Popup Toolkit User's Manual
  1. Introduction
  2. Menu
  3. User Interface

1. Introduction

Welcome to Popup Toolkit Software!

Popup Toolkit Software generates the Standard old-style Popups, Imposing Popups, Unblockable DHTML Popups, Unblockable text only Popups (Unblockable OnExit Popups) and Popup Rotators. You may choose the Popups behavior, looks, content and triggering mode along with other features using the controls in the application's user interface. The user interface is organized in tabs and sections. The tabs (screens) of the interface are covered comprehensively in manual section 3. User Interface.

The software application has menus used to manipulate projects and access help. You may save and load Popup and Rotator projects using the File menu and open different help topics using the Help menu. The menus are covered in manual section 2. Menu.

Anywhere using the interface, at anytime, you may press F1 key to receive immediate help on the control that has the focus. If you need help on a certain control just click it with the mouse and then press F1.

While working on your Popups you may use the Preview Buttons at the bottom of the interface to preview your current work.


2. Menu

Use the File menu to save and load Popup and Rotator projects. you may start a new Popup or Rotator project by choosing a new project command. If you open a rotator project or choose a new rotator project then the user interface will be switched to rotator mode. If you open a popup project or choose a new popup project the user interface will be switched to Popup mode. In all cases, you will be asked to save your unsaved projects.

Use the Help menu to access different help topics either from your installation as the current user's manual or an online topic.


3. User Interface

The Popup Toolkit's user interface consists of two modes - Popup mode and Rotator mode. You choose the mode by opening an existing or a new project either a Popup project or a Rotator project. You will be prompted to saved any unsaved projects when switching the mode, so don't worry about your data.

Popup mode. It consists of five tabs with controls used to set various popup features. The tabs are described below in detail.

Rotator mode. It consists of one tab with controls used to set various rotator features. The Rotator tab is described below in detail.

Starting with the Popup mode and its first tab of controls -


General Settings tab

The General Settings tab consists of four sections with controls used to set up the most general Popup features.

General Settings tab -> Choose the Popup Type section

Here you can setup the Popup type. You may choose between six different types.

DHTML Popups.
Popup Toolkit supports DHTML popups based on JavaScript, CSS and other Modern Web Technologies. These popups are not blockable by the current popup blocking software. The DHTML technological approach lets Popup Toolkit produce extremely effective popups with a large number of effects and exceptional design flexibility. DHTML popups are shown in the web browser window. They possess titlebar, close and minimize buttons, border, content area and shadow. All these elements except the content area can be switched on and off. Various attributes of the DHTML popup window may be set up and adjusted. Attributes are divided into four user interface tabs - see User Interface.

Standard Popups.
Except the DHTML type of popups, the software is capable of generating Standard (Regular) Popups. These are blockable by popup blockers. They support a limited Looks design and Behavior capabilities compared to DHTML Popups. For example they support only the jumping and the sliding behavior effect. When you choose Standard Popup all features and controls in the user interface that are not supported will be disabled to let you know which features are available for this popup type.
Although blockable and with limitations, you may always need a standard popup - it opens in a new browser window and thus isn't "connected" with the web page opening it. It stays alive after closing the main web page. If you need, you can always "backup" your standard popup with a DHTML one. See "If the popup gets blocked..." checkbox.

Standard Popunders.
Popunders are a well known type of popups. The only difference from the Standard Popups is that right after opening, the Popunder goes behind all other windows and stays there for the user to see later.

Imposing Popups.
Imposing Popups are the so called Modeless Popups supported by Internet Explorer. They are very alike with the Standard Popups with two differences. The Imposing Popup will pass through some popup blockers. The Imposing Popup will always stay Over the main page. Thus it imposes itself to be better observed. The Imposing Popup will hide when the main page is hidden (minimized) and will close when the main page is closed. In other browsers different from IE, the Imposing Popup is automatically substituted with a Standard Popup, so you don't have to worry about compatibility.
Like with the Standard Popup, if you need, you can always "backup" your standard popup with a DHTML one. See "If the popup gets blocked..." checkbox.

Super-Imposing Popups
Super-Imposing Popups are similar to Imposing Popups. They are the so called Modal Popups and are supported by Internet Explorer. The difference between the Imposing and the Super-Imposing Popup is that Super-Imposing Popups tend to grab the focus on themselves. They do not let the user work with the main web page (the page opening the popup). Thus they draw even more attention than the Imposing ones. Super-Imposing popups have limitations. They may use only an external web page as content and allow no Bahavior Effects. Again, in other browsers different from IE, the Imposing Popup is automatically substituted with a Standard Popup, so you don't have to worry about compatibility.

