wt_directory¶

What does it do?¶

wt_directory is THE possibility to show addresses from tt_address. Different views (with HTML Templates) for list and single. Just add different fields in flexform to show – that's all.

wt_directory supports tt_address_groups.

Different filter possibilities for wt_directory: ABC list, Add some search fields, Category dropdown.

vCard export of addresses and powermail link for sending a form to a tt_address email address possible.

Of course you can use typoscript for every view (possibility of lightboxes, case script, etc...)

All features in a list¶

• Address list of tt_address table like the old extension sp_directory.
• HTML Templates for all views.
• Define tt_address category, ABC list, category selector or your own search fields.
• Connection to rggooglemap to show an address right now on a map.
• Connection to powermail to send a form to chosen tt_address user.
• Edit fields via typoscript possible.
• Easily adding some more markers for text or typoscript.
• Vcard download in listview or detailview.
• wt_directory was developed to meet the demands on high security.

wt_directory requires¶

• tt_address
• wt_doorman (security class)

Frontend: Using wt_directory to show addresses¶

Backend: Use flexform for configuration¶

Note: Need more screenshots¶

We need more screenshots! Do you need a backlink? So let's get together and write me!

Step by step:¶

• Import tt_address from online repository (TER) (Don't use wt_directory without tt_address!)
• Import wt_doorman from online repository (TER)
• Import wt_directory from TER
• Add some tt_address entries on any page (maybe sysfolder)
• Enter a wt_directory plugin to any existing page
• Configure it via flexform
• Some more configuration possibilities available via constants
• If you want to include a default css, you can add the static template
• If you want to use autocomplete for search fields, you can enter the static template

wt_directory test homepage:¶

http://www.einpraegsam.net/fachgebiete/typo3-extensions/wt- directory.html

Main¶

List¶

Detail¶

Googlemap¶

Powermail¶

tt_news¶

Constants¶

template.list¶

template.detail¶

template.ALLmarker¶

template.pagebrowser¶

template.search¶

template.vcard¶

path.ttaddress_pictures¶

enable.hideDescription¶

enable.googlemapOnDetail¶

enable.vCardForList¶

enable.vCardForDetail¶

enable.powermailForList¶

enable.powermailForDetail¶

morelink_detail.condition¶

label.vCard¶

label.powermail¶

list.perPage¶

list.orderby¶

detail.title¶

detail.emailredirect¶

wrap.addressgroup¶

filter.cat.disable¶

filter.cat.showAllInDropdown¶

filter.list.clearOldFilter¶

filter.cat.clearOldFilter¶

vCard.utf8¶

Constants prefix is always plugin.wtdirectory

Typoscript settings (setup)¶

# WT_DIRECTORY PLUGIN #

includeLibs.user_wtdirectory_pagebrowser = EXT:wt_directory/lib/class.user_wtdirectory_pagebrowser.php

# main settings

plugin.tx_wtdirectory_pi1 {

# Constants

template.list = {$plugin.wtdirectory.template.list}

template.detail = {$plugin.wtdirectory.template.detail}

template.ALLmarker = {$plugin.wtdirectory.template.ALLmarker}

template.pagebrowser = {$plugin.wtdirectory.template.pagebrowser}

template.search = {$plugin.wtdirectory.template.search}

template.vcard = {$plugin.wtdirectory.template.vcard}

path.ttaddress_pictures = {$plugin.wtdirectory.path.ttaddress_pictures}

enable.googlemapOnDetail = {$plugin.wtdirectory.enable.googlemapOnDetail}

enable.hideDescription = {$plugin.wtdirectory.enable.hideDescription}

enable.vCardForList = {$plugin.wtdirectory.enable.vCardForList}

enable.vCardForDetail = {$plugin.wtdirectory.enable.vCardForDetail}

enable.powermailForList = {$plugin.wtdirectory.enable.powermailForList}

enable.powermailForDetail = {$plugin.wtdirectory.enable.powermailForDetail}

morelink_detail.condition = {$plugin.wtdirectory.morelink_detail.condition}

label.vCard = {$plugin.wtdirectory.label.vCard}

label.powermail = {$plugin.wtdirectory.label.powermail}

list.perPage = {$plugin.wtdirectory.list.perPage}

list.orderby = {$plugin.wtdirectory.list.orderby}

detail.title = {$plugin.wtdirectory.detail.title}

detail.emailredirect = {$plugin.wtdirectory.detail.emailredirect}

wrap.addressgroup = {$plugin.wtdirectory.wrap.addressgroup}

filter.cat.disable = {$plugin.wtdirectory.filter.cat.disable}

filter.cat.showAllInDropdown = {$plugin.wtdirectory.filter.cat.showAllInDropdown}

filter.list.clearOldFilter = {$plugin.wtdirectory.filter.list.clearOldFilter}

filter.cat.clearOldFilter = {$plugin.wtdirectory.filter.cat.clearOldFilter}

vCard.utf8 = {$plugin.wtdirectory.vCard.utf8}

# Detail view

detail {

field.tstamp = TEXT

field.tstamp.field = tstamp

field.tstamp.strftime = %d.%m.%Y

field.name = TEXT

field.name.field = name

field.name.wrap = <h2>|</h2>

field.gender = CASE

field.gender.key.field = gender

field.gender.default = IMAGE

field.gender.default.file = EXT:wt_directory/files/icon_female.gif

field.gender.m = IMAGE

field.gender.m.file = EXT:wt_directory/files/icon_male.gif

field.first_name = TEXT

field.first_name.field = first_name

field.middle_name = TEXT

field.middle_name.field = middle_name

field.last_name = TEXT

field.last_name.field = last_name

field.birthday = TEXT

field.birthday.field = birthday

field.birthday.strftime = %d.%m.%Y

field.title = TEXT

field.title.field = title

field.email = COA

field.email.if.isTrue.field = email

field.email.10 = IMAGE

field.email.10.file = EXT:wt_directory/files/icon_mail.gif

field.email.10.params = style="margin-right: 6px;" class="wt_directory_icon_mail"

field.email.20 = TEXT

field.email.20.field = email

field.email.20.typolink.parameter.field = email

field.phone = COA

field.phone.if.isTrue.field = phone

field.phone.10 = IMAGE

field.phone.10.file = EXT:wt_directory/files/icon_phone.gif

field.phone.10.params = style="margin-right: 6px;" class="wt_directory_icon_phone"

field.phone.20 = TEXT

field.phone.20.field = phone

field.mobile = COA

field.mobile.if.isTrue.field = mobile

field.mobile.10 = IMAGE

field.mobile.10.file = EXT:wt_directory/files/icon_cell.gif

field.mobile.10.params = style="margin-right: 6px;" class="wt_directory_icon_cell"

field.mobile.20 = TEXT

field.mobile.20.field = mobile

field.www = COA

field.www.if.isTrue.field = www

field.www.10 = IMAGE

field.www.10.file = EXT:wt_directory/files/icon_web.gif

field.www.10.params = style="margin-right: 6px;" class="wt_directory_icon_www"

field.www.20 = TEXT

field.www.20.field = www

field.www.20.typolink.parameter.field = www

field.www.20.typolink.ATagParams = target="_blank"

field.address = TEXT

field.address.field = address

field.address.br = 1

field.building = TEXT

field.building.field = building

field.room = TEXT

field.room.field = room

field.company = TEXT

field.company.field = company

field.city = TEXT

field.city.field = city

field.zip = TEXT

field.zip.field = zip

field.region = TEXT

field.region.field = region

field.country = TEXT

field.country.field = country

field.image = TEXT

field.image.field = image

field.image.split {

token = ,

cObjNum = 1

1 {

10 = IMAGE

10.params = class="wt_directory_image"

10.file.import.current = 1

10.file.import.dataWrap = {$plugin.wtdirectory.path.ttaddress_pictures}

10.file.width = 120

10.imageLinkWrap = 1

10.imageLinkWrap.enable = 1

10.imageLinkWrap {

bodyTag = <body style="background-color: white;">

wrap = <a href="javascript:close();">|</a>

JSwindow = 1

JSwindow.newWindow = 1

}

}

}

field.fax = COA

field.fax.if.isTrue.field = fax

field.fax.10 = IMAGE

field.fax.10.file = EXT:wt_directory/files/icon_fax.gif

field.fax.10.params = style="margin-right: 6px;" class="wt_directory_icon_fax"

field.fax.20 = TEXT

field.fax.20.field = fax

field.description = TEXT

field.description.field = description

field.description.br = 1

field.addressgroup = TEXT

field.addressgroup.field = addressgroup

field.anyfield = YOURTYPOSCRIPT

}

# List view

list {

field.tstamp = TEXT

field.tstamp.field = tstamp

field.tstamp.strftime = %d.%m.%Y

field.name = TEXT

field.name.field = name

field.name.wrap = <h2>|</h2>

field.gender = CASE

field.gender.key.field = gender

field.gender.default = IMAGE

field.gender.default.file = EXT:wt_directory/files/icon_female.gif

field.gender.m = IMAGE

field.gender.m.file = EXT:wt_directory/files/icon_male.gif

field.first_name = TEXT

field.first_name.field = first_name

field.middle_name = TEXT

field.middle_name.field = middle_name

field.last_name = TEXT

field.last_name.field = last_name

field.birthday = TEXT

field.birthday.field = birthday

field.birthday.strftime = %d.%m.%Y

field.title = TEXT

field.title.field = title

field.email = COA

field.email.if.isTrue.field = email

field.email.10 = IMAGE

field.email.10.file = EXT:wt_directory/files/icon_mail.gif

field.email.10.params = style="margin-right: 6px;" class="wt_directory_icon_mail"

field.email.20 = TEXT

field.email.20.field = email

field.email.20.typolink.parameter.field = email

field.phone = COA

field.phone.if.isTrue.field = phone

field.phone.10 = IMAGE

field.phone.10.file = EXT:wt_directory/files/icon_phone.gif

field.phone.10.params = style="margin-right: 6px;" class="wt_directory_icon_phone"

field.phone.20 = TEXT

field.phone.20.field = phone

field.mobile = COA

field.mobile.if.isTrue.field = mobile

field.mobile.10 = IMAGE

field.mobile.10.file = EXT:wt_directory/files/icon_cell.gif

field.mobile.10.params = style="margin-right: 6px;" class="wt_directory_icon_cell"

field.mobile.20 = TEXT

field.mobile.20.field = mobile

field.www = COA

field.www.if.isTrue.field = www

field.www.10 = IMAGE

field.www.10.file = EXT:wt_directory/files/icon_web.gif

field.www.10.params = style="margin-right: 6px;" class="wt_directory_icon_www"

field.www.20 = TEXT

field.www.20.field = www

field.www.20.typolink.parameter.field = www

field.www.20.typolink.ATagParams = target="_blank"

field.address = TEXT

field.address.field = address

field.address.br = 1

field.building = TEXT

field.building.field = building

field.room = TEXT

field.room.field = room

field.company = TEXT

field.company.field = company

field.city = TEXT

field.city.field = city

field.zip = TEXT

field.zip.field = zip

field.region = TEXT

field.region.field = region

field.country = TEXT

field.country.field = country

field.image = IMAGE

field.image.wrap = |&nbsp;

field.image.file {

import.dataWrap = {$plugin.wtdirectory.path.ttaddress_pictures}

import.field = image

import.listNum = 0

width = 120

}

field.fax = COA

field.fax.if.isTrue.field = fax

field.fax.10 = IMAGE

field.fax.10.file = EXT:wt_directory/files/icon_fax.gif

field.fax.10.params = style="margin-right: 6px;" class="wt_directory_icon_fax"

field.fax.20 = TEXT

field.fax.20.field = fax

field.description = TEXT

field.description.field = description

field.description.br = 1

field.addressgroup = TEXT

field.addressgroup.field = addressgroup

field.anyfield = YOURTYPOSCRIPT

}

searchAllFields = company, name, city

# Pagebrowser

pagebrowser = HMENU

pagebrowser {

special = userfunction

special.userFunc = user_wtdirectory_pagebrowser->user_pagebrowser

1 = TMENU

1 {

wrap = <ul class="wt_directory_pagebrowser">|</ul>

NO.allWrap = <li>|</li>

ACT = 1

ACT.allWrap = <li>|</li>

ACT.ATagParams = class="act"

}

}

# vCard settings

vCard {

### MAIN ###

# Display name

display_name = COA

display_name {

10 = TEXT

10.field = first_name

10.noTrimWrap = || |

20 = TEXT

20.field = last_name

}

# Firstname

first_name = TEXT

first_name.field = first_name

# Lastname

last_name = TEXT

last_name.field = last_name

# Middle name

middle_name = TEXT

middle_name.field = middle_name

# Title

title = TEXT

title.field = title

# Name prefix

name_prefix = TEXT

name_prefix.field = title

# Name suffix

name_suffix = TEXT

name_suffix.value =

# Email 1

email1 = TEXT

email1.field = email

# Email 2

email2 = TEXT

email2.value =

# Company

company = TEXT

company.field = company

# Room

company = TEXT

company.room = room

### WORK ###

# Phone

work_phone = TEXT

work_phone.field = phone

# Post Office Box

work_po_box = TEXT

work_po_box.value =

# Extended Address

work_extended_address = TEXT

work_extended_address.field = address

# Address

work_address = TEXT

work_address.field = address

# City

work_city = TEXT

work_city.field = city

# State

work_state = TEXT

work_state.field = region

# ZIP

work_zip = TEXT

work_zip.field = zip

# Country

work_country = TEXT

work_country.field = country

### PRIVATE ###

# Phone

home_phone = TEXT

home_phone.field = phone

# Post Office Box

home_po_box = TEXT

home_po_box.value =

# Extended Address

home_extended_address = TEXT

home_extended_address.field = address

# Address

home_address = TEXT

home_address.field = address

# City

home_city = TEXT

home_city.field = city

# State

home_state = TEXT

home_state.field = region

# ZIP

home_zip = TEXT

home_zip.field = zip

# Country

home_country = TEXT

home_country.field = country

### OTHER ###

# Cellphone

cellphone = TEXT

cellphone.field = mobile

# Fax

fax = TEXT

fax.field = fax

# Pager

page = TEXT

page.value =

# URL

www = TEXT

www.value = Homepage

www.typolink {

parameter.data = field : www

returnLast = url

}

# Createdate of vCard

crdate = TEXT

crdate.data = date:U

crdate.strftime = %Y-%m-%d %H:%M:%S

# Birthday

birthday = TEXT

birthday.field = birthday

birthday.strftime = %Y%m%d

# Role

role = TEXT

role.value =

# Note

note = TEXT

note.value = created by wt_directory

# Timezone

timezone = TEXT

timezone.value = +0100

# Filename for vCard

filename = COA

filename.wrap = |.vcf

filename {

10 = TEXT

10.field = first_name

10.noTrimWrap = ||_|

20 = TEXT

20.field = last_name

}

}

}

# TypeNum 3134 for vCard Download

wtdirectory_vCard = PAGE

wtdirectory_vCard {

typeNum = 3134

10 < plugin.tx_wtdirectory_pi1

config {

disableAllHeaderCode = 1

disablePrefixComment = 1

xhtml_cleaning = 0

admPanel = 0

}

}

How can I use my own html code for listview, singleview, search or pagebrowser?¶

Have a look into your constant editor to use your own html templates

How can I change the output of any field in listview or singleview?¶

Every field could be changed via typoscript setup (see ts above image or name)

How to add a new marker to my HTML Template (list or detail)?¶

Have a look into the TypoScript Template. You can add two lines and have a new marker...

How to output new fields of tt_address?¶

• See this HOWTO on http://www.typo3.net/forum/list/list_post//82282
• Add some new fields to tt_address (e.g. via kickstarter)
• New fields (example from rggooglemap) are automaticly shown in the backend:
• Enable field via TypoScript:

plugin.tx_wtdirectory_pi1 {
        detail {
                field.tx_rggooglemap_lat = TEXT
                field.tx_rggooglemap_lat.field = tx_rggooglemap_lat
                field.tx_rggooglemap_lat.wrap = <span style=”color: red;”>|</span>
        }
}

Add a new marker to your HTML Template:

<!-- ###WTDIRECTORY_DETAIL### begin -->
        ###WTDIRECTORY_TX_RGGOOGLEMAP_LNG###
                <hr />
                ###WTDIRECTORY_SPECIAL_ALL###
<!-- ###WTDIRECTORY_DETAIL### end →

Add a label for the new field:

plugin.tx_wtdirectory_pi1 {
        _LOCAL_LANG.default.wtdirectory_ttaddress_tx_rggooglemap_lat = Latitude:
        _LOCAL_LANG.de.wtdirectory_ttaddress_tx_rggooglemap_lat = Breitengrad:
}

• Example FE output:
• Example TypoScript fom RTE field:

plugin.tx_wtdirectory_pi1 {
        list {
                field.tx_temp_tempextend = TEXT
                field.tx_temp_tempextend.field = tx_temp_tempextend1
                field.tx_temp_tempextend.parseFunc < lib.parseFunc_RTE
        }
}

How can I add a new marker to show a text / How to change locallang output?¶

• ###WTDIRECTORY_LL_TEST### can be used in every HTML Template
• Fill this example via locallang.xml or
• Fill this example via typoscript plugin.tx_wtdirectory_pi1._LOCAL_LANG.en.wtdirectory_ll_test = my text

How can I add a new marker and use typoscript¶

• ###WTDIRECTORY_TS_TEST### can be used in every HTML Template
• Fill this example via typoscript:

plugin.tx_wtdirectory_pi1 {

dynamicTyposcript {

test = TEXT

test.value = typoscript blabla

}

}

I want to write addressgroups comma separated and no comma at the end!?¶

Constants:

# seperate address groups with comma

plugin.wtdirectory.wrap.addressgroup = |,

Setup:

# Don't want the comma at the end of the address groups

plugin.tx_wtdirectory_pi1 {

detail {

field.addressgroup = TEXT

field.addressgroup.field = addressgroup

field.addressgroup.split {

token = ,

cObjNum = 1 |*| 2 |*| 3 || 4

1.current = 1

1.wrap = |,

2.current = 1

2.wrap = |,

3.current = 1

3.wrap = |

4.current = 1

}

}

}

HTML header is shown in my vCard – why?¶

• Do you use realurl and forgot to set the typenum 3134 in realurl settings?
• Example settings:

How can I crop the description text in the list view after X letters?¶

Example typoscript to crop the description in the list view after 200 letter:

plugin.tx_wtdirectory_pi1 {

list {

field.description = TEXT

field.description.field = description

field.description.crop = 200 | ... | 1

}

}

How can I change the pagebrowser output?¶

The pagebrowser could easily set via typoscript – it's just a HMENU (see typoscript above)

I want to use the category dropdown, but it's not shown – why?¶

• You have to select min. 2 categories in the flexform for the dropdown
• Or you can set in constants that all categories should be shown (don't care about selection in flexform)

Constant Editor could help you...¶

The constant editor helps you, if you want:

• Set the number of results on one page in the listview
• Change html templates
• And many more

Get a relation between tt_address and powermail¶

• Click on the powermail icon to switch to a page with powermail
• Fill in the form and the main receiver is the chosen email from the tt_address
• NOTE: Only the main receiver will be changed, cc receiver without changes

How to style the output of wt_directory¶

You can include a default css via static template

Autocomplete for search fields don't work¶

• Have you included the static template for autocomplete?
• Check if you'll see a list if you enter the eID manually (pid where your addressed are): http://yourdomain.org/?eID=wtdirectory_autocomp lete&pid=10&field=name
• Don't use mootools and protoype at the same time on the same page

What the hell is wt_doorman?¶

wt_doorman is a security class which filters piVars against bad behaviour

((generated))¶