What is Pop Any Module?

Pop Any Module 3.1 opens any published Joomla module inside a popup (modal) when someone clicks a button, link, or image.

Examples: login form, contact form, newsletter signup, custom HTML — without leaving the page.

Two ways to use it

1. Content Plugin (shortcode) — paste {popanymodule …} into an article. Best for content pages.
2. Site Module — configure a trigger in the backend and place it in a module position (header, footer, sidebar). Best for site-wide buttons.

What you need

• Joomla 4, 5, or 6 (Joomla 3 is not supported)
• The install package pkg_popanymodule_3.1.zip (includes both plugin and module)
• At least one published site module you want to show in the popup (for example Login)

Which path should I choose?

• Need a popup on one article or page body? → use the Plugin / Shortcode tab.
• Need the same button on many pages? → use the Module Setup tab.
• Want lazy loading (load content only when opened)? → install and enable the plugin even if you mainly use the module.

Step 1 — Install the package

1. Log in to Joomla Administrator.
2. Go to System → Install → Extensions.
3. Upload pkg_popanymodule_3.1.zip.
4. Wait until you see a success message. This installs both the content plugin and the site module.

Step 2 — Enable the content plugin

1. Go to System → Manage → Plugins.
2. Search for Pop Any Module.
3. Find Content - Pop Any Module and set it to Enabled.
4. Click the plugin name to open settings (theme, lazy load, hash defaults). Save.

Without this plugin, shortcodes will not work, and lazy AJAX loading will not work for the module either.

Step 3 — Find a target module ID

1. Go to Content → Site Modules.
2. Open the module you want inside the popup (example: Login).
3. Look at the URL or the module list — note the numeric ID (example: 16).
4. Make sure that module is Published.

Standalone installs (optional)

If you prefer separate zips:

• plg_content_popanymodule_3.1.zip — content plugin only
• mod_popanymodule_3.1.zip — site module only

Still enable the plugin if you need shortcodes or lazy load.

After upgrading

Clear Joomla cache: System → Maintenance → Clear Cache. Hard-refresh the browser (Ctrl+F5).

What the plugin does

The content plugin reads shortcodes in articles (and other prepared content) and turns them into clickable triggers that open a module popup.

Quick start (article)

1. Create or edit an article.
2. Paste a shortcode where you want the button/link/image.
3. Save and open the article on the front end.
4. Click the trigger — the popup should open.

Basic shortcode

{popanymodule id="16" text="Open Login Form"}

id = the target module ID. text = what the visitor clicks.

Styled button

{popanymodule id="16" text="Open Login" class="ibtn ibtn-primary" icon="fas fa-sign-in-alt" lazy="true" hash="true" hashslug="modern-login"}

Image trigger with overlay

{popanymodule id="16" image="images/thumb.jpg" alt="Open login" overlaytext="Sign in" overlayeffect="slide-up" overlaybgcolor="#1819ed"}

Gallery (next / prev between two modules)

{popanymodule id="16" text="Login" class="ibtn ibtn-primary" rel="my-gallery"}
{popanymodule id="213" text="Contact" class="ibtn" rel="my-gallery"}

Use the same rel value on every item in the group.

Attribute reference

