# Readmo AI Plugin - Translations

This directory contains translation files for the Readmo AI plugin.

## Text Domain

`readmo-ai`

## Generating POT File

### Method 1: Using WP-CLI (Recommended)

```bash
wp i18n make-pot . languages/readmo-ai.pot
```

### Method 2: Using Poedit

1. Download and install [Poedit](https://poedit.net/)
2. Open Poedit and select "Create new translation"
3. Select this plugin directory
4. Poedit will automatically scan all PHP files and generate the POT file

### Method 3: Using WordPress.org Tools

Once the plugin is uploaded to WordPress.org SVN, the translation system will automatically generate the POT file.

## Translation Files Structure

```
languages/
├── readmo-ai.pot                    # Translation template (to be generated)
├── readmo-ai-zh_TW.po               # Traditional Chinese translation (example)
├── readmo-ai-zh_TW.mo               # Compiled Traditional Chinese (example)
└── README.md                        # This file
```

## For Translators

1. Download the `readmo-ai.pot` file
2. Use a translation tool like [Poedit](https://poedit.net/) or [GlotPress](https://translate.wordpress.org/)
3. Translate all strings
4. Save as `readmo-ai-{locale}.po` and compile to `.mo`
5. Place both files in this directory

## Available Translations / 可用翻譯

| Language | Locale | Files | Status |
|----------|--------|-------|--------|
| English (Default) | `en_US` | Built-in | ✅ Complete |
| Traditional Chinese (Taiwan) | `zh_TW` | `readmo-ai-zh_TW.mo` | ✅ Complete (45/45) |
| Simplified Chinese (China) | `zh_CN` | `readmo-ai-zh_CN.mo` | ✅ Complete (45/45) |
| Traditional Chinese (Hong Kong) | `zh_HK` | `readmo-ai-zh_HK.mo` | ✅ Complete (45/45) |

### Translation Summary
- **Total translatable strings:** 45
- **Completed translations:** 3 languages (zh_TW, zh_CN, zh_HK)
- **Translation coverage:** 100%

## WordPress.org Translation

Once the plugin is approved on WordPress.org, translations can be contributed via:
https://translate.wordpress.org/projects/wp-plugins/readmo-ai/

All user-facing strings in this plugin use WordPress i18n functions:
- `__()` - Return translated string
- `_e()` - Echo translated string
- `esc_html__()` - Return translated and escaped string
- `esc_html_e()` - Echo translated and escaped string
- `_x()` - Return translated string with context
- `_n()` - Return singular or plural translation