Display PDFs / documents with category selector in list

Here describes how to use shortcodes to display PDFs in list with category selector.
With category selector, it allows user/visitor to select the category and have all pdfs associated with the category be shown.
There are two list types and you need call different shortcodes to display what you want.

Shortcodes

[bsk-pdfm-selector-ul] for unordered list and [bsk-pdfm-selector-ol] for ordered list.

They have same attributes and you may switch the two shortcodes in the following examples.

Common uses

Specific categories in selector, PDFs with search bar, date weekday filter
[bsk-pdfm-selector-ul cat_id="ALL" exclude_cat_id="9,10,11,12,13,14,15,16,17,18" hierarchical="yes" cat_order_by="title" cat_order="ASC" order_by="date" order="DESC" pdfs_per_page="10" target="_blank" show_date="yes" date_format="_d/m/Y" search_bar="YEAR_KEYWORDS" search_bar_year_range="2015-2018" search_bar_year_order="DESC" date_weekday_filter="M-D" date_weekday_filter_right="yes"]
click to copy

view demo

All categories in selector, PDFs with featured image search bar, date weekday filter
[bsk-pdfm-selector-ul cat_id="ALL" exclude_cat_id="9,10,11,12,13,14,15,16,17,18" hierarchical="yes" default_cat_id="5" cat_order_by="title" cat_order="ASC" order_by="date" order="DESC" pdfs_per_page="10" target="_blank" show_date="yes" date_format="_d/m/Y" search_bar="YEAR_KEYWORDS" search_bar_year_range="2015-2018" search_bar_year_order="DESC" date_weekday_filter="M-D" date_weekday_filter_right="yes" featured_image="yes" show_pdf_title="yes" show_description="yes"]
click to copy

view demo

Shortcode attributes table

Both the two shortcodes have same attributes, the following examples use bsk-pdfm-selector-ul but it also work for bsk-pdfm-selector-ol.

You may choose the features you want and then add associated attributes to shortcode.

