Metadata-Version: 2.0
Name: mds-writing-serialletter
Version: 0.1.3
Summary: Tryton module to write serial letters for paper-based newsletters
Home-page: https://www.m-ds.de/
Author: m-ds GmbH
Author-email: service@m-ds.de
License: GPL-3
Download-URL: https://www.m-ds.de/serviceportal/downloads/trytonmodul-writing-serialletter
Keywords: tryton party
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Plugins
Classifier: Framework :: Tryton
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Customer Service
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Legal Industry
Classifier: Topic :: Office/Business
Classifier: Natural Language :: German
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Programming Language :: Python :: 2.7
Requires-Dist: mds-party-fieldaddon (>=0.1.1)
Requires-Dist: trytond (>=3.8,<3.9)
Requires-Dist: trytond-company (>=3.8,<3.9)
Requires-Dist: trytond-party (>=3.8,<3.9)

serial letters
==============
- a Tryton module to write serial letters for paper-based newsletters
- create a letter-template with placeholders
- export a Libreoffice-Writer-file or PDF-file from the letter-template, individually for each recipient

Install
=======
  pip install mds-writing-serialletter

Requires
========
- Tryton 3.8
- mds-party-fieldaddon

How to use
==========
Grant access to serial-letter
#############################
- The group *Serial letter - view* grants read access to the serial letter.
- The group *Serial letter - edit* grants read/write access to the serial letter.
- The group *Party Administration* allows the user to create *salutations* and *greetings*.

Create some salutations and greetings
#####################################
In *Party/Configuration*, open *Salutation* and create a few salutation, something like 'Mr.', 'Mrs.', etc.
Then open *Greetings* and create something like 'Dear', 'Hello', etc.

Create serial letter template
#############################
In *Writing*, open *Serial Letter* and create a new entry. Enter *name* and *subject*. Enter a *contact* to your serial letter. 
Insert text and use placeholders to place recipient-specific texts.

The result could look like this::

  [party:correspondence]
  Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam 
  nonumyeirmod tempor invidunt...

  sincerely
  [contact:name]

Add recipients
##############
Click *Recipient* and add some recipients. A party can have several addresses, one of these addresses must be marked as a mailing address. Click the button *Activate mailing address* to mark the first address as the mailing address.
For the individual recipients, select the salutations and greetings (double-click the receiver, select und save).

Export
######
Click the report button to get a LibreOffice-Writer-file from your mailing.

Changes
=======

*0.1.3 - 06/14/2017*

- updated depency

*0.1.2 - 06/07/2017*

- module name changed

*0.1.1 - 05/26/2017*

- first public version


