Creation Form
Automate file creation on your website - diplomas, certificates, or other documents. Your site visitors just need to fill out the form and receive their file.
To generate files, create an HTML form on your website. If that's not feasible, simply use our creation widget.
Form Creation
To send requests for file generation to DiMaker, you need to create a form on your site. This form can reside in either the public or restricted section of your website. Use your CMS to create a page and form on that page.
Form Action
https://dimaker.app/api/v1/webform-create/Form Fields
You need to create several hidden fields with the following values:
-
secure*
Token (string, 36 characters)
-
doc_id*
ID of the document (string, 36 characters) used for file creation. Obtain the ID from the address bar when the document is open. It should not be in the trash but can be in any folder.
-
mail_id
ID of the email template (string, 36 characters) for sending emails. Obtain the ID from the address bar when the template is open. If this variable is not provided, no email will be sent.
-
email_send
Time to send the email with the file. Acceptable values are:
onfinish - Send all emails after creating all files (default)
oncreate - Send emails immediately after creating the file. For a single file, onfinish and oncreate are identical.
timeout - Send emails after a time interval. In this case, provide two additional parameters:
email_timeout_value - Numeric interval value for sending emails, as an integer
email_timeout_unit - Unit for the interval. Can be "m" (minutes), "h" (hours), or "d" (days).
Alternatively, to specify an exact send time, provide the time in Unix format in email_timeout_timestamp. If both timeout and email_timeout_timestamp are provided, the latter takes precedence. -
storage_period
Duration for storing files on the Disk. If not specified, files are stored indefinitely until manually deleted. Use timeout for automatic deletion. Provide two additional parameters:
storage_period_timeout_value - Numeric interval value for deleting files, as an integer
storage_period_timeout_unit - Unit for the interval. Can be "m" (minutes), "h" (hours), or "d" (days).
Alternatively, to specify an exact deletion time, provide the time in Unix format in storage_period_timeout_timestamp. If both storage_period_timeout_value and email_timeout_timestamp are provided, the latter takes precedence. -
folder_id
ID of the folder on Disk (string, 36 characters) for saving files. If the folder doesn't exist, it will be created automatically with the first file creation.
-
page_id
Sheet number (number or string), if the document has multiple sheets. Provide a single number (first sheet is 0), or multiple numbers (comma-separated) for the sheets to use in file creation.
Send File to Yourself After Creation
The file will be sent to the account's email immediately after creation. In the "Email Template" field, select which template to use for the email. You can pre-create a specific template in Mail Templates for account email delivery. If you include the variable %data in the email text, all file data will be inserted there in a table format.
Script and Styles
Get the code and insert it into the HEAD or any other section of the integration page. Do not include this code on all site pages, only on the page with the form.
Additionally, you need to create two blocks with the IDs result-success and result-danger. Both should be hidden using display:none; In the first block, write success messages for file creation. It will appear upon a successful request. If an error occurs, the result-danger block will display automatically with the error message.
Placeholder in Document
Your document should have at least one placeholder for replacement, such as %name or %course. Add fields in the form where the variable name starts with mask_, like mask_name or mask_course. The data entered by visitors will replace corresponding placeholders in the document text. Use mask_email for email addresses. To send emails to multiple addresses, list them separated by commas or spaces. The Disk status will reflect the first address.
Form Functionality
After creating the form, open the published page to test its functionality. A file will generate and appear in a pop-up window for download.
One Document = One Submission
Optionally, limit the number of form submissions. If a file with the doc_id was already created for the specified email, a warning will indicate only one file can be created.
My Documents
You can display a user's documents in a restricted area of your site. Create the form as outlined above. Then add hidden fields for email, secure, and doc_id. In the email field, enter the visitor's email address, and in the doc_id field, use the value "all." When this page opens, visitors will see a list of all documents with download options instead of the form if they have already filled out the form. Ensure the form's email field is hidden and automatically populated by your CMS.