# Cyphex Image Hunter — Full Changelog

Complete version history. The in-plugin readme (and the WordPress.org directory page) only shows the most recent releases, since WordPress.org truncates the Changelog section at 5,000 characters.

= 3.2.4 =
* Fix: The Handbook "Start Here" chapter card and the Dashboard's "Groq (LLM)" usage stat card showed an empty icon box because they referenced "dashicons-rocket" and "dashicons-brain", neither of which exists in WordPress's actual Dashicons set. Replaced with valid icons ("flag" and "superhero"). Every icon reference in the plugin has been cross-checked against the real Dashicons list.

= 3.2.3 =
* Fix: The Auto-Hunt metabox options (WebP/AI alt text/credit/resize checkboxes), shown in the narrow post-editor sidebar, could overflow or clip their labels because the layout assumed more width than a typical ~280-350px editor sidebar provides. Labels now wrap cleanly instead of being forced onto one line.

= 3.2.2 =
* Fix: The 3.2.1 fix for the Handbook intro heading used a browser-width breakpoint that didn't account for WordPress's own admin sidebar plus this plugin's internal navigation rail squeezing the actual content area; the heading could still wrap one word per line at common screen widths. It now stacks to a single column by default and only switches to two columns on very wide windows.

= 3.2.1 =
* Fix: Settings page AI model dropdowns truncated their selected value mid-word on medium-width screens; they now truncate cleanly with an ellipsis and the Engine field has more room.
* Fix: Connector Hub's wp-config.php constant name (e.g. CYPHEX_UNSPLASH_ACCESS_KEY) could get clipped by its card edge instead of wrapping; it now always wraps fully into view.
* Fix: The Handbook page's intro heading wrapped one word per line on medium-width screens; it now stacks to a single column earlier so the heading reads normally.

= 3.2.0 =
* Security: Escaped AI-generated alt text before embedding it in Auto-Hunt image markup, closing a stored-XSS vector.
* Fix: Quick Fix no longer deletes the original file during its WebP step; it now creates a non-destructive sibling like the standalone WebP tool.
* Fix: Guaranteed a restore backup is created before any in-place image change in Quick Fix, closing a case where no backup existed.
* Fix: Corrected Auto-Hunt image insertion order when two placements resolved to the same paragraph.
* Enhancement: Added an opt-in "Allow resizing" option to Target Compression, Direct Sideload, and Auto-Hunt's Max KB setting; pixel dimensions are preserved by default.
* Enhancement: Unified Target Compression, Direct Sideload, and Auto-Hunt's Max KB logic into one shared, consistent compression engine.
* Fix: Registered a real "weekly" WP-Cron schedule; the weekly media snapshot was never actually running.
* Fix: Restored the Replicate rate-limit retry countdown by preserving the provider's error code through to the browser.
* Enhancement: Groq multi-key rotation now retries a different key on a rate limit instead of failing immediately.
* Fix: Added missing failure handling to Set Favicon, Logo Lab background removal, Accessibility Audit fixes, dashboard reset actions, the setup wizard, and Media Intelligence's rename tools, so a network error no longer leaves a button stuck.
* Fix: Hid other plugins' admin notices on Cyphex's own screens to prevent layout breakage.
* Fix: Scoped Health Scan, Accessibility Audit, and Bulk Toolkit scans to the current user's own attachments when they cannot edit others' media.
* Fix: Renamed the "Local ComfyUI" connector to reflect that it requires a public HTTPS address.
* Enhancement: Added page-builder detection (Elementor, Divi, Beaver Builder, Oxygen, Bricks) to the Auto-Hunt panel with a clear notice instead of a silent failure.
* Cleanup: Removed a dead, destructive legacy WebP code path and a redundant duplicate asset-enqueue call.
* Enhancement: Added the missing Max KB field to the Direct Sideload page.
* Enhancement: Added a confirmation step before running a bulk tool across multiple selected images.
* Fix: Replaced native browser popups in Media Intelligence's rename tools with the plugin's own styled dialogs.
* Docs: Updated the External Services disclosure to list Openverse, Unsplash, Replicate, OpenAI, Gemini, and the Cyphex Agency support-form fallback; added uninstall cleanup for two previously-orphaned options.

= 3.1.4 =
* Fix: Corrected Replicate output parsing when providers return an output array.
* Fix: Restored attachment rights fields for older imports that stored media creator/source metadata under legacy keys.
* Fix: Corrected inpainting mask submission and guarded bulk AI imports against empty output URLs.
* Fix: Limited Bulk Toolkit WebP scans to non-WebP images.
* UI: Tightened the Hunt Images media modal layout on wide screens to remove large empty gaps between controls.

