Joomla! Documentation - User contributions [en]

Potential backward compatibility issues in Joomla 3 and Joomla Platform 12.2

2012-07-13T19:53:49Z

Alfred:

{{incomplete}}{{RightTOC}}This documents track potential backward compatibility issues for Joomla 3.0 and Joomla Platform 12.1 which is included in Joomla 3.0. Listed are issues which potentially break extensions.
Please help making this document complete.

The base of this comparison is Joomla 2.5/Platform 11.4.

Backwards compatibility issues were also tracked for Joomla 2.5: [[Potential backward compatibility issues in Joomla 2.5 and Joomla Platform 11.4]]

= Platform =
The platform removed a larger number of deprecated classes and methods. For most extensions written for Joomla 2.5 the required changes should be reasonably small. Note that there are still deprecated classes in the platform that will be removed in future versions, developers should stop using them where possible.

== Updated System Requirements ==
The system requirements have changed in the following points:
*PHP 5.3.1
*register_globals must be off
*magic_quotes_gpc must be off

== General changes ==
*Almost all functions, methods, members and classed marked as deprecated 12.1 have been removed. They won't be listed in this document.
*Appending ?no_html to an URL to get a RAW view is not supported anymore (this was an old Joomla 1.0 feature)
*The DS constant has been removed. If you really need it you can use DIRECTORY_SEPARATOR instead
*Many more function arguments have been type hinted, including existing classes. Make sure you're always passing values of the correct type.
*The name of modules now have to start with mod_
*Extensions need to set the registeredurlparams now, the fall back on the URL has been removed.
*Some cookies are only accessible trough HTTP (not via JavaScript). For example the session cookie.
*Due to upcoming changes to the MVC implementation in the platform, JModel, JView, and JController are re-used as the names of the new interfaces. For now use JModelLegacy, JViewLegacy and JControllerLegacy instead.

== Changes to extension installation ==
*Use of the <install> base tag (from 1.5) is no longer supported; use <extension> instead
*Suppport for install_script and uninstall_script, and the methods com_install and com_uninstall in these scripts, has been removed; use scriptfile instead
*In language extensions, support for client="both" has been removed; package each client as a separate extension and optionally bundle them as a package extension instead
*File paths for plugins no longer support the old 1.5 method (i.e. plugins/system/cache.php); each plugin must be in its own folder (i.e. plugins/system/cache/cache.php)

== Changes to Components ==
*In admin components the admin.*.php and toolbar.*.php are not automatically included anymore. This was a Joomla 1.0 legacy feature.

== Moved files ==
All classes listed here should now be autoloadable. Explicit requires and includes have to be modified or removed.

=== Classes moved to the CMS ===
*JFormFieldHelpsite
*JFormFieldMedia
*JFormFieldMenuitem
*JFormFieldUser
*JHelp
*JTableContent

=== Classes moved within the platform ===
*JDatabaseQuery subclasses
*JInput (and all subclasses)
*JTable (and all subclasses)
*JArchive (and all subclasses)

== Renamed classes ==
*JFTP is now called JClientFtp
*JLDAP is now called JClientLdap
*JWebClient is now called JApplicationWebClient

== Removed classes ==
*JParameter (use JForm instead)
*JElement and its subclasses
*JFormFieldEditors (use JFormFieldPlugins instead)
*JHtmlImage
*JSimpleXML
*JPane

== Changes to classes ==

=== Base classes ===

==== JFactory ====
*JFactory::getXMLParser() has been removed. For RSS and Atom use cases, use JFactory::getFeedParser() instead. To read XML files or strings use JFactory::getXML().
*JFactory::_createConfig() has been removed. Use JFactory::createConfig() instead.
*JFactory::_createSession() has been removed. Use JFactory::createSession() instead.
*JFactory::_createDbo() has been removed. Use JFactory::createDbo() instead.
*JFactory::_createMailer() has been removed. Use JFactory::createMailer() instead.
*JFactory::_createDocument() has been removed. Use JFactory::createDocument() instead.

=== Application ===

==== JApplicationHelper ====
*JApplicationHelper::getPath() has been removed. No replacement.
*JApplicationHelper::_checkPath() has been removed. No replacement.

