Formulario de creación
Creación automática de archivos en tu sitio web - diplomas, certificados o cualquier otra cosa. El visitante de tu sitio solo necesita completar el formulario y recibir el archivo.
Para la creación de archivos, es necesario crear un formulario HTML en tu sitio web. Si esto no es posible, simplemente utiliza el widget de creación.
Creación del formulario
Para enviar solicitudes de creación de archivos a DiMaker, necesitas crear un formulario en tu sitio web. Este formulario puede estar ubicado en la parte pública o en la parte privada de tu sitio web. Con la ayuda de tu CMS, crea una página y coloca el formulario en ella.
Action del formulario
https://dimaker.app/api/v1/webform-create/Campos del formulario
Es necesario crear varios campos ocultos con los siguientes valores:
-
secure*
Token (cadena, 36 caracteres)
-
doc_id*
ID del documento (cadena, 36 caracteres) que se utilizará para la creación del 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 en cualquier carpeta de Documentos.
-
mail_id
ID de la plantilla de correo electrónico (cadena, 36 caracteres) para el envío del correo electrónico. El ID se puede obtener en la barra de direcciones cuando la plantilla esté abierta. Si la variable no se pasa, el correo no se enviará.
-
email_send
El momento en que se enviará el correo con el archivo. Puede tomar los siguientes valores:
onfinish - Enviar todos los correos después de la creación de todos los archivos (por defecto)
oncreate - Enviar correos inmediatamente después de la creación del archivo. Al crear un solo archivo, onfinish y oncreate son idénticos.
timeout - Enviar correos después de un período de tiempo. En este caso, es necesario pasar dos parámetros más:
email_timeout_value - valor numérico del intervalo de tiempo tras el cual enviar los correos, valor entero
email_timeout_unit - unidad de medida del intervalo. Puede tomar los valores "m" (minutos), "h" (horas), "d" (días).
Alternativamente, para especificar el tiempo exacto de envío, se debe pasar el tiempo en formato unix time en email_timeout_timestamp. Si se pasan timeout y email_timeout_timestamp, se dará prioridad al último. -
storage_period
El tiempo de almacenamiento de los archivos en el Disco. Si no se especifica el parámetro, los archivos se almacenan indefinidamente hasta su eliminación manual. Para eliminar después de un período de tiempo, se debe tomar el valor:
timeout. En este caso, es necesario pasar dos parámetros más:
storage_period_timeout_value - valor numérico del intervalo tras el cual eliminar archivos, valor entero
storage_period_timeout_unit - unidad de medida del intervalo. Puede tomar los valores "m" (minutos), "h" (horas), "d" (días).
Alternativamente, para especificar el tiempo exacto de eliminación, se debe pasar el tiempo en formato unix time en storage_period_timeout_timestamp. Si se pasan storage_period_timeout_value y email_timeout_timestamp, se dará prioridad al último. -
folder_id
ID de la carpeta en el Disco (cadena, 36 caracteres) para guardar los archivos. Si la carpeta no existe, se creará automáticamente al crear el primer archivo.
-
page_id
Número de página (número o cadena), si el documento tiene varias páginas. Se puede pasar un solo número (primera página - 0), o varios números (separados por coma) de las páginas que se deben utilizar para crear el archivo.
Enviarte el archivo después de la creación
El archivo se enviará a la dirección de correo electrónico de la cuenta inmediatamente después de ser creado. En el campo "Plantilla de correo", se puede elegir qué plantilla usar para el envío. Previamente, en Plantillas de correos se puede crear una plantilla separada para el envío de correos electrónicos a la cuenta. Si en el texto del correo se escribe la variable %data, todos los datos del archivo se agregarán en forma de tabla en ese lugar.
Script y estilos
En la página de integración necesitas obtener el código e insertarlo en el HEAD o cualquier otro lugar de la página. No necesitas insertar este código en todas las páginas del sitio. Solo necesitas insertarlo en la página con el formulario.
Además, necesitas crear dos bloques con los id result-success y result-danger. Ambos bloques deben estar ocultos con el estilo display:none; En el primer bloque, puedes escribir un texto sobre la creación exitosa del archivo. Este bloque se mostrará tras una solicitud exitosa. Si ocurre algún error, se mostrará el bloque con el id result-danger. El texto del error se insertará automáticamente en el bloque.
Sustitución en el documento
En el documento debe haber al menos una variable para reemplazar, por ejemplo %name o %course. Agrega en el formulario un campo donde el nombre de la variable debe comenzar con mask_, por ejemplo, mask_name o mask_course. Los datos introducidos por el visitante en estos campos se reemplazarán por las correspondientes variables en el texto del documento. Para especificar la dirección de correo electrónico, utiliza la variable mask_email. Para enviar correos a varias direcciones, indícalos separados por comas o espacios. El estado de envío en el Disco se mostrará por la primera dirección.
Funcionamiento del formulario
Después de crear el formulario, puedes abrir la página publicada y comprobar su funcionamiento. Se creará un archivo y se mostrará en una ventana emergente para su descarga.
Un documento = un llenado
Si lo deseas, puedes limitar el número de veces que se puede llenar el formulario. Si para el correo electrónico indicado ya se creó un archivo con el doc_id, se mostrará una advertencia de que solo se puede crear un archivo.
Mis documentos
Puedes mostrar los documentos de una persona en la parte privada de tu sitio web. Para ello, crea un formulario como se indicó anteriormente. Luego añade campos ocultos email, secure y doc_id. En el primero, la dirección de correo electrónico del visitante, y en el último campo, pon el valor all. Cuando se abra esta página, el visitante verá en lugar del formulario una lista de todos los documentos con la opción de descargarlos. Si deseas que, si el visitante ya completó el formulario, se le muestre su archivo en lugar del formulario, el campo email del formulario debe estar oculto y ser completado automáticamente por tu CMS.