Payload CMS
Překládejte lokalizovaná pole v Payload 3, zachovejte strukturu zdrojů a zvolte, jak se změny zdrojového obsahu promítnou do cílových jazyků.
Payload už má u každého lokalizovaného pole prostor pro jednotlivé jazykové verze. Připojení Lingo.dev načte vybraná zdrojová pole, přeloží je pomocí lokalizačního engine a výsledky zapíše do stejných zdrojů v cílových jazycích. Kolekce, globální zdroje i publikování zůstávají v Payload.
V navigaci Studio 2.5 přejděte na Studio 2.5 → Integrace místo Nastavení → Integrace. Stávající odkazy pro připojení a nastavení fungují i nadále.
Začněte s jedním zdrojem a ruční synchronizací. Zkontrolujte výsledek a poté přidejte notifikace o změnách zdrojového obsahu, pokud mají překlady automaticky reagovat na úpravy.
Integrace Payload CMS vyžaduje plán Enterprise. Aktuální dostupnost najdete v ceníku. Pokud organizace nemá plán s přístupem k této integraci, v části Nastavení → Integrace se u Payload zobrazí Není součástí vašeho plánu.
Připravte Payload a servisního uživatele #
Použijte Payload 3 s nastavenou lokalizací. Překlad formátovaného textu podporuje editor Lexical; starší editor Slate podporován není. Vaše instance musí být pro Lingo.dev dostupná přes HTTPS.
Vytvořte servisního uživatele v autentizační kolekci s useAPIKey: true, obvykle users. Udělte mu oprávnění ke čtení a aktualizaci všech kolekcí a globálních zdrojů, které chcete překládat. Zápisy se budou připisovat tomuto uživateli. Pokud brána vyžaduje další hlavičky, zadejte je při připojování a jejich hodnoty uchovávejte v tajnosti.
Zdrojový jazyk připojení nastavte tak, aby odpovídal hodnotě localization.defaultLocale v Payload, pro kterou plugin sleduje změny. Kódy zdrojového i cílových jazyků se musí přesně shodovat s kódy nastavenými v Payload: en a en-US označují různé jazyky. V připojené organizaci Lingo.dev vyberte dostupný lokalizační engine. Pokud připojení nelze přidat, zkontrolujte oprávnění v organizaci a to, zda má organizace přístup k připojením.
Připojte instanci a zpřístupněte její schéma #
Otevřete Nastavení → Integrace a u Payload CMS vyberte Připojit. Zadejte název připojení, kořenovou adresu instance, autentizační kolekci, servisní klíč API a případné hlavičky brány. Výběrem Připojit ověříte přístup a připojení uložíte. URL webhooku, která se poté zobrazí, si uschovejte pro automatické notifikace.
Nainstalujte plugin do projektu Payload:
pnpm add @lingo.dev/payloadcmsPřidejte lingo do stávajícího pole plugins. Ukázka obsahuje konfiguraci pluginu; kolekce, globální zdroje, lokalizaci i ostatní pluginy svého projektu zachovejte:
import { buildConfig } from "payload";
import { lingo } from "@lingo.dev/payloadcms";
export default buildConfig({
plugins: [
lingo({ webhookUrl: process.env.LINGO_WEBHOOK_URL }),
],
});Plugin vždy registruje GET /api/lingo/schema. Lingo.dev pomocí tohoto koncového bodu rozpoznává lokalizovaná pole. Připojení můžete vytvořit i před instalací pluginu, k překladu je ale koncový bod schématu nezbytný.
Pro automatické notifikace zkopírujte URL webhooku připojení do proměnné prostředí LINGO_WEBHOOK_URL v Payload. Zacházejte s ní jako s tajným přístupovým údajem: kdokoli tuto URL zná, může odesílat požadavky na notifikace. Po změně pluginu nebo prostředí znovu nasaďte Payload. Pokud chcete překládat jen ručně, vynechte webhookUrl; plugin bude schéma zpřístupňovat i nadále.
V prostředí Studio vyberte instanci v části Připojené a poté zvolte Nastavit. Vyberte její lokalizační engine, zdrojový a cílové jazyky a režim zpětného zápisu. Zvolte Pokračovat a pak vyberte kolekce a globální zdroje, které chcete překládat. Režimy publikování jsou popsány níže.
Přeložte jeden zdroj #
Vyberte jednu kolekci nebo globální zdroj s krátkým lokalizovaným textovým polem a jeden cílový jazyk. Před spuštěním synchronizace si v Payload poznamenejte aktuální hodnoty ve zdrojovém i cílovém jazyce.
Vyberte režim podle toho, jak chcete překlady publikovat:
| Režim | Zdroj a zpětný zápis |
|---|---|
| Koncept | Načítá zdrojový obsah z konceptů a přeložená pole zapisuje jako koncepty ke kontrole v Payload. |
| Publikovat | Zpracovává publikované změny a zapisuje publikované překlady. |
Payload uchovává pro každý dokument jeden sdílený koncept a publikuje ho jako celek. Zápis překladu do publikovaného dokumentu s nepublikovanými úpravami by tak zveřejnil i tyto úpravy. Režim publikování proto takový dokument ponechá beze změny a jeho překlad označí jako neúspěšný. Publikujte úpravy nebo se v Payload vraťte k publikované verzi a poté znovu spusťte synchronizaci. Aby uživatel přiřazený ke klíči API mohl tyto úpravy zobrazit, potřebuje přístup readVersions ke všem verzím vybraných kolekcí a globálních objektů. Pokud je tento přístup omezen filtrem, režim publikování ponechá jejich publikované dokumenty beze změny. U dokumentu, který ještě nikdy nebyl publikován, se tato kontrola přeskočí: režim publikování do něj zapíše překlad a dokument zůstane konceptem. Kontrola probíhá těsně před každým zápisem, takže koncept uložený v mezidobí může být přesto publikován spolu s překladem. Neukládejte proto koncepty dokumentů, do kterých právě zapisuje synchronizace, a po jejím dokončení zkontrolujte stav jejich publikování. Chování konceptů závisí také na konfiguraci Payload. Při testování aktualizace proto ověřte stávající veřejně dostupnou verzi.
Vyberte Synchronizovat, otevřete příslušné spuštění workflow a zkontrolujte přímo cílové pole v Payload. Ověřte znění, odkazy, strukturu formátovaného textu, jazyk a stav publikování. Pak si obsah přečtěte i na webu, který ho používá. Samotné vytvoření připojení katalog nepřeloží.
První synchronizace zachová úplné stávající překlady, aniž by je nahradila. Doplní chybějící pole včetně těch, jejichž aktuální hodnota jen opakuje výchozí hodnotu z Payload. Pokud synchronizace pole zachovala, porovnejte jeho hodnotu s tímto stavem, než požádáte o nahrazení.
Vyberte zdroje a pole #
Tabulky Kolekce a Globální obsahují přepínače Synchronizovat, jejichž nastavení se ukládá. Výběrem kolekce zahrnete její dokumenty; výběrem globálního zdroje zahrnete daný zdroj. Akce v záhlaví zpracovávají aktivní zdroje. Tam, kde jsou k dispozici akce pro vybrané řádky, zařadí do fronty pouze vybraný rozsah, aniž by změnily uložený výběr připojení.
V těchto zdrojích schéma vybírá lokalizovaná pole text, textarea a pole richText editoru Lexical. Vyhledává také text v lokalizovaných skupinách, polích, blocích a kartách, včetně vnořených a vložených bloků formátovaného textu.
Nelokalizovaná pole a strukturální hodnoty, jako jsou id, blockType a blockName, nejsou součástí překládaného textu. Výběrová pole, čísla, vztahy, nahrané soubory, kód ani libovolný JSON se nestanou přeložitelnými jen tím, že vyberete jejich kolekci. Chcete-li zahrnout další textové pole, nastavte jeho lokalizaci v Payload a projekt znovu nasaďte.
Při zpracování obsahu Lexical se zachovává kontext vět napříč vloženým formátováním a odkazy. Poté se znovu sestaví strom včetně odkazů, médií a bloků. Než rozsah rozšíříte, otestujte reprezentativní dokument, zvlášť pokud váš projekt používá vlastní pole nebo rozšíření editoru.
Udržujte překlady v souladu se změnami zdrojového obsahu #
Pokud je nastavena URL webhooku a výchozí jazyk, plugin po změnách ve zdrojovém jazyce odesílá notifikace. Notifikace obsahuje odkaz na zdroj, nikoli tělo dokumentu. Lingo.dev znovu načte obsah pomocí uložených přihlašovacích údajů servisního uživatele a použije nastavený rozsah a režim připojení. Časově blízké notifikace před zpracováním seskupí.
Zápisy v cílovém jazyce další překlad nespouštějí. Selhání notifikace navíc nezabrání uložení změn v editoru, takže samotné úspěšné uložení doručení nepotvrzuje. Pokud se některá změna nezpracovala, prohlédněte si historii spuštění a obsah slaďte ruční synchronizací. Ukládání konceptů se zohledňuje v režimu Koncept; uložení v cílovém jazyce ani zdroj mimo vybraný rozsah nejsou pro toto připojení změnou zdrojového obsahu.
Pro změněný zdrojový obsah a chybějící cílový obsah použijte Synchronizovat. Tato akce porovnává obsah s dostupným výchozím stavem. Pokud dřívější zdrojový artefakt není dostupný, může obnova dotčený obsah vygenerovat znovu. Zkontrolujte proto rozdíly a nepředpokládejte, že všechny ruční úpravy zůstanou zachovány. Po přidání cílového jazyka spusťte synchronizaci, aby se pro něj obsah doplnil.
Pokud chcete vybrané překlady nahradit, včetně ručně upravených polí, použijte Přeložit znovu. Například výrazná změna instrukcí lokalizačního engine může být důvodem k novému překladu, i když se zdrojový obsah nezměnil. Požadavky se řadí do fronty za právě probíhající spuštění připojení; opakované odesílání stejné akce její dokončení neurychlí.
Obnovte změněný nebo částečně zapsaný dokument #
Při zpětném zápisu se zdrojový obsah znovu načte. Pokud ho mezitím někdo v editoru změnil, dokument se přeskočí, aby se přeložené hodnoty nezapsaly do jiné revize nebo do pole s jiným pořadím prvků. Následná synchronizace obsah sladí s novým zdrojovým obsahem.
I po neúspěšném nebo zrušeném spuštění zůstávají úspěšné zápisy zachovány. V části Spuštění workflow rozlišujte dokončené, aktuální, přeskočené, neúspěšné a zrušené úlohy a před opakováním zkontrolujte dotčené zdroje. Akce Zastavit zruší probíhající práci tam, kde je to možné; již zapsaná pole ale nevrátí do původního stavu. Výsledek označený jako aktuální znamená, že ve vybraném rozsahu nebyla žádná změna ke zpracování.
Pokud se výstup vůbec neobjeví, zkontrolujte koncový bod schématu, lokalizaci a typ pole, oprávnění servisního uživatele ke čtení a aktualizaci, přesný kód jazyka, výběr zdrojů pro synchronizaci, režim a nastavení webhooku v prostředí. Než požádáte o nový překlad, vyřešte nedostupnost instance nebo odmítnutí klíče.
Změňte nastavení nebo zrušte připojení #
Výběr zdrojů, jazyky, lokalizační engine a režim můžete měnit v prostředí Studio. V části Nastavení → Integrace můžete připojení přejmenovat nebo spravovat jeho přihlašovací údaje. URL webhooku zůstává při těchto změnách stejná.
Chcete-li vyměnit klíč API, otevřete připojení v části Nastavení → Integrace a vyberte Nahradit klíč. Zadejte klíč ze stejné autentizační kolekce a znovu zadejte všechny vlastní hlavičky, které instance stále potřebuje. Zadané hlavičky nahradí ty uložené.
Změna adresy instance vyžaduje nové připojení. Než se znovu začnete spoléhat na automatické notifikace, nastavte rozsah překladu nového připojení a do prostředí Payload zadejte novou URL webhooku.
Odpojením odstraníte lokální historii a stav synchronizace připojení a zastavíte další čtení a zápisy. Stávající přeložený obsah zůstane v Payload. Odstraňte starou hodnotu webhooku z prostředí nebo příslušný hook a samostatně zneplatněte servisní klíč, pokud už není potřeba.
Nové připojení vytvoří nový výchozí stav. Jeho první synchronizace zachová stávající překlady, které splňují podmínky pro zachování, a doplní chybějící obsah. Lokální historii spuštění předchozího připojení ale neobnoví. První spuštění zkontrolujte stejně jako u každého nového připojení.