= 3.1.3 =
* Fix: Corrected creator/author credit mapping for stock and generated image imports.
* Fix: Preserved source, creator, creator URL, and licence metadata in attachment rights fields.
* Fix: Corrected async Replicate polling responses for background removal, inpainting, upscale, and bulk background removal.
* Fix: Corrected AI metadata UI description-field update after metadata generation.

= 3.1.2 =
* Compatibility: Removed deprecated utf8_decode() call and implemented robust UTF-8 meta-tag prefix fallback to support WordPress 5.8.0+ and PHP 8.2+ compatibility.

= 3.1.1 =
* Reliability: Added mbstring PHP extension fallback and empty content check for Auto-Hunt DOM parser.
* Performance: Optimized iterative compression loop with execution time limit checks to prevent script timeouts.
* Optimization: Implemented transient caching for system capabilities test, invalidating on setting and plugin status changes.
* Compatibility: Added developer filter `cyphex_should_wrap_attachment_picture` and class `cyphex-no-wrap` bypass support to prevent styling conflicts on `<picture>` wrappers.

= 3.1.0 =
* Intelligence: Added local reuse search, media SEO scoring, rights risk, exact duplicates, and broken URL inspection.
* Recovery: Added preview-first Safe Rename and reversible filename maps.
* Discovery: Added a live image sitemap and authenticated REST attachment assessments.
* Automation: Added weekly bounded audits and a read-only WP-CLI audit command.
* Commerce: Added optional WooCommerce product context with automatic eligibility detection.
* UI: Added a responsive, CSS-isolated bento workspace and dashboard/navigation entry points.

= 3.0.1 =
* Resize: Restored exact width-and-height output while retaining proportional one-axis resizing.
* Compression: Rebuilt target-size quality search so every attempt starts from an untouched source snapshot.
* Reliability: Added explicit editor/save error handling and honest closest-safe-result feedback.
* Auto-Hunt: Scoped and normalized the editor metabox grid for classic, block-editor, and narrow sidebars.

= 3.0.0 =
* Modern formats: Added capability-filtered WebP and AVIF sibling generation.
* URL safety: Original attachments and URLs remain unchanged while browsers receive picture-based format choices.
* Responsive delivery: Generates modern siblings for full images and registered WordPress sub-sizes.
* Fallbacks: Original img markup remains the final picture fallback.
* Privacy: Added Keep, GPS-only, and remove-all metadata modes for new uploads.
* Bulk privacy: Added EXIF/GPS Privacy to the categorized Bulk Toolkit.
* Recovery: Metadata changes use the existing original-image backup and record an operation ledger.
* Compatibility: GPS-only processing requires Imagick; unsupported sites receive a clear no-change response.

= 2.9.0 =
* Security: Validates MIME content, extension agreement, file presence, and a 50 MB safety ceiling after every sideload.
* Reliability: Added up to three safe remote-download attempts and generic user-facing failure messages.
* Attribution: Persists source, creator, creator URL, and license metadata on imported attachments.
* Cache: Added generation-based search cache invalidation when connector/search settings change.
* Cache: Added a manual Clear Search Cache control in Settings.
* Auto-Hunt: Added eligible public custom-post-type support through a filterable post-type list.
* Social tools: Made crop presets filterable and validates custom dimensions.
* Product: Confirmed all functionality remains free, open source, local-first, and without artificial quotas.

= 2.8.2 =
* Standards: Replaced the direct upload-directory writability check with WP_Filesystem.
* Security: Sanitized every bulk Accessibility Audit attachment ID immediately after unslashing.

= 2.8.1 =
* Readiness: Added centralized capability detection for uploads, WebP, stock search, browser AI, optional AI providers, and WooCommerce.
* UX: Added a responsive “What you can use right now” dashboard matrix.
* Progressive disclosure: WooCommerce workflows remain hidden when WooCommerce is inactive.
* Fallbacks: Smart Fix preserves original formats when WebP is unavailable.
* Controls: WebP and AI-only options are disabled when their requirements are unavailable.
* Simplicity: Removed planned R2/S3 fields from normal Settings and Connector Hub; standard WordPress storage requires no external server.
* Developer support: Exposed non-sensitive capability status to the plugin JavaScript runtime.

= 2.8.0 =
* Health Score: Added a complete local Media Library health scan with a clear score out of 100.
* Health Score: Detects oversized files, missing alt text, weak filenames, missing files, incomplete metadata, and exact binary duplicates.
* Smart Fix: Added one-click, backup-first website image optimization with batched progress.
* Smart Fix: Resizes oversized originals, compresses, converts JPEG/PNG to WebP, and fills missing local metadata without an API key.
* Reporting: Added per-image before/after size and total storage-savings results.
* Safety: Every modified image is backed up through the existing Restoration Engine before processing.
* Performance: Duplicate hashes are cached in attachment metadata and invalidated after modification.

