FAIR

Federated and Independent Repositories

Alligator Popup

Plugin Banner

Alligator Popup

by cubecolour

Download
Description

This plugin allows you to enter a shortcode to add links to pages/posts which will be opened in a popup window. The only options in Alligator popup are entered in the shortcode, so there is no admin page for this plugin.

Shortcode:

Add a popup shortcode where you would like a link to appear within your post or page text. The shortcode has parameters for url, height and width and should be in the format:

[popup url="https://cubecolour.co.uk/wp" height="300" width="300" scrollbars="yes" alt="popup"]Link Text[/popup]

Include your own Link Text and values for the url the width & height of the popup, and the alt text fot the link.

If no values are entered for the alt text and the height and width, defaults of 400px are used for the width & height of the popup window.

Scrollbars are enabled by default and will show if the scrollbars parameter is not added to the shortcode. If you do not want scrollbars on your popup window, add the scrollbars parameter with the value “no” to the shortcode: scrollbars="no"

If no value is entered for the alt text, an empty alt tag will be used in the link.

HTML Link:

Instead of using the shortcode you can include your link in the format:

<a href="https://cubecolour.co.uk/wp" class="popup" data-height="300" data-width="300" data-scrollbars="0" alt="my link text">Link Text</a>

This might be useful in a text widget, or you can build the link in a template file of your theme.

Note:

If you are using any other plugin (or a theme) that uses a shortcode with the name ‘popup’, you will not be able to use this plugin. This is not because of any shortcoming in this plugin, but because shortcodes such as those to create popup links should always be implemented in a plugin not a theme.

On mobile devices such as iPads which don’t use browser windows, the link will open in a new tab.

This plugin was written in response to a post by a WordPress.org forum user who promised to wrestle an alligator if his problem with creating popups was solved.

  1. Upload the plugin folder to the ‘/wp-content/plugins/’ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Add a popup link to a page by including the shortcode to your content in the format:
    [popup url=”http://cubecolour.co.uk/wp” height=”300″ width=”300″ scrollbars=”0″]Link Text[/popup]
  1. A popup

    A popup

Where is the admin page?

It doesn’t have any options that need an admin page, so there isn’t one.

What is the syntax of the shortcode?

[popup url=”http://cubecolour.co.uk/wp” height=”300″ width=”300″ scrollbars=”0″]Link Text[/popup]
The values for height and width must be positive integers and the value for scrollbars must be either 1 (to show scrollbars) or 0 (to not show scrollbars)

Are the shortcode parameters all necessary?

The url is a mandatory parameter but height, widths and scrollbars are optional parameters, Default values will be used for any not present.

What is the syntax of a link if I’m not using the shortcode?

Link Text

Why doesn’t it work?

The plugin does work on the sites it has been tested on. If it is not working for you, you may have done something wrong or maybe your theme is not built to WordPress standards. Feel free to ask for help on the Alligator Popup plugin support page on WordPress.org.

What levels of support are available?

I offer free forum support for free cubecolour plugins where all communication takes place on the WordPress.org forums and a link is provided to the page on your site where I can see the issue without needing a password. Non-free support via email is available if the conditions of obtaining free support on the public forum are not compatible with the level of support required. This paid email support can be requested at: cubecolour.co.uk/premium-support

I am using the plugin and love it, how can I show my appreciation?

You can donate via my donation page. If you find the plugin useful I would also appreciate a glowing five star review on the plugin review page

How do I wrestle an alligator?

This page has some handy tips:
http://www.artofmanliness.com/2010/10/19/how-to-wrestle-an-alligator/

Really Fiddly but Nothing to Touch It

By deeveearr on May 5, 2022

I was quite surprised that my comments were still high on the first page of the support forum (usually meaning that the plugin is not downloaded very much), but even though it's really fiddly to use and you need to work out a new workflow to cover a blog with over 400 posts, this works better than anything else out there! My original question was concerning Google Analytics type links, that open in a shrunken window. It's a lot easier when you work out the components, width and height, then save them onto a notepad, and remember to 'paste as plain text', and copy the link address from the original link, then delete it when the popup is compiled. Lots of these popup plugins can only be relied on to popup content from WordPress websites, but this one pops-up content from government websites, Wikipedia, and I even tried a couple of Google Maps links last night, all of which opened in shrunken popup windows. Right then, better crack on with the rest of my 400 posts!

Brilliant plugin!

By coderiverstudio on February 17, 2022

Just simply works. Thank you. And the sequel alligator menu popup was just what I needed to pop from a menu.

A keeper

By markonrose on February 15, 2021

Does what it's supposed to do, simply and reliably.

How Plugins Should Be

By starapple on September 13, 2018

This is how plugins should be: Simple and just add an enhancement that seems natural. Some plugins seem larger than core. Good job.

Simple, easy and it does work!

By antoniomc76 on February 11, 2018

After trying some other plugins, this is the the easiest and most effective. Thanks!

Works perfectly, easy as heaven

By 8oris on December 18, 2017

Installation: 5 seconds Usage: easy, no tricky methods or whatever needed Interface: well designed

Simple, Lightweiht, Great... Recommended !!!

By ynteligent on August 28, 2017

This is exactly what I was looking for. I just put html and php code to my template... and that is it. Thank you.

Great, does exactly what I need it to do

By lukejr on July 19, 2017

It works, thanks.

A great solution

By jgmm81 on April 10, 2017

works fine without problems thanks a lot!

Clean and Perfect

By lindaschneider on April 7, 2017

Does what it says. Pops up a new window (an actual full page within a box at the dimensions you want).

2.0.0

  • Removed jQuery as dependency

1.2.1

  • Removed function to get plugin version

1.1.3

  • added alt parameter to shortcode for alt tag support in popup link
  • reduced the size of the plugin page icons

1.1.2

  • added ‘resizable=yes’ to enable maximise button on popped up window in IE

1.1.1

  • Undefined variable fixed in plugin page links

1.1.0

  • Dynamic Version number added to script enqueue
  • Plugin Page Links
  • Added scrollbars option to shortcode

1.0.1

  • Small improvements to documentation

1.0.0

  • Initial Version
Back to top