Difference between revisions of "PDF templates"

From Protemos Wiki
Jump to: navigation, search
(XHTML elements and attributes)
 
(115 intermediate revisions by the same user not shown)
Line 1: Line 1:
Watch our video tutorial on Common notes - [[File:2ag.png|40px|link=https://youtu.be/hCA48afcmR4]]
+
=='''PDF Templates'''==
  
You can define common notes for client invoices, vendor invoices, quotes and job PO.
+
You can create PDF templates for client invoices, vendor invoices, quotes, and job PO.
  
Common note text can contain valid XHTML 1.0 markup. Allowed XHTML elements: a, b, br, div, h1, h2, h3, h4, h5, h6, hr, i, li, ol, p, span, ul. Allowed attributes: href, style.
+
PDF templates text can contain valid XHTML 1.0 markup. Allowed XHTML elements: a, b, br, div, h1, h2, h3, h4, h5, h6, hr, i, li, ol, p, span, ul. Allowed attributes: href, style.
  
To add the common notes, go to '''Settings → Common notes:'''
+
To create a template, go to '''Settings → PDF Templates:'''
  
[[File:Screreenshot 1.png|border|300px]]
+
[[File:Settings - pdf templates.png|border|280px]]
  
You always can update or delete the note:
+
You always can clone, update or delete the templates:
  
[[File:SsScreenshot 1.png|border|800px]]
+
[[File:Client invoice pdf templates+.png|border|1070px]]
  
=='''Client invoice common notes'''==
+
=='''Client invoice PDF templates'''==
  
To add the client invoice common notes, go to '''Settings → Common notes → Client invoice''':
+
To create the client invoice PDF template, go to '''Settings → PDF Templates → Client invoice''':
  
[[File:1 client cn.png|border|300px]]
+
[[File:Settings - pdf templates - client invoice.png|border|280px]]
  
Press '''"New common note"''':
+
Click '''"New PDF template"''':
  
[[File:2 client cn.png|border|900px]]
+
[[File:New pdf template (client invoice).png|border|1000px]]
  
Enter the name, the comment, and press '''"Create"''':
+
Fill in the fields, select the needed options and click '''"Create"''':
  
[[File:1NEW UPD.png|border|900px]]
+
[[File:New cl invoice pdf template2.png|border|1000px]]
  
You can define a default client invoice common note and it will be displayed in every client invoice you issue.
+
*'''Name''' — the name of the template;
  
Go to the '''Account''' page, scroll down to the Default settings, and press '''"Update"''':
+
*'''Page size''' — select A4 or a letter size;
  
[[File:Default common note.png|border|900px]]
+
*'''Page orientation''' — select the portrait or landscape page orientation;
  
From the drop-won list choose the needed one, and press '''"Update"''':
+
*'''Top margin, mm''' — the top margin height in millimeters;
  
[[File:1325.png|border|900px]]
+
*'''Bottom margin, mm''' — the bottom margin height in millimeters;
  
You can add a common note in an invoice.
+
*'''Locale''' — locale defines the language of the template text;
  
Open the needed invoice and press '''"Update"''':
+
*'''Page header''' — the text that appears at the top of the page;
  
[[File:Screekknshot 2.png|border|900px]]
+
*'''Page footer''' — the text that appears at the bottom of the page;
  
Choose the needed invoice common note from the drop-down list, and press '''"Update"''':
+
*'''Common note''' — this field is used for any additional notes;
  
[[File:Scrseeddnshot 3.png|border|600px]]
+
*'''Include CAT log details''' — unmark this checkbox if you want to remove CAT log details from the PDF template.
  
[[File:Redirect.jpg|40px|link=Common notes]] Back to the '''table of contents'''.
+
You can define a default client invoice PDF template that will be applied to invoices for all the new clients.
  
=='''Vendor invoice common notes'''==
+
Go to the '''Account''' page, scroll down to the '''Account settings''', and click '''"Update"''':
  
To add the vendor invoice common notes, go to '''Settings → Common notes → Vendor invoice''':
+
[[File:Account settings (client invoice template).png|border|1000px]]
  
[[File:Vendvor cn.png|border|300px]]
+
Select the needed one from the drop-down list and click '''"Update"''':
  
Press '''"New common note"''':
+
[[File:Update account settings+.png|border|1000px]]
  
[[File:New cn.png|border|900px]]
+
You can also select the default client invoice PDF template for a particular client.  
  
Enter the name, the comment, and press '''"Create"''':
+
Go to the needed client profile, scroll down to the '''Settings''' section and click '''"Update"''':
  
[[File:1 nedw.png|border|900px]]
+
[[File:Client profile setting section.png|border|1000px]]
  
You can define a default vendor invoice common note that will be displayed in every vendors' invoices you issue.
+
Select the template from the drop-down list and click '''"Update"''':
  
Go to the '''Account''' page, scroll down to the Default settings, and press '''"Update"''':
+
[[File:Client profile settings section1.png|border|1000px]]
  
[[File:Updacte.png|border|900px]]
+
If needed, you can select the template for a specific client invoice. Open the needed invoice and click '''"Update"''':
  
From the drop-won list choose the needed one, and press '''"Update"''':
+
[[File:Update client invoice.png|border|1000px]]
  
[[File:2c2 vcm.png|border|900px]]
+
Choose the template from the drop-down list and click '''"Update"''':
  
You can update the common vendor invoice note in invoices. Open the needed invoice and press '''"Update"''':
+
[[File:Update cl invoice2.png|border|1000px]]
  
[[File:Screenshot 9.png|border|900px]]
+
[[File:Redirect.jpg|40px|link=PDF templates]] Back to the '''table of contents'''.
  
Choose the needed invoice common note from the drop-down list, and press '''"Update"''':
+
=='''Vendor invoice PDF templates'''==
  
[[File:Sccreenshot 8.png|border|600px]]
+
To add the vendor invoice PDF templates, go to '''Settings → PDF Templates → Vendor invoice''':
  
[[File:Redirect.jpg|40px|link=Common notes]] Back to the '''table of contents'''.
+
[[File:Settings - pdf templates - vendor invoice.png|border|280px]]
  
=='''Quote common notes'''==
+
Click '''"New PDF template"''':
  
To add the quote common notes, go to '''Settings → Common notes → Quote''':
+
[[File:New vendor invoice PDF templates.png|border|1000px]]
  
[[File:Quote common note.png|border|300px]]
+
Fill in the fields, select the needed options and click '''"Create"''':
  
Press '''"New common note"''':
+
[[File:New cl invoice pdf template2.png|border|1000px]]
  
[[File:Screenffshot 2.png|border|900px]]
+
*'''Name''' — the name of the template;
  
Enter the name, the comment, and press '''"Create"''':
+
*'''Page size''' — select A4 or a letter size;
  
[[File:Screeddnshot 3.png|border|900px]]
+
*'''Page orientation''' — select the portrait or landscape page orientation;
  
You can define a default quote common note that will be added to every quote you create.
+
*'''Top margin, mm''' — the top margin height in millimeters;
  
Go to the '''Account''' page, scroll down to the Default settings, and press '''"Update"''':
+
*'''Bottom margin, mm''' the bottom margin height in millimeters;
  
[[File:1 upd fef comm.png|border|900px]]
+
*'''Locale''' — locale defines the language of the template text;
  
From the drop-down list choose the needed one, and press '''"Update"''':
+
*'''Page header''' — the text that appears at the top of the page;
  
[[File:Screednddshot 4.png|border|600px]]
+
*'''Page footer''' — the text that appears at the bottom of the page;
  
==='''Add a quote common note'''===
+
*'''Common note''' — this field is used for any additional notes;
  
You can update the common quote note in the needed quote when you create it.
+
*'''Include CAT log details''' — unmark this checkbox if you want to remove CAT log details from the PDF template.
  
You also can add the common not by pressing the '''"Update"''':
+
You can define a default vendor invoice PDF template that will be applied to invoices for all the new vendors.
  
[[File:Screejjlnshot 4.png|border|900px]]
+
Go to the '''Account''' page, scroll down to the '''Account settings''', and click '''"Update"''':
  
Choose the needed quote common note from the drop-down list, and press '''"Update"''':
+
[[File:Account settings - def v invoice template.png|border|1000px]]
  
[[File:Screeasdnshot 5.png|border|600px]]
+
Select the needed one from the drop-down list and click '''"Update"''':
  
[[File:Redirect.jpg|40px|link=Common notes]] Back to the '''table of contents'''.
+
[[File:Update account settings (v invoice).png|border|1000px]]
  
=='''Job PO common notes'''==
+
You can also select the default vendor invoice PDF template for each vendor.
  
To add the job PO common notes, go to '''Settings → Common notes → Job PO''':
+
Go to the needed vendor profile, scroll down to the '''Settings''' section and click '''"Update"''':
  
[[File:1 common note.png|border|300px]]
+
[[File:Update vendor profile+.png|border|1000px]]
  
Press '''"New common note"''':
+
Select the template from the drop-down list and click '''"Update"''':
 
 
[[File:Scrcsdeenshot 1.png|border|900px]]
 
 
 
Enter the name, the comment, and press '''"Create"''':
 
 
 
[[File:Screenvvvvvshot 2.png|border|900px]]
 
 
 
You can define a default job PO common note that will be added to every job you create.
 
 
 
Go to the '''Account''' page, scroll down to the Default settings, and press '''"Update"''':
 
 
 
[[File:Updsfefate.png|border|900px]]
 
 
 
From the drop-down list choose the needed one, and press '''"Update"''':
 
 
 
[[File:Screensaswfhot 3.png|border|600px]]
 
 
 
You can update the common job PO note for the needed job when you create it.
 
 
 
Or open already created job and press '''"Update"''':
 
 
 
[[File:Scdrreenshot 6.png|border|900px]]
 
 
 
Choose the needed job PO common note from the drop-down list, and press '''"Update"''':
 
 
 
[[File:Screenshot 7.png|border|450px]]
 
 
 
[[File:Redirect.jpg|40px|link=Common notes]] Back to the '''table of contents'''.
 
 
 
=='''XHTML elements and attributes'''==
 
 
 
{| style="width:1200px" border="1"  class="mw-datatable"
 
 
 
|-style="height:40px"
 
|1. " valign="top" align="center" width="100"  |  '''TAG'''
 
|2. " valign="top" align="center" width="300" | '''DESCRIPTION'''
 
|3. " valign="top" align="center" width="300" | '''EXAMPLE'''
 
|4. " valign="top" align="center" width="300" | '''VIEW'''
 
 
|-style="height:10px"
 
|1. " valign="top" align="center" width="100"  |  '''<nowiki><a href></nowiki>'''
 
|2. " valign="top" align="left" width="300" | The <a> tag defines a hyperlink, which is used to link from one page to another. The most important attribute of the <a> element is the href attribute, which indicates the link's destination.
 
|3. " valign="top" align="left" width="300" | <nowiki><a href="protemos.com">Visit my website</a></nowiki>
 
<br> <nowiki><a href="mailto:as@protemos.com">as@protemos.com</a></nowiki>
 
 
 
|4. " valign="top" align="center" width="300" | [[File:1 V.png|150px]]
 
 
 
|-style="height:40px"
 
|1. " valign="top" align="center" width="100"  | '''<nowiki><b></nowiki>'''
 
|2. " valign="top" align="left" width="300" | The tag specifies bold text without any extra importance.
 
|3. " valign="top" align="left" width="300" | <nowiki><b>This text is bold</b></nowiki>
 
|4. " valign="top" align="center" width="300" | [[File:2 B.png|130px]]
 
 
 
|-style="height:40px"
 
|1. " valign="top" align="center" width="100"  | '''<nowiki><br/></nowiki>'''
 
|2. " valign="top" align="left" width="300" | The tag inserts a single line break.
 
|3. " valign="top" align="left" width="300" | <nowiki><br/></nowiki>
 
 
 
|-style="height:40px"
 
|1. " valign="top" align="center" width="100"  | '''<nowiki><div></nowiki>'''
 
|2. " valign="top" align="left" width="300" | Defines a division part. It's a block-level element
 
|3. " valign="top" align="left" width="300" | <nowiki><div style="text-align: center;">This text is in the center.</div></nowiki>
 
|4. " valign="top" align="center" width="300" | [[File:Centre.png|150px]]
 
 
 
|-style="height:40px"
 
|1. " valign="top" align="center" width="100"  | '''<nowiki><h1> to <h6></nowiki>'''
 
|2. " valign="top" align="left" width="300" | Defines Headings level from 1 to 6 different sizes.
 
|3. " valign="top" align="left" width="300" | <nowiki><h1 style="color:blue;">This is a heading</h1></nowiki>
 
|4. " valign="top" align="center" width="300" | [[File:3 H.png|200px]]
 
 
 
|-style="height:40px"
 
|1. " valign="top" align="center" width="100"  | '''<nowiki><hr></nowiki>'''
 
|2. " valign="top" align="left" width="300" | Represents a thematic break between paragraph-level tags. It is typically drawn horizontal line.
 
|3. " valign="top" align="left" width="300" | <nowiki><hr/></nowiki>
 
|4. " valign="top" align="center" width="300" | [[File:1 line.png|140px]]
 
 
 
|-style="height:40px"
 
|1. " valign="top" align="center" width="100"  | '''<nowiki><i></nowiki>'''
 
|2. " valign="top" align="left" width="300" | The content inside is typically displayed in ''italic''.
 
|3. " valign="top" align="left" width="300" | <nowiki><i>This text is italic</i></nowiki>
 
|4. " valign="top" align="center" width="300" | [[File:4 I.png|110px]]
 
 
 
|-style="height:40px"
 
|1. " valign="top" align="center" width="100"  | '''<nowiki><li></nowiki>'''
 
|2. " valign="top" align="left" width="300" | The tag defines a list item. The <nowiki><li></nowiki> tag is used inside ordered lists(<nowiki><ol></nowiki>), unordered lists (<nowiki><ul></nowiki>)
 
|3. " valign="top" align="left" width="300" | <nowiki><ol>
 
<li>Quote</li>
 
  <li>Project</li>
 
  <li>Job</li>
 
</ol></nowiki>
 
|4. " valign="top" align="center" width="300" | [[File:8Q.png|80px]]
 
  
|-style="height:40px"
+
[[File:Update vendor profile+1.png|border|1000px]]
|1. " valign="top" align="center" width="100"  | '''<nowiki><ol></nowiki>'''
 
|2. " valign="top" align="left" width="300" | The tag defines an ordered list. An ordered list can be numerical or alphabetical. The <nowiki><li></nowiki> tag is used to define each list item.
 
|3. " valign="top" align="left" width="300" | <nowiki><ol>
 
<li>Quote</li>
 
  <li>Project</li>
 
  <li>Job</li>
 
</ol></nowiki>
 
|4. " valign="top" align="center" width="300" | [[File:8Q.png|80px]]
 
  
|-style="height:40px"
+
If needed, you can select the template for a specific vendor invoice. Open the needed invoice and click '''"Update"''':
|1. " valign="top" align="center" width="100"  | '''<nowiki><p></nowiki>'''  
 
|2. " valign="top" align="left" width="300" |The tag defines a paragraph.
 
|3. " valign="top" align="left" width="300" | <nowiki><p>This project is due <span style="color: red;">30 days</span>.</p></nowiki>
 
|4. " valign="top" align="center" width="300" | [[File:1 th.png|160px]]
 
  
|-style="height:40px"
+
[[File:Update vendor invoice.png|border|1000px]]
|1. " valign="top" align="center" width="100"  | '''<nowiki><span></nowiki>'''
 
|2. " valign="top" align="left" width="300" | The tag is an inline container used to mark up a part of a text, or a part of a document. The <span> tag is much like the <nowiki><div></nowiki> element, but <nowiki><div></nowiki> is a block-level element and <span> is an inline element.
 
|3. " valign="top" align="left" width="300" | <nowiki><p>This is a <span style="color:blue;"> paragraph</span>.</p></nowiki>
 
|4. " valign="top" align="center" width="300" | [[File:5. P.png|130px]]
 
 
 
|-style="height:40px"
 
|1. " valign="top" align="center" width="100"  | '''<nowiki><ul></nowiki>'''
 
|2. " valign="top" align="left" width="300" | The tag defines an unordered (bulleted) list. Use the <nowiki><ul></nowiki> tag together with the <nowiki><li></nowiki> tag to create unordered lists.
 
|3. " valign="top" align="left" width="300" | <nowiki>
 
<ul>
 
  <li>Quote</li>
 
  <li>Project</li>
 
  <li>Job</li>
 
</ul>
 
</nowiki>
 
|4. " valign="top" align="center" width="300" | [[File:6. Q.png|80px]]
 
 
 
|-style="height:40px"
 
|1. " valign="top" align="center" width="100"  | '''<nowiki><style></nowiki>'''
 
|2. " valign="top" align="left" width="300" | <br>Used to add CSS style, e.g.: <br> - '''Underline the text''' <hr/> <br>- '''Align the text'''<hr/> - '''Change the size of the text'''. <br>
 
|3. " valign="top" align="left" width="300" | <br> <nowiki><p style="text-decoration: underline;"> Underlined text </p></nowiki> <hr/> <nowiki><p style="text-align: center;">This text is in the center.</p> </nowiki> <hr/> <nowiki> <p style="font-size:12px">This text size is 12 px.</p></nowiki>
 
|4. " valign="top" align="center" width="300" | <br> [[File:Underlined.png|125px]] <br> [[File:Centre.png|175px]]<br>[[File:Font.png|125px]]
 
 
 
|}
 
 
 
For text to start from a new page - <nowiki><p style="clear: both; display: block; page-break-after: always;"></p></nowiki>
 
  
 +
Choose the template from the drop-down list and click '''"Update"''':
  
 +
[[File:Update vendor invoice2.png|border|1000px]]
  
That's the example on how your invoice can look like:
+
[[File:Redirect.jpg|40px|link=PDF templates]] Back to the '''table of contents'''.
  
[[File:Common notes html example2.png|700px]] [[File:Common notes html example1.png|border|500px]]
+
=='''Quote PDF templates'''==
  
<span style="color:red">Note:</span> please avoid this sign '''&''' because the system doesn't allow to save the common note.
+
To create the quote PDF template, go to '''Settings → PDF Templates → Quote''':
  
[[File:Redirect.jpg|40px|link=Common notes]] Back to the '''table of contents'''.
+
[[File:Settings - pdf templates - quote.png|border|280px]]
  
=='''PDF Templates'''==
+
Click '''"New PDF Template"''':
  
<span style="color:red">Described features will be available with the forthcoming system release.</span>
+
[[File:New quote pdf template.png|border|1000px]]
  
You can create PDF templates for client invoices, vendor invoices, quotes, and job PO.
+
Fill in the fields, select the needed options and click '''"Create"''':
 
 
PDF templates text can contain valid XHTML 1.0 markup. Allowed XHTML elements: a, b, br, div, h1, h2, h3, h4, h5, h6, hr, i, li, ol, p, span, ul. Allowed attributes: href, style.
 
 
 
To create a template, go to '''Settings → PDF Templates:'''
 
 
 
[[File:PDF templates.png|border|300px]]
 
 
 
You always can clone, update or delete the templates:
 
 
 
[[File:Client invoice pdf templates+.png|border|1000px]]
 
 
 
=='''Client invoice PDF templates'''==
 
 
 
To create the client invoice PDF template, go to '''Settings → PDF Templates → Client invoice''':
 
 
 
[[File:PDF templates - client invoice.png|border|300px]]
 
 
 
Click '''"New PDF template"''':
 
 
 
[[File:2 client cn.png|border|900px]]
 
 
 
Fill in the fields, select the needed options and click "Create":
 
  
 
[[File:New cl invoice pdf template2.png|border|1000px]]
 
[[File:New cl invoice pdf template2.png|border|1000px]]
  
*'''Name''' — a name of the template;
+
*'''Name''' — the name of the template;
  
*'''Page size''' — select whether the page size is A4 or a letter size;
+
*'''Page size''' — select A4 or a letter size;
  
 
*'''Page orientation''' — select the portrait or landscape page orientation;
 
*'''Page orientation''' — select the portrait or landscape page orientation;
  
*'''Top margin, mm''' — select the top margin height in millimeters;
+
*'''Top margin, mm''' — the top margin height in millimeters;
  
*'''Bottom margin, mm''' — select the bottom margin height in millimeters;
+
*'''Bottom margin, mm''' — the bottom margin height in millimeters;
  
*'''Locale''' - locale defines the language of the template text;
+
*'''Locale''' locale defines the language of the template text;
  
*'''Page header''' — a text that appears at the top of the page;
+
*'''Page header''' — the text that appears at the top of the page;
  
*'''Page footer''' — a text that appears at the bottom of the page;
+
*'''Page footer''' — the text that appears at the bottom of the page;
  
*'''Common note''' — a text that appears after the payment method description;
+
*'''Common note''' — this field is used for any additional notes;
  
You can define a default client invoice PDF template that will be applied to invoices for all the new clients.
+
*'''Include CAT log details''' — unmark this checkbox if you want to remove CAT log details from the PDF template.
 +
 
 +
You can define a default quote PDF template that will be selected automatically when creating quotes.
  
Go to the '''Account''' page, scroll down to the Default settings, and click '''"Update"''':
+
Go to the '''Account''' page, scroll down to the '''Account settings''' section and click '''"Update"''':
  
[[File:Default common note.png|border|900px]]
+
[[File:Define default quote template.png|border|1000px]]
  
 
Select the needed one from the drop-down list and click '''"Update"''':
 
Select the needed one from the drop-down list and click '''"Update"''':
  
[[File:Account settings cl invoice+.png|border|1000px]]
+
[[File:Update account settings (quote).png|border|1000px]]
 
 
You can also select the default client invoice PDF template for each client.
 
 
 
Go to the needed client profile, scroll down to the Settings section and click '''"Update"''':
 
 
 
[[File:Client profile setting section.png|border|1000px]]
 
 
 
Select the template from the drop-down list and click '''"Update"''':
 
  
[[File:Client profile settings section1.png|border|1000px]]
+
You can select the PDF template for the quote when you create it.
  
If needed, you can select the template for a specific client invoice. Open the needed invoice and click '''"Update"''':
+
If needed, you can select the template for a specific quote. Open the needed quote and click '''"Update"''':
  
[[File:Update client invoice.png|border|1000px]]
+
[[File:Update quote (pdf template).png|border|1000px]]
  
 
Choose the template from the drop-down list, and click '''"Update"''':
 
Choose the template from the drop-down list, and click '''"Update"''':
  
[[File:Update cl invoice2.png|border|1000px]]
+
[[File:Update quote2.png|border|1000px]]
  
[[File:Redirect.jpg|40px|link=Common notes]] Back to the '''table of contents'''.
+
[[File:Redirect.jpg|40px|link=PDF templates]] Back to the '''table of contents'''.
  
=='''Vendor invoice PDF templates'''==
+
=='''Job PO PDF templates'''==
  
To add the vendor invoice PDF templates, go to '''Settings → PDF Templates Vendor invoice''':
+
To add the job PO PDF templates, go to '''Settings → PDF templates Job PO''':
  
[[File:PDF templates - vendor invoice.png|border|300px]]
+
[[File:Settings - pdf templates - job PO.png|border|280px]]
  
Click '''"New PDF template"''':
+
Click '''"New PDF Template"''':
  
[[File:New vendor invoice PDF templates.png|border|1000px]]
+
[[File:New PDF template (job po).png|border|1000px]]
  
Fill in the fields, select the needed options and click "Create":
+
Fill in the fields, select the needed options and click '''"Create"''':
  
 
[[File:New cl invoice pdf template2.png|border|1000px]]
 
[[File:New cl invoice pdf template2.png|border|1000px]]
  
*'''Name''' — a name of the template;
+
*'''Name''' — the name of the template;
  
*'''Page size''' — select whether the page size is A4 or a letter size;
+
*'''Page size''' — select A4 or a letter size;
  
 
*'''Page orientation''' — select the portrait or landscape page orientation;
 
*'''Page orientation''' — select the portrait or landscape page orientation;
  
*'''Top margin, mm''' — select the top margin height in millimeters;
+
*'''Top margin, mm''' — the top margin height in millimeters;
 +
 
 +
*'''Bottom margin, mm''' — the bottom margin height in millimeters;
  
*'''Bottom margin, mm''' — select the bottom margin height in millimeters;
+
*'''Locale''' — locale defines the language of the template text;
  
*'''Locale''' - locale defines the language of the template text;
+
*'''Page header''' the text that appears at the top of the page;
  
*'''Page header''' — a text that appears at the top of the page;
+
*'''Page footer''' — the text that appears at the bottom of the page;
  
*'''Page footer''' — a text that appears at the bottom of the page;
+
*'''Common note''' — this field is used for any additional notes;
  
*'''Common note''' — a text that appears after the payment method description;
+
*'''Include CAT log details''' — unmark this checkbox if you want to remove CAT log details from the PDF template.
  
You can define a default vendor invoice PDF template that will be applied to invoices for all the new vendors.
+
You can define a default job PO PDF template that will be applied to every job PO you create.
  
Go to the '''Account''' page, scroll down to the Default settings, and click '''"Update"''':
+
Go to the '''Account''' page, scroll down to the '''Account settings''' section, and click '''"Update"''':
  
[[File:Account settings - def v invoice template.png|border|1000px]]
+
[[File:Account settings (job po).png|border|1000px]]
  
 
Select the needed one from the drop-down list and click '''"Update"''':
 
Select the needed one from the drop-down list and click '''"Update"''':
  
[[File:2c2 vcm.png|border|900px]]
+
[[File:Update account settings (job po)2.png|border|1000px]]
 
 
You can update the common vendor invoice note in invoices. Open the needed invoice and press '''"Update"''':
 
 
 
[[File:Screenshot 9.png|border|900px]]
 
 
 
Choose the needed invoice common note from the drop-down list, and press '''"Update"''':
 
 
 
[[File:Sccreenshot 8.png|border|600px]]
 
 
 
[[File:Redirect.jpg|40px|link=Common notes]] Back to the '''table of contents'''.
 
 
 
=='''Quote common notes'''==
 
 
 
To add the quote common notes, go to '''Settings → Common notes → Quote''':
 
 
 
[[File:Quote common note.png|border|300px]]
 
 
 
Press '''"New common note"''':
 
 
 
[[File:Screenffshot 2.png|border|900px]]
 
 
 
Enter the name, the comment, and press '''"Create"''':
 
  
[[File:Screeddnshot 3.png|border|900px]]
+
You can also select the job PO PDF template for the job when you create it.
  
You can define a default quote common note that will be added to every quote you create.  
+
If needed, you can select the job PO template for a specific job. Open the needed job and click "Update":
  
Go to the '''Account''' page, scroll down to the Default settings, and press '''"Update"''':
+
[[File:Update job (select PO template)1.png|border|1000px]]
  
[[File:1 upd fef comm.png|border|900px]]
+
Choose the needed job PO PDF template from the drop-down list and click '''"Update"''':
  
From the drop-down list choose the needed one, and press '''"Update"''':
+
[[File:Update job (select PO template).png|border|1000px]]
  
[[File:Screednddshot 4.png|border|600px]]
+
[[File:Redirect.jpg|40px|link=PDF templates]] Back to the '''table of contents'''.
  
==='''Add a quote common note'''===
+
=='''Add images'''==
  
You can update the common quote note in the needed quote when you create it.
+
''PDF template images page: [https://cloud.protemos.com/pdf-image-file/index cloud.protemos.com/pdf-image-file/index]''
 +
----
  
You also can add the common not by pressing the '''"Update"''':
+
This functionality can be used for adding signatures, seals, payment systems logos, etc. to your PDF templates.
  
[[File:Screejjlnshot 4.png|border|900px]]
+
To add images to your templates, go to the '''PDF images''' page first:
  
Choose the needed quote common note from the drop-down list, and press '''"Update"''':
+
[[File:Settings - pdf templates - pdf images+.png|border|270px]]
  
[[File:Screeasdnshot 5.png|border|600px]]
+
Click the '''"New PDF image"''' button:
  
[[File:Redirect.jpg|40px|link=Common notes]] Back to the '''table of contents'''.
+
[[File:Pdf template images+.png|border|1070px]]
  
=='''Job PO common notes'''==
+
Fill in the name, select a needed image, then click '''"Create"''':
  
To add the job PO common notes, go to '''Settings → Common notes → Job PO''':
+
[[File:Upload image.1.png|border|1070px]]
  
[[File:1 common note.png|border|300px]]
+
The uploaded image will be displayed on the '''PDF template images''' page, and you will be able to add it to the templates:
  
Press '''"New common note"''':
+
[[File:Uploaded images list.png|border|1070px]]
  
[[File:Scrcsdeenshot 1.png|border|900px]]
+
Find the needed template and click '''"Update"''':
  
Enter the name, the comment, and press '''"Create"''':
+
[[File:Update the template.png|border|1070px]]
  
[[File:Screenvvvvvshot 2.png|border|900px]]
+
To add the image, please use the corresponding HTML markup elements and attributes: '''<img src="{IMAGE:visa_logo}" alt=""/>'''
  
You can define a default job PO common note that will be added to every job you create.
+
[[File:Add image to template (html).png|border|1070px]]
  
Go to the '''Account''' page, scroll down to the Default settings, and press '''"Update"''':
+
This is what the added images will look like on the PDF file:
  
[[File:Updsfefate.png|border|900px]]
+
[[File:Pdf example.png|border|650px]]
  
From the drop-down list choose the needed one, and press '''"Update"''':
+
==='''Download, update and delete images'''===
  
[[File:Screensaswfhot 3.png|border|600px]]
+
You can also download, change the name and choose another image or delete images by clicking the corresponding buttons:
  
You can update the common job PO note for the needed job when you create it.  
+
[[File:Download, update and delete images.png|border|1070px]]
  
Or open already created job and press '''"Update"''':
+
<span style="color:orange">'''Note:'''</span> Images that are already used in templates cannot be deleted, but you can replace the uploaded image so that its name and URL macro stay the same. To do so, click '''"Update"''':  
  
[[File:Scdrreenshot 6.png|border|900px]]
+
[[File:Update uploaded image.png|border|1070px]]
  
Choose the needed job PO common note from the drop-down list, and press '''"Update"''':
+
Click '''"Choose file"''', select the needed image and click '''"Update"''':
  
[[File:Screenshot 7.png|border|450px]]
+
[[File:Update uploaded image+.png|border|1070px]]
 
 
[[File:Redirect.jpg|40px|link=Common notes]] Back to the '''table of contents'''.
 
  
 
=='''XHTML elements and attributes'''==
 
=='''XHTML elements and attributes'''==
Line 490: Line 314:
 
|1. " valign="top" align="center" width="100"  |  '''<nowiki><a href></nowiki>'''  
 
|1. " valign="top" align="center" width="100"  |  '''<nowiki><a href></nowiki>'''  
 
|2. " valign="top" align="left" width="300" | The <a> tag defines a hyperlink, which is used to link from one page to another. The most important attribute of the <a> element is the href attribute, which indicates the link's destination.  
 
|2. " valign="top" align="left" width="300" | The <a> tag defines a hyperlink, which is used to link from one page to another. The most important attribute of the <a> element is the href attribute, which indicates the link's destination.  
|3. " valign="top" align="left" width="300" | <nowiki><a href="protemos.com">Visit my website</a></nowiki>
+
|3. " valign="top" align="left" width="300" | <nowiki><a href="https://protemos.com">Visit my website</a></nowiki>
 
<br> <nowiki><a href="mailto:as@protemos.com">as@protemos.com</a></nowiki>
 
<br> <nowiki><a href="mailto:as@protemos.com">as@protemos.com</a></nowiki>
  
Line 504: Line 328:
 
|1. " valign="top" align="center" width="100"  | '''<nowiki><br/></nowiki>'''  
 
|1. " valign="top" align="center" width="100"  | '''<nowiki><br/></nowiki>'''  
 
|2. " valign="top" align="left" width="300" | The tag inserts a single line break.
 
|2. " valign="top" align="left" width="300" | The tag inserts a single line break.
 +
To add a blank line, use this tag twice.
 
|3. " valign="top" align="left" width="300" | <nowiki><br/></nowiki>
 
|3. " valign="top" align="left" width="300" | <nowiki><br/></nowiki>
  
Line 582: Line 407:
 
  |}
 
  |}
  
For text to start from a new page - <nowiki><p style="clear: both; display: block; page-break-after: always;"></p></nowiki>
+
* If you need to adjust the text in various ways (for instance, change its color and center it), please input the XHTML elements in the following way<nowiki>: <p style=</nowiki>'''"color:orange; text-align: center;"'''<nowiki> >If you have any questions about this invoice, please  <a href="protemos.com">  contact us.</a> </p> </nowiki>
 
 
  
 +
* For text to start from a new page: <nowiki><p style="clear: both; display: block; page-break-after: always;"></p></nowiki>
  
That's the example on how your invoice can look like:
+
That's an example of how your invoice can look like:
  
[[File:Common notes html example2.png|700px]] [[File:Common notes html example1.png|border|500px]]
+
[[File:Invoice pdf template example.2.png|border|900px]] [[File:Invoice example.1.1.png|border|700px]]
  
<span style="color:red">Note:</span> please avoid this sign '''&''' because the system doesn't allow to save the common note.
+
<span style="color:orange">'''Note:'''</span> please avoid this sign '''&''' because the system doesn't allow to save the common note.
  
[[File:Redirect.jpg|40px|link=Common notes]] Back to the '''table of contents'''.
+
[[File:Redirect.jpg|40px|link=PDF templates]] Back to the '''table of contents'''.

Latest revision as of 12:28, 24 November 2023

PDF Templates

You can create PDF templates for client invoices, vendor invoices, quotes, and job PO.

PDF templates text can contain valid XHTML 1.0 markup. Allowed XHTML elements: a, b, br, div, h1, h2, h3, h4, h5, h6, hr, i, li, ol, p, span, ul. Allowed attributes: href, style.

To create a template, go to Settings → PDF Templates:

Settings - pdf templates.png

You always can clone, update or delete the templates:

Client invoice pdf templates+.png

Client invoice PDF templates

To create the client invoice PDF template, go to Settings → PDF Templates → Client invoice:

Settings - pdf templates - client invoice.png

Click "New PDF template":

New pdf template (client invoice).png

Fill in the fields, select the needed options and click "Create":

New cl invoice pdf template2.png

  • Name — the name of the template;
  • Page size — select A4 or a letter size;
  • Page orientation — select the portrait or landscape page orientation;
  • Top margin, mm — the top margin height in millimeters;
  • Bottom margin, mm — the bottom margin height in millimeters;
  • Locale — locale defines the language of the template text;
  • Page header — the text that appears at the top of the page;
  • Page footer — the text that appears at the bottom of the page;
  • Common note — this field is used for any additional notes;
  • Include CAT log details — unmark this checkbox if you want to remove CAT log details from the PDF template.

You can define a default client invoice PDF template that will be applied to invoices for all the new clients.

Go to the Account page, scroll down to the Account settings, and click "Update":

Account settings (client invoice template).png

Select the needed one from the drop-down list and click "Update":

Update account settings+.png

You can also select the default client invoice PDF template for a particular client.

Go to the needed client profile, scroll down to the Settings section and click "Update":

Client profile setting section.png

Select the template from the drop-down list and click "Update":

Client profile settings section1.png

If needed, you can select the template for a specific client invoice. Open the needed invoice and click "Update":

Update client invoice.png

Choose the template from the drop-down list and click "Update":

Update cl invoice2.png

Redirect.jpg Back to the table of contents.

Vendor invoice PDF templates

To add the vendor invoice PDF templates, go to Settings → PDF Templates → Vendor invoice:

Settings - pdf templates - vendor invoice.png

Click "New PDF template":

New vendor invoice PDF templates.png

Fill in the fields, select the needed options and click "Create":

New cl invoice pdf template2.png

  • Name — the name of the template;
  • Page size — select A4 or a letter size;
  • Page orientation — select the portrait or landscape page orientation;
  • Top margin, mm — the top margin height in millimeters;
  • Bottom margin, mm — the bottom margin height in millimeters;
  • Locale — locale defines the language of the template text;
  • Page header — the text that appears at the top of the page;
  • Page footer — the text that appears at the bottom of the page;
  • Common note — this field is used for any additional notes;
  • Include CAT log details — unmark this checkbox if you want to remove CAT log details from the PDF template.

You can define a default vendor invoice PDF template that will be applied to invoices for all the new vendors.

Go to the Account page, scroll down to the Account settings, and click "Update":

Account settings - def v invoice template.png

Select the needed one from the drop-down list and click "Update":

Update account settings (v invoice).png

You can also select the default vendor invoice PDF template for each vendor.

Go to the needed vendor profile, scroll down to the Settings section and click "Update":

Update vendor profile+.png

Select the template from the drop-down list and click "Update":

Update vendor profile+1.png

If needed, you can select the template for a specific vendor invoice. Open the needed invoice and click "Update":

Update vendor invoice.png

Choose the template from the drop-down list and click "Update":

Update vendor invoice2.png

Redirect.jpg Back to the table of contents.

Quote PDF templates

To create the quote PDF template, go to Settings → PDF Templates → Quote:

Settings - pdf templates - quote.png

Click "New PDF Template":

New quote pdf template.png

Fill in the fields, select the needed options and click "Create":

New cl invoice pdf template2.png

  • Name — the name of the template;
  • Page size — select A4 or a letter size;
  • Page orientation — select the portrait or landscape page orientation;
  • Top margin, mm — the top margin height in millimeters;
  • Bottom margin, mm — the bottom margin height in millimeters;
  • Locale — locale defines the language of the template text;
  • Page header — the text that appears at the top of the page;
  • Page footer — the text that appears at the bottom of the page;
  • Common note — this field is used for any additional notes;
  • Include CAT log details — unmark this checkbox if you want to remove CAT log details from the PDF template.

You can define a default quote PDF template that will be selected automatically when creating quotes.

Go to the Account page, scroll down to the Account settings section and click "Update":

Define default quote template.png

Select the needed one from the drop-down list and click "Update":

Update account settings (quote).png

You can select the PDF template for the quote when you create it.

If needed, you can select the template for a specific quote. Open the needed quote and click "Update":

Update quote (pdf template).png

Choose the template from the drop-down list, and click "Update":

Update quote2.png

Redirect.jpg Back to the table of contents.

Job PO PDF templates

To add the job PO PDF templates, go to Settings → PDF templates → Job PO:

Settings - pdf templates - job PO.png

Click "New PDF Template":

New PDF template (job po).png

Fill in the fields, select the needed options and click "Create":

New cl invoice pdf template2.png

  • Name — the name of the template;
  • Page size — select A4 or a letter size;
  • Page orientation — select the portrait or landscape page orientation;
  • Top margin, mm — the top margin height in millimeters;
  • Bottom margin, mm — the bottom margin height in millimeters;
  • Locale — locale defines the language of the template text;
  • Page header — the text that appears at the top of the page;
  • Page footer — the text that appears at the bottom of the page;
  • Common note — this field is used for any additional notes;
  • Include CAT log details — unmark this checkbox if you want to remove CAT log details from the PDF template.

You can define a default job PO PDF template that will be applied to every job PO you create.

Go to the Account page, scroll down to the Account settings section, and click "Update":

Account settings (job po).png

Select the needed one from the drop-down list and click "Update":

Update account settings (job po)2.png

You can also select the job PO PDF template for the job when you create it.

If needed, you can select the job PO template for a specific job. Open the needed job and click "Update":

Update job (select PO template)1.png

Choose the needed job PO PDF template from the drop-down list and click "Update":

Update job (select PO template).png

Redirect.jpg Back to the table of contents.

Add images

PDF template images page: cloud.protemos.com/pdf-image-file/index


This functionality can be used for adding signatures, seals, payment systems logos, etc. to your PDF templates.

To add images to your templates, go to the PDF images page first:

Settings - pdf templates - pdf images+.png

Click the "New PDF image" button:

Pdf template images+.png

Fill in the name, select a needed image, then click "Create":

Upload image.1.png

The uploaded image will be displayed on the PDF template images page, and you will be able to add it to the templates:

Uploaded images list.png

Find the needed template and click "Update":

Update the template.png

To add the image, please use the corresponding HTML markup elements and attributes: <img src="{IMAGE:visa_logo}" alt=""/>

Add image to template (html).png

This is what the added images will look like on the PDF file:

Pdf example.png

Download, update and delete images

You can also download, change the name and choose another image or delete images by clicking the corresponding buttons:

Download, update and delete images.png

Note: Images that are already used in templates cannot be deleted, but you can replace the uploaded image so that its name and URL macro stay the same. To do so, click "Update":

Update uploaded image.png

Click "Choose file", select the needed image and click "Update":

Update uploaded image+.png

XHTML elements and attributes

TAG DESCRIPTION EXAMPLE VIEW
<a href> The <a> tag defines a hyperlink, which is used to link from one page to another. The most important attribute of the <a> element is the href attribute, which indicates the link's destination. <a href="https://protemos.com">Visit my website</a>


<a href="mailto:as@protemos.com">as@protemos.com</a>

1 V.png
<b> The tag specifies bold text without any extra importance. <b>This text is bold</b> 2 B.png
<br/> The tag inserts a single line break.

To add a blank line, use this tag twice.

<br/>
<div> Defines a division part. It's a block-level element <div style="text-align: center;">This text is in the center.</div> Centre.png
<h1> to <h6> Defines Headings level from 1 to 6 different sizes. <h1 style="color:blue;">This is a heading</h1> 3 H.png
<hr> Represents a thematic break between paragraph-level tags. It is typically drawn horizontal line. <hr/> 1 line.png
<i> The content inside is typically displayed in italic. <i>This text is italic</i> 4 I.png
<li> The tag defines a list item. The <li> tag is used inside ordered lists(<ol>), unordered lists (<ul>) <ol> <li>Quote</li> <li>Project</li> <li>Job</li> </ol> 8Q.png
<ol> The tag defines an ordered list. An ordered list can be numerical or alphabetical. The <li> tag is used to define each list item. <ol> <li>Quote</li> <li>Project</li> <li>Job</li> </ol> 8Q.png
<p> The tag defines a paragraph. <p>This project is due <span style="color: red;">30 days</span>.</p> 1 th.png
<span> The tag is an inline container used to mark up a part of a text, or a part of a document. The tag is much like the <div> element, but <div> is a block-level element and is an inline element. <p>This is a <span style="color:blue;"> paragraph</span>.</p> 5. P.png
<ul> The tag defines an unordered (bulleted) list. Use the <ul> tag together with the <li> tag to create unordered lists. <ul> <li>Quote</li> <li>Project</li> <li>Job</li> </ul> 6. Q.png
<style>
Used to add CSS style, e.g.:
- Underline the text

- Align the text
- Change the size of the text.

<p style="text-decoration: underline;"> Underlined text </p>
<p style="text-align: center;">This text is in the center.</p>
<p style="font-size:12px">This text size is 12 px.</p>

Underlined.png
Centre.png
Font.png
  • If you need to adjust the text in various ways (for instance, change its color and center it), please input the XHTML elements in the following way: <p style="color:orange; text-align: center;" >If you have any questions about this invoice, please <a href="protemos.com"> contact us.</a> </p>
  • For text to start from a new page: <p style="clear: both; display: block; page-break-after: always;"></p>

That's an example of how your invoice can look like:

Invoice pdf template example.2.png Invoice example.1.1.png

Note: please avoid this sign & because the system doesn't allow to save the common note.

Redirect.jpg Back to the table of contents.