Skip to content

Repository files navigation

Advanced Pixel Editor

Version WordPress Plugin Version PHP Version License: GPL v2 WordPress Plugin Downloads

Crop, resize, rotate, flip, contrast and sharpen images inside the WordPress Media Library with a live before/after preview. Requires the ImageMagick PHP extension.

πŸš€ Powered by ImageMagick: This plugin requires the ImageMagick PHP extension for image processing. Imagick is extremely common and should be available on most modern hosting platforms. Enabling Imagick is a significant upgrade for image handling on WordPress sites, leading to better results from plugins and core features.

πŸ“¦ Current Version: 3.8.0 | πŸ“… Released: September 24, 2026 | ⚑ WordPress 5.6+ Required

Advanced Pixel Editor Banner

✨ Features

Professional Image Editing

  • πŸ€– AI Edit: Describe a change in words and the AI provider connected in WordPress 7.0+ (OpenAI or Google) edits the image; refine, adjust and save it like any other edit
  • 🎨 Real-time Preview: See filter changes instantly as you adjust sliders
  • πŸ”§ Contrast Adjustment: Professional contrast control with fine-tuned precision
  • ⚑ Unsharp Masking: Advanced sharpening with full control over amount, radius, and threshold
  • βœ‚οΈ Crop & Resize: Interactive crop overlay with aspect ratio presets, resize with aspect lock, and DPI controls
  • πŸ”„ Rotate & Flip: Free rotation with 45/90-degree presets, plus horizontal and vertical mirroring
  • β™Ώ Accessibility: Full keyboard navigation and screen reader support
  • πŸ”’ Security: Rate limiting, input validation, and secure file handling
  • πŸš€ Performance: Optimized processing with memory management and dimension limits
  • πŸ“± Responsive Design: Works perfectly on all screen sizes
  • πŸ”— WordPress Integration: Seamless media library workflow

AI Edit example

AI Edit before and after: "Replace the sky with a warm sunset"

Advanced Features

Advanced filters (brightness, saturation, hue, auto levels, sepia, vignette, blur, noise reduction, emboss), text and image watermarks, and zoom & pan in the preview are available in Advanced Pixel Editor Pro.

🎯 Perfect For

  • πŸ“Έ Photographers and Designers: Professional image editing tools
  • πŸ“ Bloggers and Content Creators: Quick image enhancements
  • πŸ›’ E-commerce Stores: Product image optimization
  • 🏒 Corporate Websites: Brand-consistent image processing
  • πŸ‘₯ Anyone: Who needs professional image editing in WordPress

πŸš€ Installation

Prerequisites

⚠️ Important: This plugin requires the ImageMagick PHP extension (Imagick) to be installed and enabled on your server.

Imagick is extremely common and should be available on most modern hosting platforms. If Imagick is not enabled:

  1. Contact your web hosting provider
  2. Request that they enable the ImageMagick PHP extension
  3. Most hosting providers can enable this quickly (usually within hours)
  4. Enabling Imagick is a significant upgrade for image handling on WordPress sites, leading to better results from plugins and core features

Installation Steps

  1. Download the plugin from WordPress.org
  2. Upload the advanced-pixel-editor folder to /wp-content/plugins/
  3. Activate the plugin through the 'Plugins' menu in WordPress
  4. Navigate to Media β†’ Advanced Pixel Editor to start editing

Requirements

  • WordPress: 5.6 or higher
  • PHP: 7.4 or higher
  • 🟑 ImageMagick Extension (Imagick): Required for image processing

⚠️ ImageMagick Extension Setup

The plugin requires the ImageMagick PHP extension for image processing. Imagick is extremely common and should be available on most modern hosting platforms.

Why Imagick? Enabling Imagick is a significant upgrade for image handling on WordPress sites, leading to better results from plugins and core features. ImageMagick provides superior image processing capabilities compared to GD library.

