Installa Linguise su un sito web che esegue PHP

Sommario

Requisiti tecnici

Per eseguire lo script di traduzione Linguise , avrai bisogno di quanto segue:

  • Esegui PHP 7+
  • Server Apache, LiteSpeed, NGINX, IIS
  • Attiva la riscrittura dell'URL nella configurazione del tuo server

Come installare lo script nel video

1. Genera la chiave API

Dopo la connessione alla dashboard Linguise , dovrai prima configurare un nuovo dominio e salvarne le impostazioni per ottenere la chiave API.

La chiave API è ciò che è necessario per attivare la traduzione sul tuo sito web. Fondamentalmente, la chiave API controllerà quale lingua è attivata su quale dominio e consentirà la generazione delle pagine di traduzione neurale.

Copia la chiave API e conservala negli appunti.

Cliccando poi sulla scheda “Script PHP” otterrete le istruzioni di installazione che seguiremo qui in dettaglio.

2. Carica e collega lo script di traduzione Linguise

Lo script di traduzione Linguise deve essere caricato sul tuo server, può essere scaricato qui:

Dopo aver scaricato lo script, decomprimilo e caricalo nella cartella principale in cui è installato il CMS.

  • Assicurati che sia al livello principale del tuo sito web (di solito dove si trovano i file CMS)
  • Assicurati che la cartella si chiami " linguise " (il nome predefinito quando la cartella viene decompressa)

La Linguise dovrà essere copiata nella cartella: …/ linguise /Configuration.php file che hai caricato sul tuo server, modifica il file e copia la tua chiave API tra virgolette semplici, sostituisci il testo REPLACE_BY_TOUR TOKEN.

config-php

3. Imposta gli URL della lingua

L'URL per lingua deve essere configurato nel file .htaccess. Se hai un "RewriteBase /" nel tuo file, copia solo dopo tutto il codice seguente. È meglio inserire il codice all'inizio del file:

				
					<IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA]
</IfModule>
				
			
file-carrello-aperto

4. Attivare il selettore di lingua

Il selettore di lingua è il popup di bandiera per selezionare la lingua desiderata. Per caricarlo, dovrai copiare il codice fornito per caricare lo script ovunque nella configurazione del tuo sito web o nel file modello.

La cosa più importante è caricare lo script in tutte le tue pagine, nella sezione head.

Il selettore di lingua verrà visualizzato per impostazione predefinita in una posizione mobile in basso a destra sul tuo sito web. Puoi personalizzarlo dalla dashboard Linguise .

Nota importante sulla SEO: il numero di lingue impostate ha un grande impatto sulla SEO. Quando imposti le tue lingue di traduzione, se hai una grande quantità di pagine indicizzate (>500), il motore di ricerca potrebbe impiegare molto tempo per elaborarle. Potrebbe avere un impatto sulla tua SEO nella tua lingua originale. Ecco perché ti consigliamo di aggiungere all'inizio un massimo di 5 lingue, poi, una volta indicizzato, puoi aggiungere le lingue in un batch di 3 al mese.

Imposta il selettore di lingua

Il selettore della lingua può essere personalizzato dalla Linguise > Impostazioni > Visualizzazione dei flag della lingua. Ogni modifica qui si rifletterà sul sito web.

Sul lato destro dello schermo hai l'anteprima del selettore di lingua. Ecco gli elementi che puoi impostare:

  • 3 layout: affiancati, a discesa o popup
  • La posizione del selettore di lingua
  • Il contenuto del selettore di lingua
  • Nomi delle lingue in inglese o nella lingua madre
  • Forme e dimensioni delle bandiere
  • Colori e ombra della scatola

Carica il selettore di lingua nel contenuto PHP

posizione della bandiera sul posto

Per visualizzare il commutatore di lingua in un punto specifico, nel contenuto PHP, è necessario impostare la posizione su "Sul posto".
Una volta impostata la posizione nella Linguise , puoi aggiungere lo shortcode qui sotto per includerla. Clicca sul codice qui sotto per inserirlo negli appunti.

Una volta aggiunto, sul frontend avrai la bandiera e i nomi delle lingue visualizzati nell'area HTML in cui hai aggiunto il codice.

Attiva il sistema di cache locale

Come opzione, puoi attivare un sistema di cache locale che memorizza gli URL e il relativo contenuto multilingue per servire le pagine più velocemente. La cache locale salverà alcuni trasferimenti di dati tra il server Linguise e il server del tuo sito web. La cache viene utilizzata solo quando una pagina è già stata tradotta e non è stata aggiornata. La cache mantenuta prioritaria sarà la cache delle pagine multilingue più visualizzate.

Come opzione è possibile definire la quantità di cache archiviata in MB. Nell'esempio seguente la cache è attivata e la quantità di cache da conservare è 500 MB:

				
					    /** Basic configuration **/
    public $cache_enabled = true;
    public $cache_max_size = 500; // In megabyte
				
			

Traduzione automatica su server Windows IIS

Aggiungi la riga corrispondente al tuo costruttore di siti web nel file Web.config.
Dovrebbe essere impostato prima di qualsiasi altro reindirizzamento, in particolare il reindirizzamento al file principale PHP:

				
					<rule name="Linguise" stopProcessing="true">
<match url="^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$" ignoreCase="false" />
        <conditions logicalGrouping="MatchAll" trackAllCaptures="false" />
            <action type="Rewrite" url="linguise/linguise.php?linguise_language={R:1}&amp;original_url={R:2}" appendQueryString="true" />
</rule>
				
			

Traduzione automatica sui server NGINX

Aggiungi la riga corrispondente al tuo CMS nel blocco di configurazione del server NGINX.
Dovrebbe essere impostato prima di qualsiasi altro reindirizzamento, in particolare il reindirizzamento nel file principale PHP.
				
					rewrite ^/(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ /linguise/linguise.php?linguise_language=$1&original_url=$2 last;