=== Ukrainian Cyrillic to Latin by OSTG ===
Contributors: bohdanborutskyi
Donate link: https://buymeacoffee.com/tatkovakovalnia/e/483666
Tags: ukrainian, transliteration, cyrillic, latin, seo
Requires at least: 5.2
Tested up to: 6.9
Stable tag: 1.0.1
Requires PHP: 7.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically transliterates Ukrainian Cyrillic characters to Latin characters for better SEO and URL readability.

== Description ==

**Ukrainian Cyrillic to Latin by OSTG** is a WordPress plugin that automatically transliterates Ukrainian Cyrillic characters into Latin characters for SEO-friendly URLs and improved readability.

This plugin helps Ukrainian WordPress sites create cleaner, more accessible URLs by converting Cyrillic text to Latin equivalents in posts, pages, categories, tags, and media files.

### Key Features

* **Automatic Transliteration** - Works seamlessly in the background
* **Post & Page Slugs** - Converts permalinks to Latin characters
* **Category & Tag Slugs** - Makes taxonomy URLs more readable
* **Media Files** - Transliterates uploaded file names and titles
* **Customizable Options** - Configure apostrophe handling and case conversion
* **SEO Optimized** - Improves search engine indexing and user experience
* **Lightweight** - Minimal impact on site performance

### How It Works

The plugin follows standard Ukrainian transliteration rules and automatically converts:

- Post and page slugs when publishing or updating content
- Category and tag slugs when creating or editing them
- Media filenames during upload
- Media titles when editing attachments

### Transliteration Examples

* Київ → Kyiv
* Україна → Ukraina  
* Львів → Lviv
* Харків → Kharkiv

### Settings

Configure the plugin behavior at **Settings → Ukrainian Cyrillic to Latin**:

* **Remove Apostrophes**: Remove apostrophes from transliterated text
* **Convert to Lowercase**: Convert all transliterated text to lowercase

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/ukrainian-cyrillic-to-latin-by-ostg/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Configure settings at Settings → Ukrainian Cyrillic to Latin (optional)

== Frequently Asked Questions ==

= Will this affect my existing content? =

No, the plugin only affects new content or content that you update after installing the plugin. Existing URLs remain unchanged unless you edit and update them.

= Can I convert existing slugs in bulk? =

This version doesn't include bulk conversion functionality. You need to edit and update existing content individually to trigger the transliteration.

= Does this change how content appears on my website? =

No, this plugin only affects URLs, filenames, and internal slugs. Your content will still display in Ukrainian characters where appropriate.

= Is the transliteration reversible? =

The transliteration process is one-way. Once converted, the original Cyrillic characters in URLs cannot be automatically restored.

= Will this work with other plugins? =

Yes, the plugin is designed to work seamlessly with other WordPress plugins and themes. It hooks into WordPress core functions safely.

= Does this affect SEO? =

Yes, positively! Latin character URLs are generally better for SEO as they're more accessible to search engines and international users.

== Screenshots ==

1. Plugin settings page with configuration options
2. Example of transliterated post URL
3. Transliterated category and tag slugs

== Changelog ==

= 1.0.1 =
* Fixed: Global function naming to comply with WordPress 6.9 coding standards
* Updated: WordPress 6.9 compatibility confirmed
* Updated: Plugin version and constants

= 1.0.0 =
* Initial release
* Automatic transliteration for posts, pages, categories, tags, and media
* Configurable settings for apostrophes and lowercase conversion
* WordPress 6.8 compatibility

== Upgrade Notice ==

= 1.0.1 =
WordPress 6.9 compatibility update. Fixed global function naming to comply with WordPress coding standards.

= 1.0.0 =
Initial release of Ukrainian Cyrillic to Latin by OSTG - Ukrainian to Latin transliteration for WordPress.

== Support ==

For support, bug reports, or feature requests, please visit [OSTG Blog](https://ostg.blog/ukrainian-cyrillic-to-latin-by-ostg).

== Privacy Policy ==

This plugin does not collect, store, or transmit any personal data. All transliteration is performed locally on your WordPress installation.