INSTALLING THE NEWSLETTER BUILDER

0. Introduction
------------------------------------------------------------------

1.  What is the eznewsletter_builder extension?

    This extension is a general package for the newsletter extension 
    which includes all features and appereance with improved usability.

2.  License

    This software is licensed under the GPL. The complete
    license agreement is included in the LICENSE file. For more information
    or questions please contact info@ez.no

3. System requirements

   You need the actual version of eZ publish 3.7.5 to use this 
   installation procedure. You can find it at:
   
   http://ez.no/download/ez_publish

   Information on the installation of eZ publish can be found at:
   http://ez.no/doc/ez_publish

   PHP version:
   Make sure you have PHP 4.4.0 or higher.

4. All required extensions are in the contributions section on
   http://www.ez.no


1. System installation
------------------------------------------------------------------

1. copy following extensions in your extension directory:
    
    eznewsletter
    ezxapprove2
    ezmailimport
    eznewsletter_builder
    newsletter_modules
    ezlabel
    
2. add additional tables to you database

    mysql <db_name> < eznewsletter/sql/newsletter.sql
    mysql <db_name> < ezlabel/database/mysql/schema.sql
    mysql <db_name> < ezapprove2/sql/mysql/schema.sql
    mysql <db_name> < ezmailimport/sql/mailimport.sql
    mysql <db_name> < ezmailimport/settings/importmail.ini.append.php

3. execute patch

    cd <ezpublish_root_dir>
    patch -p0 < eznewsletter/kernelpatch/ezp37_patch.diff

4. activate siteaccess

    activate the example siteaccess 'editor' in your installation

5.  set the start node for image browsing in the
    browse.ini.append.php of the eznewsletter_builder
    Node-Id of the image folder in the media gallery
    (Step 3 of chapter 2 required)


6.  Set the attribute Id's of your imported classes in the 
    content.ini.append.php of the eznewsletter_builder
    (Step 3 of chapter 2 required)

7.  set up your email account settings for bouncemanagement in
    
    eznewsletter/settings/bounce.ini.append.php

8.  optionally you can set your hostname for sending out 
    newsletters with sendmail
    
    eznewsletter/settings/ezsendmailsettings.ini.append.php

9.  set the newsletter content class to newsletter_issue in

    eznewsletter/settings/override.ini.append.php
    
10. set up the contentstructure menu, set your start node 
    and optionally disable class filtering in
    
    eznewsletter/settings/contentstructuremenu.ini.append.php

11. set up your system to execute all cronjobs in the extensions


2. Setup in admin siteaccess
------------------------------------------------------------------

1. create folder for newsletter inbox

2. create folder for newsletter placement

3. import newsletter classes from package

    newsletter_classes-1.0-1.ezpkg
    
    Two classes shoud be imported, the newsletter issue 
    and the newsletter article class. If the system crashes
    go back and retry again, there is a known import bug with
    predefined date value attributes.

4.  edit the newsletter article class
    set validity date to current date
    set expiry date to adjusted current datetime 
    and fill in your validity period how log article should be valid

    The expiry datetime is only for metadata and is not checked yet.

5. create enhanced approve workflow
    add event Event / Approve2
    set up event to your needs

6. create workflow multiplexer
    select standard section
    select newsletter article and newsletter issue class
    select workflow enhanced approve

7. activate approve trigger 
    
    select approve workflow multiplexer
    in the event content publish before

