WordPress Connector

WordPress Connector FAQs

Why do my URLs have parameters like ?noredirect=es_ES, ?noredirect=fr_FR and ?noredirect=en_US?

These URL parameters are a feature of the MultilingualPress plugin, which handles the delivery of your translated WordPress sites. Read more about the redirect feature here. You can disable the feature by navigating to the MultilingualPress settings page and unchecking HTTP Redirect.

Why does my language selector show all languages, not just languages with available translations?

The Language Selector is a feature of the MultilingualPress plugin and will show all languages for your site, regardless of whether translations exist.

What happens when I update a tag or category for an article that is already translated?

Translated posts will be updated also, but how long this take will depend on your settings and how many changes have been made. When you make any updates to a post or page that has translations, it is marked as Outdated. Depending on your settings, the changes may be uploaded to Smartling automatically, or you may need to request an update manually.

When the translated post is downloaded to WordPress, it will be rebuilt with updated metadata.

Can I translate URL slugs?

By default, the ‘slug’ property of a post is excluded from translation, but you can change this by navigating to your Smartling settings profile and removing slug from the Exclude fields by field name list.

Can I translate permalinks?

Not directly but, since WordPress uses the post_name field to generate permalinks, you can alter permalinks by translating the post_name field. This field is excluded by default, but can be translated by removing the post_name entry from your Exclude fields by field name setting in your Smartling settings profile.

How fast does upload/downloads happen?

Like all large operations on WordPress, uploads and downloads between WordPress and Smartling are background tasks governed by a cron configuration. Cron configuration can be edited from your Smartling Settings profile.

By default:

  • Posts marked ready to upload are uploaded every 5 minutes.
  • Translation progress in Smartling is checked and completed translations downloaded every 3 hours.

The exception is when you upload a single post from the Smartling widget, which occurs immediately.

How to exclude some content from translation?

That is a common issue of a customizable WordPress installation. Since the WP Connector cannot guess what should be translated and what should not be translated, then the WP Connector uses the "greedy" approach - to ingest as much as possible content.

The first step should be to figure out a field name that contains unwanted content.

  • Go to Dashboard and download the required XML file.
  • Open it and walk through the <string> elements.
  • Each element has a name attribute, which is a field name.

Now you know the field name, and you can apply one of 3 possible options:

1) To remove the field from translation:

  • Go to Profile Edit Screen > Expert Settings > Exclude fields by field name
  • Add field name to Exclude fields by field name box

2) To copy the field without translation:

  • Go to Profile Edit Screen > Expert Settings > Copy fields by field name
  • Add field name to Copy fields by field name box

3) To copy the field without translation by field value:

  • Go to Profile Edit Screen > Expert Settings > Copy by field value
  • Add field name to Copy by field value box

Filter boxes support full field names, partial field names and regular expressions.

What is the Translation Locked checkbox for?

This is an option for a translated post that prevents the connector from downloading new translations for the post, even if changes are available. See here for more details.

What happens when I edit a post that’s already been translated?

If you have configured the plugin to resubmit changed content automatically, then your changes will be uploaded to Smartling immediately. Otherwise, the post will be flagged as outdated and you can resubmit it manually when you’re ready.

What does the ‘Translation completed’ checkbox do?

The Translation completed checkbox in the Publish widget is part of the MultilingualPress plugin and does not have any effect in Smartling.

What does Enqueue for Upload/Download do?

The Enqueue for Upload/Download bulk actions add the selected items to a queue of items that will be uploaded by a Cron task. This is to stop large uploads from slowing down your WordPress instance. You can change the frequency of this task by editing your crontab.

Does submitting a single post from the Smartling widget work faster than using Bulk Submit or the Submissions Board?

Yes. Bulk Submit and the Submissions board use cron tasks, which is necessary to avoid timeout issues on WordPress. If you need a post in the Dashboard as soon as possible, the Smartling Widget in the post’s edit view is the fastest way.

How do I get my content into Smartling?

The Connector offers three ways to submit your source content to Smartling.

  • Bulk submit (/wp-admin/admin.php?page=smartling-bulk-submit) was designed to be the primary means of submitting content. It allows you to submit multiple posts, tags, menus, and other entities for multiple locales in a single click. Some entities can be submitted only from Bulk submit: Theme Widgets Media Attachments * Navigation Menus
  • The Smartling widget on the Post Edit screen. This allows you to submit only current post for chosen locales
  • The Submissions Board is similar to Bulk Submit, but here you can find only content/entities that were submitted before. Use this view to resubmit content that you want to retranslate, for example because the source content has changed.

Can I submit content from a translated site?

Each Smartling project has only a single source language. If you want to submit content from another language--for example, you may want to submit content written in your Spanish (es-ES) site to push it to other Spanish locals (es-CO, es-MX, es-AR, etc)--you need to first create a new Smartling project with the appropriate source language.

Then create a new Smartling Settings Profile on WordPress, using the details of the new project.

If you have previously tried to upload any content in your alternate source language, you will need to upload this content again.

Can I clone a site for different environments?

Although there is no restriction to cloning or duplicating a site on WordPress, there 

You may have to clone a site on Wordpress for a number of reasons, including having content on two different environments (staging and production). While the content may be the same on both sites, it is important to remember that the Wordpress Connector does not support multisite connection. Content may be in different states in Wordpress in each site, but the Connector only has visibility over one site, as it uses a unique Smartling project ID for each integration.

If you want the Wordpress Connector to work on multiple site, you should create a Wordpress Project for each connection to avoid losing content. To save some time, you could clone the WordPress project as well as cloning the WordPress site.


Was this article helpful?