Skip to content
jquery-plugin to create a popunder
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist
src
.gitignore
AUTHORS.txt
Gruntfile.js
LICENCE
README.md
THANKS.md
bower.json
index.html
package.json

README.md

jquery-popunder

jquery-popunder is a jquery-plugin to create popunders in major browsers.

Usage

Popunders are popups which are opened in the background of a browser-window. This script will only work, if the popunder is opened on a user-generated event (e.g. click or submit).

For examples and usage documentation, take a look at the index.html.

The recommended usage is the first example: a function to build the url-stack. So you leave the event-handling to the plugin. To add some flexibility to the function, the plugin will pass the initial event to the function - from which you may access e.g. DOM-data of the activated DOM-element.

Options

All of the options are optional!

{
    "cookie": "__puc",     The cookie-name (optional, used for blocking a popunder)
    "name": "__pu",        The window-name (optional)
    "blocktime": false,    The time to block popunder, in minutes
    "window": {
        "height": ..       The width of the popunder
        "width": ..        The height of the popunder
        ..: ..             more window.open-parameters ..
    },
    "skip": {              UA-Patterns to skip (needs to be a known ua!)
        "opera": true
    },
    "cb": null             Callback, after a popunder has been opened (if a function)
}

Donation

Feel free to donate and support further development:

BTC: 15nw595FRxMzYs4DjCXeLwAMPapFKnCWNf
ETH: 0x9854049be24048077ce4df93162513d829a71e43
NEO: AJeEyx4obEAE9AsMKuZQYn93P1B15djCW8
XMR: 468Qxh8QXZL9zE7KLLiAJAH73qGNDjx984kPDhedsFzRWjBh6qWp5EfP6zWogYsKWm97K5LsKJkT8hL3rf68aMCTDCzPwSK

Compatibility

jquery-popunder was tested with:

  • Mozilla Firefox 3-57
  • Google Chrome 10-62
  • Microsoft Internet Explorer 6-11, edge

Known Issues

  • chrome 45+ & linux is covered by moving the originating website into a new tab, leaving the popunder on the first one
  • in Firefox, when the setting: 'Open new windows in a new tab instead' is deactivated

Installation

Just copy the dist/jquery.popunder.min.js file into your project or use bower:

bower install jquery-popunder

or add it to your bower.json.

Dependencies

The dependencies can be installed using bower

bower update

When you're not using jquery, you could use dist/popunder.min.js, which includes a stripped version of jquery. Mind, that there is no real selector-engine included, which limits element-selection in oldie to #ids.

You can’t perform that action at this time.