In order to create an “image type” variable, i.e. one that may allow the end user to upload an image or introduce his/her signature via a signature pad we need to insert a placeholder image in the corresponding Word template.
In order that Docxpresso reconized that image as an “interactive” one we should tag it as usual with a Docxpresso like variable like {{image_name}}. This is done introducing that text as an alternative text associated with the image.
Unfortunately depending on the Word or LibreOffice version that you are using this is done differently (if the shown method can not be applied in your case just consult the Word or LibreOffice help).
Right click on the image so the contextual menu shows up:
By clicking in the Alt Text menú entry a panel will show up at the right of your screen
:
And write the name of the variable within double curly barckets.
When you upload the template to Docxpresso that image becomes “editable” so we should parametrized it via the template edit interface:
By clicking on the image a popup with the following options will be shown:
The following specific fields to a image type variable (the others coincide with the ones of a normal text variable so we will not go over them once again here) will appear:
- Source: that can take the following values:
- Picture: when the end users will click the image they will be asked to upload an image from their file system.
- Signature pad: in this case when clicked by the end users a pop up with a signature pad will open so they can insert their signature (notice that this signature is not legally binding by itself).
- QR: if chosen an automatic QR will be generated (more on this below).
- Format: we are offered the following options:
- Preserve width: the image or signature will show up preserving the placeholder image width.
- Preserve height: the image or signature will show up preserving the placeholder image height.
- Preserve size: in this case both placeholder width and height will be preserved. Notice that this may cause the resulting image to be distorted.
- Redimension: the width and height of the uploaded image will be preserved. Notice that this may break the original template layout.
- Max. file size: it will limit the acceptable size of the uploaded image. This may also be limited by other factors like the general server configuration. If you need to upload really big images, please, contact the Docxpresso support.
QRs
If the QR option is chosen we are offered extra alternatives like:
- Type: that can take the following options:
- Continue edition link: the QR contains a link that allows to continue the edition of the document.
- Predefined link or text: the QR will reflect the introduced link or text (in this case an additional input field will show up).
- Value of a variable: the value of the chosen variable (a dropdown with the list of available variables is offered) will be used in the QR.
- Size: the available sizes in pixels of the resulting QR.
