PLZS Elementor Popup Menu Link

 ______   __         ______     ______    
/\  == \ /\ \       /\___  \   /\  ___\   
\ \  _-/ \ \ \____  \/_/  /__  \ \___  \  
 \ \_\    \ \_____\   /\_____\  \/\_____\ 
  \/_/     \/_____/   \/_____/   \/_____/ 

English | Русский

---

English

A lightweight, high-performance, and object-oriented WordPress plugin designed to seamlessly connect Elementor Pro Popups to standard WordPress navigation menus.

Normally, triggering popups from menu items requires manual CSS class configurations or complex JavaScript hacks. This plugin integrates directly into the WordPress admin panel, allowing you to select and assign popups with a single click.

[!TIP] Performance Optimized: This plugin loads dynamically. It scans the rendered navigation menu on each page and injects only the necessary popup assets in the footer, preserving your site's speed and SEO scores.

🌟 Key Features

• 🎯 Native WP Menu Integration: Adds a clean dropdown field inside the Appearance -> Menus editor for each menu item.
• ⚡ Dynamic Asset Loading: Only enqueues the required popup templates on the current page to avoid DOM bloat.
• 🎨 Dual-Layer Style Rendering: Enqueues the template stylesheet (\Elementor\Core\Files\CSS\Post) and renders inline styles as a fallback. This guarantees popups look perfect and center correctly as modals without unstyled layout shifts.
• 🌐 Multilingual Ready: Full translation mapping support for WPML and Polylang out of the box.
• 🚀 Native Triggering: Binds clean jQuery events to fire the native Elementor Pro JS popup API (showPopup) for fluid animations.

---

🚀 Installation

Option 1: Direct ZIP Download (Recommended)

1. Go to the Releases page on GitHub.
2. Download the latest plzs-menu-popup-vX.Y.Z.zip file.
3. In your WordPress Dashboard, go to Plugins -> Add New -> Upload Plugin.
4. Select the downloaded ZIP file, click Install Now, and then Activate Plugin.

Option 2: Manual Git Installation

1. Clone this repository into your WordPress plugins folder (wp-content/plugins/):

   git clone https://github.com/Plazzos/plzs-menu-popup.git

2. Go to WordPress Dashboard -> Plugins and click Activate.

[!IMPORTANT] Make sure both Elementor and Elementor Pro are installed and active on your WordPress site.

---

📖 How to Use

1. Navigate to Appearance -> Menus in your WordPress dashboard.
2. Expand any menu item (e.g., Pages, Custom Links, Categories).
3. Look for the new section titled Trigger Elementor Popup.
4. Select your desired popup from the dropdown menu and click Save Menu.
5. Visit the frontend of your website. Clicking that menu item will now trigger the Elementor popup smoothly!

---

🛠️ Directory Structure

plzs-menu-popup/
├── plzs-menu-popup.php           # Main plugin bootstrap file
├── README.md                     # Project documentation (EN/RU)
├── includes/
│   ├── class-plugin.php          # Core plugin controller (Singleton)
│   ├── class-admin.php           # Admin dropdown controls & data saving
│   └── class-frontend.php        # Frontend menu parsing & footer rendering
└── assets/
    ├── css/
    │   └── admin.css             # Admin dashboard UI stylesheet
    └── js/
        └── frontend.js           # Frontend popup click interceptor

---

Русский

Легковесный, объектно-ориентированный WordPress плагин с высокой производительностью, разработанный для простого и бесшовного подключения всплывающих окон (Popups) Elementor Pro к стандартным навигационным меню WordPress.

Вместо того чтобы вручную прописывать CSS-классы, использовать костыли или сложный JavaScript, этот плагин добавляет удобное выпадающее меню выбора прямо в настройки каждого пункта меню в админке.

[!TIP] Оптимально для SEO: Плагин работает динамически. Он сканирует активное меню на странице и выводит в футер только нужные попапы. Никакого лишнего кода для неиспользуемых страниц!

🌟 Ключевые возможности

• 🎯 Нативная интеграция с меню WP: Добавляет красивое и удобное поле выбора попапа в редакторе Внешний вид -> Меню для каждого пункта.
• ⚡ Динамическая загрузка ресурсов: Плагин сканирует меню и подключает в футер только те попапы, которые выводятся на текущей странице, сохраняя высокую скорость загрузки страниц сайта.
• 🎨 Стабильное отображение стилей: Использует двухэтапную систему загрузки CSS (подключение внешнего файла стилей Elementor и дублирующий вывод inline-стилей). Это гарантирует, что попапы отобразятся корректно, сохранят свои размеры, анимации и центрирование, предотвращая появление нестилизованного контента.
• 🌐 Мультиязычность: Полная поддержка плагинов перевода WPML и Polylang (плагин автоматически подменяет ID попапа на нужный язык).
• 🚀 Нативный вызов: Перехватывает клик по ссылке и запускает окно через встроенный фронтенд-API Elementor Pro (showPopup), сохраняя оригинальные анимации и условия закрытия окон.

---

🚀 Установка

Способ 1: Прямая загрузка готового архива (Рекомендуется)

1. Перейдите на страницу Releases на GitHub.
2. Скачайте файл последней версии архива plzs-menu-popup-vX.Y.Z.zip.
3. В админ-панели вашего сайта перейдите в Плагины -> Добавить новый -> Загрузить плагин.
4. Выберите скачанный ZIP-архив, нажмите Установить, а затем Активировать плагин.

Способ 2: Ручная установка через Git

1. Склонируйте этот репозиторий прямо в папку плагинов WordPress (wp-content/plugins/):

   git clone https://github.com/Plazzos/plzs-menu-popup.git

2. Перейдите в раздел Панель управления WordPress -> Плагины и нажмите Активировать.

[!IMPORTANT] Для работы плагина на вашем сайте должны быть установлены и активны плагины Elementor и Elementor Pro.

---

📖 Инструкция по использованию

1. Перейдите в раздел Внешний вид -> Меню в админ-панели.
2. Раскройте любой пункт меню (страница, произвольная ссылка, рубрика).
3. Найдите новую секцию Trigger Elementor Popup.
4. Выберите нужное всплывающее окно из выпадающего списка и нажмите кнопку Сохранить меню.
5. Перейдите на сайт. При клике на выбранный пункт меню ваше всплывающее окно плавно откроется!

---

License / Лицензия

GPLv2 or later. Created by Plazzos.