PDF Maker

PDF Maker Manual · Chapter 5

Work area – PDF Maker for Vtiger CRM

The Work Area of PDF Maker consists of:

  • ListView – used for common tasks like add new template, import and export templates and access to others tools
  • ListView of Header/Footer – used for common tasks like add new template of Header or Footer, import,export or delete templates
  • DetailView – shows already created PDF template in details
  • EditView – allows the preparation of the new PDF template or editing existing templates
  • EditView of Header/Footer – allows the preparation of the new Header/Footer template or editing existing templates
  • PDF Maker block – mainly used for export records to PDF file
  • Preview – preview window with options to Download, Print, Send Email, Edit and Save into Documents

5.1 ListView of PDFMaker

The common tasks like add/delete template, import/export templates or start editing have to be initiated via PDF Maker ListView. Go to Projects→ PDF Maker and PDF Maker ListView will appear on your screen.
The main part of the PDF Maker ListView consists of list of the PDF templates, which gives you information about a template name, a primary module, a short description, sharing info, template owner and its status. In the list you can also select one or more templates and consequently delete or export the selected group of templates using button Action button – ListView of PDFMaker. As shown in the picture, it is also possible to edit or duplicate already created PDF templates directly from the ListView. Also there is option to search templates in your ListView.

ListView – PDF Maker Vtiger 7
ListView – PDF Maker Vtiger 7

There is group of buttons in the above part:

Action button – ListView of PDFMaker contains actions for delete, import and export of the PDF templates
Add template button – ListView of PDFMaker is used to add new PDF template
Add heder footer button – ListView of PDFMaker is used to add new Header/Footer template
Customize button – ListView of PDFMaker is settings part of PDF Maker. You can find here Extensions, Profiles, Self-defined labels, Product block templates, License setting, Upgrade PDF Maker and option to Uninstall PDF Maker

5.2 ListView of Header/Footer

The common tasks like add/delete Header/Footer template, import/export templates or start editing have to be initiated via ListView of Header/Footer. Go to Projects→ PDF Maker click on Header/Footer List andHeader/Footer ListView will appear on your screen.
The main part of the PDF Maker ListView consists of list of the Header/Footer templates, which gives you information about a template name, a primary module, a short description and type of template. In the list you can also select one or more templates and consequently delete or export the selected group of templates using button Action button – ListView of Header/Footer. As shown in the picture, it is also possible to edit or duplicate already created PDF templates directly from the ListView.

ListView of Headers/Footers – PDF Maker Vtiger 7
ListView of Headers/Footers – PDF Maker Vtiger 7

There is group of buttons in the above part:

Action button – ListView of Header/Footer contains actions for delete, import and export of the Header/Footer templates
Add template button – ListView of Header/Footer is used to add new PDF template
Add heder footer button – ListView of Header/Footer is used to add new Header/Footer template
Customize button – ListView of Header/Footer is settings part of PDF Maker. You can find here Extensions, Profiles, Self-defined labels, Product block templates, License setting, Upgrade PDF Maker and option to Uninstall PDF Maker

5.3 DetailView of PDF Maker

From ListView you can directly open any pdf template in DetailView. The DetailView consists of:

  • Template information part – gives basic information of the template
  • PDF template itself which consist of Header, Body and Footer part.
  • Group of action buttons
    • [Edit] – switch to EditView and start editing
    • [More] –
      • [Delete] – allows you to delete template
      • [Duplicate] – create duplicate of the template and start editing
  • Tools – for changing default and status of the shown template
    • Set as default / Unset as default – setting of default
    • Set as inactive / Set as active – change status
  • Display conditions – allows you to set conditions when template is shown or hidden
  • CSS Styles – allows to you manage your CSS styles and assigned it to templates

DetailView of PDF Maker
DetailView of PDF Maker

Display conditions

Display conditions tab allows set conditions when template is shown or hidden. If you want to show template without ban, leave conditions empty. There is option to show template if conditions are true or hide templates if conditions are true. You can set it by choosing Yes if/No if in Displayed tab. In Conditions tab you can choose if you want that all conditions must be met or At least one of the conditions must be met. You can add or delete conditions.

Display conditions
Display conditions

CSS Styles

Styles4You extension allows to you manage your CSS styles and assigned it to templates.

Styles4You
Styles4You

5.4 DetailView of Header/Footer

From ListView of Header/Footer you can open any Header/Footer template in DetailView. The DetailView consists of:

  • Template information part – gives basic information of the template
  • Header/footer template itself which consist of Header, Body and Footer part.
  • Group of action buttons
    • [Edit] – switch to EditView and start editing
    • [More] –
      • [Delete] – allows you to delete template
      • [Duplicate] – create duplicate of the template and start editing

DetailView of Headers/Footers – PDF Maker Vtiger 7
DetailView of Headers/Footers – PDF Maker Vtiger 7

5.5 Edit view of PDF Maker