==== JController ====
*JController::$_acoSection has been removed.
*JController::$_acoSectionValue has been removed.
*JController::authorize() has been removed. Use JController::authorise() instead.
*JController:: setAccessControl() has been removed. Use JAccess.

==== JControllerLegacy ====
* JControllerLegacy::display() needs an extra parameter: ($cachable = false, $urlparams = false).

=== Archive ===

==== Adapters ====
*JArchiveBzip2 does not extend JObject anymore. You must not use any of JObject's methods.
*JArchiveGzip does not extend JObject anymore. You must not use any of JObject's methods.
*JArchiveTar does not extend JObject anymore. You must not use any of JObject's methods.
*JArchiveZip does not extend JObject anymore. You must not use any of JObject's methods.

=== Base ===

==== JObject ====
*JObject::toString() has been removed. Use JObject::__toString() instead.

=== Client ===

==== JClientLdap (formerly JLDAP) ====
*JClientLdap does not extend JObject anymore. You must not use any of JObject's methods.

=== Database ===
JDatabase had been renamed JDatabaseDriver. JDatabase is still around (but deprecated) and is the base of JDatabaseDriver, this way type hints and instance of checks keep working.

Due to lazy-connecting a connection is only opened when running a query or explicitly calling JDatabseDriver::connected(). Beware of that when checking JDatabaseDriver::connected().

==== JDatabase ====
*JDatabase::$hasQuoted has been removed.
*JDatabase::$quoted has been removed.
*JDatabase::addQuoted() has been removed.
*JDatabase::hasUTF() has been removed.
*JDatabase::debug() has been removed. Use JDatabase::setDebug() instead.
*JDatabase::explain() has been removed.
*JDatabase::getEscaped() has been removed. Use JDatabase::escape() instead.
*JDatabase::getTableFields() has been removed. Use JDatabase::getTableColumns() instead.
*JDatabase::getTicker() has been removed. Use JDatabase::count() instead.
*JDatabase::isQuoted() has been removed.
*JDatabase::loadResultArray() has been removed. Use JDatabase::loadColumn() instead.
*JDatabase::nameQuote() has been removed. Use JDatabase::quoteName() instead.
*JDatabase::queryBatch() has been removed.

=== Document ===

==== JDocument ====
*JDocument::setMetaData() the $sync argument has been removed. It was broken beyond repair.

==== JDocumentRenderer ====
*JDocumentRenderer does not extend JObject anymore. You must not use any of JObject's methods.

==== JDocumentFeed ====
*JFeedItem does not extend JObject anymore. You must not use any of JObject's methods.
*JFeedEnclosure does not extend JObject anymore. You must not use any of JObject's methods.
*JFeedImage does not extend JObject anymore. You must not use any of JObject's methods.

==== JDocumentOpenSearch ====
*JOpenSearchUrl does not extend JObject anymore. You must not use any of JObject's methods.
*JOpenSearchImage does not extend JObject anymore. You must not use any of JObject's methods.

==== JDocumentXml ====
*JDocumentXml::_name has been renamed to JDocumentXml::name

=== Environment ===

==== JBrowser ====
*JBrowser does not extend JObject anymore. You must not use any of JObject's methods.
*JBrowser::setQuirk() has been removed.
*JBrowser::hasQuirk() has been removed.
*JBrowser::getQuirk() has been removed.
*JBrowser::setFeature() has been removed.
*JBrowser::hasFeature() has been removed.
*JBrowser::getFeature() has been removed.
*JBrowser::_majorVersion has been renamed to JBrowser::majorVersion
*JBrowser::_minorVersion has been renamed to JBrowser::minorVersion
*JBrowser::_browser has been renamed to JBrowser::browser
*JBrowser::_agent has been renamed to JBrowser::agent
*JBrowser::_lowerAgent has been renamed to JBrowser::lowerAgent
*JBrowser::_accept has been renamed to JBrowser::accept
*JBrowser::_accept_parsed has been renamed to JBrowser::acceptParsed
*JBrowser::_platform has been renamed to JBrowser::platform
*JBrowser::_robots has been renamed to JBrowser::robots
*JBrowser::_mobile has been renamed to JBrowser::mobile
*JBrowser::_images has been renamed to JBrowser::images

==== JRequest ====
*JRequest::clean() has been removed.
*JRequest::_cleanVar() is now protected.