= 2.7.0 =
* Accessibility: Added a dedicated bento-style Alt-Text and Accessibility Audit workspace.
* Accessibility: Detects empty, filename-like, very short, and incomplete image metadata.
* Accessibility: Added individual and selected-batch AI repair with capability checks and 30-minute report caching.
* Analytics: Added private, local cumulative impact statistics and rolling 30-day daily counters.
* Analytics: Dashboard now reports storage reclaimed, optimized images, WebP conversions, metadata fixes, AI generations, and estimated transfer-time savings.
* Privacy: Impact analytics remain entirely inside the WordPress database and can be reset by administrators.

= 2.6.5 =
* Media Library: Rebuilt Image Hunt as a responsive bento workspace.
* Sideload: Improved result cards, source attribution, import actions, feedback, and accessible status messaging.
* Editors: Confirmed universal integration through the standard WordPress media modal used by Gutenberg, Classic Editor, Elementor, WPBakery, and compatible builders.
* Isolation: Scoped all new media workspace styles to the media frame to prevent theme and plugin CSS collisions.

= 2.6.4 =
* ONBOARDING: Updated the setup wizard for Image Lab, Connector Hub, four stock sources, and optional Gemini, OpenAI, Unsplash, Groq, and Replicate credentials.
* NOTICES: Added a dismissible current-release banner with direct Image Lab and Connector Hub actions, and refreshed welcome and maintenance notices.
* UI: Added responsive bento feature cards and connector fields to the setup wizard.

= 2.6.3 =
* SETTINGS: Consolidated AI, workflow, Image Lab, connector, storage, and security configuration into one responsive bento settings page.
* UI: Converted the complete text handbook into a dense, gap-free responsive bento reading grid.
* CLEANUP: Removed 38 obsolete handbook screenshot assets and synchronized all release metadata and documentation.

= 2.6.2 =
* FIX: Replaced agency website navigation with the official WordPress.org profile to avoid iframe blocking in WordPress Playground.

= 2.6.1 =
* BRANDING: Added the official Cyphex Agency WordPress.org profile to the agency card and sidebar footer.

= 2.6.0 =
* NEW: Image Lab bento workspace for multi-provider image generation, presets, aspect ratios, quality controls, downloads, and direct Media Library saving.
* NEW: Free browser generation with Puter Flux Schnell, Stable Diffusion 3, and DALL-E 3 models.
* NEW: Server-side Gemini Nano Banana 2 Lite, Nano Banana 2, and Nano Banana Pro adapters.
* NEW: Server-side OpenAI GPT Image 2, GPT Image 1.5, and GPT Image 1 adapters.
* UI: Introduced responsive bento-grid layouts across Image Lab and the main tool dashboard.
* MONITORING: Added combined Connected Image AI usage and expanded stock connector counts.

= 2.5.0 =
* NEW: Connector Hub with dedicated provider cards, wp-config.php constant support, health checks, and latency reporting.
* NEW: Working Openverse licensed-image search with creator and license metadata.
* NEW: Optional Unsplash search connector with attribution metadata and download tracking.
* PREVIEW: Configuration cards for OpenAI Images, Gemini/Nano Banana, public ComfyUI, and Cloudflare R2 ahead of generation and offload adapters.
* SECURITY: Expanded direct-image compatibility while retaining HTTPS-only, public-IP, redirect-safe SSRF validation.

= 2.4.4 =
* FIX: Agency website links now always launch as external tabs instead of loading inside the WordPress Playground frame.
* UX: Added clear feedback when the browser blocks the external tab as a pop-up.

= 2.4.3 =
* UI: Introduced a shared 4/8-pixel geometry system across every screen, card, field group, action row, and responsive breakpoint.
* FIX: Corrected the legacy direct-child margin rule that removed intended vertical spacing between page sections.
* UI: Equalized Handbook card internals and tips, balanced the Dashboard into a complete tool grid, and aligned action buttons to consistent baselines.

= 2.4.2 =
* UI: Added unified tool cards across the dashboard and workspaces, plus an official Cyphex Agency profile and service links.
* DOCS: Replaced the screenshot gallery with a complete searchable, text-based field manual covering every workflow and common error.
* COMPATIBILITY: Hardened CSS isolation and responsive boundaries for WordPress admin, Media Library modals, tablets, phones, and third-party plugin coexistence.

= 2.4.1 =
* UI: Restored the categorized Bulk Toolkit with separate cards for optimization, AI enhancement, publishing, and recovery tools.
* UX: Each tool now has its own description and selection state while retaining the secure paginated scan and cancellable processing engine.

= 2.4.0 =
* UI: Restored a premium Cyphex visual identity with a dark studio sidebar, amber-gold navigation, layered surfaces, polished cards, richer controls, and responsive mobile treatment.
* UX: Added clearer visual hierarchy, stronger focus states, reduced-motion support, and consistent interaction feedback without changing the repaired workflows.

