WebBlocks Forms

Versión del paquete documentado: 0.7.0. WebBlocks CMS ^1.57.0; PHP >=8.3.

Cree sus propios formularios con los campos que necesita y recopile los envíos usted mismo sitio.

WebBlocks CMS envía un bloque contact_form nativo con un conjunto de campos fijo: nombre, correo electrónico, Asunto, mensaje. Funciona bien y este complemento no lo reemplaza. Lo que añade es el Lo que ese bloque no puede hacer: un formulario cuyos campos decide el propietario del sitio.

Construya el artefacto y luego cárguelo a través de System → Plugins en el CMS como superadministrador:

Los complementos instalados están deshabilitados de forma predeterminada. Habilítelo, luego ejecute la acción de configuración del complemento desde la pantalla de detalles del complemento para crear las tablas. Hasta que se ejecute la instalación, las pantallas del complemento dicen Plugin migrations pending en lugar de fallar.

1. Forms → Agregar formulario. Dale un nombre y un identificador. El mango es lo que almacena un bloque. apunte a este formulario, por lo que al cambiarlo más tarde se separan todas las páginas que ya lo colocaron.
2. Colocarlo. Agrega el bloque Form a una página y elige el formulario. ese es el bloque única configuración: los campos, la copia y la entrega se encuentran todos en el formulario, por lo que el mismo formulario puede ubicarse en cinco páginas y el cambio de copia ocurre una vez.
3. Submissions. Todo lo que envían los visitantes llega a Formularios → Envíos, filtrable por formulario y estado, exportable como CSV por formulario.
4. Notification. Cada formulario le envía un correo electrónico cuando llega un envío. dejar el destinatario vacío y vuelve al valor predeterminado de este sitio en Configuración de formulario, luego el sitio Contacte al destinatario y luego al entorno: un cuadro vacío es un entorno de trabajo, no un falta uno.

Más allá de eso, por campo: proporcione a los campos el mismo número step para preguntarlos en una página, o numérelos 1, 2, 3 para preguntar una página a la vez. Establezca cuándo mostrar este campo para revelarlo solo cuando otra respuesta en el mismo paso coincide. Agregue un campo carga de archivos para archivos adjuntos. y por formulario: una respuesta al remitente, webhooks salientes y una suscripción al boletín a través WebBlocks Campaigns.

Si la notificación informa Not configured, la instalación no tiene un correo saliente real: log, Los anuncios publicitarios array y null se informan honestamente y no como enviados. Los envíos se almacenan De cualquier manera, el almacenamiento y la entrega son preocupaciones separadas, y un correo mal configurado nunca te cuesta el mensaje.

A se puede mostrar solo cuando coincide otra respuesta en el mismo paso. El navegador se oculta y se muestra a medida que el visitante escribe, pero eso es conveniente: el servidor decide . Un campo cuyo la condición no se cumplió no se valida ni se almacena.

Ambas mitades importan. Validar uno le diría al visitante que complete una casilla que no está en la página. Almacenar uno registraría una respuesta que nadie dio: una solicitud diseñada puede tener un valor de cualquier entrada, y la bandeja de entrada se leerá como si se hubiera proporcionado.

Con JavaScript desactivado no se oculta nada: se muestran todos los campos y las mismas reglas del servidor siguen determinando qué respuestas cuentan. La experiencia limitada muestra más preguntas, pero nunca impide enviar el formulario.

El script lo publica el CMS en /cms/plugins/webblocks-forms/, por lo que este necesidades de liberación ^1.57.0.

Forms → Importar formulario de contacto enumera los bloques de formulario de contacto nativos en el sitio actual páginas. Importar uno crea un formulario aquí con los mismos cuatro campos, las mismas etiquetas para un visitante vio, y el encabezado, la introducción, el mensaje de éxito y el texto de consentimiento del bloque en todos los idiomas que los tenía, además del destinatario de la notificación.

El bloque se deja exactamente como está y sigue funcionando, y los mensajes ya en Contacto Los mensajes se quedan ahí. Cambiar el bloque en la página es tuyo cuando estés listo. nada sobre la importación es reversible al deshacer, pero tampoco nada es destructivo: lo peor El caso es un formulario que usted elimina.

A Algunas cosas que la importación no puede transferir sin cambios, y así lo dice en la pantalla cuando Aplicar:

• Un bloque sin destinatario se importa sin ninguno, por lo que el formulario sigue heredando el respaldo en lugar de que congelar la respuesta de hoy en un entorno explícito.
• La notificación desactivó las importaciones como una acción que está presente y deshabilitada.
• El texto del consentimiento que falta en un idioma se completa desde el idioma predeterminado. Solo núcleo mostró su cuadro de consentimiento donde existía la redacción, por lo que los visitantes en ese idioma no estaban siendo preguntado en absoluto: verifique la redacción antes de publicar.
• store submissions apagado se informa, no se obedece. El CMS almacenó cada mensaje. Independientemente, respetarlo sería importar un error.

La retención es por formulario y está desactivada de forma predeterminada, porque eliminar silenciosamente los datos de un sitio es peor que conservarlo. Cuando se configura una ventana, el programador del host ejecuta:

Agregue --dry-run para ver qué sucedería sin eliminar nada.

A Una instalación utilizando este complemento y el formulario de contacto nativo tiene dos lugares para leer mensajes: /webadmin/contact-messages para el bloque nativo, y Formularios → Envíos aquí. Ese es un costo deliberado. La alternativa es un complemento que escribe en una tabla principal que no propio, que el límite del complemento prohíbe y que no encajaría de todos modos, ya que contact_messages tiene columnas para un mensaje fijo de cuatro campos y ningún lugar para colocar un esquema instantánea, un archivo o un estado de entrega por acción.

Los archivos adjuntos enviados no van a la biblioteca multimedia de CMS. La biblioteca almacena todo en el disco público sin forma de solicitar nada más, y su verificación de uso no puede ver un referencia del complemento, por lo que un archivo adjunto a un envío se informa como no utilizado y un editor lo elimina de la pantalla Multimedia sin previo aviso. Ambos son correctos para los activos del sitio y incorrecto para el documento de un visitante, por lo que las cargas utilizan el propio disco privado del complemento, configurado en config/webblocks-forms.php. Descarga de archivos adjuntos a través de un enlace firmado de corta duración, siempre como un archivo adjunto y nunca en línea: una carga SVG o HTML renderizada en línea ejecutaría su script en el origen del administrador.