Toolbar:

Plugins:  Click this button to return to the JCE Plugins list.

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

Uninstalling a Plugin deletes it completely from the system.

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

Cancel: Click this button to return to the default JCE Configuration menu. 

Install a New Plugin:

Plugins are usually packaged inside a .zip file. Some plugin developers may package the plugin with documentation and other items. (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 Plugin .zip files separately.

To Upload and Install a New Plugin:

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 Plugin file on the local hard drive. Select the Plugin file and click the Open button. The dialogue window will disappear and the path to, and name of, the Plugin 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 Plugin file from the local computer to the joomla_root/mambots/editors/jce/jscript/tiny_mce/plugins directory tree.

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 Plugin from a Directory:

If the host web server does not have GZIP support enabled with PHP it will be necessary to transfer the Plugin 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/com_jce/installer/plugins/plugin_name 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/com_jce/installer/plugins/plugin_name then click the Install button.

The new Plugin will be installed by Joomla! in the joomla_root/mambots/editors/jce/jscript/tiny_mce/plugins/plugin_name directory of the web site.

The Success (or Failure Screen)

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

The new Mambot will have been installed in the joomla_root/mambots/editors/jce/jscript/tiny_mce/plugins/plugin_name directory of the web site.

If things did not go to plan the message Upload Plugin - 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 Plugin will now listed and be accessible via the JCE Admin->JCE Plugins Menu Item.

Installed Plugins

This section of the Installer screen contains a listing of all the installed (and editable) Plugins. Core Plugins that cannot be deleted are not included in the list.

Name: Lists the common, descriptive name of the Plugin.

Plugin: Lists the Plugin's system name.

Author: This column identifies the name of the Developer/Author of the Plugin. The information displayed here is copied directly from the plugin_name.xml file that is included in a Plugin installation.

Version: This column identifies the Version Number of the Plugin. The information displayed here is copied from the plugin_name.xml file that is included in a Plugin installation.

Date: This column identifies the date upon which the Plugin was released. The information displayed here is copied from the plugin_name.xml file that is included in a Plugin installation.

Author E-mail: This column identifies the e-mail address of the Author of the Plugin. The information displayed here is copied from the plugin_name.xml file that is included in a Plugin installation.

Author URL: This column identifies the web site address of the Author of the Plugin. The information displayed here is copied from the plugin_name.xml file that is included in a Plugin installation.

Plugins developers may not always provide all the information within the plugin_name.xml file as they should so there may well be gaps in the display!

Uninstalling a Plugin:

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

Uninstalling a Plugin deletes it completely from the system. Deleted Pluginss cannot be restored. If the Plugin is required again it must be re-installed from the beginning.

 Only non-core plugins are displayed and can be uninstalled.

Upgrading Plugins:

There is as yet no standard procedure for updating a Plugin. In some cases it is necessary to uninstall an existing version before adding the new. In other situations the update can be down by copying the new plugins files over the existing ones.

Portions of this documentation have been adapted from the Joomla! Mambots Install help screen.