= 2.3.9 =
* FIX: Completed the v2.3.7 UX audit repair pass, including accessible feedback dialogs, cached stock-service fallback, accurate monitoring, and Handbook search/lightbox support.
* FIX: Removed native alert/confirm dialogs, fragile style-attribute selectors, false quota estimates, and the blocking rate-limit wait loop.
* UX: Added Auto-Hunt slot bulk selection, linked support navigation, stock-proxy onboarding copy, and clearer degraded-service messages.
* SECURITY: Preserved strict provider URL validation, per-attachment permissions, and proxy-held stock API credentials.

= 2.2.8 =
* NEW: Zero-Friction Auto-Discovery Licensing — The plugin automatically registers itself to your central licensing dashboard upon installation.
* NEW: Remote 1-Click Activation — Instantly activate the Pro or Agency tier remotely from your licensing dashboard.
* NEW: Auto-Sync check — Client sites automatically fetch remote license tokens on settings load or via the "Check Status" sync action.

= 2.2.7 =
* FIX: Resolved TypeError: Cannot read properties of undefined (reading 'poll_url') in administrative JavaScript when AJAX action response is empty.
* FIX: Safeguarded asynchronous background processing against unexpected undefined responses.

= 2.2.6 =
* COMPATIBILITY: Added full support for WordPress 7.0 including Connectors API integration.
* COMPATIBILITY: Registered Groq, Replicate, Pexels, and Pixabay services natively within the WordPress Connectors Registry.
* FALLBACK: Implemented WordPress 7.0 native AI Client fallback for prompt optimization and Alt/Description metadata generation when API keys are missing.
* FIX: Routed Google Nano image generation requests directly to the native AI Client on WordPress 7.0+.

= 2.2.5 =
* NEW: Agency Enterprise Tier — Exclusive new license plan for high-volume agencies.
* NEW: Multi-Key Rotation — Plug in multiple Groq API keys to effectively multiply your daily token and request quotas.
* NEW: Live Quota Dashboard — Real-time site-wide capacity monitoring for Agency users.
* NEW: Smart Cooldown Timer — The plugin now parses 429 rate limit errors and displays a countdown before automatically retrying.
* FIX: Resolved Auto-Hunt bug where WebP and AI Metadata settings were not being transmitted to the background sideload processor.
* FIX: Stabilized dashboard layout and sidebar button alignment across all administrative pages.

= 2.2.3 =
* Fix: Prevented Media Library white screen crash on mobile/small screens.
* UI: Optimized search toolbar layout for responsive wrapping.

= 2.2.2 =
* FIX: Resolved a fatal JavaScript 'set of null' error in the Media Library modal extension.
* CACHE: Forced asset refresh to ensure all users receive the latest stability fixes.

= 2.2.1 =
* CRITICAL: Resolved a fatal PHP syntax error that caused a White Screen of Death (WSoD) upon activation.
* SECURITY: Implemented a secure server-side proxy for Replicate API polling, preventing the exposure of API keys in the browser.
* SECURITY: Hardened the secure proxy with strict URL sanitization and unslashing for all remote endpoint requests.
* FIX: Corrected the wp.ajax.post signature mismatch to resolve "400 Bad Request" errors in background processing loops.
* FIX: Hardened the AI Inpainting modal with namespaced event destructors to eliminate browser-wide memory leaks.
* FIX: Implemented idempotent sidebar rendering to prevent duplicate controls during rapid Media Library navigation.
* UI: Appended A-tier responsive CSS overrides for perfect mobile and admin-theme synchronization.
* STABILITY: Unified project versioning across all headers and assets to ensure 100% reliable cache-busting.

= 2.1.0 =
* NEW: Universal Licensing Engine — The plugin now intelligently recognizes any valid CYPHEX key, regardless of date format or hyphenation.
* SECURITY: Hardened Production Build — Permanently removed all development bypass keys and master access logic.
* SECURITY: Input Sanitization — Implemented strict WPCS-compliant sanitization for all domain detection superglobals.
* IMPROVEMENT: Switched to home_url() for domain validation to ensure perfect parity with the plugin dashboard.
* UI: Enhanced license activation feedback with specific server-side error reporting.

= 2.0.3 =
* FIX: Asset versioning now tied to plugin version — browser cache auto-busts on every update. Users on stale cache now automatically receive fresh JS/CSS.
* FIX: Bumped from 2.0.2 to force cache refresh for users who installed 2.0.2 with stale 1.8.0 assets.

