Cómo traducir Ninja Forms en WordPress: formularios multipaso, acciones de correo electrónico, acciones de integración

Antes de empezar

Instale y active estos plugins:

• Ninja Forms.
• WPML y WPML Traducción de cadenas.
• Ninja Forms Multilingual (el complemento que cubre esta página).

Construya el formulario en Ninja Forms en el idioma de origen de su sitio, incluyendo cualquier estructura multipaso, lógica condicional, texto de validación y las acciones que necesite (mensaje de éxito, redirección de envío, correo electrónico, acciones de integración). Envíe el formulario a traducir una vez que sea funcionalmente completo.

Traducir todo automáticamente se encarga de esto por usted

Si su sitio tiene activado Traducir todo automáticamente, no necesita enviar el formulario a traducir manualmente. WPML detecta los formularios nuevos y actualizados junto con el resto de su contenido y los traduce en segundo plano. El paso de inserción en la página que se describe a continuación sigue siendo aplicable, pero el paso de enviar el formulario a traducir es automático. El resto de esta página describe la ruta manual para los sitios que usan Traducir una parte: usted elige qué traducir (o para los formularios que quiera traducir antes de la cola automática).

Enviar el formulario a traducir

1. Abra WPML > Traducciones > Escritorio.
2. Expanda la sección Ninja Forms.
3. Marque el formulario que quiera traducir.
4. Elija un método de traducción: PTC (recomendado), su traductor o Traducir yo mismo.
5. Haga clic en Traducir.

Los campos, las opciones, las acciones (mensaje de éxito, correo electrónico, redirección de envío, integraciones) y los mensajes de validación por campo se incluyen en el mismo trabajo de traducción.

Insertar el formulario en sus páginas traducidas

Ninja Forms se ubica dentro de una página o entrada, normalmente a través del bloque de Ninja Forms o del shortcode [ninja_form id="X"]. La regla de inserción multilingüe es:

Use el mismo bloque o shortcode en cada versión de idioma de la página. No cree un formulario distinto por idioma.

El flujo de trabajo es el siguiente:

1. Construya el formulario una vez en su idioma de origen.
2. Envíe el formulario a traducir (o deje que Traducir todo automáticamente lo detecte).
3. Inserte el formulario en la página en el idioma de origen mediante el bloque de Ninja Forms o el shortcode [ninja_form].
4. Traduzca la página a través de WPML > Traducciones > Escritorio de la misma manera que traduciría cualquier otra página. La incrustación del formulario se conserva en la página traducida.
5. Cuando un visitante abre la página traducida, Ninja Forms Multilingual muestra el formulario en el idioma del visitante automáticamente: mismo ID de formulario, mismo shortcode, contenido traducido.

No necesita un ID de formulario distinto por idioma. La traducción está vinculada al formulario de origen; Ninja Forms Multilingual resuelve la versión en el idioma correcto en el momento de la visualización.

La excepción: cuando realmente quiere formularios distintos por idioma. Si necesita formularios estructuralmente diferentes por idioma (diferentes campos, diferentes acciones, diferente lógica), construya formularios de Ninja Forms por separado (uno por idioma) e inserte el shortcode de cada uno en la versión de idioma correspondiente de la página utilizando el editor de WordPress para esa traducción. Esa es la única situación en la que los shortcodes difieren entre idiomas.

Etiquetas y tipos de campo

Cada etiqueta de campo, texto de marcador de posición y opción de Ninja Forms aparece en el trabajo de traducción. Se traduce todo el catálogo de campos: texto, párrafo, nombre, correo electrónico, dirección, teléfono, lista (selección, radio, casilla de verificación, selección múltiple), número, fecha/hora, subida de archivos, enviar.

Los campos repetidores se traducen a nivel de fila: la etiqueta del botón de añadir fila y la etiqueta de cada campo por fila se incluyen en el trabajo de traducción. Los traductores ven la estructura del repetidor intacta, con la etiqueta de cada subcampo como una fila traducible.

Campos de selección de imagen

Los campos de selección de imagen emparejan una miniatura con una etiqueta de texto. Ninja Forms Multilingual traduce la etiqueta para cada idioma mientras que la imagen sigue siendo compartida. Los selectores basados en imágenes funcionan de forma idéntica en todos los idiomas; solo se traducen las leyendas.

Formularios multipaso

Para los formularios multipaso, cada encabezado de paso y los botones de navegación por paso (Anterior, Siguiente, Enviar) se traducen como sus propias filas. La lógica condicional por paso sobrevive a la traducción. El mapa de valores mantiene los valores de elección subyacentes alineados en todos los idiomas.

