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.
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:
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
random
no
false*
Randomises the gallery. When used in combination with multiple artists, value is set to true by default
link_colour
no
0687f5
tile_colour
no
ffffff