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

1.2.Users Manual Table Of Content 1.4.Configuration

1.3. Administration

Important

See topic 'Language files' how to get the translations for other languages. The language files must be imported separately.

Frontend Rendering

HTML Template

The default template provided with the plugin depends on which static template you are using: FE User Registration CSS-styled or FE User Registration Old Style.

When using static template FE User Registration CSS-styled, the default template is:

 EXT:sr_feuser_register/pi1/tx_srfeuserregister_pi1_css_tmpl.html

CSS Styles

Default CSS styles are defined in the default TS template setups. They will vary depending on which static template you are using: FE User Registration CSS-styled or FE User Registration Old Style.

As usual, the default CSS styles may be modified and moved to a .css file. In such a case , the location of the file should be specified by an import rule overriding the default TS template setup:

plugin.tx_srfeuserregister_pi1._CSS_DEFAULT_STYLE = @import url("fileadmin/styles/some_style_sheet_file.css");

Alternatively, the selectors may be moved to some site-wide style sheet file and the default styles may be nullified:

plugin.tx_srfeuserregister_pi1._CSS_DEFAULT_STYLE >

When using static template FE User Registration CSS-styled, the following selectors are used in the example HTML template and are defined in default TS setup:

.tx-srfeuserregister-pi1 p { }
.tx-srfeuserregister-pi1 h4 { }
.tx-srfeuserregister-pi1 legend { }
.tx-srfeuserregister-pi1 .tx-srfeuserregister-pi1-notice { }
.tx-srfeuserregister-pi1 .tx-srfeuserregister-pi1-trash {  }
.tx-srfeuserregister-pi1 a:link { }
.tx-srfeuserregister-pi1 label { }
.tx-srfeuserregister-pi1 label span { }
.tx-srfeuserregister-pi1 .tx-srfeuserregister-pi1-error { }
.tx-srfeuserregister-pi1 input { }
.tx-srfeuserregister-pi1 input[type=password] { }
* html .tx-srfeuserregister-pi1 input.tx-srfeuserregister-pi1-password { }
.tx-srfeuserregister-pi1 input[type=radio], .tx-srfeuserregister-pi1 input[type=checkbox] { }
* html .tx-srfeuserregister-pi1 input.tx-srfeuserregister-pi1-radio, * html .tx-srfeuserregister-pi1 input.tx-srfeuserregister-pi1-checkbox { }
.tx-srfeuserregister-pi1 .tx-srfeuserregister-pi1-delete-icon { }
.tx-srfeuserregister-pi1 .tx-srfeuserregister-pi1-delete-icon:hover { }
.tx-srfeuserregister-pi1 a.tx-srfeuserregister-pi1-file-view { }
.tx-srfeuserregister-pi1 ul { }
.tx-srfeuserregister-pi1 ul.tx-srfeuserregister-multiple-checkboxes { }
.tx-srfeuserregister-pi1 ul.tx-srfeuserregister-multiple-checkboxes li { }
.tx-srfeuserregister-pi1 ul.tx-srfeuserregister-multiple-checkboxes li label { }
.tx-srfeuserregister-pi1 ul.tx-srfeuserregister-multiple-checked-values { }
.tx-srfeuserregister-pi1 ul.tx-srfeuserregister-multiple-checked-values li { }
.tx-srfeuserregister-pi1 dl { }
.tx-srfeuserregister-pi1 dt, .tx-srfeuserregister-pi1 dd { }
.tx-srfeuserregister-pi1 dt { }
.tx-srfeuserregister-pi1 dd { }
* html .tx-srfeuserregister-pi1 dd { }
.tx-srfeuserregister-pi1 dd p { }
.tx-srfeuserregister-pi1 dd label { }

HTML Template Markers

The following is the list of global and main subparts markers used in the example HTML template, when using static template FE User Registration CSS-styled.

Global markers:

  1. ###CHARSET### = config.metaCharset or iso-8859-1.