The Edit view shown in the picture below is divided into two areas:

  • Tabs area – allows user to insert into template different kind of values, fields, labels and to set up properties, sharing and other common settings of the pdf template. Tabs area consists of following tabs, which are described in the following sub-chapters:
    • Basic information
    • Other information
    • Labels
    • Product block
    • Header/Footer
    • Properties
    • Settings
    • Signature
    • Sharing
  • Editing area – is mainly used for inserting/editing your own text, tables, images etc. and to make some design adjustment of the template like font change, color, format, size, background color of the text etc. This editing can be initiated via many toolbars located inside three tabs (Body, Header and Footer) in the above part of Editing area. Please refer to the chapter 4 for the details related to editing.

Note: If you click on the Body tab in editing area you automatically switch to the Properties tab. Also, if you click on Header tab or Footer tab in editing area then it switches Tabs area to Header/Footer tab.

PDF Maker - Edit view
PDF Maker – Edit view

5.5.1 Basic information

The main purpose of the Basic information tab is to define template name and module for which PDF will be used.

PDF Maker Properties tab
PDF Maker Properties tab

Name Description
Template name The name of the template. It is mandatory field for template creation.
Module Template will be based and available only for one selected module and its fields.
Related modules If exists related module(s) to selected module, it is possible here to select and use fields from any related modules.
Related blocks Related block(s) to selected module, with buttons to insert, create, edit or delete related block.
Company information Comprises group of fields from Company information.
User information Assigned to User, Logged in User, Modified by User and Created by User information

5.5.2 Other information

As shown below Other information tab contains several fields and functions:

Other information tab – PDF Maker Vtiger 7
Other information tab – PDF Maker Vtiger 7
Name Description
ListView block Create list view blocks
Terms and Conditions Terms and Conditions.
Current date Current date and times in several formats.
Barcodes, QR code Several types of Barcodes and QR code
Custom functions If you need a special treatment of Vtiger data in your template, you can use custom (or your own) functions.
Font Awesome Insert Font Awesome icons into your template
Is Signature Insert variable $PDF_SIGNATURE$ to place PDF Signature block

5.5.3 Labels

Labels tab consists of Global language, Module language and Self-defined labels part. Labels are very useful especially in case you need to print/save documents in two or more languages.

PDF Maker Labels tab
PDF Maker Labels tab

Name Description
Global language Global labels.
Module language Labels related only to selected module.
Self-defined labels Labels defined by user.

5.5.4 Product block

The product block tab allows inserting product block template and editing it. In addition, you can create your own product block using “Block start”, “Block end” and fields for products and services.

PDF Maker Product block tab
PDF Maker Product block tab

Name Description
Product block template Insert predefined and created product block templates.
Product block Products and Services Block start, Products and Services Block end. Products Block start, Products Block end. Services Block start, Services Block end. Each product block has to start with “Block start” and ends with “Block end”.
Common fields for Products & Services Fields common for products & services. You can find same fields for products and services separately as well, but it is recommended to prefer common fields in the templates.
Available fields for Products Fields for products.
Available fields for Services Fields for services.

5.5.5 Header/Footer

The Header / Footer tab comprises some variables and header/footer settings related to displaying.

Header/Footer tab – PDF Maker Vtiger 7
Header/Footer tab – PDF Maker Vtiger 7

Name Description
Header Allows you use custom or select from your Header templates
Footer Allows you use custom or select from your Footer templates
Header / Footer variables “Current page”, “Total pages” and “Page/pages”.
Display header Allows defining how to display the header of the pdf document.
Display footer Allows defining how to display the footer of the pdf document.

If you use Custom Header or Footer then to export is taken Header or Footer from PDF Template.
If you Select From list and choose your Header or Footer template then this template is added to PDF file in process of export.
How it works you can find also here

5.5.6 Properties

The Properties tab allows defining page settings, number format and new Watermark functionality.

pdfmaker-manual-properties
Properties Tab – PDF Maker Vtiger 7

Name Description
Page format A3, A4, A5, A6, Letter, Legal or Custom. Custom page format allows to define width and height of the page in mm. Maximum values are 2000 mm x 2000 mm and minimum values are 1mm x 1mm.
Page orientation Portrait or landscape.
Margins Margins in cm. Maximum value is 9.9 cm and minimum value is 0 cm.
Number format This format is used as default when Currency format is not checked for all values
Otherwise is can be used for Quantity or Percentage values ONLY if the Currency format is checked.

Decimal point separator – comma, dot (but any symbol can be used)
Decimal point number – 0-3 recommended (can be more based on your needs)
Thousands separator – comma, dot, space (but any symbol can be used)
Truncate Trailing Zeros – removes trailing zeros from decimal numbers

Curreny format When checked, this formatting is applied only on currency values.

Is Active – activate this formatting only for currency fields
Decimal point separator – comma, dot (but any symbol can be used)
Decimal point number – 0-3 recommended (can be more based on your needs)
Thousands separator – comma, dot, space (but any symbol can be used)

