Overzicht
Internationale merken, luchtvaartmaatschappijen, grote evenementen en winkelketens geven vaak wallet-passen uit aan klanten in uiteenlopende taalregio's. Passinstance biedt een native meertalige lokalisatie-engine die gelokaliseerde teksten en assets compileert naar:
-
Apple Wallet
.lproj-bundels: Standaard Apple PassKit-tekstwoordenboeken (<language>.lproj/pass.strings) die samen met gelokaliseerde afbeeldingen rechtstreeks in het.pkpass-archief worden verpakt. -
Google Wallet
LocalizedString-bronnen: Google Wallet API-structuren met terugvalteksten en taalspecifieke vertalingen (translatedValues[]).
Wanneer een klant een pas installeert, controleren iOS en Android automatisch de taal- en regio-instellingen van het besturingssysteem en worden veldlabels, waarden, meldingen op het toegangsscherm en merkafbeeldingen in de eigen taal weergegeven — zonder dat daar afzonderlijke sjablonen voor nodig zijn.
Systeemarchitectuur: meertalige PassKit- & Google-compilatie
De 4-laags terugvalhiërarchie voor locales
Wanneer een mobiel apparaat een gelokaliseerde pas weergeeft, past Passinstance een oplossingshiërarchie in vier lagen toe om te garanderen dat tekst nooit leeg of verminkt verschijnt:
-
1
Exacte locale-overeenkomst: Als het apparaat
de-AT(Duits - Oostenrijk) opvraagt en er bestaat eende-AT-woordenboek, wordt dit als eerste geladen. -
2
Overeenkomst op basistaal: Als
de-ATontbreekt, valt de engine terug opde(Duits). -
3
Primaire sjabloontaal: Als
deontbreekt, valt de engine terug op de canonieke basistaal van het sjabloon (standaard:en). -
4
Eerste beschikbare vertaling: Als basisteksten ontbreken, rendert de compiler de eerst beschikbare vertaalde tekenreeks.
Gelokaliseerde elementen & assets
U kunt de volgende onderdelen van elk passjabloon lokaliseren:
| Element | Apple Wallet-mechanisme | Google Wallet-mechanisme | Voorbeeld |
|---|---|---|---|
| Veldlabels | Sleutel gekoppeld in pass.strings | translatedValues op label-LocalizedString | "POINTS" -> "PUNKTE" / "POINTS DE FIDÉLITÉ" |
| Statische veldwaarden | Sleutel gekoppeld in pass.strings | translatedValues op waarde-LocalizedString | "Gold Member" -> "Membre Or" |
| Push-wijzigingsberichten | Sleutel in pass.strings met %@-placeholder | Google Wallet-pushnotificatiepayload | "Your balance is %@" -> "Ihr Guthaben beträgt %@" |
| Logotekst & organisatienaam | Sleutel logoText in pass.strings | localizedString op de Class-koptekst | "Artisan Cafe" -> "Café Artisan" |
| Gelokaliseerde afbeeldingen | Opgeslagen in <lang>.lproj/-map in .pkpass | Provider-afbeeldings-URI per gelokaliseerde Class | Gelokaliseerde promostrip met vertaalde typografie |
| Achterzijdevelden & voorwaarden | Lange tekstsleutels in pass.strings | Gelokaliseerde modules in textModulesData | Algemene voorwaarden vertaald per regio |
Belangrijk: Bij het lokaliseren van push-wijzigingsberichten (
changeMessage) moet u de Apple-opmaakplaatshouder%@in elke vertaling behouden (bijvoorbeeld"Votre solde est désormais de %@"). Als%@ontbreekt in een gelokaliseerde vertaling, onderdrukt iOS de melding op het toegangsscherm wanneer die taal actief is.
Lokalisatie configureren in de Visuele editor
-
1
Open uw sjabloon in de Visuele editor.
-
2
Ga in de linker navigatiebalk naar Ontwerp & inhoud -> Talen & vertalingen.
-
3
Klik op + Taal toevoegen en selecteer de gewenste taalcodes (bijv. Duits
de, Fransfr, Spaanses). -
4
De editor toont een overzichtelijk vertaalraster naast elkaar met alle veldsleutels, labels, waarden en wijzigingsberichten.
-
5
Vul voor elk veld de vertaalde teksten in.
-
6
Om taalspecifieke afbeeldingen te uploaden (zoals een Duitse stripbanner met Duitse tekst), klikt u op Gelokaliseerde afbeeldingen op het geselecteerde taaltabblad en uploadt u de bijbehorende
@2x- /@3x-PNG. -
7
Klik op Concept opslaan en bekijk uw wijzigingen in de simulator door de voorvertoningstaal om te schakelen.
Programmatische API: meertalige teksten configureren
U kunt vertalingen beheren via de Passinstance REST API door template.localization bij te werken (PATCH /api/v1/templates/:id):
{
"localization": {
"defaultLanguage": "en",
"languages": ["de", "fr", "es"],
"translations": {
"de": {
"MEMBER_LABEL": "MITGLIED",
"POINTS_LABEL": "PUNKTESTAND",
"TIER_GOLD": "Goldstatus",
"CHANGE_POINTS_MSG": "Ihr neuer Punktestand ist %@",
"TERMS_TITLE": "ALLGEMEINE GESCHÄFTSBEDINGUNGEN",
"TERMS_BODY": "Punkte verfallen nach 12 Monaten Inaktivität."
},
"fr": {
"MEMBER_LABEL": "MEMBRE",
"POINTS_LABEL": "POINTS DE FIDÉLITÉ",
"TIER_GOLD": "Statut Or",
"CHANGE_POINTS_MSG": "Votre nouveau solde est de %@",
"TERMS_TITLE": "CONDITIONS GÉNÉRALES",
"TERMS_BODY": "Les points expirent après 12 mois d'inactivité."
}
}
}
}
Referentie voor het Apple pass.strings-bestandsformaat
Wanneer Passinstance een Apple Wallet .pkpass-bundel compileert, genereert het automatisch UTF-16- (of UTF-8 met BOM) gecodeerde pass.strings-bestanden in mappen <locale>.lproj/:
/* de.lproj/pass.strings */
"MEMBER_LABEL" = "MITGLIED";
"POINTS_LABEL" = "PUNKTESTAND";
"CHANGE_POINTS_MSG" = "Ihr neuer Punktestand ist %@";
"TERMS_TITLE" = "ALLGEMEINE GESCHÄFTSBEDINGUNGEN";
Gelokaliseerde passen testen op mobiele apparaten
Zo controleert u of uw lokalisatieregels correct worden weergegeven:
-
1
Testen op iOS:
- Ga op uw iPhone naar Instellingen -> Algemeen -> Taal en regio. - Voeg uw testtaal toe (bijv. Duits) en stel deze in als primaire systeemtaal. - Open Apple Wallet: alle veldlabels en pushmeldingen van de pas schakelen over naar het Duits.
-
2
Testen op Android:
- Ga op uw Android-toestel naar Instellingen -> Systeem -> Talen en invoer. - Sleep Duits of Frans naar boven in uw lijst met taalvoorkeuren. - Open Google Wallet om de vertaalde textModulesData en koptekstwaarden te bekijken.
-
3
Testen van de downloadpagina:
- PassFlow-downloadpagina's (/p/:token) detecteren automatisch de Accept-Language-header van de browser en bieden onderaan een taalkiezer.
Bekijk Sjabloonontwerp & configuratie om visuele kaartstructuren aan te passen, of Sjabloonversies & publiceren om uw gelokaliseerde sjabloon naar productie te promoveren.
