Connectors

WordPress Connector

WordPress is an open-source blogging and web content management system. It also supports mailing lists, forums, media galleries, analytics, and online stores.

By installing the Memsource plugin, users are able to translate blog posts, pages, tags, and categories. In a project you can manually select pages for translation and then manually upload them back to your WordPress site, or you can configure Automated Project Creation and download / upload the files automatically.

Requirements

  • WordPress Version: 3.7 or higher
  • PHP Version: 5.6 or higher
  • WPML Plugin: Version 3.7 or higher

Supported Text Types

Memsource can translate the following text from WordPress:

  • Posts
  • Pages
  • Tags
  • Categories
  • Custom post types

Content from WordPress will always be imported as HTML files.

WPML Plugin for WordPress

Your WordPress website will need a WPML plugin to create and manage multilingual pages. These pages are then used by the Memsource WordPress Plugin. Version 3.7 or higher of WPML Multilingual CMS is required.

Languages in WPML must match the languages of the Memsource project. To support local variations such as French (Canada), define the languages in the WPML panel inside WordPress.

Set up the Memsource Plugin in WordPress

Connector

To set up a new connector, go to Memsource in the left-hand navigation panel, click Connector, and then click Show Connector settings.

Note the hyperlink Generate new token. You will need this hyperlink to generate a token to establish a connection between Memsource and WordPress. The setup instructions are outlined in detail below.

Select which posts should be imported based on their status, and what status should be assigned to the translated posts sent back from Memsource to WordPress.

WP_conn_settings.png

Translatable Content

The Memsource Translation Plugin for WordPress includes a Translatable Content page. The Custom fields section lists all the custom fields included in a WordPress site. Users can choose which custom fields from this list should be exported from WordPress and translated in Memsource.

 

Note: All custom fields are selected for export into Memsource by default.

Language Mapping

The Memsource Translation Plugin for WordPress includes a language mapping page. This is where users must map their preferred WPML language codes to Memsource. The language codes on the mapping page and those in Memsource need to match for the Memsource WordPress Connector to work properly. See our list of all the supported language codes in Memsource.

Shortcodes

The Memsource Translation Plugin for WordPress includes a shortcode editor, which can be used to add custom shortcodes to those in your WordPress site. To access the shortcode editor, hover over the Memsource plugin in the left-hand navigation panel of your WordPress site and then click Shortcodes. To use the shortcode editor, a custom shortcode must first be created using a third-party shortcode plugin.

Visual Page Builders

The following Visual Page Builders are supported by the Memsource Translation Plugin for WordPress:

  • Avada
  • Divi
  • WPBakery Page Builder (formerly Visual Composer)
  • Avia (Enfold Theme)
    • Enfold custom fields must be deselected because they are not supported. Click on the Memsource Plugin in your WordPress account, and go to the Translatable Content page to deselect the Enfold custom fields.

Once you install a Visual Page Builder, you can view the shortcodes supported by the Memsource Plugin in the Shortcodes Page. The shortcodes from the Visual Page Builder cannot be modified. To access the Shortcodes page, hover over the Memsource plugin in the left-hand navigation panel of your WordPress site and then click Shortcodes.

Set up the Plugin for WordPress in Memsource

Once you have your plugin set up in WordPress, please log in to your Memsource account separately and follow the steps listed below:

Step 1: To set up a new connector, go to the Memsource Setup page. Under the Integrations section, click on Connectors, and then select New.

Step 2: Select the WordPress option.

Step 3: Add your WordPress site URL prefix to the WordPress site URL field. For example, if your WordPress admin page URL is http://blog.memsource.com/wp-admin/index.php, the prefix would be http://blog.memsource.com/.

Step 4: Go back to the Memsource connector page in your WordPress account and click the Generate new token hyperlink. Copy the resulting token and paste it into the Memsource WordPress plugin token field.

Step 5: Click Test connection. Memsource should connect to your WordPress site and display a list of languages configured by the WPML plugin (as described above). If the WPML plugin is not found, an error message will appear.

Step 6: If everything is OK, Save the connector.

Troubleshooting

What to do if Memsource Imports Text Full of Code

Some Wordpress add-ons will inject code into your WordPress pages. Memsource does not handle that code out of the box and needs to be configured to properly handle this. The add-ons that are known to cause this issue are:

  • Avia Layout Builder
  • Divi Builder
  • Fusion Builder
  • Visual Composer
  • WPBakery (formerly Visual Composer)

To configure Memsource in this case, please indicate in WordPress which custom fields you wish to translate. Go to Memsource Plugin in your WordPress, then Shortcodes, and add the shortcodes based on the specification of the addon format. For Bakery, the settings are shown below: