WordPress Integration

EasyContent has a plugin that lets you easily connect your projects to a WordPress website, allowing you to sync articles between them with ease. This way, you won't have to manually copy and paste or upload your articles to your website ever again.

This article covers plugin installation and configuration. We have a separate article about syncing individual articles between WordPress and EasyContent here.

Installing EasyContent WordPress Plugin

To get started, you have to install our WordPress plugin. To do that:

  1. Login to your WordPress website and in the dashboard, go to Plugins Add New.
  2. In the search bar, type "EasyContent". The first result should be the correct plugin.
  3. Click Install Now then Activate the plugin and you're ready to connect your site!

Get Your API Key

To connect a project to a WordPress site, you need an API key. To generate one, log in to your EasyContent account then go to the Integrations page. Note: you need proper permissions to access this page. If you need to manage integrations, contact your account owner or admin.

Once you're on the page, click the green Create new API key button on the upper left area of the page.

The Create API key dialog box will appear. Select the project you want to connect to your WordPress site, then add that site's URL in the Website URL field (make sure you include the https:// or http:// part of your URL).

Once you're done, click Add.

After a few moments, a notice containing your API key will be displayed.  Make a copy of this key somewhere safe as it will only be displayed once.

Now that you have the key, head back to your WordPress site. If you've already installed and activated the EasyContent plugin, you should see a new item in the admin sidebar menu called "EasyContent". Go here and paste your API key in the API Key field.

Click Save Changes. If your API key is valid, you should see a success message similar to the one below.

You've now successfully connected a WordPress site to one of your EasyContent projects!  You can see which project from which account the site is connected to. You can click on the project name and a new tab will open up and redirect you to the said project's dashboard.

Next, let's see how to set up the plugin and how to pull and push content to and from EasyContent.

Publishing Options

After successfully connecting a project to your WordPress site via the EasyContent plugin, you will see that additional plugin options will unlock.

Among these new options are the Publishing Options. This defines how content items are published on your WordPress site.

  • Post author - defines who will be credited as the author of all items pulled from EasyContent.
  • Post type - you can choose between post and page. If you chose the page post type, the section for mapping categories will become unavailable.
  • Post status - you can set what post status the item will be assigned to when synced/pulled from EasyContent. Note that it will not affect the item's workflow status in EasyContent.
  • Comment status - you can set whether you want to allow comments or not on items pulled from EasyContent.

Category Mapping

You can map EasyContent categories to WordPress categories. In the example below, if an item is in the Content Marketing category in EasyContent and then you push it to WordPress, it will be assigned to the Content category.

You can also assign a default category where any unmapped or unassigned categories would be assigned to.

This mapping also affects articles you push to EasyContent.

For example, if you have an article in your WordPress site that's not on your EasyContent account, you can "push", or in other words, upload it so it would be added to your list of content items.

Let's say this article belongs to the Content category in WordPress. If we take a look at our example above, we can see that it's mapped to the Content Marketing category in EasyContent, so if you upload this article to EasyContent, it will automatically be assigned to the Content Marketing category.

SEO Settings

This page displays compatible SEO plugins with EasyContent. Currently, we support both Yoast SEO and All-in-One SEO Pack. If you have neither of those installed and you visit this page, it will display a notification telling you about these plugins.

However, if you have one of them installed, this page will notify you that everything is set up and you don't have to do anything else. It also means that our plugin successfully detected/recognized that you have either Yoast or All-in-One SEO pack installed.

If you have either Yoast SEO or All-in-One SEO pack installed and this page still says that you need one of those plugins for the SEO settings to function properly, then there may be something wrong.

First, make sure that the plugins are not only installed but are also activated. Second, make sure you only activate one and not both of them at once. You have to pick between the two. Third, you may need to reinstall the plugins.

If these steps didn't solve the problem, feel free to contact us and we'll see what we can do to help you.

Image Processing

The image processing options allow you to configure the maximum dimensions of images pulled from EasyContent to your WordPress site.

There are three options you can configure here:

  • Enable image resizing - this enables the plugin's built-in image resizing function. Note that only images that came from EasyContent will be resized and not the ones you upload directly to WordPress.
  • Max image dimensions - allows you to set the maximum dimensions you want for your images. You can set a maximum width and height and the image will resize accordingly, maintaining the original aspect ratio.
  • JPEG compression level - you can set values anywhere from 1 and 100. Lower values reduce file size but also reduces your image's quality. Higher values result in larger file size, but in return, images will have better quality. We recommend setting this to 90 but feel free to tweak it based on your needs.

Import from EasyContent

This page displays all your Assignments on the connected project. 

  1. Refresh all data - this button refreshes the item list to display recent additions to the assignments. Every time you assign, claim, or cancel an assignment on EasyContent you should use this button to update the article list and their workflow status.
  2. Import selected items - should be self-explanatory. You can select items using the checkboxes.
  3. Change status on import - lets you auto change the item(s)'s workflow status in EasyContent upon importing.
  4. Search and Filtering options - these options lets you easily find a particular item. You can search by name, filter by workflow, sync status, etc.
  5. Assignment list - this table shows you all current items on the assignments page of the currently connected project. This doesn't automatically update on its own, so you will have to use the refresh all data button to see any newly added (or removed as well as updated) ones. This item is discussed in more detail below.

Assignment List

The assignment list has five different columns:

  1. EC Topic Name - is the assignment's task name in EasyContent.
  2. EC Title - is the assignment's title as it appears in the Text & Files tab.
  3. Updated - reflects the assignment's last content update time in EasyContent.
  4. EC Status - reflects the assignment's current workflow status in EasyContent.
  5. Last Synced - displays the last synced time to or from WordPress. You can click on this to directly go to the post editor for the corresponding item (if it's already synced at least once).

Connecting Your Project to a New Website

If you are moving your project to a new website, you need to delete the API key and create a new one.

Copy the new key and then log in to the new website, install the EasyContent plugin, and input your API key. You'll need to reconfigure the plugin to match your previous settings. Once done, you're all set.

Next, learn how to push and pull individual articles between WordPress and EasyContent here.