Popup Toolkit - Plugin for Joomla 2.5 Tutorial

This tutorial will show you how to install the Popup Toolkit Plugin for Joomla 2.5 and how to install popups in your Joomla 2.5 based websites.

We assume that you have already saved your popup into a JS file. If not, learn how to save your popup into a JS file in the JS File Install Tutorial.

The Plugin for Joomla 2.5 is delivered to you along with the full version of the software for no additional cost. When you download Popup Toolkit archive and unzip it you will find the plugin inside. The plugin has its own zip file which is called 'PWS_v2.50s_for_Joomla_2.5_plugin.zip'. Do not unzip this file, but save it to your hard disk and remember the location where you saved it :-). Then open the administration control panel of your Joomla site in a web browser. You will see a control panel similar to the one shown on Figure 1 below.

fig.1 - Joomla 2.5 Administration Control Panel.

Select from the menu 'Extensions->Install/Uninstall' as shown on Figure 1 above. You will see the Extension Manager of Joomla 2.5 (Figure 2 below).

fig.2 - Joomla 2.5 Extension Manager.

Click the 'Browse...' button in the middle of the interface. A dialog box will open up (see Figure 3 below). Use this dialog box to select the location where you saved the plugin .zip file and then double click on the file or click on the 'Open' button in the lower right of the dialog box. (Figure 3 below).

fig.3 - Joomla 2.5 Install Plugin dialog box.

Next, click the 'Upload File & Install' button, which is next to the 'Browse...' button (see Figure 2 above). As shown on Figure 4 below, Joomla will install the plugin and will emit the message 'Install Plugin Success'.

fig.4 - Plugin installed Joomla message.

The last step is to activate the plugin. Select from the menu 'Extensions->Plugin Manager'. You will be directed to the plugin manager of Joomla 2.5 (Figure 5 below).

fig.5 - Plugin Manager.

By default, each newly installed plugin is disabled. In the list of installed plugins you will see the new plugin named 'Popup Toolkit'. Next to it in the right hand side column there is a 'disabled' icon (a red circle with a cross inside). Click on this icon once to enable the plugin. The icon will change to a green tick denoting an enabled plugin.

The Popup Toolkit plugin for Joomla 2.5 has been installed and enabled. Now it is time to install a popup inside a Joomla webpage. This procedure is very easy to perform. Select 'Content->Article Manager' using the menu (Figure 6 below).

fig.6 - Selecting 'Article Manager' from the menu.

Then click on an article where you want to install a popup to. The 'Article: [Edit]' screen will open (Figure 7 below).

fig.7 - Selecting 'Article Manager' from the menu.

The method of popup installation is the same no matter what editor you are using inside Joomla (JCE, TinyMCE, etc.). The method is the same even if you are not using any editor at all.

You need to enter just one line of code to install a popup. As you can see on Figure 7 above the line of code is:

{pwsjs}popup-joomla.js{/pwsjs}

The text between tags {pwsjs} and {/pwsjs} is the name of the JS file holding the popup code. In this case the JS file name is 'popup-joomla.js'. Use Popup Toolkit to generate a JS file with popup code inside and then upload the JS file to the base (root) folder of your Joomla installation (the folder where your 'configuration.php' file is located). Of course, you may use sub-folders, but then you will have to include the path to your popup in the plugin code. For example, if you place your popup code in the sub-folder called 'popups/' then use the following line of code to install your popup:

{pwsjs}popups/popup-joomla.js{/pwsjs}

Lastly, you may use full URL to denote where your JS file is located:

{pwsjs}http://popup-toolkit.com/popup-jumptrans.js{/pwsjs}

For further details on specific features and effects, refer to the User's Manual.

Finally, if you encounter any problem or need help, contact me (see bottom of page for contacts).

Enjoy!


Home | Help/FAQ/News | Terms of Use | Privacy Policy | Contacts:
Copyright © 2006-2024 Popup-Toolkit.com, All rights reserved.