If Imagick is not enabled on your server:

  1. Contact your web hosting provider immediately
  2. Request that they enable the ImageMagick PHP extension
  3. Most hosting providers can enable this quickly (usually within hours)
  4. If using shared hosting, you may need to upgrade to VPS or dedicated server
  5. This is not optional - the plugin will not function without Imagick

Need help? Contact your webhost provider if Imagick is not installed on your server.

πŸ“– Usage

  1. Select Image: Click "Select Image" to choose from your WordPress media library
  2. Adjust Filters: Use the intuitive sliders to apply contrast and sharpening
  3. Preview: See changes in real-time as you adjust the controls
  4. Save: Click "Save Edited Image" to create a new version in your media library

Filter Controls

  • Contrast: Adjusts the difference between light and dark areas (-1 to 1)
  • Sharpness Amount: Controls the intensity of sharpening (0-5)
  • Sharpness Radius: Determines how far the sharpening effect spreads (0-10 pixels)
  • Sharpness Threshold: Sets the minimum contrast level for sharpening (0-1)

🀝 Supporting Open Source

This plugin is powered by ImageMagick, the world's most comprehensive free software suite for image processing. ImageMagick has been a cornerstone of digital imaging since 1987, supporting millions of websites and applications worldwide.

When you purchase Advanced Pixel Editor Pro, 20% of all proceeds are donated to support the ImageMagick project, helping sustain the free software that powers professional image processing worldwide.

Learn more about ImageMagick | Sponsor ImageMagick on GitHub

πŸ“Έ Screenshots

  1. Main Editor Interface - Clean, professional interface with real-time preview
  2. Filter Controls - Intuitive sliders for contrast and sharpening adjustments
  3. Accessibility Features - Full keyboard navigation and screen reader support
  4. Media Library Integration - Seamless workflow with WordPress media library

πŸ”§ Frequently Asked Questions

How do I access the image editor?

Navigate to Media β†’ Advanced Pixel Editor in your WordPress admin panel.

What image formats are supported?

The plugin supports all standard web image formats including JPEG, PNG, GIF, and WebP.

Is there a limit to image size?

By default, images up to 10MB and 4096Γ—4096 pixels are supported for optimal performance.

Can I edit images that are already in my media library?

Yes! Select any image from your WordPress media library to edit and enhance.

Does this plugin create backups of original images?

Yes! When using "Save as new image" mode, the original is untouched. When using "Replace original" mode, a backup is created automatically and you can restore it at any time.

Is the plugin accessible for users with disabilities?

Yes! The plugin includes full ARIA support, keyboard navigation, and screen reader compatibility.

Can I use this plugin on mobile devices?

Yes, the editor is fully responsive and works on tablets and mobile devices.

Does this plugin require any special server configuration?

Yes, the plugin requires the ImageMagick PHP extension (Imagick) to be installed and enabled on your server. Imagick is extremely common and should be available on most modern hosting platforms. Contact your web hosting provider if it's not installed - most can enable it quickly (usually within hours). Enabling Imagick is a significant upgrade for image handling on WordPress sites, leading to better results from plugins and core features.

πŸ› οΈ Development

Contributing

Contributions are welcome! Please see our contributing guidelines on GitHub.

Requirements for Development

  • WordPress 5.6+
  • PHP 7.4+
  • ImageMagick PHP extension (Imagick)
  • Node.js 20+ for JavaScript checks

The repository ships browser-ready assets and has no package-install step.

Running Checks

# PHP syntax
find . -type f -name '*.php' -not -path './vendor/*' -print0 | xargs -0 -n1 php -l