• id (required) — target module ID
• text — link or button label
• class — CSS classes; use ibtn / ibtn-primary for a button look
• icon — Font Awesome class (example: fas fa-envelope)
• image / alt — image trigger path and alt text
• popwidth / popheight — popup size (examples: 520px, 85vh). Legacy: width / height
• showtitle — true/false show target module title in the popup
• lazy — true load content via AJAX when first opened
• hash / hashslug — deep link URL hash (example: #deep-login)
• rel — gallery group name
• Image overlay: overlaytext, overlayeffect, overlaybgcolor, overlaytextcolor, imgwidth, imgheight, imgradius

Plugin defaults (backend)

Open System → Plugins → Content - Pop Any Module to set defaults used when a shortcode omits an option:

• Popup Theme (Modern or Classic)
• Lazy Load ON/OFF
• Hash / Deep Links ON/OFF
• Opening / closing effects and speeds
• Overlay colors, Modern design (width, blur, accent), image overlay defaults
• Extra CSS

Shortcode attributes always override plugin defaults for that one trigger.

What the site module does

It places a ready-made trigger (button, text link, or image) in a module position. Clicking it opens another module in a popup. You configure everything in the backend — no shortcode needed on that page.

Step-by-step setup

1. Go to Content → Site Modules → New.
2. Choose type Pop Any Module.
3. Give it a title (example: Header Login Popup). You can hide the module title on the page if you only want the button.
4. Under Trigger Settings:
   • Target Module — pick the module that should appear inside the popup.
   • Trigger Type — Text / Button, or Image.
   • For text/button: set Link Text, optional Icon Class, and Extra CSS Classes (try ibtn ibtn-primary).
   • For image: choose Trigger Image, alt text, and size.
   • Optional: Gallery Group (rel) and Hash Slug.
5. Under Popup Behaviour: choose theme, width/height, effects, Hash ON/OFF, Lazy Load ON/OFF, gallery arrows/swipe.
6. Assign a Position (example: sidebar-right, menu, or your template position).
7. Under Menu Assignment, choose On all pages or Only on the pages you need.
8. Set Status to Published and Save.
9. Visit the front end and click the trigger.

Important notes

• Lazy Load ON needs the content plugin installed and enabled.
• Do not select Pop Any Module as its own target (recursive popups are blocked).
• The target module must be published. It does not need its own menu assignment if you only open it via popup (especially with lazy load).
• Caching: if the button text looks stuck after edits, set Caching to No Caching on this module, or clear cache.

Module field groups (what each tab means)

• Trigger Settings — what visitors click, and which module opens
• Popup Behaviour — size, theme, animations, hash, lazy, gallery
• Styling — overlay/popup colors, Font Awesome, Extra CSS
• Image Trigger & Overlay — defaults for image hover captions
• Modern Popup Design — radius, blur, accent color, close button (Modern theme only)

Lazy load (AJAX)

What it does: module HTML is fetched when the popup first opens, instead of being hidden in the page HTML.

When to use: large forms, modules you do not need on every page load.

How to turn on:

• Shortcode: lazy="true"
• Plugin or Module settings: Lazy Load = ON

Requirement: Content - Pop Any Module plugin must be enabled. AJAX URL uses com_ajax with plugin popanymodule.

Hash / deep links

What it does: when the popup opens, the browser URL gets a hash like #login-form. Sharing or reloading that URL can reopen the popup.

How to set:

• Shortcode: hash="true" hashslug="login-form"
• Module: enable Hash / Deep Links and set Hash Slug

If Hash Slug is empty, a default like popmod-{id} may be used.

Gallery groups

What it does: several triggers share one group so visitors can move next/prev (and swipe on phones) between popups.

How to set: same rel="group-name" (shortcode) or Gallery Group field (module) on every item. Use letters, numbers, and hyphens only.

Enable Gallery Next/Prev and Gallery Swipe in plugin or module behaviour settings.

Popup size tips

• Prefer fixed heights like 560px when you know the content height.
• 85vh means “85% of the screen height” (a max height), not a tiny 85px box.
• Width examples: 520px, 860px, min(920px, 94vw).

Modern (2026)

Blurred overlay, rounded panel, soft shadow, CSS variables. Good default for new sites. Accent color default is #1819ed (changeable in Modern Popup Design).

Classic

Original Fancybox-style skin. Overlay patterns and close-button sprites are available under Styling.

Note: Theme is chosen in the plugin or module settings. A shortcode cannot fully force Classic by itself — set Popup Theme to Classic in the backend, then use your shortcode/module as usual.

Effects

Opening/closing: none, fade, zoom, slide-up, slide-down, elastic. Speeds are in milliseconds (example: 380).

Button classes

• ibtn — base button
• ibtn-primary — primary filled button
• Optional color helpers (when modern button styling is ON): ibtn-blue, ibtn-green, ibtn-red, …

Extra CSS

Add site-specific rules in the Extra CSS field on the plugin or module. Use browser DevTools to find class names if you need to fine-tune.

Shortcode shows as plain text

• Is Content - Pop Any Module enabled?
• Is the shortcode spelled exactly {popanymodule …}?
• Clear cache and refresh.

Click does nothing / popup empty

• Is the target module ID correct and published?
• If Lazy Load is ON, is the plugin enabled?
• Check the browser console for JavaScript errors from other extensions.

Popup is too short or cut off

• Set popheight to a pixel value like 560px.
• Avoid assuming 85vh means a fixed small height — it is a max height based on the viewport.
• Wait a moment after open if lazy load is filling content, then resize if needed.

White / invisible button

• Use class="ibtn ibtn-primary".
• Ensure Modern Button Styling is ON (Modern theme).
• Check template CSS is not overriding .ibtn with transparent backgrounds.

Hash does not reopen the popup

• Hash / Deep Links must be ON.
• hashslug must match the URL hash (without the #).
• Reload the page with the hash already in the URL.

Gallery arrows missing

• Same rel / Gallery Group on all items.
• Gallery Next/Prev enabled in settings.

Asset / registry error about plg.content.popanymodule.init

• Update to 3.1.x assets.
• Clear cache. Re-save the plugin and module.

Still stuck?

• Confirm Joomla 4/5/6.
• Reinstall pkg_popanymodule_3.1.zip.
• Contact support with your Joomla version, PHP version, and whether you use shortcode or module.