Unblockable Popups
The Unblockable popup is not blocked by any popup blocker. It is text only popup and has two buttons at the bottom - "OK" and "Cancel". You can set onclick actions for both the "OK" and the "Cancel" buttons. If you set NO action for the "OK" button then, when clicked, it will do the Visitor's action - navigate away or close the browser window. If you set NO action for the "Cancel" button then, when clicked, it will do nothing but stay on the current webpage. Otherwise, clicking on the "OK" or the "Cancel" button will do the action you have chosen - for example navigate to a certain web page.
Click here to open the tutorial on using Unblockable popups
Click here to open a test on a Fully Unblockable OnExit Popup

"If the popup gets blocked, display a DHTML popup instead" checkbox
This is the special Popup Type feature mentioned above. You may set up your popup as a non-DHTML type (Standard, Standard Popunder, Imposing or Super-Imposing), but if it gets blocked by a popup blocker a similar DHTML popup will open instead. This is very useful when you need the capabilities of the Standard and Imposing popups but would like all visitors to see your popup even if they have a popup blocker installed.


General Settings tab -> Select the Popup Triggering mode

Triggering mode of the popup enables you to choose under what condition and when your Popup will enter the screen. You may trigger the popup automatically when the page is opened (loaded) or closed (unloaded), or you may choose a user action dependant triggering. See the triggering modes below for further information.
Note: If you use the "Delay the Arrival by" option the popup will show after the given period of time counted from the moment the triggering event has taken place.
Note: If you use the "Auto Close after" option the popup will hide after the given period of time counted from the moment the popup was opened.

Trigger the Popup "On Entry"
The Popup will be triggered on entering the web page. This means that when the web visitor opens the web page containing the popup (or navigates to the page), the popup will enter the screen with the chosen behavior.

Trigger the Popup "On Exit"
The Popup will be triggered on navigating away from the web page or on closing the browser window. Note that only the Standard, Standard Popunder and Super-Imposing popup types allow this triggering mode. Choosing different popup types on the left (Popup Type section) will show you which triggering modes are available for each popup type - the unavailable triggering modes will be disabled.

Trigger the Popup "On Exit with Exceptions"
This triggering mode is very similar to the "On Exit" mode. Again, it is available only for Standard, Standard Popunder and Super-Imposing popup types. The difference is that here you may specify which links should NOT open the popup. To specify this you have to put the following code piece at those links. Example: 
  <a href="http://www.some-url.com" 
     onClick="DontShowWin_myid()">
Every popup is UNIQUE, because you may have more than one popup on one web page. You will need to specify which popup of all on the page you are working with. So you need a unique code piece to tell the specific popup what to do. Here, in the "DontShowWin_myid()" code, the "myid" piece is the unique popup identifier called Popup ID. For more information on setting the Popup ID of the current popup see Popup Trigger Codes section found in the Popup Code tab.
In the example above the unique code onClick="DontShowWin_myid()" tells the popup NOT to show when the given link is clicked. You will find this unique code piece for the current popup in the Popup Trigger Codes section found in the Popup Code tab. There you may copy the code by clicking on the "Select & Copy" button next to the code field. You may put this code piece on any HTML element that would navigate to another web page (or would close the browser window). See the following example for a button HTML element: 
  Submit button:
  <INPUT type="submit" value="Submit the Form"
         onClick="DontShowWin_myid()">

  Normal button:
  <INPUT type="button" value="Open Some Web Page"
         onClick="DontShowWin_myid();OpenPage()">
When the user closes the web page or navigates away, the popup will show. If the user clicks a link or a button with the code onClick="DontShowWin_myid()" the popup will NOT show.
If you have several popups set with the trigger mode "On Exit with Exceptions" on one web page and you wish to have a link, that when clicked, will STOP all these popups from showing on exit, then there is a special code piece to accomplish this: 
  <a href="http://www.some-url.com" 
     onClick="DontShowOnExit=true">
Now when the web user clicks on this link, all popups with "On Exit with Exceptions" triggering mode will NOT open when the page is navigated away or the browser window is closed.

