[IMP] report_webkit: improved description and added hint about static lib on Linux

bzr revid: odo@openerp.com-20111027150809-kynbj1ycwbzbfalg
This commit is contained in:
Olivier Dony
2011-10-27 17:08:09 +02:00
parent 5136b88771
commit 4223622f1f
2 changed files with 49 additions and 35 deletions
+33 -23
View File
@@ -38,38 +38,48 @@ This module adds a new Report Engine based on WebKit library (wkhtmltopdf) to su
The module structure and some code is inspired by the report_openoffice module.
The module allows:
-HTML report definition
-Multi header support
-Multi logo
-Multi company support
-HTML and CSS-3 support (In the limit of the actual WebKIT version)
-JavaScript support
-Raw HTML debugger
-Book printing capabilities
-Margins definition
-Paper size definition
- HTML report definition
- Multi header support
- Multi logo
- Multi company support
- HTML and CSS-3 support (In the limit of the actual WebKIT version)
- JavaScript support
- Raw HTML debugger
- Book printing capabilities
- Margins definition
- Paper size definition
... and much more
Multiple headers and logos can be defined per company.
CSS style, header and footer body are defined per company
The library to install can be found here
http://code.google.com/p/wkhtmltopdf/
The system libraries are available for Linux, Mac OS X i386 and Windows 32.
After installing the wkhtmltopdf library on the OpenERP Server machine, you need to set the
path to the wkthtmltopdf executable file on the Company.
CSS style, header and footer body are defined per company.
For a sample report see also the webkit_report_sample module, and this video:
http://files.me.com/nbessi/06n92k.mov
Requirements and Installation
-----------------------------
This module requires the ``wkthtmltopdf`` library to render HTML documents as
PDF. Version 0.9.9 or later is necessary, and can be found at http://code.google.com/p/wkhtmltopdf/
for Linux, Mac OS X (i386) and Windows (32bits).
After installing the library on the OpenERP Server machine, you need to set the
path to the ``wkthtmltopdf`` executable file on each Company.
If you are experiencing missing header/footer problems on Linux, be sure to
install a "static" version of the library. The default ``wkhtmltopdf`` on
Ubuntu is known to have this issue.
TODO
----
* JavaScript support activation deactivation
* Collated and book format support
* Zip return for separated PDF
* Web client WYSIWYG
TODO :
JavaScript support activation deactivation
Collated and book format support
Zip return for separated PDF
Web client WYSIWYG
""",
"version" : "0.9",
"depends" : ["base"],
+16 -12
View File
@@ -33,24 +33,28 @@ from osv import fields, osv
class ResCompany(osv.osv):
"""Override company to add Header object link a company can have many header and logos"""
_inherit = "res.company"
_columns = {
'header_image' : fields.many2many(
'ir.header_img',
'company_img_rel',
'company_id',
'img_id',
'ir.header_img',
'company_img_rel',
'company_id',
'img_id',
'Available Images',
),
'header_webkit' : fields.many2many(
'ir.header_webkit',
'company_html_rel',
'company_id',
'html_id',
'ir.header_webkit',
'company_html_rel',
'company_id',
'html_id',
'Available html',
),
'lib_path' : fields.char('Webkit Executable Path', size=264, help="Complete (Absolute) path to the wkhtmltopdf executable."),
'lib_path' : fields.char('Webkit Executable Path', size=264,
help="Full path to the wkhtmltopdf executable file. "
"Version 0.9.9 is required. Install a static version "
"of the library if you experience missing header/footers "
"on Linux."),
}
ResCompany()
}
ResCompany()