Version: 3.1.0 Joomla! 3 M
Have you ever wanted to add more Icon/Links to the Control Panel for quick access to other parts of your Joomla! backend. The KC Admin QuickIcons module allows the administrator to define extra Control Panel icons to quickly link to other extensions or administrator backend functions.
This information is only for the Joomla! 3.x version of this module. The Joomla! 2.5 version information can be found here and the Joomla! 1.5 version information can be found here.
Description
Joomla! 3.x
The KC Admin QuickIcons administrator module allows the administrator to add up to 15 more quick access links to the Joomla! backend administrator control panel. Each link has a text label and can have an icon from the hathor template or you can use your own custom icon. The module uses the access levels setup for each of the functions you add a quick icon for. So you can set up some icons and they will only be visible for backend users that have the access levels to view them.
Change Log
3.2.0 - Added icon support as an option so icomoon icons could be used
3.1.0 - Added new grid layout, added the ability to open links in a new browser window, fixed strict standard warnings
3.0.1 - Added back layout css file
3.0.0 - Inital Joomla! 3.0 release. Changed to using hathor template icons. Moved the custom icon folder to under the module.
Installation & Upgrading
Installation & Upgrade Instructions - Joomla! 3.0
Follow these instructions to install the module for the first time or to upgrade to a new version of the module.
- Login to the backend of your Joomla! site as an Administrator or Super Administrator
- Under the Extensions menu go to Extensions Manager > Install
- Click the Browse button next to the Package File box
- Find the mod_kc_admin_quickicons-x.x.x.zip file that you previously stored on your hard drive and click Open
- Click the Upload & Install button under the Package File box
- The module will be installed
- Under the Extensions menu go to Module Manager, select Administrator type modules in the top right pulldown menus
- Find the KC Admin QuickIcons module and click the title to edit it (if the module is not in the list, click the new button and select KC Admin QuickIcons module)
- Change the Position to "Quick Icons [icon]", set the Access to Special and Publish the module. You can also upload your own custom icons to the /administrator/modules/mod_kc_admin_quickicons/images folder or a sub-folder of it.
- Save the module
- If you want your Quick Icon links to display after the standard Joomla! Quick Icons, reorder the module so it is after the Quick Icons module.
Check the Updater periodically for new versions of the module. A new version can be updated using the updater, the currently installed version does not need to be uninstalled before upgrading.
Usage
Adding Admin Quick Icons
The module comes with a Quick Icon setup for the Module Manager. Lets assume that you want to add a quick link to clean the cache. To add more quick icons follow these steps:
- Edit the KC Admin QuickIcons module by clicking on its title
- Find the next empty Icon Label (if you just installed the module, that would be Icon Label 2)
- Add text for this icon's Icon Label, in our example we would add "Clean Cache"
- Add the link to the extension or administrator function you want this icon to link to. It should start with index.php?option=. In our example we would add index.php?option=com_cache. Note if you want to add an edit link the format for the link should be:
index.php?option=com_content&task=article.edit&id=xx or index.php?option=com_modules&task=module.edit&id=xx,
where xx is the id of the article you want to edit. if you use the format:
index.php?option=com_content&view=article&layout=edit&id=xx
the ACL will disallow the user access to the article. - Now we can either use an icomon icon, select one of the icons from the administrator hathor template from the pulldown menu or use our own custom icon image. The icomoon icon will override the admin icon from the pulldown menu. To use an icomoon icon enter the icon name into the Icomoon Icon field, for example icon-cube. If you want to use one of the system icons, use the pulldown menu and select the icon you would like to use. In our example we could use the icon-48-clear.png image.
- If we don't want to have a custom icon we leave the Custom Icon radio button set to No. If we want to use our own Custom Icon we would change the radio button to Yes. Setting the Custom Icon radio button to Yes will override the Icon image selected in the Icon pulldown menu
- If we set the Custom Icon field to Yes we need to set the path to the icon. The module assumes that the icon image file will be in the /administrator/modules/mod_kc_admin_quickicons/images folder. If you have the custom image is in a sub-folder you would enter the folder(s) in the Custom Icon Path field. For example if your custom icon was in the /administator/images/kc_admin_quickicons/icons or administrator/modules/mod_kc_admin_quickicons/images/icons folder your would enter icons for Joomla 3.0, in the field. Note that you do not start the path with a / or end the path with a /
- If we set the Custom Icon field to Yes we need to set the custom icon image filename. Enter the filename of the custom icon image including its file extension. For example cache_icon.png. Note that the custom icom image should be at most 48x48 pixels in size.
- Repeat these steps for each custom icon that you need.
See this tip on how to have the icons visible other than just in the control panel: http://www.keashly.net/forum/2-kc-admin-quickicons/423-cool-tip#423
Download
Download the Module
The KC Admin QuickIcons module is released under the GNU GPL license, please read and agree to these terms before downloading the software.
Download the Joomla! 3.x latest version of the module