cliffparnitzky/extended-member-inserttags

Provides additional insert tags for members.

2.0.4 2019-07-04 19:58 UTC

README

Latest Version on Packagist Installations via composer per month Installations via composer total

Contao Extension: ExtendedMemberInserttags

Provides additional insert tags for members.

Installation

Install the extension via composer: cliffparnitzky/extended-member-inserttags.

If you prefer to install it manually, download the latest release here: https://github.com/cliffparnitzky/ExtendedMemberInserttags/releases

Tracker

https://github.com/cliffparnitzky/ExtendedMemberInserttags/issues

Compatibility

  • Contao version >= 3.2.0 ... < 3.6.0
  • Contao version >= 4.4.0

Dependency

There are no dependencies to other extensions, that have to be installed.

Insert tags

Provides all known insert tags to get information of the actual logged member (replace user with member !) of this listing.

Known insert tags are:

  • {{member::firstname}} ... This tag will be replaced with the first name of the currently logged in member.
  • {{member::lastname}} ... This tag will be replaced with the last name of the currently logged in member.
  • {{member::company}} ... This tag will be replaced with the company name of the currently logged in member.
  • {{member::phone}} ... This tag will be replaced with the phone number of the currently logged in member.
  • {{member::mobile}} ... This tag will be replaced with the mobile number of the currently logged in member.
  • {{member::fax}} ... This tag will be replaced with the fax number of the currently logged in member.
  • {{member::email}} ... This tag will be replaced with the e-mail address of the currently logged in member.
  • {{member::website}} ... This tag will be replaced with the web address of the currently logged in member.
  • {{member::street}} ... This tag will be replaced with the street name of the currently logged in member.
  • {{member::postal}} ... This tag will be replaced with the postal code of the currently logged in member.
  • {{member::city}} ... This tag will be replaced with the city of the currently logged in member.
  • {{member::country}} ... This tag will be replaced with the country of the currently logged in member.
  • {{member::username}} ... This tag will be replaced with the username of the currently logged in member.

Also useful but not documented insert tags are:

  • {{member::dateOfBirth}} ... This tag will be replaced with the date of birth of the currently logged in member.
  • {{member::gender}} ... This tag will be replaced with the gender of the currently logged in member.
  • {{member::state}} ... This tag will be replaced with the state of the currently logged in member.
  • {{member::language}} ... This tag will be replaced with the language of the currently logged in member.

Additional insert tags are:

  • {{member::age}} ... This tag will be replaced with the age of the currently logged in member.
  • {{member::name}} ... This tag will be replaced with the name (combination of firstname and lastname) of the currently logged in member.
  • {{member::salutation}} ... This tag will be replaced with the salutation (Ms or Mr) for the currently logged in member.
  • {{member::welcoming::formally}} ... This tag will be replaced with a formally welcoming (Dear Ms or Dear Mr) for the currently logged in member (the short form is also possible: {{member::welcoming}}).
  • {{member::welcoming::personally}} ... This tag will be replaced with a personally welcoming (Dear) for the currently logged in member.

Improvements are

For properties with regular expression of date / time / datim (defined in eval array of DCA config) a custom dateformat could be set (e.g. {{member::dateOfBirth::d. M Y}} will be replaced with 14. Nov 1991). If no custom format was found, the systems default will be used.

For properties of datatype array and existing foreign key (defined in DCA config) the text values will be read from database (e.g. {{member::groups}} will be replaced with Piano Students, Violin Students). Additionally define a separator to be used for concating the values (e.g. {{member::groups:: / }}will be replaced with Piano Students / Violin Students)

Feature

Each inserttag can be extended with the id of a special member to get the information about it. To use this feature add the id to the insert tags {{member::ID::FIELDNAME}}, e.g.:

  • {{member::3::name}} ... This tag will be replaced with the name of the member with id 3.
  • {{member::27::email}} ... This tag will be replaced with the e-mail address of the member with id 27.
  • {{member::15::dateOfBirth::*}} ... This tag will be replaced with the date of birth of the member with id 15 (with custom format).
  • {{member::3::groups}} ... This tag will be replaced with the groups of the member with id 3 (separated with , ).
  • {{member::3::groups:: / }} ... This tag will be replaced with the groups of the member with id 3 (separated with /).