Tabla de contenido
Requisitos técnicos OpenCart
La traducción automática neuronal que se usará con OpenCart requiere el script PHP (descargable a continuación). Para instalar el Linguise , se requieren los siguientes requisitos:
- Ejecute PHP 7+
- Apache, LiteSpeed, NGINX, servidor IIS
- Activar la reescritura de URL a través de la configuración PrestaShop
Cómo instalar la traducción OpenCart
1. Generar la clave API para activar la traducción
La clave API es necesaria para activar la traducción en tu OpenCart . Básicamente, la clave API comprobará qué idioma está activado en qué dominio y permitirá generar las páginas de traducción neuronal.
Copie la clave API y guárdela en su portapapeles.

Luego, haciendo clic en la pestaña “Script PHP”, obtendrá las instrucciones de instalación que seguiremos aquí en detalle.

2. Cargue y conecte el script Linguise con OpenCart
El script de traducción Linguise debe cargarse en el servidor donde está instalado OpenCart :
Después de descargar el script, descomprímalo y cárguelo en la carpeta raíz donde está instalado el CMS.
- Asegúrese de que esté en el nivel raíz de su sitio web (donde se encuentran sus archivos OpenCart
- Asegúrese de que la carpeta mantenga su nombre predeterminado “ linguise ”

¿Cómo acceder a la interfaz de script Linguise ?
Después de completar la Linguise , puede acceder al tablero visitando su sitio web con el siguiente formato de URL:
https://www.domain.com/ linguise
Cambie la dirección de dominio de acuerdo con la dirección de su sitio web*
Asegúrese de que Linguise tenga un permiso de lectura y escritura adecuado*
Configuración de contraseña y conexión de base de datos
Una vez que acceda a la interfaz de script, se le presentará una pantalla de configuración donde puede crear una contraseña y conectarse a su base de datos preferida.
Puede:
- Establezca una contraseña, que se requerirá para el acceso futuro a esta interfaz.
- Elija su tipo de base de datos, ya sea MySQL o SQLite, dependiendo de su configuración y preferencia.
Esta configuración inicial garantiza un acceso seguro y le permite configurar el script de acuerdo con su entorno.

Conexión de la base de datos MySQL
Si elige MySQL, aparecerá una interfaz diferente solicitando los siguientes detalles de conexión de los campos de configuración de MySQL a continuación:

Asegúrese de que la información sea correcta para establecer una conexión exitosa con su base de datos MySQL.
MySQL vs SQLite - ¿Cuál es la diferencia?
Tanto MySQL como SQLite son sistemas de bases de datos populares utilizados para almacenar y administrar datos para sitios web y aplicaciones. Sin embargo, están diseñados para diferentes casos de uso y tienen algunas diferencias clave:
| Característica | Sqlite | Mysql |
|---|---|---|
| Configuración | Muy fácil (se requiere instalación de SQLite) | Requiere la configuración del servidor |
| Almacenamiento | Fila india | Gestionado por MySQL Server |
| Actuación | Ideal para aplicaciones a pequeña escala | Mejor para sistemas grandes y de alto tráfico |
| Caso de uso | Aplicaciones locales, pruebas, sitios pequeños | Aplicaciones web, comercio electrónico, sistemas empresariales |
Interfaz de script Linguise : Configuración para la plataforma PHP
El tablero de traducción de Linguise , anteriormente disponible solo para Joomla y WordPress, ahora extiende el soporte a PHP y plataformas adicionales. Esta actualización permite a los usuarios configurar sin problemas la configuración del idioma, como opciones de visualización, estilos de bandera y personalización de apariencia, directamente desde una interfaz unificada, independientemente de su CMS o marco.

Los administradores pueden administrar la configuración Linguise de manera más eficiente, con características consistentes como ventanas emergentes de selección de idiomas, efectos de sombra y variantes de opciones de bandera específicas de la región. El tablero conserva su diseño fácil de usar al tiempo que ofrece una compatibilidad más amplia para diversos entornos web.


3. Configurar las URL de idioma en OpenCart
La reescritura de URL suele activarse con fines SEO en OpenCart. Esta reescritura utiliza un archivo .htaccess disponible en la raíz del servidor.

En la OpenCart , compruebe que la reescritura de URL esté activada. Utilice el menú de administración OpenCart
Sistema > Configuración > Predeterminado > Servidor.

La URL por idioma debe configurarse en el archivo .htaccess. Simplemente copie este código después del código "RewriteBase /", disponible en el archivo .htaccess predeterminado OpenCart .
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]
Asegúrese de que la ruta linguise/linguise.php sea la misma en su servidor, /linguise/ es el nombre predeterminado cuando descomprime el script.
4. Activa el selector de idiomas
Ahora puedes cargar todas tus páginas traducidas usando la URL, por ejemplo: www.dominio.com/fr/

