Tabla de contenido
Requisitos técnicos Craft CMS
La traducción automática neuronal que se utilizará con Craft CMS requerirá el uso del script PHP (se puede descargar 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
- Craft CMS 3 o 4 y superior
- Normalmente, la carpeta raíz de Craft CMS /web ".
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.
Simplemente seleccione la plataforma Craft CMS para obtener el enlace adecuado a 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 lo que se requiere para activar la traducción en su sitio web Craft CMS . Básicamente, la clave API comprobará qué idioma está activado en su dominio y permitirá 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 su servidor donde está instalado Craft CMS :
Una vez descargado el script, descomprímalo y cárguelo en la carpeta raíz donde está instalado Craft CMS .
- Asegúrese de que esté en el nivel raíz de su sitio web (donde se encuentran sus Craft CMS , de forma predeterminada está dentro de /web )
- Asegúrese de que la carpeta mantenga su nombre predeterminado " linguise "
La Linguise deberá copiarse en el Configuration.php que cargó en su servidor, edite el archivo y copie su clave API entre comillas simples, reemplace el texto REPLACE_BY_TOUR TOKEN.
3. Configure la reescritura de URL Craft CMS
De forma predeterminada, la reescritura de URL está activa en Craft CMS . Si ese no es el caso, puedes activarlo desde tu proveedor de hosting.
La URL por idioma debe configurarse en el .htaccess. Simplemente copie el código a continuación después del código " RewriteEngine on " Craft CMS predeterminado .htaccess.
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]
Finalmente, su Craft CMS .htaccess debería verse así:
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]
# Send would-be 404 requests to Craft
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !^/(favicon\.ico|apple-touch-icon.*\.png)$ [NC]
RewriteRule (.+) index.php?p=$1 [QSA,L]
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 Craft CMS para mostrar el selector de idiomas 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 sencilla de cargar este código en craft CMS es agregarlo al índice de su plantilla. Abra la carpeta /template y edite el archivo de índice para incluir el enlace del script en la sección del encabezado.
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 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.
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 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 Craft CMS
Para mostrar el selector de idioma en un lugar específico, en el Craft CMS , 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.
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 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;