
=== Album Mosaic ===

Contributors:      WordPress Telex
Tags:              block, albums, music, gallery, mosaic
Tested up to:      6.8
Stable tag:        0.1.0
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

A beautiful mosaic block for displaying your favorite albums of the month with adaptive grid layouts.

== Description ==

Album Mosaic is a dynamic WordPress block that lets you showcase your favorite albums in an elegant, adaptive mosaic layout. Perfect for music blogs, personal websites, or any site that wants to highlight album recommendations.

**Features:**

* Adaptive grid layout that automatically adjusts based on the number of albums
* Automatic album artwork fetching from Apple Music/iTunes catalog
* Reliable, high-quality cover images from trusted music services
* Clean, modern design that works beautifully with 5-10 albums
* Easy-to-use interface for adding album titles, artists, and cover art
* Responsive design that looks great on all devices
* Hover effects for enhanced interactivity
* Optimized performance with efficient rendering

The block intelligently arranges your album covers in a visually appealing mosaic pattern, ensuring your music collection always looks its best. Simply add your albums through the block's intuitive interface, click "Find Cover from Apple Music" to automatically fetch high-quality artwork, and watch as the layout adapts automatically.

**Artwork Source:**

All album artwork is automatically sourced from Apple Music/iTunes, ensuring reliable, high-quality images that won't change or break over time. The block uses Apple's official API to search for and retrieve album covers at 600x600 resolution.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/album-mosaic` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Add the "Album Mosaic" block to any post or page
4. Start adding your favorite albums!

== Frequently Asked Questions ==

= How many albums can I add? =

The block is optimized for 5-10 albums, which provides the best visual balance. However, you can add more or fewer albums as needed, and the layout will adapt accordingly.

= Where do the album cover images come from? =

All album artwork is automatically fetched from Apple Music/iTunes using their official API. This ensures you get high-quality, reliable images that won't disappear or change. Simply enter the album title and artist name, then click "Find Cover from Apple Music" to automatically retrieve the artwork.

= Can I use my own image URLs? =

Yes! While the block automatically fetches artwork from Apple Music, you can also manually enter any image URL if you prefer to use a different source or if an album isn't found in Apple's catalog.

= What if an album isn't found? =

If the automatic search doesn't find your album, you can manually enter the cover image URL. We recommend using reliable sources like music streaming services or your WordPress media library.

= Can I customize the layout? =

The layout automatically adapts based on the number of albums. The block uses intelligent CSS Grid layouts to create the most visually appealing arrangement.

= Is the block responsive? =

Yes! The Album Mosaic block is fully responsive and will look great on desktop, tablet, and mobile devices.

== Screenshots ==

1. Album Mosaic block in the editor with sample albums
2. Front-end display showing the adaptive grid layout
3. Block settings and automatic cover fetching from Apple Music
4. Inspector panel with album management controls

== Changelog ==

= 0.1.0 =
* Initial release
* Adaptive mosaic grid layout
* Automatic album cover fetching from Apple Music/iTunes
* Support for multiple albums
* Hover effects and smooth transitions
* Responsive design
* High-quality 600x600 artwork resolution

== Usage ==

1. Add the Album Mosaic block to your post or page
2. Click "Add Album" to create a new album entry
3. Enter the album title and artist name
4. Click "Find Cover from Apple Music" to automatically fetch the artwork
5. Repeat for all your favorite albums
6. The layout will automatically adapt to showcase your collection beautifully

The block provides an intuitive editing experience in the WordPress block editor, with easy controls for adding, removing, and reordering albums. Album artwork is sourced directly from Apple Music/iTunes, ensuring reliable and high-quality images.
