.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================ EXT: nn\_address ================ :Author: Christopher :Created: 2010-12-18T19:57:23 :Changed: 2014-11-13T09:43:05.590000000 :Classification: nn_address :Description: Brand new alternative to tt_address. Based on extBase/fluid and works with Typo3 6.2. You can add multiple addresses,numbers to a Person. Not enough fields? Extend it with flexForms! :Keywords: Addresses, Persons, Addresslist :Author: KERN23.de - Hendrik Reimers :Email: kontakt@kern23.de :Language: en .. _img-1-img-2-EXT-nn-address: |img-1| |img-2| EXT: nn\_address ================================ Extension Key: nn\_address Language: en Version: 1.6.2 Keywords: Addresses, Persons, Addresslist Copyright 2006-2012, neonaut.de – Hendrik Reimers, 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.org .. _Table-of-Contents: Table of Contents ----------------- **`EXT: nn\_address 1 <#__RefHeading__5708_1738894311>`_** **`Introduction 3 <#__RefHeading__5710_1738894311>`_** `What does it do? 3 <#__RefHeading__463_413120346>`_ `Sponsor 3 <#__RefHeading__358_1505703577>`_ `Screenshots 4 <#__RefHeading__465_413120346>`_ **`Users manual 7 <#__RefHeading__467_413120346>`_** **`Administration 8 <#__RefHeading__31511_818911409>`_** **`Configuration 9 <#__RefHeading__31515_818911409>`_** `Installation 9 <#__RefHeading__31517_818911409>`_ **`Known problems 10 <#__RefHeading__31525_818911409>`_** **`To-Do list 11 <#__RefHeading__477_413120346>`_** **`ChangeLog 12 <#__RefHeading__31623_818911409>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ The future for tt\_address with Typo 6.x and especially 6.2 is uncertain. For this reason we developed an alternative with great new features. The extension makes it possible to manage address data in the Typo3 back-end. You are also able to store multiple address sets (e.g. work, home, etc.) for one contact. If the existing fields are not sufficient, it's possible to add a FlexForm file via the extension manager that will extend the contact data set with your own fields defined in that file. There are three plugins for getting data from the extension. One for getting a list of all address sets, one for getting a single data set and one for getting a alphabetical grouped list. Another features a pagination and a search or a filter for groups. In combination with the extension “content\_designer” it's possible to store the data in the page properties for creating staff pages for example. The TypoScript for the Content Designer Extension is part of this distribution. Feel free to get in contact with us on forge: `http://forge.typo3.org/projects/extension-nn\_address `_ .. _Sponsor: Sponsor ^^^^^^^ Thanks for supporting us to the following companies: |img-3| - NEONAUT GmbH ( `www.neonaut.de `_ , `info@neonaut.de `_ ) |img-4| - BEL NET GmbH ( `www.belnet.de `_ , `typo3@belnet.de `_ ) .. _Screenshots: Screenshots ^^^^^^^^^^^ Back-end data set example: |img-5| |img-6| |img-7| ^^^^^^^^^^^^^^^ |img-8| Frontend full feature screenshots: |img-9| |img-10| Users manual ------------ The back-end user doesn't have to do much. He just has to create data sets and choose the desired plug-in for the data output on the page where required. .. _Administration: Administration -------------- Preferably you would install the extension, create a Sysfolder and create data sets there. It is important to include the “static Template” with TypoScript and to define the storagePid via the constant values. .. _Configuration: Configuration ------------- .. _generated: ((generated)) ^^^^^^^^^^^^^ .. _TypoScript-Constants: TypoScript Constants """""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _persistence-storagePid: persistence.storagePid ~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property persistence.storagePid Data type integer Description Where are your contacts? SysFolder ID Default .. _settings-mapColor: settings.mapColor ~~~~~~~~~~~~~~~~~ .. container:: table-row Property settings.mapColor Data type string Description In the single view the addresses will be shown with google static map images. The basic color could be set here in hex (without hash tag) Default FF8700 .. _settings-swordValidationExpr: settings.swordValidationExpr ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property settings.swordValidationExpr Data type regexp Description As a security improvement any search string will be checked with a regular expression. Here you can define the expression. Default /^([\S\d\-\\_\.\ ]+)$/i .. _searchInFields: searchInFields ~~~~~~~~~~~~~~ .. container:: table-row Property searchInFields Data type csv Description In which fields should be searched for the search term? Default LastName, firstName, organisation .. ###### END~OF~TABLE ###### .. _Example-realURL-Configuration: Example realURL Configuration """"""""""""""""""""""""""""" :: // RealURL auto-configuration $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl']['_DEFAULT']['postVarSets']['_DEFAULT']['details'] = array( array( 'GETvar' => 'tx_nnaddress_abclist[person]', 'lookUpTable' => array( 'table' => 'tx_nnaddress_domain_model_person', 'id_field' => 'uid', 'alias_field' => 'CONCAT(last_name,\'_\',organisation)', 'addWhereClause' => ' AND NOT deleted', 'useUniqueCache' => 1, 'useUniqueCache_conf' => array( 'strtolower' => 1, 'spaceCharacter' => '-', ), ), ) ); .. _Installation: Installation ^^^^^^^^^^^^ Go to the extension manager and import and install the extension. After that include the default static Template and go to the constants manager to set the storagePid. In the extension configuration, inside of the extension manager, you can define or remove the path to an FlexForm XML file which extends the contact fields in the “Extended” sheet. .. _Known-problems: Known problems -------------- No problems known yet. Post them on forge: `http://forge.typo3.org/projects/extension-nn\_address `_ .. _To-Do-list: To-Do list ---------- Feel free to send us feature ideas or help us to optimize and extend this extension. `C `_ ontact us: `http://forge.typo3.org/projects/extension-nn\_address `_ .. _ChangeLog: ChangeLog --------- Last changes: .. ### BEGIN~OF~TABLE ### .. _1-0-0: 1.0.0 ^^^^^ .. container:: table-row Version 1.0.0 Changes First official release! .. _2-0-0: 2.0.0 ^^^^^ .. container:: table-row Version 2.0.0 Changes Brand new powerful features and re-factored code. Bugfix: Address Entries with hidden group, are shown before Feature: - Added ABC List view - Added possibility to show a google static map on each address entry - Added search by term or filter bei group - Added possibility to order and sort by columns - Optimized code .. _2-1-0: 2.1.0 ^^^^^ .. container:: table-row Version 2.1.0 Changes Features: - Extended default Person FlexForm to extend the Contact with associated Contacts as an example - Included a realURL example configuration in this manual. - Shorter URLs with a little trick (see TypoScript Setup). - Small changes in the default templates. - Possibility to extend all Models (not only person). Just set a folder in extConf (extMgr) and name the XMLs as the model (like Person.xml) .. _2-2-0: 2.2.0 ^^^^^ .. container:: table-row Version 2.2.0 Changes Bugfix and Features: - Removed unused locallang values and changed some values - Fixed not closing tags in templates - Some changes with the realurl conf example - Added organisation field to the list module label field by default - Added new viewhelper to get single contacts (persons) inside a fluid template. Useful for associatedPersons flexform field. - Put realurl\_conf for including inside Resources/Private/RealURL/realurl\_conf.php - #58822 Assignment of group to a person shows all groups, even the translated ones .. _2-2-1: 2.2.1 ^^^^^ .. container:: table-row Version 2.2.1 Changes Added possibility to limit the selectable groups to a sysfolder with: TCEFORM.tx\_nnaddress\_domain\_model\_person.groups.PAGE\_TSCONFIG\_ID LIST = ... .. _2-3-0: 2.3.0 ^^^^^ .. container:: table-row Version 2.3.0 Changes Bugfixes (see forge) and feature update to set the plugin flexform by the extMgr configuration .. _2-4-0: 2.4.0 ^^^^^ .. container:: table-row Version 2.4.0 Changes Feature and Bugfix release. Thanks a lot to “ **SAM. Agentur** ” for supporting ( `www.sam-net.de `_ ): - Bugfix #59936 - Bugfix #61350 - Feature #59801: Subgroups with AJAX Selection for search - Feature: Support for AND search of groups. Example included if constant set .. _2-4-1: 2.4.1 ^^^^^ .. container:: table-row Version 2.4.1 Changes Bugfix release. Main bugfix with the pagination in the ABC Group List. - Bug #62376 - Bug #62362 .. ###### END~OF~TABLE ###### .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 44 .. :id: graphics5 .. :name: graphics5 .. :vspace: 57 .. :width: 161 .. |img-2| image:: img-2.png .. :align: left .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 66 .. :id: Grafik3 .. :name: Grafik3 .. :width: 213 .. |img-4| image:: img-4.jpeg .. :align: left .. :border: 0 .. :height: 83 .. :id: Grafik8 .. :name: Grafik8 .. :width: 198 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 540 .. :id: Grafik1 .. :name: Grafik1 .. :width: 631 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 458 .. :id: Grafik2 .. :name: Grafik2 .. :width: 669 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 282 .. :id: Grafik4 .. :name: Grafik4 .. :width: 632 .. |img-8| image:: img-8.png .. :align: left .. :border: 0 .. :height: 541 .. :id: Grafik5 .. :name: Grafik5 .. :width: 393 .. |img-9| image:: img-9.png .. :align: left .. :border: 0 .. :height: 623 .. :id: Grafik7 .. :name: Grafik7 .. :width: 631 .. |img-10| image:: img-10.png .. :align: left .. :border: 0 .. :height: 280 .. :id: Grafik6 .. :name: Grafik6 .. :width: 631