214
$5
Add to project

Product support

Get help in the plugin support forum.

Categories

Automatically optimize and speed up your website media! The Upload Image Resizer & Converter plugin automatically resizes large uploaded images and converts them into next-generation WebP or AVIF formats directly upon upload in October CMS.

Key Features

  • Automatic Image Resizing: Automatically resizes images that exceed your specified maximum width while keeping exact aspect ratios.
  • Next-Gen WebP & AVIF Conversion: Convert uploaded JPEGs and PNGs into modern WebP or AVIF formats for maximum page speed scores.
  • Preserve Original File Backup: Option to keep original high-res JPG/PNG files on disk as backup alongside converted images.
  • Minimum Size Threshold: Set a minimum file size limit (in KB) to skip processing small icons, logos, or thumbnails.
  • Independent Quality Control: Separate compression quality settings for standard formats (JPG/PNG) and modern formats (WebP/AVIF).
  • EXIF Mobile Orientation Fix: Automatically detects and corrects orientation for photos uploaded directly from smartphones.
  • PNG Transparency Preservation: Maintains transparent backgrounds during resizing and format conversion.
  • Interactive Batch Optimization Tool: Re-process and optimize all existing uploaded images in your system with a real-time progress bar.
  • CLI Command: Run php artisan imageresize:process via terminal or cron for automated background batch optimization.
  • Fast & Self-Contained: Uses native PHP GD library functions. No external API keys or third-party services required.
Resizing

Installation via Command Line

php artisan plugin:install Stheme.ImageResize

Upload Image Resizer & Converter Documentation

Installation & Configuration

Navigate to Settings -> Image Resize Settings in your October CMS Backend.

1. General Settings (Resizing Tab)

  • Enable Image Resize: Enable or disable automatic image processing globally.
  • Max Image Width: Maximum allowed image width in pixels (default: 2000px).
  • Minimum File Size (KB): Skip images smaller than this threshold (e.g., 50 KB).
  • JPG / PNG Quality: Compression quality percentage for original formats (0-100, default: 85%).

2. Format Conversion (WebP & AVIF Tab)

  • Format Conversion: Choose Keep Original Format, Convert to WebP, or Convert to AVIF (requires PHP 8.1+ GD).
  • WebP / AVIF Quality: Compression quality percentage for converted formats (0-100, default: 80%).
  • Keep Original File: Enable to preserve the original JPG/PNG file on disk alongside the converted image.

Batch Optimization Tools

Option A: Backend UI Progress Bar (Batch Tool Tab)

  1. Go to Settings -> Image Resize Settings -> Batch Tool.
  2. Click Start Batch Optimization Now.
  3. A real-time progress bar will display processing progress, file names, and total disk space saved (MB).

Option B: Terminal / Artisan Command

Run the following command in your terminal to batch-process all existing images:

php artisan imageresize:process
1.1.0

Added AVIF format conversion support (PHP 8.1+ GD)

Jul 29, 2026
1.0.5

Added error handling with try/catch blocks

Jan 07, 2026
1.0.4

Added settings permissions

May 28, 2025
1.0.3

Add image size control

Mar 20, 2025
1.0.2

fix resizer

Mar 20, 2025
1.0.1

First version of ImageResize

Jan 21, 2025

Version 1.1.0

  • Added AVIF format conversion support (PHP 8.1+ GD).
  • Added Minimum File Size threshold setting (KB).
  • Added option to Keep Original File on disk when converting formats.
  • Added separate quality controls for JPG/PNG vs WebP/AVIF.
  • Added interactive Batch Optimization Tool with real-time progress bar in Backend Settings.
  • Added php artisan imageresize:process CLI command for batch processing.
  • Redesigned settings UI into clean, compact tabs (Resizing, WebP & AVIF, Batch Tool).
  • Removed TinyPNG API dependency for 100% self-contained local image processing.

Upgrading Steps:

No breaking changes or manual database steps required. Simply update the plugin via Marketplace / Composer and configure your preferred format settings under Settings -> Image Resize Settings.