Download

Theme and plugin translation for Polylang (TTfP)

By Marcin Kazmierski

Description

What is “Theme and plugin translation for Polylang”?

Extension for Polylang plugin (Polylang is an extension to make multilingual WordPress websites.).
Plugin is needed to translate the WordPress themes and plugins by Polylang.

How it is work?

“Theme and plugin translation for Polylang” automatically searches all files of WordPress themes and plugins. It chooses from this file only those files with extensions:

  • php
  • inc
  • twig

In addition, is implemented the integration with Timber library (read more: http://timber.upstatement.com) – which allows to translate twig’s skins in simple way.
Plugin in searched skins or plugins chooses texts from Polylang functions, such as:

  • _e(string $text, string $domain = ‘default’);
  • __(string $text, string $domain = ‘default’);
  • _x(string $text, string $context, string $domain = ‘default’);
  • pll_e(string $text);
  • pll__(string $text);
  • esc_html(string $text);
  • esc_html_e(string $text, string $domain = ‘default’);
  • esc_html__(string $text, string $domain = ‘default’);
  • _n(string $single, string $plural, int $number, string $domain = ‘default’);
  • esc_attr_e(string $text, string $domain = ‘default’);
  • esc_attr__(string $text, string $domain = ‘default’);

In your function.php, themes or plugins.

For example:

<p><?php pll_e('My text'); ?></p>

<p><?php _e('My another text', 'my_theme'); ?></p>

On the timber context declare this functions like:

$context['pll_e'] = TimberHelper::function_wrapper('pll_e');

$context['pll_'] = TimberHelper::function_wrapper('pll_');

See more on: https://polylang.wordpress.com/documentation/documentation-for-developers/functions-reference/
This functions are defined by Polylang plugin for printing translations.
Thanks “Theme and plugin translation for Polylang” you can find these strings to translate and add to Polylang register on very simple way.
And then you can translate these texts from the admin dashboard.
The scan result can be seen on the tab with translations:
Settings -> Languages -> String translation
or
Languages -> String translation

You don’t need programs like poedit – you don’t change files with extensions like: .pot, .po, .mo.
“Theme and plugin translation for Polylang” is highly efficient because the scanner is worked only on admin dashboard in tab:

Settings -> Languages -> String translation

or

Languages -> String translation

Export and import string translation

Languages -> Export/import translations

Screenshots

  • Screen show "Polylang" strings translations with "Theme and plugin translation for Polylang".
  • Export/import translations as CSV file with "Theme and plugin translation for Polylang".
  • Settings - Select area to be scanned in Strigs translations polylang tab.

Installation

This plugin requires installed and activated the Polylang plugin,
This plugin requires PHP 5.0

  1. Upload the “Theme and plugin translation for Polylang” folder to the /wp-content/plugins/ directory on your web server.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Go to the Settings -> Languages -> String translation or Languages -> String translation and find your texts.

Use

<?php
 pll_e('My string'); // similar to _e();
 // or:
 $var = pll_('My string'); // similar to __();
 // or:
  _e('My string', 'my_theme');
 // or:
  $var = __('My string', 'my_theme');

How to enable Twig extension with “Theme and plugin translation for Polylang”? [Timber plugin]

In functions.php add:

if (!class_exists('Timber')) {
    add_action('admin_notices', function () {
        echo '<div class="error"><p>Timber not activated. Make sure you activate the plugin in <a href="' . esc_url(admin_url('plugins.php#timber')) . '">' . esc_url(admin_url('plugins.php')) . '</a></p></div>';
    });
    return;
}

function timber_context()
{
    $context = Timber::get_context();
    $post = Timber::query_post();
    $context['post'] = $post;
    $context['pll_e'] = TimberHelper::function_wrapper('pll_e');
    $context['pll__'] = TimberHelper::function_wrapper('pll__');
    return $context;
}

Timber::$dirname = array('templates', 'views'); // directory names with twig templates
timber_context();

Next, for example in index.php add:

<?php
 $context = timber_context();
 $templates = array('home.twig', 'index.twig'); // twig files for render
 Timber::render($templates, $context);

Then you can use in twig templates polylang functions like this (in templates/home.twig):

{% extends "base.twig" %}
 {% block content %}
     <p>
         {{ pll_e("Test text on TWIG template 1.") }}
     </p>
     <p>
         {{ pll__("Test text on TWIG template 2.") }}
     </p>
 {% endblock %}

Reviews

Something PLL should natively have

December 23, 2021
It's odd that we need an additional plugin for this functionality, but i'm happy it's here. Detracted one star because the string translation page in the admin is very slow. I suspect it's rescanning all files on page load? Perhaps it's better to cache the results, and allow a manual "refresh strings" setting? Even when filtering to just a small theme with a couple dozen strings takes a while.

Отличный плагин! Must have.

November 2, 2021
Если вы, как и я, когда-то пользовались плагином qTranslate X, и не любите всякие автоматические решения по переводу вашего сайта (которые дерут деньги за каждую переведённую букву), и любите всё настраивать вручную - то конечно же вы будете использовать бесплатный плагин Polylang. А этот вот плагин, в связке с ним позволяет переводить захардкоженные в шаблоне тексты, например заголовки блоков, инфу в "подвале" и прочие моменты. Совместим с Advanced Custom Fields. Буду теперь использовать в каждом мультиязычном проекте.

great plugin

June 30, 2021
great plugin, really useful in addition to Polylang. @developer: Please keep developing it!

Super very usefull plugin

June 15, 2021
This is a great addition to use with Polylang. You can translate almost all the theme and plugin texts in an easy way.

Great for translating Bookly

June 1, 2021
Excellent! Greatly expands the usefulness of Polylang. I am using it to translate Bookly, which recommends WPML. This plugin makes that subscription unnecessary. If you are doing the same, I recommend looking at the Bookly documentation for using WPML, which clarifies some points.
Read all 23 reviews

Contributors & Developers

“Theme and plugin translation for Polylang (TTfP)” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Theme and plugin translation for Polylang (TTfP)” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

3.2.12 – 2021/06/15

  • Added esc_attr_e and esc_attr__ filter.

3.2.11 – 2021/05/17

  • Added esc_html filter.
  • Test with WordPress 5.7.2 version and Polylang version 3.0.4.
  • Updated version.

3.2.10 – 2021/05/10

  • Fixed gettext_with_context filter.

3.2.9 – 2021/05/04

  • Updated scanner regex.

3.2.8 – 2021/05/03

  • Updated scanner regex.
  • Updated readme.

3.2.7 – 2021/05/03

  • Updated scanner regex: added esc_html__.

3.2.6 – 2021/04/27

  • Updated scanner regex.
  • Test with Polylang version 3.0.4.
  • Updated version.

3.2.5 – 2021/02/20

  • UTF-8 header in csv exporter.
  • Test with Polylang version 2.9.2.
  • Updated version.

3.2.4 – 2020/09/13

  • Added ngettext polylang filter.
  • Added to file skaner function _n(): single + plural.
  • Test with Polylang version 2.8.2.
  • Updated version.

3.2.3 – 2020/03/26

  • Updated screens.
  • Refactoring.
  • Test with Polylang version 2.6.10.
  • Updated version.

3.2.2 – 2020/02/02

  • Fixed gettext filter.
  • Test with WordPress 5.3.2 version and Polylang version 2.6.9.
  • Updated version.

3.2.1 – 2019/12/07

  • Updated version.
  • Test with WordPress 5.3 version and Polylang version 2.6.7

3.2.0 – 2019/09/26

  • Added setting section in “Export/import translations” tab.
  • Updated version.

3.1.1 – 2019/09/20

  • Fix file scanner.
  • Updated version.

3.1.0 – 2019/09/13

  • Translate strings from functions: _e( string $text, string $domain = ‘default’ ) and __( string $text, string $domain = ‘default’ ).
  • Updated plugin description.
  • Test with WordPress 5.2.3 version and Polylang version 2.6.x.
  • Updated version.

3.0.0 – 2019/05/12

  • Added import and export feature.
  • Updated plugin description.
  • Test with WordPress 5.2 version and Polylang version 2.5.x.
  • Updated version.

2.0.4 – 2018/12/10

  • Test with WordPress 5.0 version and Polylang version 2.5.
  • Updated version.

2.0.3 – 2018/07/04

  • Test with WordPress 4.9.5 version and Polylang version 2.3.4.
  • Updated version.

2.0.2 – 2018/01/02

  • Updated plugin description.
  • Test with WordPress 4.9 version and Polylang version 2.2.7.
  • Updated version.

2.0.1 – 2017/10/03

  • Test with WordPress 4.8 version and Polylang version 2.2.3.
  • Updated version.

2.0.0 – 2017/03/05

  • Added plugin scanner.
  • Updated version.

1.4.0 – 2017/01/29

  • Polylang version 2.1 – fixed: polylang changed default tab.
  • Updated version.

1.3.3 – 2017/01/09

  • Test with WordPress 4.7 version and Polylang version 2.0.12.
  • Updated version.

1.3.2 – 2016/09/07

  • Test with 4.6.1 WordPress version.
  • Updated version.

1.3.1 – 2016/06/07

  • Added plugin logo.

1.3 – 2016/05/15

  • Fixed warnings.
  • Test with 4.5 WordPress version.
  • Updated description.
  • Updated version.

1.2 – 2016/03/27

  • Updated description.

1.1 – 2016/02/03

  • Fixed readme.txt

Meta

Ratings

See all
Log in to submit a review.

Contributors

Support

Issues resolved in last two months:

2 out of 3

View support forum