# JavaScript syntax and regression tests (when present)
find assets/js -type f -name '*.js' -print0 | xargs -0 -n1 node --check
shopt -s nullglob
js_tests=(tests/*.test.js)
if (( ${#js_tests[@]} )); then node --test "${js_tests[@]}"; fi

# Shell syntax and the WordPress.org distribution archive
for f in build-wp-org-zip.sh dev-tools/*.sh; do bash -n "$f"; done
./build-wp-org-zip.sh

GitHub Actions runs these checks across supported PHP versions for every pull request.

πŸ“Š Changelog

[3.8.0] - 2026-09-24

  • AI Edit: describe a change in words and the AI provider connected under Settings > Connectors edits the image (WordPress 7.0 or newer, OpenAI or Google provider plugin). A second prompt refines the result; the other tools and both save modes work on it. Unsaved results are kept for 24 hours; the prompts, provider and model are stored with the saved image
  • New hooks for add-ons: advaimg_source_path filter, advaimg_image_saved and advaimg_image_restored actions
  • Readme documents the AI provider as an external service, with links to its terms and privacy policy

[3.7.1] - 2026-09-18

  • Crop aspect presets (1:1, 4:3, 16:9) now reshape the crop selection as soon as you click them, and open the selection if it was not shown yet
  • The aspect ratio lock between Width and Height is a real button, reachable with Tab and toggled with Space or Enter
  • The editor sliders show a visible focus ring when reached with the keyboard

[3.7.0] - 2026-09-06

  • Animated GIF and WebP images are processed frame by frame and saved with all their frames
  • Crop selections are mapped on the canvas the server reports, so crops after resize, rotation, repeated crops and Replace Original land where you drew them
  • Apply Crop clears the selection after applying, drops an active resize, and says so when the preview is not ready yet
  • Replace Original validates the edited file before it replaces the original and restores the original if metadata generation fails; backups get collision-safe names
  • The server checks format, dimensions, total pixels, frame count and DPI before processing and refuses unsupported formats with a clear message; rotation, resize and DPI resampling have their own output limits
  • Preview requests are sequenced and cancelled so a slow response can no longer overwrite a newer edit
  • Reset and switching images clear every transform (Advanced Pixel Editor Pro 2.4.4 follows the same reset)
  • AVIF, HEIC and HEIF are recognized by name
  • The "Advanced Editor" button label is escaped before it is inserted into the Media Library
  • Truthful plugin description and About tab resources; translation template regenerated (212 strings) with a context for the crop preset "Free"
  • Added GitHub Actions checks for PHP 7.4, 8.1 and 8.5, JavaScript, shell syntax and the WordPress.org package

[3.6.1] - 2026-08-17

  • Fixed the crop overlay dimming the whole page instead of only the area outside the selection
  • Widened the crop X/Y/W/H inputs (four-digit values were clipped)
  • Locked Pro toolbar icons and dimmed Pro sliders now link to the Pro page
  • Fixed the About tab showing an outdated version number
  • Refreshed readme description, tags and screenshots

[3.6.0] - 2026-07-04

  • Added Flip tool: mirror images horizontally or vertically, with combined flips supported
  • New toolbar button with live preview; works together with Rotate, Crop and all filters

[3.5.0] - 2026-07-04

  • Added Rotate tool: free rotation from -180 to 180 degrees with 45 and 90 degree presets
  • New toolbar button with live preview; corners filled white (JPEG) or transparent (PNG/WebP)
  • Declared compatibility with WordPress 7.0

[3.4.0] - 2026-03-18

  • Added Crop & Resize tool: interactive crop overlay with aspect ratio presets, resize with aspect lock, DPI/resample controls
  • Added Apply/Clear buttons for Resize and DPI controls
  • Comparison slider is hidden while the crop tool is active to prevent interference
  • Crop & Resize moved from Pro to free plugin

[3.3.2] - 2026-03-02

  • Added per-attachment permission checks for multi-author security
  • Added keyboard focus styles for WCAG 2.4.7 compliance
  • Improved touch event handling and code cleanup
  • Refreshed WordPress.org readme with Pro add-on reference

[3.3.1] - 2026-03-02

  • Fixed comparison slider labels, handle alignment, sharpness ranges, default values, keyboard shortcuts, loading spinners, and duplicate heading

[3.3.0] - 2026-03-02

  • Contrast filter upgraded to gradual sigmoidal contrast (Photoshop-style curve)
  • Save now preserves original image format (PNG transparency, WebP, GIF) instead of converting to JPEG

[3.2.0] - 2026-02-27

  • Add filterable tab system (advaimg_admin_tabs, advaimg_valid_tabs, advaimg_render_tab_ action) for add-on extensibility
  • Add advaimg_editor_contrast_after hook for injecting controls into the Contrast tool group
  • Add icon palette toolbar with tool-based panel switching

[3.1.1] - 2026-02-08

  • Fixed "Advanced Editor" button placement on attachment edit page, now appears next to "Edit Image"
  • Added translation template (.pot) file

[3.1] - 2026-02-08

  • Added "Advanced Editor" button to attachment edit page sidebar

[3.0] - 2026-02-08

  • Added save mode selection: save as new image or replace original
  • Added custom filename input for new image saves
  • Added automatic backup when replacing original image (WordPress _wp_attachment_backup_sizes pattern)
  • Added "Restore Original" option to revert replaced images

[2.9] - 2026-01-28

  • Added "Advanced Editor" button to Media Library grid view modal (next to "Edit Image")
  • Added "Advanced Edit" row action to Media Library list view
  • Editor now supports direct image pre-loading via URL parameter from Media Library

[2.8] - 2025-01-23

  • Added draggable comparison slider handle on the image preview
  • Clicking anywhere on preview wrapper now moves the comparison slider
  • Added touch support for comparison slider on mobile devices
  • Filter controls now support negative values (contrast, sharpness amount, radius, threshold)

[2.7] - 2025-01-21

  • Changed plugin slug from "advanced-image-editor" to "advanced-pixel-editor" per WordPress.org review
  • Updated text domain, class names, and all file references to match new slug
  • Renamed main plugin file to advanced-pixel-editor.php

[2.6] - 2025-01-21

  • Renamed plugin display name from "Advanced Image Editor" to "Advanced Pixel Editor"

[2.5] - 2025-01-21

  • Fixed plugin URI validation issue
  • Changed prefix from 'aie' to 'advaimg' to meet WordPress.org guidelines (4+ characters)
  • Improved base64 image data sanitization with dedicated validation method
  • Renamed internal files to match new prefix convention
  • Added build script for WordPress.org submission

[2.4] - 2025-01-16

  • Fixed WordPress.org validation errors
  • Improved UI and user experience

[2.3] - 2025-01-15

  • Added preview toggle checkbox to show/hide image preview
  • Added before/after comparison slider with draggable handle
  • Redesigned layout with preview at top and compact controls sidebar
  • Improved responsive design for mobile devices
  • Enhanced user interface with better space utilization

[2.2] - 2025-01-14

  • Complete plugin rename from "Advanced Image Filters" to "Advanced Image Editor"
  • Enhanced security with rate limiting, input validation, and capability checks
  • Improved accessibility with ARIA support and keyboard navigation
  • Performance optimizations with memory management and dimension limits
  • Better user interface with loading states and progress indicators
  • Comprehensive internationalization support
  • WordPress coding standards compliance

[2.1] - 2025-01-10

  • Initial release with basic image editing functionality

πŸ“„ License

This plugin is licensed under the GPL v2 or later.

Advanced Pixel Editor is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

Advanced Pixel Editor is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with Advanced Pixel Editor. If not, see <https://www.gnu.org/licenses/gpl-2.0.html>.

πŸ™ Credits

Developed by: Rafael Minuesa and the ProWoos team

Built with:

  • Advanced Imagick processing
  • Custom WordPress AJAX API
  • Secure input validation
  • Optimized image processing algorithms

Special Thanks:

  • ImageMagick community for the powerful image processing library
  • WordPress community for the amazing platform

πŸ“ž Support

Free Support


Advanced Pixel Editor brings professional image editing capabilities to the WordPress ecosystem, powered by the Open-Source ImageMagick library. 🌟

About

Professional image editing tool with advanced filters, contrast adjustment, and unsharp masking. Real-time preview, accessibility features, and seamless WordPress integration.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages