Login / Status
developer.Resource
Home . Documentation . Document Library . Extension Manuals
Sponsors
hosted by punkt.deTYPO3 and Open Source MagazineAOE Media

1.4. Configuration

There are as usual a lot of options for configuring. These are listed below. This section could still need some work but since the extension has potential for further development, this is all you get now.

General

The plugin supports all system languages in TYPO3. Translation is done using the typo3.org tools.

If you want to use eg. danish language that will automatically be used if this option is set in your template:

config.language = dk

TypoScript Reference

There is a moderate number of TypoScript options for the two plugins. Here is a screendump from the Object Browser:

This is pretty straight forward and many of the above options may be self-explanatory or at least (in the case of ..._pi3 - the user listing) similar to other known plugins.

Tip / Side note

There is one interesting thing to comment in the above screendump and that is the setting of the value “._LOCAL_LANG.default.listFieldHeader_typo3experiences”. This value overrides the normal value found in the local_lang.php files. This opportunity is not specific for this plugin but applies generally to all modern extension made under the kickstarter. In other words you can overrule those hardcoded default labels through TypoScript! You just have to know the keys used in the local_lang files. That's all. In this case the details-display of a user will use the label “Experience with TYPO3:” instead of the default label which is just “Experience:”

The User list plugin

Property:

Data type:

Description:

Default:

CMD

[Future option]

pidList

[Future option]

recursive

[Future option]

tableParams_details

<TABLE>-params

Setting the attributes of the table tag of the table displaying the user details (single display).

A class attribute is automatically appended to this string!

border=0 cellpadding=1 cellspacing=2 width=90%

listView.results_at_a_time

int+

The number of records to show at a time in the listing

50

listView.maxPages

int+

The maximum number of “browser”-pages (<PREV, 1, 2, 3....) to show.

20

listView.show.email

boolean

Whether the email address is shown in the limited (no-login) listing of users

1

listView.show.email_in_details

boolean

Whether the email address is shown in details view (when a user is not logged in)

1

listView.alwaysPrev

boolean

Whether to always display the “<PREV” link in the browsebox.

1

listView.customProcessing.[fieldname]

cObject

Here you can configure custom processing for field values shown in the list view.

The data array ist set to the current record!

So you can access the field values on stdWrap properties by .field = thefieldname. See examples below.

The following example shows how to make the username appear in bold:

plugin.tx_newloginbox_pi3.customProcessing {

        username = TEXT
        username.field = username
        username.wrap = <b>|</b>

}

By default, the following customProcessing is set:

plugin.tx_newloginbox_pi3.listView.customProcessing {

        image = IMAGE
        image.file {
                import = uploads/pics/
                import.field = image
                import.listNum = 0
                maxW = 200
                maxH = 300
        }

}

You can easily change all the values with the TypoScript Object Browser.

singleView.customProcessing.[fieldname]

cObject

Same as listView.customProcessing just for the singleView instead.

_CSS_DEFAULT_STYLE

string

Default CSS style. You should unset this value and copy the CSS selectors to a stylesheet.

Notice that the selectors will apply to all templates in the TYPO3 database by default!

_LOCAL_LANG.[langkey].[labelkey]

string

Overriding the labels from the local lang array.

_DEFAULT_PI_VARS.[piVars_key]

string

Setting the default value of a piVars value (those values used in the post/get requests within the plugin.)

Example:

_DEFAULT_PI_VARS.pointer = 2

This will set the pointer to “Page 3” in the browsebox by default.

0

[tsref:plugin.tx_newloginbox_pi3]

The “Better login box” plugin

Property:

Data type:

Description:

Default:

storagePid

int+

The PID number of the page where the frontend-users are stored. If this is set, the “General Record Storage Page” setting is ignored.

detailsPage

int+

The PID number of the page where the details of the users should be displayed. The username is linked to this page if this PID is given.

showForgotPassword

boolean

Whether the show-forgot-password-link is shown in the login-form

domains

string

Comma separated list of domain names.

If the HTTP_REFERER URL of the user is in this list of domains, the user is redirectet to the refering URL after a successful login.

email_from

The sender email address of the “forgot password” emails

email_fromName

The sender NAME of the “forgot password” emails

tableParams_details

<TABLE>-params

Setting the attributes of the table tag of the table displaying the user details (single display).

A class attribute is automatically appended to this string!

border=0

templateFile

string

This is the default template file used to render forms,

EXT:newloginbox/res/newloginbox_00.html

replyTo

The reply-to email address of the “forgot password” emails

_CSS_DEFAULT_STYLE

string

Default CSS style. You should unset this value and copy the CSS selectors to a stylesheet.

Notice that the selectors will apply to all templates in the TYPO3 database by default!

_LOCAL_LANG.[langkey].[labelkey]

string

Overriding the labels from the local lang array.

_DEFAULT_PI_VARS.[piVars_key]

string

Setting the default value of a piVars value (those values used in the post/get requests within the plugin.)

0

[tsref:plugin.tx_newloginbox_pi1]

CSS styling

As with all modern plugins they are styled with CSS selectors. These are the selectors you can use. You'll (for now) have to guess/experiment which of them does what. Here is the default style assigned to the template.

Login form

.tx-newloginbox-pi1 table { border:2px solid #ccc; width:100%; }

.tx-newloginbox-pi1 th { background:#ccc; padding:4px; text-align:right; white-space:nowrap; width:25%; }

.tx-newloginbox-pi1 td { background:#eee; padding:4px; }

User list

.tx-newloginbox-pi3 table { border:2px solid #ccc; width:100%; }

.tx-newloginbox-pi3 th { background:#ccc; padding:4px; white-space:nowrap; text-align:right; }

.tx-newloginbox-pi3 td { background:#eee; padding:4px; }

.tx-newloginbox-pi3-listrow th { text-align:center; }

.tx-newloginbox-pi3-singleView th { width:25%; }