Tabla de contenido
Requerimientos técnicos
Para ejecutar el script de traducción Linguise , necesitará lo siguiente:
- Ejecute PHP 7+ y Laravel
- Apache, LiteSpeed, NGINX, servidor IIS
- Activa la reescritura de URL en la configuración de tu servidor
- La carpeta raíz de Laravel pública ", asegúrese de instalar Linguise dentro de esta carpeta.
1. Generar la clave API
La clave API es lo que se requiere para activar la traducción en su sitio web. 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.
Luego, al hacer clic en la pestaña "Script PHP", obtendrá las instrucciones de instalación que seguiremos aquí en detalle.
2. Cargue y conecte el script de traducción Linguise
El script de traducción Linguise debe cargarse en su servidor, en la carpeta donde está instalado Laravel , se puede descargar aquí:
Una vez descargado el script, descomprímalo y cárguelo en la carpeta raíz donde está instalado Laravel .
- Asegúrese de que esté en el nivel raíz de su instalación Laravel Laravel establece la raíz en la carpeta " pública " donde puede instalar Linguise allí)
- Asegúrese de que la carpeta se llame " linguise " (el nombre predeterminado cuando se descomprime la carpeta)
La Linguise deberá copiarse en la carpeta: …/ linguise /Configuration.php archivo 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 las URL del idioma
La URL por idioma debe configurarse en el archivo .htaccess, si tiene un "RewriteBase /" en su archivo, simplemente copie después de eso todo el siguiente código:
RewriteEngine On
RewriteRule ^linguise/linguise.php$ - [L]
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]
4. Activa el selector de idiomas en Laravel .
El selector de idioma es la bandera emergente para seleccionar el idioma que desea. Para cargarlo, deberá copiar el código proporcionado al final de la configuración del sitio web (panel de Linguise ).
El script debe cargarse en el encabezado de las páginas HTML manejadas por Laravel . El selector de idioma de bandera se cargará automáticamente.
El selector de idiomas se mostrará de forma predeterminada en una posición flotante superior derecha en su sitio web. Puede personalizarlo como desee con CSS.
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 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 Laravel
Para mostrar el selector de idioma en un lugar específico, en el Laravel , debes 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.
Sistema de caché local para páginas Laravel
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.
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
Configuraciones específicas para la plataforma Laravel
En el archivo Configuration.php también tenemos una configuración que permite pasar alguna configuración específica para el CMS o no. De forma predeterminada, es automático, pero el equipo de soporte puede pedirle que lo personalice para usar algunas configuraciones especiales.
Aquí está el código para agregar para Laravel , este es el nombre del CMS en minúsculas:
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'laravel';
De SQLite a MySQL
Aún en Configuration.php hay una configuración para forzar el uso de MySQL en lugar de SQLite, en caso de que SQLite no esté instalado en el servidor.
En este caso, deberás completar la información de MySQL en esta parte del archivo Configuration.php:
/** Advanced database configuration **/
/*
* In case you don't want to use Sqlite, you can use MySQL
* To do so, you need to fill the following variables
* Linguise will create the tables for you
*/
public static $db_host = '';
public static $db_user = '';
public static $db_password = '';
public static $db_name = '';
public static $db_prefix = '';
Traducción automática en servidores Laravel + 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 Laravel + 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;