==== JURI ====
*JURI does not extend JObject anymore. You must not use any of JObject's methods.
*JUri::_uri has been renamed to JUri::uri
*JUri::_scheme has been renamed to JUri::scheme
*JUri::_host has been renamed to JUri::host
*JUri::_port has been renamed to JUri::port
*JUri::_user has been renamed to JUri::user
*JUri::_pass has been renamed to JUri::pass
*JUri::_path has been renamed to JUri::path
*JUri::_query has been renamed to JUri::query
*JUri::_fragment has been renamed to JUri::fragment
*JUri::_vars has been renamed to JUri::vars

=== Error ===

==== JError ====
*JError::isError() has been removed. Use instance of Exception instead.

==== JProfiler ====
*JProfiler does not extend JObject anymore. You must not use any of JObject's methods.
*JProfiler::_start has been renamed to JProfiler::start
*JProfiler::_prefix has been renamed to JProfiler::prefix
*JProfiler::_buffer has been renamed to JProfiler::buffer
*JProfiler::_previous_time has been renamed to JProfiler::previousTime
*JProfiler::_previous_mem has been renamed to JProfiler::previousMem
*JProfiler::_iswin has been renamed to JProfiler::isWin

=== Filesystem ===

==== JStream ====
*JStream::_fh has been renamed to JStream::fh
*JStream::_filesize has been renamed to JStream::filesize
*JStream::_context has been renamed to JStream::context
*JStream::_contextOptions has been renamed to JStream::contextOptions
*JStream::_openmode has been renamed to JStream::openmode

==== JStreamString ====
*JStream::_currentstring has been renamed to JStream::currentString
*JStream::_path has been renamed to JStream::path
*JStream::_mode has been renamed to JStream::mode
*JStream::_options has been renamed to JStream::options
*JStream::_opened_path has been renamed to JStream::openedPath
*JStream::_pos has been renamed to JStream::pos
*JStream::_len has been renamed to JStream::len
*JStream::_stat has been renamed to JStream::stat

=== Filter ===

==== JFilterInput ====
*JFilterInput does not extend JObject anymore. You must not use any of JObject's methods.

=== HTML ===

==== JHtml ====
*JHtml::_includeRelativeFiles() has been removed. Use JHtml::includeRelativeFiles() instead.
*JHtml::core() has been removed. Use JHtmlBehavior::framework() instead.
*JHtml::script() doesn't support a string as the second parameter anymore. This used to be the path to the file in Joomla 1.5 and has been removed now.
*JHtml::stylesheet() doesn't support a string as the second parameter anymore. This used to be the path to the file in Joomla 1.5 and has been removed now.

==== JHtmlAccess ====
*JHtmlAccess::assetgroups() the argument $config has been removed. It was previously unused.

==== JHtmlBehavior ====
*JHtmlBehavior::mootools() has been removed. Use JHtmlBehavior::framework instead.
*JHtmlBehavior::noframes() the argument $location has been removed. It was previously unused.

==== JHtmlList ====
*JHtmlList::ordering() the argument $chop has been removed. It was previously unused.
*JHtmlList::users(), the argument $reg has been removed.

==== JHtmlSelect ====
*JHtmlSelect::_optionDefaults has been renamed to JHtmlSelect::optionDefaults

==== JToolBar ====
*JToolBar does not extend JObject anymore. You must not use any of JObject's methods.

==== JButton ====
*JButton does not extend JObject anymore. You must not use any of JObject's methods.

==== JPagination ====
*JPagination::_viewall has been renamed to JPagination::viewall
*JPagination::_additionalUrlParams has been renamed to JPagination::additionalUrlParams

=== Installer ===

==== JInstaller ====
*JInstaller::getOverwrite() has been removed. Use JInstaller::isOverwrite() instead.
*JInstaller::getUpgrade() has been removed. Use JInstaller::isUpgrade() instead.
*JInstaller::_paths has been renamed to JInstaller::paths
*JInstaller::_upgrade has been renamed to JInstaller::upgrade
*JInstaller::_overwrite has been renamed to JInstaller::overwrite
*JInstaller::_stepStack has been renamed to JInstaller::stepStack

==== JInstallerLanguage ====
*JInstallerLanguage::_core as been renamed to JInstallerLanguage::core

=== Language ===

