Focused WordPress plugins for real client work.Clear licensing for 1, 5, or 100 websites

Woo Thumb Generator help

Installation, usage, and technical reference for version 1.6.1.

Overview

WooCommerce's default thumbnail behavior crops product images to fit a target aspect ratio. If your catalog has images in mixed sizes and shapes (tall, wide, square, irregular), the crop will hide important parts of some products.

Thumb Generator produces a square thumbnail at your chosen size, with the original image scaled to fit inside and the remaining space filled with your chosen padding colour. Nothing gets cropped.

Configurable settings:

Before you start

  • WordPress 6.4 or newer
  • PHP 8.2 or newer
  • WooCommerce must be active

Installation

  1. Upload the dprime-woo-thumb-generator folder to /wp-content/plugins/.
  2. Activate Dprime Woo Thumb Generator in WordPress.
  3. Open the plugin settings and review the available options.

Interface guide

Use these screens with the steps below. Select an image to open it at full size.

Woo Thumb Generator settings for image sizes and thumbnail generation.
Choose product-image settings and generate the thumbnail sizes required by the store.

Using the plugin

  • Output size (200 to 1200 px)
  • Padding percentage (0 to 20%)
  • Background colour
  • JPEG quality
  • Overwrite existing thumbnails

Styling and CSS classes

These public-facing class hooks are present in the plugin styles. Add custom CSS only after checking the result on a staging site.

.dp-btn-ghost.dp-hd.dp-hd-actions.dp-hd-mark.dp-hd-text.dp-help.dp-lbl.dp-msg.dp-msg-err.dp-msg-ok.dp-msg-rst.dp-notice-zone.dp-pill.dp-pill-active.dp-pill-inactive.dp-pill-warning.dp-pro-tag.dp-save.dp-section.dp-section-body.dp-section-hd.dp-sections.dp-tab.dp-tabs

Data and cleanup

  • 1 WordPress setting
  • Content metadata: _product_image_gallery

Retention: kept until the plugin is uninstalled. Uninstall policy: delete the plugin-owned data declared above.

Troubleshooting

  1. Confirm the required WordPress, PHP, and companion-plugin versions above.
  2. Save the plugin settings again, then repeat the exact action that failed.
  3. Clear page, object, and browser caches when the issue affects front-end output.
  4. Temporarily test with unrelated plugins disabled on a staging site to identify a conflict.
  5. If the problem remains, record the steps, visible error, and relevant logs before contacting support.

Updates and access

Download the complete plugin directly. Dprime Core can connect it to the public update catalogue.