=== MediaSpark - Media Library Organizer ===
Contributors: aacers
Tags: media folders, media tags, auto alt text, media analytics, bulk media editor
Requires at least: 6.0
Tested up to: 6.8.2
Stable tag: 1.6.2
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Best free WordPress media organizer: unlimited folders/tags, auto alt text, bulk edit (50 items), SEO analytics. Pro for unlimited features.
== Description ==
MediaSpark is the ultimate free WordPress media library organizer plugin, designed for bloggers, eCommerce sites, and SEO professionals. With unlimited hierarchical folders, media tags, auto alt text and tags, bulk editing in list mode (up to 50 items), SEO analytics for used/unused items, duplicates, alt text, and folder usage, plus folder/tag search, CSV export, and basic drag-and-drop, MediaSpark streamlines media management. Built for WordPress 6.0+, it's lightweight, secure, and compatible with Elementor, Divi, Beaver Builder, and WooCommerce.
Key Free Features

Unlimited Media Folders: Organize attachments with hierarchical virtual folders – no file URL changes, no limits.
Media Tags: Add non-hierarchical tags for quick searching and filtering.
Auto Alt Text & Tags: Generate alt text and tags from file titles (first two words) on upload – boosts SEO.
Bulk Editing in List Mode: Edit tags, alt text, and folders for up to 50 items (switch to list view; unlimited + grid in Pro).
SEO Analytics: Detect used/unused items, items without alt text, potential duplicates, and folder usage stats.
Count Column: View and sort counts in the folders/tags admin screen, with clickable links to filtered media.
Folder/Tag Search Dropdown: Quickly filter media by folder or tag in the media library.
CSV Export: Export up to 50 unused items as CSV (Pro for unlimited).
Basic Drag-and-Drop: Limited drag-and-drop for assigning items to folders (Pro for unlimited).
Image Compression Preview: Preview compression effects (one image per session in free).
Multilingual Support: Translated into English, Spanish, French, German, Italian, and Japanese. Contribute via translate.wordpress.org.
Lightweight & Secure: Optimized code ensures fast performance for large media libraries.

Why Choose MediaSpark?

Unmatched Free Features: Unlimited folders, 50-item bulk editing, folder/tag search, counts, CSV export, and basic drag-and-drop for superior organization.
SEO Powerhouse: Analytics for alt text, duplicates, and folder usage to enhance site performance.
User-Friendly: Intuitive folder dropdown, search filters, sortable counts, and basic drag-and-drop.
Performance: Cached analytics and counts for minimal database load.
Pro Upsell: Upgrade to MediaSpark Pro for advanced features like unlimited bulk editing, AI-powered alt text/tags, unlimited drag-and-drop, grid mode bulk, duplicate deletion, watermarking, WooCommerce integration, and unlimited CSV exports.

MediaSpark is the go-to WordPress media library organizer for bloggers, agencies, and eCommerce stores. Simplify and optimize your media management today!
Upgrade to MediaSpark Pro
Unlock advanced features with MediaSpark Pro:

Unlimited bulk editing in list/grid modes
AI-powered tag and alt text generation
Unlimited drag-and-drop folder management
Automatic watermarking
Bulk image compression and resizing
WooCommerce auto-tagging
Lazy loading and CDN integration
Unlimited CSV exports and duplicate deletion

== Installation ==

Upload the mediaspark folder to /wp-content/plugins/.
Activate the plugin via the Plugins menu.
Configure options in Media > MediaSpark > Settings.
View analytics in Media > MediaSpark > Analytics.
Use bulk actions in the media library (list mode recommended).

