Cyr-To-Lat

ਵੇਰਵਾ

Converts Cyrillic characters in post, page and term slugs to Latin characters. Useful for creating human-readable URLs.

ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ

  • The only plugin with fully editable transliteration table. Allows add/remove and edit pairs like ‘Я’ => ‘Ya’, or even ‘Пиво’ => ‘Beer’
  • Converts any number of existing post, page and term slugs in background processes
  • Saves existing post and page permalinks integrity
  • Performs transliteration of attachment file names
  • Includes Russian, Belorussian, Ukrainian, Bulgarian, Macedonian, Serbian, Greek, Armenian, Georgian, Kazakh, Hebrew, and Chinese characters
  • Has many advantages over similar plugins
  • Officially compatible with WPML

Based on the original Rus-To-Lat plugin by Anton Skorobogatov.

ਸਕਰੀਨਸ਼ਾਟ

ਸਥਾਪਤੀਕਰਨ

  1. Upload cyr2lat folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.

ਅਕਸਰ ਪੁੱਛੇ ਜਾਂਦੇ ਸਵਾਲ

How can I define my own substitutions?

Add this code to your theme’s functions.php file:

/**
 * Modify conversion table.
 *
 * @param array $table Conversion table.
 *
 * @return array
 */
function my_ctl_table( $table ) {
   $table['Ъ'] = 'U';
   $table['ъ'] = 'u';

   return $table;
}

add_filter( 'ctl_table', 'my_ctl_table' );

How can I redefine non-standard locale ?

For instance, if your non-standard locale is uk_UA, you can redefine it to uk by adding the following code to your theme’s function.php file:

/**
 * Use conversion table for non-standard locale.
 *
 * @param array $table Conversion table.
 *
 * @return array
 */
function my_ctl_table( $table ) {
    if ( 'uk_UA' === get_locale() ) {
        $settings = new Cyr_To_Lat_Settings();
        $table    = $settings->get_option( 'uk' );
    }

    return $table;
}

add_filter( 'ctl_table', 'my_ctl_table' );

How can I define own transliteration of titles?

Add similar code to your theme’s functions.php file:

/**
* Filter title before sanitizing.
*
* @param string|false $result Sanitized title.
* @param string       $title  Title.
*
* @return string|false
*/
function my_ctl_pre_sanitize_title( $result, $title ) {
    if ( 'пиво' === $title ) {
        return 'beer';
    }

    return $result;
}

add_filter( 'ctl_pre_sanitize_title', 10, 2 );

How can I define own transliteration of filenames?

Add similar code to your theme’s functions.php file:

/**
* Filter filename before sanitizing.
*
* @param string|false $result   Sanitized filename.
* @param string       $filename Title.
*
* @return string|false
*/
function my_ctl_pre_sanitize_filename( $result, $filename ) {
    if ( 'пиво' === $filename ) {
        return 'beer';
    }

    return $result;
}

add_filter( 'ctl_pre_sanitize_filename', 10, 2 );

How can I limit post types for background conversion?

Add similar code to your theme’s functions.php file:

/**
* Filter post types allowed for background conversion.
*
* @param array $post_types Allowed post types.
*
* @return array
*/
function my_ctl_post_types( $post_types ) {
    return [
    'post'          => 'post',
    'page'          => 'page',
    'attachment'    => 'attachment',
    'product'       => 'product',
    'nav_menu_item' => 'nav_menu_item',
    ];
}

add_filter( 'ctl_post_types', 'my_ctl_post_types' );

How can I convert many posts/terms using wp-cli?

Use the following command in the console:

wp cyr2lat regenerate [--post_type=<post_type>] [--post_status=<post_status>]

Where
-post_type is list of post types,
-post_status is list of post statuses.

Can I contribute?

Yes you can!

ਸਮੀਖਿਆਵਾਂ

