Tabla de contenido
Requisitos técnicos de PyroCMS
La traducción automática neuronal que se usará con PyroCMS requerirá utilizar el script PHP (puede descargarse a continuación). Para instalar el script de Linguise, you’ll necesitará los siguientes requisitos:
- Ejecutar PHP 7+
- Servidores Apache, LiteSpeed, NGINX e IIS
- Asegúrese de que la reescritura de URL esté activada en su servidor
- PyroCMS 3 y superiores
1. Generar la clave API
Después de su conexión o registro a su Linguise dashboard, you’ll necesitará configurar un nuevo dominio primero y guardar sus configuraciones para obtener la clave API.
Puede seleccionar la plataforma "Otra PHP" para continuar con el registro del dominio de 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
- Enlace al script de Linguise para el selector de idioma
La clave API es lo que se requiere para activar la traducción en su sitio web PyroCMS. Básicamente, la clave API verificará qué idioma está activado en su dominio y permite la traducción automática del contenido.
Por ahora, puedes copiar la clave API y guardarla en el portapapeles.
2. Carga y conecta el script de traducción de Linguise
El script de traducción Linguise necesita ser subido a su servidor donde está instalado PyroCMS:
Después de descargar el script, descomprímalo y súbalo a la carpeta raíz donde está instalado PyroCMS.
- Asegúrate de que esté en el nivel raíz de su sitio web (donde se encuentran los archivos de PyroCMS, por defecto está ubicado en la carpeta /public)
- Asegúrate de que la carpeta mantenga su nombre predeterminado “linguise”
¿Cómo acceder a la interfaz de scripts de Linguise?
Una vez completada la instalación de Linguise, podrá acceder al panel de control visitando su sitio web con el siguiente formato de URL:
https://www.dominio.com/linguise
Modifique la dirección del 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, verá 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 a esta interfaz en el futuro.
- Elige el tipo de base de datos: MySQL o SQLite, según tu configuración y preferencias.
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 que se muestran 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 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 (se requiere instalación de SQLite) | Requiere configuración del servidor |
| Almacenamiento | Fila india | Gestionado por el servidor MySQL |
| Actuación | Ideal para aplicaciones de pequeña escala | Más adecuado 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 de Linguise de forma más eficiente, con funciones consistentes como ventanas emergentes de selección de idioma, efectos de sombra y variantes de opciones de banderas específicas para cada región. El panel de control conserva su diseño intuitivo a la vez que ofrece una mayor compatibilidad con diversos entornos web.
3. Configurar la reescritura de URLs de PyroCMS
Por defecto, la reescritura de URL está activa en PyroCMS. Si ese no es el caso, puedes activarla desde tu proveedor de hosting.
La URL por idioma necesita ser configurada en el .htaccess. Simplemente copia el código a continuación después del código “RewriteEngine on” disponible en el predeterminado PyroCMS .htaccess.
<IfModule mod_rewrite.c>RewriteEngine en 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|f i|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|s d|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 de PyroCMS debería verse algo así:
<IfModule mod_rewrite.c> <IfModule mod_negotiation.c> Options -MultiViews </IfModule> 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] RewriteBase / # Redirect trailing slashes RewriteRule ^(.*)/$ /$1 [L,R=301]
Ahora puede cargar todas sus páginas traducidas utilizando la URL, por ejemplo:www.shop.com/fr/
Ahora carguemos el selector de idioma.
4. Activa el selector de idioma
4.1 Cargar el script JS de Linguise
El enlace del script JS de Linguise debe cargarse en todas sus páginas de PyroCMS para mostrar el selector de idioma con banderas y URLs alternas en los encabezados HTML (con fines de SEO).
Para copiar el enlace del script, desde el panel de control 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 PyroCMS es añadirlo dentro del encabezado de tu sitio web o <head> código. PyroCMS viene con un entorno especial y tiene un archivo específico para añadir un script al encabezado.
Se encuentra en scripts.twig que puedes encontrar navegando en la carpeta de instalación de tu CMS aquí:
vendor/pyrocms/*YOUR_THEME*/resources/views/partials/scripts.twig. Por defecto, el tema de PyroCMS es starter-theme.
Edita el archivo de script para incluir el enlace del script en la sección del encabezado como se muestra a continuación.
El selector de idioma 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 de SEO: El número de idiomas que configuras tiene un gran impacto en SEO. Cuando configuras tus idiomas de traducción, si tienes una gran cantidad de páginas indexadas (>500), el motor de búsqueda puede tardar mucho tiempo en procesarlas. Puede afectar tu SEO en tu idioma original. Eso’s por lo que recomendamos añadir primero un máximo de 5 idiomas, luego, cuando está’s indexado, puedes añadir idiomas en lotes de 3 por mes.
Configura el selector de idioma en PyroCMS
El selector de idioma se puede personalizar desde el panel de control de Linguise > Ajustes > Visualización de indicadores de idioma. Todos los cambios realizados aquí se reflejarán en el sitio web.
En el lado derecho de la pantalla se muestra 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 en el idioma nativo
- Formas y tamaños de las banderas
- Colores y sombra de caja
Carga el selector de idioma en el contenido de PyroCMS
Para mostrar el selector de idioma en el lugar específico, en el contenido de PyroCMS, debe establecer la posición como “En el sitio”.
Una vez que haya establecido la posición en el panel de control de Linguise, puede agregar el shortcode a continuación para incluirlo. Haga clic en el código a continuación para copiarlo al portapapeles.
<div>[lingüístico]</div>
Una vez añadido, en la interfaz de usuario se mostrarán los nombres de las banderas y los idiomas en el área HTML donde hayas añadido 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 asociado para que las páginas se carguen más rápido. La caché local reduce la transferencia de datos entre el servidor de Linguise y el servidor de su sitio web. La caché se utiliza únicamente cuando una página ya ha sido traducida y no se ha actualizado. La caché que se mantendrá con mayor prioridad 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 conservar es de 500 MB.
/** Configuración básica **/ public $cache_enabled = true; public $cache_max_size = 500; // En megabytes
Traducción automática en servidores NGINX
volver a escribir ^/(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 último;