Sharing with WordPress
This article will show you how to connect Clarify to your WordPress blog as well as how to upload a document.
Enter your blog login credentials
- Enter your username and password.
- Clarify ships with one WordPress HTML template that is used when formatting your Clarify document for upload to WordPress. The template does not apply any sort of styling to the content that is uploaded. If you would like to create a custom HTML template that can be used when uploading to WordPress then please refer to the HTML templates manual.
- Test the connection to make sure you have entered your information correctly.
Uploading to WordPress
Now that you have configured your WordPress sharing account you will see a WordPress icon in the sharing toolbar. Click on it to upload your document to WordPress.
The WordPress upload dialog
A note about updating images
The next time you upload the Clarify document to WordPress Clarify will replace the existing post. When updating an existing WordPress post Clarify tries to optimize the update process by not uploading images which have already been uploaded. If a step image has been uploaded before then it will not be uploaded again if:
- The image still exists in WordPress and
- The image content has not changed.
A couple of things to keep in mind. You should not modify any images that Clarify uploaded within WordPress itself if you plan on using Clarify to update the post later on. If you use a 3rd party WordPress plugin to replace an image in WordPress, Clarify won't know that you did and will not upload the latest image from the Clarify document. In addition, if you use WordPress to edit the image Clarify will not know that you made changes to it.
This article provides troubleshooting tips for known issues with posting to WordPress.
Note that these problems are all related to security issues associated with the xmlrpc.php file that ships with WordPress. We are currently working on a solution that uses a new JSON API for WordPress. It requires installing some plugins but so far in our tests does not experience any of the same issues. If you are having trouble posting to WordPress and would like to try the new solution we are working on then send an email to firstname.lastname@example.org.
Error 403 Forbidden
If you have iThemes Security installed make sure you don't have it set to deny all xmlrpc.php files. Switch it to only deny pingbacks and try again.
"Unable to reach the Wordpress server", message about your IP address being banned, or a mod_sec.html error
Some web host providers will blacklist an IP address that makes multiple requests to the xmlrpc.php file in a WordPress installation. This is due to the fact that the file has historically been used for nefarious purposes. Since Clarify documents often contain multiple images it is making multiple requests to the xmlrpc.php file on your server and your web hosting service may flag you.
You can contact your hosting provider and ask them to whitelist you so that you can upload to WordPress.
Another potential cause of the "Unable to reach the WordPress server" error could be a WordPress plugin. At least one user has reported issues with using the "EWWW Image Optimizer" plugin. You can try disabling plugins to see if one is causing a problem.