16 ਦਸੰਬਰ 2020
Запустил преобразование по готовым постам, в итоге проект убило. Неделю делал, и всё потеряно по клику кнопкой... Бэкап не сделал, потому что не предполагал, что простейший плагин может убить всё. Больше 10 лет сидел на rus-to-lat без проблем... Этот плагин явно что-то делает помимо URL и имен картинок! У меня было всего несколько страниц с кириллическим именем и ни одной картинки. В проекте используется Elementor. Так вот Elementor сдох, я не могу отредактировать НИ ОДИН пост, даже те которые были на латинских именах. Я не представляю куда мог залезть Cyr-To-Lat! На кириллице было только несколько URL постов и всё. Если бы он поменял только это, проблем бы не было. Я в шоке, это не объяснить даже словами... Ни слова предупреждений ни внутри ни тут в описании....
9 ਦਸੰਬਰ 2020
Не хватает стабильности, так как с последней обновой рухнул сайт с ошибками [Tue Dec 08 17:27:52.666279 2020] [fcgid:warn] [pid 19343] [client 37.214.80.207:37526] mod_fcgid: stderr: PHP Warning: require(/var/www/www-root/data/www/____/wp-content/plugins/cyr2lat/vendor/composer/../ralouphie/getallheaders/src/getallheaders.php): failed to open stream: No such file or directory in /var/www/www-root/data/www/____/wp-content/plugins/cyr2lat/vendor/composer/autoload_real.php on line 69, referer: https://____/ [Tue Dec 08 17:27:52.666319 2020] [fcgid:warn] [pid 19343] [client 37.214.80.207:37526] mod_fcgid: stderr: PHP Fatal error: require(): Failed opening required '/var/www/www-root/data/www/____/wp-content/plugins/cyr2lat/vendor/composer/../ralouphie/getallheaders/src/getallheaders.php' (include_path='.:/opt/php73/share/pear') in /var/www/www-root/data/www/____/wp-content/plugins/cyr2lat/vendor/composer/autoload_real.php on line 69, referer: https://____ поэтому срочно пришлось лезть на сервер удалять, и ставить прошлую версию или искать замену также, словарь есть, но еще хотелось бы маппинг слов, например именно слово виталюр нужно трансформировать не vita, это как пример
24 ਅਕਤੂਬਰ 2020
Добрый день! С некоторых пор перестал правиьно переводить русские символы. Например, "ы" не переводит совсем. Нашла ответ на похожий вопрос раньше, надо добавить код: function my_cyr_to_lat_table( $ctl_table ) { $ctl_table['Ы'] = 'Y'; $ctl_table['ы'] = 'y'; $ctl_table['Ъ'] = ''; $ctl_table['ъ'] = ''; $ctl_table['Ё'] = 'YO'; $ctl_table['ё'] = 'yo'; return $ctl_table; } add_filter( 'ctl_table', 'my_cyr_to_lat_table' ); Но это не решает проблему. Буква "и" в русском языке должна преобразовываться в "i", а в украинском - в "y". Как это исправить? Еще буква "г" в русском - "g", в украинском - "h", но это - мелочи по сравнению с "и". Спасибо!
Read all 66 reviews

ਯੋਗਦਾਨੀ ਤੇ ਵਿਕਾਸਕਾਰ

“Cyr-To-Lat” is open source software. The following people have contributed to this plugin.

ਯੋਗਦਾਨੀ

“Cyr-To-Lat” has been translated into 8 locales. Thank you to the translators for their contributions.

“Cyr-To-Lat” ਦਾ ਆਪਣੀ ਭਾਸ਼ਾ ਵਿੱਚ ਅਨੁਵਾਦ ਕਰੋ।

ਵਿਕਾਸ ਕਾਰਜ ਵਿੱਚ ਰੁਚੀ ਰੱਖਦੇ ਹੋ?

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

ਤਬਦੀਲੀ-ਚਿੱਠਾ

4.6.3 (21.02.2021)

  • Fix bug with attachment post type filtered by ‘ctl_post_types’
  • Fix bug with background conversion of product attribute terms

4.6.2 (11.02.2021)

  • Fix bug with non-existing function PLL().

4.6.1 (10.02.2021)

  • Fix bug with Polylang

4.6.0 (10.02.2021)

  • Add compatibility with Polylang
  • Add confirmation popup before mass conversion of slugs
  • Improve selection of posts and tags for conversion to avoid selection of excessive items for mass conversion
  • Fix bug with redirection from the old slug to a new one after background slug conversion
  • Fix js to run in old browsers like IE

4.5.2 (08.12.2020)

  • Fix bug with the deployment to wp.org

4.5.1 (07.12.2020)

  • Tested up to WordPress 5.6
  • Tested on PHP 5.6 – 8.0

4.5.0 (18.05.2020)

  • Added Greek and Armenian languages
  • Added background conversion of attachments and thumbnails
  • Fixed background conversion of existing slugs

4.4.0 (18.04.2020)

  • Full flexibility to edit transliteration table: now it is possible to add/remove transliteration pairs on the settings page
  • Ability to edit not only values in the transliteration table, but also keys
  • Saving active table via ajax
  • Watching changes in active table
  • Auto-saving of changed table
  • Info about the current locale on settings page
  • Making table with current locale active at setting page load
  • Chinese language added
  • Fixed: slug not updated at woocommerce product duplication

4.3.5 (28.03.2020)

  • Tested up to WordPress 5.4
  • Fixed bug with disappearing of WooCommerce attributes

4.3.4 (22.02.2020)

  • Fixed non-conversion of slugs with WPML
  • Restricted conversion of post to public and nav_menu_item
  • Introduced ctl_post_types filter

4.3.3 (20.02.2020)

  • Reworked main plugin filter
  • Improved performance by minimizing number of calls
  • Updated Georgian table
  • Fixed slug duplication in taxonomies
  • Fixed warnings with WooCommerce when mbstring is not loaded
  • Fixed transliteration of draft post slug
  • Tables sorted by local alphabets