Trigger the Popup "On Exit Only through Specific Links"
This triggering mode is very similar to the "On Exit with Exceptions" mode. Again, it is available only for Standard, Standard Popunder and Super-Imposing popup types. The difference is that here you may specify which links SHOULD open the popup when navigating away from the current web page (or when closing the browser window). To specify this you have to put the following code piece at those links that SHOULD open the popup. Example: 
  <a href="http://www.some-url.com" 
     onClick="ShowWin_myid()">
Every popup is UNIQUE, because you may have more than one popup on one web page. You will need to specify which popup of all on the page you are working with. So you need a unique code piece to tell the specific popup what to do. Here, in the "ShowWin_myid()" code, the "myid" piece is the unique popup identifier called Popup ID. For more information on setting the Popup ID of the current popup see Popup Trigger Codes section found in the Popup Code tab.
In the example above the unique code onClick="ShowWin_myid()" tells the popup TO SHOW when the given link is clicked. You will find this unique code piece for the current popup in the Popup Trigger Codes section found in the Popup Code tab. There you may copy the code by clicking on the "Select & Copy" button next to the code field. You may put this code piece on any HTML element that would navigate to another web page (or would close the browser window). See the following example for a button HTML element: 
  Submit button:
  <INPUT type="submit" value="Submit the Form"
         onClick="ShowWin_myid()">

  Normal button:
  <INPUT type="button" value="Open Some Web Page"
         onClick="ShowWin_myid();OpenPage()">
When the user closes the web page or navigates away, the popup will NOT show. If the user clicks a link or a button with the code onClick="ShowWin_myid()" the popup will DO show.
If you have several popups set with the trigger mode "On Exit Only through Specific Links" on one web page and you wish to have a link, that when clicked, will SET all these popups to show on exit, then there is a special code piece to accomplish this: 
  <a href="http://www.some-url.com" 
     onClick="ShowOnExit=true">
Now, when the web user clicks on this link, all popups with "On Exit Only through Specific Links" triggering mode WILL open when the page is navigated away or the browser window is closed.


No matter which Triggering Mode you choose, you may always Open or Close the Popup when the visitor clicks on an HTML element or through script.
When you need your popup to be triggered when the web visitor clicks on a link, button or HTML element you can use the code piece onClick="OpenWin_myid()".
As mentioned earlier, every popup is UNIQUE, because you may have more than one popup on one web page. You will need to specify which popup of all on the page you are working with. So you need a unique code piece to tell the specific popup what to do. Here, in the "OpenWin_myid()" code, the "myid" piece is the unique popup identifier called Popup ID. For more information on setting the Popup ID of the current popup see Popup Trigger Codes section found in the Popup Code tab.
If you use JavaScript you may utilize the function OpenWin_myid() and open the given popup whenever you need to.
Analogically, to close the popup use the code piece onClick="CloseWin_myid()".

Examples: 
  <BUTTON type="button"
     onClick="OpenWin_myid()">

  <IMG src="myimage.jpg"
     onClick="OpenWin_myid()">

  <A href="http://www.some-url.com" 
     onClick="CloseWin_myid()">
In the example above the unique code onClick="OpenWin_myid()" tells the popup to open when the given HTML element is clicked. You will find this unique code piece for the popup in the Popup Trigger Codes section found in the Popup Code tab. There you may copy the code by clicking on the "Select & Copy" button next to the code field.
You may put this code piece on any HTML element. Here are some more examples: 
  Pseduo-link:
  <a href="javscript: OpenWin_myid()">Click Here</a>
  
  Submit button:
  <INPUT type="submit" value="Submit the Form"
         onClick="OpenWin_myid()">

  Normal button:
  <INPUT type="button" value="Open Some Web Page"
         onClick="OpenWin_myid(); DoSomething()">

  HTML element:
  <DIV onClick="CloseWin_myid(); DoSomething()">
    Hello
  </DIV>

  From JavaScript:
  OpenWin_myid(); and
  CloseWin_myid();
Using these code pieces you have full flexibility and control on how and when to open a given popup. The function OpenWin_myid() allows even more flexibility with its two parameters:
  OpenWin_myid(immediate,exiting)
