AdsDestroyer – clean admin panel & white label

Description

AdsDestroyer turns the WordPress admin into a clean, white-label workspace. Hide any element you do not need — advertising blocks, promotional notices, menu items, admin-bar nodes, or confidential data — by picking it visually. The plugin generates a precise XPath or CSS selector and applies it on every page load, so hidden blocks never flash back.

Perfect for:
– Focus & Productivity: Hide distracting admin notices, promotional banners, and unnecessary UI elements to concentrate on your work
– Brand Customization: Remove third-party branding, API keys, and sensitive information from admin screens
– Clean Interface: Eliminate clutter by hiding elements that can’t be removed through standard WordPress settings
– Client Management: Create cleaner admin experiences for clients by hiding complex settings and technical information
– Development Workflow: Remove development notices, debug information, and testing elements from production admin

Key Features:
– Visual Selection Mode: Click the admin bar button and visually select any element to hide
– Smart Block Picker: Snaps to meaningful blocks and lets you preview and choose parent containers
– Collision-Aware Panel: Keeps controls clear of the selected block, admin bar, and menu, with a pointer to the target
– Smart Selector Engine: Chooses stable IDs, data attributes, classes, text, or a positional fallback and validates uniqueness
– Stable Admin Chrome Rules: Uses deterministic anchors for submenu items and global scope for admin menu and admin bar targets
– Flexible Duration: Set rules to hide elements forever or for specific time periods (hours, days, weeks, months)
– Safe Removal: Uses HTML5 parsing with placeholder replacement to prevent broken layouts
– Rule Management: Full CRUD interface to edit, activate/deactivate, and delete rules
– Conflict Resolution: Automatically detects duplicate rules and offers to activate existing ones
– Multisite Support: Per-site or network-wide rule management
– Performance Optimized: Only processes admin pages, never affects frontend performance

We drew inspiration from these plugins:
– Admin Menu Editor Pro
– White Label CMS
– Adminimize
– Remove Admin Notices
– Admin Columns Pro

Usage

Quick Start:
1. Activate Selection Mode: Click the « Disable ad » button in the WordPress admin bar to start hiding elements
2. Select Elements: Hover over any element to preview it, then click to select
3. Refine the Target: Preview the parent chain and choose a complete container when needed
4. Choose Duration: Click « Hide » and explicitly select how long to hide the element:
– Hide forever (permanent)
– For a day (24 hours)
– For a week (7 days)
– For a month (30 days)
5. Element Hidden: The selected element disappears only after a duration is chosen

Managing Rules:
– View All Rules: Go to Settings → AdsDestroyer to see all your hidden elements
– Edit Rules: Click the edit button to modify XPath rules, add descriptions, or change expiration dates
– Toggle Rules: Activate/deactivate rules without deleting them
– Delete Rules: Remove rules you no longer need
– Reset All: Clear all rules at once if needed

Advanced Features:
– Visual Selection: The plugin resolves nested markup to a meaningful block and offers up to six ancestor candidates
– Selector Validation: Every generated XPath must resolve to exactly the selected element before it is stored
– Scope Awareness: Fragile page content stays page-specific, while admin menu and admin-bar rules can work globally
– Conflict Detection: If you try to hide an element that’s already hidden, the plugin offers to activate the existing rule
– Safe Removal: Uses HTML5 parsing to prevent broken layouts when hiding elements
– Page Information: Automatically tracks which page each rule was created on for better organization

Multisite

• By default, settings are per site.
• Optional network-wide mode (planned toggle in settings) stores options as a site option across network.

Output Buffering

This plugin uses PHP output buffering (ob_start) to process HTML content in the WordPress admin panel. The buffering is only active in the admin area and never affects the frontend of your website.

Important for hosting providers:
– The plugin does NOT use output buffering on frontend pages
– Admin panel pages are rarely cached by hosting providers due to their personalized nature
– If you have admin panel caching enabled on your hosting, it may cause conflicts with the plugin’s functionality
– If you have problems with WordPress admin panel caching. We recommend disabling admin panel caching when using this plugin

Technical details:
– The buffering is used to apply XPath rules to hide unwanted elements in the admin interface
– No impact on frontend performance or caching

Development & Build Instructions

This plugin uses modern build tools for JavaScript and CSS compilation. To build the plugin from source:

Prerequisites:
– PHP 7.4 through PHP 8.4 with the DOM extension
– Node.js 18 or higher
– npm (comes with Node.js)
– Composer 2

Build Commands:
– npm install – Install dependencies
– npm run build – Build production assets and create distribution package
– npm run build:dev – Build development assets (with source maps)
– npm run dev – Build development assets (alias for build:dev)

Build Process:
1. JavaScript files are compiled using Vite from assets/js/ directory
2. SCSS files are compiled to CSS from assets/scss/ directory
3. Compiled assets are output to build/ directory
4. Final distribution package is created as build/compiled/ads-destroyer-[version].zip

Source Files:
– JavaScript: assets/js/main.js, assets/js/admin-settings.js, and related modules
– SCSS: assets/scss/index.scss, assets/scss/admin-settings.scss, and component files
– Build configuration: vite.config.js, package.json

Output Structure:
– build/js/ – Compiled JavaScript files
– build/css/ – Compiled CSS files
– build/compiled/ – Distribution packages

Our Other Plugins

AI Thumbnails Maker – Automatically generate beautiful AI-powered thumbnails and force regenerate featured images for your WordPress posts. Perfect for keeping your media library fresh and professional.
SmartyPress AI Engine – Powerful AI integration for WordPress with ChatGPT and Deepseek. Generate high-quality content directly in Gutenberg editor with Magic Wand inline editing and AI Content Generator panel. Create titles, articles, excerpts with 10+ pre-built actions or custom prompts.
Unnotifier – Take complete control over WordPress admin notifications. Hide, customize, or remove any admin notice with precision. Essential for agencies managing multiple client sites or power users who value a clean interface.
Everyone Accessibility Suite – Lightweight accessibility widget and frontend panel so visitors can adjust typography, contrast, colors, and reading aids. Includes 5 accessibility profiles and 40+ tools for WCAG 2.1, ADA, and Section 508 compliance.