# Platform Translations - Quick Reference

## 🚀 Quick Start

```php
// In Blade templates
{{ platform_name() }}        // Timebank.cc
{{ platform_users() }}        // Timebankers (or Zeitbankers in German)
{{ platform_slogan() }}       // Your time is currency

// With automatic placeholder replacement
{{ trans_with_platform('Welcome @PLATFORM_USERS@!') }}
```

## 📋 Available Functions

| Function | Returns (EN) | Returns (DE) |
|----------|-------------|--------------|
| `platform_name()` | " Timebank.cc" | " Timebank.cc" |
| `platform_name_short()` | "Timebank" | "Timebank" |
| `platform_user()` | "Timebanker" | "Zeitbanker" |
| `platform_users()` | "Timebankers" | "Zeitbankers" |
| `platform_slogan()` | "Your time is currency" | "Deine Zeit ist Währung" |
| `platform_principles()` | "Timebank principles" | "Timebank Prinzipien" |
| `platform_currency_name()` | "Hour" | "Stunde" |
| `platform_currency_name_plural()` | "Hours" | "Stunden" |
| `platform_currency_symbol()` | "H" | "Std" |

## 🔧 Common Use Cases

### Email Subject Lines
```php
$subject = 'Welcome to ' . platform_name();
```

### Page Titles
```blade
<h1>{{ platform_users() }} Directory</h1>
```

### Translated Content with Platform Terms
```blade
{{ trans_with_platform('Join @PLATFORM_USERS@ worldwide') }}
```

### Multi-language Support
```php
// Get German version regardless of current locale
$germanSlogan = platform_slogan('de');
```

## 📝 Translation File Placeholders

When editing JSON translation files, use these placeholders:

```json
{
    "Welcome new user!": "Welkom nieuwe @PLATFORM_USER@!",
    "Connect with others": "Maak verbinding met andere @PLATFORM_USERS@",
    "About us": "Over @PLATFORM_NAME_SHORT@"
}
```

**Available Placeholders:**
- `@PLATFORM_NAME@` → " Timebank.cc"
- `@PLATFORM_NAME_SHORT@` → "Timebank"
- `@PLATFORM_USER@` → "Timebanker"
- `@PLATFORM_USERS@` → "Timebankers"
- `@PLATFORM_PRINCIPLES@` → "Timebank principles"
- `@PLATFORM_SLOGAN@` → "Your time is currency"
- `@PLATFORM_NAME_LEGAL@` → "association Timebank.cc"
- `@PLATFORM_CURRENCY_NAME@` → "Hour"
- `@PLATFORM_CURRENCY_NAME_PLURAL@` → "Hours"
- `@PLATFORM_CURRENCY_SYMBOL@` → "H"

## ⚙️ Configuration

Edit `config/timebank-cc.php`:

```php
'platform_translations' => [
    'en' => [
        'platform_name' => ' Timebank.cc',
        'platform_users' => 'Timebankers',
        // ... other keys
    ],
],
```

After changes: `php artisan config:clear`

## ✅ Testing

```bash
php artisan tinker
```

```php
app()->setLocale('nl');
echo platform_users(); // Test Dutch
```

## 📚 Full Documentation

See `PLATFORM_TRANSLATIONS.md` for complete documentation.

---

**System Status**: ✅ Active (89 placeholders per language)
**Languages**: EN, NL, DE, ES, FR