Welcome! You’re browsing the complete online Help for TypeMetal. The same content is available via TypeMetal’s “Help” menu.

TypeMetal User Guide

Connecting to WordPress

To start using TypeMetal with a WordPress site, you simply provide TypeMetal with the site’s URL and your account credentials. TypeMetal automatically connects to the server and obtains your site’s content and related resources.

If you don’t yet have a WordPress site, you’ll need to create one first. Numerous web hosting providers allow you to install WordPress, and many even provide an easy WordPress setup process. TypeMetal also works with WordPress sites hosted at WordPress.com. And if you want a local installation you can experiment with, you can also install WordPress on your Mac.

Adding an Account

TypeMetal’s new “Blogging” menu lists the WordPress blogs that you’ve told TypeMetal about.

To connect to a WordPress site for the first time, choose “Blogging” → “Add WordPress Blog…”.

TypeMetal presents a login panel to prompt you to enter the site’s address and your account credentials:

TypeMetal WordPress window and login panel
Connecting to a WordPress Account for the First Time

Enter your site’s URL in the “Host” field. (You don’t have to type “http://“.)

  • If your site is hosted on WordPress.com, simply type “wordpress.com” in the “Host” field.
  • If you have a self-hosted WordPress site, or your own domain hosted at WordPress.com, you might type something as simple as “myamazingsite.com”.

Next, enter your WordPress user name for the site, and the password you use to log in. TypeMetal stores your password securely in the OS X Keychain, so you won’t have to enter it again.

When you are done entering your credentials, click the “Login” button, or press [return] in the “Password” field. TypeMetal will attempt to connect to your WordPress server using the information you provided.

Rate-Limiting Requests to Your Host

Website security is a tricky business. One way that your WordPress hosting provider may protect your site involves limiting the number of requests allowed from a given source computer (IP address) in some interval of time. When that limit is exceeded, the host may begin denying requests, and may choose to deny all subsequent requests from the originating IP address for a while. These request denials may show up in TypeMetal’s WordPress Sync Log as “HTTP error 418”.

Syncing your site with TypeMetal for the first time, or performing an “exhaustive” sync, necessarily involves a large number of requests, so may can easily afoul of any rate-limiting security measures that your WordPress host has instituted.

If your WordPress host enforces rate-limiting (as is frequently done using the “ModSecurity” Apache server module), you can configure TypeMetal to limit the number of requests it will send to your host over some time interval. You do this by toggling the rate-limiting checkbox on in the WordPress login panel, as shown below.

WordPress login UI showing rate-limiting settings
Enabling Rate-Limiting

TypeMetal remembers these settings on a per-project basis. They default to a maximum of 10 requests per 60-second interval (a common setting), but you can change them if necessary to match the limits enforced by your host.

If you encounter trouble syncing your site using TypeMetal that might be due to rate-limiting enforcement, please drop us a note on the TypeMetal Support Forum, letting us know which WordPress hosting provider you’re using. The best long-term solution is usually for us to work with your hosting provider to have them “white-list” requests from TypeMetal. The rate-limiting settings in TypeMetal can be useful as a temporary workaround, but will slow down syncing any time the limit is reached. Once a host has white-listed TypeMetal, rate limiting is no longer necessary (and you should disable it to get faster syncs).

Custom XML-RPC URLs

TypeMetal communicates with your WordPress host using a protocol called “XML-RPC”. By default, TypeMetal assumes the standard WordPress configuration, and attempts to talk to your WordPress server at <host>/xmlrpc.php

If your WordPress host is configured to use a different XML-RPC URL, you’ll need to enter that URL in the provided text field, below the “Host” field. TypeMetal will remember the custom URL, and use it every time it syncs with your WordPress site.

If your WordPress host is configured to use HTTPS (secure encrypted) transport, be sure to prefix the URL you type with “https://”, as in the example shown below.

WordPress login UI showing Custom XML-RPC URL field
Entering a Custom XML-RPC URL

WordPress.com Sites

If your site is hosted on WordPress.com, TypeMetal will next prompt you to log into your WordPress.com account and grant permission to access your blog.

Authenticating with WordPress.com
Authenticating with WordPress.com

You’ll need to enter your WordPress.com account name and password one more time in the above sign-in sheet. Then click the “Sign In” button. (If you change your mind, click the “x” in the lower-right corner to dismiss the sheet.)

Once you’ve signed in successfully, WordPress.com will prompt you to confirm that you want TypeMetal to be allowed to access your blog. If there is more than one blog associated with your WordPress.com account, you’ll need to choose the blog that you want TypeMetal to connect to. (WordPress.com grants permission on a per-blog basis, so if you have more than one blog associated with a given WordPress.com user name, you’ll need to add the blogs one at a time.)

Selecting the Blog to Connect To
Selecting the Blog to Connect To

Choose the blog you want to connect to from the popup list, then click the “Authorize” button. This confirms to WordPress.com that it’s OK for TypeMetal to access the blog’s posts, pages, and associated content. TypeMetal should then proceed to download a copy of all of your blog’s posts, pages, and associated content, showing your progress as it goes.

If you have other blogs associated with the same WordPress.com account that you haven’t yet connected to, TypeMetal will ask whether you want to add another existing blog when it has finished syncing the current one.

TypeMetal asking whether you want to add more wordpress.com blogs
TypeMetal Prompting to Sync Additional WordPress.com Blogs

Click “Yes” if you want to add another existing blog before proceeding further. TypeMetal will prompt you to sign into your WordPress.com account again and grant access to an additional blog.

If you click “Not now”, you can always connect TypeMetal to your other blog(s) later, by choosing “Add WordPress Blog…” from TypeMetal’s “Blogging” menu. TypeMetal will add any such blogs to the existing TypeMetal project for your WordPress.com user name.

TypeMetal’s attempt to connect to your WordPress host should succeed or fail within ten seconds or so. If the attempt fails, you’ll see a result such as “Incorrect username or password” (indicating you may have made a typo entering your user ID or password), or “HTTP error 404” (indicating the host you specified could not be reached — perhaps because you mis-entered the “Host” URL). Review and correct the credentials you entered, and try again.

Troubleshooting WordPress Sync

If you have trouble syncing with a WordPress site, there’s a sync log you can send that will help us diagnose the problem.

To view the sync log for a given account, choose BloggingView Sync Log from the menus, or click the “Sync Log” button that appears at the bottom of a sync status display for any of the account’s blog windows. The “Sync Log” window that appears contains diagnostic text describing the last few sync sessions, that you can copy and paste. Email it to support@coherencelabs.com with a description of the problem you’re seeing, or quote relevant excerpts when posting to the public TypeMetal support forum. We’ll do our best to get you up and running again!

If the attempt to connect succeeds, TypeMetal will begin downloading posts, pages, and related information from your WordPress site. Depending on the size of your site, you may need to allow TypeMetal some time to complete this first sync, which downloads all of the site’s content. You’re free to use TypeMetal, and your Mac, for other things while the download continues.

When the sync completes, TypeMetal presents an “Open Blogs” button. Clicking it dismisses the login panel, and opens a blog editor window for each of your account’s blogs (often there will be only one).

TypeMetal WordPress window showing completed first sync
When TypeMetal finishes syncing with WordPress, an “Open Blogs” button appears.

Finding Your Blogs Later

Once TypeMetal has connected to your WordPress site, you’ll be able to find your blog(s) listed in the “Blogging” menu. Choose any blog in the list, to have TypeMetal open a window for it.

Removing a Blog from TypeMetal

If you decide you no longer want to work with a given blog using TypeMetal, you can remove it from TypeMetal’s “Blogging” menu.