Display PDFs / documents with category selector in dropdown

Here describes how to use shortcodes to display PDFs in specific category / categories in dropdown.

Shortcodes

[bsk-pdfm-selector-dropdown]

Common uses

All categories with hierarchy in selector, PDFs with date weekday filter
[bsk-pdfm-selector-dropdown cat_id="ALL" exclude_cat_id="9,10,11,12,13,14,15,16,17,18" show_cat_description="yes" hierarchical="yes" default_cat_id="5" cat_order_by="title" cat_order="ASC" order_by="date" order="DESC" target="_blank" show_date="yes" date_format="_d/m/Y" date_weekday_filter="M-D" date_weekday_filter_right="yes"]
click to copy

view demo

Shortcode attributes table

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
hierarchical yes no
show_cat_description no yes
Examples Description
[bsk-pdfm-selector-dropdown 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 ) in dropdown. Display PDFs/documents in selected category in dropdown by Ajax on selector change.
[bsk-pdfm-selector-dropdown 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 in dropdown by Ajax on selector change.
[bsk-pdfm-selector-dropdown cat_id="all" default_cat_id="1" hide_empty_cat="yes" cat_order_by="date" cat_order="DESC" order_by="date" order="ASC"]
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 in dropdown by Ajax on selector change.
[bsk-pdfm-selector-dropdown cat_id="all" default_cat_id="11" hierarchical="yes" cat_order_by="date" cat_order="DESC" order_by="date" order="ASC" 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 in dropdown 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
option_none any string Select to open...
target _blank _blank
Examples Description
[bsk-pdfm-selector-dropdown cat_id="all" default_cat_id="1" exclude_cat_id="2,3,4"]
click to copy

view demo

Display all categories exclude cateogry of id:2,3,4 in selector, default to display PDFs/documents in category of id:1 in dropdown. Load PDFs/documents in selcted category in dropdown on category change, open PDF/document in new window/tab when PDFs/documents dropdown selected change
[bsk-pdfm-selector-dropdown cat_id="all" default_cat_id="1" exclude_cat_id="2,3,4" selector_option_none="Fai clic per cambiare categoria" option_none="Selezionare per aprire"]
click to copy

view demo

Same as above but overtie the selctor option none and PDFs/documents option none to Italian

*  The default text on select is overwritten

[bsk-pdfm-selector-dropdown cat_id="all" default_cat_id="1" exclude_cat_id="2,3,4" target=""]
click to copy

view demo

Display all categories exclude cateogry of id:2,3,4 in selector, open PDF/document in current window/tab when PDFs/document dropdown selected change
Attribute Values Default
exclude_pdf_id integer value
Examples Description
[bsk-pdfm-selector-dropdown cat_id="all" default_cat_id="11" exclude_cat_id="3,4,5,8" exclude_pdf_id="7,8,9,10,11,12,81"]
click to copy

view demo

Show all PDF/documents in all category but exclude category id in( 3,4,5,8 ). Exlcude PDF/docoument of id:7,8,9,10,11,12,81 for any selected category.
[bsk-pdfm-selector-dropdown cat_id="all" extension="pdf"]
click to copy

view demo

show all PDFs
[bsk-pdfm-selector-dropdown 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-dropdown 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-dropdown 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-dropdown 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-dropdown 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-dropdown 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 in dropdown
[bsk-pdfm-selector-dropdown cat_id="all" default_cat_id="1" year_of="2017"]
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 in dropdown
[bsk-pdfm-selector-dropdown cat_id="all" default_cat_id="1" year_of="2019-9999"]
click to copy

view demo

All category in title ascending order in selector, only show PDFs/documents with date after 2019-01-01 in selected category in dropdown
[bsk-pdfm-selector-dropdown 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-dropdown 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-dropdown 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-dropdown 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 )
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-dropdown cat_id="1,2,6,20,21" default_cat_id="1" search_bar="KEYWORDS" show_count_desc="yes"]
click to copy

view demo

display categories of id=1,2,6,20, 21 in title ascending in selector, 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-dropdown 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"]
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
Examples Description
[bsk-pdfm-selector-dropdown 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-dropdown 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-dropdown cat_id="1,2,6,20,21" default_cat_id="6" show_date="yes" date_format="Y-m-d " date_before_title="yes"]
click to copy

view demo

Place date before title

*  Check PHP date() Function for more date format

*  PDFs/documents description is not supported when display in dropdown

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-dropdown cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" 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-dropdown cat_id="ALL" default_cat_id="1" 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-dropdown 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-dropdown cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" 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-dropdown 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-dropdown cat_id="ALL" columns="3" 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="12" show_count_desc="yes"]
click to copy

view demo

display year and month as query filter. Also show documents count description.
[bsk-pdfm-selector-dropdown 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-dropdown 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-dropdown 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-dropdown 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.

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

[bsk-pdfm-selector-dropdown 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

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

[bsk-pdfm-selector-dropdown 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-dropdown 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-dropdown 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-dropdown 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-dropdown 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-dropdown 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-dropdown 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-dropdown 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-dropdown 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

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

[bsk-pdfm-selector-dropdown 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"

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

[bsk-pdfm-selector-dropdown 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-dropdown 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-dropdown 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-dropdown 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-dropdown cat_id="ALL" output_container_class="my_idenfity_PDFs_container_class"]

Filters & Hooks

Filters & Hooks

Purchase BSK PDF Manager Pro