BG Slug Transliterator

BG Slug Transliterator is a small WordPress plugin that safely transliterates Bulgarian Cyrillic post and page URL slugs into Latin slugs.

Version 1.1.0 intentionally does not hook into WordPress' global sanitize_title filter. This keeps WooCommerce products, variations, attributes, terms, and taxonomies untouched.

Features

• Automatically transliterates new WordPress post slugs.
• Automatically transliterates new WordPress page slugs.
• Does not touch WooCommerce products.
• Does not touch WooCommerce product variations.
• Does not touch WooCommerce product attributes.
• Does not touch terms, taxonomies, categories, tags, or custom post types by default.
• Adds a Tools > BG Slug Transliterator admin page.
• Includes an optional bulk conversion button for existing posts and pages only.

Safety Notes

Earlier versions used a broader slug hook. Version 1.1.0 narrows the plugin scope to post and page slugs only.

If you use WooCommerce, Shop Kit, variation swatches, product filters, product attribute plugins, or any other ecommerce extension, use version 1.1.0 or newer.

Installation

1. Download the release ZIP.
2. In WordPress admin, go to Plugins > Add New > Upload Plugin.
3. Upload the ZIP file.
4. Activate BG Slug Transliterator.

Manual installation:

1. Upload the bg-slug-transliterator folder to wp-content/plugins/.
2. In WordPress admin, go to Plugins > Installed Plugins.
3. Activate BG Slug Transliterator.

Existing URLs

The plugin automatically affects newly generated post and page slugs.

For existing content, go to:

Tools > BG Slug Transliterator

Then confirm and click:

Convert existing post and page slugs to Latin

Changing existing slugs changes URLs. On a public site, make a backup first and add redirects from the old URLs to the new URLs if needed.

Developer Opt-In For Custom Post Types

By default, only post and page are included.

Developers can opt in specific custom post types with:

add_filter( 'bg_slug_transliterator_allowed_post_types', function ( $post_types ) {
    $post_types[] = 'your_custom_post_type';
    return $post_types;
} );

Do not add WooCommerce product or product_variation unless you understand the URL and attribute consequences.

Requirements

• WordPress 5.8 or newer
• PHP 7.4 or newer

License

GPL-2.0-or-later