Emberly Popups for WordPress

persistence_method: ‘session’,

show_interval_ms : 1800000 // 30 minutes

);

<h3>PHP 7 & earlier (ordered arguments)</h3>```php

emberly_popup(

'', // $title

'<p>Thanks for visiting our site. Don't miss our latest offers!</p>',

'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

);

Manual triggers Anywhere in your markup, add:

html

<a href="#" em-popup-trigger-id="welcome-popup">Open Welcome Popup</a>

The em-popup-trigger-id value must match the $id you set in emberly_popup().

Parameters 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 content.

auto_open

bool

false

Automatically open after delay 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).

Debugging Add debug: true (PHP 8+) or append true as the 13th argument (PHP 7) to enable console logging:

`php

// PHP 8+ example

emberly_popup(

title : ‘Debug Popup’,

content: ‘

Debugging is on!

‘,

id : ‘debug-popup’,

debug : true

);

`