Actions

User

Tom Hutchison/DPL

From Joomla! Documentation

< User:Tom Hutchison(Redirected from User:Hutchy68/DPL)

Contents

Adding images

  • Upload Using Media Manager

The simplest way to add images is to upload them from your computer using the Media Manager. First, of course, you have to download the image onto your computer and be able to find it. Then, from the Control Panel (back-end administrative interface) navigate to Content -> Media Manager.

On the left is a directory tree, with the root directory "Media". This corresponds to the default "images" directory, yoursite/joomla/images. Pick a subdirectory where you want the image located, or else do nothing to upload the image to the default images directory.

At the bottom of the page is a typical Upload box. Click "Browse" to locate the image on your computer, then "Upload" to upload the file to the server.

  • FTP

Of course, you can upload images to a server using any standard FTP client. You might find this handier for adding images to template directories; however, if you have FTP set up, you probably don't need an explanation of how to add an image. Also, many server administration panels such as Cpanel and Plesk have upload capabilities.

  • Extensions

There are several extensions, available from the Joomla extensions section, that handle image uploads.


All HTML markup is stripped when you save an article

In some cases (for example, when you have a database error during the update), when you edit an article, all of the HTML markup is removed when the article is saved.

To fix this, navigate to Global Configuration → Text Filters, make sure the filters are set correctly, then Save.

This is caused by moving the Text Filter function from Article ManagerOptions → Global Configuration. In a normal 2.5.0 update, these Text Filter settings are transferred automatically.


Broken-configuration-screen-in-2.5.10

If you use memcached you may have a broken configuration screen. The best solution to this is to update to 2.5.11. If for some reason you cannot update to 2.5.11 you may apply the following hotfix.

Find the file libraries/joomla/cache/storage/memcached.php

At line 317 change Memcache to Memcached.

-    $memcached = new Memcache;
+    $memcached = new Memcached;


Can I add registration fields?


Since Joomla! 1.6 you can add extended registration fields by using a profile plugin. A sample profile plugin is included in the standard installation, offering a number of commonly requested fields such as mailing address, telephone number and date-of-birth.

See: What is a profile plugin? See also: Creating a profile plugin


Can articles be assigned to multiple categories or sections?

No, Articles and other content items cannot be assigned to multiple categories or sections.

In Joomla! Joomla 1.0 and Joomla 1.5: Content items are restricted to a single category in a single section. In Joomla! Joomla 2.5 and newer: Content items are restricted to a single category in a category tree.

Possible work-arounds include:

  • creating duplicate articles in multiple categories.
  • using menus rather than dynamic lists of content items.
  • using various third party extensions that simulate assignment to multiple categories.
  • using key words to simulate categories and sections.


Can you remove the "Powered by Joomla!" message?

Joomla 2.5 and newer Joomla 2.5Joomla 3.1

Starting with Joomla 1.5 and its move to Internationalization and full support of UTF-8, messages for footer.php and other Joomla pages has been moved to a language specific file.

As before if you want to change the text, go to the language directory, go to the folder of the language you want to change, find the mod_footer.ini file and change the relevant text. For British English, the specific file is language/en-GB/en-GB.mod_footer.ini. Remember that you may not remove copyright and license information from the source code. However note that this means that every time you update Joomla the language file will be overwritten with the old copyright.

A better solution is to create a language string override in the language. See the Joomla! 2.5 or Joomla! 3.1 help screens for more information on how to do this

If you want to remove the footer entirely, go to Extensions > Module Manager and unpublish the footer module.

Other places where can look for options to make changes are these. If you find code related to footers in these files, you can either "comment it out" or remove it:

  • /includes/footer.php file.
  • index.php file for your active template

Joomla 1.5Joomla 1.5

Starting with Joomla 1.5 and its move to Internationalization and full support of UTF-8, messages for footer.php and other Joomla pages has been moved to a language specific file.

If you want to change the text, go to the language directory, go to the folder of the language you want to change, find the mod_footer.ini file and change the relevant text. For British English, the specific file is language/en-GB/en-GB.mod_footer.ini. Remember that you may not remove copyright and license information from the source code.

If you want to remove the footer entirely, go to Extensions > Module Manager and unpublish the footer module.

Other places where can look for options to make changes are these. If you find code related to footers in these files, you can either "comment it out" or remove it:

  • /includes/footer.php file.
  • index.php file for your active template


Cannot-upload-file-in-2.5.10

If you get a message saying you cannot upload in 2.5.10 the best solution is to upgrade to 2.5.11.

If it is not possible to upgrade to 2.5.11 you can click the options button in the media manager and save, and the error will be gone.

Please note that the Flash uploader has been removed completely for security reasons.


Control Panel Breaks When Upgrading to 2.5.0

Control Panel may appear "broken" after the upgrade

Symptom

When upgrading from 1.7.3 to 2.5.0, the Control Panel may appear "broken" after the upgrade. See the image on this page.

Cause

This issue is caused by changes to the Administrative template.

How to Fix

The fix is to clear your browser's cache.

