Emberly Digital

Emberly Popups is a simple PHP function that generates ARIA‑compliant modal popups. Great for newsletters, surveys, announcements, or any call‑to‑action:
<ul>
<li>Auto‑open after a configurable delay </li>
<li>Cookie‑ or session‑based “show once” control </li>
<li>Repeat interval (milliseconds) between popups </li>
<li>Shortcode support inside popup content </li>
<li>Adjustable width and padding </li>
<li>Accessible markup with proper ARIA roles</li>
</ul>
<h3>Usage</h3>
<h3>PHP 8+ (named arguments)</h3>
“`php 
emberly_popup( 
 title : ‘Welcome!’, 
 content : ‘
Thanks for visiting our site. Don’t miss our latest offers!
‘, 
 id : ‘welcome-popup’, 
 width : ’50rem’, 
 padding : ‘3rem’, 
 echo : true, 
 output_shortcodes: true, 
 auto_open : true, 
 delay : 2000, 
 show_once : false, 
 persistence_method: ‘session’, 
 show_interval_ms : 1800000 // 30 minutes 
); 
 <code><h3>PHP 7 & earlier (ordered arguments)</h3>```php 
emberly_popup( 
 '', // $title 
 'Thanks for visiting our site. Don't miss our latest offers!', 
 'category-survey-popup', // $id 
 '50rem', // $width 
 '3rem', // $padding 
 true, // $echo 
 true, // $output_shortcodes 
 true, // $auto_open 
 2000, // $delay 
 false, // $show_once 
 'session', // $persistence_method 
 1800000 // $show_interval_ms 
);</code>
<h3>Manual triggers</h3>
Anywhere in your markup, add: 
 <code>html 
<a href="#" em-popup-trigger-id="welcome-popup">Open Welcome Popup</a></code> 
The <code>em-popup-trigger-id</code> value must match the <code>$id</code> you set in <code>emberly_popup()</code>.
<h3>Parameters</h3>
 Parameter 
 Type 
 Default 
 Description
 title 
 string 
 ” 
 Popup heading text.
 content 
 string 
 ” 
 HTML for the popup’s body.
 id 
 string 
 ” 
 Unique popup identifier (required for cookies/sessions & triggers).
 width 
 string 
 ’60rem’ 
 CSS max-width for the popup container.
 padding 
 string 
 ‘3rem’ 
 Inner padding inside the popup.
 echo 
 bool 
 true 
 Echo the markup immediately (false to return as string).
 output_shortcodes 
 bool 
 false 
 Process WordPress shortcodes in <code>content</code>.
 auto_open 
 bool 
 false 
 Automatically open after <code>delay</code> ms.
 delay 
 int 
 0 
 Milliseconds to wait before auto-open.
 show_once 
 bool 
 false 
 If true, shows only once per session/cookie period.
 persistence_method 
 string 
 ‘cookie’ 
 Where to store “shown” flag: ‘cookie’ or ‘session’.
 show_interval_ms 
 int 
 0 
 Minimum interval (ms) before showing again. 0 disables repeats.
 debug 
 bool 
 false 
 Log internal events to browser console (load, open, cookies, scroll lock).
<h3>Debugging</h3>
Add <code>debug: true</code> (PHP 8+) or append <code>true</code> as the 13th argument (PHP 7) to enable console logging:
<pre><code>`php
</code></pre>
// PHP 8+ example 
emberly_popup( 
 title : ‘Debug Popup’, 
 content: ‘
Debugging is on!
‘, 
 id : ‘debug-popup’, 
 debug : true 
); 
 `

Emberly Popups

Lightweight, accessible popups for WordPress—made by developers, for developers.

Adam Nowak

This plugin is an alternative to the jQuery based lightbox systems. It was created using pure Javascript and has no dependencies on any other libraries. I created this simple lightbox after weeks of dealing with jQuery conflicts within Buddypress and WordPress. Many of the existing jQuery type lightboxes do not stop audio playback for flash/.swf playback when closing the lightbox. This plugin completely removes the overlay content from the dom to make absolutely sure your .swf file playback is stopped in all browsers.
<h3>Help</h3>
How to implement the Ez Overlay lightbox:
<ol>
<li>Copy the code for this example into the WordPress editor in the HTML window or start from scratch and go to step 2.</li>
<li>Create an Ez Overlay Div element by assigning it a with the class=”ez-overlay”, to avoid css conflicts add your target div to the body of your html and not within a sidebar or another div.</li>
<li>Assign the new Div a unique CSS Id so it can be activated by the trigger. Ie: id=”my-overlay”.</li>
<li>Put whatever Html content within the Ez Overlay Div.</li>
<li>Create a trigger for the overlay, it can be just about any Html element but needs an ‘onlclick’ attribute to activate the lightbox. See the ezFade() function below.</li>
</ol>
Tips:
<ol>
<li>Ie7 will render text elements within this overlay at a different size than Ie8. If this is an issue, just assign a width and height to your Ez Overlay target div using an inline style.</li>
<li>Avoid padding or adding margins to the Ez Overlay target div. Padding adds to a div’s width and height and will throw your overlay off-center. Just add a margin to the elements within the target div instead.</li>
<li>In the folder named ‘uncompressed-js’, there is a file named ‘ez-overlay.js’ which is a readable copy of the compressed code for tinkering.</li>
<li>The plugin removes the overlay div’s from the dom when you exit out of them, this is so that .swf playback will be halted on all browsers. Don’t panic, the plugin immediately returns them to the body of your html document at the very end.</li>
</ol>
ezFade Function:
<pre><code>onclick="ezFade('my-overlay4',800,true,100,100);"
</code></pre>
The ezFade() function accepts five arguments, the first being the target lightbox to be triggered, the second is the fade time. The third argument is to activate "fixed mode", and finally the x/y coordinates if you want you overlay to be fixed in a certain position.

Ez Overlay

A simple lightbox plugin designed to enable you to display html content within a popup window using just about any html element as a trigger.

Emberly Popups vs Ez Overlay