-
Ultimate and Enterprise plans (Legacy)
Get in touch with Sales for licensing questions.
Tip
For information about WordPress integration in Phrase Strings, refer to WordPress (Strings).
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 Phrase 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 Phrase without 2FA. The endpoints used by the connector are already secured with a Phrase token and security can be improved by adding a basic auth and/or only allowing access from Phrase IPs.
-
WordPress Version: 4.9 or higher, including multi-site installations (Phrase 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 CAT 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 Phrase Translation Plugin for WordPress:
-
Avada
-
Divi
-
Elementor
-
Gutenberg
-
Predefined blocks are configured automatically. Configure in Gutenberg blocks under the menu. If not configured, content will not be imported.
-
-
Yoast SEO
-
SEOPress
-
WPBakery Page Builder (formerly Visual Composer)
-
Avia (Enfold Theme)
-
Enfold custom fields must be deselected because they are not supported. Click on the Phrase Plugin in your WordPress account and go to the 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. Phrase 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 new projects automatically created 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 In-context preview feature offers a real-time preview of original or translated text in both the CAT web editor and CAT desktop editor.
Phrase 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 CAT 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.
-
Navigate to the Custom fields page and select custom fields from the list that should be exported from WordPress and translated. All custom fields are selected for export by default.
-
Navigate to the page and map WordPress languages to Phrase 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 language codes.
Note
Languages in WPML must match the languages of the 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.
-
Enter the WordPress site URL.
Example: If your WordPress admin page URL was http://blog.phrase.com/wp-admin/index.php, the site URL would be http://blog.phrase.com/.
-
Enter the Phrase WordPress plugin token with the token from Phrase 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. Hover 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 page.
What to do if imported text is full of code
Some WordPress add-ons inject code into your WordPress pages. Phrase 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 Phrase 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.