El selector de idioma es la ventana emergente que te permite seleccionar el idioma que deseas. Para cargarlo, copia el enlace al script Linguise OpenCart de todas tus páginas. El selector de idioma se cargará automáticamente. Puedes encontrar el enlace del script en:
panel delinguise> Configuración

Luego, para agregarlo a su OpenCart , vaya a Diseño > Editor de temas y edite el encabezado/valor predeterminado de la plantilla.
El selector de idiomas se mostrará por defecto en una posición flotante en la esquina superior derecha de tu sitio web. Puedes personalizarlo desde el panel Linguise en el siguiente paso.

Nota importante de SEO: la cantidad de idiomas que configura tiene un gran impacto en el SEO. Cuando configura sus idiomas de traducción, si tiene una gran cantidad de páginas indexadas (> 500), el motor de búsqueda puede tardar mucho tiempo en procesarlas. Puede afectar su SEO en su idioma original. Es por eso que recomendamos agregar al principio un máximo de 5 idiomas, luego cuando esté indexado, puede agregar idiomas en un lote de 3 por mes.
Configurar el selector de idioma
El selector de idiomas se puede personalizar desde el Linguise > Configuración > Mostrar indicadores de idioma. Cualquier modificación aquí se reflejará en el sitio web.

En el lado derecho de la pantalla, tienes la vista previa del selector de idiomas. Aquí tienes los elementos que puedes configurar:
- 3 diseños: lado a lado, desplegable o emergente
- La posición del selector de idioma
- El contenido del selector de idioma
- Nombres de idiomas en inglés o idioma nativo
- Formas y tamaños de banderas
- Colores y sombra de caja.
Cargar el selector de idioma en el contenido OpenCart

Para mostrar el selector de idioma en la ubicación específica del contenido del CMS, debe configurarlo como "In situ".
Una vez que lo haya configurado en el Linguise , puede agregar el código corto a continuación para incluirlo. Haga clic en el código a continuación para guardarlo en el portapapeles.
[linguise]
Una vez agregado, en la interfaz tendrá la bandera y los nombres del idioma mostrados en el área HTML en la que agregó el código.
Activar el sistema de caché local de traducción
Como opción, puede activar un sistema de caché local que almacena las URL y su contenido multilingüe relacionado para servir las páginas más rápido. El caché local guardará algunas transferencias de datos entre el servidor de Linguise y el servidor de su sitio web. El caché se usa solo cuando una página ya se ha traducido y no se ha actualizado. El caché mantenido en prioridad será el caché de las páginas multilingües más vistas.

Como opción, puede definir la cantidad de caché almacenada en MB. En el siguiente ejemplo, la caché está activada y la cantidad de caché a conservar es de 500 MB:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Configuraciones específicas para OpenCart CMS
En el archivo Configuration.php también tenemos una opción que permite pasar una configuración específica para el CMS. Por defecto, es automática, pero el equipo de soporte podría pedirle que la personalice para usar ajustes especiales.
Aquí está el código para agregar para OpenCart , este es el nombre del CMS en minúsculas:
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'opencart';
De SQLite a MySQL
Aún en Configuration.php hay una configuración para forzar el uso de MySQL en lugar de SQLite, en caso de que SQLite no esté instalado en el servidor.
En este caso, deberás completar la información de MySQL en esta parte del archivo 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 = '';
Traducción automática en servidores Windows IIS
Agregue la línea correspondiente al creador de su sitio web en su archivo Web.config.
Debe configurarse antes de cualquier otra redirección, especialmente la redirección a su archivo principal PHP:
Traducción automática en servidores 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;