immediate - true/false. This parameter sets whether to delay the popup with the "Delay the Arrival by" timeout or not (see "Delay the Arrival by" option found in the Behavior Settings tab). This will have an effect only if the "Delay the Arrival by" feature is used for the current popup. If you specify true for this parameter the popup will NOT be delayed and will show immediatly. If you specify false - the popup WILL be delayed with the given timeout.
exiting - true/false. This parameter tells the popup if the web page will close or will be navigated to a different URL. If you use the OpenWin_myid() function on a link that navigates away from the current page, set this parameter to true.
NOTE: Omitting both parameters will result in a delayed popup opening on a NON exiting page. (both values will be assumed false).
Examples: 
  Pseduo-link that delays the popup and is not exiting the web page:
  <a href="javscript: OpenWin_myid()">Click Here</a>
  
  Pseduo-link that does NOT delay the popup and is not exiting
  the web page:
  <a href="javscript: OpenWin_myid(true)">Click Here</a>

  Link that does NOT delay the popup and IS exiting the web page:
  <a href="http://some-url.com"
     onClick="javscript: OpenWin_myid(true,true)">Click Me</a>
Finally, a special case is when you need to place closing code inside the popup content. For example you have a form in your popup's content and when the form is submitted, the user is directed to a "Thank you" page. Then you need there to be a close link on the "Thank you" page that, when clicked, would close the popup. To achieve this behavior place the following code in the "Thank you" page: 
  <A href='javascript: parent.CloseWin ( )'>Close the Popup</A>
If you use JavaScript, to close the popup through script located inside the popup's content call the function parent.CloseWin().

Heuristic OnExit Algorithm
Any type of Popup may be triggered using this intelligent heuristic algorithm. This algorithm will analyze the behaviour of the visitor and recognize when they are about to leave your web page either by closing the browser window or by navigating away (entering a new URL in the address bar or clickng the Back or Forward buttons on the browser's toolbar). The popup will show up before the visitor has had the chance to actually leave your site, thus any popup type is available for this triggering algorithm. The most effective popup to use with the Heuristic OnExit Algorithm is the DHTML unblockable popup. It will show just before the visitor goes away thus grabbing his attention and making them an offer just when they are about to leave.
Click here to open a test on a Heuristic OnExit Unblockable Popup


General Settings tab -> Instant Mail-Send Buttons section

The Mail-Send Buttons features let the visitor easily send you an e-mail.
NOTE: Mail-Send buttons are available only if you have choosen to create the popup content using the internal HTML editor (internal content). Also they are not supported for Imposing and Super-Imposing popup types.

Include Instant Mail-Send Buttons checkbox
The Mail-Send Buttons let the popup viewer easily send you an e-mail just by clicking the "OK" button in the popup. For example, the visitor will read the popup, that offers him/her to subscribe to your e-Zine or Autoresponder system. The visitor will not have to fill long forms. They will just have to click OK and confirm they would like to send you an e-mail.
Also, by letting your viewer send you an e-mail, you will obtain his/her e-mail address, because when they click the OK button an e-mail is sent from their default e-mail account to your subscription address. Instant Mail-Send feature is very useful for increasing your subscribers rate significantly. Your visitor sees your offer and then he/she may act simply using the buttons at the bottom of the popup.

Send method:
There are two e-mail send methods: Note: The Default method does not work with the Netscape browser. Netscape users will experience the Show Email method.

E-mail Address:
In this field you have to enter the e-mail address where your visitor will send the e-mail to. For example this will be the subscription e-mail address for your e-Zine or Autoresponder system. You can enter more than one e-mail address. Separate e-mail addresses with ; (semicolon). This is useful if you would like to subscribe your visitor to several services at once.

E-mail Subject:
Here you may enter the text of the e-mail subject. For example, "subscribe me".

E-mail Body:
Here you may enter the text of the e-mail subject.
This field is available if you have chosen the "Show e-mail" Send method (see below). Here you can set the text that will appear in the body of the e-mail being sent by your visitor. For example:
"Click 'Send' and you will shortly receive on your e-mail latest info on how to setup a simple web page".
You can enter at most 420 characters.

General Settings tab -> How Often to Show the Popup section

"Show the Popup" combo box
Using this combo box you can determine how often the popup would show for every given visitor. This feature is based on the browser cookie capabilities, so if the visitor's browser has no cookie support or the cookies are disabled, the popup will show every time, no matter what option you choose from the combo box (see "Disable Popups for non-Cookie Browsers" checkbox below).
You may choose the popup to show every time, once only, once per session only (until the browser is closed), once per day and once per period. The latter option will let you enter the number of days in the field right below the combo box.

"Disable Popups for non-Cookie Browsers" checkbox
This option will ensure that your popup won't annoy those visitors who do not have cookies enabled or their browser does not support cookies. This is a very small group of users - most users have their cookies working. So, if check this checkbox, these visitors will see no popup at all rather than having the popup appear every time.


Design Settings tab

The Design Settings tab consists of six sections with controls used to set up the looks of the popup.

Design Settings tab -> Popup Size and Position section

In this section you can setup the Popup size and position.

Popup Width and Height fields
In these tow fields you can enter the width and height of the popup window you want to create. Enter these dimensions in pixels.

Fullscreen checkbox
Check this checkbox if you would like your popup to occupy the whole screen or the whole browser window in the case of a DHTML popup.

Position combo box
Choose your popup's position. If you choose the option "as set above" then you have to use the above two fields to set the exact popup position from the left and the top (see "Popup distance from Left and from Top" below).

Popup distance from Left and from Top
If you choose the option "as set above" in the Position combo box (see above) you will have to use these two fields to set the exact popup position from the Left and Top of the screen. In case of DHTML popup these coordinates are from Left and Top of the browser window.

Resizable checkbox
Check this checkbox if you would like your be resizable. This option is available for all non-DHTML popups.

Design Settings tab -> Popup Window Elements

In this section you can setup the Popup window elements like buttons and toolbars.

"Use Integrated Button Images" checkbox
Check this checkbox if you like to have integrated button images for your DHTML popup. This feature is available only for the DHTML type of popups. DHTML popups may have close and minimize buttons and you have the flexibility to choose their face by selecting an image file for each one of the two buttons.
If you uncheck this checkbox you will have to enter the close and minimize images' URLs. The button faces will be loaded from these URLs and you need to supply valid URLs (either absolute or relative) for your button images (see about selecting images' URLs below).
If you check this checkbox, the button images will not be looked for on external URLs and instead will be integrated with the popup code. Thus you will not have to worry about supplying URLs for button images and will not have to worry about uploading button image files on the selected URLs. This option (integrated button images checked) has benefits, as described so far, but has one drawback: it is performance hungry and on slower machines the animation of the popup's behavior will be somewhat slower. You may always test for yourself and decide which one variant to use.

