# Guardian Gaze Translation Guide

This directory contains translation files for the Guardian Gaze WordPress security plugin.

## For Translators

### Getting Started

1. **Download the template**: Use `guardian-gaze.pot` as your starting point
2. **Create your language file**: Copy `guardian-gaze.pot` to `guardian-gaze-{locale}.po`
   - Example: `guardian-gaze-es_ES.po` for Spanish (Spain)
   - Example: `guardian-gaze-fr_FR.po` for French (France)
   - Example: `guardian-gaze-de_DE.po` for German (Germany)

### Translation Tools

We recommend using one of these tools for translation:

- **Poedit** (https://poedit.net/) - User-friendly GUI tool
- **Loco Translate** - WordPress plugin for in-browser translation
- **GlotPress** - WordPress.org's translation platform

### File Structure

```
languages/
├── guardian-gaze.pot          # Template file (don't edit)
├── guardian-gaze-es_ES.po     # Spanish translation
├── guardian-gaze-es_ES.mo     # Spanish compiled file
├── guardian-gaze-fr_FR.po     # French translation
├── guardian-gaze-fr_FR.mo     # French compiled file
└── README.md                  # This file
```

### Important Notes

1. **Text Domain**: Always use `guardian-gaze` as the text domain
2. **Context**: Pay attention to security-related terminology
3. **Placeholders**: Preserve `%s`, `%d` and other placeholders in translations
4. **HTML**: Keep HTML tags intact in translations
5. **Testing**: Test your translations in a WordPress environment

### Key Translation Areas

- **Dashboard Interface**: Main security dashboard and widgets
- **Scan Controls**: Scanning interface and options
- **Login Security**: Login protection features and messages
- **Error Messages**: Security warnings and error notifications
- **Settings**: Configuration options and descriptions

### Generating Updated POT File

If you're a developer and need to update the POT file after adding new translatable strings:

```bash
php generate-pot.php
```

This will scan all PHP files and regenerate the `guardian-gaze.pot` template.

### Contributing Translations

1. Complete your translation
2. Test it thoroughly
3. Submit via GitHub pull request or email to support@guardiangaze.com

### Support

For translation questions or issues:
- Email: support@guardiangaze.com
- GitHub: https://github.com/guardiangaze/guardian-gaze

Thank you for helping make Guardian Gaze accessible to users worldwide! 🌍
