Table of Contents
More Resources
Setting up the easyDITA WordPress Connector
Setting up the easyDITA WordPress Connector
Learn how to set up the easyDITA WordPress Connector and authorize publishing from easyDITA. This set up only has to be done once, then you can publish directly from easyDITA to WordPress.
Installing Jetpack
Install the Jetpack plugin to set up your WordPress site API.
Creating a WordPress Application
Create a WordPress application to connect easyDITA to WordPress. During this process, you'll get your login credentials (Client ID and Client Secret), which you'll use later to connect WordPress to easyDITA.
Connecting easyDITA to WordPress
Log in to your WordPress site through easyDITA so you can start publishing content.
Setting up the easyDITA WordPress Connector

Learn how to set up the easyDITA WordPress Connector and authorize publishing from easyDITA. This set up only has to be done once, then you can publish directly from easyDITA to WordPress.
In order to use the easyDITA WordPress Connector, you’ll need to set up a few things first. The easyDITA WordPress Connector uses OAuth to authenticate publish requests, so you’ll need to set up the API on your site and get login credentials. Follow these steps to set up the easyDITA WordPress Connector:
Note:If you’re connecting easyDITA to a site hosted by WordPress (e.g. my-docs.wordpress.com), you can skip installing Jetpack. The API is already included by default for WordPress hosted sites, so installing the Jetpack plugin isn’t necessary.
Installing Jetpack

Install the Jetpack plugin to set up your WordPress site API.
context
Note:If you’re connecting easyDITA to a site hosted by WordPress (e.g. my-docs.wordpress.com), you can skip installing Jetpack. The API is already included by default for WordPress hosted sites, so installing the Jetpack plugin isn’t necessary.
  1. Navigate to and log in to your WordPress site.

    Step Information
    Note:wp-site-domain is used as a placeholder for the domain of your site (my-docs.host.com).
  2. Click Plugins. A list of installed plugins displays. 

    Step Information
  3. Often the Jetpack plugin is installed by default, so if you see Jetpack by WordPress.com, click Activate.

    Step Information
    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.

      Step Information
    3. Click Install Now and then click Activate.
  4. Once Jetpack has been activated, a banner will display across the top of the screen. Click Connect to WordPress.com.

    Step Information
  5. Log in with your WordPress.com account to authorize Jetpack to work on your site.

    Step Information
    Expected Result
    The Jetpack tab is added to the navigational pane.
  6. Click Jetpack.

    Expected Result
result

Jetpack is installed on your WordPress site. Now, you’re ready to connect easyDITA to WordPress.

Creating a WordPress Application

Create a WordPress application to connect easyDITA to WordPress. During this process, you’ll get your login credentials (Client ID and Client Secret), which you’ll use later to connect WordPress to easyDITA.
context
  1. To create the WordPress application, go to developer.wordpress.com/apps.

    Step Information
  2. Log in with your WordPress developer’s account or create one if you don’t have one already. If you need to create a developer’s account, just create a free domain.

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

    Step Information
    Expected Result
    The Create New Application screen displays.
  4. 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 http://my-docs.host.com
    Redirect URL http://yourserver.easydita.com/plugins/wordpress/set-up-oauth http://epictoasters.easydita.com/plugins/wordpress/set-up-oauth
    Javascript Origins Leave this blank
    (Prove that you’re human) Enter the sum
    Type Select “Web” Web
    Follow Developer blog Whatever you like Unchecked
  5. Click Create.

    Expected Result
    Your new Application page displays.
  6. Navigate to the easyDITA Publish Connector.

    Step Information
  7. Take note of the Client ID and Client Secret; you’ll use them when connecting easyDITA to WordPress.

    Step Information
result

You’ve set up the easyDITA WordPress Connector and have your Client ID and Client Secret.

Connecting easyDITA to WordPress

Log in to your WordPress site through easyDITA so you can start publishing content.
prereq
Before you can connect your WordPress site with easyDITA, make sure you create a WordPress application first to access your Client ID and Client Secret credentials.  
  1. To begin the log in process, open a map you want to publish to WordPress and click Publish .

    Step Information
    Expected Result
    The Publishing interface displays.
  2. Click WordPress.

    Expected Result
    The Manage WordPress Publishing Accounts page displays.

  3. Click New.

    Expected Result
    The Add a New WordPress Account page displays.

  4. Complete the following fields:

    Step Information
    Field Name Field Entry Example
    WordPress Site Domain The URL for your WordPress site my-docs.host.com
    Client ID The Client ID provided when you created your WordPress Application  35548
    Client Secret The Client Secret provided when you created your WordPress Application
    95Ccuswxj55r9cUQGCRXWQI2RjgR9iilE8
    vEzlueaP0UWPFSDcaW5HSeZESTGvXM

  5. Click Connect to your Site!.

    Expected Result
    A new window opens requesting you to Approve or Deny easyDITA’s request to access your WordPress site.
  6. Click Approve.

    Step Information
    Note:If you see a WordPress login page, log in using your site credentials.
  7. Do one of the following:

    1. If you’re using a site hosted by WordPress, the window will close and you’ll be returned to easyDITA (skip to Step 8).
    2. If you’re using a self-hosted site, you’ll be redirected to your WordPress site login. Use the log in credentials you used to set up your hosted WordPress site (e.g. my-docs.host.com) and click Login. The window will close and you will be returned to easyDITA.
  8. In the easyDITA window, a dialog displays notifying you to reload the page to begin publishing. Click Reload.

    Step Information
result
Once the page reloads, you’ll see a new screen that says Publish To WordPress!. Now, you’re ready to start publishing to WordPress.