setName('i18n:migrate')
->setDescription('Import overrides from the translation-strings plugin into user/languages')
->addOption('dry-run', null, InputOption::VALUE_NONE, 'Report what would be written without touching anything')
->setHelp('The i18n:migrate command copies translation-strings overrides into the language files used by the Translations editor in Admin 2.1. The plugin config is left untouched so the move can be undone.');
}
protected function serve(): int
{
include __DIR__ . '/../vendor/autoload.php';
$io = new SymfonyStyle($this->input, $this->output);
$this->initializePlugins();
$grav = Grav::instance();
$dryRun = (bool) $this->input->getOption('dry-run');
$sources = new TranslationSourceIndex($grav);
$store = new TranslationOverrideStore($grav, $sources);
$importer = new TranslationStringsImporter($grav, $sources, $store);
$report = $importer->report();
if (!$report['present']) {
$io->success('Nothing to migrate — the translation-strings plugin has no overrides configured.');
return 0;
}
foreach ($report['languages'] as $language) {
$io->section("{$language['code']} — {$language['total']} override(s)");
if ($language['already'] > 0) {
$io->writeln("{$language['already']} already present in user/languages");
}
if ($language['shipped'] > 0) {
$io->writeln("{$language['shipped']} match what the source already ships and will be dropped");
}
if ($language['conflict'] > 0) {
$io->writeln("{$language['conflict']} disagree with user/languages; the plugin's value wins:");
foreach ($this->pick($language['keys'], TranslationStringsImporter::CONFLICT) as $entry) {
$io->writeln(" {$entry['key']}");
}
}
if ($language['unknown'] > 0) {
$io->writeln("{$language['unknown']} key(s) no plugin, theme or core file provides:");
foreach ($this->pickUnknown($language['keys']) as $entry) {
$io->writeln(" {$entry['key']}");
}
}
if ($dryRun) {
$io->writeln('would write ' . $store->path($language['code']));
}
}
if ($dryRun) {
$io->note("Dry run — nothing was written. {$report['pending']} override(s) would change. Re-run without --dry-run to apply.");
return 0;
}
$result = $importer->import();
foreach ($result['languages'] as $language) {
$io->writeln("wrote {$language['written']} to {$language['path']}");
}
$io->success("Migrated {$result['imported']} override(s).");
if ($result['unknown'] !== []) {
$io->warning(
count($result['unknown']) . ' of them name keys nothing provides. They were kept so you can '
. 'find them under Translations with the "Unknown" filter, but they have no effect.'
);
}
if ($importer->pluginEnabled()) {
$io->writeln('');
$io->writeln('The translation-strings plugin is still enabled, and it merges its strings after this store does, so it still wins.');
$io->writeln('Check the site reads correctly, then disable it to finish the move. Its config is untouched, so this is reversible.');
}
return 0;
}
/**
* @param array $keys
* @return array
*/
private function pick(array $keys, string $status, int $limit = 10): array
{
return array_slice(array_values(array_filter($keys, static fn (array $k): bool => $k['status'] === $status)), 0, $limit);
}
/**
* @param array $keys
* @return array
*/
private function pickUnknown(array $keys, int $limit = 10): array
{
return array_slice(array_values(array_filter($keys, static fn (array $k): bool => $k['unknown'])), 0, $limit);
}
}