WordPress is an open-source blogging and web content management system. It also supports mailing lists, forums, media galleries, analytics, and online stores.
The connector supports WPML and Multilingual Press plugins. It automatically detects which plugin is installed during the Memsource Plugin installation. Which mode the plugin is running in can be viewed in settings.
The connector does not support 2FA. 2FA can be enabled for wp-admin or the frontend, but all endpoints starting with /wp-json/memsource/v1/connector must be accessible from Memsource without 2FA. The endpoints used by the connector are already secured with a Memsource token and security can be improved by adding a basic auth and/or only allowing access from Memsource IPs.
-
WordPress Version: 4.9 or higher, including multi-site installations (Memsource plugin and WPML need to be installed to all sites)
-
PHP Version: 7.0 or higher
-
WPML Plugin: version 3.7 or higher
-
Multilingual Press Plugin: version 3.7.0 or higher
Supported Content Types
WordPress connector allows the downloading of source content and uploading of target localizations directly to/from WordPress for the following content types:
-
Posts
-
Pages
-
Tags
-
Categories
-
Custom post types
-
Custom taxonomies
Supported Statuses
-
Published and Draft (In-context preview supported for posts and derived content)
Note
Some HTML tags present a risk and the Memsource Editor removes them from this HTML when displaying the preview. This is to ensure user's data privacy and security.
Examples of removed tags include FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT or background-image CSS properties.
Supported Plugins
The following plugins are supported by the Memsource Translation Plugin for WordPress:
-
Avada
-
Divi
-
Elementor
-
Gutenberg
-
Yoast SEO
-
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.
-
There are a number of use cases for the connector:
-
Project Managers can add files directly to projects from an online repository.
-
With the Advanced Custom Fields (ACF) plugin, individual workflows can be defined within WordPress. Memsource monitors the changes to workflow steps and updates them accordingly, e.g. from Translate to Translation in Progress to Translation Completed.
-
Set up the submitter portal to allow Submitters to add files to requests directly from the online repository.
-
Use Automated Project Creation (APC) to have Memsource automatically create new projects when a change in the last modified date is detected for monitored files or a folder.
-
Selected files are imported the very first time APC runs. All files are imported when a folder is monitored.
-
-
The Connector API can be used to automate steps otherwise performed manually through the UI. Webhooks can be used to have Memsource notify 3rd party systems about certain events (for example, a job status change).
The In-context Preview feature offers a real-time preview of original or translated text in both the Memsource Editor for Web and Memsource Editor for Desktop.
In order for Memsource to offer the real-time preview, it must have access to unpublished pages in an on-premise author node.
Memsource Requirements:
-
Pass through the enterprise firewall to access the on-premise installation.
-
Authenticate into the authoring environment.
Firewall Configuration for On-premise installation:
-
Installation must be accessible from the following IP addresses:
34.243.87.13, 34.248.197.209, 108.129.22.31, 3.248.158.93
-
Domain name must be able to be resolved externally.
Note
Some HTML tags present a risk and the Memsource Editor removes them from this HTML when displaying the preview. This is to ensure user's data privacy and security.
Examples of removed tags include FORM, IFRAME, SCRIPT, SVG, VIDEO, EMBED, OBJECT or background-image CSS properties.
-
Install the WPML or Multilingual Press plugin to create and manage multilingual pages.
-
Go to in the left-hand navigation panel.
-
Click Connector and then Show Connector settings.
-
Click Generate new token to generate a token to establish the connection.
-
Select which posts should be imported based on their status and what status should be assigned to the translated content sent back from Memsource.
-
Navigate to the page and select custom fields from the list that should be exported from WordPress and translated in Memsource. All custom fields are selected for export by default.
-
Navigate to the page and map WordPress languages to Memsource language codes.
-
Go to the page to see the list of supported shortcodes or add a custom shortcode that was created using a third-party shortcode plugin.
-
Provide Translate to languages specified in (APC).
Automated Project Creation only creates jobs for languages specified in the custom field identified by its – e.g. target_languages. The field type should be the multi-value picklist, where the values match the Memsource language codes.
Note
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.
-
From the Settings
page, scroll down to the section. -
Click on Connectors.
The page opens.
-
Click New.
The page opens.
-
Provide a name for the connection and change the Type to WordPress .
-
Enter the WordPress site URL.
Example: If your WordPress admin page URL was http://blog.memsource.com/wp-admin/index.php, the site URL would be http://blog.memsource.com/.
-
Enter the Memsource WordPress plugin token with the token from Memsource plugin configuration.
-
If the site is secured using basic HTTP authentication, provide Username and Password as set in WP admin.
-
Click Test connection.
A list of configured languages will appear if the connection was successful. A red exclamation point will appear with an error message if it wasn't. Mouse over the icon to see additional details.
If the source or target is changed, clicking will refresh the selection of configured languages.
-
Click Save.
The connector is added to the list on the Connectors page.
If a default project, branch, and folder is required when connecting, open the connector configuration and click the Select Remote Folder button to set it.
What to do if Memsource Imports Text Full of Code
Some WordPress add-ons inject code into your WordPress pages. Memsource does not handle this code without further configuration.
Add-ons 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, indicate in WordPress which custom fields you wish to translate.
Go to Plugin, then , and add the shortcodes based on the specification of the addon format.
WPBakery settings:
Connection Test Fails when Configuring the Connector
Some WordPress plugins, like WP Hardening, WP Security, WP Staging, Disable WP REST API, or Wordfence Security, provide options for disabling the JSON API. Ensure the WordPress API is not disabled.