Tabla de contenido
Requisitos técnicos ProcessWire CMS
La traducción automática neuronal que se utilizará con ProcessWire CMS requiere el script PHP (descargable a continuación). Para instalar el script Linguise , se requieren los siguientes requisitos:
- Ejecutar PHP 7+
- Servidor Apache, LiteSpeed, NGINX e IIS
- Asegúrese de que la reescritura de URL esté activada en su servidor
- ProcessWire CMS 2.x o 3 y superior
1. Generar la clave API
Después de conectarse o registrarse 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 “Otra PHP” para continuar con el registro del dominio Linguise , como esta documentación y los idiomas de origen y destino.
Después de eso obtendrás:
- La clave API que valida tu membresía
- El enlace al script Linguise para el selector de idiomas
La clave API es necesaria para activar la traducción en su sitio web ProcessWire CMS. Básicamente, la clave API comprobará el idioma activado en su dominio y permitirá la traducción automática del contenido.
Por ahora, puedes copiar la clave API y guardarla en tu 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 ProcessWire CMS:
Después de descargar el script, descomprímalo y cárguelo en la carpeta raíz donde está instalado el CMS ProcessWire .
- Asegúrese de que esté en el nivel raíz de su sitio web (donde se encuentran los archivos ProcessWire
- 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 panel de control visitando su sitio web con el siguiente formato de URL
linguise https://www.domain.com/linguise
Cambie la dirección de dominio según la dirección de su sitio web*
Asegúrese de que Linguise tenga los permisos de lectura y escritura adecuados*
Configurar contraseña y conexión a la base de datos
Una vez que acceda a la interfaz del script, se le presentará una pantalla de configuración donde podrá crear una contraseña y conectarse a su base de datos preferida.
Puede:
- Establezca una contraseña que será necesaria para acceder en el futuro a esta interfaz.
- Elija su tipo de base de datos: MySQL o SQLite, según su configuración y preferencia.
Esta configuración inicial garantiza un acceso seguro y le permite configurar el script según su entorno.
Conexión a la base de datos MySQL
Si elige MySQL, aparecerá una interfaz diferente que le solicitará 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 a su base de datos MySQL.
MySQL vs. SQLite: ¿Cuál es la diferencia?
Tanto MySQL como SQLite son sistemas de bases de datos populares que se utilizan para almacenar y gestionar datos de sitios web y aplicaciones. Sin embargo, están diseñados para diferentes casos de uso y presentan algunas diferencias clave:
| Característica | SQLite | MySQL |
|---|---|---|
| Configuración | Muy fácil (requiere instalación de SQLite) | Requiere configuración del servidor |
| Almacenamiento | Fila india | Administrado por el servidor MySQL |
| 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 panel de traducción de Linguise , anteriormente disponible solo para Joomla y WordPress, ahora es compatible con PHP y otras plataformas. Esta actualización permite a los usuarios configurar fácilmente los ajustes de idioma (como las opciones de visualización, los estilos de banderas y la personalización de la apariencia) directamente desde una interfaz unificada, independientemente de su CMS o framework.
Los administradores pueden gestionar la configuración Linguise de forma más eficiente, con funciones consistentes como ventanas emergentes de selección de idioma, efectos de sombra y variantes de banderas específicas para cada región. El panel de control conserva su diseño intuitivo y ofrece una mayor compatibilidad con diversos entornos web.
3. Configurar la reescritura de URL ProcessWire CMS
De forma predeterminada, la reescritura de URL está activa en ProcessWire 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 ProcessWire 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, su CMS .htaccess ProcessWire debería verse así:
# 8. Enable Apache mod_rewrite (required)
# -----------------------------------------------------------------------------------------------
<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]
# 8A. Optionally (O) set a rewrite base if rewrites are not working properly on your server.
# -----------------------------------------------------------------------------------------------
Ahora puedes cargar todas tus páginas traducidas usando la URL, por ejemplo: www.shop.com /fr/
Ahora carguemos el selector de idioma.
4. Activar el selector de idioma
4.1 Cargar el script JS Linguise
El enlace del script Linguise JS debe cargarse en todas las páginas de ProcessWire CMS para mostrar el selector de idioma con indicadores y URL alternativas en los encabezados HTML (para fines de SEO).
Para copiar el enlace del script, desde el panel de 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 ProcessWire CMS es agregarlo dentro del encabezado de su sitio web o Sección. ProcessWire CMS viene con un archivo específico para cargar un script en el encabezado.
Se encuentra en _main.php. Puedes encontrarlo en site/templates/_main.php . Edita el archivo de script para incluir el enlace en el encabezado.
El selector de idioma con banderas ahora debería cargarse automáticamente.
El selector de idiomas se mostrará por defecto en una posición flotante en la esquina superior derecha de su sitio web. Puede personalizarlo como se explica en el siguiente capítulo.
Nota importante sobre SEO: La cantidad de idiomas que configures tiene un gran impacto en el SEO. Al configurar los idiomas de traducción, si tienes una gran cantidad de páginas indexadas (más de 500), los motores de búsqueda pueden tardar bastante en procesarlas. Esto puede afectar tu SEO en tu idioma original. Por eso, recomendamos agregar inicialmente un máximo de 5 idiomas y, una vez indexada, añadir 3 idiomas al mes.
Configurar el selector de idioma
El selector de idiomas se puede personalizar desde el panel 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 ventana emergente
- La posición del selector de idioma
- El contenido del selector de idioma
- Nombres de idiomas en inglés o lengua materna
- Formas y tamaño de banderas
- Colores y sombras de caja
Cargar el selector de idioma en el contenido ProcessWire
Para mostrar el selector de idioma en la ubicación específica del ProcessWire , 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.
<div>[linguise]</div>
Una vez agregado, en el frontend tendrás los nombres de las banderas y los idiomas mostrados en el área HTML donde has agregado 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 para agilizar el servicio de las páginas. La caché local ahorrará parte de la transferencia de datos entre el servidor Linguise y el servidor de su sitio web. La caché solo se utiliza cuando una página ya se ha traducido y no se ha actualizado. La caché prioritaria será la de las páginas multilingües más visitadas.
Para complementar esto, puede definir la cantidad de caché almacenada en MB. En el siguiente ejemplo, la caché está activada y la cantidad de caché a mantener es de 500 MB.
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Traducción automática en servidores IIS de Windows
Añade la línea correspondiente a tu creador de sitios web en tu archivo Web.config.
Debe configurarse antes de cualquier otra redirección, especialmente la redirección a tu archivo principal de 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>
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;