"Show Minimize button" checkbox and Minimize Button Image Path
These settings are again available only for DHTML popups. If you need to have a minimize button on your DHTML popup then check this checkbox. You will be able to enter the image file path for your minimize button. Whether you have chosen to use integrated buttons or not, you will be able to choose the corresponding image file path. If you have chosen to use integrated buttons then you will need to specify (using the "Browse" button) an image .BMP file from your harddrive. In the current version Popup Toolkit supports only BMP file for the integrated button images. If you choose to use non-integrated button images, then you will be able to specify any absolute or relative URL for the image file. It this case you will be able to specify any browser supported image file format like BMP, GIF, JPG, etc.


"Show Close button" checkbox and Close Button Image Path
These settings are again available only for DHTML popups. If you need to have a close button on your DHTML popup then check this checkbox. You will be able to enter the image file path for your close button. Whether you have chosen to use integrated buttons or not, you will be able to choose the corresponding image file path. If you have chosen to use integrated buttons then you will need to specify (using the "Browse" button) an image .BMP file from your harddrive. In the current version Popup Toolkit supports only BMP file for the integrated button images. If you choose to use non-integrated button images, then you will be able to specify any absolute or relative URL for the image file. It this case you will be able to specify any browser supported image file format like BMP, GIF, JPG, etc.


"Show Toolbar", "Show Locationbar", "Show Statusbar", "Show Toolbar", "Show Locationbar", "Show Statusbar", "Show Scrollbars", "Show Directorybar" and "Show Menubar" checkboxes
These checkboxes except the "Show Scrollbars" are available for non-DHTML popups and mostly for the Standard and Standard Popunder popup types. You can specify which bars of the popup browser window should be visible. Checking an option means that the given bar will be visible.
Scrollbar Color
When you check the "Show Scrollbars" checkbox you are enabled to specify the scrollbar color for your popup. For some popups and for some cases when you use external content (an external web page as content) you will not be allowed to setup the scrollbar colors. In the case of an external popup content (external web page as content) the scrollbar color will be specified by the web page itself. Use the 'Pick' button or simply click on the colored field to open a color picker dialog for easy color selection.

Design Settings tab -> Background Setting section

Background Color
You may set the background color of you popup. In the case when external content (an external web page as content) you will not be allowed to setup the background color. In that case the background color will be specified by the web page itself. Use the 'Pick' button or simply click on the colored field to open a color picker dialog for easy color selection.

