.. contents:: :depth: 2

Introduction
============

Easy Template (collective.easytemplate) products brings easy dynamic texts to Plone. 
You don't need to create full blown product just for few dynamic pages anymore - 
the most simplest things can be typed straight from the visual editor.

Templating is a way to add simple programming logic to text output. 
This products adds or enhances templating supports on various parts
of Plone site.

Motivation 
----------

Plone lacks out of the box support for custom, extensible, templating support for content editors.

Use cases
---------

Possible use cases are e.g.

* Adding dynamic listings and tables on pages, like news listing

* Adding dynamic email bodies, titles and receivers in content rules actions

* Adding generated content to content rule action emails

* Show different text to logged in and anonymous users

* Creating a simple text portlet dynamically

Example
-------

The following example demostrates how text in Templated Document edit mode gets translated to generated HTML snippet in the view mode.

You write in Kupu::

  Hello user!
  
  Please select one course from below:
  
  {{ list_folder("courses") }}
 
will result to the output:

  Hello user!
  
  Please select one course from below:
  
  * `Math <http://example.example>`_
  
  * `Marketing <http://example.example>`_
  
  * `Chemistry <http://example.example>`_


Installation 
------------

Add to your buildout::

	eggs = 
	    collective.templateengines
		collective.easytemplate
		
	zcml = 
		collective.easytemplate
	
Run Add-on product installer for *Easy Template* product.

collective.easytemplate depends on `collective.templateengines <http://pypi.python.org/pypi?%3Aaction=pkg_edit&name=collective.templateengines>`_
and `Jinja2 <http://pypi.python.org/pypi/Jinja2>`_ template engine. 


Running unit tests
------------------

Python eggs Cheetah, Jinja2 and Products.LinguaPlone must be installed in order to run all unit tests.
  
Author
------

`Twinapex Team <mailto:info@twinapex.com>`_ - Python and Plone professionals for hire. 

* `Twinapex company site <http://www.twinapex.com>`_ (`Twinapex-yritysryhmä <http://www.twinapex.fi>`_)

* `Twinapex company blog <http://blog.twinapex.fi>`_

* `Twinapex mobile site <http://www.twinapex.mobi>`_

* `More about Plone <http://www.twinapex.com/products/plone>`_ (`Lisätietoja Plone-julkaisujärjestelmästä <http://www.twinapex.fi/tuotteet/plone>`_)

* `Other open source Plone products by Twinapex <http://www.twinapex.com/for-developers/open-source/for-plone>`_

Sponsorship
------------

The development of this product was sponsored by `London School of Marketing <http://londonschoolofmarketing.com>`_.




