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
- Upload the dprime-woo-thumb-generator folder to /wp-content/plugins/.
- Activate Dprime Woo Thumb Generator in WordPress.
- 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.
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-tabsData 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
- Confirm the required WordPress, PHP, and companion-plugin versions above.
- Save the plugin settings again, then repeat the exact action that failed.
- Clear page, object, and browser caches when the issue affects front-end output.
- Temporarily test with unrelated plugins disabled on a staging site to identify a conflict.
- 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.
