Groups for tt_address¶

What does it do?¶

In the first place this extension adds a new field to tt_address records. This field is used to assign groups to the address record. The groups can be organized in a hierarchy with parent and sub groups.

The extension also comes with a plugin where either single tt_address records can get selected or as an alternative the selection can be made through groups. That group selection can have AND or OR combinations of groups. Additionally the plugin offers to select a template to display the address records.

In both, the tt_address records and the plugin the groups can be selected through a tree view like that known from DAM or tt_news.

The advantage of using address records through the plugin instead of inserting them with the “Insert record” content element especially pays of in larger sites with a lot of address records, so you can assign the groups to addresses and on a page you make a selection by groups, thus if a person changes its function you don't need to search the whole site where that person is shown. Instead you just assign his old group to a new person and it is exchanged over the whole site.

Screenshots¶

This is the plugin with the tree selector.

Creating a Group¶

At first you need to create some groups for your address records. To do this navigate to a sysfolder and switch to the list view. Click “Create new record” at the bottom, now click Address Group.

In that form the title is the only required field, if you have created some groups already you will see them in the tree view and can select one as the parent group for the group you are about to create. At the bottom you can add a small note or description to the group.

Assigning groups to an address record¶

Adding groups to an address is as easy as adding a parent group to another group. Open the address record you want to assign a group to or create a new address record, go to the bottom of the form and add one or more groups from the right box by clicking on the group.

When adding groups to an address there's one point to be aware of: The top most group you assign to an address can be put out in the front end later, so you might want to choose that carefully or switch positions of the selected groups.

Creating a Plugin Content Element and adding addresses to it¶

Go to the page view and navigate to the page where you want to insert one or more addresses. Create a new content element and in the “new content element wizard” scroll down to the plugins section and select “Address Selection”

Now on the first tab [1] you can add address records to the plugin, the second tab [2] is for selecting a template for how the address should look like, this needs to be configured by your administrator. If there're no templates on the second tab, just save the content element once and after saving it they should apear.

In the Single addresses field [3] you can select addresses by using the known element browser. Even if the addresses selected here would be selected via groups, too they do not appear twice.

In the groups field [4] you can select groups from the tree view. These groups get combined either by AND or by OR [5]. That means you can select addresses which are in all of the given groups (AND) or they are required to be only in one of the given groups (OR).

The starting point does not necessarily need to be set. The extension can be configured to work with a default setting which needs to be adjusted by your administrator. If you set a startingpoint here, it will override that default setting that might be set. The recursive field [7] set how deep in the page tree beginning from the startingpoint the system should look for addresses with the given groups.

¶

Reference¶

plugin.tx_addressgroups_pi1 {
  templates.template_1 {
    email.wrap = E-Mail: |<br />
    email.required = 1
    ...
  }

  templates.other_template {
    ...
  }

  templates.different_template {
    ...
  }
}