Description
Converts Cyrillic characters in post, page and term slugs to Latin characters. Useful for creating human-readable URLs.
Features
- The only plugin with fully editable transliteration table. Allows to 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
- The plugin supports 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.
Sponsored by Blackfire.
Plugin Support
Screenshots
Installation
- Upload
cyr2lat
folder to the/wp-content/plugins/
directory. - Activate the plugin through the ‘Plugins’ menu in WordPress.
FAQ
-
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’sfunction.php
file:/** * Use non-standard locale. * * @param string $locale Current locale. * * @return string */ function my_ctl_locale( $locale ) { if ( 'uk_UA' === $locale ) { return 'uk'; } return $locale; } add_filter( 'ctl_locale', 'my_ctl_locale' );
-
How can I define my 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 my 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 allow the plugin to work on the frontend?
-
Add the following code to your plugin’s (or mu-plugin’s) main file. This code won’t work being added to a theme’s functions.php file.
/** * Filter status allowed Cyr To Lat plugin to work. * * @param bool $allowed * * @return bool */ function my_ctl_allow( bool $allowed ): bool { $uri = isset( $_SERVER['REQUEST_URI'] ) ? sanitize_url( wp_unslash( $_SERVER['REQUEST_URI'] ) ) : ''; if ( 0 === strpos( $uri, '/divi-comments' ) ) { return true; } return $allowed; } add_filter( 'ctl_allow', 'my_ctl_allow' );
-
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 a list of post types,
-post_status is a list of post statuses. -
How can I regenerate thumbnails safely?
-
Regeneration of thumbnails with the command
wp media regenerate
can break links in old posts as file names become transliterated.To avoid it, deactivate cyr2lat plugin during regeneration:
wp media regenerate --skip-plugins=cyr2lat
-
Can I contribute?
-
Yes, you can!
- Join in on our GitHub repository
- Join in on our Telegram Group
Reviews
Contributors & Developers
“Cyr-To-Lat” is open source software. The following people have contributed to this plugin.
Contributors“Cyr-To-Lat” has been translated into 9 locales. Thank you to the translators for their contributions.
Translate “Cyr-To-Lat” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
6.1.0 (09.03.2024)
- Tested with WordPress 6.5.
- Tested with WooCommerce 8.6.
- Fixed error on System Info tab when post types or post statuses are not set.
6.0.8 (14.02.2024)
- Improved detection of the Gutenberg editor.
- Fixed processing of product attributes.
6.0.7 (11.02.2024)
- Tested with WooCommerce 8.5.
- Added redirect from the cyrillic post title when creating a new post.
- Added description of post types and post statuses on the Converter page.
- Fixed displaying all file descriptions in the Theme Editor in the current locale.
- Fixed PHP warning in SettingsBase.
- Fixed output of variable product attributes.
6.0.6 (14.01.2024)
- Tested with WordPress 6.4.
- Tested with WooCommerce 8.4.
- Tested with PHP 8.3.
- Fixed documentation on ctl_allow filter.
- Fixed improper display of the rate plugin” message on options.php.
6.0.5 (09.10.2023)
- Fixed displaying file descriptions in the Theme Editor; now in the current locale.
6.0.4 (23.09.2023)
- Fixed disappeared file descriptions on the Theme File Editor page.
6.0.3 (29.07.2023)
- Fixed the fatal error with Jetpack sync.
6.0.2 (26.07.2023)
- Fixed fatal error in admin_footer_text().
6.0.1 (26.07.2023)
- Fixed the fatal error on the System Info page with empty options.
6.0.0 (26.07.2023)
- Dropped support of PHP 5.6. The Minimum required PHP version is 7.0 now.
- Tested with WordPress 6.3.
- Tested with WooCommerce 7.9.
- Added System Info tab.
- Added filter ‘ctl_allow’
- Fixed console error when saving table data.
- Fixed the current table setting on the Tables page with WPML.