{"id":275223,"date":"2026-01-29T02:10:31","date_gmt":"2026-01-29T02:10:31","guid":{"rendered":"https:\/\/en-au.wordpress.org\/plugins\/bandcamp-album-grid\/"},"modified":"2026-01-29T02:25:20","modified_gmt":"2026-01-29T02:25:20","slug":"acidboxblues-visual-grid-for-bandcamp","status":"publish","type":"plugin","link":"https:\/\/ms.wordpress.org\/plugins\/acidboxblues-visual-grid-for-bandcamp\/","author":13081124,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.3.8","stable_tag":"1.3.8","tested":"6.9.4","requires":"5.4","requires_php":"7.4","requires_plugins":null,"header_name":"Acidboxblues Visual Grid for Bandcamp","header_author":"thisisnotlondon","header_description":"Displays a grid of Bandcamp albums using [acidvigr_visual_grid] shortcode","assets_banners_color":"","last_updated":"2026-01-29 02:25:20","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/paypal.me\/fundmydigitakt","header_plugin_uri":"","header_author_uri":"https:\/\/acidboxblues.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":183,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0":{"tag":"1.0","author":"thisisnotlondon","date":"2026-01-29 02:22:24"},"1.3.8":{"tag":"1.3.8","author":"thisisnotlondon","date":"2026-01-29 02:25:20"}},"upgrade_notice":{"1.3.8":"<p>Introduces a new visual progress bar for manual cache updates and batch processing to improve stability for large discographies.<\/p>","1.3.7":"<p>Security maintenance release. Includes hardening of input sanitization and late escaping of output data.<\/p>","1.3.6":"<p>This is a significant refactor. The shortcode has changed to <code>[acidvigr_visual_grid]<\/code>. Please update your posts and pages.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3449167,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3449167,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.3.8"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[6133,14027,8515,6040,218],"plugin_category":[50],"plugin_contributors":[254866],"plugin_business_model":[],"class_list":["post-275223","plugin","type-plugin","status-publish","hentry","plugin_tags-albums","plugin_tags-bandcamp","plugin_tags-discography","plugin_tags-grid","plugin_tags-music","plugin_category-media","plugin_contributors-thisisnotlondon","plugin_committers-thisisnotlondon"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/acidboxblues-visual-grid-for-bandcamp\/assets\/icon-128x128.png?rev=3449167","icon_2x":"https:\/\/ps.w.org\/acidboxblues-visual-grid-for-bandcamp\/assets\/icon-256x256.png?rev=3449167","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>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.<\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li>Responsive grid layout that adjusts to any screen size<\/li>\n<li>Customisable columns between 1 and 6 (default: 2)<\/li>\n<li>Automatic data fetching retrieves album titles, artwork, and release dates from Bandcamp<\/li>\n<li>Caches album data for faster page loads<\/li>\n<li>Sort albums by release date or title, ascending or descending<\/li>\n<li>Simple shortcode implementation<\/li>\n<li>Cache updates automatically twice daily<\/li>\n<li><strong>New:<\/strong> Real-time visual progress bar and status updates when manually refreshing the cache<\/li>\n<li>Built with WordPress security best practices and data validation<\/li>\n<\/ul>\n\n<h4>How It Works<\/h4>\n\n<ol>\n<li>Add your Bandcamp album URLs to the plugin settings (one per line)<\/li>\n<li>The plugin fetches album information (title, artwork, release date) from each URL<\/li>\n<li>Data is cached for performance<\/li>\n<li>Display your albums anywhere using the [acidvigr_visual_grid] shortcode<\/li>\n<li>Cache updates automatically twice daily to keep your discography current<\/li>\n<\/ol>\n\n<h4>Suitable For<\/h4>\n\n<ul>\n<li>Musicians displaying their discography<\/li>\n<li>Record labels displaying their catalogue<\/li>\n<li>Music blogs featuring artist collections<\/li>\n<li>Music review sites<\/li>\n<li>Bandcamp Friday promotions<\/li>\n<\/ul>\n\n<!--section=installation-->\n<h4>Automatic Installation<\/h4>\n\n<ol>\n<li>Log in to your WordPress admin panel<\/li>\n<li>Go to Plugins \u2192 Add New<\/li>\n<li>Search for \"Acidboxblues Visual Grid for Bandcamp\"<\/li>\n<li>Click \"Install Now\" and then \"Activate\"<\/li>\n<\/ol>\n\n<h4>Manual Installation<\/h4>\n\n<ol>\n<li>Download the plugin zip file<\/li>\n<li>Log in to your WordPress admin panel<\/li>\n<li>Go to Plugins \u2192 Add New \u2192 Upload Plugin<\/li>\n<li>Choose the zip file and click \"Install Now\"<\/li>\n<li>Click \"Activate Plugin\"<\/li>\n<\/ol>\n\n<h4>After Installation<\/h4>\n\n<ol>\n<li>Go to Settings \u2192 Acidboxblues Visual Grid<\/li>\n<li>Add your Bandcamp album URLs (one per line)<\/li>\n<li>Adjust number of columns if desired<\/li>\n<li>Click \"Save Settings\"<\/li>\n<li>Click \"Update Cache Now\" to fetch your album data<\/li>\n<li>Add the shortcode [acidvigr_visual_grid] to any page or post<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"how%20do%20i%20add%20the%20grid%20to%20my%20page%3F\"><h3>How do I add the grid to my page?<\/h3><\/dt>\n<dd><p>Add the shortcode [acidvigr_visual_grid] to any page, post, or widget that supports shortcodes.<\/p><\/dd>\n<dt id=\"what%20urls%20should%20i%20use%3F\"><h3>What URLs should I use?<\/h3><\/dt>\n<dd><p>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<\/p><\/dd>\n<dt id=\"can%20i%20customise%20the%20grid%20layout%3F\"><h3>Can I customise the grid layout?<\/h3><\/dt>\n<dd><p>Yes. In Settings \u2192 Acidboxblues Visual Grid you can:<\/p>\n\n<ul>\n<li>Set the number of columns (1-6)<\/li>\n<li>The grid is automatically responsive on mobile devices<\/li>\n<\/ul><\/dd>\n<dt id=\"how%20do%20i%20sort%20the%20albums%3F\"><h3>How do I sort the albums?<\/h3><\/dt>\n<dd><p>Use these shortcode variations:<\/p>\n\n<ul>\n<li>[acidvigr_visual_grid] - Default (newest first)<\/li>\n<li>[acidvigr_visual_grid sort=\"date\" order=\"desc\"] - Newest first<\/li>\n<li>[acidvigr_visual_grid sort=\"date\" order=\"asc\"] - Oldest first<\/li>\n<li>[acidvigr_visual_grid sort=\"title\" order=\"asc\"] - A-Z by title<\/li>\n<li>[acidvigr_visual_grid sort=\"title\" order=\"desc\"] - Z-A by title<\/li>\n<\/ul><\/dd>\n<dt id=\"how%20often%20does%20the%20cache%20update%3F\"><h3>How often does the cache update?<\/h3><\/dt>\n<dd><p>The cache updates automatically twice daily. You can also manually update it anytime from Settings \u2192 Acidboxblues Visual Grid by clicking \"Update Cache Now\".<\/p><\/dd>\n<dt id=\"why%20isn%27t%20my%20new%20release%20showing%20up%3F\"><h3>Why isn't my new release showing up?<\/h3><\/dt>\n<dd><p>If you've just added a new album to Bandcamp:<\/p>\n\n<ol>\n<li>Add the URL to your settings<\/li>\n<li>Click \"Save Settings\"<\/li>\n<li>Click \"Update Cache Now\"<\/li>\n<li>The album should appear immediately.<\/li>\n<\/ol><\/dd>\n<dt id=\"can%20i%20use%20albums%20from%20different%20bandcamp%20artists%3F\"><h3>Can I use albums from different Bandcamp artists?<\/h3><\/dt>\n<dd><p>Yes. You can mix albums from any Bandcamp artist or label. Just add all the URLs to your list.<\/p><\/dd>\n<dt id=\"will%20this%20slow%20down%20my%20site%3F\"><h3>Will this slow down my site?<\/h3><\/dt>\n<dd><p>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).<\/p><\/dd>\n<dt id=\"does%20this%20work%20with%20bandcamp%20labels%3F\"><h3>Does this work with Bandcamp labels?<\/h3><\/dt>\n<dd><p>Yes. You can add any Bandcamp URL, whether it's from an individual artist or a label page.<\/p><\/dd>\n<dt id=\"what%20if%20a%20url%20is%20invalid%3F\"><h3>What if a URL is invalid?<\/h3><\/dt>\n<dd><p>The plugin validates all URLs and only saves valid HTTPS Bandcamp URLs. Invalid URLs are automatically filtered out when you save settings.<\/p><\/dd>\n<dt id=\"can%20i%20display%20multiple%20grids%20on%20one%20page%3F\"><h3>Can I display multiple grids on one page?<\/h3><\/dt>\n<dd><p>Yes. You can use multiple [acidvigr_visual_grid] shortcodes on the same page, each with different sorting options.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.3.8<\/h4>\n\n<ul>\n<li>Feature: Added a visual progress bar and real-time status text to the settings page when updating the cache manually.<\/li>\n<li>Improvement: Switched manual cache updates to a JavaScript-based batch process. This prevents PHP timeouts when processing large lists of URLs.<\/li>\n<li>Improvement: Better error handling during the scraping process; individual URL failures no longer stop the entire batch.<\/li>\n<\/ul>\n\n<h4>1.3.7<\/h4>\n\n<ul>\n<li>Security: Implemented \"late escaping\" for inline CSS generation using <code>absint()<\/code> to prevent injection.<\/li>\n<li>Security: Enhanced input sanitization for settings using <code>wp_unslash<\/code> and strict field sanitization.<\/li>\n<li>Security: Hardened settings saving process by using specific input allowlists.<\/li>\n<\/ul>\n\n<h4>1.3.6<\/h4>\n\n<ul>\n<li>Refactor: Implemented PHP Namespaces (<code>thisisnotlondon\\bandcampalbumgrid<\/code>) to prevent code collisions.<\/li>\n<li>Refactor: Standardized all internal prefixes to <code>acidvigr_<\/code> (Classes, constants, options, and actions).<\/li>\n<li>Change: Shortcode updated to <code>[acidvigr_visual_grid]<\/code>.<\/li>\n<li>Performance: Separated CSS and JS into dedicated asset files.<\/li>\n<li>Performance: Implemented <code>wp_add_inline_style<\/code> for dynamic column handling.<\/li>\n<li>Performance: Implemented <code>wp_localize_script<\/code> for secure Admin JS variable handling.<\/li>\n<\/ul>\n\n<h4>1.3.5<\/h4>\n\n<ul>\n<li>Renamed plugin to Acidboxblues Visual Grid for Bandcamp<\/li>\n<li>Removed: Thumbnail size setting to simplify layout and prevent CSS conflicts<\/li>\n<li>Changed: Images now automatically fill 100% of the column width<\/li>\n<li>Improved: CSS handling for square aspect ratios<\/li>\n<\/ul>\n\n<h4>1.3.4<\/h4>\n\n<ul>\n<li>Fixed: Critical error on activation by ensuring WordPress is fully loaded before initialisation<\/li>\n<li>Improved: Added check for DOMDocument extension to prevent crashes on unsupported servers<\/li>\n<\/ul>\n\n<h4>1.3.3<\/h4>\n\n<ul>\n<li>Fixed: CSS specificity issue where some themes would override the thumbnail size setting<\/li>\n<li>Improved: Added important flag to width styles to ensure user settings take precedence<\/li>\n<\/ul>\n\n<h4>1.3.2<\/h4>\n\n<ul>\n<li>Fixed: Grid \"blowout\" issue where large album covers would expand columns unexpectedly<\/li>\n<li>Improved: CSS Grid definition using minmax to handle intrinsic image sizes<\/li>\n<\/ul>\n\n<h4>1.3.1<\/h4>\n\n<ul>\n<li>Changed: Thumbnail size setting now uses percentages (%) instead of pixels (px) for responsiveness<\/li>\n<li>Improved: Added aspect-ratio CSS to ensure thumbnails remain square<\/li>\n<li>Improved: Images smaller than column width are now automatically centred<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Improved: Replaced Regex with DOMDocument for more reliable data fetching<\/li>\n<li>Improved: Cache security (hashed filenames and directory protection)<\/li>\n<li>Improved: Handling of line endings in settings<\/li>\n<li>Improved: Hidden admin error messages from public view<\/li>\n<li>Updated: Requires PHP 7.4+<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Added customisable column count setting<\/li>\n<li>Added adjustable thumbnail size<\/li>\n<li>Improved settings panel UI<\/li>\n<li>Enhanced security with proper escaping<\/li>\n<li>Added translation support<\/li>\n<li>Simplified default URL list<\/li>\n<li>Fixed WordPress coding standards compliance<\/li>\n<li>Performance improvements<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Display a grid of Bandcamp albums on your WordPress site with customisable layouts and automatic data caching.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ms.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/275223","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ms.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ms.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ms.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=275223"}],"author":[{"embeddable":true,"href":"https:\/\/ms.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/thisisnotlondon"}],"wp:attachment":[{"href":"https:\/\/ms.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=275223"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ms.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=275223"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ms.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=275223"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ms.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=275223"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ms.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=275223"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ms.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=275223"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}