== Frequently Asked Questions ==
= Does MediaSpark create physical folders? =
No, it uses virtual taxonomies for efficient organization without altering file URLs, ensuring compatibility and performance.
= How are used/unused items detected? =
Used items are attached to posts/pages (post_parent != 0). Unused are unattached. Pro offers advanced detection, including shortcode and widget scans.
= How does duplicate detection work? =
The free version identifies potential duplicates based on file paths. MediaSpark Pro allows deleting duplicates to save space.
= Where can I use bulk editing? =
Bulk editing (tags, alt text, folders) is available in list mode up to 50 items. Upgrade to Pro for grid mode support and unlimited items.
= Can I see how many items are in each folder/tag? =
Yes, the folders/tags admin screen includes a sortable "Count" column. Click the count to view items in that folder/tag.
= Can I bulk edit more than 50 items? =
The free version supports up to 50 items in list mode. Upgrade to Pro for unlimited bulk editing.
= Can I filter media by folder or tag? =
Yes, use the folder/tag dropdown filters in the media library to quickly view specific categories.
= Can I export unused items? =
Yes, export up to 50 unused items as CSV from the analytics tab. Pro offers unlimited exports.
= How does drag-and-drop work? =
In free, drag items to folders (limited to 5/session). Pro offers unlimited drag-and-drop.
= Is MediaSpark translatable? =
Yes, fully translated into English, Spanish, French, German, Italian, and Japanese. Contribute translations via translate.wordpress.org.
= Does it work with page builders? =
Yes, compatible with Elementor, Divi, Beaver Builder, and other major page builders.
== Screenshots ==

Hierarchical Folders: Organize your media library with unlimited folders and subfolders.
Count Column: View and sort counts in the folders/tags admin screen, with clickable links to filtered media.
SEO Analytics Dashboard: View used/unused items, items without alt text, duplicates, and folder usage stats.
Bulk Editing in List Mode: Apply tags, alt text, or folders to up to 50 items (switch to list view).
Folder/Tag Search & CSV Export: Filter media by folder/tag and export unused items as CSV.

== Changelog ==
= 1.6.1 =

Fixed title of MediaSpark.

= 1.6.1 =

Fixed bulk editing in list mode: Input fields for tags, alt text, folders now appear correctly after selecting actions.
Fixed single "Count" column for folders/tags with accurate attachment counts, updated on changes.
Fixed MediaSpark menu tabs to load without errors, with premium white background and purple accents.
Added transient invalidation on bulk actions and term changes for real-time count updates.
Improved JS polling for reliable bulk action and tab functionality.

= 1.6.0 =

Added free vs pro comparison table in Pro Comparison tab with upgrade button.
Enhanced MediaSpark menu with tabs (Settings, Analytics, Pro Comparison) and premium styling.
Moved settings and analytics to Media > MediaSpark with tabs.
Added folder/tag search dropdown in media library.
Added unused items CSV export (up to 50, Pro for unlimited).

= 1.5.4 =

Simplified bulk editing to list mode only for reliability (Pro adds grid mode).
Updated Pro teases to highlight grid bulk and drag-drop.
Enhanced settings/analytics prompts for better upsell flow.

= 1.5.3 =

Updated readme: Limited to 5 tags, 150-character short description.
Optimized readme with SEO keywords for better WordPress.org visibility.

= 1.5.2 =

Added count column to folders admin screen (sortable, clickable to filter media).
Added bulk editing support in grid mode (tags, alt text, folders up to 50 items).
Added folder usage stats to analytics page with clickable counts.
Optimized counts with transients for performance.

= 1.5.1 =

Added unlimited folders and tags in free version.
Increased bulk editing limit to 50 items (from 5).
Added SEO analytics: Items without alt text count and filter.
Added duplicate detection (Pro for deletion).
Added folder dropdown for bulk actions.
Implemented auto alt text/tags and compression preview on upload.

= 1.4.8 =

Added translations for Spanish, French, German, Italian, and Japanese.
Fixed translators comments for placeholder strings.

== Upgrade Notice ==
Upgrade to 1.6.1 for fixed bulk editing, accurate counts, tabbed menu with premium styling, folder/tag search, and CSV export. Get MediaSpark Pro for unlimited drag-drop, grid bulk, and more!