Transparent Background Color
Check this checkbox if you like the background color of you popup to be transparent. In that case the background color set with the Background Color fields will be ignored. If you want to make a popup with a non-rectangular shape then you may use the help of this feature. Once you have checked this check box the background color will be transparent and you could make use of the background image to make your popup for example with a round shape (see setting the background image below). Also you will need to switch off the titlebar, shadow and border.

Background Transparency
You may use the slider or enter a number between 0 and 100 (%) to set the background transparency. If you have checked the Transparent Background Color checkbox, then the background color will always be 100% transparent and you will be setting only the background image transparency. If the Transparent Background Color checkbox is NOT checked then you will be setting the transparency of both the background color and background image.

Background Image settings
You may specify a URL for a background image (either an absolute or a relative URL). The image will appear as background of your popup. In the areas of the image where there are transparent pixels (GIF images for example) you will see the Background Color you have specified. Thus making the background color Transparent only the image will be seen and if the image has for example a round form, and you have switched off the titlebar, border and shadow, then the popup will receive the shape of the background image.

Design Settings tab -> Titlebar Setting section

No Titlebar checkbox
Checking this checkbox will hide the titlebar. This option is available only for DHTML popups because the other types of popup do not allow hiding their titlebars.

Titlebar text field
Use this field to set the titlebar text.

Titlebar Font settings
Use the font combo boxes and check boxes in the titlebar section to adjust the titlebar font, font size and font styles.

Titlebar Text color
You may set the titlebar text color. Use the 'Pick' button or just click the colored field to open a color select dialog box.

Titlebar color
You may set the titlebar (background) color. Use the 'Pick' button or just click the colored field to open a color select dialog box.

Titlebar color gradient
Using this combo box you may set the titlebar color gradient or switch it off.

Design Settings tab -> Border Setting section

This section contains controls for setting the popup border (frame) properties. It is available only for DHTML popups.

Border thickness
Choose the border thickness in pixels.

No Border checkbox
Check this checkbox to switch the border off (hide the border).

Border Style combo box
Choose your border's style.

Border color
You may set the border color. Use the 'Pick' button or just click the colored field to open a color select dialog box.

Design Settings tab -> Shadow Setting section

This section contains controls for setting the popup shadow properties. It is available only for DHTML popups.

Shadow thickness
Use the field to enter the shadow thickness in pixels.

No Shadow checkbox
Check this checkbox to switch the shadow off (hide the shadow).

Shadow intensity
Use this field to enter the shadow intensity (opaque) in %. Or use the slider for easy adjusting.

Shadow color
You may set the shadow color. Use the 'Pick' button or just click the colored field to open a color select dialog box.


Behavior Settings tab

The Behavior Settings tab lets you specify the behavior your popup will have when opening, closing and while staying opened.

Behavior Settings tab -> General Behavior Settings section

Here you can choose the Behavior type. You may choose between seven different behaviors. You can setup a few more features in this section. See below for more information.

Choosing the Behavior Type
Choose between seven different behaiors for you popup: DHTML popups allow all behaviors to be used. For Standard, Standard Popunders and Imposing popups you may use the Sliding and Jumping behaviors. The Super-Imposing popup lets no behavior and you must use the Just Pop mode.

Draggable checkbox
When you check this checkbox your popup will be draggable with the mouse. If you leave this checkbox unchecked the popup will stay not have the dragging capability.

Popup scrolling checkbox
This checkbox, when checked, will make the DHTML popup keep its position on the screen no matter where the visitor scrolls the web page to.

"Delay the Arrival by" feature
Check this check box to delay the arrival of your popup. You will have to enter the delay of the arrival in seconds.

"Auto Close" feature
Check this check box to auto close your popup after the given interval of time (in seconds). This interval is counted after the popup has been opened.

Behavior Settings tab -> Sliding Behavior section

Sliding behavior settings
When you choose the Sliding behavior, the sliding behavior settings section will be enabled. Here you can setup your popup's Slide In and Slide Out settings. You can choose whether the popup should slide out or it should just popout (disappear at once). For both behaviors you need to specify the direction of movement. Use the corresponding combo boxes. Then you may set the speed of sliding. Finally, you may set the sliding deceleration option for the Slide in movement, and the sliding acceleration for the Slide out movement respectively. These two settings will make the popup's sliding movement smooth.

Behavior Settings tab -> Rolling and Caterpillar behavior section

