README

mhinspeya/inspeya-hyva-popup

Main Functionalities
Installation
Configuration
Popup Rules & Targeting
Popup Positioning
Specifications
Attributes

Main Functionalities

The MHinspeya Hyvä Popup Module allows Magento 2 store owners and marketers to create dynamic, targeted, responsive, and fully customizable popup messages directly from the Magento admin panel.

This module is highly flexible and supports:

✔ Custom Popup Creation

Create multiple popups from the backend
Add HTML content, images, text, promotions, newsletter forms, etc.
Supports Hyvä theme and Alpine.js
Easy-to-use admin UI for popup design

✔ Powerful Popup Display Rules

Customer Group targeting
Specific Page targeting
Display only during Valid From and Valid To date ranges
Ability to enable/disable each popup
Show to guests, logged-in users, or both

✔ Popup Position Control

Choose where the popup appears on the screen:

Center
Top
Bottom
Left
Right
Floating corners
Full-width banners

✔ Fully Responsive

The popup adapts to:

Desktop
Tablet
Mobile

No layout breaking — optimized for all Hyvä viewports.

Installation

* For production environments, use --keep-generated.

Type 1: Manual (Zip) Installation

Extract the module to:
```
app/code/MHinspeya/Popup
```

Enable the module:

php bin/magento module:enable MHinspeya_Popup

Run setup upgrade:
```
php bin/magento setup:upgrade
```
Clear cache:
```
php bin/magento cache:flush
```

Type 2: Composer Installation

Add repository if needed:

composer config repositories.inspeya composer https://repo.inspeya.com/

Install the module:

composer require mhinspeya/inspeya-hyva-popup

Enable module:

php bin/magento module:enable MHinspeya_Popup

Run upgrade:
```
php bin/magento setup:upgrade
```
Clear cache:
```
php bin/magento cache:flush
```

Configuration

Admin Path:

Stores → Configuration → MHinspeya → Popup Settings

Here you can:

Globally enable/disable popup functionality
Configure front-end behavior & loading logic
Set default animations
Manage overlay settings

Individual popups are managed under:

Marketing → Popup Manager

Each popup contains:

Title
Content (HTML/Images/Text)
Customer group rules
Page rules
Valid From / Valid To
Position settings
Status (Active/Inactive)

Popup Rules & Targeting

✔ Customer Group Based Targeting

Display popup only to:

Guests
Logged-in customers
Specific customer groups

✔ Page-Level Targeting

Choose where the popup appears:

Homepage
Category page
Product page
CMS page
Cart
Checkout
Custom URL patterns

✔ Date Range Control

Every popup supports:

Valid From (start date)
Valid To (end date)

Popups only show during the configured date range.

Popup Positioning

Available positions:

Center modal
Top bar
Bottom bar
Left sidebar
Right sidebar
Top-left
Top-right
Bottom-left
Bottom-right
Full width

100% responsive on all screen sizes.

Specifications

Feature	Supported
Hyvä Compatibility	✔
Custom Popup Builder	✔
Customer Group Targeting	✔
Page-level Targeting	✔
Valid From / To	✔
Multi-position Popups	✔
Fully Responsive	✔
Unlimited Popups	✔
Overlay & animations	✔

Attributes

This module does not create product or category attributes.

It includes:

Admin popup grid
Popup creation/edit form
Popup rule engine
Frontend Hyvä popup renderer

mhinspeya / inspeya-hyva-popup

Maintainers

Details