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

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, <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>`_

What does it do? 3

Sponsor 3

Screenshots 4

`Users manual 7 <#__RefHeading__467_413120346>`_

`Administration 8 <#__RefHeading__31511_818911409>`_

`Configuration 9 <#__RefHeading__31515_818911409>`_

Installation 9

`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

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

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