Mozilla / Firefox / Safari: hold Shift while clicking Reload, or press either Ctrl-F5 or Ctrl-R (Command-R on a Macintosh); Konqueror: click Reload or press F5; Opera: clear the cache in Tools → Preferences; Internet Explorer: hold Ctrl while clicking Refresh, or press Ctrl-F5.


Database Errors When Upgrading to 2.5.0

When upgrading from an earlier, compatible version, to 2.5.0, you may experience a database error such as the following

JInstaller: :Install: Error SQL DB function failed with error number 1060 Duplicate column name 'ordering' SQL=ALTER TABLE `j17_languages` ADD COLUMN `ordering` int(11) NOT NULL default 0 AFTER `published`; SQL = ALTER TABLE `#__languages` ADD COLUMN `ordering` int(11) NOT NULL default 0 AFTER `published`; Files Update: SQL error file DB function failed with error number 1060 Duplicate column name 'ordering' SQL=ALTER TABLE `j17_languages` ADD COLUMN `ordering` int(11) NOT NULL default 0 AFTER `published`; SQL = ALTER TABLE `#__languages` ADD COLUMN `ordering` int(11) NOT NULL default 0 AFTER `published`;"

To fix this issues, go to Extension Manager -> Database then click the fix button. This will attempt to fix any database issues caused by changes in the database structure that occurred between versions.


Disappearing articles after 2.5 upgrade

Problem: I have just upgraded to 2.5 from 1.7.3 and the only problem I have is that the articles that a specific user wrote are not being published. They still show up in the backend but not in the frontend. Other articles written by other users do show up.

Cause: If you have a user linked to a contact that is unpublished, the articles written by this user don't show up in the front.

Solution: Please check if you have a unpublished contact linked to user that wrote the articles. Also check the trashed contacts for this. The solution would be to publish the contact or to completely remove them, so empty the trash.


Editors buttons Issues in FireFox

When you are inserting images or page break (on tinyMCE), the location of the item you added is on beginning position of the article and not the original location when the mouse cursor was before press the button.

For fixing this issue, you'll require to add the next css code to the end of the file media/system/css/modal.css:

@-moz-document url-prefix() {
    .body-overlayed {
        overflow: visible;
    }
}

See also


Empty-$path-issue-in-2.5.10

In version 2.5.10 some extensions show an empty $path error. The best solution for this is to update to 2.5.11.

If for some reason you cannot update to 2.5.11 you can apply the following hot fix.

Navigate to libraries/joomla/filesystem/path.php.

At about line 202 change

if (!is_string($path)) 
to
if (!is_string($path) && !empty($path))


