FAQ

  1. Which version of WordPress does the App work with?
  2. Which devices will this work with?
  3. I get an “Unable to read the WordPress site on that URL” error message. What do I do ?
  4. I get a “Blog returned invalid data” error message. What do I do?
  5. I can’t login, I get a “Precondition Failed” or a “Forbidden” error message. What do I need to do?
  6. I can’t upload photos/videos, I get a “Failed” error message. What do I need to do?
  7. My blog is located in a folder, and resolves to http://example.com/blog.  How do I add the blog?
  8. Can I adjust the size of photos uploaded from the app?
  9. I can save posts to local drafts but can’t figure out how to publish to the blog — what do I need to do?
  10. How do I delete a blog?
  11. I get an “XML-RPC Service are disabled on your blog”. How I can enable them on my blog?
  12. My Host Blocks XML-RPC Access! How do I fix that?
  13. Can I use SSL to encrypt the App communication?
  14. I’m in China and I can’t login, I get an SSL error. What do I need to do?
  15. How to set up set up Stats via Jetpack?
  16. I can’t connect to my self-hosted blog, what do I do?
  17. I get the error “Couldn’t Sync — Sorry, you cannot edit posts site.”

Which version of WordPress does the App work with?
We make sure the app works with the current and two previous versions of WordPress. Earlier versions are not supported but may still work for most features.

Which devices will this work with?
The App works with any device that is running iOS version 7 or greater.

I get an “Unable to read the WordPress site on that URL” error message. What do I do ?
1. Ensure that you’ve typed in the URL correctly.
2. If it’s correct, make sure XML-RPC services are enabled on the blog.
3. Verify that xmlrpc.php is functioning properly. Locate your RSD meta tag by viewing-source on your blog. It will look similar to this:
<link rel="EditURI" type="application/rsd+xml" title="RSD" href="http://example.com/xmlrpc.php?rsd" />
Next, follow the link, http://example.com/xmlrpc.php?rsd, and make sure it resolved to an XML file. Locate the WordPress API item: http://example.com/xmlrpc.php. And lastly, load that apiLink value into your browser. If everything is setup correctly, you should see this message: “XML-RPC server accepts POST requests only.”
4. 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.
5. Try with the default theme and with no active plug-in.
(Trying it with the default theme and plugins disabled will help pin down where the problem is. If everything works then you go back and enable your theme and then try it again. If everything still works then you go back and activate each plugin one at a time until you find the one that is causing the breakage.)
6. Turn on the ‘debug mode’, that enables extended log format, and check the log file. Instructions here.

I get a “Blog returned invalid data” error message. what do I do?
1. A common issue that can cause errors with the App is invalid characters.  The easiest way to check 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.
2. You can also try with the default theme and with no active plug-in.
(Trying it with the default theme and plugins disabled will help pin down where the problem is. If everything works then you go back and enable your theme and then try it again. If everything still works then you go back and activate each plugin one at a time until you find the one that is causing the breakage.)
3. You might be able to figure out what’s wrong by yourself by following the instructions here: http://wpiphonedev.wordpress.com/extra-debug/

I can’t login, I get a “Precondition Failed” or a “Forbidden” error message. What do I need to do?
If you receive a “Precondition Failed” that is most likely a mod_Security issue discussed in this WordPress Support Forum discussion.
Check with your hosting provider or system administrator to see if permissions or other issues are causing the error.

I can’t upload photos/videos, I get a “Failed” error message. What do I need to do?
If you’re running WordPress 2.9.2 or later please be sure to add the following lines to your root .htaccess file:
php_value memory_limit 128M
php_value upload_max_filesize 128M
php_value post_max_size 128M
php_value max_execution_time 120

Additional info here.

My blog is located in a folder, and resolves to http://example.com/blog.  How do I add the blog?
Type in the full URL when adding the blog, in this case, example.com/blog.

Can I adjust the size of photos uploaded from the app?
You can choose whether to have photos resized for faster uploading. You can choose between predefined dimensions (small/medium/large) or setting a custom resize dimension.

I can save posts to local drafts but can’t figure out how to publish to the blog — what do I need to do?
When you are ready to publish, change the status of the post (from the Settings screen) to “Published” and then tap “Save.”

How do I delete a blog?
In Settings, swipe your finger from left to right over the title of the blog.  A “Remove” button will then appear.  Tap “Remove” to remove the blog.

I get an “XML-RPC Service are disabled on your blog”. How I can enable them on my blog

*Note* As of WordPress 3.5, XML-RPC is enabled by default. The following settings only apply to 3.4 or lower.
1. Go to your blog and log in (/wp-admin).
2. In the sidebar, open Settings and then select Writing.
3. Under Remote Publishing, check the XML-RPC protocol checkbox.
3. Click Save Changes at the bottom of the page.

My Host Blocks XML-RPC Access! How do I fix that?

  1. Rename your xmlrpc.php file to something different, but only change it after the ‘xmlrpc’. Ex: xmlrpc_wp.php.
  2. Install this plugin.
  3. Read the installation instructions and activate it.
  4. Remove your blog from the app and add it back again.

Can I use SSL to encrypt the App communication?
Yes. On WordPress.com blogs, all communication (done over XML-RPC)  is by default going to use an encrypted connection via SSL.  For self-hosted WordPress, if you have SSL enabled, WordPress 2.6.1 or later supports pointing the RSD information at the “https” version of xmlrpc.php which creates an encrypted communication link with the App.

I’m in China and I can’t login, I get an SSL error. What do I need to do?
The app tried to connect to your blog using a secure connection (https) but apparently WordPress.com is being blocked in China over https connection. You can add the blog following the steps below:
- Tap the add blogs button.
- Tap on “Add self-hosted WordPress blog”.
- Insert the URL of your blog http://your-blog-name.wordpress.com/xmlrpc.php
- Insert your Credentials and tap “Save”.

How to set up set up Stats via Jetpack?
Jetpack is a plugin that connects to WordPress.com and enables awesome features like stats, powered by the WordPress.com cloud infrastructure. To view your self-hosted blog’s stats:
1. Install the Jetpack plugin on your blog. To install, go to the Plugins > Add New in your dashboard, search for Jetpack, and click “Install Now”.
2. Connect the plugin to a WordPress.com account. In the Jetpack tab in your dashboard click the “Connect to WordPress.com” button and follow the directions.
3. In the app, enter the credentials to the WordPress.com account connected to the Jetpack plugin. You can do this when prompted on the Stats screen, or by tapping Settings > Your Blog > Configure Jetpack Stats.

I can’t connect to my self-hosted blog, what do I do?

If this guide to help you make the XMLRPC endpoint accessible didn’t help, the case might be that you’re running a plugin on your blog that is blocking access for apps to connect to your blog.

We have a running list of WordPress plugins that can break your blog here: http://ios.forums.wordpress.org/topic/app-blocking-plugin-list?replies=1#post-5985

If you’re running any of these plugins, please try and disable them to see if that fixes the problem.

If your plugin is not on the list but does make your site unreachable, please let us know and we’ll add it. Feel free to nudge the developers of the respective plugins to fix the connectivity issues!

I get the error “Couldn’t Sync — Sorry, you cannot edit posts site.”

The reason you would get this error is most likely because of one of two reasons:

1. The account you have on the site doesn’t have sufficient privileges. Your user role needs to be Author, Editor, or Administrator to be able to manage content in the app.

2. You recently changed the URL associated with your blog in the app, moved your website elsewhere, or changed your CMS.

Solution: make sure you have the sufficient privileges on the site, Author or higher. Make sure the blog URL in the app is correct by going to Settings and tap your blog to edit it.

Follow

Get every new post delivered to your Inbox.

Join 2,128 other followers