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
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/prangishviliabe/adaptx-pro/archive/refs/heads/main.zip

Readme

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

Read the full README on GitHub →