Tabla de contenido
Requisitos técnicos MODX CMS
La traducción automática que se utilizará con el Marco de Gestión de Contenido MODX requerirá el script PHP (descargable a continuación). Para instalar el script Linguise , necesitará los siguientes requisitos:
- Ejecute PHP 7+
- Apache, LiteSpeed, NGINX, servidor IIS
- Asegúrese de que la reescritura de URL esté activada en su servidor
- MODX CMS 2.x o 3 y superior
1. Generar la clave API
Después de su conexión o registro en su panel de control Linguise , primero deberá configurar un nuevo dominio y guardar su configuración para obtener la clave API.
Puede seleccionar la plataforma "Otro PHP" para continuar con el dominio de registro Linguise , como esta documentación y los idiomas de origen y destino.
Después de eso obtendrás:
- La clave API que valida su membresía
- El enlace al script Linguise para el selector de idioma
La clave API es necesaria para activar la traducción en tu sitio web MODX CMS. Básicamente, la clave API comprueba el idioma activado en tu dominio y permite la traducción automática del contenido.
Por ahora, puede copiar la clave API y guardarla en su portapapeles.
2. Cargue y conecte el script de traducción Linguise
El script de traducción Linguise debe cargarse en el servidor donde está instalado MODX CMS:
Después de descargar el script, descomprímalo y cárguelo en la carpeta raíz donde está instalado MODX CMS.
- Asegúrate de que esté en el nivel raíz de tu sitio web (donde se encuentran tus archivos MODX
- 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 |
| Rendimiento | 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 la reescritura de URL MODX CMS
Por defecto, la reescritura de URL ya está activa en MODX CMS. Si no es así, puedes activarla desde tu proveedor de hosting.
La URL por idioma debe configurarse en el archivo .htaccess. Simplemente copie el código a continuación después del código " RewriteEngine on " , disponible en el archivo .htaccess predeterminado MODX CMS .
<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>
Finalmente, tu .htaccess MODX CMS debería verse así:
<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>
# Prevent rewrite the .well-known directory used by LetsEncrypt by rules below of this rule
RewriteRule "^\.well-known/" - [L]
# Prevent dot directories (hidden directories like .git) to be exposed to the public
# Except for the .well-known directory used by LetsEncrypt a.o
RewriteRule "/\.|^\.(?!well-known/)" - [F]
Ahora puede cargar todas sus páginas traducidas usando la URL, por ejemplo: www.shop.com / fr /
Ahora vamos a cargar el conmutador de idioma.
4. Activa el selector de idiomas
4.1 Cargar el script Linguise JS
El enlace del script Linguise JS debe cargarse en todas sus páginas MODX CMS para mostrar el selector de idioma con banderas y URL alternativas en sus encabezados HTML (para fines de SEO).
Para copiar el enlace del script, desde el panel de control Linguise , vaya a la configuración del dominio y copie el enlace del script.
La forma más fácil de cargar este código en MODX CMS es agregarlo dentro del encabezado de su sitio web o código.
Para lograr esto, abra las MODX /páginas de administración. Luego, vaya a Elementos, seleccione BaseTemplate y desplácese hacia abajo. Verá un código de plantilla (HTML). Edite el código para incluir el enlace del script en el código principal.
El selector de idioma es la ventana emergente que te permite seleccionar el idioma que deseas. Para cargarlo, copia el código proporcionado al final de la configuración del sitio web en el encabezado de tu página HTML. El selector de idioma se cargará automáticamente.
El conmutador de idioma se mostrará de forma predeterminada en una posición flotante superior derecha en su sitio web. Puede personalizarlo como se explica en el próximo capítulo.
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.
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 ventana 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ño de banderas
- Colores y sombra de caja.
Cargar el selector de idioma en el contenido de MODX CMS
Para mostrar el selector de idioma en la ubicación específica del MODX , debes configurarlo como "In situ".
Una vez que lo hayas configurado en el Linguise , puedes agregar el código corto a continuación para incluirlo. Haz clic en el código para guardarlo en el portapapeles.
<div>[linguise]</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 la opción del 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.
Para complementar eso, puede definir la cantidad de caché almacenada en MB. En el siguiente ejemplo, la memoria caché está activada y la cantidad de memoria caché que se debe conservar es de 500 MB.
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
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;