Actions

Help35

Difference between revisions of "Extensions Extension Manager Update"

From Joomla! Documentation

m (Quick Tips: categorisation for 3.2 help screens)
(Toolbar)
 
(20 intermediate revisions by 4 users not shown)
Line 1: Line 1:
==Overview==
 
 
This screen is accessed from the back-end Joomla! administrator panel. It is used to update extensions that are installed in your Joomla! installation.
 
This screen is accessed from the back-end Joomla! administrator panel. It is used to update extensions that are installed in your Joomla! installation.
  
 
Last change: Purge cache is now included in Find Updates, not available as a separate action anymore.
 
Last change: Purge cache is now included in Find Updates, not available as a separate action anymore.
 
==How to Access==
 
*Select '''Extensions → Extension Manager''' from the drop-down menu of the '''''Joomla! Administrator Panel'''''. Then select the '''Update''' menu item in the '''''Extension manager''''' screen that appears.
 
  
 
==Description==
 
==Description==
 
This screen allows you to update installed extensions. The extension update feature was introduced in Joomla! 1.6.  You will only be able to update extensions which support this feature. For extensions which support this feature, you will be able to perform an in-place update of the extension without having to upload and install the updated extension files like you did with previous versions of Joomla!. The update feature utilizes standard HTTP connection mechanisms to download the extension update files from a remote update server.
 
This screen allows you to update installed extensions. The extension update feature was introduced in Joomla! 1.6.  You will only be able to update extensions which support this feature. For extensions which support this feature, you will be able to perform an in-place update of the extension without having to upload and install the updated extension files like you did with previous versions of Joomla!. The update feature utilizes standard HTTP connection mechanisms to download the extension update files from a remote update server.
 +
 +
==How to Access==
 +
*Select '''Extensions → Manage → Update''' from the drop-down menu of the '''''Joomla! Administrator Panel'''''. Or select the '''Update''' menu item in the '''''Extension manager''''' screen that appears.
  
 
==Screenshot==
 
==Screenshot==
[[Image:Help30-Extensions-Extension-Manager-Update-screen.png]]
+
Without update:{{-}}
 +
[[Image:Help-3x-extensions-extension-manager-update-en.png|800px]]{{-}}
 +
With update:{{-}}
 +
[[Image:Help-3x-extensions-extension-manager-update-yes-en.png|800px]]
  
 
==Column Headers==
 
==Column Headers==
*'''Checkbox.''' Check this box to select one or more items. To select all items, check the box in the column heading. After one or more boxes are checked, click a toolbar button to take an action on the selected item or items.
+
:[[File:Help35-Extensions-Manage-Update-columns-en.png|680px]]
 +
{{Chunk30:colheader|Checkbox/en}}
 
*'''Name.''' The name of the extension.
 
*'''Name.''' The name of the extension.
*'''Install Type.''' The type of installation that will be performed by the update. Usually this will be type '''''Update''''' which will perform an in-place update of the extension
+
*'''Location.''' Specifies if this is a site or administrator extension.
*'''Extension Type.''' The extension type. Examples of extension types are module, plug-in, template, component, or language.
+
*'''Type.''' The extension type. Examples of extension types are module, plug-in, template, component, language or package.
*'''Version.''' The version number of the available update.
+
*'''Installed.''' The version number of the currently installed extension.
 +
*'''Available.''' The version number of the available update.
 
*'''Folder.''' If the extension is a plug-in, the subdirectory of your Joomla! installation's /plugins directory where the extension is located. By default Joomla! has the following subdirectories in the plugins directory which each represent the different types of plug-ins that are defined: authentication, content, editors, editors-xtd, extension, search, system, user.
 
*'''Folder.''' If the extension is a plug-in, the subdirectory of your Joomla! installation's /plugins directory where the extension is located. By default Joomla! has the following subdirectories in the plugins directory which each represent the different types of plug-ins that are defined: authentication, content, editors, editors-xtd, extension, search, system, user.
*'''Client.''' Specifies if this is a site or administrator extension.
+
*'''Install Type.''' The type of installation that will be performed by the update. Usually this will be type '''''Update''''' which will perform an in-place update of the extension
 
