Tabella dei Contenuti
Requisiti tecnici OpenCart
La traduzione automatica neurale da utilizzare con OpenCart richiede l'uso dello script PHP (scaricabile qui sotto). Per installare lo Linguise , sono necessari i seguenti requisiti:
- Esegui PHP 7+
- Server Apache, LiteSpeed, NGINX, IIS
- Attiva la riscrittura dell'URL tramite la configurazione PrestaShop
Come installare la traduzione di OpenCart
1. Genera la chiave API per attivare la traduzione
Dopo aver effettuato l'accesso alla Linguise dashboard dovrai prima configurare un nuovo dominio e salvarne le impostazioni per ottenere la chiave API.
La chiave API è ciò che serve per attivare la traduzione sul tuo OpenCart . In pratica, la chiave API verificherà quale lingua è attivata su quale dominio e consentirà la generazione delle pagine di traduzione neurale.
Copia la chiave API e conservala negli appunti.
Quindi cliccando sulla scheda “Script PHP” otterrete le istruzioni di installazione che seguiremo qui nel dettaglio.
2. Carica e collega lo script Linguise con OpenCart
Lo script di traduzione Linguise deve essere caricato sul server su cui è installato OpenCart :
Dopo aver scaricato lo script, decomprimilo e caricalo nella cartella principale in cui è installato il CMS.
- Assicurati che si trovi nella directory principale del tuo sito web (dove OpenCart si trovano i file
- Assicurati che la cartella mantenga il suo nome predefinito "linguise".
Come accedere all'interfaccia dello script Linguise ?
Dopo aver completato l' Linguise , puoi accedere alla dashboard visitando il tuo sito web con il seguente formato URL:
https://www.dominio.com/linguise
Cambia l'indirizzo del dominio in base all'indirizzo del tuo sito web*
Assicurati che Linguise abbia i permessi di lettura e scrittura appropriati*
Imposta password e connessione al database
Una volta effettuato l'accesso all'interfaccia dello script, verrà visualizzata una schermata di configurazione in cui è possibile creare una password e connettersi al database preferito.
Puoi:
- Imposta una password che sarà necessaria per i futuri accessi a questa interfaccia.
- Scegli il tipo di database: MySQL o SQLite, a seconda della tua configurazione e delle tue preferenze.
Questa configurazione iniziale garantisce un accesso sicuro e consente di configurare lo script in base al proprio ambiente.
Connessione al database MySQL
Se si sceglie MySQL, verrà visualizzata un'interfaccia diversa che richiederà i seguenti dettagli di connessione dei campi di configurazione MySQL riportati di seguito:
Assicurati che le informazioni siano corrette per stabilire una connessione corretta al tuo database MySQL.
MySQL vs SQLite: qual è la differenza?
Sia MySQL che SQLite sono sistemi di database molto diffusi, utilizzati per archiviare e gestire dati per siti web e applicazioni. Tuttavia, sono progettati per casi d'uso diversi e presentano alcune differenze fondamentali:
| Caratteristica | SQLite | MySQL |
|---|---|---|
| Impostare | Molto semplice (è richiesta l'installazione di SQLite) | Richiede la configurazione del server |
| Archiviazione | fila indiana | Gestito dal server MySQL |
| Prestazioni | Ottimo per app su piccola scala | Ideale per sistemi di grandi dimensioni e ad alto traffico |
| Caso d'uso | Applicazioni locali, test, piccoli siti | Applicazioni web, eCommerce, sistemi aziendali |
Interfaccia dello 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 ad altre piattaforme. Questo aggiornamento consente agli utenti di configurare senza problemi le impostazioni della lingua, come le opzioni di visualizzazione, gli stili dei flag e la personalizzazione dell'aspetto, direttamente da un'interfaccia unificata, indipendentemente dal CMS o dal framework in uso.
Gli amministratori possono gestire le impostazioni Linguise in modo più efficiente, con funzionalità coerenti come popup di selezione della lingua, effetti ombra e varianti di scelta delle bandiere specifiche per regione. La dashboard mantiene il suo design intuitivo, offrendo al contempo una maggiore compatibilità con diversi ambienti web.
3. Imposta gli URL delle lingue in OpenCart
La riscrittura degli URL viene solitamente attivata per scopi SEO su OpenCart. La riscrittura degli URL avviene tramite un file .htaccess disponibile nella root del server.
Dalle OpenCartOpenCartOpenCart OpenCartOpenCartOpenCartOpenCart OpenCartOpenCart :
Sistema > Impostazioni > Predefinite > Server
L'URL per lingua deve essere configurato nel file .htaccess. Basta copiare questo codice dopo il codice "RewriteBase /" presente nel file .htaccess predefinito OpenCart .
<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. Attiva il selettore di lingua
Ora puoi caricare tutte le tue pagine tradotte utilizzando l'URL, ad esempio: www.dominio.com/fr/
Il selettore della lingua è il popup con la bandierina che permette di selezionare la lingua desiderata. Per caricarlo, è necessario copiare il link allo LinguiseOpenCartOpenCart OpenCartOpenCartOpenCartOpenCart OpenCartOpenCart di tutte le pagine. Il selettore della lingua con la bandierina verrà quindi caricato automaticamente. Ecco il link allo script:
dashboard.linguise.com > Impostazioni
Per aggiungerlo alla tua OpenCart , vai su Design > Editor temi e modifica l'intestazione predefinita del template.
Il selettore di lingua verrà visualizzato per impostazione predefinita in alto a destra sul tuo sito web. Puoi personalizzarlo dalla dashboard Linguise nel passaggio successivo.
Nota importante per la SEO: il numero di lingue che imposti ha un impatto significativo sulla SEO. Quando imposti le lingue di traduzione, se hai un numero elevato di pagine indicizzate (>500), il motore di ricerca potrebbe impiegare molto tempo per elaborarle. Ciò potrebbe influire sulla SEO nella lingua originale. Per questo motivo, consigliamo di aggiungere inizialmente un massimo di 5 lingue e, una volta che queste sono state indicizzate, di aggiungerne altre 3 al mese.
Configura il selettore della lingua
Il selettore della lingua può essere personalizzato dalla Linguise > Impostazioni > Visualizzazione delle bandiere della lingua. Ogni modifica apportata qui verrà visualizzata sul sito web.
Sul lato destro dello schermo è presente l'anteprima del selettore di lingua. Ecco gli elementi che puoi impostare:
- 3 layout: affiancati, a discesa o popup
- Posizione del selettore di lingua
- 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 selettore della lingua in una posizione specifica all'interno del contenuto CMS, è necessario impostare la posizione su "Sul posto".
Una volta impostata la posizione nella Linguise , è possibile aggiungere lo shortcode sottostante per includerlo. Fare clic sul codice qui sotto per copiarlo negli appunti.
<div>[linguise]</div>
Una volta aggiunto, sul frontend verranno visualizzati i nomi della bandiera e della lingua nell'area HTML in cui hai aggiunto il codice.
Attiva il sistema di cache locale della traduzione
In alternativa, puoi attivare un sistema di cache locale che memorizza gli URL e i relativi contenuti multilingue per servire le pagine più velocemente. La cache locale eviterà il trasferimento 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 in priorità sarà quella delle pagine multilingue più visualizzate.
Come opzione, è possibile definire la quantità di cache memorizzata 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 è presente anche un'impostazione che consente di passare alcune configurazioni specifiche per il CMS. Di default, questa impostazione è automatica, ma il team di supporto potrebbe chiederti di personalizzarla per utilizzare impostazioni specifiche.
Ecco il codice da aggiungere per OpenCart, questo è il nome del 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 file 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 relative a MySQL in questa sezione 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 sui server Windows IIS
Aggiungi la riga corrispondente al tuo generatore di siti web nel file Web.config.
Dovrebbe essere impostata 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;