Formulario de creación
Creación automática de archivos en su sitio web: diplomas, certificados o cualquier otra cosa. El visitante de su sitio web solo tendrá que completar el formulario y recibirá el archivo.
Para crear archivos, debe crear un formulario HTML en su sitio web. Si no es posible, simplemente use el widget de creación.
Creación de formulario
Para enviar solicitudes para crear archivos en DiMaker, debe crear un formulario en su sitio web. Este formulario puede estar en la parte pública o privada de su sitio. Con su CMS, cree una página y un formulario en la página.
Action del formulario
https://dimaker.app/api/v1/webform-create/Campos del formulario
Debe crear algunos campos ocultos con los siguientes valores:
-
secure*
Token (cadena, 36 caracteres)
-
doc_id*
ID del documento (cadena, 36 caracteres) que se utilizará para crear el archivo. Puede obtener el ID en la barra de dirección cuando se abre el documento. 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 por correo electrónico. Puede obtener el ID en la barra de dirección cuando se abre la plantilla. Si la variable no está pasada, no se enviará ningún correo electrónico.
-
email_send
Hora de enviar el correo electrónico con el archivo. Puede tomar los siguientes valores:
onfinish - Enviar todos los correos electrónicos después de crear todos los archivos (por defecto)
oncreate - Enviar correos electrónicos inmediatamente después de crear un archivo. Al crear un solo archivo, onfinish y oncreate son idénticos.
timeout - Enviar correos electrónicos después de un período de tiempo. En este caso, debe pasar dos parámetros adicionales:
email_timeout_value - valor numérico del intervalo de tiempo para enviar correos electrónicos, valor entero
email_timeout_unit - unidad de tiempo del intervalo de tiempo. Puede tomar el valor "m" (minuto), "h" (hora), "d" (día).
O para especificar un momento preciso para enviar, debe pasar la hora en formato de tiempo UNIX en email_timeout_timestamp. Si pasa timeout y email_timeout_timestamp, la última tendría prioridad. -
folder_id
ID de la carpeta de Drive (cadena, 36 caracteres) para guardar archivos. Si no hay carpeta, 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. Puede pasar un número (primera página - 0), o números (separados por comas) de las páginas que desea utilizar para crear el archivo.
Enviar un archivo a uno mismo después de crearlo
El archivo se enviará a la cuenta de correo electrónico inmediatamente después de ser creado. En el campo "Plantilla de correo electrónico" se puede seleccionar qué plantilla utilizar para enviarlo. Con antelación, en Plantillas de correo se puede crear una plantilla separada para enviar correos electrónicos a la cuenta de correo electrónico. Si en el texto del correo se escribe la variable %data, se añadirán en esa parte todos los datos del archivo en forma de tabla.
Script y estilos
En la página de integración hay que tomar el código e insertarlo en HEAD o en cualquier otro lugar de la página. No es necesario insertar este código en todas las páginas del sitio. Hay que insertar este código sólo en la página con el formulario.
Además, hay que crear dos bloques con id result-success y result-danger. Ambos bloques están ocultos con el estilo display:none; En el primer bloque se puede escribir el texto con la creación exitosa del archivo. Este bloque se mostrará en caso de éxito en la solicitud. Si hay algún error, se mostrará un 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 la sustitución, por ejemplo %name o %course. Agregue en el formulario un campo donde el nombre de la variable debe comenzar con mask_, por ejemplo mask_name o mask_course. Los datos ingresados por el visitante en estos campos se sustituirán por las variables correspondientes en el texto del documento. Para indicar la dirección de correo electrónico, utilice la variable mask_email. Para enviar correos a varias direcciones, indique separado por comas o espacios. En este caso, el estado de envío en Drive se mostrará en la primera dirección.
Funcionamiento del formulario
Después de crear el formulario, se puede abrir la página publicada y verificar el funcionamiento del formulario. Se creará un archivo y se mostrará en una ventana emergente para su descarga.
Un documento = un envío
Opcionalmente, se puede limitar la cantidad de envíos del formulario. Si ya se ha creado un archivo con doc_id en el correo electrónico especificado, se mostrará una advertencia de que sólo se puede crear un archivo.
Mis documentos
Se pueden mostrar los documentos de la persona en la sección cerrada de su sitio. Para hacer esto, cree un formulario como se indica anteriormente. Luego, agregue campos ocultos para email, secure y doc_id. En el primer campo, la dirección de correo electrónico del visitante, y en el último campo, indique el valor todos. Al abrir esta página, el visitante verá en lugar del formulario una lista de todos los documentos con la posibilidad de descargarlos. Si desea que si el visitante completó el formulario, en lugar de mostrar el formulario, se le muestre su archivo, el campo de correo electrónico del formulario debe estar oculto y automatizado en su CMS.