This manual is deprecated. Please visit https://groupoffice.readthedocs.io for the latest documentation.

Project PDF templates

From Group-Office Groupware and CRM Documentation
Revision as of 15:43, 14 January 2010 by Admin (Talk | contribs) (Special tables)

Jump to: navigation, search

To customize reports in the projects module go to:

Projects → Administration → Report templates → Template → Pages

Doubleclick a page to edit or add one.

You can simply type text in the page and add smart tags by clicking on a tag at the right pane. Custom fields for the project or report template may also be used. You could add for example:

The project we are reporting here is called {name} and started at {start_time|from_unixdate}.

All the tags from the panel on the right come from the project or report template. The |from_unixtime modifier converts the database timestamp to a readable date.

Tag modifiers

The following modifiers are available:

You can add paramters like this:

{var|from_unixtime:0}

Tagname Parameters Description
from_unixtime bool with time or just the date Convert unix timestamp to date
Number int decimals Format a number from the database

Getting totals

In a lot of cases you want to sum up expenses, hours etc. You can do this with the {totalize} tag.

{totalize fields="period_expenses,total_expenses,total_count,period_count" templates="Project, Travel costs"}

The fields can have a number of field names that will be avialble as tags after the totalize tags. The example above will calcualte the total expenses and total count of projects with template name “Project” or “Travel costs”. The templates attribute is not mandatory. If you omit it it will calculate it for all project templates. The new tags that will be available are {period_expenses}, {total_expenses} etc.

The fields that are available for the totalize tags are:

period_expenses Calculates the total expenses for the reporting period
total_expenses Calclates the total expenses for all time
total_count Calculates the total number of projects for the reporting period
period_count Calclates the total expenses for all time

You can also do the same for custom fields. This works in the same way as the totalize tags:

{totalize_customfields fields="col_76,col_78" templates=""}

This will create {total_col_76} and {period_col_76}. The custom field database names can be looked up at the custom fields module or inserted with the panel on the right.

HTML markup

You can use simple HTML markup within {html}{/html} tags.

For example:

{html}
<table border="0" cellpadding="2">
<tr>
<td colspan="2">
<span style="color:#7da541;font-size:12px">Project information<br /></span>
</td>
</tr>
<tr>
<td width="70">Name:</td>
<td>{path}</td>
</tr>
<tr>
<td width="70">Status:</td>
<td>{status_name}</td>
</tr>
<tr>
<td width="70">Starts:</td>
<td>{start_time|from_unixtime:0}</td>
</tr>
<tr>
<td width="70">Ends:</td>
<td>{due_time|from_unixtime:0}</td>
</tr>
<tr>
<td width="70">
Description:</td>
<td>
{description|to_html}
</td>
</tr>
</table>

<br /><br />
{/html}

Special tables

Group-Office can draw some special tables with data from the database. Here are some examples:

comments

{htmltable type="comments" border="0" cellpadding="2"}
{thead}
<tr><td colspan="2"><span style="color:#7da541;font-size:12px">Comments</span></td>
</tr>
{/thead}
{row}
<tr>
<td>{user_name} wrote on {ctime|from_unixdate}: <em>{comments|to_html}</em></td>
</tr>
{/row}
{/htmltable}

tasks

{html}
<br /><br />
<span style="color:#7da541;font-size:12px">Tasks</span><br />
{/html}
{htmltable type="tasks" due_in_period="false" complete="0" border="1" cellpadding="2"}
{thead}
<tr>
<td>Name</td>
<td>Due at</td>
</tr>
{/thead}
{row}
<tr>
<td><em>{name}</em></td>
<td><em>{due_time|from_unixdate}</em></td>
</tr>
{/row}
{/htmltable}

timeregistration

{font size="8" line-height-ratio="1.5"}

{totalize fields="period_hours"}

{math sum="period_hours_amount / period_hours_units" assign="fee"}

{html}
<br />
<table width="200">
<tr>
<td>Total amount:</td><td>€ {period_hours_amount|number}</td>
</tr>
<tr>
<td>Total units:</td><td>{period_hours_units}</td>
</tr>
<tr>
<td>Amount per unit:</td><td>€ {fee|number}</td>
</tr>
</table>

<br />
{/html}

{html}
<span style="color:#7da541;font-size:12px">Hours per project<br /></span
{/html}
{htmltable type="hours_by_project" border="1" width="700" cellpadding="2"}
{thead}
<tr style="font-weight:bold;">
<td width="100">Project</td>
<td colspan="3">Total</td>
</tr>
<tr>
<td width="100"></td>
<td>D</td>
<td>U</td>
<td>€</td>
</tr>
{/thead}

{row}
<tr nobr="true">
<td width="100">{path}</td>
<td align="right">{units|number:0}</td>
<td align="right">{amount|number:0}</td>{/monthcol}
<td align="right">{days|number:0}</td>
<td align="right">{units|number:0}</td>
<td align="right">{amount|number:0}</td>
</tr>
{/row}

{sum}
<tr nobr="true" style="font-weight:bold">
<td width="100">Total:</td>
<td align="right">{total_units|number:0}</td>
<td align="right">{total_amount|number:0}</td>{/monthcol}
<td align="right">{total_days|number:0}</td>
<td align="right">{total_units|number:0}</td>
<td align="right">{total_amount|number:0}</td>
</tr>
{/sum}

{/htmltable}

{html}
<span style="color:#7da541;font-size:12px"><br />Hours per user<br /></span>
{/html}


{htmltable type="hours_by_user" border="1" width="700" cellpadding="2"}
{thead}
<tr style="font-weight:bold;">
<td width="100">User</td>
<td colspan="3">Total</td>
</tr>
<tr>
<td width="100"></td>
<td>D</td>
<td>U</td>
<td>€</td>
</tr>
{/thead}

{row}
<tr nobr="true">
<td width="100">{user_name},{user_id}</td>
<td align="right">{units|number:0}</td>
<td align="right">{amount|number:0}</td>{/monthcol}
<td align="right">{days|number:0}</td>
<td align="right">{units|number:0}</td>
<td align="right">{amount|number:0}</td>
</tr>
{/row}

{sum}
<tr nobr="true" style="font-weight:bold">
<td width="100">Total:</td>
<td align="right">{total_units|number:0}</td>
<td align="right">{total_amount|number:0}</td>{/monthcol}
<td align="right">{total_days|number:0}</td>
<td align="right">{total_units|number:0}</td>
<td align="right">{total_amount|number:0}</td>
</tr>
{/sum}

{/htmltable}