*'''URL Details.''' The URL for the extension update XML file which contains the information needed by your Joomla! installation to perform the update.
 
*'''URL Details.''' The URL for the extension update XML file which contains the information needed by your Joomla! installation to perform the update.
*'''Display #.''' The number of items to display on one page.
+
 
 +
===Column Filtering===
 +
Above the column headers on the right, there are 2 drop down input fields, '''Sort Table by:''' (preset to '''Name ascending''') and a '''number''' (preset to '''20''') to display.
 +
[[Image:Help35-Column-Filter-Extensions-Update-Name-Ascending-DisplayNum-en.png]]
 +
 
 +
These column sorting input fields shows the current method of sorting applied to the table. Use the drop down field choices and click the column heading name. Alternatively, click on the column heading to sort the list by that column's value. This will also change the value in the drop field to correspond with the column header name. The list will then be sorted in order by that column and a sort icon(up or down arrow) will show next to the column name. Click a second time to reverse the sort, which will change the corresponding drop field.
 +
{{Chunk30:colheader|Order/en}}
 +
{{Chunk30:colheader|Ascending/en}}
 +
{{Chunk30:colheader|DisplayNum/en}}
 +
 
 +
==List Filters==
 +
You can use one of the available filters or any combination of them to limit the number of extensions displayed to just the extensions which match your filter parameters.
 +
 
 +
===Search Tools===
 +
{{Chunk30:colheader|Banner List Filter/en}}
 +
 
 +
===Filter by Location, Type and Folder===
 +
 
 +
[[Image:Help35-colheader-select-location-en.png]]
 +
*'''-Select Location-.''' Select an extension client from the drop-down list box of available locations.
 +
*'''Site.''' Site extensions are extensions which are designed for use in areas outside of the administrator interface.
 +
*'''Administrator.''' Administrator extensions are for the back-end administrative functions of your Joomla! installation. Usually you would only directly interact with these extensions through the administrator web interface.
 +
 
 +
[[Image:Help35-colheader-select-type-en.png]]
 +
*'''-Select Type-.''' Select the extension type from the drop-down list box of available types.
 +
 
 +
[[Image:Help35-colheader-select-folder-en.png]]
 +
*'''-Select Folder-.''' Select a plug-in folder from the drop-down list box of available folders. There is a separate folder for each type of plug-in defined in your installation of Joomla.
 +
 
 +
===Automatic Pagination===
 +
{{Chunk30:colheader|Manager Pagination/en}}
  
 
==Toolbar==
 
==Toolbar==
At the top left you will see the toolbar:
+
At the top you will see the toolbar:
  
[[Image:Help30-Update-FindUpdates-PurgeCache-Options-Help-toolbar.png]]
+
[[Image:Help30-Update-FindUpdates-Help-Options-toolbar-en.png|800px]]
  
 
The functions are:
 
The functions are:
{{Chunk30:Help_screen_toolbar_icon_Update|extension(s)}}
+
{{Chunk30:Help_screen_toolbar_icon_Update/en|extension(s)}}
{{Chunk30:Help_screen_toolbar_icon_FindUpdates|extensions}}
+
{{Chunk30:Help_screen_toolbar_icon_FindUpdates/en|extensions}}
{{Chunk30:Help_screen_toolbar_icon_Help}}
+
{{Chunk30:Help_screen_toolbar_icon_Clear_Cache/en}}
{{Chunk30:Help_screen_toolbar_icon_Options}}
+
{{Chunk30:Help_screen_toolbar_icon_Help/en}}
 
+
{{Chunk30:Help_screen_toolbar_icon_Options/en}}
  
 
==Links to Other Screens==
 
==Links to Other Screens==
At the top left, you will see the following five links:
+
At the top left, you will see the following links:
  
