.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================= wt\_dynamictarget ================= :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Alex Kellner :Changed: 2009-03-17T10:23:53 :Classification: powermail recipient manipulation :Author: Alex Kellner :Email: Alexander.Kellner@einpraegsam.net :Info 3: :Info 4: .. _img-1-wt-dynamictarget: |img-1| wt\_dynamictarget ========================= Extension Key: **wt\_dynamictarget** Copyright 2005-2008, Alex Kellner, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.com .. _Table-of-Contents: Table of Contents ----------------- **wt\_dynamictarget 1** **wt\_dynamictarget introduction 2** What does it do? 2 What does this extension need to run? 2 Screenshots 3 Acknowledgments 3 **How to use 4** Step by step: 4 **Page record explanation 5** Dynamic Target Conditions 5 Dynamic Target Rules 6 Recipient Email 7 **Typoscript 8** setup 8 constants 8 explanation 8 **Note 9** **Todos 10** **Changelog 11** **Additional links 12** .. _wt-dynamictarget-introduction: wt\_dynamictarget introduction ------------------------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension manipulates the powermail mail to the receiver. Define different email addresses, subjects, cc addresses, sendernames and sender email addresses for different conditions. **This scenario is possible:** If user is located in italy the email will be send to the italy support, if the user is located in germany, the email will be send to the german support (of course automaticly) and so on... This conditions are available at the moment: - Usercountry (uses extension “geoip”) - Browserlanguage of user - If any powermail field contains a special value - The language which is set in the frontend - The current domain in frontend .. _What-does-this-extension-need-to-run: What does this extension need to run? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - powermail - geoip (only if usercountry should be used) .. _Screenshots: Screenshots ^^^^^^^^^^^ .. _Add-condition-to-powermail-recipients: Add condition to powermail recipients """"""""""""""""""""""""""""""""""""" |img-2| .. _Define-your-conditions-and-the-email-details-for-that: Define your conditions and the email details for that """"""""""""""""""""""""""""""""""""""""""""""""""""" |img-3| .. _Acknowledgments: Acknowledgments ^^^^^^^^^^^^^^^ Creation of this extension was sponsored by conject ( `http://www.conject.com `_ ): Construction Project Management, CAFM and Cost Controlling with conject in german: Planmanagement, CAFM und Baukosten Management mit conject .. _How-to-use: How to use ---------- .. _Step-by-step: Step by step: ^^^^^^^^^^^^^ - Import, install and configurate powermail from the TER - Import extension geoip from TER (only if you need the user country) - Import extension wt\_dynamictarget from TER - Add (e.g.) a sysfolder and enter - Record: Recipient Email (define the settings if a condition fit) - Record: Dynamic Target Conditions and add some Dynamic Target Rules - Enter the powermail page record and add the condtion to this (area recipients) .. _Page-record-explanation: Page record explanation ----------------------- .. _Dynamic-Target-Conditions: Dynamic Target Conditions ^^^^^^^^^^^^^^^^^^^^^^^^^ .. _Screenshot: Screenshot """""""""" .. _img-4: |img-4| """"""" .. _Explanation: Explanation """"""""""" - Hide: Disable a record - Title: Define a title (this is only for the backend) - Rules: add some rules(see Dynamic Target Rules)(if one of the rules fits, Email address details will be overwritten) - Email addresses: Define which Email definitions should be used if one of the rules fit .. _Dynamic-Target-Rules: Dynamic Target Rules ^^^^^^^^^^^^^^^^^^^^ .. _Screenshot: Screenshot """""""""" .. _img-5: |img-5| """"""" .. _Explanation: Explanation """"""""""" - Hide: Disable the rule - Title: Only for Backend use (maybe your description) - Kind of rule: “Geo IP”, “Frontend language”, “Value of a powermail field”, “Browserlanguage” or “Domain”(see table below for details) - Value: Define which value (see table below) .. _Kind-of-rule-and-Value-explanation: Kind of rule and Value explanation """""""""""""""""""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _Rule-Kind: **Rule Kind** ~~~~~~~~~~~~~ .. container:: table-row a **Rule Kind** b **Explanation** c **Value field** d **Example** e **Example explanation** .. _Geo-IP: Geo IP ~~~~~~ .. container:: table-row a Geo IP b Maybe if a user is located in Germany or Austria (you need the extension geoip and you need to enter the relative path to the geo ip file via constants – see constans above) c Define the language code (ISO 3166 / ISO 3) – list at: `http://www.addressdoctor.com/de/countries\_data/isocodes.asp `_ d DEU, ITA, SWE e If user is located in Gemany or in Italy or in Sweden, so use Email details which are defined in Conditions .. _Frontend-language: Frontend language ~~~~~~~~~~~~~~~~~ .. container:: table-row a Frontend language b If frontend language is 2, than the email details should be changed c Define some language uids (commaseparated) d 1,2,3 e If the frontend language is 1 or 2 or 3 (e.g. &L=1), so use Email details which are defined in Conditions .. _Value-of-a-powermail-field: Value of a powermail field ~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row a Value of a powermail field b If there is a special value in a powermail field, so change email details c Enter the field uid and the value which should be in there (e.g. uid34=male, uid23=firstname, uid4\|0=red, uid4\|1=blue) d uid3=computer, uid3=laptop e If powermail field uid3 contains the string computer or the string laptop, use Email details which are defined in Conditions .. _Browserlanguage: Browserlanguage ~~~~~~~~~~~~~~~ .. container:: table-row a Browserlanguage b If the Browser of the user has a special language (only the first defined language of the browser is used) c Enter a language definition (have a look e.g. into the firefox, and change the language settings – you will see the available codes) d de-de, de-at e If the user uses a german browser (located in germany or in austria), use Email details which are defined in Conditions .. _Domain: Domain ~~~~~~ .. container:: table-row a Domain b Change receiver datas to current domain c You can enter one domain or part of the domain d www.test.com e If the current domain is (e.g.) `http://www.test.com `_ than this rule will be used .. ###### END~OF~TABLE ###### .. _Recipient-Email: Recipient Email ^^^^^^^^^^^^^^^ .. _Screenshot: Screenshot """""""""" |img-6| .. _Explanation: Explanation """"""""""" - Hide: Disable the Email definition - Receiver email (comma separated): Enter new receiver email - Sender email: Define sender email address - Subject of receiver mail: Define new subject (you can use markers if you want) - Senders name: Define new sender name - CC email (comma separated): Define cc email addresses .. _Typoscript: Typoscript ---------- .. _setup: setup ^^^^^ plugin.tx\_wtdynamictarget { file.geoip = {$plugin.wtdynamictarget.file.geoip} emptyvalue = {$plugin.wtdynamictarget.emptyvalue} debug = {$plugin.wtdynamictarget.debug} } .. _constants: constants ^^^^^^^^^ plugin.wtdynamictarget { \# cat=plugin.wtdynamictarget//010; type=text; label= GeoIP File: Enter relative path to the geoip file. Have a look into the manual of geoip for more information about this file (e.g. fileadmin/geo.dat) file.geoip = fileadmin/geo.dat \# cat=plugin.wtdynamictarget/enable/020; type=boolean; label= Use empty values: If there is an empty value in the email addresses table, overwrite (clear) default value or not (e.g. 1 means clear default value) emptyvalue = 1 \# cat=plugin.wtdynamictarget/enable/100; type=boolean; label= Debugmode: If you activate debug mode, the new mail array for recipient mail is shown in frontend and no email will be send (e.g. 1) debug = 0 } .. _explanation: explanation ^^^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _Name: **Name** """""""" .. container:: table-row a **Name** b **Explanation** c **Standard value** .. _file-geoip: file.geoip """""""""" .. container:: table-row a file.geoip b GeoIP File: Enter relative path to the geoip file. Have a look into the manual of geoip for more information about this file (e.g. fileadmin/geo.dat) c fileadmin/geo.dat .. _emptyvalue: emptyvalue """""""""" .. container:: table-row a emptyvalue b Use empty values: If there is an empty value in the email addresses table, overwrite (clear) default value or not (e.g. 1 means clear default value) c 1 .. _debug: debug """"" .. container:: table-row a debug b Debugmode: If you activate debug mode, the new mail array for recipient mail is shown in frontend and no email will be send (e.g. 1) c 0 .. ###### END~OF~TABLE ###### .. _Note: Note ---- If you want to use geoip, ensure that geoip needs min. 50MB memory\_limit(serversetting and setting in the install tool of TYPO3) .. _Todos: Todos ----- - powermail fields with wildcards (uid3=\*@\*) - powermail fields inverted like uid3!=value - This is the initial release, so there are a lot of features!? Do you need a new feature? Maybe we can help you, so just write us! .. _Changelog: Changelog --------- .. _generated: ((generated)) ^^^^^^^^^^^^^ .. _wt-dynamictarget-version-0-5-x-beta: wt\_dynamictarget version 0.5.x beta """""""""""""""""""""""""""""""""""" .. _Initial-Release-to-TER-on-17-03-2009-version-0-5-1: Initial Release to TER on 17.03.2009 version 0.5.1 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ New method added: Domain (Change receiver to current domain) .. _Initial-Release-to-TER-on-14-10-2008-version-0-5-0: Initial Release to TER on 14.10.2008 version 0.5.0 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Main bugfix: Wrong email uid used (maybe no emails could be sent) - Preparing use with powermail 1.4 or higher .. _Initial-Release-to-TER-on-14-10-2008-version-0-1-2: Initial Release to TER on 14.10.2008 version 0.1.2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - wt\_callback supported now - small code cleaning .. _Initial-Release-to-TER-on-08-10-2008-version-0-1-1: Initial Release to TER on 08.10.2008 version 0.1.1 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DB entries will be changed too now .. _Initial-Release-to-TER-on-07-10-2008-version-0-1-0: Initial Release to TER on 07.10.2008 version 0.1.0 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Basic features enabled .. _Additional-links: Additional links ---------------- **You can use one of the following links, to get more informations about this plugin:** - Authors (Alex Kellner) homepage: `http://www.einpraegsam.net `_ - Sponsors homepage: `http://www.conject.com `_ - Tuning parts for your car: `http://www.wunschtacho.de `_ - Stuff for snowboarder and skier: `http://www.justpowder.de `_ Do you need help with this plugin: `http://www.typo3.net `_ |img-7| wt\_dynamictarget - 12 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 156 .. :id: graphics7 .. :name: graphics7 .. :width: 156 .. |img-2| image:: img-2.jpeg .. :align: left .. :border: 0 .. :height: 526 .. :id: Grafik1 .. :name: Grafik1 .. :width: 608 .. |img-3| image:: img-3.jpeg .. :align: left .. :border: 0 .. :height: 214 .. :id: Grafik2 .. :name: Grafik2 .. :width: 669 .. |img-4| image:: img-4.jpeg .. :align: left .. :border: 0 .. :height: 337 .. :id: Grafik3 .. :name: Grafik3 .. :width: 447 .. |img-5| image:: img-5.jpeg .. :align: left .. :border: 0 .. :height: 247 .. :id: Grafik4 .. :name: Grafik4 .. :width: 426 .. |img-6| image:: img-6.jpeg .. :align: left .. :border: 0 .. :height: 401 .. :id: Grafik5 .. :name: Grafik5 .. :width: 445 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102