Tabla de contenido
Requisitos técnicos del CMS TYPO3
La traducción automática neuronal que se utilizará con TYPO3 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
- TYPO3 CMS 9 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 lo que se requiere para activar la traducción en su sitio web TYPO3 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 TYPO3 CMS:
Una vez descargado el script, descomprímalo y cárguelo en la carpeta raíz donde está instalado TYPO3 CMS.
- Asegúrese de que esté en el nivel raíz de su sitio web (donde se encuentran sus archivos TYPO3
- 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 TYPO3 CMS
De forma predeterminada, la reescritura de URL está activa en TYPO3 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 " disponible en el .htaccess predeterminado TYPO3 CMS .
# Set PHP version to 7.4 >> Please Add this code before the Rewrite rules to ensure Linguise works in PHP v7.4
AddHandler application/x-httpd-php74 .php
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 archivo .htaccess de TYPO3 CMS debería verse así:
# Set PHP version to 7.4
AddHandler application/x-httpd-php74 .php
# Enable URL rewriting
RewriteEngine On
RewriteBase /typo10/ # Set the RewriteBase to the subfolder
# Add a condition to check if the request starts with the subfolder
RewriteCond %{REQUEST_URI} !^/typo10/
# Rewrite requests that don't start with the subfolder to include it
RewriteRule ^(.*)$ /typo10/$1 [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-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)(?:$|/)(.*)$ /typo10/linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA]
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 TYPO3 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 TYPO3 CMS es agregarlo dentro del encabezado de su sitio web o código. TYPO3 CMS viene con un entorno especial y tiene que crear un archivo específico para agregar un script al encabezado.
Puede lograr esto siguiendo estos pasos a continuación:
- Inicie sesión en Typo3 Admin,
- Seleccione " Página " > " +Contenido " > haga clic en la pestaña Elementos especiales > HTML simple
Edite el archivo de secuencia de comandos para incluir el enlace de la secuencia de comandos en la sección de código HTML como se muestra a continuación.
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 idiomas en TYPO3 CMS
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 de TYPO3 CMS
Para mostrar el selector de idioma en un lugar específico, en el TYPO3 , debe configurar 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 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;
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:
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 = '';