Requirements

• Zope 2.8.5-final
• Plone-2.1.2
• Archetypes 1.3.7-final
• TemplateFields (http://svn.plone.org/svn/archetypes/MoreFieldsAndWidgets/TemplateFields)

It may or may not work with other versions.

Installation

1. Uncompress the EasyNewsletter product into your <Zope Instance>/Products directory or link it there.
2. Restart Zope.
3. Go to site setup -> add/remove products and add EasyNewsletter.
4. Go via ZMI to the property tab of the portal object (or to a other object you want) and add "here/portlet_easynewsletter/macros/portlet" to left_slots or right_slots to add the portlet.

Quickstart

1. Add a EasyNewsletter instance, fill in the form and save it.
2. Go to criteria tab and add the criteria, which shall be applied to all of your Newsletters, e.g. "Items Type".
3. Add a Newsletter instance, fill in the form and save it.
4. Go to criteria tab and add the criteria, which shall be applied to this Newsletter, e.g. "Creation Date",
5. Go to send tab and push "Test Newsletter".
6. Go via ZMI to portal_properties -> easynewsletter_properties and fill in the relative path to your EasyNewsletter instance in the path propertiy. That means, if you added a EasyNewsletter "Newsletter" inside a folder "Information", which is on his part right under the portal, enter: "information/newsletter".

Good-To-Knows

• Adding content

  EasyNewsletter itself as the outer container of the product and a newsletter inside of it are ATTopics. Hence you can use familiar criteria to decide which content should be part of a newsletter. It's a feature of ATTopics that subtopics are able to inherit criteria from its parent, so all Newsletter instances are able to inherit criteria from the outer EasyNewsletter instance. Once the content is generated one could edit the text as ususal in Plone.

• Structure content

  You can create own templates to structure the selected content. Please refer to the provided "default"-template to see how it works.

• Portlet

  To make the portlet able to add subscribers and link to the archive, you have to enter the relative path to the newsletter in portal_properties -> easynewsletter_properties (see 6. of Quickstart).

Contribution

If you want to contribute, please don't hesitate. Everything is welcome. If you want to contribute code, please be aware that the whole application is generated via ArchGenXML - which is by the way the killer-app for developing Plone products. You will find the model inside the model directory. It is made with Poseidon 3.0.

Copyright

Copyright 2006 by Kai Diefenbach - iqplusplus (info@iqpp.de)