Shortcodes
- Pete Callaghan
- LabelGrid
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 |
| string | filters the list to match only the specified label | all |
| numeric | number of items returned | 1 |
| select | filter by status (released, unreleased, all) | released |
| string | order of the results Possible values: “DESC”=Descending “ASC”=Ascending | DESC |
| array | filter by artists IDs | null |
| 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 |
| string | filters the list to match only the specified label | all |
| true/false | show or hide page title | true |
| numeric | number of items per page | 12 |
| numeric | number of items per row | 4 |
| on/off | enable pagination | on |
| 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 |
| 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 |
| 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 |
| string* | filters the list to match only the specified artist category | all |
| true/false | show or hide page title | true |
| numeric | number of items per page | 12 |
| numeric | number of items per row | 4 |
| on/off | enable pagination | on |
| 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 |
| string* | filters the list to match only the specified gate category | all |
| true/false | show or hide page title | true |
| numeric | number of items per page | 12 |
| numeric | number of items per row | 4 |
| 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 |
| string* | specifies the gate-id (or post id associated to the gate) | current post id |
| string | show a custom text for the download button | null |
| string | use a custom CSS class on the button | null |
| 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']