Main subparts markers:

  1. ###TEMPLATE_CREATE### : template used to display the initial registration form.

  2. ###TEMPLATE_CREATE_PREVIEW### : template used to display the (optional) registration preview form.

  3. ###TEMPLATE_CREATE_LOGIN### : template used to display a link to the edit form when the front end user is already logged in.

  4. ###TEMPLATE_CREATE_SAVED### : when email confirmation request is disabled, template used to display confirmation that the account was created.

  5. ###TEMPLATE_SETFIXED_CREATE### : when email confirmation request is enabled and administrative review is disabled, template used to display confirmation that the account was created but that an email is being sent to the user to complete the registration process.

  6. ###TEMPLATE_SETFIXED_CREATE_REVIEW### : when administrative review is enabled, template used to display confirmation that the account was created but that an email is being sent to the user to complete the registration process.

  7. ###TEMPLATE_INVITE### : template used to display the initial account creation form in the case of an invitation.

  8. ###TEMPLATE_INVITE_PREVIEW### : template used to display the (recommended) account creation preview form, in the case of an invitation.

  9. ###TEMPLATE_SETFIXED_INVITE### : template used to display confirmation that an account was created and that an invitation email has been sent to the user to complete the registration process or decline the invitation..

  10. ###TEMPLATE_EDIT### : template used to display the account or profile editing form.

  11. ###TEMPLATE_EDIT_PREVIEW### : template used to display the (optional) editing preview form.

  12. ###TEMPLATE_EDIT_SAVED### : template used to display confirmation that the account was updated.

  13. ###TEMPLATE_DELETE_PREVIEW### : template used to display the deletion confirmation form.

  14. ###TEMPLATE_DELETE_SAVED### : template used to display confirmation that the account was deleted.

  15. ###TEMPLATE_SETFIXED_OK### : when administrative review is disabled, template used to display confirmation that the registration process was completed.

  16. ###TEMPLATE_SETFIXED_OK_APPROVE_REVIEW### : when administrative review is enabled, template used to display confirmation that the registration was completed, but that the registration must be accepted by the site administrator.

  17. ###TEMPLATE_SETFIXED_OK_ACCEPT### : when administrative review is enabled, template used to display the response page when the administrator accepts the account registration.

  18. ###TEMPLATE_SETFIXED_OK_ENTER### : when administrative review is enabled, template used to display the response page when the user clicks on the link in the acceptation email (without auto-login).

  19. ###TEMPLATE_SETFIXED_OK_REFUSE### : when administrative review is enabled, template used to display the response page when the administrator refuses the account registration.

  20. ###TEMPLATE_SETFIXED_OK_DELETE### : template used to display confirmation that the registration process was canceled.

  21. ###TEMPLATE_SETFIXED_FAILED### : template used to display a message when the registration or cancellation process could not be completed.

  22. ###TEMPLATE_AUTH#### : template used to display a link to the registration form.

  23. ###TEMPLATE_NO_PERMISSIONS### : template used to display a message when some illegal access is attempted.

  24. ###EMAIL_TEMPLATE_CREATE_SAVED_HTML### : when email confirmation request is disabled, template for the HTML message sent to the user when he has created an account.

  25. ###EMAIL_TEMPLATE_CREATE_SAVED### : when email confirmation request is disabled, template for the plain text message sent to the user when he has created an account.

  26. ###EMAIL_TEMPLATE_CREATE_SAVED_ADMIN### : when email confirmation request is disabled, template for the plain text notification sent to the site administrator when a user has created an account.

  27. ###EMAIL_TEMPLATE_EDIT_SAVED_HTML### : template for the HTML message sent to the user when he has updated his account.

  28. ###EMAIL_TEMPLATE_EDIT_SAVED### : template for the plain text message sent to the user when he has updated his account.

  29. ###EMAIL_TEMPLATE_EDIT_SAVED_ADMIN### : template for the plain text notification sent to the site administrator when a user has updated his account.

  30. ###EMAIL_TEMPLATE_INFOMAIL### : template for forgotten password notification

  31. ###EMAIL_TEMPLATE_SETFIXED_CREATE_HTML### : when email confirmation request is enabled and administrative review is disabled, template for the HTML message sent to the user when he has created an account and need to confirm his registration.

  32. ###EMAIL_TEMPLATE_SETFIXED_CREATE### : when email confirmation request is enabled and administrative review is disabled, template for the plain text message sent to the user when he has created an account and needs to confirm his registration.

  33. ###EMAIL_TEMPLATE_SETFIXED_CREATE_ADMIN### : when email confirmation request is enabled and administrative review is disabled, template for the plain text notification sent to the site administrator when a user has created an account and needs to confirm his registration.

  34. ###EMAIL_TEMPLATE_SETFIXED_CREATE_REVIEW_HTML### : when administrative review is enabled, template for the HTML message sent to the user when he has created and he needs to confirm his registration, and administrative review will be required.

  35. ###EMAIL_TEMPLATE_SETFIXED_CREATE_REVIEW### : when administrative review is enabled, template for the plain text message sent to the user when he has created and he needs to confirm his registration, and administrative review will be required.

  36. ###EMAIL_TEMPLATE_SETFIXED_CREATE_REVIEW_ADMIN### : when administrative review is enabled, template for the plain text notification sent to the site administrator when a user has created an account and needs to confirm his registration.

  37. ###EMAIL_TEMPLATE_SETFIXED_REVIEW_HTML### : when administrative review is enabled, template for the HTML message sent to the site administrator when a user has approved his/her registration and a decision to accept or refuse the registration is required.

  38. ###EMAIL_TEMPLATE_SETFIXED_REVIEW### : when administrative review is enabled, template for the plain text message sent to to the site administrator when a user has approved his/her registration and a decision to accept or refuse the registration is required.

  39. ###EMAIL_TEMPLATE_SETFIXED_INVITE_HTML### : template for the HTML invitation message sent to a person for whom an account has been created and requesting the invitation be accepted to confirm registration, or to decline the invitation (or ignore the message).

  40. ###EMAIL_TEMPLATE_SETFIXED_INVITE### : template for the plain text invitation message sent to a person for whom an account has been created and requesting the invitation be accepted to confirm registration, or to decline the invitation (or ignore the message).

  41. ###EMAIL_TEMPLATE_SETFIXED_INVITE_ADMIN### : template for the plain text notification sent to the site administrator when an invitation to register has been sent and the invited person needs to confirm his/her registration.

  42. ###EMAIL_TEMPLATE_SETFIXED_APPROVE_HTML### : when email confirmation request is enabled and administrative review is disabled, template for the HTML message sent to the user when he has confirmed the registration.

  43. ###EMAIL_TEMPLATE_SETFIXED_APPROVE### : when email confirmation request is enabled and administrative review is disabled, template for the plain text message sent to the user when he has confirmed the registration.

  44. ###EMAIL_TEMPLATE_SETFIXED_APPROVE_ADMIN### : when email confirmation request is enabled and administrative review is disabled, template for the plain text notification sent to the site administrator when a user has confirmed his registration.

  45. ###EMAIL_TEMPLATE_SETFIXED_APPROVE_REVIEW_HTML### : when administrative review is enabled, template for the HTML message sent to the user when he has confirmed the registration.

  46. ###EMAIL_TEMPLATE_SETFIXED_APPROVE_REVIEW### : when administrative review is enabled, template for the plain text message sent to the user when he has confirmed the registration.

  47. ###EMAIL_TEMPLATE_SETFIXED_APPROVE_REVIEW_ADMIN### : when administrative review is enabled, template for the plain text notification sent to the site administrator when a user has confirmed his registration.

  48. ###EMAIL_TEMPLATE_SETFIXED_ACCEPT_HTML### : when administrative review is enabled, template for the HTML welcome message sent to the user when the registration was accepted.

  49. ###EMAIL_TEMPLATE_SETFIXED_ACCEPT### : when administrative review is enabled, template for the plain text welcome message sent to the user when the registration was accepted.

  50. ###EMAIL_TEMPLATE_SETFIXED_ACCEPT_ADMIN### : when administrative review is enabled, template for the plain text notification sent to the site administrator when a registration was accepted.

  51. ###EMAIL_TEMPLATE_SETFIXED_REFUSE_HTML### : when administrative review is enabled, template for the HTML message sent to the user when the registration was refused.

  52. ###EMAIL_TEMPLATE_SETFIXED_REFUSE### : when administrative review is enabled, template for the plain text message sent to the user when the registration was refused.

  53. ###EMAIL_TEMPLATE_SETFIXED_REFUSE_ADMIN### : when administrative review is enabled, template for the plain text notification sent to the site administrator when a registration was refused.

  54. ###EMAIL_TEMPLATE_SETFIXED_DELETE_HTML### : template for the HTML message sent to the user when he has canceled his registration.

  55. ###EMAIL_TEMPLATE_SETFIXED_DELETE### : template for the plain text message sent to the user when he has canceled his registration.

  56. ###EMAIL_TEMPLATE_SETFIXED_DELETE_ADMIN### : template for the plain text notification sent to the site administrator when a user has canceled his registration.

  57. ###EMAIL_TEMPLATE_DELETE_SAVED_HTML### : template for the HTML message sent to the user when he has deleted his account.

  58. ###EMAIL_TEMPLATE_DELETE_SAVED### : template for the plain text message sent to the user when he has deleted his account.

  59. ###EMAIL_TEMPLATE_DELETE_SAVED_ADMIN### : template for the plain text notification sent to the site administrator when a user has deleted his account.

