Vacation Planner 0.1alpha (Alpha release) (Aug 19, 2005)

This is not a final release. Experimental releases should only be used for testing and development. Do not use these on production sites, and make sure you have proper backups before installing.

First release.

For additional information about this project, please visit the overview page .

Available downloads

Release Notes

Tested with	Plone 2.0.5
State	Alpha release
License	GPL

LICENSE

• GPL: See VacationPlanner.py header.

CREDITS

• Follows the general design of GeologicTimeScale, and TeachingSchedule, and comes out of a need for examples for a talk given at the 2005 North American Plone Symposium in July 2005.
• SVG all around help, http://www.carto.net
• SVG emitting, http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/325823
• ReportLab toolkit and examples

AUTHORSHIP

• initial coding: Jeff Pittman, http://www.geojeff.org

DESCRIPTION

VacationPlanner uses the ReportLab toolkit to generate a vacation calendar plot in various rendering targets and uses its own rendering routines to directly generate SVG and other targets.

VacationPlanner is a folderish Archetypes-based Plone/Zope product. The idea is to use various renderers to create images, PDF files, and/or SVG versions of the vacation planner and store them. This allows flexibility for a user of VacationPlanner to offer several format versions, if needed, and to experiment with rendering choices before deciding on the best one for the specific usage.

VacationPlanner takes input of the following items:

• image size (width and height, in pixels)
• position (x and y of upper left corner, in pixels)
• a setting for scale-to-fit
• vacations, entered as comma-separated values on separate lines for the vacations. Vacations are specified by:
  • username
  • realname
  • groupname
  • year
  • month
  • day
  • day portion (morning, evening, all day)
  • reason
  • red, green, blue (each 0-255)

REQUIREMENTS

• Archetypes (tested with Archetypes-1.3.2-final bundle)
• Plone (tested with Plone-2.0.5)
• PIL (Python Imaging Library), http://www.pythonware.com/products/pil
• ReportLab Toolkit, from http://www.reportlab.org (tested with v. 1.20)
• renderPM, from the ReportLab Toolkit, as an addon module, from: http://www.reportlab.org (renderPM provides the full functionality for formats other than ps and pdf)
• Adobe Acrobat Reader, for fonts, from http://www.adobe.com/products/acrobat/readstep2.html. On Linux, v. 5 works; the new v. 7 doesn't contain Times-Roman font used.

PLATFORM NOTES

• So far, testing has only been done on Linux.

INSTALLATION

1. Install Adobe Acrobat Reader, taking note of its installation directory.
2. Install the ReportLab toolkit, first editing rl_config.py in the reportlab directory to set the Acrobat directory, if needed, so the fonts will be found by the renderer.
3. Install the renderPM addon from ReportLab.org.
4. Put VacationPlanner in your Zope Products directory.
5. Restart Zope.
6. Install VacationPlanner into your Plone site using CMFQuickInstaller. (In Plone, select "plone setup", click on "Add/Remove Products" and install VacationPlanner.) You can also use the portal_quickinstaller tool from the ZMI to install the Product.

TO DO

• Experiment with different fonts that don't degrade badly at small size.
• Experiment with colors, line styles, and strokes, and labeling to perhaps find a better looking graphic design.
• Add input fields for font size of various elements, or find reasonable calculations based on the input widths and heights of component parts of the drawing.
• Improve the simple HTML version of the output.
• Consider making an actual Vacation type, and allow creation of these in the folder. Individuals, or web administrators or managers, would create Vacation instances in the folder, and upon creation (and recreation by edit) of the rendering, the folder would be polled and the vacation objects queried for data. The existing CSV data entry mechanism could be retained for an alternative.
• An interface with more robust calendaring systems might be needed.

BUGS AND FEATURE REQUESTS

Please report bugs and feature requests to Jeff Pittman, who can be reached at jeff@geojeff.org. Jeff is often on the #plone irc channel as geojeff or ffej.

Change log

2005-08-19

* Further coding and first release during early
August

2005-07-24

* Used as an example at the 2005 North American
Plone Conference in New Orleans for a talk on
Illustration Types in Plone.

2005-06-10 Jeff Pittman <jeff@geojeff.org>

* Initial work