Esta página está dirigida al equipo de desarrollo de CornerStone y a los desarrolladores web que utilizan el maquetador visual CornerStone. Explica el proceso para mantener la compatibilidad de CornerStone con WPML, lo cual se hace actualizando el archivo de configuración de idioma.
En Registrar widgets personalizados de maquetadores visuales para su traducción, explicamos en detalle cómo registrar widgets personalizados de maquetadores visuales para su traducción mediante un archivo de configuración de idioma. Ahora, revisemos la información necesaria para lograr esto con los widgets de Cornerstone.
Encontrar la información de registro del widget
Para poder registrar un widget personalizado de Cornerstone en el archivo wpml-config.xml , primero debe encontrar cierta información básica sobre este.
Puede obtener esta información fácilmente desde el campo personalizado _cornerstone_data o usando un plugin como JSM Show Post Metadata. Este plugin muestra los metadatos de la entrada y sus valores no serializados en una caja de metadatos en la parte inferior de las páginas de edición de entradas.
De forma alternativa, puede seguir estos pasos para obtener esta información:
- Vaya a la página WPML → Configuración, desplácese hasta la sección Traducción de campos personalizados y haga clic en el enlace Mostrar campo del sistema .
- Establezca el campo personalizado _cornerstone_data en Traducir.
- Cree una página nueva y añada solo el widget de CornerStone que desea registrar. Guarde la página.
- Vaya a WPML → Configuración y en la sección Editor de traducción , active temporalmente la opción Editor de traducción clásico.
- Intente traducir la página que creó en el paso 3 usando el Editor de traducción clásico, y notará una matriz serializada, como esta:
- Copie el contenido de la matriz serializada.
- Use su herramienta de deserialización preferida para ver mejor cómo el widget genera su contenido. En nuestro caso, usamos el sitio Unserialize.
A continuación, se explica el contenido de la matriz que verá:
- [_type] contiene el nombre insertado en el atributo name de la etiqueta del widget.
- El valor field será el nombre dentro de los corchetes que contendrá el nombre del campo. Por ejemplo: [testimonial_content] => You are never too old to set another goal or to dream a new dream. En este caso, “title” es el texto que necesita.
Una vez que tenga esta información, puede proceder a registrar el widget para su traducción.
Por ejemplo, el widget Testimonial que viene con Cornerstone incluye una estructura similar a esta en su campo personalizado _cornerstone_data. Con esta información, el widget debe registrarse de la siguiente manera para que WPML pueda detectarlo y traducirlo:
<wpml-config> <cornerstone-widgets> <widget name="testimonial"> <fields> <field type="Testimonial: Content">testimonial_content</field> </fields> </widget> </cornerstone-widgets> </wpml-config>
Esto, por supuesto, no es necesario, ya que el widget Testimonial ya está registrado de forma predeterminada por WPML en nuestro repositorio. Pero sirve como ejemplo para sus widgets personalizados.
Probar el archivo de configuración de idioma
Una vez que haya creado su archivo de configuración, siga estos pasos para comprobar si todo está registrado como se esperaba:
- Configure una instalación que tenga activados tanto CornerStone como WPML. Active los complementos Traducción de cadenas y Traducción de medios.
- Tendrá que anular el archivo de configuración de idioma remoto de WPML con el actualizado. Para ello, vaya a la página WPML → Configuración y haga clic en la pestaña Configuración XML personalizada. Copie el contenido de su archivo de configuración de idioma actualizado en el editor y haga clic en Guardar.
- Cree una página nueva y añada los módulos nuevos. En caso de que haya actualizado algunos atributos de los módulos existentes, añádalos también a la página. En este ejemplo, supondremos que el módulo Testimonial se acaba de añadir al maquetador visual CornerStone. Añádalo a la página y haga clic en Publicar.
- Haga clic en el icono más para traducir la página. Esto le llevará a la pantalla Editor de traducción.
- Asegúrese de que los elementos textuales del módulo se muestren en la pantalla Editor de traducción avanzado.
- Introduzca el texto traducido y haga clic en el botón Completar traducción.
- Compruebe la página traducida en el front-end.
La página traducida muestra todas las cadenas traducidas, lo que implica que el archivo de configuración de idioma actualizado funciona correctamente. En caso de que tenga algún problema, póngase en contacto con nuestro equipo de desarrollo de compatibilidad. Estarán encantados de revisar los problemas relacionados con el archivo de configuración de idioma.
Una vez que haya terminado con las pruebas, envíe una solicitud de fusión a nuestro repositorio. Nuestros desarrolladores de compatibilidad recibirán sus solicitudes y las revisarán.