==== JLanguage ====
*JLanguage::getPluralSufficesCallback() has been removed. Use JLanguage::getPluralSuffixesCallback() instead.
*JLanguage::_parseLanguageFiles() has been removed. Use JLanguage::parseLanguageFiles() instead.
*JLanguage::_parseXMLLanguageFiles() has been removed. Use JLanguage::parseXMLLanguageFiles() instead.
*JLanguage::_parseXMLLanguageFile() has been removed. Use JLanguage::parseXMLLanguageFile() instead.
*JLanguage::loadLanguage() the argument $overwrite has been removed. It was previously unused.

=== Registry ===

==== JRegistry ====
*JRegistry::loadXML() has been removed. Use JRegistry::loadString() instead.
*JRegistry::loadINI() has been removed. Use JRegistry::loadString() instead.
*JRegistry::loadJSON() has been removed. Use JRegistry::loadString() instead.
*JRegistry::makeNameSpace() has been removed. No replacement.
*JRegistry::getNameSpaces() has been removed. No replacement.
*JRegistry::getValue() has been removed. Use JRegistry::get() instead.
*JRegistry::setValue() has been removed. Use JRegistry::set() instead.
*JRegistry::loadSetupFile() has been removed. No replacement.

==== JRegistryFormatINI ====
* JRegistryFormatINI::stringToObject() the second argument ($option) may not be a boolean anymore.

==== JRegistryFormatJSON ====
*JRegistryFormatJSON::stringToObject() the second argument ($option) may not be a boolean anymore.

=== Session ===

==== JSessionStorageDatabase ====
*JSessionStorageDatabase::_data has been renamed to JSessionStorageDatabase::data

=== Table ===

==== JTable ====
*JTable::canDelete() has been removed.
*JTable::toXML() has been removed.

=== Updater ===

==== JUpdate ====
*JUpdate::_xml_parser has been renamed to JUpdate::xmlParser
*JUpdate::_stack has been renamed to JUpdate::stack
*JUpdate::_state_store has been renamed to JUpdate::stateStore
*JUpdate::_current_update has been renamed to JUpdate::currentUpdate

==== JUpdater ====
*JUpdater::arrayUnique() has been removed. Use JArrayHelper::arrayUnique() instead.

=== User ===

==== JAuthentication ====
*The constant JAUTHENTICATE_STATUS_SUCCESS has been removed. Use JAuthentication::STATUS_SUCCESS instead.
*The constant JAUTHENTICATE_STATUS_CANCEL has been removed. No replacement.
*The constant JAUTHENTICATE_STATUS_FAILURE has been removed. Use JAuthentication:: STATUS_FAILURE instead.
*JAuthentication::_observers has been renamed to JAuthentication::observers
*JAuthentication::_state has been renamed to JAuthentication::state
*JAuthentication::_methods has been renamed to JAuthentication::methods

==== JUser ====
*JUser::getParameters() has been removed.
*Juser::authorisedLevels() has been removed. Use JUser::getAuthorisedViewLevels() instead.
*Juser::authorize() has been removed. Use JUser::authorise() instead.
*JUser::$usertype has been removed.

=== Utility ===

==== JBuffer ====
*JBuffer::_buffers has been renamed to JBuffer::buffers

==== JDate ====
*JDate::toMysql() has been removed. Use JDate::toSql() instead.
*JDate::toFormat() has been removed. Use JDate::format() instead.
*JDate::setOffset() has been removed.
*JDate::$offsets has been removed.
*JDate__construct() doesn't accept an numeric value for $tz anymore.
*JDate::_tz has been renamed to JDate::tz.

==== JUtility ====
*JUtility::sendMail() has been removed. Use JMail::sendMail() instead.
*JUtility::sendAdminMail() has been removed. Use JMail:: sendAdminMail() instead.
*JUtility::getHash() has been removed. Use JApplication::getHash() instead.
*JUtility::getToken() has been removed. Use JSession::getFormToken() instead.
*JUtility::isWinOS() has been removed. Use JApplication::isWinOS() instead.
*JUtility::dump() has been removed. No replacement.
*JUtility::array_unshift_ref() has been removed. No replacement.
*JUtility:: array_unshift_ref() has been removed. No replacement.