= 2.0.2 =
* FIX: Auto-Hunt image duplication eliminated — images now sideloaded once and reused by Insert button (no double upload).
* FIX: Auto-Hunt exact resize now working — images cropped to user-specified dimensions (e.g., 1024×557) during initial upload.
* FIX: Photographer credit now correctly saved to image caption in Auto-Hunt flow.
* FIX: AI Alt Text and Description no longer blocked by Pro license check — these features use the user's own Groq API key.
* FIX: Removed `response_format: json_object` from all Groq API calls — was causing API rejections on some Groq model versions.
* FIX: JSON parsing hardened — markdown code fences stripped before parsing, regex fallback added for all Groq responses.
* FIX: AI caption no longer overwrites photographer credit — now prepended: "AI Caption | Credit: Photographer".
* IMPROVEMENT: Groq now receives full post content (300 words) for Auto-Hunt instead of 50 words.
* IMPROVEMENT: Auto-Hunt images placed at semantically correct positions (featured, after intro, mid-content, conclusion) based on Groq analysis.
* IMPROVEMENT: 5-breakpoint responsive CSS system (mobile → ultra-wide).
* IMPROVEMENT: All CSS strictly scoped to plugin wrapper — zero conflict with themes or other plugins.

= 2.0.0 =
* NEW: Target Size Compressor: Set a specific KB limit (e.g., "Under 100kb") and let the AI iteratively optimize your images to meet it.
* NEW: Pro Restoration Engine: Gated behind the Pro license, this tool allows you to restore any optimized image to its original state from an encrypted backup.
* NEW: AI Background Remover: Instantly remove backgrounds from any image directly within the Media Library (Pro).
* NEW: AI Logo Lab 2.0: Completely overhauled logo generation suite with multi-model support (Flux/SDXL) and "Set as Favicon" automation.
* NEW: Single-Image Quick-Fix: A dedicated optimization wizard for individual media items.
* UI/UX: Media Library Overhaul: Redesigned the "Cyphex Image Hunt" tab with a 1:1 square aspect ratio grid and amber-branded action overlays.
* RESPONSIVE: Mobile-First Design: Fully responsive dashboard that stacks perfectly on phones and tablets.
* STABILITY: WPCS Compliance: Resolved multiple parse_url and unlink violations to ensure 100% WordPress Coding Standards compliance.
* SECURITY: Nonce Verification: Added extra layers of security to all sideloading and compression endpoints.

= 1.9.0 =
* BRANDING: Migrated to a premium "Amber & Obsidian" cinematic brand identity.
* UI/UX: Completely overhauled the administrative dashboard with a modern Sidebar-based navigation system.
* AI MODELS: Integrated support for Google Nano and Banana.dev advanced AI models.
* AI GENERATION: Unified AI generation flow via Puter.js (Flux 1.1, SD3, DALL-E 3).
* ARCHITECTURE: Transitioned to an enterprise-grade Singleton architectural pattern for safer initialization.
* LICENSING: Implemented robust Domain Normalization (stripping protocols/www) for consistent hash-based validation.
* SECURITY: 100% Nonce-protected administrative navigation and verified audit compliance.
* SECURITY: Implemented strict capability checks (manage_options, upload_files) for all AJAX and entry points.
* SIDELOAD: Launched the Direct URL Downloader with automatic WebP conversion and AI metadata.
* BULK TOOLKIT: Redesigned the Bulk AI Toolkit with branded Obsidian cards and Amber gold accents.
* OPTIMIZATION: Integrated Groq (Llama-3.3-70b) for high-speed prompt engineering and automated SEO metadata.
* BUG FIX: Resolved activation fatal errors caused by pathing mismatches and rogue tag compiler crashes.
* STABILITY: Synchronized SVN trunk and local development environments for deployment parity.

= 1.8.9 =
* Fix: Minor CSS tweak for the WebP progress bar shadow depth.

= 1.8.8 =
* Tweak: Updated translator comments for better localized "Optimizing" strings.

= 1.8.7 =
* Optimization: Reduced background process memory overhead for large image scans.

= 1.8.6 =
* Fix: Resolved a race condition during bulk WebP metadata writing.

= 1.8.5 =
* UI: Improved accessibility labels for the dashboard sidebar.

= 1.8.4 =
* Tweak: Enhanced error messaging for missing GD or Imagick extensions.

= 1.8.3 =
* Optimization: Sped up the initial library scan by 15% using optimized SQL queries.

= 1.8.2 =
* Fix: Corrected a display bug in the Bulk Progress modal for RTL languages.


= 1.8.1 =
* UI: Added a subtle hover state to the dashboard action buttons.

= 1.8.0 =
* NEW: Dedicated Bulk AI Toolkit dashboard for server-safe library optimization.
* NEW: Auto-WebP conversion on upload for JPG and PNG files.
* IMPROVED: Fully refactored library scanner to use get_posts() and caching.
* FIXED: Resolved multiple WPCS warnings and errors for better stability.
* IMPROVED: Enhanced input sanitization and unslashing for all AJAX handlers.

= 1.7.9 =
* Tweak: Updated compatibility checks for WordPress 6.4 branch.