Después de la traducción, recorra el flujo multipaso en cada idioma para confirmar que la navegación se lee con naturalidad y que las bifurcaciones condicionales se siguen activando en los pasos correctos.

Diseño y estilos

Los resultados del diseñador de diseño y estilos (Layout & Styles) de Ninja se traducen sin perder la estructura. La cuadrícula, las columnas y el estilo visual se mantienen; solo cambia el contenido de las cadenas por idioma. No hay pasos especiales: traduzca el formulario y el diseño se mantendrá.

Guardar progreso

Para los formularios que tienen activado Guardar progreso, se traducen los avisos que ve el visitante:

• La etiqueta del botón Guardar progreso.
• El asunto y el cuerpo del correo electrónico con el enlace de reanudación.
• El mensaje de éxito después de guardar.

Los tres se incluyen en el trabajo de traducción. Después de la traducción, haga una prueba guardando a mitad de un formulario en cada idioma y confirmando que el correo electrónico de reanudación llega en el idioma correcto.

Mensajes de validación por campo

Cada campo lleva su propio texto de validación: error de campo obligatorio, error de formato, mensaje de validación personalizado. Cada uno aparece en el trabajo de traducción. El texto de Anti-Spam y Honeypot se traduce a través de WPML Traducción de cadenas (no en el trabajo de traducción del formulario).

Acción de mensaje de éxito y acción de redirección de envío

El texto de agradecimiento integrado de la acción de mensaje de éxito se traduce para cada idioma. La URL de la acción de redirección de envío también es traducible. Configure una URL de agradecimiento diferente para cada idioma para que los visitantes lleguen a una página en su idioma después del envío.

Acción de correo electrónico

Cada acción de correo electrónico en el formulario se traduce de forma independiente. Para, Nombre del remitente, Asunto y Mensaje de correo electrónico aparecen en el trabajo de traducción. Los formularios con múltiples acciones de correo electrónico (notificación al administrador + confirmación al visitante, por ejemplo) traducen cada acción por separado para que el texto de cada idioma sea independiente.

Acciones de integración

La arquitectura de acciones de Ninja Forms significa que cada integración es un paso del flujo de trabajo por formulario. El texto visible para el visitante de cada acción se traduce:

• Acciones de Webhook. El cuerpo de la petición y cualquier etiqueta visible para el visitante se traducen; los valores de los campos se mantienen canónicos para que los endpoints receptores no fallen.
• Mailchimp / AWeber / Constant Contact / ActiveCampaign / Campaign Monitor / CleverReach / Drip / EmailOctopus / Emma / Kit / MailerLite / MailPoet. Las etiquetas de lista / segmento / etiqueta (tag) se traducen si existen como cadenas a nivel de formulario.
• HubSpot / Salesforce / ZohoCRM. Las etiquetas de embudo (pipeline) / etapa / formulario se traducen.
• Zapier / Slack / Trello. Las cadenas de canal, etiqueta y nombre del formulario del webhook se traducen.

Para las integraciones de pago (Stripe, Authorize.net, Elavon, PayPal), las descripciones de compra y las etiquetas de los botones visibles para el visitante se traducen. Realice una transacción de prueba en cada idioma utilizando el modo de prueba del procesador de pagos y confirme que el texto del recibo llega correctamente.

Una limitación conocida: envío de formularios en PDF

El complemento Ninja Forms PDF Form Submission no genera archivos PDF cuando Ninja Forms Multilingual está activo en formularios con traducciones configuradas. Esto está registrado en un hilo del foro. Solución alternativa: desactive el complemento de PDF para los formularios traducidos hasta que se resuelva la compatibilidad.

Errores comunes

• El cuerpo de la acción de correo electrónico tiene un entorno de etiquetas combinadas sin traducir. Limitación conocida (ver arriba). Reestructure el cuerpo del correo electrónico para poner el texto traducido fuera de las inserciones de etiquetas combinadas, o acepte la limitación.
• Los correos electrónicos de notificación al administrador llegan en el idioma de origen. Confirme que la acción de correo electrónico que está probando se ha vuelto a enviar a traducir después de su última edición. Si sigue fallando, consulte el hilo recurrente del foro para ver el estado.
• La lógica condicional deja de activarse en los formularios traducidos. Se editó una etiqueta de elección en el idioma de origen después de la traducción. Vuelva a enviar el formulario a traducir para actualizar el mapa de valores.
• El envío de formularios en PDF deja de funcionar. Desactive el complemento o elimine la traducción hasta que se resuelva la compatibilidad.