1.5 Template Project

The Joomla! Documentation Working Group is running a project to develop detailed reference and tutorial material on Joomla! 1.5 templates.  There is a project page on the documentation wiki where you can see the work in progress and help us by contributing your knowledge.

Who's Online

We have 16 guests online

Help Site License

The Joomla! Help Site content is copyright © 2005 - 2008 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution NonCommercial ShareAlike 2.5. Some parts of this website may be subject to other licenses.
Home arrow Help Screens arrow Help Screens :: Components arrow Install New Components and Manage Installed Components

Install New Components and Manage Installed Components PDF Print E-mail

1012_doc_icon

Type:

com_installer

Access:

menu=>Installers=>Components

User Level:

Administrator; Super Administrator

Screenshot:

inst_new_component
Install a New Component

Toolbar:

 uninstall_help_tb

Uninstall: Select the radio button next to the Component that is to be uninstalled (deleted) from the web site. Then click the Uninstall icon.

warning_711_small Warning: Uninstalling a Component deletes it completely from the system. Any other Extensions that depend upon it will also no longer work.

Help: Click the Help icon at any time to view this Help Screen.

Install New Components:

note711_small NOTE: Many new Components (and Templates, Mambots(Plugins), and Modules) are packaged inside a .zip file with documentation and other Extensions (Therefore there are .zip files and other items inside the .zip file). It is good practice to check this before attempting the new installation as it may be necessary to unpack this file first of all and then install the individual Extensions separately via the appropriate installer.

note711_small NOTE: Many Component developers add additional functionality to their product by providing Plug-ins (also third parties may develop these) that are installed separately from the main Component, Modules, or Mambots. 

In this instance these Plug-ins are different from Plugins being the new name under Joomla! 1.5 for Mambots. 

To Upload and Install a New Component:

If the host web server has GZIP support enabled with PHP, it is possible to upload a zipped (.zip) package file that will be installed automatically.

To trace the file click on the Browse button. This will open the File Upload dialogue window. Navigate to the location of the desired Template file on the local hard drive. Select the Component file and click the Open button. The dialogue window will disappear and the path to, and name of, the Component file will appear in the File Upload field. Click the Upload and Install button to complete the transfer and installation of a copy of the Component file from the local computer to the joomla_root/components/ directory tree.

note711_small NOTE: There is usually an upper limit to the size of files that can be uploaded within the web server itself. This limit is set in the PHP configuration file (php.ini) and may differ between web servers and web hosts. The limit cannot be altered from within Joomla!. Some hosting companies do not allow the limit to be altered at all!

To allow larger files to be uploaded it will probably be necessary to increase the upload_max_filesize and the post_max_size settings.

For very large files it may also be necessary to increase the max_execution_time and the memory_limit settings. Alternatively it may be necessary to use an external program to upload the files. If so follow the next set of instructions.

To Install a New Component From a Directory:

If the host web server does not have GZIP support enabled with PHP it will be necessary to transfer the Component file to the web server using FTP (File Transfer Protocol) or possibly a web host provided control panel, bit these are varied and outside the scope of this Help Screen.

Unpack the compressed .zip file onto the local hard drive before uploading it via FTP. Ideally the file should be transferred to the joomla_root/administrator/components/com_installer/component/yourcomponentname directory of Joomla!.

Once the files are uploaded enter the exact location of this file (it must be the absolute location) in this example: joomla_root/administrator/components/com_installer/component/yourcomponentnamethen click the Install button.

The new Component will be installed by Joomla! in the joomla_root/components/yourcomponentname directory of the web site.

The Success (or Failure Screen)

If all goes well a page will be displayed proclaiming Upload Component - Success. This confirms the name of the Component installed together with the authors Component description message.

The new Component will have been installed by Joomla! in the joomla_root/components/yourcomponentname directory of the web site.

If things did not go to plan the message Upload Component - Failed, followed usually by the reason for the failure. Make a note of the reason before clicking continue. Rectify the error, if possible, before trying again.

The newly installed Component will now be accessible via the menu=>Components Menu Item. The Component is also listed in the Installed Components Manager within the Installer screen.

note711_small NOTE:To use the new Component ensure that it is configured and - where necessary - published after the installation is complete in accordance with the Developers instructions.

Installed Components

This section of the Installer screen contains a listing of all the installed (and editable) Components within this installation.

Columns:

Currently Installed: Lists all the Components currently installed on the web site (these are only those that are not a part of the core operation of the Joomla! installation).

Component Menu Link: Lists all the Menu Item shortcuts that have currently been created linking the Components to the Menu Modules on the Front-end of the web site.

Author: This column identifies the name of the Developer/Author of the Component. The information displayed here is copied by Joomla! directly from the component_name.xml file that is included in a normal Component installation.

Version: This column identifies the Version Number of the Component. The information displayed here is copied by Joomla! directly from the component_name.xml file that is included in a normal Component installation.

Date: This column identifies the date upon which the Component was released. The information displayed here is copied by Joomla! directly from the component_name.xml file that is included in a normal Component installation.

Author E-mail: This column identifies the e-mail address of the Author of the Component. The information displayed here is copied by Joomla! directly from the component_name.xml file that is included in a normal Component installation.

Author URL: This column identifies the web site address of the Author of the Component. The information displayed here is copied by Joomla! directly from the component_name.xml file that is included in a normal Component installation.

note icon NOTE: Extension developers don't always provide all the information within the component_name.xml file as they should so there may well be gaps in the display!

Uninstalling a Component:

Select the radio button next to the Component that is to be uninstalled (deleted) from the web site. Then click the Uninstall icon.

warning_711_small Warning: Uninstalling a Component deletes it completely from the system. Any other Extensions that depend upon it will also no longer work. Deleted Components cannot be restored as a Menu Item or Content Item can. If the Component is required again it must be re-installed from the beginning.

note icon NOTE: Components essential to core Joomla! operations cannot be deleted.

Upgrading Components:

There is no standard procedure for updating a Component. In some cases it is necessary to uninstall an existing version before adding the new. In other situations the update will be handled automatically.

It is therefore essential to read the Component developers upgrade notes - these may be enclosed in the file that is downloaded, or will be located on the developers web site. 

Related Information:

 Install New Modules  Install New Mambots (Plugins)
 Components - What are they?  Install New Component

note icon NOTE: If you have any comments or suggestions regarding this Help screen then please post them in the Suggestions, Modifications, and Corrections forum in the User Documentation Work Group.

Last Updated ( Wednesday, 09 May 2007 )
 
< Prev   Next >