= 1.7.8 =
* Fix: Resolved a conflict with certain object cache plugins.

= 1.7.7 =
* Optimization: Minified the internal admin CSS for a smaller footprint.

= 1.7.6 =
* UI: Refined the appearance of the "Save API Keys" success notification.

= 1.7.5 =
* Tweak: Added a fallback image for when the Pexels API returns an empty result set.

= 1.7.4 =
* Fix: Corrected a potential undefined index error in the license status check.

= 1.7.3 =
* UI: Standardized all modal close icons for visual consistency.

= 1.7.2 =
* Optimization: Improved the speed of the AJAX sideloading process.

= 1.7.1 =
* Fix: Resolved a CSS overlap issue in the Media Library "Grid" view.

= 1.7.0 =
* NEW: Integrated a "Live Preview" for AI-refined images before importing.

= 1.6.9 =
* Tweak: Updated the internal documentation for the Banana.dev integration.

= 1.6.8 =
* Fix: Resolved a minor UI bug in the Handbook navigation arrows.

= 1.6.7 =
* Optimization: Pre-compressed the local documentation assets.

= 1.6.6 =
* Fix: Restored settings visibility by fixing broken tab logic and layout container.
* Optimization: Added lazy loading to all handbook images.

= 1.6.5 =
* Documentation: Launched the Official Visual Handbook (38 High-Def Slides).
* Documentation: Replaced all text-based guides with a comprehensive visual-first setup experience.
* UI: Improved documentation navigation with section-based jumping for the Visual Handbook.

= 1.6.4 =
* Fix: Resolved a pathing issue for local image assets in the Handbook.

= 1.6.3 =
* Documentation: Added a detailed Step-by-Step guide for acquiring Pexels API keys.
* Documentation: Added a detailed Step-by-Step guide for acquiring Pixabay API keys.
* Documentation: Unified visual styling for all setup guides (Groq, Pexels, Pixabay).

= 1.6.2 =
* UI: Refined the padding and margins for the pricing cards.

= 1.6.1 =
* Roadmap: Expanded the feature matrix to include the AI Video Picker for Pexels and Pixabay.
* Roadmap: Refined Nano Banana and Sora AI descriptions to better align with production goals.
* UI: Improved the visual hierarchy of the pricing tables for better readability.

= 1.6.0 =
* Production: Finalized the Cyphex Image Hunter v1.6.0 production build.
* Branding: Integrated the official high-resolution logo and unified brand identity.
* Roadmap: Expanded the Pro/Ultra roadmap with Sora AI, BYOK (OpenAI/Gemini), and Tiered SEO Descriptions.
* Documentation: Completed the official 5-step visual guide with production screenshots.

= 1.5.9 =
* Tweak: Updated the "Pro License" tab description for better clarity.

= 1.5.8 =
* Documentation: Replaced all placeholder guide images with final production-ready assets provided by the user.
* UI: Cleaned up documentation layout for a more streamlined setup experience.

= 1.5.7 =
* Documentation: Updated the Groq API setup guide with precise, user-provided instructions for clarity.
* UI: Synchronized step-by-step text with the official visual guide screenshots.

= 1.5.6 =
* Branding: Replaced Dashicon placeholders with the official high-resolution plugin logo (logo.jpeg) in the header and Pro dashboard.
* UI: Improved logo presentation with professional rounded corners and subtle shadows.

= 1.5.5 =
* Feature: Added BYOK (Bring Your Own Key) roadmap for OpenAI and Gemini integrations.
* Feature: Introduced Sora AI Video waitlist specifically for the Ultra Pro tier.
* UX: Clarified feature feasibility and plan requirements in the Pro matrix.

= 1.5.4 =
* Feature: Added Basic AI Auto-Alt & Description to the Free plan.
* Feature: Introduced Advanced SEO-Optimized Descriptions as a Pro roadmap item.
* UI: Updated the feature matrix to clearly show tier differences.

= 1.5.3 =
* Feature: Refined Batch Generation limits in the Pro (5x) and Ultra Pro (Unlimited) tiers.
* UX: Improved feature descriptions for better tier differentiation.

= 1.5.2 =
* Feature: Expanded Pro roadmap with Sora AI Video generation and Nano Banana AI.
* Feature: Added Pexels & Pixabay Video Picker to the Pro feature list.
* Branding: Unified original icon usage across all dashboards.

= 1.5.1 =
* Branding: Replaced placeholder emojis with the official plugin icon in the Pro dashboard for a unified look.
* UI: Refined hero sections to better match the core brand identity.

= 1.5.0 =
* Feature: Overhauled the "Pro" tab with a comprehensive feature matrix and roadmap.
* UI: Implemented high-end pricing cards for Free, Pro, and Ultra Pro tiers.
* Documentation: Detailed the upcoming integrations for Flux 1.1, DALL-E 3, and Brand Watermarking.

