- Скопируйте содержимое оригинального поста с помощью Polylang в его бесплатной версии
- Показать общее количество сообщений, переведенных с помощью Polylang на каждом языке
- Добавьте родные баннеры Polylang на любую страницу или сообщение
- Добавление SVG-значка рядом с переключателем языка
- Показывайте настраиваемое предупреждение о существовании версии на иностранном языке

Хотя существуют разные мнения о том, какой плагин лучше для создания многоязычного блога, и все они сильно эволюционировали со времен своих первых версий, упростив и облегчив задачу, одним из самых используемых является Polylang.
Имея на сегодняшний день более 700 000 активных установок, он остается одним из самых легких и эффективных вариантов.
Здесь представлен небольшой список сниппетов с функциями и фильтрами, которые могут пригодиться в какой-то момент. Все они работают в бесплатной версии Polylang и были протестированы и/или использованы здесь.
Скопируйте содержимое оригинального поста с помощью Polylang в его бесплатной версии
Если вы пользуетесь бесплатной версией плагина Polylang для WordPress, то уже знаете, что новая страница или пост, которые он генерирует для перевода , не копирует оригинальное содержимое. Это одна из особенностей его платной версии, а в бесплатной версии вам придется вставлять содержимое вручную.
Чтобы решить эту проблему и ускорить процесс, просто добавьте эти функции в файл functions.php вашего шаблона. Теперь при добавлении нового перевода он будет открываться с оригинальным скопированным содержимым (название и содержание).
// Copying content when creating a translation with Polylang
function jb_editor_content( $content ) {
// Polylang sets the 'from_post' parameter
if ( isset( $_GET['from_post'] ) ) {
$my_post = get_post( $_GET['from_post'] );
if ( $my_post )
return $my_post->post_content;
}
return $content;
}
add_filter( 'default_content', 'jb_editor_content' );
// Copy title when creating a translation with Polylang
function jb_editor_title( $title ) {
// Polylang sets the 'from_post' parameter
if ( isset( $_GET['from_post'] ) ) {
$my_post = get_post( $_GET['from_post'] );
if ( $my_post )
return $my_post->post_title;
}
return $title;
}
add_filter( 'default_title', 'jb_editor_title' );
*Тиссниппетбыл найден в заметке от декабря 2020 года. Хотя он все еще работает, не помешает следить за ним на случай, если со временем и в будущих обновлениях Polylang он выйдет из строя.
Показать общее количество сообщений, переведенных с помощью Polylang на каждом языке
Эта функция позволяет добавить шорткод для каждого языка, который будет показывать общее количество постов, опубликованных на языке, на который есть переводы, добавленные с помощью плагина Polylang.
Эта функция более чем проверена и работает правильно на моей странице статистики и полезна для ведения списка счетчиков, которые автоматически обновляются.
Сниппет добавляется в файл functions.php шаблона :
// Function to display number of published posts by language for Polylang
function polylang_post_count_by_language($atts) {
// Atributos del shortcode
$atts = shortcode_atts(array(
'lang' => '', // Código de idioma (ej: 'es', 'en', etc.)
), $atts, 'post_count_by_lang');
// Check if Polylang is active
if (!function_exists('pll_languages_list')) {
return 'Polylang plugin is not active.';
}
// Get the language code
$lang = $atts['lang'];
if (empty($lang)) {
return 'Language code is required.';
}
// Single key for transient
$transient_key = 'post_count_by_lang_' . $lang;
// Trying to get the count from the cache
$post_count = get_transient($transient_key);
// If there is no cache, perform the query
if (false === $post_count) {
// Configure the query to count posts by language
$args = array(
'lang' => $lang,
'post_type' => 'post', // Type of post (you can change it if necessary)
'post_status' => 'publish', // Only published posts
'fields' => 'ids', // Only obtain IDs to reduce the burden
'numberposts' => -1, // All posts
);
// Make an enquiry
$query = new WP_Query($args);
// Get the total number of posts
$post_count = $query->found_posts;
// Cache for 12 hours (43200 seconds)
set_transient($transient_key, $post_count, 43200);
}
// Return the number of posts
return $post_count;
}
add_shortcode('post_count_by_lang', 'polylang_post_count_by_language');
Одна из проблем, с которой мы столкнулись, заключается в том, что если на вашем сайте много постов на разных языках, как в случае с этим блогом, влияние запроса к базе данных может замедлить скорость загрузки. В коде это учтено, и запрос оптимизирован с помощью WP_Query с полями => 'id', чтобы уменьшить затраты памяти, не загружая целые объекты постов.
Количество постов хранится с помощью set_transient и позволяет избежать повторяющихся запросов к базе данных. В примере кэш обновляется каждые 12 часов, выраженных в секундах (вы можете настроить это время в соответствии с вашими потребностями).
Для оптимизации запроса вместо get_posts используется WP_Query для доступа к found_posts, который возвращает общее количество постов без необходимости загружать все объекты.
Параметр fields => 'ids' уменьшает нагрузку на память, получая только идентификаторы постов.
Если в какой-то момент вам нужно очистить кэш вручную (например, после публикации нового поста), чтобы он не показывал устаревшие данные, вы можете использовать его:
delete_transient('post_count_by_lang_' . $lang);
Если вы предпочитаете автоматизировать этот процесс, следующая функция будет удалять переходник каждый раз, когда пост публикуется, обновляется или удаляется. Если вы добавите ее в functions.php вашего шаблона, хук будет активирован для всех этих действий:
//Deleting the transient when publishing, updating or deleting a post
function clear_post_count_transient($post_id) {
// Check if the post is of type 'post' (or the type you are counting).
if (get_post_type($post_id) === 'post') {
// Get the language of the post using Polylang
if (function_exists('pll_get_post_language')) {
$lang = pll_get_post_language($post_id);
// If the language is obtained, delete the corresponding transient.
if ($lang) {
delete_transient('post_count_by_lang_' . $lang);
}
}
}
}
add_action('save_post', 'clear_post_count_transient'); // When publishing or updating
add_action('delete_post', 'clear_post_count_transient'); // By deleting
А этот автоматически очищает кэш в соответствии с несколькими возможными сценариями(включая приведенный выше):
// Function to delete the transient when necessary
function clear_post_count_transient($post_id) {
if (get_post_type($post_id) === 'post') {
if (function_exists('pll_get_post_language')) {
$lang = pll_get_post_language($post_id);
if ($lang) {
delete_transient('post_count_by_lang_' . $lang);
}
}
}
}
add_action('save_post', 'clear_post_count_transient');
add_action('delete_post', 'clear_post_count_transient');
//Function to delete transient when changing the language of a post
function clear_post_count_transient_on_language_change($post_id, $lang) {
$old_lang = pll_get_post_language($post_id);
if ($old_lang) {
delete_transient('post_count_by_lang_' . $old_lang);
}
if ($lang) {
delete_transient('post_count_by_lang_' . $lang);
}
}
add_action('pll_save_post', 'clear_post_count_transient_on_language_change', 10, 2);
// Function to delete all transients when uninstalling or deactivating Polylang
function clear_all_post_count_transients() {
if (function_exists('pll_languages_list')) {
$languages = pll_languages_list();
foreach ($languages as $lang) {
delete_transient('post_count_by_lang_' . $lang);
}
}
}
register_deactivation_hook(__FILE__, 'clear_all_post_count_transients');
register_uninstall_hook(__FILE__, 'clear_all_post_count_transients');
Числа отображаются с помощью шорткода для каждого языка с соответствующим кодом там, где вы хотите отобразить число. Выглядит это следующим образом:
For Spanish: [post_count_by_lang lang="es"]
For English: [post_count_by_lang lang="en"]
For German: [post_count_by_lang lang="de"]
For French: [post_count_by_lang lang="fr"]
etc.
Вы можете изменить'post_type' в коде, если хотите учитывать другие типы контента (страницы, пользовательские типы постов и т.д.).
В этом URL есть пример работы шорткодов.
Добавьте родные баннеры Polylang на любую страницу или сообщение
Поскольку Polylang включает в себя коллекцию из 249 флагов размером 16x11 в формате .png, мы можем использовать их для оформления списков, добавления в таблицы, абзацы и т.д. без необходимости писать HTML или CSS.
Эта функция позволяет добавить изображение любого нативного баннера, используемого плагином, через шорткод.
Чтобы сделать их доступными, добавьте сниппет в functions.php вашей дочерней темы, в пользовательский плагин или в Code Snippet, если вы его используете.
function polylang_flag_shortcode($atts) {
// Shortcode attributes
$atts = shortcode_atts(array(
'code' => '', // Flag code (e.g. 'es', 'en', 'fr')
'size' => '16', // Flag size (width in pixels)
), $atts, 'polylang_flag');
// Check if a flag code was provided
if (empty($atts['code'])) {
return 'Flag code not provided.';
}
// Polylang flag base route
$flag_path = plugins_url('polylang/flags/' . $atts['code'] . '.png');
// Create the HTML of the flag image
$flag_html = '<img src="' . esc_url($flag_path) . '" alt="' . esc_attr($atts['code']) . '" width="' . esc_attr($atts['size']) . '" height="auto" />';
return $flag_html;
}
add_shortcode('polylang_flag', 'polylang_flag_shortcode');
После добавления кода вы можете использовать шорткод с соответствующим кодом страны на любой странице или в любом посте WordPress , убедившись, что он точно соответствует названиям файлов флагов в папке /wp-content/plugins/polylang/flags/.
[polylang_flag code="en" size="32"]
[polylang_flag code="fr" size="24"]
//Original size
[polylang_flag code="de"]
Чтобы изменить размер флагов, просто измените значение атрибута size в шорткоде.
Если вы хотите создать и использовать свои собственные баннеры или другую коллекцию с другим дизайном, просто разместите новые баннеры (в формате .png) в новой папке с другим именем (иначе вы потеряете изменения при обновлении плагина) и добавьте новый путь в код. Например:
$flag_path = plugins_url('polylang/nuevas_banderas/' . $atts['code'] . '.png');
Добавление SVG-значка рядом с переключателем языка
Этот сниппет добавляет SVG-иконку с символом "Перевести" слева от переключателя родного языка Polylang, чтобы сделать его более визуально привлекательным и привлечь внимание посетителя. В примере использована иконка, которую я использую в этом блоге. Вы можете найти ту, которая вам больше всего нравится, и заменить ее. Вот несколько из них.
function polylang_add_translate_icon($output) {
//SVG icon for "translate".
$translate_icon = '<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="vertical-align: middle; margin-right: 5px;"><path d="M24 24h-2.784l-1.07-3h-4.875l-1.077 3h-2.697l4.941-13h2.604l4.958 13zm-4.573-5.069l-1.705-4.903-1.712 4.903h3.417zm-9.252-12.804c.126-.486.201-.852.271-1.212l-2.199-.428c-.036.185-.102.533-.22 1-.742-.109-1.532-.122-2.332-.041.019-.537.052-1.063.098-1.569h2.456v-2.083h-2.161c.106-.531.198-.849.288-1.149l-2.147-.645c-.158.526-.29 1.042-.422 1.794h-2.451v2.083h2.184c-.058.673-.093 1.371-.103 2.077-2.413.886-3.437 2.575-3.437 4.107 0 1.809 1.427 3.399 3.684 3.194 2.802-.255 4.673-2.371 5.77-4.974 1.134.654 1.608 1.753 1.181 2.771-.396.941-1.561 1.838-3.785 1.792v2.242c2.469.038 4.898-.899 5.85-3.166.93-2.214-.132-4.635-2.525-5.793zm-2.892 1.531c-.349.774-.809 1.544-1.395 2.15-.09-.646-.151-1.353-.184-2.108.533-.07 1.072-.083 1.579-.042zm-3.788.724c.062.947.169 1.818.317 2.596-1.996.365-2.076-1.603-.317-2.596zm11.236-1.745l-2.075-5.533 5.414-1.104-.976 1.868c2.999 2.418 4.116 5.645 4.532 8.132-1.736-2.913-3.826-4.478-5.885-5.321l-1.01 1.958zm-7.895 10.781l1.985 5.566-5.43 1.016 1.006-1.852c-2.96-2.465-4.021-5.654-4.397-8.148 1.689 2.94 3.749 4.483 5.794 5.36l1.042-1.942zm10.795-6.029"/></svg>';
// Add the icon before the selector
return $translate_icon . '<span style="margin-left: 5px;">' . $output . '</span>';
}
add_filter('pll_the_languages', 'polylang_add_translate_icon');
Показывайте настраиваемое предупреждение о существовании версии на иностранном языке
Эта функция создает шорткод для отображения предупреждения с желтым фоном, которое можно добавить в любое место поста или страницы. Это сообщение предупреждает о том, что статья имеет английский перевод с Polylang, и предоставляет ссылку на английскую версию.
Я выбрал этот пример, потому что использовал его, когда статья на любом языке получала больше трафика из англоязычных стран и из англоязычных браузеров (что также не гарантирует, что человек, перешедший по ссылке, искал именно английскую версию). Тем не менее, в некоторых случаях это способ обеспечить удержание посетителей.
Код для добавления в functions.php
// English version notice
function polylang_translation_notice_shortcode() {
// Verifica si el plugin Polylang está activo
if (!function_exists('pll_the_languages')) {
return '';
}
// Get the ID of the current post
$post_id = get_the_ID();
// Get the English translation of the current post
$english_post_id = pll_get_post($post_id, 'en'); // 'en' es el código del idioma inglés
// Si no hay una traducción en inglés, no mostrará nada
if (!$english_post_id) {
return '';
}
// Get the link to the English version
$english_post_url = get_permalink($english_post_id);
// Crear el contenido del aviso
$ticker_content = sprintf(
'<div style="background-color: #ffffcc; padding: 10px; border-radius: 5px; margin-bottom: 20px; font-size: 14px;">
This article has an English version. <a href="%s" style="color: #0073e6; text-decoration: none; font-weight: bold;">Read</a>
</div>',
esc_url($english_post_url)
);
return $ticker_content;
}
add_shortcode('polylang_translation_notice', 'polylang_translation_notice_shortcode');
В стиле вы можете изменить сообщение, размер текста, цвета текста, фона и ссылки по своему вкусу.
Чтобы добавить сообщение куда угодно, просто используйте этот шорткод:
[polylang_translation_notice]
С помощью CSS в примере это выглядит следующим образом.

Если вы хотите добавить уведомление о переводе на другой язык, просто измените код языка в pll_get_post($post_id, 'en'); на 'fr', 'de', 'it' и т. д. Если вам нужно использовать несколько постов, вы можете добавить разные сниппеты, по одному для каждого языка. Можно добавить их все в один сниппет, но мне нужен был только один.