=== BloomImages ===

Contributors: moonwalkseo
Tags: images, seo, ai, metadata, automation
Requires at least: 5.3
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered WordPress plugin that automatically generates ALT text and image metadata to improve SEO and accessibility.

== Description ==

BloomImages is an advanced WordPress plugin that uses artificial intelligence to automate the management of image metadata. It significantly improves accessibility and SEO by automatically generating ALT text, titles, and descriptions for your images.

= Key Features =

* **Automatic metadata generation**: Create ALT text, titles, and descriptions using AI
* **Multiple templates**: Descriptive, E-commerce, and Creative/Storytelling
* **Bulk processing**: Process multiple images simultaneously
* **Smart automation**: Automatically process images upon upload
* **Advanced filters**: Filter by dimensions, formats, and file types
* **Intuitive interface**: Dashboard with statistics and activity history
* **Credit validation**: Prevents processing when insufficient credits are available
* **Translations**: Available in Spanish and English
* **Gutenberg compatible**: Fully compatible with the block editor

= SEO Benefits =

* Improves accessibility by following WCAG recommendations for alternative text
* Enhances on-page SEO with relevant metadata
* Supports faster image indexation
* Improves user experience for visually impaired users
* Follows SEO best practices for image optimization

= Use Cases =

* **Personal blogs**: Generate creative descriptions for travel and lifestyle images
* **E-commerce**: Create conversion-oriented metadata for product images
* **Corporate websites**: Maintain consistency across image libraries
* **Portfolios**: Automatically optimize project images
* **Media websites**: Speed up content publishing workflows

= Available Templates =

* **Descriptive**: Neutral and informative metadata
* **E-commerce**: Conversion-focused for product listings
* **Creative/Storytelling**: Narrative style for blogs and lifestyle content

= System Requirements =

* WordPress 5.0 or higher
* PHP 7.4 or higher
* Internet connection for AI processing
* Valid API key and available credits in your BloomImages account

== Installation ==

1. Upload the plugin to the `/wp-content/plugins/bloomimages/` directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Go to **BloomImages > Settings** in the admin panel
4. Enter your API key for the BloomImages service
5. Start optimizing your images automatically

= Initial Setup =

1. **Get an API key**: Register on the BloomImages website
2. **Configure the key**: Paste it into the plugin settings
3. **Test the connection**: Ensure everything works correctly
4. **Set up automation**: Define rules for automatic processing

== Frequently Asked Questions ==

= What is BloomImages? =

BloomImages is a WordPress plugin that uses artificial intelligence to automatically generate SEO metadata (ALT text, titles, and descriptions) for your website images.

= How does the credit system work? =

BloomImages uses a credit-based system linked to your account. Each processed image consumes 1 credit.

= What templates are available? =

* **Descriptive**: Neutral and informative metadata
* **E-commerce**: Conversion-oriented for products
* **Creative/Storytelling**: Narrative style for blogs and lifestyle content

= Can I process images in bulk? =

Yes, BloomImages allows you to process up to 30 images simultaneously. The plugin automatically validates that you have sufficient credits before processing.

= Does it support automation? =

Yes, you can configure the plugin to automatically process images upon upload, using filters based on dimensions, formats, and file types.

= Is it compatible with Gutenberg? =

Yes, BloomImages is fully compatible with the WordPress block editor and works with any theme.

= Which image formats are supported? =

It supports standard formats including JPG, JPEG, PNG, WebP, GIF, BMP, and TIFF. You can also configure it to process additional file types if needed.

= How are credits calculated? =

Each processed image consumes 1 credit. The plugin automatically checks that you have enough credits before processing.

= Can I edit the generated metadata? =

Yes, all generated metadata is saved as proposals that you can review, edit, and manually apply from the admin panel.

= Are there processing limits? =

The plugin allows bulk processing of up to 30 images per batch. There is no global limit on the number of processed images, as long as you have sufficient credits available in your account.

== Screenshots ==