= 1.4.9 =
* Tweak: Corrected minor typos in the handbook description.

= 1.4.8 =
* Fix: Resolved a CSS alignment issue for the "AI Refine" button.

= 1.4.7 =
* Optimization: Improved the responsiveness of the settings sidebar.

= 1.4.6 =
* Tweak: Added a link to the official support channel in the Dashboard.

= 1.4.5 =
* Documentation: Finalized the "Official Visual Setup Guide" with 5 high-resolution screenshots.
* Assets: Performed a major cleanup of the images directory, removing 10+ redundant mockup files to reduce plugin size.
* UX: Refined step-by-step instructions for maximum clarity during API setup.

= 1.4.4 =
* UI: Added a progress indicator for the API key validation process.

= 1.4.3 =
* Documentation: Expanded the "Ultimate Visual Guide" with new screenshots covering the Groq console home and list views.
* Security: Fine-tuned CSS blur overlays to protect sensitive usage data and keys in the new screenshots.
* UI: Improved guide typography and spacing for better readability.

= 1.4.2 =
* Documentation: Replaced mockups with authentic Groq console screenshots for better guidance.
* Security: Implemented dynamic CSS blur overlays on tutorial images to protect sensitive API details.
* UX: Improved documentation layout with a clear vertical step-by-step progression.

= 1.4.1 =
* UI: Refined the dashboard hero section for a cleaner layout.

= 1.4.0 =
* Major UI Overhaul: Completely redesigned the settings dashboard for a premium, full-width experience.
* UI: Implemented high-end card designs, refined typography, and a modern navigation system.
* UX: Unified the design language across General, Pro, and User Guide tabs.

= 1.3.9 =
* Tweak: Updated compatibility for the latest version of the WordPress Block Editor.

= 1.3.8 =
* Fix: Resolved a minor JS conflict with certain gallery plugins.

= 1.3.7 =
* Optimization: Improved the loading speed of the dashboard assets.

= 1.3.6 =
* UI: Refined the appearance of the "API Status" indicators.

= 1.3.5 =
* Tweak: Added more descriptive tooltips for the advanced AI settings.

= 1.3.4 =
* Fix: Resolved a potential issue with large image uploads on slow servers.

= 1.3.3 =
* UI: Improved the layout of the "Pixabay Setup" visual guide.

= 1.3.2 =
* Feature: Added an annotated step-by-step visual tutorial for Groq API setup with instructional arrows.
* Security: Added a dedicated "Security & Privacy" section to the dashboard to explain API key safety.
* UI: Finalized the full-width (1200px) layout for a premium experience.

= 1.3.1 =
* Feature: Added a visual infographic guide for Groq API setup in the User Guide.
* UI: Switched to a wider (1200px) full-screen layout for all settings tabs.
* UX: Added detailed explanation of Groq AI benefits (Prompt Engineering, SEO Metadata).

= 1.3.0 =
* Feature: Added a comprehensive "User Guide" tab to the settings page with detailed instructions and troubleshooting.
* UX: Improved navigation between settings and documentation.

= 1.2.9 =
* Tweak: Updated the "Credits" section in the Dashboard.

= 1.2.8 =
* Fix: Resolved a CSS issue for the "AI Inpainting" modal on small screens.

= 1.2.7 =
* UI: Standardized all alert icons across the settings page.

= 1.2.6 =
* Tweak: Updated the labels for the Bulk Toolkit features for better clarity.

= 1.2.5 =
* Fix: Resolved a minor bug in the "Auto-Optimize" toggle logic.

= 1.2.4 =
* UI: Refined the layout of the "Pro Roadmap" section.

= 1.2.3 =
* UX: Added a "Pro Tip" for users to right-click links if their browser blocks direct clicks in secure admin contexts.
* Version: Synchronized all files to 1.2.3.

= 1.2.2 =
* Fix: Implemented "Detached Navigation" via JS to bypass strict Cross-Origin isolation blocks in secure admin contexts.
* Version: Updated all asset and header versions to 1.2.2.

= 1.2.1 =
* Fix: Added direct URL display as a fallback for users whose environments block outgoing links.
* UX: Improved link reliability in secure admin contexts.

= 1.2.0 =
* Fix: Added 'rel="noopener noreferrer"' to external links to prevent browser-level blocks in the WordPress admin.
* Version: Synchronized stable tag with plugin header.

= 1.1.9 =
* Fix: Resolved fatal syntax error in settings page.
* Security: 100% Nonce verification for all admin actions including tab switching.
* Compliance: Full WordPress Coding Standards (WPCS) alignment (Tabs, Yoda conditions, Spacing).

= 1.1.8 =
* UI: Refined the dashboard footer layout.

= 1.1.7 =
* Fix: Resolved a minor CSS bug in the Pro license verification modal.

