LastLogin
From Contao Community Documentation
Display of last login and the list of online / offline members over Insert-Tags.
From TYPOlight 2.8 is already displayed by the login module itself the last login time.
This module now supports the internal method and also includes an insert-tag for this.
More Insert-Tags have been added over the course of development, as shown in the follow list.
Incomplete Article: This article is not finished yet and needs expansion.
Please expand it and remove this notice when it is finished. |
Extension-Overview | |
---|---|
Name of the developer | Glen Langer (BugBuster) |
Developer Website | http://www.contao.glen-langer.de |
Version of the extension | 1.6.0 rc1 |
Compatibility with Contao Version | ab 2.9 |
Compatibility with TYPOlight Version | 2.8.0 - 2.8.4 (see installations notes) |
Link to Extension Repository | http://www.contao.org/extension-list/view/lastlogin.en.html |
Donate the developer | http://www.amazon.de/wishlist/26HHEJOU03G76 |
Link to Tracker | http://dev.typolight-forge.org/projects/lastlogin/issues |
Depending of ff. Extension | memberlist (mandatory), avatar (optional) |
Comment | Version for Contao 2.9 online |
Contents
Forum
Questions about the LastLogin module will be answered in forum: Forum
Errors and requests can be reported in the Issue Tracker.
Installation
The installation of the module occurs about the extension Repository in back end of Contao.
A manual installation is possible. Download the ZIP file from Extension Repository, unzip and transfer it.
A directory should have been created "/system/modules/lastlogin".
Then call /contao/install.php - Perform Update Database.
( /typolight/install.php in older TYPOlight installations )
Note for older "TYPOlight" versions
TYPOlight 2.8
TYPOlight 2.8.x users can use the current version.
TYPOlight 2.7
Users of TYPOlight 2.7.x, please use LastLogin module version 1.4.1 (Direct Link)
Installation as an update
An update is identical to the installation.
Overview
The last login module has no back end or front end modules, it provides only insert tags.
All Insert-Tags from the module to be resistant from TL 2.8 cache by adding the prefix "cache_". When the cache is turned on in the site structure, the values of the insert tags will not be saved with the cache, but will be replaced again with each delivery from the cache.
Example: "last_login" becomes "cache_last_login.
The following Insert-Tags are currently available:
- Last Login
- last_login / cache_last_login
- Online Members
- last_login_members_online / cache_last_login_members_online
- Online Members linked
- last_login_members_online_link / cache_last_login_members_online_link
- Number registered members
- last_login_number_registered_members / cache_last_login_number_registered_members
- Number online members
- last_login_number_online_members / cache_last_login_number_online_members
- Number offline members
- last_login_number_offline_members / cache_last_login_number_offline_members
- Offline Members
- last_login_members_offline / cache_last_login_members_offline
- Offline Memberslinked
- last_login_members_offline_link / cache_last_login_members_offline_link
All the insert tags are controlled by parameters of what and how something is to be displayed. (firstname,lastname,avatar,...)
Translation in process...
Last Login
Shows the own "Last Login" time. Expandable with additional parameters.
Without the format information is generated after the system definition "dateFormat". The example of the default installation "webacademy" is there defined as: "Y-m-d".
On example would be the last login on 3.4.2009 at 16:27 o'clock: :
Last Login: {{cache_last_login}} Last Login: {{cache_last_login::d.m.y H:i}}
shows:
Last Login: 2009-04-03 Last Login: 03.04.09 16:27
Online members
Shows all the online and active members. Expandable with additional parameters. Each member must have released these fields. (Public fields)
Comma-separated output
Examples:
{{last_login_members_online::username}} {{last_login_members_online::firstname}} {{last_login_members_online::lastname}} {{last_login_members_online::fullname}} {{last_login_members_online::avatar}}
The word "username" represents the default specification, {{cache_last_login_members_online}} will also apply.
The members are displayed only when you are online.
Hint: | The term "avatar" will only work if the module "avatar" is installed. This does not happen automatically because it has not been defined as dependence in the ER. |
Output as a list
The further declaration "list", will be used the included template "mod_last_login_members.tpl".
This will output a list of the names.
Examples:
{{last_login_members_online::username::list}} {{last_login_members_online::firstname::list}} {{last_login_members_online::lastname::list}} {{last_login_members_online::fullname::list}} {{last_login_members_online::avatar::list}}
The word "username" represents the default specification, {{last_login_members_online::list}} will also apply.
The members are displayed only when you are online.
Hint: | The term "avatar" will only work if the module "avatar" is installed. This does not happen automatically because it has not been defined as dependence in the ER. |
Online members linked
Online members as a linked issue with connection to the module member list. It can be specified which field to display (first parameter) and the alias name of the site by the Member List module has been integrated (second parameter).
Use as last_login_members_online, following information are available:
{{last_login_members_online_link::username::memberlist}} {{last_login_members_online_link::firstname::memberlist}} {{last_login_members_online_link::lastname::memberlist}} {{last_login_members_online_link::fullname::memberlist}} {{last_login_members_online_link::avatar::memberlist}}
The words "username" and "memberlist" represents the default specification, {{cache_last_login_members_online_link}} will also apply.
The members are displayed only when you are online.
Examples: Output should be firstname, alias name is "mymemberlist":
{{last_login_members_online_link::firstname::mymemberlist}}
generated when there are 2 users online (with ID 4 and 5):
<div class="mod_last_login"> <ul class="members_online_link"> <li><a href="mymemberlist.html?show=4" title="Profile view">Donna</a></li> <li><a href="mymemberlist.html?show=5" title="Profile view">John</a></li> </ul> </div>
With "avatar", as follows:
<div class="mod_last_login"> <ul class="members_online_link_avatar"> <li><a href="mymemberlist.html?show=4" title="Profile view Donna Evans"> <img width="32" height="31" class="avatar" alt="avatar" src="tl_files/avatars/member_4.jpg"></a></li> <li><a href="mymemberlist.html?show=5" title="Profile view John Smith"> <img width="32" height="31" class="avatar" alt="avatar" src="tl_files/avatars/member_5.jpg"></a></li> </ul> </div>
Number registered members
Shows the number of registered members.
Examples:
There are {{cache_last_login_number_registered_members}} registered members.
Number online members
Shows the number of online members.
Examples:
There are {{cache_last_login_number_online_members}} online members.
Number offline members
Shows the number of offline members, but were already online today.
Examples:
There are {{cache_last_login_number_offline_members}} offline members, recently online.
Offline Mitglieder
Anzeige der Namen von Mitgliedern die offline sind, und vor kurzem noch online waren.
Ausgabe durch Komma getrennt
{{last_login_members_offline::username}} {{last_login_members_offline::firstname}} {{last_login_members_offline::lastname}} {{last_login_members_offline::fullname}} {{last_login_members_offline::avatar}}
Wobei die Angabe "username" die Defaultangabe darstellt, d.h. {{last_login_members_offline}} gilt ebenfalls.
Die Anzeige erfolgt nur wenn man selbst online ist.
Template:Hinweis
Ausgabe als Liste
{{last_login_members_offline::list}} {{last_login_members_offline::username::list}} {{last_login_members_offline::firstname::list}} {{last_login_members_offline::lastname::list}} {{last_login_members_offline::fullname::list}} {{last_login_members_offline::avatar::list}}
Wobei die Angabe "username" die Defaultangabe darstellt, d.h. {{last_login_members_offline::list}} gilt ebenfalls.
Die Anzeige erfolgt nur wenn man selbst online ist.
Template:Hinweis
Offline Mitglieder verlinkt
Verlinkte Ausgabe der Offline Mitglieder (vor kurzem noch online) als Verbindung zum Modul Memberlist. Dabei kann angegeben werden, welche Ausgabe erfolgen soll (erster Parameter) und der Alias Name der Seite indem das Modul Memberlist integriert wurde (zweiter Parameter).
Anwendung wie bei last_login_members_offline, folgende Angaben sind möglich:
{{last_login_members_offline_link::username::memberlist}} {{last_login_members_offline_link::firstname::memberlist}} {{last_login_members_offline_link::lastname::memberlist}} {{last_login_members_offline_link::fullname::memberlist}} {{last_login_members_offline_link::avatar::memberlist}}
Wobei die Angabe "username" und "memberlist" die Defaultangaben darstellen, d.h. {{cache_last_login_members_offline_link}} gilt ebenfalls.
Die Anzeige erfolgt nur wenn man selbst online ist.
Beispiel: Ausgabe soll Vorname sein, Aliasname ist "mitgliederliste":
{{last_login_members_offline_link::firstname::mitgliederliste}}
erzeugt wenn 2 User sind (mit ID 4 und 5):
<div class="mod_last_login_offline"> <ul class="members_offline_link"> <li><a href="mitgliederliste.html?show=4" title="Profile view">Donna</a></li> <li><a href="mitgliederliste.html?show=5" title="Profile view">John</a></li> </ul> </div>
Bei "avatar" wie folgt:
<div class="mod_last_login_offline"> <ul class="members_offline_link_avatar"> <li><a href="memberlist.html?show=4" title="Profile view Donna Evans"><img width="32" height="31" class="avatar" alt="avatar" src="tl_files/avatars/member_4.jpg"></a></li> <li><a href="memberlist.html?show=5" title="Profile view John Smith"><img width="32" height="31" class="avatar" alt="avatar" src="tl_files/avatars/member_5.jpg"></a></li> </ul> </div>