Attribute Values Default
selector_option_none any string Select category to browse...
cat_id integer value, ALL
default_cat_id integer value
exclude_cat_id integer value no
cat_order_by title, date title
cat_order ASC, DESC ASC
password_required yes no
hide_empty_cat yes no
show_cat_empty_message yes no
hierarchical yes no
show_cat_description no yes
Examples Description
[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" exclude_cat_id="2,3,4" selector_option_none="Click to change category"]
click to copy

view demo

show all categories exclude category of id = 2,3,4 in selector order by title in ascending( defualt ), default to display all PDFs/documents in category of id = 1 in title ascending( default ). Display PDFs/documents in selected category by Ajax on selector change.
[bsk-pdfm-selector-ul cat_id="1,2,13,9,8" default_cat_id="1" exclude_cat_id="2,3,4" cat_order_by="date" cat_order="DESC"]
click to copy

view demo

show categories of id = 1,2,13,9,8 in selector order by category date in descending, default to display all PDFs/documents in category of id = 1 in title ascending( default ). Display PDFs/documents in selected category by Ajax on selector change.
[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" hide_empty_cat="yes" cat_order_by="date" cat_order="DESC" order_by="date" order="ASC" selector_option_none="Fai clic per cambiare categoria"]
click to copy

view demo

show all categories with PDFs/documents in selector order by date in descending, default to display all PDFs/documents in category of id = 1 in date ascending. Display PDFs/documents in date ascending in selected category by Ajax on selector change.
[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" hierarchical="yes" cat_order_by="date" cat_order="DESC" order_by="date" order="ASC" show_cat_empty_message="yes" show_cat_description="yes" password_required="yes"]
click to copy

view demo

show all categories in selector order by title in date descending, default to display all PDFs/documents in category of id = 1 in date ascending. Display PDFs/documents in date ascending in selected category by Ajax on selector change. Show category description and empty message.

*  password_required="yes", only protect the PDF/document list( links ) not visible to users, does not protect PDF/document itself. To protect PDF/document file please use "Security and users permission module( developing )"

*  hide_empty_cat="yes" will hide categories that have no PDFs/documents from selector

Attribute Values Default
exclude_pdf_id integer value
Examples Description
[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" hide_empty_cat="yes" hierarchical="yes" exclude_pdf_id="7,8,9,10,11,12"]
click to copy

view demo

show all categories exclude category of id = 2,3,4 in selector, default to display all PDFs/documents but exclude PDF/documents with id of: 7,8,9,10,11,12. Display PDFs/documents in selected category by Ajax on selector change.
[bsk-pdfm-selector-ul cat_id="all" extension="pdf"]
click to copy

view demo

show all PDFs
[bsk-pdfm-selector-ul cat_id="all" exclude_id="3,4,5,8" columns="3" extension="mp3,flac,wav"]
click to copy

view demo

show audio files

*  exclude_pdf_id is for PDF/document id

*  extension must be valid value that checked on plugin setting page

Attribute Values Default
order_by title, date, custom, id title
order ASC, DESC ASC
Examples Description
[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" order_by="title" order="ASC"]
click to copy

view demo

Display all categories in selector, default display all PDFs/documents of category id:1 in title ascending. Load PDFs/documents in selected category on selector change.
[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" order_by="date" order="DESC"]
click to copy

view demo

Same as above but PDFs/documents in date descending
[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" order_by="custom" order="ASC"]
click to copy

view demo

Display PDFs/documents in selected category by customer ascending order

*  Check for how to set custom order >>

[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" order_by="id" order="DESC"]
click to copy

view demo

Display PDFs/documents in id descending order
Attribute Values Default
most_top integer value( > 0 )
year_of year number( ex: 2020 ), 9999( most recent ), year range( ex: 2017-2019 )
month_of month number( ex: 05 mans May ), any year
day_of day number( ex: 03 ), any year any month
weekday_of MON, TUE, WED, THU, FRI, SAT, SUN
Examples Description
[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" order_by="date" order="DESC" most_top="20" ]
click to copy

view demo

All category in title ascending order in selector, show the most recent 20 PDFs/documents in selected category

*  pagination cannot work if month_of="X" applied

[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" year_of="2017" pdfs_per_page="5"]
click to copy

view demo

All category in title ascending order in selector, only show PDFs/documents with date in year 2017 in selected category
[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" year_of="2020-9999" pdfs_per_page="5"]
click to copy

view demo

All category in title ascending order in selector, only show PDFs/documents with date after 2020-01-01 in selected category
[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" year_of="2017" month_of="06"]
click to copy

view demo

All category in title ascending order in selector, only show PDFs/documents which date in Jun, 2017 in selected category
[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" day_of="11"]
click to copy

view demo

All category in title ascending order in selector, only show PDFs/documents which date day of 11 in selected category, donot care year or month
[bsk-pdfm-selector-ul cat_id="all" default_cat_id="1" year_of="9999" month_of="99" day_of="99"]
click to copy

view demo

only show PDFs/documents which date is the most recent date in selected category
[bsk-pdfm-selector-ul cat_id="1,2,19,21,6" default_cat_id="1" weekday_of="MON"]
click to copy

view demo

only show PDFs/documents which date is Monday in selected category, donot care year, month or day )

*  Pagination cannot work when most_top="x" applied

Attribute Values Default
pdfs_per_page integer value( > 0 ) 0
pagination_previous_text any string « Previous Page
pagination_next_text any string Next Page »
Examples Description
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" order_by="date" order="DESC" pdfs_per_page="5"]
click to copy

view demo

display all PDFs/documents in selected category with pagination and every 5 PDFs/documents on each page
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" show_cat_description="yes" pdfs_per_page="10" pagination_previous_text="Previous" pagination_next_text="Next"]
click to copy

view demo

every 10 PDFs/documents on each page and customize previous and next anchor

*  Pagination does't work when most_top="xx" applied

Attribute Values Default
show_count_desc yes no
count_desc_empty any string no records found
count_desc_singular %d + any string %d record found
count_desc_plural %d + any string %d records found
Examples Description
[bsk-pdfm-selector-ul cat_id="1,2,6,20,21" default_cat_id="1" search_bar="KEYWORDS" show_count_desc="yes" pdfs_per_page="15"]
click to copy

view demo

display categories of id=1,2,6,20, 21 in title ascending in selector, every 15 PDFs/documents on each page with search bar eanbled, the search bar only have keywords field. PDFs/documents order in title ascending( default ). Display count bar above PDFs/documents
[bsk-pdfm-selector-ul cat_id="1,2,6,20,21" default_cat_id="1" extension_filter="SPECIFIC" extension_filter_specific="pdf,zip,doc,docx" extension_filter_labels="pdf:Schedule,zip:Attachment,doc:Timesheet,docx:More details" show_count_desc="yes" count_desc_singular="Total: %d" count_desc_plural="Total: %d" pdfs_per_page="15"]
click to copy

view demo

display extension bar and show results count with custom text for all PDFs/documents in selected category
Attribute Values Default
show_date yes no
date_format d, j, l, m, M, F, Y, y d/m/Y
date_before_title yes no
date_prefix custom string
show_description yes no
Examples Description
[bsk-pdfm-selector-ul cat_id="1,2,6,20,21" default_cat_id="1" show_date="yes"]
click to copy

view demo

Dislay categories of id=1,2,6,20,21 in title ascending in selector, show PDFs/documents in selected category, append date with default format( d/m/Y, example: 25/02/2020 ) after title.
[bsk-pdfm-selector-ul cat_id="1,2,6,20,21" default_cat_id="1" show_date="yes" date_format="--F d, Y" date_prefix="Published on: "]
click to copy

view demo

Same as above but make date with custom format( F d, Y, example: February 25, 2020 ). And display "Published on: " before PDF date.
[bsk-pdfm-selector-ul cat_id="1,2,6,20,21" default_cat_id="6" show_date="yes" date_format="Y-m-d " date_before_title="yes" show_description="yes"]
click to copy

view demo

Place date before title

*  Check PHP date() Function for more date format

Attribute Values Default
date_weekday_filter Y, m, M, F, d, j, jS, D, l
date_weekday_filter_order DESC, ASC ASC
date_weekday_filter_right yes no
date_weekday_filter_year_option_none any string Year
date_weekday_filter_month_option_none any string Month
date_weekday_filter_day_option_none any string Day
date_weekday_filter_weekday_option_none any string Day of week
Examples Description
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" pdfs_per_page="10" date_weekday_filter="Y-m-d-D" date_weekday_filter_order="DESC-ASC-ASC-ASC" date_weekday_filter_right="yes"]
click to copy

view demo

display all categories in title ascending in selector, display PDFs/documents in title ascending( default ) in selected category, place date weekday fitler above PDFs/documents list on right.

*  The date_weekday_filter & date_weekday_filter_order separated by - and can use one or all of them

[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" pdfs_per_page="10" date_weekday_filter="Y-m-d-D" date_weekday_filter_order="DESC-ASC-ASC-ASC" date_weekday_filter_right="yes" date_weekday_filter_year_option_none="Anno" date_weekday_filter_month_option_none="Mese" date_weekday_filter_day_option_none="Giorno" date_weekday_filter_weekday_option_none="Giorno della settimana"]
click to copy

view demo

Same as above but overwrite text on year, month, day, day of week
[bsk-pdfm-selector-ul cat_id="1,6,12,17" default_cat_id="1" date_weekday_filter="Y" date_weekday_filter_order="DESC" order_by="date" order="DESC" most_top="15"]
click to copy

view demo

display the most recent 15 PDFs/documents in selected category, show year filter above PDFs/documents
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" pdfs_per_page="30" date_weekday_filter="Y-D" date_weekday_filter_order="DESC-ASC"]
click to copy

view demo

show year and weekday in filter, year in descending and month in ascending

*  This filter only apply to the current PDFs/documents results it won't query PDFs/documents from database

*  For year the support format is: Y( eg: 2020 )

*  For month the support format is: m( eg: 01 ), M( eg: Dec ), F( eg: February )

*  For day the support format is: d( eg: 25 ), j( eg: 25 ), jS( eg: 25th )

*  For weekday the support format is: D( eg: Tue ), l( lower case of L, eg: Tuesday )

Attribute Values Default
date_weekday_query_filter ALL_EXISTED, SPECIFIC no
date_weekday_query_filter_format Y, m, M, F, d, j, jS, D, l, Y-m|M|F-d|j|jS-D|l Y-F-jS-D
date_weekday_query_filter_range YEAR_start:YEAR_end-MONTH_start:MONTH_end-DAY_start:DAY_end-WEEKDAY_start:WEEKDAY_end 2000:2020-1:12-1:31-MON:SUN
date_weekday_query_filter_order DESC, ASC DESC-ASC-ASC-ASC
date_weekday_filter_year_option_none any string Year
date_weekday_filter_month_option_none any string Month
date_weekday_filter_day_option_none any string Day
date_weekday_filter_weekday_option_none any string Day of week
date_weekday_query_filter_right yes no
date_weekday_query_filter_only yes no
date_weekday_query_filter_sunday_first yes no
Examples Description
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" cat_order_by="date" cat_order="DESC" order_by="date" order="DESC" date_weekday_query_filter="ALL_EXISTED" pdfs_per_page="10"]
click to copy

view demo

Display all categoires that have PDFs/documents in title ascending in selector, display PDFs/documents in selected category on selector change, display date weekday query filter above PDFs, change dropdown to query PDFs with selected year, monthy, day and day of week
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="20" hide_empty_cat="yes" cat_order_by="date" cat_order="DESC" order_by="date" order="DESC" date_weekday_query_filter="ALL_EXISTED" date_weekday_query_filter_format="Y-F" pdfs_per_page="10"]
click to copy

view demo

display year and month as query filter
[bsk-pdfm-selector-ul cat_id="1,2,6,12,17" default_cat_id="1" order_by="date" order="DESC" date_weekday_query_filter="SPECIFIC" date_weekday_query_filter_range="2015:2020-MON:SUN" date_weekday_query_filter_format="Y-l"]
click to copy

view demo

display specific date weekday query filter, set year range from 2015 to 2020 and day of week from Monday to Sunday.
[bsk-pdfm-selector-ul cat_id="1,2,6,12,17" default_cat_id="1" order_by="date" order="DESC" date_weekday_query_filter="SPECIFIC" date_weekday_query_filter_range="2015:2020-MON:SUN" date_weekday_query_filter_format="Y-l" date_weekday_query_filter_order="ASC-DESC"]
click to copy

view demo

set year order to ascendant so it will show 2015 as first and 2020 as last.
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" order_by="date" order="DESC" date_weekday_query_filter="ALL_EXISTED" date_weekday_query_filter_format="Y-F" date_weekday_filter_year_option_none="Select year..." date_weekday_filter_month_option_none="Select month..." date_weekday_query_filter_right="yes" date_weekday_query_filter_only="yes"]
click to copy

view demo

display year and month as query filter, place query filter bar on right, only show query filter bar( without PDFs at first), change dropdown option null to specific text.

*  This filter shows year, month, day, day of week in dropdowns above and load documents whose date same as selected values.

*  The filter different from Date weekday filter, this one loads documents from databse when filter change.

*  date_weekday_query_filter_only="yes" means no PDFs/documents listed at first

Attribute Values Default
extension_filter ALL, ALL_EXISTED, SPECIFIC no
extension_filter_default a valid extension
extension_filter_specific valid extensions
extension_filter_labels extension:label
extension_filter_exclude valid extensions
extension_filter_only yes no
Examples Description
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" order_by="date" order="DESC" extension_filter="ALL"]
click to copy

view demo

Display all categoires that have PDFs/documents in selector, display PDFs/documents in selected category on selector change, display all supported extensions filter above PDFs/documents.
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" order_by="date" order="DESC" extension_filter="ALL" extension_filter_default="pdf"]
click to copy

view demo

same as above but set default extension to PDF, it means only PDFs shown at first
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" order_by="date" order="DESC" extension_filter="ALL_EXISTED"]
click to copy

view demo

only show extensions that have PDFs/documents managed.

*  hide_empty_cat="yes" will hide categories that have no PDFs/documents from selector

[bsk-pdfm-selector-ul cat_id="1,2,6,12,17" default_cat_id="1" extension_filter="SPECIFIC" extension_filter_specific="pdf,zip,doc,docx"]
click to copy

view demo

Show specifc extensions for selected category, the extensions given by extension_filter_specific
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" extension_filter="SPECIFIC" extension_filter_specific="pdf,zip,doc,docx" extension_filter_labels="pdf:Schedule,zip:Attachment,doc:Timesheet,docx:More details" show_count_desc="yes"]
click to copy

view demo

Show specifc extensions with labels. Labes will be shown above PDFs/documents instead extensions.

*  hide_empty_cat="yes" will hide categories that have no PDFs/documents from selector

[bsk-pdfm-selector-ul cat_id="1,2,6,17" default_cat_id="1" extension_filter="ALL_EXISTED" extension_filter_only="yes" show_count_desc="yes"]
click to copy

view demo

Only show extensions filter that have PDFs/documents managed, without PDFs/documents at first. Also show results count.

*  extension_filter_only="yes" means no PDFs/documents listed at first( even extension_filter_default given), so just extensions there.

*  This filter shows extensions that choosen on plugin setting page. It will show extensions above and load documents that have clicked extension.

*  This filter will overwrtie the extension attribute

Attribute Values Default
title_filter ALPHABET, ALPHABET_EXISTED, SPECIFIC no
title_filter_default valid title
title_filter_specific valid title
title_filter_first_x_chars integer value( work with ALPHABET_EXISTED ) 1
title_filter_exclude any string
title_filter_only yes no
Examples Description
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" order_by="date" order="DESC" title_filter="ALPHABET"]
click to copy

view demo

Display all categoires that have PDFs/documents in title ascending in selector, display PDFs/documents in selected category on selector change, display alphabet( A - Z ) as title start filter above PDFs/documents list. Order PDFs/documents by date in descending
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="20" hide_empty_cat="yes" cat_order_by="date" cat_order="DESC" order_by="date" order="DESC" title_filter="ALPHABET" title_filter_default="C" ]
click to copy

view demo

Same as above but the category title order in selecrtor is by date in descending. Also set 'C' as the default title fitler
[bsk-pdfm-selector-ul cat_id="1,2,6,12,17" default_cat_id="1" order_by="date" order="DESC" title_filter="ALPHABET_EXISTED"]
click to copy

view demo

Only show first char of title of existed PDFs/documents as filter.
[bsk-pdfm-selector-ul cat_id="1,2,6,12,17" default_cat_id="1" order_by="date" order="DESC" title_filter="ALPHABET_EXISTED" title_filter_first_x_chars="3"]
click to copy

view demo

Display all available first 3 chars of title of existed PDFs/documents as filter above PDFs/documents
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" order_by="date" order="DESC" title_filter="ALPHABET_EXISTED" title_filter_first_x_chars="2" title_filter_exclude="In,Se"]
click to copy

view demo

display all available first 2 chars of title of existed PDFs/documents but exclude In, Se as filter above PDFs/documents
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" title_filter="SPECIFIC" title_filter_specific="Traffic,Board" title_filter_default="Board"]
click to copy

view demo

Show specifc string as titler filter, filter given by title_filter_specific and set default to "Board"
[bsk-pdfm-selector-ul cat_id="1,12,21" default_cat_id="1" title_filter="SPECIFIC" title_filter_specific="Traffic,Board" title_filter_only="yes" show_count_desc="yes"]
click to copy

view demo

Only show title filter at first, PDFs/documents will be loaded on titler filter clicked.

*  This filter shows string above and load documents that title start with clicked extension.

*  title_filter_only="yes" means no PDFs/documents listed at first( even title_filter_default given).

Attribute Values Default
tags ALL, ASSIGNED, SPECIFIC
tags_default tag id
tags_exclude tag id, separate by comma
tags_specific tag id, separate by comma
tags_align_right no, yes no
tags_order_by date, title title
tags_order ASC, DESC ASC
Examples Description
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" order_by="date" order="DESC" tags="ALL" tags_order_by="date" tags_order="DESC"]
click to copy

view demo

Display all categoires that have PDFs/documents in title ascending in selector, display PDFs/documents in selected category on selector change, display all tags above as anchor
[bsk-pdfm-selector-ul cat_id="ALL" default_cat_id="20" hide_empty_cat="yes" cat_order_by="date" cat_order="DESC" order_by="date" order="DESC" tags="ASSIGNED" tags_exclude="1,2" tags_align_right="yes" ]
click to copy

view demo

only display tags that assigned to PDFs / documents

*  Tags with ID of 1 and 2 will be excluded

[bsk-pdfm-selector-ul cat_id="1,2,6,12,17" default_cat_id="1" order_by="date" order="DESC" tags="SPECIFIC" tags_specific="8,11,23,14,26,28"]
click to copy

view demo

display tags with ID of 8,11,23,14,26,28

*  Tags name will be show as anchor above PDFs/documents list, load PDFs by AJAX when click tag

Advanced uses

Output container class

Use shortcode parameter of output_container_class to add your own class name to the shortcode output container if you'd like to do custom CSS. Example: [bsk-pdfm-selector-ul cat_id="ALL" output_container_class="my_idenfity_PDFs_container_class"]

Filters & Hooks

Filters & Hooks

Purchase BSK PDF Manager Pro