=== OneClickContent - Image Detail Generator === Contributors: jwilson529 Tags: images, seo, alt-text, openai, gemini Requires at least: 5.0 Tested up to: 6.8 Requires PHP: 7.2 Stable tag: 1.2.2 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Free AI-powered image metadata generation for existing Media Library images using your own OpenAI or Gemini API key. == Description == **OneClickContent - Image Detail Generator** is a free, bring-your-own-key plugin for enhancing existing WordPress images with AI-generated metadata. Use your own **OpenAI** or **Gemini** API key to generate: - alt text - image titles - captions - descriptions This plugin is focused on metadata generation for images already in your Media Library. It does not create images. **Key Benefits:** - Improve SEO for image search and content relevance - Improve accessibility with descriptive alt text - Save time on repetitive metadata writing - Use your own provider account and models - Bulk-generate metadata across your library - Control which fields get updated == Features == - Bring-your-own-key support for OpenAI and Gemini - Single-image generation inside the Media Library - Bulk generation for existing image attachments - Auto-generate on upload - Multilingual output based on plugin settings - Manual editing after generation - Forward-compatible OpenAI model filtering for GPT-5.5 API model IDs when OpenAI exposes them to API accounts == External Services == This plugin connects directly to the AI provider you configure. = OpenAI = - Endpoint: `https://api.openai.com/v1/chat/completions` - Data sent: image data and generation instructions needed to return image metadata - Purpose: generate title, description, alt text, and caption - Terms: https://openai.com/policies/terms-of-use/ - Privacy: https://openai.com/policies/privacy-policy/ = Gemini = - Endpoint: `https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent` - Data sent: image data and generation instructions needed to return image metadata - Purpose: generate title, description, alt text, and caption - Terms: https://ai.google.dev/terms - Privacy: https://policies.google.com/privacy == Third-party Libraries == - **DataTables (with Buttons and HTML5 Export)**: (v2.2.2, Buttons v3.2.2) used for table display and export functionality. Sources: - [DataTables GitHub](https://github.com/DataTables/DataTablesSrc/releases/tag/2.2.2) - [Buttons GitHub](https://github.com/DataTables/Buttons/releases/tag/3.2.2) == Source Code == Full source code, including unminified JavaScript files, is available at the [GitHub Repository](https://github.com/jwilson529/oneclickcontent-images). == Installation == 1. **Upload the Plugin:** - Upload the `occidg` folder to the `/wp-content/plugins/` directory. 2. **Activate the Plugin:** - Activate through the Plugins menu in WordPress. 3. **Configure Your Settings:** - Go to **Image Metadata** in your WordPress admin menu. - Choose **OpenAI** or **Gemini** as your provider. - Enter your API key. - Choose your preferred model. - Choose your preferred language. - Optionally enable automatic generation on upload. 4. **Generate Image Details:** - Visit your **Media Library**. - Select any image and click **Generate Metadata**, or use the Bulk Edit tab to process multiple images at once. == Frequently Asked Questions == = Does this plugin create images? = No. It generates metadata for images that already exist in the Media Library. = Do I need my own API key? = Yes. This is a bring-your-own-key plugin. Add your OpenAI or Gemini API key in the plugin settings. = Which AI providers are supported? = OpenAI and Gemini. = Does this support GPT-5.5? = The OpenAI model dropdown is populated from the models returned for your API key. OCCIDG accepts GPT-5.5-compatible model IDs and will list them when they are available through the OpenAI API. = Which fields can it generate? = The plugin can generate titles, alt text, captions, and descriptions. = Can I choose which fields to generate? = Yes. Use the metadata field settings and override controls in the admin screen. = Does it work with WooCommerce product images? = Yes. It works with image attachments in the WordPress Media Library, including WooCommerce product images stored there. = What happens if I enable automatic generation on upload? = Newly uploaded images will trigger metadata generation according to your configured settings. = What languages are supported? = The plugin supports the language options currently provided in the admin settings. == Screenshots == 1. **Settings Screen:** Configure provider, API key, model, language, and auto-generate settings. 2. **Media Library Integration:** Generate metadata directly from the WordPress Media Library. 3. **Bulk Edit Mode:** Bulk generate metadata across multiple images. 4. **Generated Image Details:** Preview and edit AI-generated titles, captions, alt texts, and descriptions. == Upgrade Notice == = 1.2.2 = This release trims the WordPress.org plugin tags to the supported five-tag limit. = 1.2.1 = This release adds forward-compatible OpenAI model filtering for GPT-5.5 API model IDs and tightens release packaging automation. = 1.2.0 = This release repositions the plugin as a free, bring-your-own-key AI metadata generator for the Media Library with OpenAI and Gemini support. == Changelog == = 1.2.2 = * Limited WordPress.org readme tags to five canonical tags to satisfy plugin directory import rules. = 1.2.1 = * Added explicit GPT-5.5-compatible OpenAI model ID coverage for the API model dropdown. * Improved metadata field selector layout on the settings screen. * Fixed the GitHub Actions deploy packaging step for the WordPress.org release workflow. = 1.2.0 = * Re-released the plugin as a free, bring-your-own-key AI image metadata solution. * Centered the user experience on OpenAI and Gemini provider settings. * Removed public-facing migration and handoff notes from the plugin readme. * Cleaned up release packaging so the distributable zip stays focused on runtime files. = 1.1.15 = * Update to media library API calls = 1.1.13 = * Plugin description, FAQs, and marketing language improved. * Minor settings screen layout enhancements. * Preparation for upcoming new language expansions. = 1.1.11 = * Vendor DataTables assets restored. * Asset loading issues corrected. = 1.1.10 = * Security enhancements, WPCS compliance updates. * Improved nonce verification and asset handling. = 1.1.8 = * Improved settings management and bulk edit handling. * Better transient management for update checking. = 1.1.7 = * Fixed nonce issue in get_thumbnail AJAX call. = 1.1.6 = * Redirects to settings screen on first activation. = 1.1.5 = * Update system fixes and performance improvements. = 1.1.1 = * Multilingual generation support added. * Data transparency improvements. = 1.1.0 = * Auto-generation of metadata on image upload. = 1.0.0 = * Initial plugin release.