[[Image:Help30-Extensions-Extension-Manager-Update-submenu-subscreen.png‎]]
+
[[Image:Help31-extension_manager-install-menu-en.png]]
*'''Install.''' Links to the [[Help30:Extensions_Extension_Manager_Install|Install Screen]].
+
*'''Install.''' Links to the [[S:MyLanguage/Help31:Extensions_Extension_Manager_Install|Install Screen]].
*'''Update.''' Links to the [[Help30:Extensions_Extension_Manager_Update|Update Screen]].
+
*'''Update.''' Links to the [[S:MyLanguage/Help31:Extensions_Extension_Manager_Update|Update Screen]].
*'''Manage.''' Links to the [[Help30:Extensions_Extension_Manager_Manage|Manage Screen]].
+
*'''Manage.''' Links to the [[S:MyLanguage/Help31:Extensions_Extension_Manager_Manage|Manage Screen]].
*'''Discover.''' Links to the [[Help30:Extensions_Extension_Manager_Discover|Discover Screen]].
+
*'''Discover.''' Links to the [[S:MyLanguage/Help31:Extensions_Extension_Manager_Discover|Discover Screen]].
*'''Warnings.''' Links to the [[Help30:Extensions_Extension_Manager_Warnings|Warnings Screen]].
+
*'''Database.''' Links to the [[S:MyLanguage/Help31:Extensions_Extension_Manager_Database|Database Screen]].
 +
*'''Warnings.''' Links to the [[S:MyLanguage/Help31:Extensions_Extension_Manager_Warnings|Warnings Screen]].
 +
*'''Install Languages.''' Links to the [[S:MyLanguage/Help30:Extensions_Extension_Manager_Languages|Install Languages Screen]].
 +
*'''Update Sites.''' Links to the [[S:MyLanguage/Help35:Extensions_Extension_Manager_Update_Sites|Update Sites Screen]].
  
 
==Quick Tips==
 
==Quick Tips==
Line 53: Line 90:
 
* It is recommended to backup your Joomla! installation files and database before attempting to update extensions or the Joomla! installation itself. This will ensure that you can restore your Joomla! installation to its previous state if the update fails or causes unexpected results.
 
* It is recommended to backup your Joomla! installation files and database before attempting to update extensions or the Joomla! installation itself. This will ensure that you can restore your Joomla! installation to its previous state if the update fails or causes unexpected results.
  
<noinclude>{{cathelp|3.0,3.1,3.2|Extension Management Help Screens|Update}}</noinclude>
+
<noinclude>
 +
[[Category:Help screen 3.0]]
 +
[[Category:Help screen 3.1]]
 +
[[Category:Help screen 3.2]]
 +
[[Category:Help screen 3.3]]
 +
[[Category:Help screen 3.4]]
 +
[[Category:Help screen 3.5]]
 +
[[Category:Extension Management Help Screens]]
 +
[[Category:Update]]
 +
[[Category:Help_screens]]
 +
</noinclude>

Latest revision as of 12:17, 5 May 2016

This screen is accessed from the back-end Joomla! administrator panel. It is used to update extensions that are installed in your Joomla! installation.

Last change: Purge cache is now included in Find Updates, not available as a separate action anymore.

Description

This screen allows you to update installed extensions. The extension update feature was introduced in Joomla! 1.6. You will only be able to update extensions which support this feature. For extensions which support this feature, you will be able to perform an in-place update of the extension without having to upload and install the updated extension files like you did with previous versions of Joomla!. The update feature utilizes standard HTTP connection mechanisms to download the extension update files from a remote update server.

How to Access

  • Select Extensions → Manage → Update from the drop-down menu of the Joomla! Administrator Panel. Or select the Update menu item in the Extension manager screen that appears.

Screenshot

Without update:

Help-3x-extensions-extension-manager-update-en.png

With update:

Help-3x-extensions-extension-manager-update-yes-en.png

Column Headers

