Joomla! Documentation - User contributions [en]

Accessing the current user object

2014-04-15T11:15:39Z

Sean Clement: Removed reference to "$user = JFactory::getUser('username');" as it doesn't work

{{version/tutor|2.5,3.x}}
== Basics ==

For every request in Joomla!, there is one user. Information about this user is readily available through the Joomla! framework in the form of an object. To get this object for the current user, use the following member function of JFactory:

<source lang="php">
$user = JFactory::getUser();
</source>

Or, to get information about any other registered user you can call the function with a user 'id', e.g. for user '99';

<source lang="php">
$user = JFactory::getUser(99);
</source>

Getting a reference through getUser() ensures that only one user object is created during any one Joomla! request, saving on memory and processing time. Most of the information about the user is available through public member variables of the user object. This code displays the current user's name, email, user name and user type:

<source lang="php">
echo "Your name is {$user->name}, your email is {$user->email}, and your username is {$user->username}";
</source>
'''Note:''' Since version 1.6 Joomla has a flexible ACL system, which makes $user->usertype deprecated!

The usertype field in #__users will only contain values for users that have been migrated from Joomla 1.5, but for new created users the field will be empty.

Use $user->groups to retrieve an array with all the IDs that refer to the groups (from #__usergroups table) of a user.

== Object Member Variables and Parameters ==

These are the relevant member variables automatically generated on a call to getUser():
* id - The unique, numerical user id. Use this when referencing the user record in other database tables.
* name - The name of the user. (e.g. Vint Cerf)
* username - The login/screen name of the user. (e.g. shmuffin1979)
* email - The email address of the user. (e.g. crashoverride@hackers.com)
* password - The encrypted version of the user's password
* password_clear - Set to the user's password only when it is being changed. Otherwise, remains blank.
* usertype - <strike>The role of the user within Joomla!. (Super Administrator, Editor, etc...)</strike> Has been deprecated since Joomla 1.6. Use $user->groups to retrieve an array with all the roles of a user.
* groups - Set to the user's group ids.
* block - Set to '1' when the user is set to 'blocked' in Joomla!.
* registerDate - Set to the date when the user was first registered.
* lastvisitDate - Set to the date the user last visited the site.
* guest - If the user is not logged in, this variable will be set to '1'. The other variables will be unset or default values.
* lastResetTime - Set to the last time the password was reset.
* resetCount - Counts the number of password resets.

In addition to the member variables (which are stored in the database in columns), there are parameters for the user that hold preferences. To get one of these parameters, call the getParam() member function of the user object, passing in the name of the parameter you want along with a default value in case it is blank.

<source lang="php">
$user = JFactory::getUser();
$language = $user->getParam('language', 'the default');

echo "Your language is set to {$language}.";
</source>

== Determining Status ==

Frequently, you will just want to make sure the user is logged in before continuing. The 'guest' property will be set to '1' when the current user is not logged in. When the user is authenticated, 'guest' will be set to '0'.

<source lang="php">
$user = JFactory::getUser();

if ($user->guest) {
echo "You must login to see the content. I want your email address.";
} else {

<h1>Impromptu leftovers salad that goes well with fish</h1>
<ul>
<li>1/2 cup chopped celery</li>
<li>1/4 cup raisins</li>
<li>1 teaspoon Extra Virgin Olive Oil</li>
<li>2 tablespoons of faux Thai lemongrass marinade</li>
<li>1/4 cup shredded fresh basil</li>
<li>Sprinkling of dill weed</li>
<li>Big pinch of kosher salt</li>
<li>Several lettuce leaves</li>
</ul>

Wash the lettuce and basil and place in a salad bowl.
Get out a much smaller bowl and swish around all of the remaining ingredients.
Pour this over the greens and toss.
Serves two.

}
</source>

== Privileges ==
Not all users are given equal rights. For instance, a Super Administrator may be able to edit anyone's content, while a Publisher may only be able to edit their own. The authorise() member function can be used to determine if the current user has permission to do a certain task. The first parameter is used to identify which task we wish to check being allowed. The second represents the component we wish to retrieve the ACL information from.

<source lang="php">
$user = JFactory::getUser();

if ($user->authorise('core.edit', 'com_content'))
{
echo "You may edit all content.";
}
else
{
echo "You may not edit all content.";
}

if ($user->authorise('core.edit.own', 'com_content'))
{
echo "You may edit your own content.";
}
else
{
echo "You may not edit your own content.";
}
</source>

== Summary ==

Information about the current user is readily available in any part of your Joomla! extension. You need only fetch the object and access the member variables. You can authorise the user against the core permissions set, or create your own to suit your needs.

== External Links ==

[http://docs.joomla.org/JFactory/getUser JUser API documentation] see getInstance.

[[Category:Development]]
[[Category:Tutorials]][[Category:Framework]]
[[Category:Module Development]]
[[Category:Plugin Development]][[Category:Component Development]]

Joomla! CMS versions

2014-01-08T13:32:17Z

Sean Clement:

Check for the latest Joomla! CMS version. If you are not on the latest release, read the release notes to see if you need to upgrade. If a release is being made in order to address security issues then it is strongly advised that you upgrade as soon as possible. You can see the release history of each series in the table below. Click the '''version history link''' in the notes column to find details on exact release date, release notes and package and MD5s.

*Normally, you should use the latest version of Joomla! for a new site unless you have a specific reason not to.
*The latest version can be downloaded from the [http://joomlacode.org/gf/project/joomla/frs/?action=index Joomla! download site].
* Make sure you '''subscribe to the [http://feeds.joomla.org/JoomlaSecurityNews Joomla! Security Announcements] feed'''. This RSS feed is used to make announcements, including the availability of new releases, that could affect the security of your site. You have the option to subscribe to this feed by RSS or email.
* If you are running an earlier release of the current version (for example, you are running 2.5.1 and the current version is 2.5.6), you should upgrade to the current version. Each minor release fixes a number of bugs and/or security issues. It is always good practice to upgrade to the latest maintenance version as a first step in troubleshooting a problem and fixing any newly discovered security issues.
{{-}}
==Joomla! CMS versions==
{| border=1 cellpadding=2 cellspacing=0 style="text-align:center; border-collapse:collapse; border-color:#000;"
| rowspan=2 style="text-align:center; background-color:#4a86e8; font-weight:bold;" | CMS Version
| rowspan=2 style="text-align:center; background-color:#4a86e8; font-weight:bold;" | Available
| colspan=2 style="text-align:center; background-color:#4a86e8; font-weight:bold;" | Support
| style='display:none;' |
| rowspan=2 style="text-align:center; background-color:#4a86e8; font-weight:bold;" | End of Life
| rowspan=2 style="text-align:center; background-color:#4a86e8; font-weight:bold;" | Upgrade Type
| rowspan=2 style="text-align:center; background-color:#4a86e8; font-weight:bold;" | Notes
| rowspan=2 style="text-align:center; background-color:#4a86e8; font-weight:bold;" | Latest Release
|-
| style='display:none;' |
| style='display:none;' |
| style="text-align:center; background-color:#4a86e8; font-weight:bold;" | Bugs
| style="text-align:center; background-color:#4a86e8; font-weight:bold;" | Security
| style='display:none;' |
| style='display:none;' |
| style='display:none;' |
| style='display:none;' |
|-
| style="background-color:#f4cccc; font-weight:bold;" | 1.5
| style="background-color:#f4cccc;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc;" | Sept 2012
| style="background-color:#f4cccc;" | Migration to 2.5
| style="background-color:#f4cccc;" | Plan to migrate to 2.5 now [[Joomla 1.5 version history]]
| style="background-color:#f4cccc;" | '''EOL''' at 1.5.26
|-
| style="background-color:#f4cccc; font-weight:bold;" | 1.6
| style="background-color:#f4cccc;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc;" | Aug 2011
| style="background-color:#f4cccc;" | One-click to 2.5
| style="background-color:#f4cccc;" | Upgrade to 2.5 now [[Joomla 1.6 version history]]
| style="background-color:#f4cccc;" | 1.6.6
|-
| style="background-color:#f4cccc; font-weight:bold;" | 1.7
| style="background-color:#f4cccc;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc;" | Feb 2012
| style="background-color:#f4cccc;" | One-click to 2.5
| style="background-color:#f4cccc;" | Upgrade to 2.5 now [[Joomla 1.7 version history]]
| style="background-color:#f4cccc;" | 1.7.5
|-
| style="background-color:#d9ead3; font-weight:bold;" | 2.5
| style="background-color:#d9ead3;" | [[File:Checkmark.png|center]]
| style="background-color:#d9ead3;" | [[File:Checkmark.png|center]]
| style="background-color:#d9ead3;" | [[File:Checkmark.png|center]]
| style="background-color:#d9ead3;" | December 31st, 2014
| style="background-color:#d9ead3;" | One-click to 3.x
| style="background-color:#d9ead3;" | Recommended as-needed basis for new installs [[Joomla 2.5 version history]]
| style="background-color:#d9ead3;" | '''{{CurrentLTSVer|maintanence}}'''
|-
| style="background-color:#f4cccc; width:100px; font-weight:bold;" | 3.0
| style="background-color:#f4cccc; width:100px;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc; width:100px;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc; width:100px;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc; width:100px;" | May 2013
| style="background-color:#f4cccc; width:100px;" | One-click to 3.1
| style="background-color:#f4cccc; width:306px;" | You should use the one click upgrade to Joomla 3.1 [[Joomla 3.0 version history]]
| style="background-color:#f4cccc;" | 3.0.4
|-
| style="background-color:#f4cccc; font-weight:bold;" | 3.1
| style="background-color:#f4cccc;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc;" | [[File:X-mark.png|center]]
| style="background-color:#f4cccc;" | Dec 2013
| style="background-color:#f4cccc;" | One-click to 3.2
| style="background-color:#f4cccc;" | You should use the one click upgrade to Joomla 3.2 [[Joomla 3.1 version history]]
| style="background-color:#f4cccc;" | 3.1.6
|-
| style="background-color:#d9ead3; font-weight:bold;" | 3.2
| style="background-color:#d9ead3;" | [[File:Checkmark.png|Checkmark.png]]
| style="background-color:#d9ead3;" | [[File:Checkmark.png|center]]
| style="background-color:#d9ead3;" | [[File:Checkmark.png|center]]
| style="background-color:#d9ead3;" | Apr 2014
| style="background-color:#d9ead3;" | One-click to 3.5
| style="background-color:#d9ead3;" | Recommended for most new installs [[Joomla 3.2 version history]]
| style="background-color:#d9ead3;" | '''{{CurrentSTSVer|maintanence}}'''
|-
| style="background-color:#fff; font-weight:bold;" | 3.5
| style="background-color:#fff;" | Mar 2014
| style="background-color:#fff;" | -
| style="background-color:#fff;" | -
| style="background-color:#fff;" | December 31st, 2016
| style="background-color:#fff;" | One-click to 4.0
| style="background-color:#fff;" |
| style="background-color:#fff;" |
|-
| style="background-color:#fff; font-weight:bold;" | 4.0
| style="background-color:#fff;" | Sept 2014
| style="background-color:#fff;" | -
| style="background-color:#fff;" | -
| style="background-color:#fff;" |
| style="background-color:#fff;" |
| style="background-color:#fff;" |
| style="background-color:#fff;" |
|}

<noinclude>
[[Category:Joomla! versions]]
</noinclude>