==== JXMLElement ====
*JXMLElement::data() has been removed
*JXMLElement::getAttribute() has been removed. Use SimpleXMLElement::attributes() instead.

== JavaScript ==
*Compatibility with MooTools 1.2 has been removed
*Forms that have name="adminForm" now also require id="adminForm"
*checkAll() has been removed. Use Joomla.checkAll() instead.
*isChecked() has been removed. Use Joomla.isChecked() instead.
*popupWindow() has been removed. Use Joomla.popupWindow() instead.
*tableOrdering() has been removed. Use Joomla.tableOrdering() instead.

= CMS =

== General changes ==
*JUtility is not always loaded. If you need it you have to add jimport('joomla.utilities.utility'); to your code.

== Changes to classes ==

=== Component Classes ===
*MenusModelItem::getItem() no longer returns a JObject but a stdClass.

=== Help ===

==== JHelp ====
*JHelp::createSiteList() the argument $selected has been removed. It was unused.

[[Category:Compatibility]]

Creating a profile plugin

2011-05-29T20:22:13Z

Alfred: Fixed error in the setFieldAttribute $group parameter

Profile plugin is a new extension in Joomla! 1.6. It allows the addition of supplemental fields in the registration and profile forms of the com_user front end and in the user create/edit form in the back end.

A simple example plugin is included in the basic Joomla! installation as a proof of concept. Much more complex plugins are possible.

The example plugin takes advantage of on the onContentPrepareForm and onUserAfterSave events.

Multiple profile plugins may be included and will be rendered in sequence.

There are four separate places where profiles forms are used in core extensions, and each of these four can be manipulated separately if that is desired. The two locations in the front end are the user registration form and the user profile edit form. In the back end the locations are the edit screen for users in the user manager and the My Profile view found in the Admin menu.

This page shows an example of a second plugin, named profile5. It adds a single field called something.

This is the file structure

profile5.php
profile5.xml
en-GB.plg_user_profile5.ini
en-GB.plg_user_profile5.sys.ini
/profiles/profile.xml

The supplemental fields are created with xml file in the profiles folder.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>

<form>
<fields name="profile5">
<fieldset name="profile5"
label="PLG_USER_PROFILE5_SLIDER_LABEL"
>
<field
name="something"
type="text"
id="something"
description="PLG_USER_PROFILE5_FIELD_SOMETHING_DESC"
filter="string"
label="PLG_USER_PROFILE5_FIELD_SOMETHING_LABEL"
message="PLG_USER_PROFILE5_FIELD_SOMETHING_MESSAGE"
size="30"
/>

</fieldset>
</fields>
</form>
</source>

profile5.php

