EXT: Contacts List¶

Table of Contents¶

EXT: Contacts List 1

Introduction 1

What does it do? 1

Screenshots 2

Users manual 2

FAQ 2

Installation and configuration 3

Upgrading from version 0.3.0 3

Reference 3

Introduction¶

If you like this extension, please submit a rating for it in the TER.

Development of this extension has been sponsored by MH- Computersysteme oHG .

If you find any bugs in this extension, please report them in the bug tracker under the product C ontactslist .

If you want to help out by fixing bugs, adding features or providing additional localization, please contact the author.

Translations wanted: If you would like to provide a translation of the extension (or fixes to the bad French localization), please contact the author.

What does it do?¶

This extension displays a list of contacts, e.g. of sales offices. The list is searchable by ZIP code and by country.

When a country is selected, the list for that country is displayed at once, so that the user doesn't need to type his or her ZIP code if the list is short.

Screenshots¶

Abbildung 1: Screenshot of the front-end plug-in: A search form with one search result.

As you can see, only the entries (in this case one entry) for the selected country are displayed. Fields that have no content (e.g.the street and the homepage) are not displayed so that there are no empty lines. Abbildung 2: Screenshot of the data entry form in the back end.

Users manual¶

Installation and configuration¶

Make sure that you’re using at least TYPO3 4.0.0 and PHP 5.1.0.

Make sure that you have installed the extension static_info_tables .

Make sure that you have installed the extension oelib .

Install the extension and its dependencies.

In you main TS template, include this extension’s static setup under Include static (from extensions) .

The extension provides its own basic set of CSS styles (which work best if you're already using a CSS-based design). These stylesheets usually get included automatically. However, if your have set disableAllHeaderCode = 1 and want to use the provided stylesheet , you need to include the stylesheet typo3conf/ext/contactslist/pi1/contactslist_pi1.css manually into your page header.

Create a system folder (page) that will hold all the contacts data. (Usually, you need only one page, but there are scenarios where you might want to use more than one page, e.g.to have more than one user group tending to the data.)

Give the user group that will enter the data write access to that folder.

Select or create one or more pages that will have the plug-in.

Add a plug-in to the page(s).

As the plug-in type, select “Contacts List”.

As a starting point (starting page), add the system folder you created.

The default setup should work out of the box. If you want to change something, configure the plug-in to your liking using the template TS setup.

To configure the plug-in language, you need to set two values in your TS setup: config.language and page.config.language.

Enter the data in the back end using Web -> List.