Documents ========= Animal Shelter Manager has extensive document abilities for creating forms and letters. The system also includes its own web-based word processor for handling this. To create a document for use with the system, you can manage templates under :menuselection:`Settings --> Document Templates`. You embed keys in your document that will be substituted with real data when a document is generated. For a complete list of document keys, see :ref:`wordkeys` Keys follow the format <<[Keyname]>>. For example, putting the tag <> in your document will cause it to be substituted for the animal's name. .. image:: images/document_menu.png A number of places in the system have toolbars with generate document buttons, you can find these: * On the animal details screen (creates documents with animal, person and movement information, useful for adoption paperwork) * On the person screen(creates documents with person information) * On the payments tab (creates documents with person, payment and animal information, useful for invoice and receipt templates) However you choose to create the document, the process is the same. You select your document template from the dropdown list. .. image:: images/html_wp.png Once you have selected the template, the document will be generated and opened in the word processor, ready for editing and printing. If you hit the save button in the word processor, the document will be saved to the appropriate media tab of the animal/person you generated the document for. You can also use the PDF button on the toolbar to generate and open a PDF of the document. This is useful as PDFs will be consistent across different machines running different operating systems and with different fonts installed. .. image:: images/html_wp_to_pdf.png PDF Directives -------------- You can embed directives in your document to give some hints to the PDF engine. These should take the form of HTML comments, embedded in , and can be inserted by going to Tools->Source Code in the document editor::
To set the papersize to a4. Other options are a3, a5 and letter::
To set the papersize to an exact measurement (in this case 89mm x 36mm width x height, which is the size used by the Dymo 450 label printer)::
To set the orientation to landscape. Portrait is the default but can be explicitly set too. Note that setting an orientation will override any papersize exact directive. Use the margins directive to set the PDF margins::
Margins are in the order top, bottom, left then right. The PDF engine will scale the document to fit the page horizontally based on the widest element in it. Use the zoom directive to override this behaviour and specify a scaling amount (this sets a zoom CSS value on the body element)::
Most of these options are to wkhtmltopdf, a PDF renderer based on webkit (the engine used by the Chrome and Safari web browsers). An alternative, simpler PDF engine can also be used by specifying::
Email Tokens in Document Templates ---------------------------------- When creating email document templates it is possible to include an email subject by using the {{SUBJECT}} token with custom text or a word key, see :ref:`wordkeys` :: {{SUBJECT This is about <>}} The following tokens can also be used to add email addresses to the template:: {{TO example@email.com}} {{FROM example@email.com}} {{CC example@email.com}} {{BCC example@email.com}} Note that the TO token will be ignored if you are using this template with a mail merge. More than one email address can be included by adding the address seperated by a comma:: {{BCC example@email.com, example2@email.com}} Electronic Signatures --------------------- .. warning:: Electronic signatures are only supported by ASM's built in HTML-based word processor. They cannot be used with OpenOffice templates. .. image:: images/sign_buttons.png ASM allows you to add electronic signatures to documents. Signed documents are read only and cannot be edited. A cryptographic hash for the signed document is calculated and stored separately so that any future tampering can be detected. There are multiple methods of adding signatures to documents: * "Sign on screen" menu item in the media tab (using a touchscreen monitor, wacom tablet, lightpen, other mouse-like device or if you are using a tablet computer) * "Signing Pad" mode of the mobile interface for any external touchscreen device (iPad, iPhone, Android phone/tablet, etc). * "Request signature by email" menu item in the media tab, which sends an email to the recipient of your choice (defaults to the current person if this is a person's media tab) with links for them to follow to sign the selected documents with their own touchscreen device. * A signature that has been pre-stored for the currently logged in user (necessary for a staff signature in addition to the main signatory). To use, select the documents you'd like to sign and click the "Sign" dropdown on the toolbar of the media tab. ASM allows you to use any generic mouse or touchscreen hardware and mobile touchscreen devices as signing pads - you do not need to buy expensive custom hardware. .. note:: Once signed, a document cannot be edited. A maximum of two signatures can be recorded in a document - one for the signatory and one for the current system user. .. image:: images/sign_dialog.png To control the size and location of the signature: * Add the token <> where you'd like the signature to appear. * You can set a pixel width of 100, 150, 200 or 300 (the default is 150) in the token, eg: <> * When a document is generated from your template, a placeholder image of the correct size will appear where you inserted the token. * The document signing module will replace the placeholder image with the signature after the document is signed. If your document template does not contain a signature token, the signature will be attached to the document as a footer along with the date and time the document was signed. .. image:: images/sign_doc.png In addition, an icon will appear next to the document on the media tab to indicate that the document has now been signed. .. image:: images/sign_icon.png Mobile Signing -------------- The "Mobile signing pad" menu item allows you to mark the document for signing in the mobile interface. If you visit ASM's mobile interface on any mobile/tablet device, you can use the "Signing Pad" link in the mobile interface to go into signing pad mode. .. warning:: The mobile interface must be logged in with the same user account as the person who clicked the "Signing Pad" button on the media tab. This prevents users signing other's documents and eliminates confusion in multi-site use. .. image:: images/sign_mobilepad.png .. image:: images/sign_waiting.png Once in signing pad mode, the interface waits for documents to sign. When documents are received, they can be reviewed in the mobile interface with a signature pad below for the person to sign. This is useful for adoption and other paperwork and allows you to keep contracts in a completely electronic manner without the need for paper. You can still print off signed documents or email them in PDF form to adopters directly. .. image:: images/sign_mobiledoc.png User Signatures --------------- It is quite common for documents to require a member of staff signature as well as the main signatory (eg: new adopter/volunteer/etc. ). In order to add a second signature to a document, the user's signature must be stored within the system. This means the system can insert the user's signature into the document which can then be signed using the signing pad - it isn't currently possible to add multiple signatures to a single document using the signing pad. Each user can store their own signature in the "Change User Settings" page, accessed under the user menu (the menu with the logged in user's name at the top right of the screen). .. image:: images/sign_user.png You can add a placeholder for the current user's signature in your document templates with the <> wordkey. This will insert the signature at 150px width into the document as an image. You can use the same 100, 150, 200 or 300 suffix to control the size of the user signature.