1. Main dashboard with usage statistics and available credits
2. Image review interface with generated metadata proposals
3. Automation settings with advanced filters
4. Automation preview view
5. Detailed image processing history
6. Settings panel with connection test
7. WordPress media library with the new Bloom resize column

== Changelog ==

= 1.1.0 – 2026-07-19 =
* New: image metadata is now generated in the background on upload — images are queued and processed by WP-Cron in batches, so bulk uploads no longer block the upload or hit request limits. Metadata appears shortly after upload instead of instantly.
* Compatibility: minimum required PHP is now 8.0.
* New: BloomImages now lives under a shared top-level "Bloom" menu (Bloom → General Panel) to prepare the Bloom plugin suite. Your existing API key is preserved.
* New: the API key now lives on a shared "Bloom → Settings" screen (General tab) with a Save & test connection action, ready to be reused by other Bloom plugins.
* New: a language note showing which language metadata will be generated in (based on your site language), on the Settings and Review screens.
* New: onboarding banner inviting you to create a free account and get 5 credits.
* New: keywords returned by the AI are now captured and shown in the review screen.
* New (optional, off by default): rename the physical image file to an SEO-friendly name on auto-apply. High-risk — see the warning in automation settings.
* Security: API requests now verify TLS certificates (sslverify enabled).
* Privacy: expanded and clarified the privacy policy.

= 1.0.2 – 2026-04-09 =
* Security: added explicit output escaping via wp_kses() to media library resize control
* Security: removed unused AJAX handler to reduce attack surface
* Fixed: wpdb::prepare() notice caused by passing non-SQL arrays to cached query helper
* Fixed: automation error messages sanitized before display in stats panel
* Fixed: remaining hardcoded Spanish strings replaced with i18n functions
* Fixed: locale bug in proposal validation and AJAX handlers

= 1.0.1 – 2026-03-10 =
* Replaced load_plugin_textdomain() with standard WordPress i18n functions
* Extracted all inline script and style blocks into external enqueued files
* Dynamic PHP data now passed to JS via wp_add_inline_script()
* Admin notices scoped to BloomImages pages only and marked dismissible
* Input sanitization and output escaping across AJAX handlers and view files
* Nonce verification added to all unprotected handlers
* Capability checks added to all AJAX actions

= 1.0.0 – 2026-02-15 =
* Initial release
* AI-powered automatic metadata generation
* Three templates: Descriptive, E-commerce, and Creative/Storytelling
* Bulk processing (up to 30 images)
* Smart automation with filters
* Dashboard with statistics and history
* Credit validation system
* Compatible with WordPress 5.0+ and PHP 7.4+

== Upgrade Notice ==

= 1.1.0 =
The admin menu moves under a new top-level "Bloom" menu (BloomImages is now Bloom → General Panel) and the API key moves to a shared "Bloom → Settings" screen. Your existing API key is preserved — no reconfiguration needed.

= 1.0.2 =
Security and stability fixes following WordPress.org review. Recommended update for all users.

= 1.0.0 =
Initial release of BloomImages including AI-powered metadata generation, automation features, and dashboard management.

== Privacy Policy ==

BloomImages sends only the public URL of each image (and
optional contextual fields like title and keywords) from
your WordPress site to our backend API and a third-party
AI service for SEO metadata generation. The image files
themselves are not uploaded — they are fetched from your
public URL, just as any crawler would access them.

The plugin does not collect or transmit data about your
site's visitors, does not install cookies, and does not
add any visitor-facing scripts.

Generated metadata proposals are cached in our backend for
30 days to avoid duplicate processing of the same image.
We do not store the images. We do not sell, share or
repurpose any data.

For more information, please visit: https://www.bloomimg.com/politica-privacidad/

== Support ==

For technical support, bug reports, or feature requests, please visit our website or contact us through our support channels.

== Donate ==

If BloomImages has been helpful to you, consider supporting its development.

== Credits ==

Developed with ❤️ for the WordPress community. BloomImages leverages artificial intelligence to enhance accessibility and SEO for websites.
