BSTabs plugin registers new post type of type Tab which serves as container for files (gpx, audio, pdf, etc.) and information (instrument, genre, level, etc.) related to one specific tabulature. New shortcode
[tabs]
could be inserted in any post content and allows listing and searching in all tabulatures according attributes.
Shortcode
[tabs]
, in its simple form (without any parameters), lists all tabulatures. Use one or more of the following parameters to change tab listing or show search dialog:
instrument
- optional parameter to limit list of tabulatures to specific instrument. (possible values: all, banjo, gutar, mandolin, fiddle, bass; default value: all).
search
- optional parameter for showing search dialog with controls for various tab metadata attributes. (possible values: yes, no; default value: no)
search_all_button
- optional parameter for showing additional button in search dialog. This button allows users to show all tabs and ignore all search dialog filters. (possible values: yes, no; default value: no)
count
- maximal number of listed tabulatures
orderby
- optional parameter to set fields for order of tabulatures, acceptable fields are author
, title
and published
. Default value is title
.
order
- optional parameter which provides additional information to orderby
parameter. It specifies if list is sorted ascending or descending.Possible values are asc
and desc
. Default value is asc
.
fields
- optional parameter which allows to enumerate tabulature fields (attributes) to be shown in listing. Parameter value must be list of field identifiers separated by semicolon. Allowed identifiers are: title
, instrument
, author
, key
, level
, genre
, tuning
, audio
, tabs
, links
and published
.
class
- optional parameter to set additional CSS class for listing generated by shortcode
Examples:
[tabs] - list all tabulatures
[tabs search="yes"] - show search dialog
[tabs search="yes" instrument="banjo"] - show search dialog, but limit all search queries to banjo instrument.
[tabs instrument="guitar"] - list all guitar tabulatures
[tabs count="5" orderby="published" order="desc" fields="title;instrument;tabs;published" class="compact"] - list five last published tabulatures, most recent tab is listed first, listing is limited to selected columns (attributes) and generated HTML code is extended of class
raw
.