Display PDFs / documents with category selector in columns

Here describes how to use shortcodes to display PDFs in columns with category selector.
With category selector, it allows user/visitor to select the category and have all pdfs associated with the category be shown.

Shortcodes

[bsk-pdfm-selector-columns]

Common uses

All categories( exclude specific categories ) in selector, PDFs shown in two columns with featured image
[bsk-pdfm-selector-columns columns="2" 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" featured_image_size="medium" show_pdf_title="yes" show_description="yes"]
click to copy

view demo

Specific categories in selector, PDFs shown in three columns with featured image and PDF title above image
[bsk-pdfm-selector-columns columns="3" cat_id="4,8" hierarchical="yes" default_cat_id="11" cat_order_by="title" cat_order="ASC" order_by="date" order="DESC" pdfs_per_page="5" 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" featured_image_size="medium" show_pdf_title="yes" show_description="yes" title_position="above"]
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
show_cat_empty_message yes no
hierarchical yes no
show_cat_description no yes
Examples Description
[bsk-pdfm-selector-columns 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 in 2 columns( default ) by Ajax on selector change.
[bsk-pdfm-selector-columns cat_id="1,2,13,9,8" default_cat_id="1" exclude_cat_id="2,3,4" cat_order_by="date" cat_order="DESC" columns="3"]
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 3 columns by Ajax on selector change.
[bsk-pdfm-selector-columns cat_id="all" default_cat_id="1" hide_empty_cat="yes" cat_order_by="date" cat_order="DESC" order_by="date" order="ASC" columns="4" 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 in 4 columns by Ajax on selector change.
[bsk-pdfm-selector-columns cat_id="all" default_cat_id="11" 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" columns="3" featured_image="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 with featured image in selected category in 3 columns 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
columns integer value 2
Examples Description
[bsk-pdfm-selector-columns cat_id="all" default_cat_id="11" exclude_id="3,4,5,8" columns="4" featured_image="yes"]
click to copy

view demo

show all PDF/documents in all category but exclude category id in( 3,4,5,8 ) in three columns

*  the max columns supported is 6

Attribute Values Default
exclude_pdf_id integer value
Examples Description
[bsk-pdfm-selector-columns cat_id="all" default_cat_id="11" exclude_cat_id="3,4,5,8" columns="3" featured_image="yes" 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 ) in three columns. Exlcude PDF/docoument of id:7,8,9,10,11,12,81 for any selected category.
[bsk-pdfm-selector-columns cat_id="all" extension="pdf"]
click to copy

view demo

show all PDFs
[bsk-pdfm-selector-columns 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-columns cat_id="all" default_cat_id="1" order_by="title" order="ASC"]
click to copy

view demo

Display all categories in selector, display PDFs/documents in selected category in 2 columns in title ascending
[bsk-pdfm-selector-columns cat_id="all" default_cat_id="1" order_by="date" order="DESC" columns="3"]
click to copy

view demo

Display all categories in selector, display PDFs/documents in selected category in 3 columns in date descending
[bsk-pdfm-selector-columns cat_id="all" default_cat_id="1" order_by="custom" order="ASC" columns="4"]
click to copy

view demo

Display all categories in selector, display PDFs/documents in selected category in 3 columns by customer order

*  Check for how to set custom order >>

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

view demo

Display all categories in selector, display PDFs/documents in selected category in 3 columns in id( PDFs/documents ) 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-columns 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 2 columns

*  pagination cannot work if month_of="X" applied

[bsk-pdfm-selector-columns cat_id="all" default_cat_id="1" year_of="2017" pdfs_per_page="5" columns="3"]
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 3 columns
[bsk-pdfm-selector-columns cat_id="all" default_cat_id="1" year_of="2017-2020" pdfs_per_page="5" columns="3"]
click to copy

view demo

All category in title ascending order in selector, only show PDFs/documents with date between 2017-01-01 and 2020-12-31 in selected category in 3 columns
[bsk-pdfm-selector-columns cat_id="all" default_cat_id="1" year_of="2017" month_of="06" columns="4"]
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 in 4 columns
[bsk-pdfm-selector-columns cat_id="all" default_cat_id="1" day_of="11" columns="3"]
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-columns cat_id="all" default_cat_id="1" year_of="9999" month_of="99" day_of="99" columns="2"]
click to copy

view demo

only show PDFs/documents which date is the most recent date in selected category
[bsk-pdfm-selector-columns cat_id="1,2,19,21,6" default_cat_id="1" weekday_of="MON" columns="5"]
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-columns cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" order_by="date" order="DESC" pdfs_per_page="6"]
click to copy

view demo

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

view demo

every 6 PDFs/documents on each page in 3 columns 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-columns cat_id="1,2,6,20,21" default_cat_id="1" search_bar="KEYWORDS" show_count_desc="yes" pdfs_per_page="9" columns="3"]
click to copy

view demo

display categories of id=1,2,6,20, 21 in title ascending in selector, every 9 PDFs/documents on each page in 3 columns 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-columns 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="12" columns="4"]
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-columns 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 in 2 columns, append date with default format( d/m/Y, example: 25/02/2020 ) after title.
[bsk-pdfm-selector-columns cat_id="1,2,6,20,21" default_cat_id="1" show_date="yes" date_format="--F d, Y" columns="3" date_prefix="Published on: "]
click to copy

view demo

Same as above but display PDFs/documents in 3 columns and make date with custom format( F d, Y, example: February 25, 2020 ). And display "Published on: " before PDF date.
[bsk-pdfm-selector-columns 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" columns="4"]
click to copy

view demo

Place date before title and display in 4 columns

*  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-columns 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 in two columns, 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-columns cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" pdfs_per_page="9" 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" columns="3"]
click to copy

view demo

Same as above but overwrite text on year, month, day, day of week
[bsk-pdfm-selector-columns 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" columns="3"]
click to copy

view demo

display the most recent 15 PDFs/documents in selected category, show year filter above PDFs/documents
[bsk-pdfm-selector-columns cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" pdfs_per_page="16" date_weekday_filter="Y-D" date_weekday_filter_order="DESC-ASC" columns="4"]
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-columns 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-columns 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"]
click to copy

view demo

display year and month as query filter
[bsk-pdfm-selector-columns 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-columns 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-columns 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-columns cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" order_by="date" order="DESC" extension_filter="ALL" columns="2"]
click to copy

view demo

Display all categoires that have PDFs/documents in selector, display PDFs/documents in selected category in 2 columns 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-columns cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" order_by="date" order="DESC" extension_filter="ALL" extension_filter_default="pdf" columns="3"]
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-columns cat_id="ALL" default_cat_id="1" hide_empty_cat="yes" order_by="date" order="DESC" extension_filter="ALL_EXISTED" columns="4"]
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-columns cat_id="1,2,6,12,17" default_cat_id="1" extension_filter="SPECIFIC" extension_filter_specific="pdf,zip,doc,docx" columns="3"]
click to copy

view demo

Show specifc extensions for selected category, the extensions given by extension_filter_specific
[bsk-pdfm-selector-columns 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" columns="4"]
click to copy

view demo

Show specifc extensions with labels. Labes will be shown above PDFs/documents instead extensions.
[bsk-pdfm-selector-columns cat_id="1,2,6,17" default_cat_id="1" extension_filter="ALL_EXISTED" extension_filter_only="yes" show_count_desc="yes" columns="3"]
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-columns 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 in 2 columns 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-columns 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" columns="3"]
click to copy

view demo

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

view demo

Only show first char of title of existed PDFs/documents as filter, PDFs/documents in 3 columns.
[bsk-pdfm-selector-columns 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" columns="4"]
click to copy

view demo

Display all available first 3 chars of title of existed PDFs/documents in 3 columns as filter above PDFs/documents
[bsk-pdfm-selector-columns 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" columns="4"]
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-columns 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-columns 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-columns 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-columns columns="4" 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-columns columns="3" 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-columns cat_id="ALL" output_container_class="my_idenfity_PDFs_container_class"]

Filters & Hooks

Filters & Hooks

Purchase BSK PDF Manager Pro