<source lang="PHP">
<?php
/**
* @version
* @copyright Copyright (C) 2005 - 2010 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

defined('JPATH_BASE') or die;

/**
* An example custom profile plugin.
*
* @package Joomla.Plugins
* @subpackage user.profile
* @version 1.6
*/
class plgUserProfile5 extends JPlugin
{
/**
* @param string The context for the data
* @param int The user id
* @param object
* @return boolean
* @since 1.6
*/
function onContentPrepareData($context, $data)
{
// Check we are manipulating a valid form.
if (!in_array($context, array('com_users.profile','com_users.registration','com_users.user','com_admin.profile'))){
return true;
}

$userId = isset($data->id) ? $data->id : 0;

// Load the profile data from the database.
$db = &JFactory::getDbo();
$db->setQuery(
'SELECT profile_key, profile_value FROM #__user_profiles' .
' WHERE user_id = '.(int) $userId .
' AND profile_key LIKE \'profile5.%\'' .
' ORDER BY ordering'
);
$results = $db->loadRowList();

// Check for a database error.
if ($db->getErrorNum()) {
$this->_subject->setError($db->getErrorMsg());
return false;
}

// Merge the profile data.
$data->profile5 = array();
foreach ($results as $v) {
$k = str_replace('profile5.', '', $v[0]);
$data->profile5[$k] = $v[1];
}

return true;
}

/**
* @param JForm The form to be altered.
* @param array The associated data for the form.
* @return boolean
* @since 1.6
*/
function onContentPrepareForm($form, $data)
{
// Load user_profile plugin language
$lang = JFactory::getLanguage();
$lang->load('plg_user_profile5', JPATH_ADMINISTRATOR);

if (!($form instanceof JForm)) {
$this->_subject->setError('JERROR_NOT_A_FORM');
return false;
}
// Check we are manipulating a valid form.
if (!in_array($form->getName(), array('com_users.profile', 'com_users.registration','com_users.user','com_admin.profile'))) {
return true;
}
if ($form->getName()=='com_users.profile')
{
// Add the profile fields to the form.
JForm::addFormPath(dirname(__FILE__).'/profiles');
$form->loadFile('profile', false);

// Toggle whether the something field is required.
if ($this->params->get('profile-require_something', 1) > 0) {
$form->setFieldAttribute('something', 'required', $this->params->get('profile-require_something') == 2, 'profile5');
} else {
$form->removeField('something', 'profile5');
}
}

//In this example, we treat the frontend registration and the back end user create or edit as the same.
elseif ($form->getName()=='com_users.registration' || $form->getName()=='com_users.user' )
{
// Add the registration fields to the form.
JForm::addFormPath(dirname(__FILE__).'/profiles');
$form->loadFile('profile', false);

// Toggle whether the something field is required.
if ($this->params->get('register-require_something', 1) > 0) {
$form->setFieldAttribute('something', 'required', $this->params->get('register-require_something') == 2, 'profile5');
} else {
$form->removeField('something', 'profile5');
}
}
}

function onUserAfterSave($data, $isNew, $result, $error)
{
$userId = JArrayHelper::getValue($data, 'id', 0, 'int');

if ($userId && $result && isset($data['profile5']) && (count($data['profile5'])))
{
try
{
$db = &JFactory::getDbo();
$db->setQuery('DELETE FROM #__user_profiles WHERE user_id = '.$userId.' AND profile_key LIKE \'profile5.%\'');
if (!$db->query()) {
throw new Exception($db->getErrorMsg());
}

$tuples = array();
$order = 1;
foreach ($data['profile5'] as $k => $v) {
$tuples[] = '('.$userId.', '.$db->quote('profile5.'.$k).', '.$db->quote($v).', '.$order++.')';
}

$db->setQuery('INSERT INTO #__user_profiles VALUES '.implode(', ', $tuples));
if (!$db->query()) {
throw new Exception($db->getErrorMsg());
}
}
catch (JException $e) {
$this->_subject->setError($e->getMessage());
return false;
}
}

return true;
}

/**
* Remove all user profile information for the given user ID
*
* Method is called after user data is deleted from the database
*
* @param array $user Holds the user data
* @param boolean $success True if user was succesfully stored in the database
* @param string $msg Message
*/
function onUserAfterDelete($user, $success, $msg)
{
if (!$success) {
return false;
}

$userId = JArrayHelper::getValue($user, 'id', 0, 'int');

if ($userId)
{
try
{
$db = JFactory::getDbo();
$db->setQuery(
'DELETE FROM #__user_profiles WHERE user_id = '.$userId .
" AND profile_key LIKE 'profile5.%'"
);

if (!$db->query()) {
throw new Exception($db->getErrorMsg());
}
}
catch (JException $e)
{
$this->_subject->setError($e->getMessage());
return false;
}
}

return true;
}

}
</source>

Profile5.xml controls whether the field is required, disabled or optional in the forms. Since profile5.php says to treat backend create/edit the same as registration only two sets of options are required, register and profile.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>

<extension version="1.6" type="plugin" group="user">
<name>plg_user_profile5</name>
<author>Joomla! Project</author>
<creationDate>January 2008</creationDate>
<copyright>(C) 2005 - 2010 Open Source Matters. All rights reserved.</copyright>
<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
<authorEmail>admin@joomla.org</authorEmail>
<authorUrl>www.joomla.org</authorUrl>
<version>1.6.0</version>
<description>PLG_USER_PROFILE5_XML_DESCRIPTION</description>

<files>
<filename plugin="profile5">profile5.php</filename>
<filename>index.html</filename>
<folder>profiles</folder>
</files>

<languages>
<language tag="en-GB">en-GB.plg_user_profile5.ini</language>
<language tag="en-GB">en-GB.plg_user_profile5.sys.ini</language>
</languages>

<config>
<fields name="params">

<fieldset name="basic">
<field name="register-require-user" type="spacer"
label="PLG_USER_PROFILE5_FIELD_NAME_REGISTER_REQUIRE_USER"
/>

