Table of Contents
More Resources
Set up WordPress
Set up WordPress
Learn how to set up WordPress to authorize publishing from easyDITA.
Create a WordPress.com Application
Set up a WordPress.com application to connect easyDITA to WordPress. You'll also access your login credentials (Client ID and Client Secret) here, which you'll use later to log into WordPress through easyDITA.
Install Jetpack
Install the Jetpack plugin to set up your WordPress site API.
Connect easyDITA to WordPress
Log in to your WordPress site through easyDITA so you can start publishing content.  
Set up WordPress

Learn how to set up WordPress to authorize publishing from easyDITA.
In order to use our WordPress connector, you’ll need to set up a few things first. Our WordPress connector uses OAuth to authenticate publish requests, so in addition to setting up the API on your site, you’ll need to get a Client ID and Client Secret. Follow these steps to set up your WordPress site:
  1. Create a WordPress.com Application to get a Client ID and Client Secret
  2. Install Jetpack to set up your site API
  3. Connect easyDITA to WordPress to authorize publishing to your site
Note:If you’re connecting easyDITA to a site hosted by WordPress (my-docs.wordpress.com), you can skip Step #concept-4354/jetpack. The API is already included by default for WordPress hosted sites, so installing the Jetpack plugin isn’t necessary.
Create a WordPress.com Application

Set up a WordPress.com application to connect easyDITA to WordPress. You’ll also access your login credentials (Client ID and Client Secret) here, which you’ll use later to log into WordPress through easyDITA.
You want to create a WordPress.com application to connect easyDITA to WordPress.
  1. Log in with your WordPress.com developer’s account or create one if you don’t have one already.

    Step Information
    Note:This account is different from the account you use to log in to your WordPress site.
  2. Click Create New Application.
  3. Complete the form using the guidelines below:

    Step Information
    Field name Enter Example
    Name Whatever you like easyDITA Publish Connector
    Description Whatever you like The application that connects easyDITA to my WordPress site
    Website URL Your WordPress site domain my-docs.host.com (do not include “https://”)
    Redirect URL http://{easydita-url}/plugins/wordpress/set-up-oauth http://yourdomain.easydita.com/plugins/wordpress/set-up-oauth
    Javascript Origins Leave this blank
    (Prove that you’re human) Enter the sum 8
    Type Select “Web” Web
    Follow Developer blog Whatever you like Unchecked
  4. Click Create.
  5. Your new Application page displays. Take note of the Client ID and Client Secret; you’ll use them when logging in through easyDITA.
You set up your WordPress.com application and have your Client ID and Client Secret.
If your site is hosted by WordPress, you’re ready to Connect easyDITA to WordPress. If your site is self-hosted, you need to Install Jetpack first.
Install Jetpack

Install the Jetpack plugin to set up your WordPress site API.
Remember:Skip this procedure if you’re using a site hosted by WordPress (for example: my-docs.wordpress.com). WordPress hosted sites already include the API by default, so you can Connect easyDITA to WordPress.
You want to install the Jetpack plugin.
Note:wp-site-domain is used as a placeholder for the domain of your site (my-docs.host.com).
  1. Navigate to your WordPress site and open the Admin dashboard: http://{wp-site-domain}/wp-admin.
  2. Log in with the credentials you set up when you created the site.
  3. Click Plugins. A list of installed plugins displays. Often the Jetpack plugin is installed by default, so if you see “Jetpack by WordPress.com,” click Activate.

    1. If you don’t see “Jetpack by WordPress.com” listed, under Plugins, click Add New.
    2. In the Search Plugins field, enter “Jetpack” and navigate to “Jetpack by WordPress.com”.
    3. Click Install Now and navigate back to your Installed Plugins.
    4. Click Activate for the “Jetpack by WordPress.com” plugin.
  4. Once Jetpack has been activated, a banner will display across the top of the screen. Click Connect to WordPress.com and log in with your WordPress.com account to authorize Jetpack to work on your site.

    Expected Result
    The Jetpack tab is added to the navigational pane.
  5. Click Jetpack.
  6. You’ll see many of the different Jetpack features highlighted in this list. That means that they are currently active. The only feature that needs to be active is “JSON API.” You’re welcome to add any other features you want.
Jetpack is installed on your WordPress.com site. Now, you’re ready to Connect easyDITA to WordPress.
Connect easyDITA to WordPress

Log in to your WordPress site through easyDITA so you can start publishing content.  
Before you can connect your WordPress site with easyDITA, make sure you Create a WordPress.com Application first to access your Client ID and Client Secret credentials.  
You want to log in to your WordPress site through easyDITA.

  1. To begin the log in process, open a map you want to publish to WordPress and click Publish.
  2. Click WordPress.

    Step Information
    Note:If you don’t see this option, contact your easyDITA sales representative to set it up for your server.

  3. Enter your WordPress Site Domain, Client ID, and Client Secret.

    Step Information
    Important:In the WordPress Site Domain field, do not include the “http://www”.
    Example
    WordPress Site Domain: my-docs.host.com
    Client ID: 35548
    Client Secret: 95Ccuswxj55r9cUQGCRXWQI2RjgR9iilE8vEzlueaP0UWPFSDcaW5HSeZESTGvXM

  4. Click Connect to your Site!. A new window will open and if you see a WordPress.com login page, log in using the username and password you created in Create a WordPress.com Application.
  5. A new page loads requesting you to Approve or Deny easyDITA’s request to access your WordPress.com application. Click Approve.
  6. Do one of the following:

    1. If you’re using a site hosted by WordPress.com, the window will close and you’ll be returned to easyDITA (skip to Step 7).
    2. If you’re using a self-hosted site, you’ll be redirected to your WordPress.com site login. Use the log in credentials you used to set up your hosted WordPress site (my-docs.host.com) and click Login. The window will close and you will be returned to easyDITA.
  7. In the easyDITA window, a dialog displays notifying you to reload the page to begin publishing. Click Reload.
Once the page reloads, you’ll see a new screen that says Publish To WordPress!. Now, you’re ready to start Publish from easyDITA.