4.3.2 (29.12.2019)

  • Fixed problems with setting of max_input_vars on some hostings

4.3.1 (27.12.2019)

  • Added requirement to have max_input_vars >= 5000
  • Added automatic plugin deactivation if requirements are not met
  • Added attempt to auto-fix max_input_variable value

4.3 (14.12.2019)

  • Added Chinese table
  • Tested up to WordPress 5.3
  • Tested up to PHP 7.4
  • External library wp-background-processing scoped into own namespace to prevent errors in some cases

4.2.3 (29.08.2019)

  • Scoped Symfony Mbstring polyfill to avoid problems with composer autoloader on some sites.

4.2.2 (28.08.2019)

  • Added ACF (Advanced Custom Fields) plugin support
  • Added Serbian table
  • Added new filter ctl_pre_sanitize_filename
  • Fixed improper encoding of Ё, ё, Й, й characters in file names on some Mac computers (old known problem on Mac’s)

4.2.1 (23.06.2019)

  • Fixed problem with sessions
  • Fixed message sequence for conversion of existing slugs.
  • Added php version check to avoid fatal error on activation on old sites.
  • Added vertical tabs in plugin settings.

4.2 (28.05.2019)

  • Bumped up required php version – to 5.6
  • Added phpunit tests for all php versions from 5.6 to 7.3
  • Fixed php warning during conversion of existing slugs
  • Fixed locale selection during conversion of existing post slugs when WPML is activated
  • Fixed bug with infinite redirection of some slugs after conversion of existing slugs

4.1.2 (22.05.2019)

  • Fixed bug with fatal error in Cyr_To_Lat_Converter with php 5.2

4.1.1 (22.05.2019)

  • Fixed bug with fatal error in Cyr_To_Lat_Converter with php 5.6

4.1 (21.05.2019)

  • Added he_IL Table
  • Added plugin translation to Ukrainian
  • Added plugin translation to Swedish
  • Added phpunit tests. All plugin classes are 100% covered
  • Added js tests. All plugin js code is 100% covered
  • Fixed bug with Jetpack sync
  • Fixed empty slug bug while using characters outside of locale

4.0 (24.04.2019)

  • Added button to convert existing slugs, instead of checkbox
  • Added admin notices during conversion of existing slugs
  • Added post_type and post_status parameters to wp-cli command
  • Fixed text domain
  • Simplified package.json to make final js even smaller
  • Added phpunit tests to the plugin main class
  • Added travis.yml for continuous integration on GitHub, and improvement of code reliability

3.7 (12.04.2019)

  • Added Belorussian, Macedonian, Kazakh tables
  • Fixed bug with MariaDB during old slug conversion
  • Fixed not saving of user modifications in default iso9 table

3.6.5 (11.02.2019)

  • Added queues for background slug conversion process

3.6.4 (06.02.2019)

  • Fixed bug with _wp_old_slug redirect.
  • Fixed bug with urldecode in posts.

3.6.3 (04.02.2019)

  • Fixed bug with network activation on multisite

3.6.2 (01.02.2019)

  • Moved the menu in the settings section
  • Text domain fixup.

3.6.1 (31.01.2019)

  • Text domain corrected.

3.6 (31.01.2019)

  • Plugin settings page added.
  • Settings page allows user to edit conversion tables online.
  • Code converted to OOP.
  • Code refactored to conform WordPress Coding Standards.
  • JS developed according to ECMA-6 script standards.
  • Settings page also works if JS is switched off in the browser.
  • Composer and yarn added.
  • Assets (banner, icon, admin icon) are added.

3.4 (21.01.2019)

  • Tested up to WP 5.1
  • Code formatting to follow WPCS.
  • Strict comparisons.
  • Braces {} removed from MySQL statements to allow checking of table names in PhpStorm.
  • Updated .gitignore and README.md
  • Added new filter ctl_pre_sanitize_title

3.3 (18.01.2019)

  • wpcs 1.0
  • Fixed many bugs
  • Added Gutenberg support

3.2

  • Added transliteration when publishing via XML-RPC
  • Fixed Invalid Taxonomy error when viewing the most used tags

3.1

  • Fixed transliteration when saving a draft

3.0

  • Added automatic conversion of existing post, page and term slugs
  • Added saving of existing post and page permalinks integrity
  • Added transliteration of attachment file names
  • Adjusted transliteration table in accordance with ISO 9 standard
  • Included Russian, Ukrainian, Bulgarian and Georgian characters
  • Added filter for the transliteration table

2.1

  • Optimized filter call

2.0

  • Added check for existing terms

1.0.1

  • Updated description

1.0

  • ਸ਼ੁਰੂਆਤੀ ਰਿਲੀਜ਼