WordPress Integration

EasyContent has a plugin that lets you easily connect one of your projects to a WordPress website. This will let you sync articles between them with ease. 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 discussing how to push and pull 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 one of your projects to a WordPress site, you need an API key. To get one, log in to your EasyContent account then on the account level menu, click Integrations. 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.

A project selection dialog box will appear. Select the project you want to connect to your WordPress site then click Add. This will initiate the API key generation. Wait for a few seconds while the system generates your API key.

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 (you can always generate a new one in case you lose it and you need to reconnect your website).

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

Next, 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 your WordPress site to one of your EasyContent projects!  You can now also see which project from which account the site is connected to. You can click on the project name (in this example, Marketing blog) and a new tab will open redirecting 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, you will see additional plugin options unlock. Among these new options are the Publishing Options which we'll discuss in this section. These options define how assignments are published on your WordPress site.

  • Post author - defines who will be credited as the author of all assignments 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 assignment is in the Content Marketing category in EasyContent, if 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 in WordPress.

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 it so it would be added to your list of assignments. 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 push this article, 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 our plugin successfully detected/recognized that you have 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 uploaded 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 filesize 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 lists all items in your Assignments page on the connected EasyContent project. You can use this page to sync articles from the project to the WordPress site.

  1. Refresh all data - this button refreshes the item list to display recent additions to the assignments page. Every time you assign, claim, or cancel an assignment on EasyContent, you should use this button to update the article list.
  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, and filter by workflow and sync status.
  5. Assignment list - this table shows you all current items in 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 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.

Integrations

Back to Help page