opticore/languages

🌍 OptiCore Translation Files

This directory contains translation files for OptiCore plugin.

📋 Available Translations

Language	Code	Status	Contributors
English	en_US	✅ Default	Core Team
Persian (Farsi)	fa_IR	🚧 In Progress	-
Arabic	ar	📝 Planned	-
Spanish	es_ES	📝 Planned	-
French	fr_FR	📝 Planned	-
German	de_DE	📝 Planned	-

🔧 How to Translate

Option 1: Using Poedit (Recommended)

1. Download Poedit from poedit.net
2. Open opticore.pot file
3. Create new translation (File → New Translation from POT/PO file)
4. Select your language
5. Translate all strings
6. Save as opticore-{locale}.po (e.g., opticore-fa_IR.po)
7. Poedit will automatically generate .mo file

Option 2: Using WordPress.org Translation

1. Go to WordPress.org Translate
2. Find OptiCore plugin
3. Select your language
4. Start translating

Option 3: Manual Translation

1. Copy opticore.pot to opticore-{locale}.po
2. Edit the PO file with a text editor
3. Translate all msgstr entries
4. Generate .mo file using:

   msgfmt opticore-fa_IR.po -o opticore-fa_IR.mo
   

📁 File Structure

languages/
├── opticore.pot              # Template file (DO NOT EDIT)
├── opticore-fa_IR.po         # Persian translation (Portable Object)
├── opticore-fa_IR.mo         # Persian compiled (Machine Object)
├── opticore-ar.po            # Arabic translation
├── opticore-ar.mo            # Arabic compiled
└── README.md                 # This file

🔤 Translation Guidelines

1. Context Matters

• Understand the context before translating
• Check where the string is used in the plugin
• Maintain consistency across similar terms

2. Preserve Placeholders

• Keep %s, %d, and other placeholders intact
• Example: "You have %d items" → "شما %d مورد دارید"

3. Maintain HTML Tags

• Keep HTML tags unchanged
• Example: "<strong>Note:</strong> Text" → "<strong>توجه:</strong> متن"

4. Technical Terms

• Some technical terms might be better left in English
• Examples: Cache, CDN, API, CSS, JavaScript

5. Character Encoding

• Always use UTF-8 encoding
• Save PO files with UTF-8 without BOM

📝 Common Translation Patterns

Settings Toggles

"Enable %s" → "فعال‌سازی %s"
"Disable %s" → "غیرفعال‌سازی %s"
"Remove %s" → "حذف %s"

Messages

"Settings saved successfully!" → "تنظیمات با موفقیت ذخیره شد!"
"An error occurred" → "خطایی رخ داد"

Actions

"Save Settings" → "ذخیره تنظیمات"
"Clear Cache" → "پاک کردن کش"
"Optimize Database" → "بهینه‌سازی دیتابیس"

🔄 Updating Translations

When plugin is updated with new strings:

1. Update opticore.pot file using:

   wp i18n make-pot . languages/opticore.pot
   

2. Update existing translations:

   • Open PO file in Poedit
   • Catalog → Update from POT file
   • Translate new strings
   • Save

🤝 Contributing Translations

We welcome translation contributions!

1. Fork the repository
2. Add your translation files
3. Test the translation in WordPress
4. Create a Pull Request
5. Include screenshots showing the translation

📧 Translation Support

Need help with translation?

• 📖 WordPress i18n Documentation
• 💬 GitHub Discussions
• 📧 Email: ahmadreza.log@gmail.com

✅ Translation Checklist

• All strings translated
• Placeholders preserved
• HTML tags intact
• Technical terms handled appropriately
• Tested in WordPress
• MO file generated
• Screenshots provided
• Pull request created

🙏 Translation Credits

Translators will be credited in:

• Plugin credits page
• README.md
• CHANGELOG.md

Thank you for helping make OptiCore accessible to everyone! 🌍