Title: Acidboxblues Visual Grid for Bandcamp
Author: thisisnotlondon
Published: <strong>ژانویه 29, 2026</strong>
Last modified: ژانویه 29, 2026

---

Search plugins

![](https://ps.w.org/acidboxblues-visual-grid-for-bandcamp/assets/icon-256x256.png?
rev=3449167)

# Acidboxblues Visual Grid for Bandcamp

 By [thisisnotlondon](https://profiles.wordpress.org/thisisnotlondon/)

[Download](https://downloads.wordpress.org/plugin/acidboxblues-visual-grid-for-bandcamp.1.3.8.zip)

 * [Details](https://haz.wordpress.org/plugins/acidboxblues-visual-grid-for-bandcamp/#description)
 * [Reviews](https://haz.wordpress.org/plugins/acidboxblues-visual-grid-for-bandcamp/#reviews)
 *  [Installation](https://haz.wordpress.org/plugins/acidboxblues-visual-grid-for-bandcamp/#installation)
 * [Development](https://haz.wordpress.org/plugins/acidboxblues-visual-grid-for-bandcamp/#developers)

 [Support](https://wordpress.org/support/plugin/acidboxblues-visual-grid-for-bandcamp/)

## Description

Acidboxblues Visual Grid for Bandcamp is a WordPress plugin that allows you to display
your Bandcamp discography in a responsive grid layout. Suitable for musicians, labels,
and music blogs who want to showcase their Bandcamp releases on their WordPress 
site.

#### Features

 * Responsive grid layout that adjusts to any screen size
 * Customisable columns between 1 and 6 (default: 2)
 * Automatic data fetching retrieves album titles, artwork, and release dates from
   Bandcamp
 * Caches album data for faster page loads
 * Sort albums by release date or title, ascending or descending
 * Simple shortcode implementation
 * Cache updates automatically twice daily
 * **New:** Real-time visual progress bar and status updates when manually refreshing
   the cache
 * Built with WordPress security best practices and data validation

#### How It Works

 1. Add your Bandcamp album URLs to the plugin settings (one per line)
 2. The plugin fetches album information (title, artwork, release date) from each URL
 3. Data is cached for performance
 4. Display your albums anywhere using the [acidvigr_visual_grid] shortcode
 5. Cache updates automatically twice daily to keep your discography current

#### Suitable For

 * Musicians displaying their discography
 * Record labels displaying their catalogue
 * Music blogs featuring artist collections
 * Music review sites
 * Bandcamp Friday promotions

## Installation

#### Automatic Installation

 1. Log in to your WordPress admin panel
 2. Go to Plugins  Add New
 3. Search for “Acidboxblues Visual Grid for Bandcamp”
 4. Click “Install Now” and then “Activate”

#### Manual Installation

 1. Download the plugin zip file
 2. Log in to your WordPress admin panel
 3. Go to Plugins  Add New  Upload Plugin
 4. Choose the zip file and click “Install Now”
 5. Click “Activate Plugin”

#### After Installation

 1. Go to Settings  Acidboxblues Visual Grid
 2. Add your Bandcamp album URLs (one per line)
 3. Adjust number of columns if desired
 4. Click “Save Settings”
 5. Click “Update Cache Now” to fetch your album data
 6. Add the shortcode [acidvigr_visual_grid] to any page or post

## FAQ

### How do I add the grid to my page?

Add the shortcode [acidvigr_visual_grid] to any page, post, or widget that supports
shortcodes.

### What URLs should I use?

Use the full HTTPS URL of any Bandcamp album or track page, for example: https://
artist.bandcamp.com/album/album-name or https://artist.bandcamp.com/track/track-
name

### Can I customise the grid layout?

Yes. In Settings  Acidboxblues Visual Grid you can:

 * Set the number of columns (1-6)
 * The grid is automatically responsive on mobile devices

### How do I sort the albums?

Use these shortcode variations:

 * [acidvigr_visual_grid] – Default (newest first)
 * [acidvigr_visual_grid sort=”date” order=”desc”] – Newest first
 * [acidvigr_visual_grid sort=”date” order=”asc”] – Oldest first
 * [acidvigr_visual_grid sort=”title” order=”asc”] – A-Z by title
 * [acidvigr_visual_grid sort=”title” order=”desc”] – Z-A by title

### How often does the cache update?

The cache updates automatically twice daily. You can also manually update it anytime
from Settings  Acidboxblues Visual Grid by clicking “Update Cache Now”.

### Why isn’t my new release showing up?

If you’ve just added a new album to Bandcamp:

 1. Add the URL to your settings
 2. Click “Save Settings”
 3. Click “Update Cache Now”
 4. The album should appear immediately.

### Can I use albums from different Bandcamp artists?

Yes. You can mix albums from any Bandcamp artist or label. Just add all the URLs
to your list.

### Will this slow down my site?

No. The plugin caches all album data locally, so your pages load quickly. Album 
information is only fetched from Bandcamp during cache updates (twice daily or when
manually triggered).

### Does this work with Bandcamp labels?

Yes. You can add any Bandcamp URL, whether it’s from an individual artist or a label
page.

### What if a URL is invalid?

The plugin validates all URLs and only saves valid HTTPS Bandcamp URLs. Invalid 
URLs are automatically filtered out when you save settings.

### Can I display multiple grids on one page?

Yes. You can use multiple [acidvigr_visual_grid] shortcodes on the same page, each
with different sorting options.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Acidboxblues Visual Grid for Bandcamp” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ thisisnotlondon ](https://profiles.wordpress.org/thisisnotlondon/)

[Translate “Acidboxblues Visual Grid for Bandcamp” into your language.](https://translate.wordpress.org/projects/wp-plugins/acidboxblues-visual-grid-for-bandcamp)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/acidboxblues-visual-grid-for-bandcamp/),
check out the [SVN repository](https://plugins.svn.wordpress.org/acidboxblues-visual-grid-for-bandcamp/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/acidboxblues-visual-grid-for-bandcamp/)
by [RSS](https://plugins.trac.wordpress.org/log/acidboxblues-visual-grid-for-bandcamp/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.3.8

 * Feature: Added a visual progress bar and real-time status text to the settings
   page when updating the cache manually.
 * Improvement: Switched manual cache updates to a JavaScript-based batch process.
   This prevents PHP timeouts when processing large lists of URLs.
 * Improvement: Better error handling during the scraping process; individual URL
   failures no longer stop the entire batch.

#### 1.3.7

 * Security: Implemented “late escaping” for inline CSS generation using `absint()`
   to prevent injection.
 * Security: Enhanced input sanitization for settings using `wp_unslash` and strict
   field sanitization.
 * Security: Hardened settings saving process by using specific input allowlists.

#### 1.3.6

 * Refactor: Implemented PHP Namespaces (`thisisnotlondon\bandcampalbumgrid`) to
   prevent code collisions.
 * Refactor: Standardized all internal prefixes to `acidvigr_` (Classes, constants,
   options, and actions).
 * Change: Shortcode updated to `[acidvigr_visual_grid]`.
 * Performance: Separated CSS and JS into dedicated asset files.
 * Performance: Implemented `wp_add_inline_style` for dynamic column handling.
 * Performance: Implemented `wp_localize_script` for secure Admin JS variable handling.

#### 1.3.5

 * Renamed plugin to Acidboxblues Visual Grid for Bandcamp
 * Removed: Thumbnail size setting to simplify layout and prevent CSS conflicts
 * Changed: Images now automatically fill 100% of the column width
 * Improved: CSS handling for square aspect ratios

#### 1.3.4

 * Fixed: Critical error on activation by ensuring WordPress is fully loaded before
   initialisation
 * Improved: Added check for DOMDocument extension to prevent crashes on unsupported
   servers

#### 1.3.3

 * Fixed: CSS specificity issue where some themes would override the thumbnail size
   setting
 * Improved: Added important flag to width styles to ensure user settings take precedence

#### 1.3.2

 * Fixed: Grid “blowout” issue where large album covers would expand columns unexpectedly
 * Improved: CSS Grid definition using minmax to handle intrinsic image sizes

#### 1.3.1

 * Changed: Thumbnail size setting now uses percentages (%) instead of pixels (px)
   for responsiveness
 * Improved: Added aspect-ratio CSS to ensure thumbnails remain square
 * Improved: Images smaller than column width are now automatically centred

#### 1.3.0

 * Improved: Replaced Regex with DOMDocument for more reliable data fetching
 * Improved: Cache security (hashed filenames and directory protection)
 * Improved: Handling of line endings in settings
 * Improved: Hidden admin error messages from public view
 * Updated: Requires PHP 7.4+

#### 1.2.0

 * Added customisable column count setting
 * Added adjustable thumbnail size
 * Improved settings panel UI
 * Enhanced security with proper escaping
 * Added translation support
 * Simplified default URL list
 * Fixed WordPress coding standards compliance
 * Performance improvements

#### 1.0.0

 * Initial release

## Meta

 *  Version **1.3.8**
 *  Last updated **9 ماه ago**
 *  Active installations **10+**
 *  WordPress version ** 5.4 or higher **
 *  Tested up to **6.9.10**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/acidboxblues-visual-grid-for-bandcamp/)
 * Tags
 * [albums](https://haz.wordpress.org/plugins/tags/albums/)[Bandcamp](https://haz.wordpress.org/plugins/tags/bandcamp/)
   [discography](https://haz.wordpress.org/plugins/tags/discography/)[grid](https://haz.wordpress.org/plugins/tags/grid/)
   [music](https://haz.wordpress.org/plugins/tags/music/)
 *  [Advanced View](https://haz.wordpress.org/plugins/acidboxblues-visual-grid-for-bandcamp/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/acidboxblues-visual-grid-for-bandcamp/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/acidboxblues-visual-grid-for-bandcamp/reviews/)

## Contributors

 *   [ thisisnotlondon ](https://profiles.wordpress.org/thisisnotlondon/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/acidboxblues-visual-grid-for-bandcamp/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://paypal.me/fundmydigitakt)