diff --git a/libraries/joomla/filesystem/path.php b/libraries/joomla/filesystem/path.php
index d4c8bb9..d5116c8 100644
--- a/libraries/joomla/filesystem/path.php
+++ b/libraries/joomla/filesystem/path.php
@@ -199,7 +199,7 @@ class JPath
         */
        public static function clean($path, $ds = DIRECTORY_SEPARATOR)
        {
-               if (!is_string($path))
+               if (!is_string($path) && !empty($path))
                {
                        throw new UnexpectedValueException('JPath::clean: $path is not a string.');
                }


Enabling user's registration approval by admins


A new feature added to the user registration process in Joomla 2.5 and newer is the New User's Approval by Administrators, where a user will only be able to login after an administrator approves and activates the account.

To enable it set User Activation to "Admin".

This new feature required a slight change to the parameters set in the Users Manager. The User Activation parameter now has 3 options (as opposed to 2 options in Joomla! 1.5.x) and the options can be chosen from a select list box instead of the previous radio buttons.

The options are:

  • None - No activation is needed. The user may login right after finishing the registration.
  • Self - The user will receive an e-mail message containing a link with a token to activate their account.
  • Admin - It is necessary that an administrator approves the account. Here is how the process goes:
    • After registering the new user receives an e-mail message containing a link with a token to verify their e-mail address;
    • After the user's e-mail address has been verified, all users with the Receive System Messages option enabled will receive an e-mail message notifying them that a user has verified their e-mail address and requests that their account be activated. That email message will contain a link with a token to activate the account;
    • Once an administrator has activated the account, the user will receive an e-mail message notifying them that they may now login.

This feature was a product of many suggestions made by users in the Administration Forum [2].


Error notice using search

Issue

When making a search within the search module, the next notice appears:

Notice: Trying to get property of non-object in /path/to/joomla/plugins/search/content/content.php on line 234

Fix

Go to  plugins/search/content/content.php 


Search $itemid = isset($item) ? '&Itemid='.$item->id : '';

Replace with the following line:

$itemid = isset($item->id) ? '&Itemid='.$item->id : '';


Save

See also


Fatal error: Call to undefined method JInstaller::parseXMLInstallFile()

Fatal error: Using $this when not in object context in /libraries/joomla/application/base.php on line 87

See this tracker item. Apply the patch of the tracker item.


Ftp-update-not-working

There have been reports that updates with the FTP layer enabled are not working. Currently there is not a fix for this, but it is suggested that rather than use the updater you install the new Joomla version using the standard extension manager install. If that does not work, you can ftp the update zip filed to your host and unzip the new files, replacing the old ones. You will need to manually run the database changes using the appropriate version script found in administrator/components/com_admin/sql.

You will also need to manually delete the Flash uploader files from the media folder.

How can you view a live site while developing, but hide it from others?

Introduction

The method described below should be used for relatively minor modifications, such as adjusting menus or quickly reorganizing content sections. More complex tasks, such as installing new components or adjusting complex configuration settings should be performed and tested on a development server first. Not only does this keep your public site up and running, but it also lets you test at your leisure, thus reducing errors. One way to do it is to create a sub-domain (i. e., dev.yourdomain.com) and install Joomla! there just as it is installed on your public site.

Directions

  1. Log in to the Back-end, and choose: Site > Global Configuration.
  2. The first option you'll see is is to set the site offline. Choose "Yes" and press the Save button. This will prevent display of all site pages and replace them with the following message:
    This site is down for maintenance. Please check back again soon.
    
  3. While you are logged into the Back-end administrator system, you can still view the Front-end, by
    • Joomla 3.x: clicking the site name in the top left corner
    • Joomla 2.5: clicking the Preview link in the top right corner
    This will display the site as it would appear to users along with a warning at the top that the site is down for maintenance.


How do I upgrade to Joomla! 3.x?

  • First, review the system requirements for Joomla 3.x and make sure that your server environment meets those requirements.
  • Second, make sure that all your extensions (especially, your templates) are Joomla 3.x compatible.
  • Third, create a test site and test the upgrade on the test site first.
  • Fourth, consult a trusted developer if you’re not 100% certain about anything.
  • Fifth, make a full backup of your site (files and database).

Once ready, go to the Joomla! Update component. Click on options and change the setting to Short Term Support. Save. You should be notified of the availability of Joomla 3.x. Click the button to install. Clear your browser’s cache to make sure you see the latest changes. That’s it!

Finally, double check and make sure that everything is working properly.

Note: On some hosts you may need to use alternative update methods such as using the extensions installer.

How do you find a Joomla! extension?

The official Joomla! extensions site: http://extensions.joomla.org/ is the main source for extensions. If you cannot find what you need there, you should also search the Joomla! Extensions Directory Forum.

If you still cannot find the right component then you should post a request or question in the Extensions Directory forum.

</noinclude>

How do you list your extension in the extensions site?

Information on how to list extensions in the extensions site is available here: http://extensions.joomla.org/help2


Before submitting an extension to JED you should read the 4 steps checklist process


How do you set global preferences for content?


Global preferences in content are set in the article manager.

In the backend, go to Content>Article manager.

On the tool bar, second from the right, there is the options icon.

Click that and set your global preferences.


How do you set parameters for articles and other content items?


In Joomla!, many Article parameters, such as Show Title, Show Author, and so on, can be set in three places:

  1. The individual article (the Article:[Edit] screen)
  2. The menu item (Menu Item:[Edit] screen)
  3. Global parameters (Article Manager / Options)

Typically, parameters at the individual article and menu item levels can be set to a specific value or to a value of "Use Global". If the individual article's parameter is set, then that value controls the setting. If this is set to "Use Global" then the menu item parameter is checked. If the menu item is set to a specific value, that value is used. If the menu item is set to "Use Global", then the global parameter setting is used.

A similar hierarchy is used for other content items, such as Banners, Contacts, News Feeds, and Web Links.

How do you use Recaptcha in Joomla?

Native Recaptcha was added into Joomla in version Joomla 2.5. Using Recaptcha is a great way of preventing bots from making fake accounts and content on your site.

There are five steps to setting up Recaptcha:

  1. Log in to your administrator back-end (How do I do this?)
  2. To enable Recaptcha
    • For Contact forms and the Registration form
      • Go to Global Configuration, and select the "Site" tab.
      • Choose "Captcha - Recaptcha" in your "Default Captcha" field.
      • Click Save & Close.
    • For the Registration form only
      • Go to your User Manager. You can find this under Users along the top menu or in the buttons on the main page of your Administrator panel.
      • Choose one of the following
        • "Use Default" in your "Default Captcha" field. (This is the default setting and follows the "Default Captcha" field setting in Global Configuration)
        • "None Selected" in your "Default Captcha" field. (This setting ignors the "Default Captcha" field setting in Global Configuration. Used when you want Recaptcha in Contact forms but not in the Registration form.)
        • "Captcha - Recaptcha" in your "Default Captcha" field. (Only needed if "Default Captcha" field setting in Global Configuration is set to "-None Selected-" and when you want the Recaptcha in contact form but not in the Contact forms).
      • Click Save & Close.
  3. Go to your Plug-In Manager. You can find this under the Extensions drop down menu in the top menu or in the buttons on the main page of your Administrator panel.
  4. Edit the Plug-In "Captcha - ReCaptcha"
    • Set Status to "Enabled"
    • Copy and paste the Public and Private keys in their appropriate fields on the right.
      • To get the Public and Private keys by signing in with your Google account (create an account if you don't have one) here: Create a reCAPTCHA key
      • Once you have register your website domain, and Google will provide you with your ReCaptcha keys.
    • Click Save & Close

That's it! You're done!


J2.5:How to add a span element to menu entries

To add a span element to your menu items (like there was in Joomla 1.5), you have to override the layout for mod_menu. You can follow the general approach described in How to override the output from the Joomla! core.

You need to override the following layout from mod_menu:

  • defult_url.php
  • default_component.php

After copying the files into your template (see How to override the output from the Joomla! core for details) do the following:

In both these files look for the following statement:

<?php echo $linktype; ?>

It should occur three times in both files.

Replace each of these with:

<span><?php echo $linktype; ?></span>

And you're done.


Issues with the Contact form and Gmail and GoogleApps

Problem

The reply-to email address is not used when replying to emails sent from the Contact component and the email is sent to yourself.

Explanation

Joomla sends emails from the Contacts component with the following headers

From: email address set as the site email address in the global configuration '"To:'" email address set in the contact component '"Reply-to:'" email address of the person who submitted the contact form

Expected Behaviour

On receiving the email you should be able to hit reply and the email is sent to the email address set in the reply-to field. This is the correct behaviour as defined in the Internet (http://tools.ietf.org/html/rfc5322).

Known Issue

IF you are using Gmail or GoogleApps AND the "From" address is one of your "Send mail as" addresses then the "Reply-to" email address is ignored and the reply is sent to the "From" address.

Solution

The best solution to this is to set the site email address in the global configuration for your website to an email address that is NOT one of your "Send mail as" addresses in Gmail.


Joomla Update Missing in from Admin Menu

Starting with version 2.5.4, the Joomla core is updated with the new component Joomla Update instead of in Extensions/Install/Update.

If Joomla Update does not shows as an installed component the menuitem could be wrong. Run this SQL statement:

UPDATE #__menu
SET component_id =
  (SELECT extension_id FROM #__extensions WHERE name = "com_joomlaupdate")
WHERE title = "com_joomlaupdate"

It should update 1 row, if not use the Discover function and install it as a component.

If Joomla Update shows as an installed component but is not in the Admin Menu under Components, you are missing the entry in the database table #__menu.

INSERT INTO `#__menu` (`menutype`, `title`, `alias`, `note`, `path`, `link`, `type`, `published`, `parent_id`, `level`, `component_id`, `ordering`, `checked_out`, `checked_out_time`, `browserNav`, `access`, `img`, `template_style_id`, `params`, `lft`, `rgt`, `home`, `language`, `client_id`) 
VALUES ('menu', 'com_joomlaupdate', 'Joomla! Update', '', 'Joomla! Update', 'index.php?option=com_joomlaupdate', 'component', 0, 1, 1, (SELECT extension_id FROM #__extensions WHERE `name` = 'com_joomlaupdate'), 0, 0, '0000-00-00 00:00:00', 0, 0, 'class:joomlaupdate', 0, '', 41, 42, 0, '*', 1);

Replace the "#_" of #__menu and #__extensions with the prefix of your database table (System --> Global Configuration --> Server --> Database Tables Prefix).

Example: vy2bp_menu and vy2bp_extensions (only one underline)

Missing-intro-text-and-images-in 2.5.10

Updating to 2.5.10 may lead to the "disappearance" of intro text and images from featured or blog article views. To fix please update to 2.5.11.

If for some reason updating to 2.5.11 is not possible, change "Show Intro Text" to Show. This may temporarily cause your full article to display the intro text when you don't want that. In that case you should change the Show Intro Text for each impacted article to Hide. A more complete solution can also be implemented by creating a template override.


Missing Save buttons on editing an article

When trying to edit an article there are missing buttons

  • Save & New
  • Save as Copy

See this tracker item, including the patch.


Modals Stop Working When Upgrading to 2.5.0

When upgrading from 1.7.3 to 2.5.0, modal "pop-ups" may stop working and be displayed full-page (as seen below) with the Save, Save and Close, and Cancel buttons unresponsive.

Joomla-2-5-0-upgrade-article-options-modal-browser-cache-issue.png

This issue is caused by changes to the Administrative template. The fix is to clear your browser's cache. For specific instructions on how to do this, please see:

Multilingual-problems-after-updating-to-2.5.11-or-3.1.1

Some (but not all) multilingual sites experience a problem where all content not in the default language is not displayed and the language filter module does not seem to work.


An official fix is not yet announced. However there were two changes that may be causing this issue and users may want to try fixing these. Try each fix in order and test to see if it resolves the problem.

First, if you have contact data you must ensure that every contact has a language (if it says "Undefined" in the contact manager, that tells you no language is assigned) and every contact that has a linked user should either have a version set to language ALL or else have one version set to each content language used on your site. That is if you have 3 languages you must either have 3 separate contacts or you must have one set to all.


Second, open the language filter plugin, make sure the cookie lifetime is set to year and save.



No-updates-shown-in-current-version

There are some reports that updates that have been released are not shown in the current (older) version. If this occurs, go to the Updates tab of the Extensions Manager. Click the clear cache icon. Then click the check for updates icon.


Please first make a selection from the list

This error message manifests on Administrator Forms for many non-core extensions even when an item has been selected.

This backwards compatibility error will be fixed in core for 2.5.1.

Temporary Workaround

Install the plugin from this forum item [3]

Extension Developers

To address this problem now so that your users do not have to wait for a core fix, update your Administrator forms and change name="adminForm" to id="adminForm". If backwards compatibility is required, simply use both values in the form definition. In future releases, Joomla will only support id="adminForm"

Patch

A patch has been created to fix the backwards compatibility in 2.5.1


Should I launch a Joomla! 2.5 site or a 3.x site?

For new sites, the Joomla! 3 series is the preferred series and starting on it avoids an update from Joomla 2.5 later down the road. Starting on the Joomla 3 series for a new site, also provides you with longer backward compatible support (with one-click upgrades) than starting a new site on 2.5. Joomla 2.5 will reach EOL (end of life) 31 Dec 2014.

Sites that are currently on Joomla 2.5 are encouraged to start planning now for an upgrade to 3.3 or greater, unless you want to move over sooner to take advantage of Joomla 3’s new features. We’ve provided a one-click upgrade from Joomla 2.5 to any Joomla 3 version and you just have to make sure that all your extensions and template are compatible before upgrading. (See the “How do I find Joomla 3.x compatible extensions?” FAQ below for more information)

Should I update from Joomla! 2.5 to 3.x?

In most cases, you will need to start planning on an upgrade to Joomla! 3.x. Joomla 2.5 will continue be supported until December 31st of 2014 and you can update directly to Joomla 3. Joomla is tried-and-tested thoroughly by other users already and stable for production sites now.

You will need to verify your template and components will work with Joomla 3.x before upgrading. All core components are upgrade ready right now.

Update did not finish successfully

In some slower shared host environments (for example, godaddy.com), the automatic update methods can fail in some cases. This appears to happen when the server is busy and the update is unable to complete within a given amount of time (for example, in 2 minutes for godaddy.com).

In this case, the update may be partially completed and the site may be damaged. You can repair the site using the Manually Copy New Program Files update method.

Also, there is a free third party extension called Admin Tools that can do updates on slower shared host systems.

See also


Version number is missing in back-end 2.5.0

In older versions of Joomla the version number is displayed in the footer of the back-end.

In Joomla 2.5.0 the version is shown in the System Information and is no longer coded in the admin template for security reasons. This is inconvenient and this has been discussed in the Joomla BugSquad.

The Joomla Bug Squad has developed a little admin module that shows the version in the footer position of your admin template like

Joomla! 2.5.0 Stable [ Ember ] 24-Jan-2012 14:00 GMT

and will be updated automatically with each release in your administrator back-end.

More information, see: http://forum.joomla.org/viewtopic.php?p=2727456#p2727456


What are the major differences between Joomla! 2.5 and 3.x?

The most noticeable difference is the totally revamped administrator, which is updated to a modern design with many simpler and more friendly user-interfaces. Also, starting with Joomla! 3.0, Joomla! is now device responsive. Simply, Joomla! is mobile friendly and can be used with any modern device.

In addition, there are dozens of improvements to the details of all of the Joomla core. Some highlights are:

Star icon.png A new installer which you will notice when creating a new Joomla 3.x install.
Star icon.png Joomla 3 is packed with goodies for extension developers, such as Bootstrap support and jQuery support.
Star icon.png Joomla 3.1 adds Tagging capability.

What do the locks mean and how do you get rid of them?

At any given time you may see a padlock next to a specific item in Joomla!'s administrative backend. These padlocks may be displayed next to any of the following (Content Items, Menu Items, Modules, etc).

The Joomla! system places these padlocks next to an item to indicate that a user is currently editing the item (i.e. the item is "checked out"). The lock is removed when the user clicks on the "Save" or "Close" button for that item. If the user never clicks "Save" or "Close" and instead hits the "Back" button or navigates to another page, then the item remains locked. If a different user needs to work with an item that is in the "checked out" state he or she must first ask a manager or administrator to check the item in before any new changes can be made.

Checking Items In

There are three ways of checking items back in. One way is to contact the person that has the item checked out to see if they are done with the item. You can hover the cursor above the lock and the tooltip popup will display the name of the user who checked out the article.

If you have access to the administrative backend and sufficient rights and can also either click on the padlock to check only this item back in or click on Site->Maintenance->Global Check-in to check all items in.

The later option should be used very carefully, especially in multi-user environments. This single action checks in all previously checked out items, whether they were checked out by you or not. Possible undesirable side effects may be that multiple editors end up working on the same document. In this case whoever clicks the save button last has their version saved as the final copy.


What if an extension only works on Joomla! 2.5 and not 3.x?

You need to speak with the extension developer to see if they have plans to release that extension for Joomla 3 in the immediate future. Developers do have to make some changes but how extensive they are depends on the extension.

What is the contact creator?


The contact creator is a plugin that automatically creates a linked contact record every time you create a new user.

The contact creator is disabled by default; enable it in the plugin manage.


What is the profile plugin?


The profile plugin makes it possible to add extra fields to the user profile form in 4 places:

  • The registration form
  • The frontend profile editing view
  • The backend profile editing view (My Profile)
  • The backend user manager user edit view.

Each of these are controlled independently. They can all be the same or specific fields can be available in each form. Similarly, fields can be set as required independently for each form or all can be the same.

Any field type from the form library can be used.

Optionally the profile for a linked user can be displayed in linked content record.

Multiple profile plugins may be used.

See Creating a profile plugin for more details.


What version of Joomla! should you use?

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 Joomla! download site.
  • Make sure you subscribe to the 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

CMS Version Available Support End of Life Upgrade Type Notes Latest Release
Bugs Security
1.5
X-mark.png
X-mark.png
X-mark.png
Sept 2012 Migration to 2.5 Plan to migrate to 2.5 now
Joomla 1.5 version history
EOL at 1.5.26
1.6
X-mark.png
X-mark.png
X-mark.png
Aug 2011 One-click to 2.5 Upgrade to 2.5 now
Joomla 1.6 version history
1.6.6
1.7
X-mark.png
X-mark.png
X-mark.png
Feb 2012 One-click to 2.5 Upgrade to 2.5 now
Joomla 1.7 version history
1.7.5
2.5
Checkmark.png
Checkmark.png
Checkmark.png
December 31st, 2014 One-click core to 3.x Start planning for an upgrade to 3.3.6
Joomla 2.5 version history
2.5.27
3.0
X-mark.png
X-mark.png
X-mark.png
May 2013 One-click to 3.1 You should use the one click upgrade
Joomla 3.0 version history
3.0.4
3.1
X-mark.png
X-mark.png
X-mark.png
Dec 2013 One-click to 3.2 You should use the one click upgrade
Joomla 3.1 version history
3.1.6
3.2
Checkmark.png
Checkmark.png
Checkmark.png
Oct 2014[1] One-click to 3.3 You should upgrade your server's PHP to 5.3.10 or greater and upgrade to 3.3
Joomla 3.2 version history
3.2.4
3.3
Checkmark.png
Checkmark.png
Checkmark.png
3.4 release One-click Recommended for all new installs
Joomla 3.3 version history
3.3.6
3.4[2] July 2014[2][3] - - 3.5 release One-click
3.5[2] Sept 2014[2][3] - - 3.6 release One-click
... ... ... ... ... ... ... ...
3.11[2] (Autumn 2015)[2][3] - - ≥ Oct 2017[2] One-click Estimated EOL and last minor release on Joomla 3's roadmap
4.0 Q2 2015[3] - -


Included External Libraries

A Joomla! installation contain external libraries which are included with Joomla! CMS version releases. These external libraries are not part of the core code. Please read the Notes section as they may contain more information, such as a external library version change released with a maintenance release.

External Libraries by Joomla Release

CMS Version CMS Version Supported Mootools Mootools More jQuery jQuery UI
(Core, Widget, Mouse, Position, and Sortable)
Bootstrap Simple Pie PHP Mailer PHP UTF-8 IDNA Convert Rapid Application Development (RAD) Framework
Akeeba's Framework on Framework(FOF)
password_compat[4]
2.5
Checkmark.png
1.4.5[5] 1.4.0.1 N/A[6] N/A[6] N/A[6] 1.2 5.2.1 0.5 N/A[6] N/A[7] N/A[8]
3.0
X-mark.png
1.4.5 1.4.0.1 1.8.1 1.8.23 2.1.0 1.2 5.2.1 0.5 N/A[9] N/A[7] N/A[8]
3.1
X-mark.png
1.4.5 1.4.0.1 1.8.3 1.8.23 2.1.0 1.2[10] 5.2.3 0.5 N/A[9] N/A[7] N/A[8]
3.1.2
X-mark.png
1.4.5 1.4.0.1 1.8.3 1.8.23 2.3.2[11] 1.2[10] 5.2.6 0.5 0.8.0 N/A[7] N/A[8]
3.2
Checkmark.png
1.4.5 1.4.0.1 1.10.2[12] 1.9.2 2.3.2[11] 1.2[10] 5.2.6 0.5 0.8.0 2.1 1.0.3
3.3
Checkmark.png
1.4.5 1.4.0.1 1.11.1[12] 1.9.2 2.3.2[11] 1.2[10] 5.2.6 0.5 0.8.0 2.1 1.0.3


Joomla! versions explained

Stop hand nuvola.svg.png
Information is out of date

This information is out of date and being updated. The new development strategy is announced here, please read the full text of the development strategy for more information. This notice was modified on 30 Apr 2014.


Joomla! is developed using a fixed release cycle. Every six months, the Joomla! Project releases a new minor or major version of Joomla!. Joomla!'s version format is:

[major].[minor].[maintenance]

Each version of Joomla! is supported by the Joomla! Project for a limited amount of time. There are two classifications for support: short term support (STS) and long term support (LTS). Every fourth release will be assigned long term support.

  • STS (short term support) releases are supported for seven months. Their support ends one month after the next release of Joomla is released. They are one click upgrades to the next STS or LTS version.
  • LTS (long term support) releases are supported for twenty-seven months.

Please note that both STS and LTS releases, once they have reached the GA (General Availability) status, are fully functional and ready to be used in production environment. The disadvantage of using STS releases is that you will need to update your installation of Joomla! every six months, while the advantage is that you will have access to new features and extensions earlier.

Generally, the first STS release after an LTS release indicates the beginning of a new major release cycle. This STS release introduces fundamentally new features and changes that break compatibility with the previous LTS. Two more STS releases follow (usually compatible with the first STS release), and the release cycle is finished by the release of an LTS release which finalizes the work of the three STS releases. The four releases in one cycle will usually be numbered [major].0,[major].1 and [major].2 (STS) and [major].5 (LTS). For example, the STS release 3.0 will include breaking changes from 2.5, and 3.5 will include matured versions of the changes in 3.0, 3.1 and 3.2.

Usually, there will be a migration path (an officially supported way of migrating to the next version) between two LTS releases (from [major].5 to [next major].5) and between an LTS release and the STS releases in its major release cycle (from [major].2 to [major].5, for example), but not necessarily to the following STS releases (from [major].5 to [next major].0). In the case of 1.5 to 2.5 (LTS to LTS), for example, there is a migration path. Note that in the case of 2.5 to 3.0 (LTS to STS), there is also built-in migration path, since the changes aren't too incompatible.

For more information, see the official Development Strategy.

The latest STS version documented on this Wiki is 3.3.6 (see Category:Joomla! 3.3). The latest LTS version documented on this Wiki is 2.5.27 (see Category:Joomla! 2.5).


References and Notes

  1. Bug fixes will cease April 2014, security fixes only, see http://community.joomla.org/blogs/leadership/1798-raising-the-bar-on-security.html.

    "Also, for the six months after Joomla! 3.3 is released, the Joomla! Project will be releasing Security Updates for both 3.2 AND 3.3 (as well as 2.5) so any new vulnerabilities can be promptly patched with a one-click update without the need to immediately update to Joomla! 3.3, giving you time to request your hosting provider to update their PHP version."

  2. 2.0 2.1 2.2 2.3 2.4 2.5 2.6 See J3's roadmap for time frames of all future releases of all Joomla! 3 versions.
  3. 3.0 3.1 3.2 3.3 Please note that dates may be subject to change depending on availability of volunteers and circumstances beyond the PLT's control.
  4. This library is intended to provide forward compatibility with the password_* functions which were added to PHP 5.5. See [1] for further information. password_compat git
  5. Contains a 1.2 compatibility layer
  6. 6.0 6.1 6.2 6.3 Not applicable, this library was not included with Joomla! CMS version 2.5.
  7. 7.0 7.1 7.2 7.3 Not applicable, this library was not included with the Joomla! CMS prior to version 3.2. The version of FOF included in Joomla 3.2 is compatible with Joomla 2.5 however.
  8. 8.0 8.1 8.2 8.3 Not applicable, this library was not included with the Joomla! CMS prior to version 3.2
  9. 9.0 9.1 Not applicable, this library was not included with the Joomla! CMS prior to version 3.1.2.
  10. 10.0 10.1 10.2 10.3 This library was deprecated for JFeedFactory in Joomla! CMS version 3.1.0
  11. 11.0 11.1 11.2 Contains some 2.1 backward compatibility defaults
  12. 12.0 12.1 Includes jQuery Migrate plugin 1.2.1 for backwards compatibility


Where are the sections?

Joomla! 2.5 eliminates sections and instead allows you to use categories within categories, with as many levels of categories as you choose. All content must be in a category, but it is not necessary to have multiple categories or levels.


Where is the auto update for Joomla?

Starting with version 2.5.4, the auto update for Joomla is now located in Components→Joomla! Update, as shown here:
Version-2-5-5-faq-screenshot.png
Extensions are still updated using the Extension Manager (Extensions→Extension Manager). If you click on the Joomla! Update icon in the Control Panel, it will link you to the Joomla! Update component automatically.


Why can't a user see anything on the backend?

This usually happens because a user has been given membership in a group with rights to access the backend but the group has not been assigned to a viewing access level. By default most assets (mainly modules such as the administrator menu and Quick Icons) in the backend are assigned to viewing access level Special. So, most commonly you will want to assign any group with backend rights to the special access level in addition to any other levels it might be assigned.


Why is my Joomla! 2.5 site update manager showing an update to 3.x?

Not unless you’re 1000% sure. By default, Joomla will not let you update to 3.x unless you activate the option within the Joomla! Update component (administrator >> Component >> Joomla! Update >> Options >> Update server >> Short Term Support). If for some reason you’ve changed this, and you’d like the updater to stop letting you upgrade, change the setting to Long Term Support. After making this change, you’ll only receive updates for Joomla 2.5.

Notice: You should not upgrade from Joomla 2.5 to Joomla 3.x unless you are certain that all of your additionally installed extensions (from third party developers), especially templates, are Joomla 3.x ready or have a Joomla 3.x version that you can upgrade to.


Will my Joomla! 2.5 extensions work with Joomla! 3.x?

Extensions that are native to Joomla 2.5 should work on Joomla 3.0 with very little change, if any. Components and templates will need the most work, while modules and plugins should work without issue (assuming they do not use deprecated methods). Extensions that support Joomla 2.5 and 1.5 in the same package will likely not work right away, until the developers update them for Joomla 3 compatibility.

In short, it depends on the extension. The Joomla Project has made the process relatively easy for most extensions, however for some extensions it’s going to take some work. To be certain, let the developers of the extensions know that you want to use their extension on Joomla 3 and consult with their documentation.

Will your 1.0 extensions still work?

Joomla 2.5 and newer Joomla 2.5Joomla 3.x

Extensions written for Joomla 1.0 will not work in Joomla 2.5 and newer. The legacy system used in Joomla 1.5 has been removed.

Joomla 1.5 Joomla 1.5

There is a legacy system in place that will allow extensions that are not 1.5 compatible to continue to operate. However, we strongly recommend that you update to the current version of all extensions prior to migration and that you check each extension's home page for specific recommendations about migration for that extension.

To activate the legacy support, go to the Plugin Manager and enable the legacy plugin.


Wrong date format in profile plugin

If you see % (ampersand) in your date field, which is part of the profile plugin (date of birth field), you can fix it easily with editing the file plugins/user/profile/profile.php.

Line #227 currently (Joomla! 2.5.1) is:

$data['profile']['dob'] = $date->format('%Y-%m-%d');

and should be changed to:

$data['profile']['dob'] = $date->format('Y-m-d');

See also


Articles in Category: Version 2.5 FAQ
Adding images
All HTML markup is stripped when you save an article
Broken-configuration-screen-in-2.5.10
Can I add registration fields?
Can articles be assigned to multiple categories or sections?
Can you remove the "Powered by Joomla!" message?
Cannot-upload-file-in-2.5.10
Control Panel Breaks When Upgrading to 2.5.0
Database Errors When Upgrading to 2.5.0
Disappearing articles after 2.5 upgrade
Editors buttons Issues in FireFox
Empty-$path-issue-in-2.5.10
Enabling user's registration approval by admins
Error notice using search
Fatal error: Call to undefined method JInstaller::parseXMLInstallFile()
Fatal error: Using $this when not in object context in /libraries/joomla/application/base.php on line 87
Ftp-update-not-working
How can you view a live site while developing, but hide it from others?
How do I upgrade to Joomla! 3.x?
How do you find a Joomla! extension?
How do you list your extension in the extensions site?
How do you set global preferences for content?
How do you set parameters for articles and other content items?
How do you use Recaptcha in Joomla?
J2.5:How to add a span element to menu entries
Issues with the Contact form and Gmail and GoogleApps
Joomla Update Missing in from Admin Menu
Missing-intro-text-and-images-in 2.5.10
Missing Save buttons on editing an article
Modals Stop Working When Upgrading to 2.5.0
Multilingual-problems-after-updating-to-2.5.11-or-3.1.1
No-updates-shown-in-current-version
Please first make a selection from the list
Should I launch a Joomla! 2.5 site or a 3.x site?
Should I update from Joomla! 2.5 to 3.x?
Update did not finish successfully
Category:Version 2.5.0 FAQ
Category:Version 2.5.10 FAQ
Category:Version 2.5.11 FAQ
Category:Version 2.5.12 FAQ
Category:Version 2.5.13 FAQ
Category:Version 2.5.14 FAQ
Category:Version 2.5.15 FAQ
Category:Version 2.5.16 FAQ
Category:Version 2.5.17 FAQ
Category:Version 2.5.18 FAQ
Category:Version 2.5.19 FAQ
Category:Version 2.5.1 FAQ
Category:Version 2.5.20 FAQ
Category:Version 2.5.21 FAQ
Category:Version 2.5.22 FAQ
Category:Version 2.5.23 FAQ
Category:Version 2.5.24 FAQ
Category:Version 2.5.25 FAQ
Category:Version 2.5.26 FAQ
Category:Version 2.5.27 FAQ
Category:Version 2.5.2 FAQ
Category:Version 2.5.3 FAQ
Category:Version 2.5.4 FAQ
Category:Version 2.5.5 FAQ
Category:Version 2.5.6 FAQ
Category:Version 2.5.7 FAQ
Category:Version 2.5.8 FAQ
Category:Version 2.5.9 FAQ
Version number is missing in back-end 2.5.0
J3.x:Warnings upgrading from Joomla 2.5 to 3.x
What are the major differences between Joomla! 2.5 and 3.x?
What do the locks mean and how do you get rid of them?
J2.5:What does a simple Joomla! installation include?
What if an extension only works on Joomla! 2.5 and not 3.x?
What is the contact creator?
What is the profile plugin?
What version of Joomla! should you use?
Where are the sections?
Where is the auto update for Joomla?
Why can't a user see anything on the backend?
Why is my Joomla! 2.5 site update manager showing an update to 3.x?
Will my Joomla! 2.5 extensions work with Joomla! 3.x?
Will your 1.0 extensions still work?
Wrong date format in profile plugin