Instalar la traducción automática Linguise en Magento

Tabla de contenido

Requisitos técnicos Magento

La traducción automática neuronal que se utilizará con Magento requerirá el uso del script PHP (se puede descargar a continuación). Para instalar el Linguise , necesitará los siguientes requisitos:

  • Ejecute PHP 7+
  • Apache, LiteSpeed, NGINX, servidor IIS
  • Activar la reescritura de URL a través de la configuración Magento
  • Magento 2+
  • La carpeta raíz de Magento /pub ", asegúrese de instalar Linguise dentro de esta carpeta.

Generar la clave API

Después de conectarse a su control Linguise , primero deberá configurar un nuevo dominio y guardar su configuración para obtener la clave API.

La clave API es lo que se requiere para activar la traducción en su sitio web Magento . Básicamente, la clave API verificará qué idioma está activado en qué dominio y permitirá que se generen las páginas de traducción neuronal.

Copie la clave API y guárdela en su portapapeles.

Paso 2 de 2, ¡listo! ¡Ya puedes empezar a traducir!

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

Una captura de pantalla de las instrucciones de instalación de un complemento WordPress , que muestra los pasos para instalar una prueba social en un sitio web.

Cargue y conecte el script de traducción de Linguise

El script de traducción Linguise debe cargarse en su servidor donde está instalado Magento :

Una vez descargado 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 Magento , de forma predeterminada está dentro de /pub )
  • Asegúrese de que la carpeta mantenga su nombre predeterminado " linguise "
Listado de directorios de un sistema de archivos con carpetas

¿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ísticaSqliteMysql
ConfiguraciónMuy fácil (se requiere instalación de SQLite)Requiere la configuración del servidor
AlmacenamientoFila indiaGestionado por MySQL Server
ActuaciónIdeal para aplicaciones a pequeña escalaMejor para sistemas grandes y de alto tráfico
Caso de usoAplicaciones locales, pruebas, sitios pequeñosAplicaciones 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.

interfaz API

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.

Pantalla interfaz
interfaz de apariencia

Configuración adicional Magento

En la barra lateral de administración, vaya a Tiendas > Configuración > Configuración > General > Web > Opciones de URL y configure la opción Agregar código de tienda a URL No ".

Acceda al código de su sitio web y abra app/etc/env.php . Establezca 'document_root_is_pub' en verdadero.

document_root_is_pub

Asegúrese de configurar ambos pasos y continúe con Configurar la reescritura de URL para garantizar que Linguise pueda ejecutarse correctamente en su sitio web Magento sin problemas.

Configurar la reescritura de URL

En la barra lateral de administración, vaya a Tiendas > Configuración > Configuración > General > Web > Optimización de motores de búsqueda y habilite la opción Usar reescritura del servidor web Más información en la documentación oficial Magento

Configuración SEO Magento 2. Usar encabezado H1.

La URL por idioma debe configurarse en el .htaccess. Simplemente copie este código después del código " RewriteEngine on " disponible en el .htaccess predeterminado Magento 2 :

				
					<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,END]
</IfModule>
				
			

Finalmente, su Magento .htaccess debería verse así:

Una pantalla de computadora que muestra líneas de código
ENTENDEMOS QUE LA CONFIGURACIÓN DE URL Y EL CAMBIADOR DE IDIOMA SON UN POCO TÉCNICOS DE CONFIGURAR; ¡PERO BUENAS NOTICIAS! OFRECEMOS INSTALACIÓN GRATUITA

Activar el selector de idioma

Cargue el script Linguise JS

Ahora puede cargar todas sus páginas traducidas usando la URL, por ejemplo: www.shop.com / fr /

Captura de pantalla de un sitio web con un bloque de texto personalizado

El selector de idioma es la ventana emergente de bandera para seleccionar el idioma que desea. Para cargarlo, deberá copiar el código que se proporciona al final de la configuración del sitio web en el encabezado de su página HTML. El selector de idioma de la bandera se cargará automáticamente.

El código para copiar y cargar en el encabezado de su sitio web está disponible en su Linguise > Su dominio > Configuración > Pestaña: Script PHP

Banner de consentimiento de cookies en un sitio web

Debe cargarse en el encabezado de su página. Magento 2 te brinda la posibilidad de agregar contenido en el encabezado de tu página a través de la configuración.

Captura de pantalla de la página de configuración de diseño. La página muestra una tabla con diversas opciones de configuración.

En el panel de administración, vaya a Contenido > Configuración , edite la vista predeterminada del tema de la tienda, luego haga clic en la sección Encabezado HTML y agregue el script copiado a la entrada Scripts y hojas de estilo. Finalmente, guarde la configuración.

Página de configuración de estilo de meta palabras clave y fragmentos predeterminados. Un cuadro de texto con el valor predeterminado.
ENTENDEMOS QUE LA CONFIGURACIÓN DE URL Y EL CAMBIADOR DE IDIOMA SON UN POCO TÉCNICOS DE CONFIGURAR; ¡PERO BUENAS NOTICIAS! OFRECEMOS INSTALACIÓN GRATUITA

Instalar el módulo de seguridad Magento

Desde Magento 2.3.5 es necesario agregar un módulo de seguridad para permitir que Magento cargue archivos desde el dominio Linguise . Si está familiarizado con Magento , eso no será un problema; de lo contrario, aquí tiene una guía paso a paso:

  1. Descarga el módulo desde este enlace
  2. Descomprima el contenido del zip en su instalación Magento en el directorio app/code/
  3. Luego ejecuta los comandos:
				
					php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
				
			

El selector de idiomas se mostrará de forma predeterminada en una posición flotante en la parte inferior derecha de su sitio web. Puede personalizarlo desde el panel de control Linguise .

Un menú desplegable para seleccionar idiomas en un sitio web. El menú incluye opciones para inglés, alemán, griego, español, francés, japonés, neerlandés, ruso y chino.

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 conmutador de idioma se puede personalizar desde el panel de control Linguise > Configuración > Visualización de banderas de idioma. Cada modificación aquí se reflejará en el sitio web.

Una captura de pantalla que muestra un menú desplegable para seleccionar la configuración de idioma con opciones para inglés.

En el lado derecho de la pantalla tienes la vista previa del selector de idioma. Estos son los elementos que puede 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.

Cargue el selector de idiomas en el contenido Magento

posición-de-la-bandera-en-su-lugar

Para mostrar el selector de idioma en un lugar específico, en el Magento , debe establecer la posición como "En su lugar".
Una vez que haya establecido la posición en el Linguise , puede agregar el código corto a continuación para incluirlo. Haga clic en el código a continuación para colocarlo en su portapapeles.

				
					<div>&#091;linguise&#093;</div>
				
			

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

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.

Ejemplo de código de configuración de traducción de Laravel . Configuración para configurar las traducciones.

Como opción, puede definir la cantidad de caché almacenada en MB. En el siguiente ejemplo, el caché está activado y la cantidad de caché a conservar es 500 MB:

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