WordPress-plugins en -thema's zijn hulpmiddelen waarmee u de functionaliteit en het uiterlijk van uw WordPress-website kunt aanpassen. Veel van hen bevatten instellingen en configuratieopties waarmee u dingen naar uw behoeften kunt aanpassen. Easy Digital Downloads geeft u bijvoorbeeld de mogelijkheid om het e-mailonderwerp en de kop van de aankoopbewijs-e-mail die na een aankoop naar klanten wordt verzonden, te beheren:
Hoewel dit soort instellingen handig zijn wanneer u tekst moet wijzigen die in een plugin of thema is opgenomen, is het niet haalbaar om dergelijke instellingen op te nemen voor
alle tekstreeksen. Sommige tekstreeksen, of ze nu aan gebruikers worden weergegeven of alleen in de WordPress-admin worden weergegeven, worden verondersteld voldoende te zijn voor kijkers en kunnen niet eenvoudig worden gewijzigd.
Dit is waar de
Say What? WordPress-plugin handig is. Say What? maakt gebruik van een WordPress-standaard die ontwikkelaars van plugins en thema's aanmoedigt om alle tekstreeksen "vertalingsklaar" te maken. Wanneer een tekstreeks vertalingsklaar is, betekent dit dat met de juiste WordPress-configuratie de plugin of het thema naar een andere taal kan worden vertaald.
Say What? kan die vertalingsklare tekstreeksen individueel targeten en naar behoefte aanpassen.
Say What? gebruiken om een tekstreeks aan te passen
Laten we een eenvoudig voorbeeld bekijken van hoe u een tekstreeks kunt aanpassen met de
Say What? plugin.
Wanneer een product aan de winkelwagen wordt toegevoegd in Easy Digital Downloads, en de klant doorgaat naar de afrekenpagina, wordt de afrekenwagen weergegeven met een lijst van producten die de klant aan de winkelwagen heeft toegevoegd.
Merk de koppen "Item Naam", "Item Prijs" en "Acties" op die boven de kolommen in de afrekenwagen worden weergegeven. Dat zijn tekstreeksen die zijn opgenomen in Easy Digital Downloads. Er zijn echter geen instellingen om die tekst te wijzigen. Dus we gebruiken
Say What? om de tekst "Item Naam" aan te passen met de volgende stappen.
1. Installeer en activeer
Say What?. Als u niet bekend bent met het installeren van een WordPress-plugin, bekijk dit artikel van WP Beginners.
2. Eenmaal geactiveerd, ga naar
Tools -> Tekstwijzigingen in uw WordPress-dashboard en klik op de knop Nieuwe toevoegen bovenaan de pagina.
3. U krijgt vier tekstvelden te zien:
Originele tekstreeks, Tekstdomein, Tekstcontext en Vervangende tekstreeks.
- Originele tekstreeks – Dit veld is voor de tekst die u probeert te wijzigen. In dit geval willen we de tekstreeks "Item Naam" wijzigen, dus dat is precies wat u in het veld zou invoeren. Opmerking: Dit veld is hoofdlettergevoelig. Dat betekent dat u de tekst exact moet invoeren zoals deze wordt weergegeven. "Item Naam" en "item naam" zijn niet dezelfde tekstreeks.
- Tekstdomein – Dit veld vereist een unieke identificatie die elke plugin of thema moet hebben. Voor Easy Digital Downloads is het tekstdomein
easy-digital-downloads. Als u hulp nodig heeft bij het vinden van het tekstdomein voor een andere plugin of thema, neem dan contact op met de ontwikkelaar. - Tekstcontext – Dit veld is niet altijd vereist. Soms zijn twee of meer tekstreeksen in een enkele plugin of thema exact hetzelfde. Wanneer dit gebeurt, bieden ontwikkelaars doorgaans context voor elke tekstreeks die helpt te identificeren waar elke specifieke reeks wordt gebruikt. In de meeste gevallen kan dit veld leeg worden gelaten.
- Vervangende tekstreeks – Dit veld is uw speeltuin. De tekst die u in het veld Originele tekstreeks plaatst, wordt vervangen door wat u ook in dit veld plaatst.
4. Sla uw nieuwe tekstwijziging op en controleer de resultaten.
Hier is een voorbeeld van een tekstwijziging die past bij ons voorbeeldwerk:
Met die tekstwijziging toegevoegd, kunnen we verwachten dat "Item Name" wordt vervangen door "My Custom Text" in de afrekenmand.
Succes!
Probleemoplossing & veelvoorkomende problemen
Er zijn momenten dat het gebruik van
Say What? een beetje ingewikkelder is dan het bovenstaande voorbeeld. Als u een nieuwe tekstwijziging hebt gemaakt en deze werkt niet correct, zijn er een paar verschillende dingen om te controleren.
Hoofdlettergevoeligheid
Zorg ervoor dat uw
Originele tekstreeks waarde hetzelfde hoofdletterpatroon gebruikt als de tekstreeks die u probeert te wijzigen. My Text String is niet hetzelfde als my text string.
Plaatsaanduidingen
Vertalingsklare reeksen in WordPress kunnen worden omwikkeld met PHP-code die delen van de tekst laat vervangen door plaatsaanduidingen.
Bijvoorbeeld, Easy Digital Downloads geeft een foutmelding weer op de afrekenpagina als een klant probeert een aankoop te voltooien met een e-mailadres dat van een andere klant is. Het volgende bericht wordt weergegeven:
Het e-mailadres [email protected] is al in gebruik.
Hoewel dat voor de klant een normale tekstreeks lijkt, gebruikt de werkelijke tekstreeks een PHP-plaatsaanduiding om het e-mailadres een andere waarde te laten hebben op basis van het e-mailadres dat de klant probeert te gebruiken. Dus de werkelijke tekstreeks ziet er als volgt uit:
Het e-mailadres %s is al in gebruik.
Zoals u kunt zien,
%s is de plaatsaanduiding voor het e-mailadres. Wanneer u uw tekstwijziging in Say What? maakt, vereist het veld Originele tekstreeks dat u de tekstreeks exact opneemt, wat betekent dat uw waarde een of meer PHP-plaatsaanduidingen kan bevatten.
Tekstcontext vereist
Het is niet ongebruikelijk dat twee verschillende tekstreeksen exact hetzelfde zijn. Wanneer dit gebeurt, worden ontwikkelaars aangemoedigd om een context te bieden die uitlegt waar elke tekstreeks wordt gebruikt om de ene van de andere te onderscheiden.
Als u de codebase van een plugin of thema zou doorzoeken op een specifieke tekstreeks, bijvoorbeeld de tekstreeks "Opslaan" in een bepaalde plugin, zou u kunnen vaststellen dat deze exacte tekstreeks op drie verschillende plaatsen wordt gebruikt. Dat betekent dat zonder context, het wijzigen van de tekstreeks veranderingen op alle drie de locaties zal veroorzaken. Om dat te voorkomen, ziet u mogelijk een vertaalbare tekstreeks in de codebase die er als volgt uitziet:
__( 'Opslaan', 'de knop voor het opslaan van plugininstellingen', 'text-domain');
Deze tekstreeks biedt een context van
de knop voor het opslaan van plugininstellingen. Wanneer u uw tekstwijziging maakt in Say What?, zorg er dan voor dat u die exacte waarde invoert in het veld Tekstcontext.
Notities & tips
Soms kost het wat moeite om een tekstreeks op te sporen. De tekstreeks zelf is mogelijk niet altijd hetzelfde als de tekst die op uw website wordt weergegeven.
Een snelle manier om de exacte tekstreeks te vinden die u zoekt, is door in de hoofdmap van de plugin of thema's te zoeken naar een
languages map, en vervolgens die map te doorzoeken op een bestand dat eindigt op .pot. Dit bestand bevat een volledige lijst van vertaalbare reeksen die door de plugin of het thema worden aangeboden. Doorzoek strategisch de lijst op uw reeks. U kunt bijvoorbeeld zoeken naar "is al in gebruik" wanneer u zoekt naar de reeks uit ons voorbeeld van plaatsaanduidingen.
Als u een tekstreeks niet kunt vinden, neem dan contact op met de ondersteuning van de plugin of het thema en vraag om hulp bij het opsporen ervan. Het kan zijn dat u het simpelweg over het hoofd heeft gezien, of dat de tekstreeks niet vertaalbaar is.