<field name="register-something" type="list"
description="PLG_USER_PROFILE5_FIELD_SOMETHING_DESC"
label="PLG_USER_PROFILE5_FIELD_SOMETHING_LABEL"
>
<option value="2">JOPTION_REQUIRED</option>
<option value="1">JOPTION_OPTIONAL</option>
<option value="0">JDISABLED</option>
</field>

<field name="profile-require-user" type="spacer"
label="PLG_USER_PROFILE5_FIELD_NAME_PROFILE_REQUIRE_USER"
/>

<field name="profile-require_something" type="list"
description="PLG_USER_PROFILE5_FIELD_SOMETHING_DESC"
label="PLG_USER_PROFILE5_FIELD_SOMETHING_LABEL"
>
<option value="2">JOPTION_REQUIRED</option>
<option value="1">JOPTION_OPTIONAL</option>
<option value="0">JDISABLED</option>
</field>

</fieldset>

</fields>
</config>
</extension>
</source>

en-GB.plg_user_profile5.ini

;
; Joomla! Project
; Copyright (C) 2005 - 2010 Open Source Matters. All rights reserved.
; License http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL, see LICENSE.php
; Note : All ini files need to be saved as UTF-8

PLG_USER_PROFILE5_XML_DESCRIPTION="User Profile 5 Plug-in"
PLG_USER_PROFILE5="User - Profile 5"
PLG_USER_PROFILE5_SLIDER_LABEL="User Profile 5"
PLG_USER_PROFILE5_FIELD_NAME_REGISTER_REQUIRE_USER="User profile fields for registration and administrator user profile 5 forms"
PLG_USER_PROFILE5_FIELD_NAME_PROFILE_REQUIRE_USER="User profile fields for profile 5 edit form"
PLG_USER_PROFILE5_FIELD_SOMETHING_DESC="Choose an option for the something filed"
PLG_USER_PROFILE5_FIELD_SOMETHING_LABEL="Something!"
PLG_USER_PROFILE5_FIELD_SOMETHING_MESSAGE="A Message for something!"
PLG_USER_PROFILE5_XML_DESCRIPTION="User Profile 5 Plug-in"

en-GB.plg_user_profile5.sys.ini

; $Id: en-GB.plg_user_profile.sys.ini 17052 2010-05-14 14:05:58Z infograf768 $
; Joomla! Project
; Copyright (C) 2005 - 2010 Open Source Matters. All rights reserved.
; License http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL, see LICENSE.php
; Note : All ini files need to be saved as UTF-8

PLG_USER_PROFILE5="User - Profile 5 "
PLG_USER_PROFILE5_XML_DESCRIPTION="User Profile 5 Plug-in"

By installing profile5 you can add new fields in addition to the ones in profile. You can also control which view levels see those fields.
Alternatively, you can write a more complex common plugin with varying controls for different groups.

[[Category:Tutorials]][[Category:Plugin Development]]

J1.5 talk:Component parameters

2008-09-25T18:12:30Z

Alfred:

I find the terms "frontend" and "backend" confusing when applied in this context.

also, links to the standard parameter types would be extremely useful.
http://docs.joomla.org/Standard_parameter_types

Overall, I found the article extremely useful.

Commercemeister, thanks for your comments. Could you please explain what you find confusing about frontend and backend? They are commonly used to refer to the main site and the administration parts of a Joomla! website, respectively. It would be helpful to know how you think they should be clarified (or you could even just do it yourself - that's the beauty of a wiki!). Thanks too for the note about parameter types - the article did originally link to a page with this information, but then that page was changed. I will update it.

One final point - please sign your comments using the four tildes at the end (<nowiki>~~~~</nowiki>). Thanks, [[User:Mike dowler|Mike]] 16:18, 3 September 2008 (EDT)

I'm confused about the differences between the types of parameters.
So you've got Parameters (Basic), (Advanced), (Component) and (System).

Now what kind of parameters would you put in (basic) and what in (component) if both can be overriden in the menu you create for the component ?
I just don't see the distinction between the two...
[[User:Alfred|Alfred]] 14:12, 25 September 2008 (EDT)

J1.5 talk:Component parameters

2008-09-25T18:11:24Z

Alfred: