Vtiger CRM:PDF Maker
From http://wiki.vtiger.com/archives
About PDF Maker
PDF Maker FREE offers you possibility to create templates for Invoice, Qoutes, Saler Order and Purchase Order modules, which can be generated into PDF File.
Features
● Ability to use all standard and custom fields from choosen and related module ● Send generated PDF file via Email ● Allow use Products images in Invoice, Quotes, Purchase or Sales Order ● Support multilanguages output, define: fonts, paper format, margin, padding ....
Installation
PDFMaker_FreeVersion is Module Manager complaint. Follow the steps below to get it installed.
Step 1: Open Module Manager
You can find Module Manager under Settings page.
Using PDFMaker
I. Create the simple PDF template
After install PDF Maker Free Version, go to Settings->PDF Maker. Select the module you want to create a template.
After that you can choose all available Fields from selected Module (including custom fields). It's also possible to choose Related Module (i.e. Invoice has as Related Module: SO, Contacts, Accounts) and its all fields (including custom fields).
Module: contains all fields from module (Invoice, Quotes, Sales Order or Purchse Order) Related Modules: contains all fields from Related Module to main Module Product block template: contains definitely templates for products/services
Other informations tab:
Company and User information: specify company information from Settings > Company Details, contains data about Logged and Assigned to User from User settings. Terms and Conditions: this variable insert T&C data defined from vtiger Settings > Terms & Conditions. You can also use variable for T&C used in Invoice, Q, SO or PO module from Properties tab. Current date: insert current date in different format Barcodes: insert barcodes into your template, more information in chapter „VII. Barcode“
Labels tab:
You can choose variable from Global vtiger language file, or varaible from choosen Module. During export file into pdf this variable will be replaced by relevant translated string.
Global language: contains all vtiger global language expressions Module language: contains all main module language expressions
Product block tab
In this section you can insert product/service variable used by productblock between PRODUCTBLOCK START and END tag. For more infomation please read chapter „VI. Mapping products block with vtiger form“
Product block: manually to define productblock start and end Common fields for Products & Services: contains data (like unite price, quantity, discount, description, ..) for Products or Services from Invoice, Quote, Sales or Purchase Order Available fields for Products: contains all available fields from Products Module (like Product Category, Vendor, …) Available fields for Services: contains all available fields from Services Module (like Product Category,…) Product block template: includes default productblock templates, that you can modify according to your needs
Settings tab:
In this section you can define various settings, regarding Page Format, Margins, Decimal
Page format: you can select Page Format (from these types A3, A4, A5, A6, Letter, Legal) Page orientation: select page orientation (Portrait or Landscape) Ignored picklist values: enter the picklist values separated by comma, which will be ignored in pdf templates. (i.e. --None--, --none--, --keine--) Margins: you can define Margins of page (Top, Bottom, Left, Right) Number format: dec_point - Sets the separator for the decimal point. decimals - Sets the number of decimal points. thousands_sep - Sets the thousands separator.
You can now write some text into Body, Header or Footer section. Set the cursor into position, choose your variable and click on „Insert into template“ button. At the end you can make some design adjustments. After you have finished your template, click on Save button.
II. Generate and sending PDF
1/To generate PDF file, go to detailview of given Module. On the right side, you can find new PDF Maker block. Choose your PDF Template and click on „Export to PDF“ link.
2/ You can send this template or merged templates with email by click on „Send Email With PDF“
III. Inserting Images into template
1/ Press the „image“ button on the toolbar. A popup window called "Image Properties" will appear.
2/ URL: define the URL address of the image. You may also use the "Browse Sever" in order to browse the files.
For more info visit folloving site: http://docs.cksource.com/FCKeditor_2.x/Users_Guide/Common_Tasks/Inserting_Images
IV. Creating a table
1/ Press the "Insert/Edit Table" button on the toolbar. After that a popup window called "Table Properties" will appear.
2/ Set a basic table properties like width, height, column and rows count.
After that the table is inserted into template and you can write some text, insert all avaiable fields from choosen and related Modules or add some images into this new table. You can also make some design adjustments like bold text, underline, …
For more info visit folloving site: http://docs.cksource.com/FCKeditor_2.x/Users_Guide/Common_Tasks/Tables
V. Using a products block template
1/ There is "Product block templates" item available for some modules that display product block. It contains predefined templates for proper display of products in the Invoices, Quotes, Sales Order and Purchase Order. You can simply add the whole product block template into your template and modify it according to your needs.
2/ You can make some changes in the selected templates, like add cell or row, change the background color. You can edit layout like a table.
3/ After adding new cell you can add some new variables
3/ After adding new cell you can add some new variables
VI. Mapping products block with vtiger form
1/ Mapping values for result pricer available in Invoices, Quotes, Sales and Purchase Order .
Curreny – Euro, Dollar Currency symbol - €, $ Currency code – EUR, USD Subtotal – Price without TAX befor discount, by Tax Mode: group = Net Total Total discount – Final Discount amount Total discount (%) - Final Discount in % Total without TAX – Total price without TAX after discount TAX – Total TAX amount TAX(%) - Total TAX in % TAX block – This is useful for some countries, that need to have the detail amount of TAX Total with TAX – Total price with TAX Shipping & Handling taxes – Final taxes for Shipping & Handling
Shipping & Handling amount – Final amount for Shipping & Handling Adjustment – Adjustment from vtiger form Grand Total - Grand Total from vtiger form
2/ Mapping values for product bloc templates item available in Invoices, Quotes, Sales Orders and Purchase Orders.
Position – Number of position (1,2,3,...) Currency – Euro, Dollar Currency symbol - €, $ Currency code – EUR, USD Name – Name and desription of product/service Name of product/service – Only the name of product/service Description of product/service – Description of product/service from module Product/Service Comment for product/ service – Comment for products/service from Invoice/SO/PO/Q form
PDF Configurator description - Descriptions field from PDF Configurator extension (crm-now) Quantity – Quantity defined in Invoice/SO/PO/Q Unit – Unit of product/service from module Product/Service List price – List Price from Invoice/SO/PO/Q Total price – List price x Unit Discount – Discount amount for each product/service Discount (%) - Discount in % for each product/service Total after discount – Total price after discount without TAX TAX – TAX amount for each product/service TAX(%) - TAX in % for each product/service Total with TAX – Total price with TAX for each product/service
VII. Barcode
1/ In “Other informations” tab, there is “Barcode” field. Chosse your barcode type and insert into templates
2/ You can use a static number/string for making barcode or you can use a variables from actual template.
1/ When you switch to header/footer tab, there are under “Properties” new Field Header/Footer variables like Current page, Total pages, Page/Pages. You can use this variables in header/footer section. You can also use all variables available in chosen module.
IX. Product page break
1/ For some modules (Invoice, SO, PO, Q) that display product block, we use "Product block templates" item. If you would like to define a new page after some product, click on „PDF Product Page Break“ link and the new frame will be displayed. You have to choose a product after which new page will begin. You can also set a repetition of header of table on the next page or to set displaying of subtotal value at the end of the page (before page break).
X. Product images
1/ In the "Product block templates" it is possible to use the products images too.
3/ Click on „PDF Product images“ link and the new frame will be displayed. You can choose a products images which should be generated in the PDF template. You can also set a width or height for the generated images. If you leave one of the parameter fields empty, the size of
image will be proportional. If you leave both parameter fields empty, the image will be displayed in its original size.
