Formulario de creación
Creación automática de archivos en tu sitio web, ya sean diplomas, certificados u otros documentos. A los visitantes de tu sitio web solo les bastará con completar un formulario para recibir el archivo.
Para crear archivos, es necesario añadir un formulario HTML en tu sitio web. Si eso no es posible, simplemente utiliza el widget de creación.
Creación del formulario
Para enviar solicitudes de creación de archivos a DiMaker, será necesario configurar un formulario en tu sitio web. Puede ubicarse en la parte pública o privada de tu página. Usa tu CMS para crear una página y añadir un formulario en ella.
Action del formulario
https://dimaker.app/api/v1/webform-create/
Campos del formulario
Es necesario crear algunos campos ocultos con los siguientes valores:
-
secure*
Token (cadena de texto, 36 caracteres)
-
doc_id*
ID del documento (cadena de texto, 36 caracteres) que se usará para generar el archivo. El ID se puede obtener en la barra de direcciones cuando el documento esté abierto. El documento no debe estar en la Papelera, pero puede estar almacenado en cualquier carpeta de Documentos.
-
mail_id
ID de la plantilla de correo (cadena de texto, 36 caracteres) que se utilizará para enviar por correo electrónico. El ID se puede obtener en la barra de direcciones al abrir la plantilla. Si esta variable no está presente, no se realizará el envío del correo.
-
email_send
Momento en que se enviará el correo con el archivo. Puede tomar los siguientes valores:
onfinish: Enviar todos los correos al finalizar la creación de los archivos (predeterminado).
oncreate: Enviar los correos inmediatamente después de la creación del archivo. Si solo se crea un archivo, onfinish y oncreate son idénticos.
timeout: Enviar correos después de un intervalo de tiempo. En este caso, también es necesario proporcionar dos parámetros adicionales:
email_timeout_value: Valor numérico del intervalo tras el cual se enviarán los correos. Debe ser un número entero.
email_timeout_unit: Unidad de tiempo del intervalo. Puede tomar valores como "m" (minutos), "h" (horas) o "d" (días).
Alternativamente, para especificar una hora exacta de envío, se puede proporcionar la hora en formato Unix time en email_timeout_timestamp. Si se proporcionan tanto timeout como email_timeout_timestamp, se prioriza el último. -
folder_id
ID de la carpeta en el Disco (cadena de texto, 36 caracteres) donde se guardarán los archivos. Si la carpeta no existe, se creará automáticamente al generar el primer archivo.
-
page_id
Número de página (número o cadena de texto) si el documento tiene varias páginas. Se puede proporcionar un solo número (la primera página es 0) o una lista de números separados por comas para indicar las páginas que se usarán para la creación del archivo.
Enviarse el archivo a sí mismo tras su creación
El archivo se enviará por correo electrónico a la cuenta inmediatamente después de ser creado. En el campo «Plantilla de correo» puedes seleccionar qué plantilla usar para el envío. Previamente, en la sección Plantillas de correos, puedes crear una plantilla específica para enviar correos electrónicos a la cuenta. Si incluyes la variable %data en el texto del correo, en su lugar se añadirán todos los datos del archivo en formato tabla.
Script y estilos
En la página de integración puedes obtener el código necesario e insertarlo en el HEAD o en cualquier otra sección de la página. No es necesario incluir este código en todas las páginas del sitio, únicamente en la página con el formulario.
Además, es necesario crear dos bloques con los id result-success y result-danger. Ambos bloques deben estar ocultos, con estilo display:none. En el primer bloque puedes escribir un mensaje indicando que el archivo se creó exitosamente. Este bloque se mostrará al completarse la solicitud con éxito. Si ocurre un error, se mostrará automáticamente en el bloque con id result-danger.
Sustitución en el documento
En el documento debe haber al menos una variable para realizar la sustitución, como %name o %course. Añade un campo en el formulario donde el nombre de la variable comience con mask_, por ejemplo mask_name o mask_course. Los datos ingresados por los visitantes en esos campos se sustituirán por las variables correspondientes en el texto del documento. Para especificar una dirección de correo electrónico, utiliza la variable mask_email. Si deseas enviar correos a varias direcciones, sepáralas por comas o espacios. En este caso, el estado de envío en el Disco se mostrará para la primera dirección.
Funcionamiento del formulario
Después de haber creado el formulario, puedes abrir la página publicada y verificar su funcionamiento. Se generará un archivo y se mostrará en una ventana emergente para su descarga.
Un documento = un único envío
Opcionalmente, puedes limitar la cantidad de envíos del formulario. Si ya se creó un archivo con el doc_id indicado para el correo electrónico proporcionado, se mostrará una advertencia indicando que solo se puede crear un archivo.
Mis documentos
Puedes mostrar los documentos de un usuario en una sección privada de tu sitio web. Para esto, crea un formulario como se indica anteriormente. Luego, añade campos ocultos como email, secure y doc_id. Introduce la dirección de correo electrónico del visitante en el primer campo y asigna el valor all al último. Al abrir esta página, el visitante verá una lista de todos sus documentos con la opción de descargarlos. Si deseas que, cuando el visitante ya haya llenado el formulario, se muestre su archivo en lugar del formulario, el campo email del formulario debe ser oculto y rellenado automáticamente por tu CMS.