LastLogin
From Contao Community Documentation
I'm not a native English speaker. Please correct my mistakes.
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.
Extension-Overview | |
---|---|
Name of the developer | Glen Langer (BugBuster) |
Developer Website | http://www.contao.glen-langer.de |
Version of the extension | 1.7.0 beta1 |
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 |
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.
Hint: | 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 Members linked
- 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,...)
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 members
Shows offline members, recently online. Expandable with additional parameters.
Comma-separated output
{{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}}
The word "username" represents the default specification, {{last_login_members_offline}} 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
{{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}}
The word "username" represents the default specification, {{last_login_members_offline::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. |
Offline members linked
Offline members (recently online) 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_offline, following information are available:
{{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}}
The words "username" and "memberlist" represents the default specification, {{cache_last_login_members_offline_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_offline_link::firstname::mymemberlist}}
generated when there are 2 users online (with ID 4 and 5):
<div class="mod_last_login_offline"> <ul class="members_offline_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_offline"> <ul class="members_offline_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>
Tutorials
Using as HTML Module
The following code could be used to place the insert-tags to an HTML module:
<!-- indexer::stop --> <div class="mod_login"> Last Login: {{last_login::d.m.Y}} </div> <!-- indexer::continue -->
Then specify in the HTML module, "Protect module" and on "Allowed member groups" select "Select all". So that the module is shown only in a logged state.
Multilingualism
With the Insert-Tag "{{iflng}}" you could do it in several languages:
{{iflng::en}}Last login:{{iflng}}{{iflng::de}}Letzer Login:{{iflng}} {{last_login}}
When does "online" / "offline"?
In "last_login_members_online" / "last_login_number_online_members" users must perform an action (page view) have done in Contao within the last 5 minutes. (Session table)
In "last_login_members_offline" / "last_login_number_offline_members" it is quite complex, which was then so are discussed and defined:
- Users who have accessed within the session time for 5 minutes no pages (but session owner)
- Users were today or yesterday online and today offline, by logging off
- Users were online today, but have no more session, and are not logged (but session deleted)
This means you get not all appear. It will only be displayed that were recently online, but already offline or considered as such.
Limit the number of output as a list
In output as a list, it is possible by an additional parameter to limit the number. Examples of each type (with 5 lines):
{{last_login_members_online::username::list::5}} {{last_login_members_online::avatar::list::5}} {{last_login_members_online_link::lastname::memberlist::5}} {{last_login_members_online_link::avatar::memberlist::5}} {{last_login_members_offline::lastname::list::5}} {{last_login_members_offline::avatar::list::5}} {{last_login_members_offline_link::fullname::memberlist::5}} {{last_login_members_offline_link::avatar::memberlist::5}}
--BugBuster 21:32, 31 October 2010 (CET)