162 lines
5.4 KiB
Markdown
162 lines
5.4 KiB
Markdown
---
|
|
phase: 11-translation-infrastructure
|
|
plan: 01
|
|
type: execute
|
|
wave: 1
|
|
depends_on: []
|
|
files_modified:
|
|
- plugins/golem15/translate/updates/version.yaml
|
|
- plugins/golem15/translate/updates/v2.4.0/seed_quotify_locales.php
|
|
- config/golem15/translate/config.php
|
|
autonomous: true
|
|
|
|
must_haves:
|
|
truths:
|
|
- "Polish locale (pl) is enabled and available"
|
|
- "German locale (de) is enabled and available"
|
|
- "English remains the default locale"
|
|
- "translate:scan command extracts theme messages to database"
|
|
- "Messages backend shows scanned translation strings"
|
|
artifacts:
|
|
- path: "plugins/golem15/translate/updates/v2.4.0/seed_quotify_locales.php"
|
|
provides: "Migration to seed PL and DE locales"
|
|
- path: "config/golem15/translate/config.php"
|
|
provides: "Translate plugin configuration"
|
|
key_links:
|
|
- from: "seed_quotify_locales.php"
|
|
to: "winter_translate_locales table"
|
|
via: "database seeder"
|
|
pattern: "DB::table.*locales.*insert"
|
|
---
|
|
|
|
<objective>
|
|
Configure translation infrastructure with Polish and German locales.
|
|
|
|
Purpose: Establish the locale configuration and verify the Translate plugin workflow works correctly for scanning, storing, and managing translatable strings.
|
|
Output: Working translation infrastructure with EN (default), PL, and DE locales configured.
|
|
</objective>
|
|
|
|
<execution_context>
|
|
@~/.claude/get-shit-done/workflows/execute-plan.md
|
|
@~/.claude/get-shit-done/templates/summary.md
|
|
</execution_context>
|
|
|
|
<context>
|
|
@.planning/PROJECT.md
|
|
@.planning/ROADMAP.md
|
|
@.planning/STATE.md
|
|
|
|
# Translate plugin understanding
|
|
@plugins/golem15/translate/Plugin.php
|
|
@plugins/golem15/translate/models/Locale.php
|
|
@plugins/golem15/translate/models/Message.php
|
|
@plugins/golem15/translate/classes/ThemeScanner.php
|
|
</context>
|
|
|
|
<tasks>
|
|
|
|
<task type="auto">
|
|
<name>Task 1: Create locale seeder migration</name>
|
|
<files>plugins/golem15/translate/updates/v2.4.0/seed_quotify_locales.php, plugins/golem15/translate/updates/version.yaml</files>
|
|
<action>
|
|
Create a new migration that seeds Polish and German locales:
|
|
|
|
1. Create directory `plugins/golem15/translate/updates/v2.4.0/`
|
|
2. Create `seed_quotify_locales.php` migration:
|
|
- Insert Polish locale: code='pl', name='Polski', is_enabled=1, is_default=0, sort_order=2
|
|
- Insert German locale: code='de', name='Deutsch', is_enabled=1, is_default=0, sort_order=3
|
|
- Use DB::table() for direct insertion (not model to avoid boot issues)
|
|
- Make migration idempotent (check if locale exists before inserting)
|
|
|
|
3. Update version.yaml to add:
|
|
```yaml
|
|
"2.4.0":
|
|
- Add Polish and German locales for Quotify.pro
|
|
- v2.4.0/seed_quotify_locales.php
|
|
```
|
|
|
|
Note: English (en) locale already exists as default from existing seed data.
|
|
</action>
|
|
<verify>php-legacy artisan winter:up runs without errors</verify>
|
|
<done>Migration runs successfully, PL and DE locales exist in database</done>
|
|
</task>
|
|
|
|
<task type="auto">
|
|
<name>Task 2: Create Translate plugin configuration</name>
|
|
<files>config/golem15/translate/config.php</files>
|
|
<action>
|
|
Create Translate plugin config file to configure caching and behavior:
|
|
|
|
1. Create directory `config/golem15/translate/` if not exists
|
|
2. Create `config.php` with:
|
|
```php
|
|
<?php
|
|
|
|
return [
|
|
/*
|
|
* Cache timeout in minutes for translated messages.
|
|
* Default: 1440 (24 hours)
|
|
*/
|
|
'cacheTimeout' => 1440,
|
|
|
|
/*
|
|
* When enabled, the locale prefix will be added to URLs
|
|
* for the default locale as well (e.g., /en/about instead of /about).
|
|
* Default: false - default locale has no prefix
|
|
*/
|
|
'prefixDefaultLocale' => false,
|
|
|
|
/*
|
|
* Disable locale prefix routing entirely.
|
|
* When true, locales are managed via session/cookie only.
|
|
* Default: false
|
|
*/
|
|
'disableLocalePrefixRoutes' => false,
|
|
];
|
|
```
|
|
|
|
This allows customization later without modifying plugin code.
|
|
</action>
|
|
<verify>File exists and is valid PHP syntax: php-legacy -l config/golem15/translate/config.php</verify>
|
|
<done>Config file created with appropriate defaults</done>
|
|
</task>
|
|
|
|
<task type="auto">
|
|
<name>Task 3: Run migration and verify locales</name>
|
|
<files>None (database operation)</files>
|
|
<action>
|
|
1. Run migrations: `php-legacy artisan winter:up`
|
|
2. Clear cache: `php-legacy artisan cache:clear`
|
|
3. Verify locales exist by running tinker check:
|
|
```bash
|
|
php-legacy artisan tinker --execute="print_r(\Golem15\Translate\Models\Locale::all()->pluck('name', 'code')->toArray())"
|
|
```
|
|
Expected output: ['en' => 'English', 'pl' => 'Polski', 'de' => 'Deutsch']
|
|
</action>
|
|
<verify>Tinker output shows all 3 locales</verify>
|
|
<done>EN, PL, DE locales all present and enabled in database</done>
|
|
</task>
|
|
|
|
</tasks>
|
|
|
|
<verification>
|
|
Before declaring plan complete:
|
|
- [ ] `php-legacy artisan winter:up` succeeds
|
|
- [ ] 3 locales exist: en (default), pl, de
|
|
- [ ] All locales are enabled
|
|
- [ ] Config file exists at config/golem15/translate/config.php
|
|
</verification>
|
|
|
|
<success_criteria>
|
|
|
|
- All tasks completed
|
|
- Polish and German locales added to database
|
|
- English remains default locale
|
|
- Translate plugin config file exists
|
|
- No errors during migration
|
|
</success_criteria>
|
|
|
|
<output>
|
|
After completion, create `.planning/phases/11-translation-infrastructure/11-01-SUMMARY.md`
|
|
</output>
|