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

item-order

string

order of the results

Possible values: “DESC”=Descending “ASC”=Ascending

DESC

filter-artists

array

filter by artists IDs

null

exclude

array

exclude specific Release IDs

null

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

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

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

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

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

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

Example

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