Difference between revisions of "Installing an extension"

From Joomla! Documentation

(Several markup changes.)
 
Line 2: Line 2:
  
 
<translate><!--T:1-->
 
<translate><!--T:1-->
Before starting it always is wise to read the documentation associated with an extension. Most extensions have homepages and forums, and it is a good idea to look at them first. If there is a README file included with the extension, you should read it.</translate>
+
Before starting it always is wise to read the documentation associated with an extension. Most extensions have homepages and forums. Look at them first. If there is a README file included with the extension, you should read it.</translate>
  
 
<translate><!--T:2-->
 
<translate><!--T:2-->
Line 8: Line 8:
  
 
<translate><!--T:3-->
 
<translate><!--T:3-->
* Download the extension to your local machine as a zip file package.</translate>
+
* Download the extension to your local machine as a ''.zip'' file package.</translate>
 
<translate><!--T:4-->
 
<translate><!--T:4-->
* From the backend of your Joomla site (administration) select Extensions {{rarr}} Install/Uninstall.</translate>
+
* From the Backend of your Joomla site (Administrator) select {{rarr|Extensions,Install/Uninstall}}.</translate>
 
<translate><!--T:5-->
 
<translate><!--T:5-->
* Click the Browse button and select the extension package on your local machine.</translate>
+
* Click the ''Browse'' button and select the extension package on your local machine.</translate>
 
<translate><!--T:6-->
 
<translate><!--T:6-->
* Click the Upload File & Install button.</translate>
+
* Click the ''Upload File & Install'' button.</translate>
 
<translate><!--T:7-->
 
<translate><!--T:7-->
 
* Some extensions may provide further instructions on installation.</translate>
 
* Some extensions may provide further instructions on installation.</translate>
Line 35: Line 35:
  
 
<translate><!--T:13-->
 
<translate><!--T:13-->
this is because of a restriction of your hosting account which leads Joomla! to try to check if the root directory exists. You will not be able to use the automated installer.</translate>
+
there is a restriction in your hosting account which leads Joomla! to try to check if the root directory exists. You will not be able to use the automated installer.</translate>
 
<translate>
 
<translate>
 
==Manual Installation== <!--T:14-->
 
==Manual Installation== <!--T:14-->
 
</translate>
 
</translate>
 
<translate><!--T:15-->
 
<translate><!--T:15-->
First, unzip all of the files in a local directory (for instance <code>com_installer</code>). Then transfer the directory (using FTP) to a folder under the install directory (for instance <code>administrator/components</code>), appropriate for the type of extension you are installing (visible in its xml file, a line like <code><extension type="component" ...</code>). Then use the installer, but select "install from directory" indicating the correct folder name. This folder name should be an absolute path from the root of the filesystem.</translate>
+
First, unzip all of the files in a local directory (for instance ''com_installer''). Then transfer the directory (using FTP) to a folder under the install directory (for instance ''administrator/components''), appropriate for the type of extension you are installing (visible in its XML file, a line like ''<extension type="component" ...''). Then use the installer, but select ''install from directory'' indicating the correct folder name. This folder name should be an absolute path from the root of the file system.</translate>
  
 
<noinclude>
 
<noinclude>

Latest revision as of 16:45, 29 November 2022

Other languages:
Deutsch • ‎English • ‎Nederlands • ‎español • ‎français • ‎italiano • ‎português do Brasil • ‎中文(台灣)‎

Before starting it always is wise to read the documentation associated with an extension. Most extensions have homepages and forums. Look at them first. If there is a README file included with the extension, you should read it.

For most extensions and most users, the procedure will be:

  • Download the extension to your local machine as a .zip file package.
  • From the Backend of your Joomla site (Administrator) select Extensions  Install/Uninstall.
  • Click the Browse button and select the extension package on your local machine.
  • Click the Upload File & Install button.
  • Some extensions may provide further instructions on installation.
  • Note that modules and plugins must be enabled before they will work.

There are some situations in which this procedure will not work.

Sometimes you need to unzip the file locally prior to installing. If you get an error saying that the file is not in the correct format, the need to unzip is a common cause of this. After unzipping try installing the individual items. Note that the files you upload using the installer still need to be zipped.

Sometimes you cannot use the automated installer. For example, very large extensions may exceed the maximum upload size allowed by your host.

Also, If you see an error like this:

Warning: is_dir() [function.is-dir]: open_basedir restriction in effect. File(/) is not within the allowed path(s): ...

there is a restriction in your hosting account which leads Joomla! to try to check if the root directory exists. You will not be able to use the automated installer.

Manual Installation[edit]

First, unzip all of the files in a local directory (for instance com_installer). Then transfer the directory (using FTP) to a folder under the install directory (for instance administrator/components), appropriate for the type of extension you are installing (visible in its XML file, a line like <extension type="component" ...). Then use the installer, but select install from directory indicating the correct folder name. This folder name should be an absolute path from the root of the file system.