WP Manifestindependent plugin directory
manifest / builders / adaptx-pro

AdaptX Pro

Intelligent responsive layout optimizer for Elementor. Automatically analyzes and fixes mobile & tablet layouts without touching the desktop design

by Abe Prangishvili · github.com/prangishviliabe/adaptx-pro · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/prangishviliabe/adaptx-pro/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/prangishviliabe/adaptx-pro ↗

AdaptX Pro Cover

⚡ AdaptX Pro

Intelligent Responsive Layout Optimizer for Elementor

AdaptX Pro automatically analyzes your Elementor layouts and generates optimized CSS for mobile & tablet breakpoints — without ever modifying the desktop layout.

🎯 What It Does

Feature Description
Auto-Detect Sections, containers, columns, widgets, custom CSS, spacing, positioning, layering
Smart Analysis Overflow issues, fixed widths, column overflow, font sizing, spacing imbalance
Intelligent Fixes Column stacking, flex-direction, fluid typography, proportional spacing, touch targets

🛡️ Desktop Safety — 6 Layers of Protection

  1. Media Query Enforcement — CSS Generator physically cannot emit bare rules
  2. Post-Generation Validation — Safety Guard parses final CSS and rejects leaks
  3. Read-Only Data Access — Never writes to _elementor_data
  4. No DOM Manipulation — Zero frontend JavaScript
  5. Specificity Control — Single-class selectors prevent desktop leaks
  6. Kill Switches — Global + per-page + per-section toggles

🚀 Features

  • ⚡ One-click optimization — activate and forget
  • 🎛️ 3 intensity levels — Conservative / Balanced / Aggressive
  • 📊 Analytics dashboard — total fixes, rule breakdown, pages scanned
  • 🔧 Per-page & per-section controls — granular control
  • 🐛 Debug mode — visual overlays showing applied rules
  • 📱 Preview simulation — live preview bar with fix counts
  • 💾 File-based caching — fast, browser-cacheable CSS per page
  • 🔥 Zero frontend JS — pure CSS approach, no CLS impact

📦 Installation

  1. Download or clone this repository
  2. Copy the adaptx-pro/ folder into wp-content/plugins/
  3. Activate from WordPress Admin → Plugins
  4. Configure at AdaptX Pro in the admin sidebar
cd wp-content/plugins/
git clone https://github.com/prangishviliAbe/Adaptx-Pro.git adaptx-pro

🏗️ Architecture

adaptx-pro/
├── adaptx-pro.php                 # Bootstrap
├── includes/
│   ├── core/
│   │   ├── class-layout-analyzer.php   # Elementor JSON parser
│   │   ├── class-rule-engine.php       # 14 heuristic rules × 3 intensities
│   │   ├── class-css-generator.php     # Media-query-only CSS output
│   │   ├── class-safety-guard.php      # Desktop protection validator
│   │   ├── class-breakpoint-manager.php
│   │   └── class-cache-manager.php
│   ├── admin/                     # Settings, meta box, analytics, editor controls
│   └── frontend/                  # CSS renderer, debug overlay, preview bar
├── templates/                     # Admin UI templates
└── assets/                        # CSS & JS

⚙️ How It Works

Page Visit → Cache Check → Layout Analyzer → Rule Engine → CSS Generator → Safety Guard → Cache & Enqueue
  1. Layout Analyzer reads _elementor_data (read-only)
  2. Rule Engine applies 14 heuristic rules at the configured intensity
  3. CSS Generator wraps every rule in @media (max-width: …)
  4. Safety Guard validates output — rejects anything that could affect desktop
  5. Cache Manager stores per-page .css files with hash-based invalidation

📋 Rule Engine (14 Rules)

Rule What It Does
Column Collapse Stacks multi-column layouts vertically on mobile
Width Constrain Adds max-width: 100% to fixed-width elements
Font Scale Applies fluid clamp() typography
Spacing Reduce Reduces oversized padding/margins proportionally
Gap Optimize Caps large gap values
Flex Direction Switches row → column for containers with many children
Absolute Reposition Safely repositions overflow-causing absolute elements
Button Touch Enforces WCAG minimum touch target sizes
Overflow Guard Prevents horizontal scroll from fixed-width elements
Image Fluid Constrains large fixed-width images
Z-Index Normalize Caps extreme z-index values
Text Overflow Adds word-break for long text
Section Full Width Expands boxed sections on mobile
Heading Scale Scales heading sizes proportionally

🔧 Requirements

  • WordPress 6.0+
  • Elementor 3.10+
  • PHP 7.4+

👤 Author

Abe Prangishvili

📄 License

GPL-2.0+ — See LICENSE