Roll and Caterpillar behavior settings
Roll and Caterpillar behaviors are similar in their features, hence they are united in one section. You can choose whether the popup should roll out or it should just popout (disappear at once). You may set the direction of Entering the screen and Exiting from the screen. Then you may set the speed of movement.

Behavior Settings tab -> Jump behavior section

Jump behavior settings
In the Jumping behavior section you can choose where the popup should Jump In from. Use the Jump In From combo box. Then you should set the Earth Acceleration. This value, if set with higher magnitude, will make the popup fall faster. Also you may enter a negative value that will make the popup fly up to the ceiling instead of falling down. Thus you could realize a balloon like effect for example. Similarly, you may use the Horizontal Acceleration field. Setting a horizontal acceleration different from 0.0 will force the popup to fall against the wall, either the left one (negative horizontal acceleration) or the right one (positive). The Elasticity field lets you setup the popup's elasticity. The elasticity may be between 0 and 100%. The expression of this feature is that if the popup has 100% elasticity it will never loose speed and will jump around forever. If the elasticity is 0% then the popup will loose all of its speed upon the first contact with a wall, floor or ceiling. Finally, you may choose whether the popup should Drop Out of the screen when closed or should just disappear.

Behavior Settings tab -> Fade behavior section

Fading behavior settings
Fading behavior lets your popup Fade In and Out of the screen. You may choose the time in seconds the Fade In and the Fade Out effects will take (in seconds). You can choose between two different effects - Alpha Fade and Dotted Fade. Finally, you can choose whether the popup should Fade Out or it should just popout (disappear at once).

Behavior Settings tab -> Exploding/Unfolding behavior section

Exploding/Unfolding behavior settings
Unfolding the popup may be realized in three modes - horizontally, vertically and in all directions (exploding). The same three options are valid for the folding behavior. You may choose the time in seconds the Unfolding and Folding effects will take (in seconds). Finally, you can choose whether the popup should Fold or it should just popout (disappear at once).

Popup Content tab

The Behavior Settings tab lets you specify the behavior your popup will have when opening, closing and while staying opened.

Popup Content tab -> Choose the Popup Content Type section

Here you can choose the Popup Content type. You may choose between internal content that you enter using the build-in HTML editor and external content - a Web Page that will show as popup content.

Internal Content
You use the build-in HTML editor to enter and edit the popup's content (see below).

External Content
You choose a URL of a Web Page that will show as popup's content. (see Show This Web page in the Popup below).

Popup Content tab -> HTML Content Editor (internal content) section

Here you can choose the Popup Content type. You may choose between internal content that you enter using the build-in HTML editor and external content - a Web Page that will show as popup content.

HTML Editor
The HTML editor lets you edit you popup content right in Popup Toolkit's interface. You have an editing area and a toolbar with tools, which are described below. 

             4.                        7.                    8.                     9.                12.            13.              14.

           1.                      2.                     3.                5.                   6.            10.              11.         15.
Toolbar elements:
  1. Font combo box - use this combo box to set the font of the selected text or the font you would like to write with from now on.
  2. Font size combo box - use this combo box to set the font size of the selected text or the font size you would like to write with from now on.
  3. Use these three icons to set the text style - bold, italic or underlined.
  4. With these tools you can set the text justification.
  5. Create numbered list.
  6. Create bulleted list.
  7. Adjust indent.
  8. Set text color.
  9. Set text background color.
  10. Insert horizontal rule.
  11. Insert web link.
  12. Insert image.
  13. Insert table.
  14. Switch between HTML source editing mode and normal HTML editing mode.
  15. Enlarge editor in a new window.

Close Link
If you need to insert a "Close this Window" type of link in your popup, check this checkbox and enter the text of the link in the field below the checkbox. Then type [Close] inside the HTML Editor in the place where you would like the link to appear.

Popup Content tab -> Show this Web Page as Popup Content (external content) section

External Content - "Show this Web Page in the Popup" field
If you choose to use a Web Page as your popups content then this field will be enabled and you will be have to specify a valid URL for the web page that will appear in your popup. You can use either absolute or relative URLs.


Popup Code tab

The Popup Code tab lets you install your popup code to a desired web page of yours.

Popup Code tab -> Code section

Popup Code
Here you can Copy the Popup code using the "Select & Copy the Code" button. Check the "Add Script Tags" checkbox to add script tags to the Popup Code. The edit box below will show you the actual Popup Code. Use this section if you would like to install you popup code manually using your favorite HTML editor for example.