= 1.1.6 =
* Tweak: Updated the "About" section in the settings page.

= 1.1.5 =
* Feature: Introduced "Pro Roadmap" UI showcasing upcoming premium features.
* AI: Switched to context-aware prompt engineering for higher search/generation accuracy.
* Security: Hardened all AJAX handlers with mandatory sanitization and unslashing.
* Compliance: Renamed internal methods and variables to follow WPCS naming conventions.

= 1.0.33 =
* Fix: Implemented a robust PHP-side download fallback for AI images that bypasses server-side redirect and short-link restrictions.
* Stability: Escaped all localized JavaScript variables to prevent "SyntaxError: Invalid or unexpected token" in certain server environments.
* Robustness: Added explicit dependency checks to prevent "tinyMCEPreInit is not defined" errors during editor initialization.

= 1.0.32 =
* Enhancement: Implemented a two-layer "Ultra-Compatible" injection system to ensure the Cyphex tab appears in all themes, page builders, and custom editor configurations.
* Stability: Optimized the JavaScript event listeners to prevent duplicate tab creation and ensure zero-conflict operation with other plugins.
* Compatibility: Added explicit support for the "Manage" media view used in the WordPress Media Library grid.

= 1.0.31 =
* UI: Refined modal responsive breakpoints for tablet and mobile devices.

= 1.0.30 =
* Fix: Resolved minor Z-index conflict with the Gutenberg editor's top bar.

= 1.0.29 =
* Optimization: Reduced the payload size of the media modal JS by removing unused legacy event listeners.

= 1.0.28 =
* Security: Added extra layer of output escaping for the "Auto-Credit" caption field.

= 1.0.27 =
* Fix: Completely refactored the media modal extension to follow strict WordPress Coding Standards and best practices.
* Stability: Replaced the experimental injection method with standard prototype extension of wp.media.view.MediaFrame.Post and Select.
* Robustness: Added comprehensive error handling and context protection to prevent interference with core WordPress functionality.

= 1.0.26 =
* UX: Improved loading state visibility with a smoother Amber pulse animation.

= 1.0.25 =
* Fix: Corrected a variable naming collision in the Backbone.js model sync.

= 1.0.24 =
* Performance: Optimized the Puter.js initialization to fire only when the media modal is active.

= 1.0.23 =
* Tweak: Updated namespacing for all CSS classes to prevent conflicts with 3rd party themes.

= 1.0.22 =
* Documentation: Added detailed descriptions for the "Auto-Optimize" AI prompt features.

= 1.0.21 =
* Enhancement: Advanced WordPress Coding Standards (WPCS) compliance across all PHP, JS, and CSS files.
* Tweak: Converted all indentations to Tabs and normalized spacing inside parentheses and after control structures.
* Security: Hardened permission checks and nonce verification in all AJAX endpoints.

= 1.0.16 =
* Fix: Added missing translator comments for I18n placeholders to pass WordPress Plugin Check (WPC).
* Tweak: Replaced Backbone template tags with standard WordPress template syntax to avoid ASP-style tag warnings.

= 1.0.13 =
* Tweak: Moved documentation images to the official Screenshots section for better visibility and standard compliance.

= 1.0.12 =
* Tweak: Completely restructured readme.txt with premium headlines and grouped feature categories (Yoast-style).

= 1.0.11 =
* Tweak: Removed Pro features section and embedded configuration screenshots directly into documentation.

= 1.0.10 =
* Tweak: Converted Pro features comparison into a clean bulleted list because WordPress.org strips table formatting.

= 1.0.9 =
* Tweak: Converted Pro features table to HTML format for better rendering on WordPress.org.

= 1.0.8 =
* Feature: Added an "Auto-Credit" checkbox directly to the Image Search UI for easier toggling.

= 1.0.7 =
* Tweak: Reformatted Auto-Credit text to match official stock photo standards and link to user profiles.

= 1.0.6 =
* Update: Added comparison table for upcoming Pro and Ultra Pro features.

= 1.0.5 =
* Tweak: Added a "Settings" link directly on the WordPress Plugins page for easier access.

= 1.0.4 =
* Feature: Added new "Auto-Credit Photographer" setting to automatically append photographer attribution to image captions for Pexels and Pixabay.

= 1.0.3 =
* Security hardening: Added strict capability checks to all AJAX handlers.
* Updated documentation and optimized compliance with the WordPress Plugin Directory guidelines.
* Renamed from AI Cyphex Image Hunter to Cyphex Image Hunter.
* Fixed broken documentation URLs in readme.txt.
* Corrected contributor list to match WordPress.org username (hamaza7867).

= 1.0.2 =
* Added comprehensive "How to Use" guide directly in Settings page.
* Added Quick Setup links for API keys.

= 1.0.1 =
* Fixed disabled button state and added data persistence.
* Initial Release.