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

Introduction	3

What does it do?	3

Sponsor	3

Screenshots	4

Users manual	7

Administration	8

Configuration	9

Installation	9

Known problems	10

To-Do list	11

ChangeLog	12

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, info@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

TypoScript Constants

Property:	Data type:	Description:	Default:
persistence.storagePid	integer	Where are your contacts? SysFolder ID	
settings.mapColor	string	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)	FF8700
settings.swordValidationExpr	regexp	As a security improvement any search string will be checked with a regular expression. Here you can define the expression.	/^([\S\d\-\_\.\ ]+)$/i
searchInFields	csv	In which fields should be searched for the search term?	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.

Contact us: http://forge.typo3.org/projects/extension-nn_address

ChangeLog

Last changes:

Version:	Changes:
1.0.0	First official release!
2.0.0	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	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	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	Added possibility to limit the selectable groups to a sysfolder with: TCEFORM.tx_nnaddress_domain_model_person.groups.PAGE_TSCONFIG_IDLIST = ...
2.3.0	Bugfixes (see forge) and feature update to set the plugin flexform by the extMgr configuration
2.4.0	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	Bugfix release. Main bugfix with the pagination in the ABC Group List. Bug #62376 Bug #62362

EXT: nn_address - nn_address	To-Do list

12

EXT: nn_address

nn_address

Addresses Persons Addresslist

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!

Christopher

2010-12-18T19:57:23