Shortcodes

The shortcodes included in this plug-in can be used everywhere in your WordPress site.

LabelGrid Tools comes with many shortcodes that can be used to display release lists, artist lists, release links, and gated downloads on your WordPress site.

Releases

Release Banner

Shortcode: [labelgrid-release-banner]

Description: Show a banner with the latest release published.

Optional Parameters

parameter	type	purpose	default
label	string	filters the list to match only the specified label	all
items-page	numeric	number of items returned	1
item-filter	select	filter by status (released, unreleased, all)	released

To filter the list by label, use the full label name as listed in LabelGrid.

You can upload personalized backgrounds in each Release

Example

[labelgrid-release-banner label='your label' items-page='1' item-filter='released']

Release list

Shortcode: [labelgrid-release-list]

Description: Show a list of releases with pagination. Can be filtered to show only a selected record label.

Optional Parameters

parameter	type	purpose	default
label	string	filters the list to match only the specified label	all
show_title	true/false	show or hide page title	true
items-page	numeric	number of items per page	12
items-row	numeric	number of items per row	4
pagination	on/off	enable pagination	on
title-below	yes/no	show titles below artwork	no
item-filter	select	filter by status (released, unreleased, all)	all

To filter the list by label, use the full label name as listed in LabelGrid.

Example

[labelgrid-release-list label='your label' show-title='false' items-page='16' items-row='4' pagination='on']

[labelgrid-release-links release-id='10']

Release links

Shortcode: [labelgrid-release-links]

Description: Print all Stores links for a certain release.

Optional Parameters

parameter	type	purpose	default
release-id	integer	specifies the release id to display.	null

NOTE: If the shortcode is called inside a loop and no ID is specified, it will use the post ID of the loop.

Example

[labelgrid-release-links release-id='10']

Release filters

Shortcode: [labelgrid-release-list-filter]

Description: Filter the displayed records by Genre or Record Label

Optional Parameters

parameter	type	purpose	default
record_label	integer	If set to "true" will show the Record labels Dropdown in the filters	null

NOTE: These filters work in conjunction with [labelgrid-release-list]

If you have set something in the label parameter of [labelgrid-release-list], the record_label dropdown will not appear.

Example

[labelgrid-release-list-filter record_label='true']

Artists

Artist list

Shortcode: [labelgrid-artist-list]

Description: Show a list of releases with pagination. Can be filtered to show only a selected artist category.

Optional Parameters

parameter	type	purpose	default
category	string*	filters the list to match only the specified artist category	all
show_title	true/false	show or hide page title	true
items-page	numeric	number of items per page	12
items-row	numeric	number of items per row	4
pagination	on/off	enable pagination	on
title-below	yes/no	show titles below artwork	no

*Category filtering: To filter the list by category, use the artist category name.

Example

[labelgrid-artist-list category='your category' show-title='true' items-page='16' items-row='4' pagination='on' title-below='yes']

Gated download

Gated download list

Shortcode: [labelgrid-gate-download-list]

Description: Show a list of Gate Downloads with Pagination. Can be filtered to show only a selected Gate Category.

Optional Parameters

parameter	type	purpose	default
category	string*	filters the list to match only the specified gate category	all
show_title	true/false	show or hide page title	true
items-page	numeric	number of items per page	12
items-row	numeric	number of items per row	4
pagination	on/off	enables pagination	on

*Category filtering: To filter the list by category, use the gate category name.

Example

[labelgrid-gate-download-list category='your category' show-title='false' items-page='16' items-row='4' pagination='on']

Gated download button

Shortcode: [labelgrid-gate-button]

Description: Show the download button which will trigger a download window for the user.

Optional Parameters

parameter	type	purpose	default
gate-id	string*	specifies the gate-id (or post id associated to the gate)	current post id
button-label	string	show a custom text for the download button	null
custom-class	string	use a custom CSS class on the button	null
download-text	string	change the default text inside the download window	null

Custom CSS class: the plugin will print only a<a href class=”custom”></a>removing the default DIV that contains the link.

Example

[labelgrid-gate-button gate-id='123' button-label='Get This For Free' custom-class='my-custom-css-class' download-text='Get the download']