Documentation-Issue-Tracker
Documentation-Issue-Tracker copied to clipboard
WordPress
[MobileApp] My sites
- [ ] Can I create a new WordPress.com site in the WordPress App?
- [ ] Can I manage plugins on a self-hosted site?
- [ ] Can I use stats with a self-hosted site?
- [ ] Comments incorrectly marked as spam
- [ ] Error: “Error establishing a database connection”
- [ ] Error: “That site already exists”
- [ ] Error: “That site is reserved”
- [ ] Help, my site is down!
- [ ] How can I add users to my site?
- [ ] How can I change the theme for my site?
- [ ] How can I export my site’s content?
- [ ] How can I import content to my site?
- [ ] How can I manage my site?
- [ ] How can I remove or hide a site?
- [ ] How do I block someone?
- [ ] How do I change my timezone?
- [ ] How do I connect my site?
- [ ] How do I delete my site?
- [ ] How do I earn money?
- [ ] How do I send debug logs from the app?
- [ ] How to change the Site Privacy?
- [ ] How to create a site?
- [ ] How to set up stats via Jetpack?
- [ ] I get a “Blog returned invalid data” error message.
- [ ] I get the error “Unable to Sync.”
- [ ] Site Icons
- [ ] What is my Site address?
- [ ] Why do I get a “connection refused” error when on the stats tab?
- [ ] Why doesn’t my site show up in Google?
- [ ] How do I increase traffic to my site?
- [ ] Blogging Reminders
- [ ] Home Screen Stats Widget
Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.
Heads up @femkreations @atachibana - the "user documentation" label was applied to this issue.
![github-actions[bot] avatar](https://avatars.githubusercontent.com/in/15368?v=4 "Published by a pub.dev verified publisher"){kind=small}
ORIGINAL TEXT: Can I create a new WordPress.com site in the WordPress App? To create a new WordPress.com site, while logged in under your WordPress.com account, select the My Site tab at the bottom left corner of the screen and click the arrow beside your site address.
COMMENTS/RECOMMENDED EDIT: Can I create a new WordPress site in the WordPress App? No, you cannot create a new WordPress site in the WordPress App. You can login to existing WordPress installs using your site's login credentials.
The original text is good.
Can I manage plugins on a self-hosted site?
Managing plugins
It is possible to manage the plugins on your site from the WordPress app.
To manage plugins on your site, tap on the Plugins menu item.
Plugins menu item in WordPress iOS app
Your Plugins page will look something like this:
Plugins page in WordPress iOS app
Clicking on the Manage link takes you to the list of plugins currently installed on your site.
Plugin manager in WordPress iOS app
When you select one of your plugins, you’ll see the option to deactivate or activate it.
Plugin details in WordPress iOS app
To delete a plugin in the iOS app, scroll to the bottom and click the Remove Plugin link.
Remove plugin in WordPress iOS app
In the Android app, click the trash icon.
Plugin details in WordPress Android app
Installing plugins
To install a plugin, go to Plugins. You’ll see a showcase of some featured plugins, as well as the most popular, and new plugins. You can also search for plugins.
After you click on a plugin name, you’ll see a button to install it on your site. You can also read all about the plugin – what new functionality it provides, and how it works.
The original text is good.
Can I use stats with a self-hosted site?
Yes!
You need to install and connect the Jetpack plugin, which you can do with these instructions.
After installing the plugin, tap the “Stats” button in the app and enter your new WordPress.com login when prompted.
The original text is good.
Comments incorrectly marked as spam
If a commenter is being incorrectly marked as spam, they can fill in this form here:
https://akismet.com/contact/
This gives us more information that can be used to debug the issue.
The original text is good (I have just added a direct link to the new mobile forum)
Error: “Error establishing a database connection”
If you get a page featuring the message “Error Establishing Database Connection,” this means that there is a problem with the connection to your database and there could be a number of reasons for this.
This isn’t a problem that can be solved in the WordPress app (or by the WordPress app support team). You can find troubleshooting tips on the Common WordPress Errors support page.
For additional help, please contact your website hosting provider. You can also get more help and advice from the WordPress community: https://wordpress.org/support/forum/mobile/
🔴 This article is no longer relevant, I think it can be deleted.
Error: “That site already exists”
If a site already exists or is reserved, you will need to choose a different address for your new site.
Every site that is registered needs to use a new, unique address that hasn’t been registered before. We cannot recycle or reassign site addresses (URLs) which may appear to be abandoned. We respect bloggers’ ownership of their content and therefore will not move or delete a site without its owner’s consent — no matter how long it has been since their last update.
If you want help choosing a site address, you can also get suggestions in the signup process here:
https://wordpress.com/start
🔴 This article is no longer relevant, I think it can be deleted.
Error: “That site is reserved”
If a site already exists or is reserved, you will need to choose a different address for your new site.
A reserved site means the address is already reserved for an existing WordPress.com user.
If you want help choosing a site address, you can also get suggestions in the signup process here:
https://wordpress.com/start
The original text is good.
Help, my site is down!
If you can’t access your site in a web browser, please contact your website hosting provider.
Your hosting provider can investigate why your site isn’t working, and help you get it back up and running. The WordPress app can only connect to your site when WordPress is installed and working there, so if you can’t access your site at all, the app (and the app support team) can’t fix that.
You can also check the Common WordPress Errors support page for common problems and how to resolve them on your site.
Once your site is working again, you can try to connect to it and manage it within the app.
🔴 I have removed references to WP.com and updated the "learn more about roles and capabilities" link but this article will need more reviewing as wp.org invitations work differently in org and com.
How can I add users to my site?
On WordPress.com sites, you can add users to your site by sending invitations. To send an invitation, you’ll need these two pieces of information:
A person’s username or email address The role that you’d like a person to have on your site
How to Invite People
- Select the My Sites icon in the navigation bar.
- Select the “People” section.
- Tap the plus (+) icon in the top right.
- Enter the username or email address of the person you want to invite.
- Select the role you want that person to have on your site.
- Optional: Add a custom message that will be included in the invitation.
- Tap “Send” (on Android) or “Invite” (on iOS) in the top right to send the invitation.
After sending the invitation, the person that you invited will receive an invitation email. Once the user clicks the “Accept Invitation” button in that email, they will be added to your site.
User Roles
User roles determine the access level or permissions of a person authorized (invited by an Administrator) to use a WordPress site.
Administrator – nothing is off-limits. Editor – has access to all posts, pages, comments, categories, tags, and links. Author – can write, upload photos to, edit, and publish their own posts. They can also view comments. Contributor – has no publishing or uploading capability, but can write and edit their own posts until they are published, and can view comments. Follower (public sites) / Viewer (private sites only) – can read and comment on posts and pages Each user role is capable of everything that a less powerful role is capable of. (In other words, Editors can do everything Authors can do, Authors can do everything Contributors can do, and so on.)
You can read more about user roles here
The original text is good.
How can I change the theme for my site?
To change your site’s theme, follow these steps:
- Tap on the “My Sites” tab in the lower left corner of your screen.
- Select the site
- Tap on the “Themes” menu item.
You’ll be shown all of your available themes for that site. You can also search them by name.
- Once you find the theme you want, tap on it.
- Tap the ellipse menu (…)
- Then tap the “Activate” button in the top right corner of the screen.
🔴 Original text below. It will need to be rewritten, this does not apply to the WP app.
How can I export my site’s content?
On Android
To export your site’s content from the WordPress mobile app you need to click on the Settings tab
Next, scroll all the way down and click on the Export Content tab
Next you will see a pop-up message saying your exported content will be sent to the email address associated with your WordPress.com account. Click on the Export Content option.
The system will export your site’s content to your email and will let you know once it’s done. Please note that depending on your email server and internet connection the file might take a while to get to your inbox. Also, it’s worth noting this type of email is rarely allowed into your main inbox. Please check any alternative inboxes you might have, like the Updates folder on Gmail for example, Spam and trash folders too.
The email should look like this
Once you open it, you will see a Download blue button. Click on the button to download the file to your device
On iOS
To export your site’s content from the WordPress mobile app you need to click on the Settings tab. Next, scroll all the way down and click on the Export Content tab
Next you will see a pop-up message saying your exported content will be sent to the email address associated with your WordPress.com account. Click on the Export Content option.
The system will export your site’s content to your email and will let you know once it’s done. Please note that depending on your email server and internet connection the file might take a while to get to your inbox. Also, it’s worth noting this type of email is rarely allowed into your main inbox. Please check any alternative inboxes you might have, like the Updates folder on Gmail for example, Spam and trash folders too.
The email should look like this
Once you open it, you will see a Download blue button. Click on the button to download the file to your device
🔴 Original text below. It will need to be rewritten, this does not apply to the WP app.
How can I import content to my site?
While it’s not possible to import your site’s content from the app at the moment, you can do so by logging into your account from a browser at https://wordpress.com/login and then go to My Sites – Tools – Import and you will be able to upload the site’s content file.
You can find a step-by-step tutorial on how to import content to your site here.
The original text is good.
How can I manage my site?
To manage your site, select the Android-MySites-Icon My Site icon at the bottom of the app and choose the site you are ready to manage.
From here you can add or edit blog posts, pages, media files, and comments.
Under Settings, you’ll see the option to set your site title and tagline, update your site privacy settings, set your timezone, configure your homepage settings, select your default editor, and a few additional post settings and formats.
You also have Admin access for any sites where you are an Administrator and can view Stats (for Jetpack and WordPress.com sites), edit general site settings, or access the Admin panel in a browser window.
The original text is good.
How can I remove or hide a site?
Select the My Site icon in the bottom navigation bar and click the arrow beside your site address.
WordPress app homepage -ANDROID
In the Android app – For WordPress.com sites, tap the three dots on the upper right of the screen, then tap Show/hide sites. Tap a site you would like to show or hide, then select the option to hide or show (whichever is applicable) at the top of the page.
In the iOS app – Swipe from right to left on the site you wish to hide, then tap Hide.
🔴 Original text below. It will need to be rewritten, this does not apply to the WP app.
How do I block someone?
While it’s not possible to block someone from viewing a public website, you do have some options.
Firstly, you can moderate your followers and remove them. There’s more information about managing your followers and specifically removing them here: https://en.support.wordpress.com/followers/#how-to-remove-a-follower
You can also change your comment moderation settings. Here you can ensure that comments from specific users and / or IP addresses are sent straight to spam. There are more details on how to do that here: https://en.support.wordpress.com/settings/discussion-settings/
The original text is good.
How do I change my timezone?
Your site’s timezone is set to Coordinated Universal Time, UTC by default, which is in London, UK.
If you live in a different area of the world you will likely want to change this option.
You can change the timezone in your site’s General Settings (in a web browser).
For sites hosted at WordPress.com:
- Open your site’s General Settings in a web browser
- Find the Site Timezone setting
- Select your timezone or a city in the same timezone
For sites hosted elsewhere:
- Open your site’s dashboard in a web browser
- Go to Settings > General to find the Timezone setting
- Select your timezone or a city in the same timezone
🔴 I think it makes sense to leave the WP.com part to avoid confusion but it would be good to review the article again.
How do I connect my site?
WordPress.com or Self-hosted site connected to Jetpack
To access a site hosted with WordPress.com, log in to the app with your WordPress.com credentials.
When you open the app for the first time, click on Log In or Sign Up with WordPress.com and enter the email address associated with your account:
WordPress App Login Screen
Please note: If you use an email that is not associated with any WordPress.com account it will automatically create a new account for you linked to the email you added.
You can choose to receive a login link via email or enter your password to access your account
Login Link
If you choose the link option, we’ll email you a special link that, once you click it, will log you into your account without needing to enter a password.
The link will work once only, and expires after one hour for added security.
Password (WordPress.com)
You can also log in with your email address and password:
Password Login
Log in to a Self-Hosted Site
To access a WordPress site that is self-hosted, tap the “Enter your site address” link, then enter the site address to connect to your site. You will then be asked to enter your username and password you use to log into WP-Admin (https://yoursiteaddress.com/wp-admin).
If your site is connected to Jetpack, you will also need to provide your WordPress.com login information to receive your Stats.
Add Additional Sites
To add more sites to your app at any point, select the Switch Site option, tap the “+” icon in the top right corner, and choose the appropriate option:
- Create a brand new WordPress.com website
- Add an existing self-hosted WordPress site
Each of your sites can then be managed independently through the app. Though any WordPress.com sites will need to be managed from the same WordPress.com account.
🔴 I do not think this is possible in the WP app, it should be reviewed.
How do I delete my site?
Deleting a WordPress.com site permanently removes it and you’ll never be able to re-use its WordPress.com address (such as yourgroovysite.wordpress.com).
To delete your entire site and its contents, you can select your site in the app and go to the “Settings” section.
There, scroll to the bottom of the screen and tap “Delete Site.” You can follow the instructions on screen to delete it.
You can also learn more about deleting your site, and other options, here:https://en.support.wordpress.com/delete-site/
Self-hosted sites
In the iOS app, you can remove a self-hosted site by going to the My Site tab and clicking on the Remove Site option at the bottom.
Remove site option in WordPress iOS app In the Android app, click the arrow beside your site address, then long press the site you wish to delete.
Remove Site option in WordPress Android app If it’s a Jetpack site, you can disconnect the site from Jetpack, but this will not actually delete the site from the web. To do that you would need to contact your host.
🔴 I do not think this is relevant for the WP app, it should be removed.
How do I earn money?
If you are looking to include ads on your blog, you can sign up for WordAds. (WordAds works on WordPress.com sites and self-hosted sites with the Jetpack plugin.) Learn more and sign up for WordAds. It’s worth noting that a site generally needs thousands of page views each month to earn meaningful advertising revenue. What you earn can vary greatly per site, depending on the following factors:
- The amount of traffic.
- Where the majority of the traffic is coming from. (North American ad placements currently pay-out at a much greater level than international ads.)
- How many are using ad blockers.
- The actual ads that are displayed.
You can find information about monetizing your site including some other options here:https://en.support.wordpress.com/monetize-your-site/
🔴 I do not see this option in the WP app, it should be removed.
How do I send debug logs from the app?
On iOS
- Open the app
- Tap the “Me” icon in the top navigation bar
- Tap “Help & Support”
- Enable “Extra Debug”
- Exit the app, re-open it, and try to perform the actions causing difficulty (this will have the effect of adding troubleshooting details to the logs)
- Go back to the Help & Support screen
- Tap “Activity Logs”
- Tap “Current”
- Tap the share button in the top right and select “Copy”
- Paste the log content to Help & Support > Contact Support to send to the app support. Please remember to include your site address and some information on the issue
On Android
- Open the app
- Try to perform the actions causing difficulty (this will have the effect of adding troubleshooting details to the logs)
- Tap the “Me” icon in the top navigation bar
- Tap “Help & Support”
- Tap “Activity Logs”
- Tap the share button in the top right or select “Copy”
- Paste the log content to Help & Support > Contact Support to send to the app support. Please remember to include your site address and some information on the issue
🔴 I do not see this option in the WP app, this article should be removed.
How to change the Site Privacy?
In the iOS app, click on the My Site tab and select the site you wish to edit.
Next, scroll down to Settings > Privacy and update the site privacy as needed
🔴 I do not see this option in the WP app, this article should be removed.
How to create a site?
To create a brand new WordPress.com site, you can go to My Site and click “create site” (if you have a brand new WordPress.com account) or the dropdown arrow to the right of your existing site list:
Then, click on the plus (+) sign on the top right corner of the screen
After that, select the option to either create a brand new WordPress.com site or add an existing WordPress.org (self-hosted) site. Please note you are not able to create a new Self-hosted site from the app. You would need to create the site from your hosting account and then you can add the site to the app.
🔴 I do not think this this will be available in the WP app, this article should be removed.
How to set up stats via Jetpack?
Jetpack is a plugin that connects your self-hosted site (WordPress.org) to WordPress.com and enables awesome features like stats, notifications, and more. To use Jetpack and view your self-hosted blog’s stats follow the steps below. They’re best done on a laptop computer or tablet; they can be a bit tough on a smaller phone screen.
If you don’t have Jetpack installed…
- Install the Jetpack plugin on your blog. To install, go to the Plugins section of your WordPress dashboard from a web browser and select Add New. Search for Jetpack, and click “Install Now”.
- Once the plugin is installed you’ll need to connect it to a WordPress.com account. In the Jetpack tab in your dashboard click the “Connect to get started” button.
- You’ll next see a screen asking you to authorize the Jetpack connection to your WordPress.com account. Click “Authorize Jetpack”.
- You’ll now be redirected back into your WordPress site’s Dashboard.
If you already have Jetpack installed, or after you install Jetpack follow the steps above…
- From your WP-Admin dashboard click on Jetpack and then on Set Up Jetpack
- This will prompt you to log in with the WordPress.com username and password your site is connected to. This is separate from the username and password you use to log in to your self-hosted site’s Dashboard, like https://yoursite.com/wp-admin
After logging in you’ll see the stats for your site displayed. If you don’t remember the WordPress.com account you used to connect Jetpack…
- Go to the Jetpack section of your WordPress dashboard in a web browser.
- Scroll down to the “Connections” section.
- In “Account connection” you can see the connected WordPress.com account.
- If you can’t remember the password for that WordPress.com account, you can also reset the password.
The original text is good.
I get a “Blog returned invalid data” error message.
The easiest way to check for invalid characters is to go to the W3C Markup Validator and type in the URL of your WordPress site.
If you get a response such as “… one or more bytes that I cannot interpret as UTF-8″ that is most likely what is causing the app to have trouble with your site.
Often, invalid data errors are caused by theme and plugin conflicts. You can check for these by switching to your default theme and deactivating your plugins. You can identify the offending the theme or plugin by activating one at a time and then retesting the app.
This article will need to be reviewed entirely since the WP app no longer uses Jetpack.
I get the error “Unable to Sync.”
If your site uses the Jetpack plugin, you may see an error like this:
**Unable to Sync** The Jetpack site is inaccessible
or returned an error:
This error means there is a problem with your site’s Jetpack connection.
You can use the Jetpack debugger to find the issues, and get information about fixing them.
Do you need more help fixing the error?
Take a look at Jetpack Troubleshooting Tips for resolving common problems. You can also contact Jetpack support or contact us through the app for more help!
The original text is good.
Site Icons
Site Icons are shown across WordPress.com, in your visitor’s browser tab, in widgets like Blogs I Follow, and as a bookmark and home screen app icon when saved to a browser or phone. Here are several examples:
Site icon on a desktop browser tab Site icon on a desktop browser tab Site icon on a mobile device shortcut Site icon on a mobile device shortcut Blogs I Follow widget display Blogs I Follow widget display You can upload a site icon by following these steps:
- Tap on the default icon to the left of your Site Title.
- Site icon in WordPress mobile app
- Click on YES, when prompted to add a site icon.
- Choose an existing image or upload a new one.
- Tap the check icon to confirm your selection.
- Then tap the the check icon when you’re happy with the icon.
It may take a few hours before you see your new site icon in a web browser. In case the icon does not update in a web browser, you can also try clearing your browser’s cache.
The original text is good.
What is my Site address?
If you already have a website, your URL or site address is the domain of your site – usually what you type into a web browser to get to your website, plus https:// part.
For instance, WordPress.com is our domain, and the URL or site address is https://wordpress.com/
How can I share my site address in the app?
To copy your site address for sharing, you can follow these steps:
- Go to My Site > View Site or tap your site address on the My Site screen.
- Then in the webview, tap the share icon and select Copy to copy the URL. You can also select an app to share the link with others.
This article will need to be reviewed entirely since the WP app no longer uses Jetpack stats
Why do I get a “connection refused” error when on the stats tab?
If you’ve installed an ad blocker app such as AdFree Android, it might block your connection to https://wordpress.com/stats. You will need to edit the /system/etc/hosts file on your device and remove all entries that have wordpress.com/stats to get it working again.