Australcode Uniform Images
| 开发者 | australcode |
|---|---|
| 更新时间 | 2026年7月18日 13:41 |
| PHP版本: | 8.2 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
Australcode Uniform Images solves the classic WooCommerce catalog problem: product photos with different proportions that the theme crops brutally to align the grid. This plugin makes them uniform without cropping — it adds smart padding over a colored canvas (white by default), optionally trims the uniform background first to normalize inconsistent margins, and delivers each thumbnail in AVIF + WebP + JPEG using the
<picture> element. The result: same size product images across your whole shop — resize product images without cropping and regenerate product thumbnails in bulk, with no catalog limit.
Key differentiators
- Alt text from the product, not the filename — your uploads are called
IMG_4832.jpg. Image SEO reads the WooCommerce product title, category and brand and writes real alt text: "Vape Pod XYZ — Pods, Brand Z". Automatic on every new upload, free, no AI and no API calls. It never overwrites alt text you wrote yourself. - No accidental crops — the entire product fits inside the thumbnail, always. The plugin pads to a uniform canvas instead of guessing where to crop.
- Real
<picture>markup — multi-source with AVIF + WebP + JPEG fallback. Survives any page cache (LiteSpeed, WP Rocket, Cloudflare APO, W3 Total Cache) because it does not useVary: Accept. The browser picks the optimal format; the cache serves HTML without negotiation. - 4-tier quality preset — Maximum / High / Standard / Economy with per-format values calibrated (e.g. Standard = AVIF Q60, WebP Q82, JPEG Q85 — visually indistinguishable from the original at half the size).
- HPOS-ready from day one — declares
custom_order_tablesandcart_checkout_blockscompatibility without any setup. - Cloudflare Image Transformations (CIT) — optional integration to serve via Cloudflare edge (
/cdn-cgi/image/format=auto) with automatic availability detection on your zone. If CIT is not enabled on your CF plan, the plugin keeps serving local derivatives without breaking anything.
- Bulk regenerate with Action Scheduler — async processing resumable after worker death, error classification (
oom,missing_original,engine_failed,fs_permission), scope filters (auto= products only based on Settings;all-used= every image referenced in posts/products/Bricks templates/terms). - Embedded sample test — processes 1-5 images on demand and shows the before/after grid with bytes and % savings. Available on the Settings page ("Quick preview") and on Bulk regenerate ("Generate sample").
- Health page with CDN detection — engine diagnostics, encoders, filesystem permissions, detected competing plugins (Smush/EWWW/ShortPixel/Imagify), Cloudflare Polish status (alerts if active — incompatible with the plugin's AVIF/WebP), Image Prioritizer (Performance Lab) status with automatic detection.
- Image SEO on every upload — new product images get alt text, title and caption built from the product title, category and brand (caption off by default — WordPress fills it from the photo's IPTC data, and that text is usually the photographer's). Deterministic, no AI, no API calls. Existing images can be filled one at a time from the Media Library; filling the whole library in one pass is Pro.
- Extreme-padding detection — the Dashboard flags product images that get squared with a lot of empty canvas (panoramic or very tall photos) and a gentle, dismissible notice points you to how each aspect is handled. Detection is free; the per-aspect fix is a Pro upgrade.
- WP-CLI — 9 commands — 7 free:
wp acimg health,stats,regenerate,derivatives <id>,purge-cache(orphans;--stale/--allrequire Pro),restore-originals,migrate-from-sir. 2 Pro:wp acimg doctor(extended diagnostics) andwp acimg reset(full state reset).
- Cloudflare Image Transformations (CIT) delivery — emits
<img>with CIT URLs (/cdn-cgi/image/format=auto) instead of local derivatives when CIT is enabled on your zone. Defensive automatic fallback to the normal path if CIT is unavailable. - Media Library audit + cleanup — orphan image detector that understands Bricks Builder (PHP serialize),
wp_termmeta, WooCommerce shortcodes, custom meta. Trash mode with typed confirmation, immutable audit log, and anuntrashendpoint for rollback. - Image Health Monitor — weekly cron that scans for missing derivatives, stale derivatives, Cloudflare Polish conflicts, and storage usage. Email digest to the admin only when there are actionable findings.
- Image SEO bulk backfill — fill the alt text, title and caption your library is missing in one pass, with a dry-run preview before anything is written. It only writes where the field is empty and never touches text you wrote yourself. (This is the fix at scale for the backlog the free Dashboard counts.)
- AI Alt Text BYOK — alt text generation per attachment via OpenAI Vision (
gpt-4o-mini) or Anthropic Vision (claude-haiku-4-5). Bring Your Own Key (no Merchant of Record over AI costs). Context enrichment with WooCommerce product title + category + brand. Complements Image SEO rather than replacing it: use it on the photos where the product name doesn't describe the picture. - Catalog Watch + Auto-Heal — daily cron that detects ghost derivatives (DB rows without files), orphan files (files without DB rows), products with broken thumbnails. Auto-heal with dry-run preview + strict path validation. Persistent admin notice when there are actionable issues.
- Multi-Site Manager (Agency) — centralized dashboard to monitor up to 25 client sites from a single wp-admin. BYO Application Password, aggregated metrics (derivatives + bytes + issues), automatic hourly sync + ad-hoc. No external services: direct wp-admin ↔ wp-admin communication via native REST.
- CIT Cost Analyzer — daily pull from Cloudflare GraphQL Analytics API. MTD cost + monthly projection + peak day to identify spikes. BYO API token (CF authenticates directly).
- Per-aspect-ratio override — within a single WordPress size, process each aspect ratio (1:1, 4:3, 16:9, vertical, horizontal) differently: uniform with canvas, proportional without cropping, or skip. Keep square photos proportional while the rest follow the base mode. Wired into upload + bulk regeneration + derivative invalidation. (This is the fix for the extreme-padding the free Dashboard flags below.)
- Image Prioritizer / Performance Lab — Australcode Uniform Images detects
fetchpriority="high"and propagates correct loading/decoding to the final<picture>. Native LCP optimization. - Bricks Builder — supports
wp_get_attachment_imageand optional output buffer rewriter for themes/page builders that bypass that filter. - WP Rocket / a3 Lazy Load — compatible with
data-src/data-sizeslazy loaders (reads both if present).
- Smart crop — would break the "no cropping" promise. If you need that, this plugin is not for you.
- SaaS-only / phone home — the plugin is 100% local. All optimization happens on your own server.
- JPEG XL — format still immature in browsers. We will reevaluate in 2027.
- Padded canvas, never cropped — every thumbnail pads the product onto a uniform canvas, so the full product is always visible. No subject-guessing, no accidental crops.
<picture>element, cache-safe by design — AVIF + WebP + JPEG fallback served withoutVary: Accept, so it survives any HTTP page cache (LiteSpeed, WP Rocket, Cloudflare APO, W3 Total Cache). The browser picks the format; the cache serves one HTML.- AVIF + WebP + JPEG, all free — modern formats are part of the free core, not a paid add-on.
- Unlimited bulk on Free — regenerate your whole catalog with no image cap and no monthly credit quota.
- 100% local — all processing happens on your own server. No SaaS, no phone-home, your images never leave the site.
- Built for WooCommerce grids — reads
wp_get_registered_image_subsizes()and respects the WC thumbnail-cropping setting, so it targets exactly the product sizes your theme uses.
安装:
Via WordPress Admin (recommended)
- Go to Plugins → Add new in your WP admin, search for "Australcode Uniform Images" and click Install + Activate.
- Navigate to the new top-level menu Australcode Image → Settings and choose your quality preset (default Standard works well for most cases).
- Go to Australcode Image → Bulk regenerate, run a Sample Test with one product to validate visually, then click "Start bulk" to process the full catalog.
wp plugin install australcode-uniform-images --activate
wp acimg health # verify everything is OK
wp acimg regenerate # bulk dry-run
wp acimg regenerate --start --yes # starts bulk in the background
wp acimg reset --yes # Pro: wipe all plugin state (tables, options, dirs) without deactivating
The wp acimg reset command (Pro) clears every persisted artifact — the 6 custom tables, options, post meta, transients and derivative directories — without deactivating the plugin. It's destructive and defaults to an interactive confirm; pass --yes to skip it. Useful to start from a clean slate when re-testing settings or migrating.屏幕截图:
常见问题:
Does Image SEO rename my image files?
No. Image SEO writes the alt text, title and caption attributes — it does not touch filenames. Renaming a file after upload means rewriting every URL that already points at it, and getting that wrong breaks live product pages. If file renaming is what you're after, this is not the plugin for it.
What's the difference between Image SEO and the AI alt text feature?
Image SEO reads your WooCommerce product data — title, category, brand — and builds the alt text from a template. It's instant, free, deterministic, and runs on every upload. AI alt text (Pro) looks at the image itself and describes what it sees, using your own OpenAI or Anthropic key at a fraction of a cent per image. Most stores run Image SEO on everything and AI only on the images where the product name doesn't describe the picture — a lifestyle shot, a detail close-up, a size comparison. They write the same field, so neither runs automatically on top of the other, and neither overwrites alt text you wrote yourself.
Will it overwrite the alt text I already wrote?
No. The automatic path only writes where the field is empty. The plugin also records what it generated, so if you edit an alt text by hand afterwards it's locked — no automatic pass will touch it again. The only way anything gets overwritten is if you click the button on that specific image yourself, or explicitly pick the "replace existing" option on a bulk run.
Why is the alt text empty on some images?
Because they aren't attached to a product. Image SEO builds the text from the product title, category and brand — a logo, a banner or a blog image has no product to read from, so the plugin writes nothing rather than inventing something. The Dashboard counter reflects this: it reports how many images it can actually fill, not how many are missing alt text.
Is it compatible with WooCommerce HPOS (High-Performance Order Storage)?
Yes. Compatibility with custom_order_tables and cart_checkout_blocks is declared from day one via before_woocommerce_init. No manual configuration required.
Does it work with Cloudflare?
Yes, and well. The plugin emits <picture> with <source> per MIME type — it survives Cloudflare APO and any page cache perfectly because it does NOT use Vary: Accept (which would break caching).
If you have Cloudflare Pro+, you can enable Image Transformations from Settings → CDN edge. The plugin automatically detects whether CIT is available on your zone and emits /cdn-cgi/image/ URLs that CF transforms on-demand with format=auto.
Caution with Cloudflare Polish: if active, it re-compresses the AVIF/WebP that the plugin already optimized — double compression equals visual artifacts. The plugin detects this on the Health page and alerts you with an admin notice. Recommendation: disable Polish, keep APO.
Which image engine does it use?
Imagick (preferred) with libheif for AVIF. GD as fallback. libvips is wired in the code but requires bundled binaries (not included in v0.x — future sprint). The active engine and its capabilities (read/write per format) appear on Health → Image engines.
Do I need anything special for AVIF?
Imagick compiled with libheif (common on modern hosts: Kinsta, WP Engine, SiteGround, recent Cloudways). If Imagick does not support AVIF, the plugin still emits WebP + JPEG and the Health page reports the limitation. You do not get stuck without anything — you just lose the most efficient format.
How much storage does it use?
Estimate: ~700 KB of derivatives on average per original image at Standard preset (varies a lot by content type — product photos with a uniform background compress better). For a catalog of 1,000 products with one image each, that's ~700 MB of derivatives. By default the plugin never modifies your originals — derivatives are separate files, so you need space for original + derivatives. The only exception is the optional "apply trim to original" setting (off by default), which backs up the pristine file first and is reversible with wp acimg restore-originals.
How do I regenerate after changing settings?
Change settings on Australcode Image → Settings, save (the plugin shows a modal warning you that existing derivatives are invalidated), and then go to Bulk regenerate or run wp acimg regenerate --start --yes. The plugin keeps serving the old derivatives until regeneration completes — zero visual downtime.
Conflicts with Smush / EWWW / ShortPixel / Imagify?
Yes, disable those plugins before installing Australcode Uniform Images. The Health → Doctor page detects them and alerts you. The typical conflict is that those plugins also hook into wp_get_attachment_image and rewrite the HTML — the output ends up inconsistent.
Does it have WP-CLI?
Yes, 9 commands under wp acimg <subcommand>. Seven are free: health (CI smoke test), stats, regenerate, derivatives , purge-cache, restore-originals, and migrate-from-sir. Two require a Pro license: doctor (extended diagnostics) and reset (resets all persisted state without deactivating). Each command supports --format=json. wp help acimg lists them all.
How do I report a bug or request a feature?
Open a support thread in the WordPress.org plugin support forum (linked from the plugin page sidebar). For Pro license-related issues, contact support@australcode.io.
更新日志:
0.42.0
- New: Image SEO (free). Alt text, title and caption built from your WooCommerce product data — title, category and brand — instead of from the filename. Runs on every new upload, deterministic, no AI and no API calls. Off by default: nothing is written until you turn it on.
- New: "Missing alt text" on the Dashboard (free). Counts how many product images Image SEO can actually fill, and says plainly how many aren't attached to a product — because those have nothing to read from and no upgrade fixes that.
- New: Image SEO bulk backfill (Pro). Fills the alt text your library is missing in one pass, with a dry-run preview of real rows before anything is written.
- Fix (data): AI alt text no longer overwrites alt text you wrote yourself. The bulk action applied the generated text unconditionally, replacing hand-written alt text. It now skips those images unless you explicitly pick the new "replace existing alt text" action — and it skips them before calling the provider, so no tokens are spent on a result that gets discarded.
- Improved: AI alt text now gets product context on gallery and variation images. It previously only recognized featured images; the rest reached the model with no context at all.
- The media modal now has a single "Image SEO" field with both buttons ("Fill from product data" and, with a key configured, "Generate with AI") instead of two separate rows writing the same field.
- New: full-bleed photo detection (free). The plugin now recognizes photos that already fill the frame — lifestyle shots, banners — as opposed to product cutouts on a plain background. The Dashboard and Health page flag how many are being shrunk and framed in white, with an honest "N of M analyzed" count.
- New: "Keep full-bleed photos" setting (opt-in). Turn it on and those photos are served edge to edge instead of scaled down to the content size; real cutouts are still scaled as before. Off by default — your existing derivatives are untouched until you enable it.
- New: the "Content size (%)" is now editable in Settings. It controls how much of the canvas the subject fills in Uniform sizes (85% leaves a margin, 100% fills edge to edge). It was previously fixed and only reachable via WP-CLI.
- Fix (data): saving Settings no longer resets the content size. Sites that had customized it — for example after migrating from Perfect Image Resize, where it defaulted to 100% — silently lost the value on every save and needlessly regenerated their whole catalog. Fixed.
- Fix: with "Apply trim to the original" enabled, full-bleed photos are no longer re-encoded. When the trim finds nothing to crop, the original is now left byte-for-byte untouched instead of being re-saved at a lower quality with no benefit.
- Internal: static-analysis cleanups. No breaking changes — safe in-place upgrade.
- Maintenance: removed the "More by Australcode" cross-promotion section from the Upgrade screen.
- New: "Heavily padded" detection (free). The Dashboard now flags product photos that get squared with a lot of empty canvas — panoramic or very tall images — and a gentle, dismissible notice points you to how each aspect ratio is handled. Detection is free; the per-aspect fix is a Pro upgrade.
- Admin theme now fully matches the Australcode family. Every page header shows the product app-icon and the sidebar menu icon recolors like a native WordPress icon (de-forked onto the shared Admin Kit) — consistent chrome across every Australcode plugin.
- Polish: the Upgrade page header gained the product icon + a one-line intro, the Catalog Watch and Multi-Site tables now scroll cleanly on mobile instead of squashing, smoother transitions throughout, and the Freemius account screen picks up the green accent.
- No data or settings changes — safe in-place upgrade.
- New "Upgrade" page replaces the separate "Family" submenu — it bundles the Pro feature pitch and the "More by Australcode" cross-sell into a single, less intrusive growth surface (the family catalog still lives there, ad-free).
- Refined menu icon — the sidebar now shows the product glyph (the 2×2 uniform-grid mark), matching the plugin icon for a consistent identity.
- Completed Spanish translations for the Pro weekly health digest email, the health severity labels, and the Cloudflare cost analyzer placeholders.
- Housekeeping: SPDX license identifier in the headers, refreshed static-analysis tooling (PHPStan 2.x), and documentation tidy-up. No behavior changes for the free version.
- New look: the Australcode admin theme. Every plugin page now ships the Australcode Admin Kit — same typography, spacing and the new green accent across the whole plugin family. No settings change; purely visual.
- English-first interface. The admin UI source language is now English, with complete Spanish translations bundled (
es_ESandes_CL, 100% coverage). WordPress picks your site language automatically. - New "Family" page — discover the other Australcode plugins, see which ones you already run, and install the free ones in one click. No ads, no admin notices — it lives quietly as the last submenu.
- Fixed: PHP notices when the premium and free builds are swapped in place (constant guards).
- Fixed: the WooCommerce cropping how-to path in Settings was untranslatable.
- Licensing and checkout moved to Freemius. Pro licensing, purchases and the in-plugin account now run through Freemius — our new billing platform and Merchant of Record — replacing the previous provider. Image processing, bulk regeneration and delivery are unchanged; this release only swaps the billing/licensing layer.
- Privacy-first, optional opt-in. The connection screen is fully WordPress.org-compliant: clicking "Skip" keeps every free feature working and sends no data to any external service.
- The free version stays 100% functional with no account required.
- Updated the "External services" disclosure in this readme to reflect the move from Lemon Squeezy to Freemius.
wp acimg migrate-from-siris now free — import your Smart Image Resize settings (background color, trim, sizes) into Australcode with one command. Makes switching effortless.- New output-format controls (free) — force JPEG-only or PNG-only output per your needs, plus an optional delivery filesystem check on the Health page. Off by default; existing sites unaffected.
- Catalog Watch repair now runs in the background — on large catalogs the repair (and its preview) no longer time out behind Cloudflare. Progress is shown and you can close the page; the job continues. (Pro)
- Cleanup, Multi-Site and CIT Cost pages redesigned — Cleanup is now a 3-step wizard (Audit → Review → Move), Multi-Site has a guided empty state, and CIT Cost leads with a budget KPI + projection.
- Fixed — Settings page polish: the AI Alt Text and aspect-ratio override sections now align with the settings column, and their "Pro" badges correctly disappear once a Pro license is active.
- Page-builder coverage extended to Beaver Builder (
_fl_builder_data) and Oxygen (ct_builder_shortcodes). The detection now combines two strategies per builder: structured ID extraction (precise for Bricks/Elementor) and a universal URL scan of the builder's stored markup (covers Beaver, Oxygen, and any builder that embeds the image URL). Divi/WPBakery remain covered viapost_content.
- Page-builder coverage: Bulk Regenerate ("All used images" scope) now detects images placed directly in Bricks and Elementor templates — they live in the builder's own storage (
_bricks_page_content,_elementor_data), outsidepost_content, so previous versions never found or optimized them. Divi was already covered (it stores inpost_content). The frontend delivery already handled any<img>from any builder; this closes the generation side. - Bulk runs now process exactly what the chosen scope selected: the "All used images" scope optimizes every used image (products and non-products alike), instead of silently skipping images whose post type isn't in the processing filter. The per-type filter still governs automatic processing on upload.
- New (opt-in): auto-detect transparency. When enabled, images whose original has significant transparency (logos, cut-out products with shadows) keep their alpha channel — the plugin uses a transparent canvas and a PNG raster fallback instead of flattening onto the canvas color. WebP and AVIF already preserve transparency. Off by default, so existing sites are unaffected until you turn it on (which regenerates derivatives). Set it in Settings → Formats & quality → Transparency.
- Internationalization: the admin JavaScript layer is now fully translatable. All dynamic UI text in Bulk Regenerate and Clean Library (counters, confirmations, progress, summaries, error messages) — plus the previously localized Catalog Watch, Multi-Site, CIT Cost Analyzer and settings preview — now routes through WordPress translations instead of hardcoded strings.
- The English (en_US) translation bundle is now 100% complete.
- No behavior changes: every string keeps its original fallback until the site's active language provides a translation.
- Pro: new per-aspect-ratio mode overrides. For each main WooCommerce size you can choose how each aspect ratio is processed (square 1:1, 4:3, 16:9, portrait, etc.): uniform with canvas, proportional without cropping, or skip. For example, keep square images on "proportional" while the rest of the size follows its base mode. Available on all paid plans.
- The per-aspect override is wired into the generation pipeline (upload and bulk regeneration) and into derivative invalidation, so changing it regenerates only what is needed.
- Visibility: the Dashboard now shows how many images were skipped by the context filter (not attached to a processable post type), with a shortcut to adjust the filter. Avoids the "I uploaded an image and nothing happened" confusion.
- Security: REST endpoints that operate on attachments now verify the edit/delete capability per attachment (current_user_can edit_post/delete_post), in addition to the general manage_woocommerce gate.
- External services URLs no longer pingable as 404 — the readme's "External services" section referenced API endpoints (
api.lemonsqueezy.com,api.openai.com,api.anthropic.com,api.cloudflare.com) as full URLs. WP.org's review scanner pings every URL in the readme and flagged the Lemon Squeezy endpoint as a broken Terms/Privacy URL. Endpoints are now declared as host + path (not full clickable URLs); Terms/Privacy links remain and resolve. - Explicit output-buffer close —
OutputBufferHook(opt-in feature, off by default) now closes itsob_start()buffer explicitly onshutdown, guarded byob_get_level(). Same rewritten output, paired open/close as WP.org guidelines expect. WP 6.5+ compatible. - Banners + branding — re-generated WP.org banners with the current name (Australcode Uniform Images) and version; renamed the last legacy global variable in the bootstrap file.
- Listing polish — sharper short description and tags for the target niche, added Upgrade Notice, fixed screenshot #8 caption, aligned WP-CLI command count between Description and FAQ.