Localization

Language files

The main language file is pi1/locallang.xml. You can translate it with the extension 'locallang-XML translation tool'.

Send any translations and text improvements to http://bugs.typo3.org choice 'Translation & Internationalization' or send an email to this extension's authors.

Get the texts for different languages by the Extension Manager 'Translation handling' or download them manually form here http://jambage.com/development/l10n.tar.gz or http://jambage.com/development/l10n.zip and copy the needed language files into your folders under typo3conf/l10n. Use the EM to create these directories for the first time.

Adapting labels

You may adapt the labels in pi1/locallang.xml to to your needs and languages.

Any label may be overridden by inserting the appropriate assignment in your TS template setup:

plugin.tx_srfeuserregister_pi1._LOCAL_LANG.languageCode.labelName = overridingValue
You can find the name of the label you want to modify (or translate) by inspecting the extension file pi1/locallang.xml.
Overriding labels specified in TCA
You may also override by the same method labels from other files when they are referenced by the TCA definition of a field (see the tutorial section on Adding fields to the registration form). This is done as follows:
plugin.tx_srfeuserregister_pi1._LOCAL_LANG.languageCode.tableName.fieldName = overridingValue
Switching salutation mode
You may also switch the salutation mode used in these labels when this is relevant for the language being used and when the labels are either available in the pi1/locallang.xml file or provided by TypoScript setup. See the TypoScript Reference section.
Localization of user group title
This extension adds table fe_groups_language_overlay in order to allow localization of the user group title.
en_US localization
If config.language is set to en_US in TS template setup, labels localized to US English will be used in the frontend. If not available, default (en_GB) labels will be used.
Labels with variables
Some labels in pi1/locallang.php have names starting with 'v_'. In those labels, the following variables may be used:
  1. %1$s : the title of the pid containing the frontend user records created by the extension;
  2. %2$s : the user name of the frontend user;
  3. %3$s : the name of the frontend user;
  4. %4$s : the email address of the frontend user;
  5. %5$s : the password of the frontend user.
Adding extra labels
Property extraLabels in TS setup may specify a list of extra labels that may be used in the HTML template.
The values of these labels are specified in TS setup with the same type of assignment as when overriding localized labels:
plugin.tx_srfeuserregister_pi1._LOCAL_LANG.languageCode.extraLabelName = extraLabelValue



				

					

						

							1.2.Users Manual
							Table Of Content
							1.4.Configuration