DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
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 |
EXT: nn_address¶
Extension Key: nn_address
Language: en
Version: 1.6.2
Keywords: Addresses, Persons, Addresslist
Copyright 2006-2012, neonaut.de – Hendrik Reimers, <info@neonaut.de>
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¶
`EXT: nn_address 1 <#__RefHeading__5708_1738894311>`_
`Introduction 3 <#__RefHeading__5710_1738894311>`_
`Users manual 7 <#__RefHeading__467_413120346>`_
`Administration 8 <#__RefHeading__31511_818911409>`_
`Configuration 9 <#__RefHeading__31515_818911409>`_
`Known problems 10 <#__RefHeading__31525_818911409>`_
`To-Do list 11 <#__RefHeading__477_413120346>`_
`ChangeLog 12 <#__RefHeading__31623_818911409>`_
Introduction¶
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¶
Thanks for supporting us to the following companies:
- - NEONAUT GmbH ( www.neonaut.de ,
- BEL NET GmbH ( www.belnet.de , typo3@belnet.de )
Screenshots¶
Back-end data set example:
^^^^^^^^^^^^^^^
Frontend full feature screenshots:
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¶
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¶
((generated))¶
TypoScript Constants¶
persistence.storagePid¶
Property
persistence.storagePid
Data type
integer
Description
Where are your contacts? SysFolder ID
Default
settings.mapColor¶
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¶
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
/^([Sd-\_.]+)$/i
searchInFields¶
Property
searchInFields
Data type
csv
Description
In which fields should be searched for the search term?
Default
LastName, firstName, organisation
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¶
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¶
No problems known yet. Post them on forge: http://forge.typo3.org/projects/extension-nn_address
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¶
Last changes:
1.0.0¶
Version
1.0.0
Changes
First official release!
2.0.0¶
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¶
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¶
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¶
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¶
Version
2.3.0
Changes
Bugfixes (see forge) and feature update to set the plugin flexform by the extMgr configuration
2.4.0¶
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¶
Version
2.4.1
Changes
Bugfix release. Main bugfix with the pagination in the ABC Group List.
- Bug #62376
- Bug #62362