Help35-Extensions-Manage-Update-columns-en.png
  • Checkbox: Check this box to select one or more items. To select all items, check the box in the column heading. After one or more boxes are checked, click a toolbar button to take an action on the selected item or items. Many toolbar actions, such as Publish and Unpublish, can work with multiple items. Others, such as Edit, only work on one item at a time. If multiple items are checked and you press Edit, the first item will be opened for editing.
  • Name. The name of the extension.
  • Location. Specifies if this is a site or administrator extension.
  • Type. The extension type. Examples of extension types are module, plug-in, template, component, language or package.
  • Installed. The version number of the currently installed extension.
  • Available. The version number of the available update.
  • Folder. If the extension is a plug-in, the subdirectory of your Joomla! installation's /plugins directory where the extension is located. By default Joomla! has the following subdirectories in the plugins directory which each represent the different types of plug-ins that are defined: authentication, content, editors, editors-xtd, extension, search, system, user.
  • Install Type. The type of installation that will be performed by the update. Usually this will be type Update which will perform an in-place update of the extension
  • URL Details. The URL for the extension update XML file which contains the information needed by your Joomla! installation to perform the update.

Column Filtering

Above the column headers on the right, there are 2 drop down input fields, Sort Table by: (preset to Name ascending) and a number (preset to 20) to display. Help35-Column-Filter-Extensions-Update-Name-Ascending-DisplayNum-en.png

These column sorting input fields shows the current method of sorting applied to the table. Use the drop down field choices and click the column heading name. Alternatively, click on the column heading to sort the list by that column's value. This will also change the value in the drop field to correspond with the column header name. The list will then be sorted in order by that column and a sort icon(up or down arrow) will show next to the column name. Click a second time to reverse the sort, which will change the corresponding drop field.

  • Ordering: (default). The column in which to sort displayed items in the table. The values are the same as the column heading names.
  • Ascending (default). Shows ordering of selected column, ascending or descending.
  • # (default is 20). Shows the number of items to display on one page, default is 20 items. If there are more items than this number, you can use the page navigation buttons located at the bottom of the table. (Start, Prev, Next, End, and page numbers) to navigate between pages.

List Filters

You can use one of the available filters or any combination of them to limit the number of extensions displayed to just the extensions which match your filter parameters.

Search Tools

Search Tools Above the table is a filter or search field and two buttons, as shown below.
Help30-colheader-filter-field-en.png

  • To filter in title, enter part of the title and click Search.
Click Clear to clear the Filter field and restore the list to its unfiltered state.
  • To enable more Filters, click on Search Tools

Filter by Location, Type and Folder

Help35-colheader-select-location-en.png

  • -Select Location-. Select an extension client from the drop-down list box of available locations.
  • Site. Site extensions are extensions which are designed for use in areas outside of the administrator interface.
  • Administrator. Administrator extensions are for the back-end administrative functions of your Joomla! installation. Usually you would only directly interact with these extensions through the administrator web interface.

Help35-colheader-select-type-en.png

  • -Select Type-. Select the extension type from the drop-down list box of available types.

Help35-colheader-select-folder-en.png

  • -Select Folder-. Select a plug-in folder from the drop-down list box of available folders. There is a separate folder for each type of plug-in defined in your installation of Joomla.

Automatic Pagination

Page Controls: When the number of items is more than one page, you will see a page control bar as shown below. The current page number being viewed is shaded.

Help30-colheader-pagination-en.png

  • Start: Click to go to the first page.
  • Prev: Click to go to the previous page.
  • Page numbers: Click to go to the desired page.
  • Next: Click to go to the next page.
  • End: Click to go to the last page.

Toolbar

At the top you will see the toolbar:

Help30-Update-FindUpdates-Help-Options-toolbar-en.png

The functions are:

  • Update: Updates the selected extension(s).
  • Find Updates. Scans your Joomla! installation and locates extensions with an available update.
  • Clear Cache. Clear the available extension update information displayed in the listing.
  • Help. Opens this help screen.
  • Options. Opens the Options window where settings such as default parameters can be edited.

Links to Other Screens

At the top left, you will see the following links:

Help31-extension manager-install-menu-en.png

Quick Tips

  • Only extensions which support the Joomla! update system will be listed in this screen. If you use extensions which do not support the new update system or you are not sure, consult the extension developer's website.
  • It is critical to keep your extensions up-to-date. Failure to do so may expose a vulnerability in your Joomla! installation which can be exploited by hackers.
  • It is recommended to backup your Joomla! installation files and database before attempting to update extensions or the Joomla! installation itself. This will ensure that you can restore your Joomla! installation to its previous state if the update fails or causes unexpected results.