TranslationClient – překlad řetězců přímo na stráce

Zdravím všechny,
zhruba po dni kódování a psaní úděsného JavaScriptu se mi povedlo zrealizovat dle mého názoru docela zajímavou myšlenku – nástroj pro překládání přímo na stránce. Abyste si udělali představu, jak to vypadá, tak 2 ukázky:

Před rozbalením:

Po rozbalení:

Hezké, co?

Asi vás napadne, co bude použití takové srandy v projektu obnášet – moc toho není. Stačí přidat zhruba jeden řádek do bootstrap.php…

TranslationClient::enable($translator);

… a zajistit, že předávaný $translator bude implementovat následující rozhraní…

interface IEditableTranslator extends ITranslator
{
	public function getVariantsCount();
	public function getStrings();
	public function setTranslation($message, $string);
	public function save();
}

… a to by mělo být vše. Může se překládat.

Nyní se ještě trošku vrátím k tomu rozhraní.

Metoda getVariantsCount() by měla vracet počet tvarů slov podle kvantity v daném jazyce. Pro angličtinu se tedy vrací 2 (singulár, plurál), čeština 3 (singulár, plurál pro 2 – 4, plurál pro 5+).

Metoda getStrings() by měla vracet asociativní pole řetězců, které se zobrazí v klientovi. Pokud řetězec není závislý na počtu, měl by se vrátit jako řetězec. Pokud závislý je, tak by se mělo vrátit pole s tolika prvky, kolik je variant. Názornější asi bude příklad (psáno v JSONu):

{
  "news": "Novinky",
  "categories": [
    "%n kategorie",
    "%n kategorie",
    "%n kategorií"
  ]
}

Tento seznam řetězců samozřejmě nemusí být jen nějaký nadefinovaný seznam, IEditableTranslator si klidně může ukládat bokem „neuspokojené“ překlady a do klienta je naservírovat k překladu – klient totiž tuto metodu volá až při ukončování scriptu (ve stejnou dobu, kdy se renderuje např. profiler), takže se tam může promítnout opravdu vše, co bylo voláno.

Metoda setTranslation($message, $string) nastaví překlad nějakého řetězce. Pro řetězec bez plurálů se opět použije jen string, pro řetězec s plurály pole všech variant.

Mno a metoda save() všechny provedené překlady uloží.

Nastavování jednotlivých překladů probíhá AJAXem. Uživatel v klientovi přeloží jeden či více řetězců a klepne na uložit. Klient provede AJAXový požadavek (identifikovaný speciální hlavičkou, takže se nebude míchat s ostatními požadavky) na URL se současnou stránkou (bez signálů atp.) a během požadavku se jeho data uloží.

Ukládání momentálně probíhá na konci volání TranslationClient::enable(...) a po uložení dat vykonávání scriptu zemře (die()), aby se předešlo případným vedlejším efektům. Toto chování mi nepřipadá úplně ideální a určitě by sneslo nějakou změnu. Také z toho vyplývá jeden možná trochu nepříjemný požadavek – IEditableTranslator už v době volání musí být schopen data bez problémů ukládat.

Na závěr bych chtěl říct, že to celé je zatím spíš ve stádiu experimentu, takže 100% funkčnost a stabilita není garantována. Dokonce to jde tak daleko, že mohu garantovat jedině nefunkčnost snad v jakékoliv verzi IE. Fungovat by to mělo ve FF, Chrome a Opeře + možná v dalších prohlížečích, pro které „moderní standarty“ nejsou jen sprosté slovo.

Na závěr bych chtěl vznést několik námětů na diskuzi, budu rád za jakýkoliv komentář:

• Chybí vám tam něco? Mělo by to ještě něco zohledňovat?
• Kam by jste dali zpracování ukládaných dat? A po něm být, či nebýt? continue, či die()?
• Má smysl podporovat IE6? Je to převážně nástroj pro vývojáře a žádného masochistu, co vyvíjí primárně na IE6, neznám…
• Má to vůbec smysl?

A teď už samotné zdrojáky, byl bych rád, kdyby si někdo našel chvilku času na prozkoumání a otestování: TranslationClient.zip. Nějakou ukázkovou miniaplikaci včetně translatoru, který bude implementovat IEditableTranslator, dodám snad v průběhu víkendu. Nějakou ukázku toho translatoru vážným zájemcům dodám na požádání.

A ještě si neodpustím malé varování: kód není komentovaný, neobsahuje phpdoc, míst k refaktorování by se tam našlo mnoho… To bude až časem.