Documentatie

Taalwisselaar

De schakelaar is wat bezoekers de taal laat veranderen. Het is geconfigureerd in Vertalingen → Schakelaar. Het verschijnt alleen als er minstens één doeltaal is.

Modus (Waar het verschijnt)

ModusWat het doet
Automatisch (standaard)Verschijnt op zichzelf, zwevend, zonder het thema aan te raken. Kies de hoek in Positie: onderaan rechts, onderaan links, bovenaan rechts of bovenaan links.
HandmatigPlaats het waar je maar wilt, met de shortcode of de PHP-functie (zie hieronder).
UitHet verschijnt niet.

In automatische modus, als je een schakelaar handmatig op een pagina plaatst, verlaat de zwevende die pagina — er zijn nooit twee.

De zwevende schakelaar verschijnt ook in de winkelmand en de kassa. Iemand die de winkelmand in de verkeerde taal bereikt, heeft op dat moment een manier nodig om terug te gaan naar de juiste taal, juist wanneer ze geld uitgeven.

Vorm

Elke vorm wordt gepreviewd in het paneel met de talen van je site.

VormWanneer het te gebruiken
LijstZij aan zij, alles zichtbaar. Scrollt horizontaal op zichzelf als het niet past.
KolomÉén per regel. Voor voetteksten en smalle zijbalken.
MenuOpent met een klik. Neemt de ruimte van een enkele taal in.
SysteemdoosDe selectiedoos van het systeem. Op telefoons opent het het native wiel, dat gemakkelijker met een vinger te raken is.

Hoe het leest

  • Vlaggen — toon een emoji-vlag voor de naam. Ze worden getekend door het systeem van de kijker, zonder afbeeldingen. Een taal waarvan de code geen land omvat (bijv. fr in plaats van fr_FR) krijgt geen vlag — een land is geen taal.
  • Naam of codeEngels, Español of EN, ES.
  • Stel de taal van de bezoeker voor — zie De taalsuggestiebalk.

Uiterlijk

Met een live voorbeeld ernaast:

  • Doos — achtergrond, rand, rand bij hover.
  • Talen — tekst, achtergrond en tekst bij hover, achtergrond en tekst van de huidige taal.
  • Vorm — tekstgrootte, afgeronde hoeken, schaduw.
  • Reset naar standaard — gaat terug naar de originele kleuren.

Als een tekstkleur onder een contrastverhouding van 4.5:1 komt (de minimum van de WCAG AA toegankelijkheidsnorm), waarschuwt het paneel je. Het waarschuwt, het voorkomt niet.

Handmatig plaatsen

Deze werken in alle drie de modi.

In inhoud of een widget:

[pht_switcher]

Shortcode opties:

  • show_label="no" — toont alleen de code in plaats van de naam;
  • class="my-class" — voegt een CSS-klasse toe.

In een thema-sjabloon (meestal header.php):

<?php pht_switcher(); ?>

Aanpassen met CSS

De schakelaar gebruikt ongeveer 4 KB CSS, alleen op de pagina's waar het verschijnt, en nul JavaScript in drie van de vier vormen. Elke weergave-optie is een CSS-variabele op .pht-switcher (--pht-bg, --pht-fg, --pht-hover, --pht-radius…), zodat een thema ze opnieuw kan definiëren zonder !important.


De taalsuggestiebalk

Iemand die de site bereikt in een taal die niet die van hun browser is, ziet een kleine balk bovenaan die de versie in hun taal aanbiedt.

  • Het stelt voor, het omleidt niet. Omleiden op basis van de browser-taal verstoort de pagina-cache, en Google adviseert hier tegen.
  • Het verschijnt slechts één keer. Kiezen of sluiten van antwoorden voor altijd.
  • Het is aan en uit te zetten in Schakelaar → Stel de taal van de bezoeker voor. Het is standaard ingeschakeld.

Automatische vertaling van de browser

Op pagina's die al door de plugin zijn vertaald, stoppen Chrome en andere browsers met het aanbieden van "Vertaal deze pagina" — hun vertaling bovenop de onze zou slechtere tekst opleveren. In de brontaal blijft de aanbieding actief: zo ontdekt een buitenlandse bezoeker dat de site bestaat in hun taal.

Publiceren.
Lees het in
elke taal.

30.000 tekens, één site, geen kaart. De sleutel arriveert per e-mail na de kassa.