Sommario
Requisiti tecnici OpenCart
La traduzione automatica neurale da utilizzare con OpenCart richiederà l'utilizzo dello script PHP (scaricabile di seguito). Per installare lo Linguise , avrai bisogno dei seguenti requisiti:
- Esegui PHP 7+
- Server Apache, LiteSpeed, NGINX, IIS
- Attiva la riscrittura dell'URL tramite la configurazione PrestaShop
Come installare la traduzione OpenCart
1. Genera la chiave API per attivare la traduzione
La chiave API è ciò che è necessario per attivare la traduzione sul tuo OpenCart . 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 Linguise con OpenCart
Lo script di traduzione Linguise deve essere caricato sul tuo server su cui è installato OpenCart :
Dopo aver scaricato lo script, decomprimilo e caricalo nella cartella principale in cui è installato il CMS.
- Assicurati che sia al livello root del tuo sito web (dove si trovano i tuoi file OpenCart
- Assicurati che la cartella mantenga il nome predefinito " linguise "
Come accedere all'interfaccia di script Linguise ?
Dopo aver completato l' Linguise , è possibile accedere alla dashboard visitando il tuo sito Web con il seguente formato URL:
https://www.domain.com/ linguise
Modifica l'indirizzo di dominio in base all'indirizzo del tuo sito Web*
Assicurati che Linguise abbia un'adeguata autorizzazione di lettura e scrittura*
Setup password e connessione al database
Una volta accettato l'interfaccia di script, ti verrà presentata una schermata di configurazione in cui è possibile creare una password e connetterti al tuo database preferito.
Puoi:
- Imposta una password, che sarà richiesta per l'accesso futuro a questa interfaccia.
- Scegli il tipo di database: MySQL o SQLite, a seconda della configurazione e della preferenza.
Questa configurazione iniziale garantisce un accesso sicuro e consente di configurare lo script in base al proprio ambiente.
Connessione del database MySQL
Se scegli MySQL, verrà visualizzata un'interfaccia diversa che richiede i seguenti dettagli di connessione dei campi di configurazione MySQL di seguito:
Assicurati che le informazioni siano corrette per stabilire una connessione di successo al tuo database MySQL.
MySQL vs SQLite - Qual è la differenza?
Sia MySQL che SQLite sono sistemi di database popolari utilizzati per archiviare e gestire i dati per siti Web e applicazioni. Tuttavia, sono progettati per diversi casi d'uso e hanno alcune differenze chiave:
| Caratteristica | Sqlite | Mysql |
|---|---|---|
| Impostare | Molto semplice (installazione di sqlite richiesta) | Richiede la configurazione del server |
| Magazzinaggio | File singolo | Gestito dal server MySQL |
| Prestazione | Ottimo per le app su piccola scala | Meglio per sistemi grandi e ad alto traffico |
| Caso d'uso | App locali, test, piccoli siti | App Web, eCommerce, Enterprise Systems |
Interfaccia script Linguise : configurazione per la piattaforma PHP
La dashboard di traduzione Linguise , precedentemente disponibile solo per Joomla e WordPress, ora estende il supporto a PHP e piattaforme aggiuntive. Questo aggiornamento consente agli utenti di configurare perfettamente le impostazioni della lingua, come opzioni di visualizzazione, stili di flag e personalizzazione dell'aspetto, direttamente da un'interfaccia unificata, indipendentemente dal loro CMS o framework.
Gli amministratori possono gestire le impostazioni Linguise in modo più efficiente, con funzionalità coerenti come popup di selezione delle lingue, effetti ombra e varianti delle scelte di bandiera specifiche della regione. La dashboard mantiene il suo design intuitivo offrendo una più ampia compatibilità per diversi ambienti Web.
3. Imposta gli URL della lingua in OpenCart
La riscrittura dell'URL viene solitamente attivata per scopi SEO su OpenCart. La riscrittura dell'URL utilizza un file .htaccess disponibile nella root del tuo server.
Dalle OpenCart , verifica che la riscrittura degli URL sia attivata. Utilizza il OpenCart :
Sistema > Impostazioni > Predefinito > Server
L'URL per lingua deve essere configurato nel file .htaccess. Basta copiare questo codice dopo il codice "RewriteBase /" disponibile nel OpenCart .htaccess predefinito.
<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>
Assicurati che il percorso linguise/linguise.php sia lo stesso sul tuo server, /linguise/ è il nome predefinito quando decomprimi lo script.
4. Attivare il selettore di lingua
Ora puoi caricare tutte le tue pagine tradotte utilizzando l'URL, ad esempio: www.domain.com/fr/
Il selettore di lingua è il popup di bandiera per selezionare la lingua desiderata. Per caricarlo, dovrai copiare il collegamento allo Linguise fornito nell'intestazione OpenCart di tutte le tue pagine. Il cambio della lingua delle bandiere verrà quindi caricato automaticamente. Ecco il collegamento allo script che puoi trovare su:
pannello di controllo.linguise> Impostazioni
Quindi, per aggiungerlo alla tua OpenCart , vai su Design > Editor del tema e modifica l'intestazione/predefinita del modello.
Il selettore di lingua verrà visualizzato per impostazione predefinita in una posizione mobile in alto a destra sul tuo sito web. Sei pronto per personalizzarlo dalla dashboard Linguise nel passaggio successivo.
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 cambio 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 OpenCart
Per visualizzare il commutatore di lingua in una posizione specifica, nel contenuto CMS, è 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.
<div>[linguise]</div>
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 di traduzione
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
Impostazioni specifiche per OpenCart CMS
Nel file Configuration.php abbiamo anche un'impostazione che permette di passare alcune configurazioni specifiche per il CMS. Per impostazione predefinita, è automatico, ma il team di supporto potrebbe chiederti di personalizzarlo per utilizzare alcune impostazioni speciali.
Ecco il codice da aggiungere per OpenCart , questo è il nome CMS in minuscolo:
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'opencart';
Da SQLite a MySQL
Sempre nel Configuration.php c'è un'impostazione per forzare l'utilizzo di MySQL invece di SQLite, nel caso in cui SQLite non sia installato sul server.
In questo caso, dovrai inserire le informazioni MySQL in questa parte del file Configuration.php:
/** Advanced database configuration **/
/*
* In case you don't want to use Sqlite, you can use MySQL
* To do so, you need to fill the following variables
* Linguise will create the tables for you
*/
public static $db_host = '';
public static $db_user = '';
public static $db_password = '';
public static $db_name = '';
public static $db_prefix = '';
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}&original_url={R:2}" appendQueryString="true" />
</rule>
Traduzione automatica sui server NGINX
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;