Watermark Allows you set text or image like watermark. Text should be static or based on module or related modules variables. Read more: Watermark

5.5.7 Settings

The Settings tab allows defining file name, new functionality PDF Password,description. page settings and other settings from usage of template point of view.

Settings Tab – PDF Maker Vtiger 7
Settings Tab – PDF Maker Vtiger 7
Name Description
File name File name in different formats.
PDF Password Allows you lock PDF file with static password or password created by values from module or related modules. Read more: PDF Password
Description The description of the pdf template.
Ignored picklist values Define picklist values which will be ignored in the final pdf document like None, none, keine etc. Entered values have to be separated with comma.
Status Active / Inactive
Set as default Set/unset as default for DetailView and ListView.
Default Product Image Size: Set the default product image size when exporting PDF for all products in the record.
Disable Export Edit: If this is checked, the EDIT Template option before export will be disabled.

5.5.8 Signature

This feature was added in version PDF Maker 4.49 on June 2023.

Users or Admin can create Signatures in form of Image and then load them into the Templates.
This can be used for PDF Signature extension, the Acceptance Signature process.

PDF Maker – Signature tab
PDF Maker – Signature tab

Users can create an Acceptance Signatures from the PDF Maker template list view, by going to Customize – Signatures:

PDF Maker – Settings – Signatures
PDF Maker – Settings – Signatures

5.5.9 Sharing

The Sharing tab changes depend on whether PDF template is shared or public/private. Using this tab you can define how to share your template between you and other users or groups.

PDF Maker Sharing tab
PDF Maker Sharing tab

Name Description
Template owner Select template owner from the list.
Sharing Select “Public”, “Private”, “Share”

5.6 EditView of Header/Footer

The EditView of Header/Footer shown in the picture below is divided into two areas:

  • Tabs area – allows user to insert into template different kind of values, fields and labels and to set up properties, and other common settings of the pdf template. Tabs area consists of following tabs which are described in the following subchapters:
    • Basic information
    • Other informations
    • Labels
  • Editing area – is mainly used for inserting/editing your own text, tables, images etc. and to make some design adjustment of the template like font change, color, format, size, background color of the text etc.

    EditView of Header/Footer – PDF Maker Vtiger 7
    EditView of Header/Footer – PDF Maker Vtiger 7

5.6.1 Basic information of Header/Footer

The main purpose of the Properties tab is to define template name and type of template (Header or Footer).

Properties tab – PDF Maker Vtiger 7
Properties tab – PDF Maker Vtiger 7

Name Description
Template name* The name of the template. It is mandatory field for template creation.
Type Type of template. Header or Footer template
Description Description of your template
Header/Footer variables Current page, All pages, Page/pages
Module You can select module if want add module fields. If you do not choose module template will be available for all PDF templates.
Related modules If you select module and if exists related module(s) to selected module, it is possible here to select and use fields from any related modules.
Company information Comprises group of fields from Company information.
User information Assigned to User, Logged in User, Modified by User and Created by User information

5.6.2 Other Informations of Header/Footer

As shown below Other information tab contains several fields and functions:

Other information tab – PDF Maker Vtiger 7
Other information tab – PDF Maker Vtiger 7

Name Description
Terms and Conditions Terms and Conditions.
Current date Current date and times in several formats.
Barcodes, QR code Several types of Barcodes and QR code
Custom functions If you need a special treatment of Vtiger data in your template, you can use custom (or your own) functions.
Font Awesome Insert Font Awesome icons into your template
Is Signature Insert variable $PDF_SIGNATURE$ to place PDF Signature block

5.6.3 Labels of Header/Footer

Labels tab consists of Global language, Module language (if module is selected) and Self-defined labels part. Labels are very useful especially in case you need to print/save documents in two or more languages.

Labels tab – PDF Maker Vtiger 7
Labels tab – PDF Maker Vtiger 7

Name Description
Global language Global labels.
Module language Labels related only to selected module.
Self-defined labels Labels defined by user.

5.7 PDF Maker block

The PDF Maker block can be found inside the specific module. In the module ListView it is necessary to click on any record to see details and on the right side, you can find the block. Depends on type of module and whether template already exists for selected module following forms of PDF Maker block can be seen in the screen (after PDF Maker installation, the PDF Maker block is visible only for modules with at least one already created PDF template) :

  1. Standard layout of the PDF Maker block.
  2. Extended layout of the PDF Maker block available for modules Invoice, Sales Order, Purchase Order, Quotes.

PDF Maker block for vtiger 7
PDF Maker block for vtiger 7

5.8 Preview

Preview window contains of PDF file preview and also you can find here options to Download file, Print, Send Email, Edit and Save into Documents.
It is useful to see how looks your PDF file.

Preview of PDF Maker
Preview of PDF Maker

Need help with PDF Maker?

Our support team answers questions about installation, templates and settings.