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.

Morgan Estes

This plugin uses the <code>hashgrid.js</code> script to overlay a CSS-customizable grid.
<h3>Credits</h3>
The <code>hashgrid.js</code> script was created by <a href="http://analog.coop" rel="nofollow ugc">Analog</a> and is licensed under Apache 2.0. Follow along at <a href="https://github.com/dotjay/hashgrid" rel="nofollow ugc">https://github.com/dotjay/hashgrid</a>.

WP Hashgrid

Overlay a customizable grid over your site to help with design layout using the hashgrid.js library.

Emberly Popups vs WP Hashgrid