bandcamp album gallery wordpress plugin

Bandcamp Album Gallery WordPress Plugin is a WordPress plugin that arranges all your Bandcamp albums in a masonry-style grid automatically. As you add new albums to Bandcamp, this grid will automatically pull in new albums or tracks and align them in the grid. Bandcamp Album Gallery WordPress Plugin is fully responsive and adapts to the size of the viewing device automatically.

Bandcamp Album Gallery WordPress Plugin can be added to any page or post by simply adding a shortcode. No prior setup is required for this plugin which means that no API keys are needed for Bandcamp, simply install it, configure your  Bandcamp artist page (see below) and see your albums appear in the grid.

Render a playlist for each of your albums to give a less structured appearance.

Choose a minimal layout to display an instagram-like grid of albums

Documentation

To use this plugin, you will need to add a shortcode to your WordPress page or post. Some shortcode usage examples are shown below:

[bandcamp-gallery id="my_id" bandcamp_urls="https://artist.bandcamp.com"]
[bandcamp-gallery id="my_id" bandcamp_urls="https://artist.bandcamp.com" minimal="true"]
[bandcamp-gallery id="my_id" bandcamp_urls="https://artist.bandcamp.com" tracklist="false"]
[bandcamp-gallery id="my_id" bandcamp_urls="https://artist.bandcamp.com" tracklist="false"]
[bandcamp-gallery id="my_id" bandcamp_urls="https://artist.bandcamp.com" tracklist="false" max_albums="30"]
[bandcamp-gallery id="my_id" bandcamp_urls="https://artist1.bandcamp.com,https://artist2.bandcamp.com" tracklist="false" max_albums="30" random="true"]

NOTE: This plugin will cache album details in a file in the plugin directory. The first load might take some time depending on the amount of tracks or albums you have on your Bandcamp artist page. Subsequent page loads will not incur this once off penalty.

Setting

Required

Default Value

Description

id

yes

n/a

A unique value for each usage of this plugin. Caution – using the same name will lead to unsatisfactory results, always make sure this name is unique across your installation.

NOTE: Only alphanumeric characters, a dash (-) and an underscore (_) are allowed


bandcamp_urls

yes

n/a

The URL of your bandcamp artist page. Common examples include:

https://johndoe.bandcamp.com/music
https://johndoe.bandcamp.com

This field accepts multiple values. Example:

https://johndoe.bandcamp.com,https://janedoe.bandcamp.com

NOTE: Ensure there are no spaces between the items in the list


tracklist

no

true

Enables or disables the tracklist. Enabled by default


minimal

no

false

Enables or disables the mimimal player. This player includes only album art and no tracklist. Cannot be used in conjunction with tracklist option.


max_albums

no

10

Specifies the number of albums to show on the page.

random

no

false*

Randomises the gallery. When used in combination with multiple artists, value is set to true by default


link_colour

no

0687f5

Sets the colour of the links in the embed code. Defaults to hex value 0687f5

tile_colour

no

ffffff

Sets the background colour of the tile. Defaults to hex value ffffff