Auto Close code
If you have used the Auto Close feature found in the Behavior Settings tab and if you have chosen the Super-Imposing popup type, then here you will be able to get the Auto Close code to place in the Web Page that is showing in your Super-Imposing popup. Note that Super-Imposing popups allow only external content (a Web Page as content). Due to the limitations of the Super-Imposing popups, you need to place this Auto Close code in the HTML code of the Web Page you will show as the popup's content.

Popup Code tab -> Direct Installation section

If you need to install your popup automatically to an existing HTML document, rather than manually, you can use this section.

Choose the HTML file to which to install the Popup Code
Use the Browse button to select the HTML file from your hard disk where you would like to install you Popup Code to.

How to Install the Popup code?
You have two options:

Popup Code tab -> Popup Trigger Codes section

Each popup is unique. This is done to avoid confusion when you have more than one popup installed in a given web page and you need some unique piece of code to tell each individual popup what to do. To make each popup unique you need to set a unique Popup ID. Set the Popup ID to "Manually set" and choose an ID using letters and/or numbers.
If you choose "Auto-Generated" for the Popup ID type, Popup Toolkit will generate a different and unique ID every time you chage any setting in your current popup project, thus avoiding ID duplications. On any change you will get a different Popup ID and this will make it difficult to use Auto-Generated Popup IDs to control your popups. Also Auto-Generated Popup IDs don't have any sense and are hard to read and remember.
Below the Popup ID settings you will find any available unique triggering codes for your current popup. Here you will see some examples on how to use these triggering codes too.
The triggering codes available for the current popup are dependant on the chosen popup type and chosen popup triggering mode. For further information on triggering codes please read the "Select the Popup Triggering mode" section found in the General Settings tab.


Popup Rotator tab

The Popup Rotator tab lets you create popup rotators. Once you open a new or an existing rotator project, the user interface will switch to Rotator mode and the Popup Rotator tab will appear, while the other tabs of the interface will hide.

Popup Rotator tab -> Rotator Sequence section

The Popup Rotator is a collection of Popup Projects that you have already created and saved using Popup Toolkit. Use Rotator user interface to create Popup Rotators for your web pages. The behavior of the Popup Rotator is as follows. The Popup Rotator will show the next popup from the popup sequence each time the visitor opens the web page with the rotator. Thus you can present to the visitor each time a different offer, avoiding visitors annoyance of seeing over and over again the same offer showing. Also this approach will increase the effectiveness of your advertisements by spreading the advertisement presentations in a sequence in time rather than showing to the user all the popups at once and frustrate him/her with too many offers.
The Popup Rotator enables you to present different offers each time the web user opens your web page or even one offer but each time with a different behavior and approach.

Add a Popup Project button
Use this button to Add a Popup Projects to your Popup Rotator sequence.

Remove the Selected Popup button
Use this button to Remove the selected Popup Project from your Popup Rotator sequence.

Move Up, Move Down, Move to Top and Move to Bottom button
Use these buttons to Move the selected Popup Project up and down in your Popup Rotator sequence.

Rotator Sequence
This list box holds the Rotator Sequence of your Popup Rotator. You may select a Popup from the sequence and then use the buttons above to manipulate this Popup Project.

Popup Rotator tab -> Rotator Sequence Loop section


Rotator Sequence Loop settings
Using these settings you are able to set the loop of your rotator sequence. You may choose not to have a loop - that is when the last popup of the sequence is shown no more popups from the sequence will show anymore. You may choose to have a loop, which means after the last popup of the sequence has shown the first one will show the next time the visitor opens the page. Finally, you may set to have a timed loop and choose the period of the loop in days. This means that after the last popup of the loop has shown, the popup sequence will loop again only if the given period has elapsed counting from the moment the first popup has shown.

Popup Rotator tab -> Rotator Code section

Rotator Code button and fields
Use the button Select and Copy the rotator code for manual installation. Using the checkbox choose whether to have the script tags automatically added to your rotator code. In the edit box you will see the whole rotator code.

Popup Rotator tab -> Direct Installation section

Choose the HTML file to install the Rotator Code to
If you don't want to install the code manually, you may use the Browse button to select an HTML file from you hard disk where you would like to install your Rotator Code automatically.

How to Install the Rotator code?
You have two options: Finally, press the "Insert the Popup Rotator Code to the Selected Page" button to install the Rotator Code.

Top | Home
Copyright © 2006, 2007, Popup-Toolkit.com, All rights reserved.