Display all / specific PDFs / documents in dropdown

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

Shortcodes

[bsk-pdfm-pdfs-dropdown]

Common uses

All PDFs in dropdown with date weekday filter

[bsk-pdfm-pdfs-dropdown id="ALL" exclude_id="50, 51, 52, 53, 54, 55, 56, 57" order_by="date" order="DESC" show_date="yes" date_format="l - " date_before_title="yes" date_weekday_filter="Y-m-l" date_weekday_filter_order="DESC-ASC-ASC" date_weekday_filter_right="yes"]

view demo

Shortcode attributes table

You may use none, one or multiple attributes to shortcode.

Attribute	Values	Default
id	integer value, ALL
exclude_id	integer value
extension	supported extnsions on setting page

Examples	Description
[bsk-pdfm-pdfs-dropdown id="7,8,9,10,11,12"] click to copy view demo	show PDF/document with specifc id of: 7,8,9,10,11,12 in dropdown
[bsk-pdfm-pdfs-dropdown id="ALL" exclude_id="3,4,5,8"] click to copy view demo	show all PDF/documents but exclude id in( 3,4,5,8 ) in dropdown
[bsk-pdfm-pdfs-dropdown id="ALL" exclude_id="3,4,5,8" columns="3" extension="mp3"] click to copy view demo	show mp3 files
[bsk-pdfm-pdfs-dropdown id="ALL" exclude_id="3,4,5,8" columns="3" extension="mp3,flac,wav"] click to copy view demo	show audio files

Attribute	Values	Default
option_none	any string	Select to open...
target	_blank	_blank

Examples	Description
[bsk-pdfm-pdfs-dropdown id="7,8,9,10,11,12"] click to copy view demo	show PDF/document with specifc id of: 7,8,9,10,11,12 in dropdown, open PDF/document in new window/tab when dropdown selected change
[bsk-pdfm-pdfs-dropdown id="7,8,9,10,11,12" option_none="selezionare per aprire"] click to copy view demo	show PDF/document with specifc id of: 7,8,9,10,11,12 in dropdown, open PDF/document in new window/tab when dropdown selected change * The default text on select is overwritten
[bsk-pdfm-pdfs-dropdown id="7,8,9,10,11,12" target=""] click to copy view demo	show PDF/document with specifc id of: 7,8,9,10,11,12 in dropdown, open PDF/document in current window/tab when dropdown selected change

Attribute	Values	Default
order_by	title, date, custom, id	title
order	ASC, DESC	ASC

Examples	Description
[bsk-pdfm-pdfs-dropdown id="ALL" order_by="title" order="ASC"] click to copy view demo	display all PDFs/documents order by title in ascending
[bsk-pdfm-pdfs-dropdown id="ALL" order_by="date" order="DESC"] click to copy view demo	display all PDFs/documents order by date in descending
[bsk-pdfm-pdfs-dropdown id="7,8,9,1,2,3,4,5,6" order_by="custom" order="ASC"] click to copy view demo	display specific PDFs/documents of id=7,8,9,1,2,3,4,5,6 order by customer order * Check for how to set custom order >>
[bsk-pdfm-pdfs-dropdown id="7,8,9,1,2,3,4,5,6" order_by="id" order="DESC"] click to copy view demo	display specific PDFs/documents of id=7,8,9,1,2,3,4,5,6 order by id descending * so the PDFs/documents order when display is id: 9,8,7,6,5,4,3,2,1
[bsk-pdfm-pdfs-dropdown id="7,8,9,1,2,3,4,5,6" order_by=""] click to copy view demo	display specific PDFs/documents of id=7,8,9,1,2,3,4,5,6 in same order as id sequence * it means the one of id=7 will be first and id=6 will be last

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-pdfs-dropdown id="ALL" order_by="date" order="DESC" most_top="20" ] click to copy view demo	show the most recent 20 PDFs/documents in dropdown
[bsk-pdfm-pdfs-dropdown id="ALL" year_of="2017-2019"] click to copy view demo	only show PDFs/documents which date between 2017-01-01 and 2019-12-31.
[bsk-pdfm-pdfs-dropdown id="ALL" year_of="2017" month_of="06"] click to copy view demo	only show PDFs/documents which date in Jun, 2017
[bsk-pdfm-pdfs-dropdown id="ALL" day_of="11"] click to copy view demo	only show PDFs/documents which date day of 11, donot care year or month
[bsk-pdfm-pdfs-dropdown id="ALL" 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
[bsk-pdfm-pdfs-dropdown id="ALL" weekday_of="MON"] click to copy view demo	only show PDFs/documents which date is Monday, donot care year, month or day )

Attribute	Values	Default
search_bar	KEYWORDS, YEAR_KEYWORDS
search_bar_year_range	year-year( ex: 2012-2020 ), APPLIED
search_bar_year_order	ASC, DESC	DESC
search_bar_keywords_match_type_default	EXACTLY, PARTIALLY	PARTIALLY
search_bar_show_keywords_match_choice	yes	no
search_bar_only	yes	no
search_bar_placeholder	any string	Keywords
search_bar_year_option_none	any string	Any Year
search_bar_reset_text	any string	Reset
search_bar_button_text	any string	Search
search_bar_keywords_match_choice_desc_text	any string	Keywords match type
search_bar_keywords_match_choice_partially_text	any string	Partially
search_bar_keywords_match_choice_exactly_text	any string	Exactly

Examples	Description
[bsk-pdfm-pdfs-dropdown id="ALL" search_bar="KEYWORDS"] click to copy view demo	display all PDFs/documents with search bar eanbled, the search bar only have keywords field
[bsk-pdfm-pdfs-dropdown id="ALL" search_bar="YEAR_KEYWORDS" search_bar_year_range="2015-2018" search_bar_year_order="ASC"] click to copy view demo	define the year range from 2015 to 2018 for year dropdown in serch bar, show years in ascending order
[bsk-pdfm-pdfs-dropdown id="ALL" pdfs_per_page="10" search_bar="YEAR_KEYWORDS" search_bar_show_keywords_match_choice="yes"] click to copy view demo	Show keywords match chocie select, exactly match only return PDF / document whose filename / title / description same as the keyword
[bsk-pdfm-pdfs-dropdown id="ALL" search_bar="YEAR_KEYWORDS" search_bar_year_range="APPLIED" search_bar_year_order="ASC" search_bar_placeholder="Cerca la rassegna stampa" search_bar_year_option_none="Anno" search_bar_button_text="Ricerca"] click to copy view demo	list all years that applied to documents for year dropdown in serch bar, show years in ascending order * the text on keyword input and year select and button will be overwritten
[bsk-pdfm-pdfs-dropdown id="ALL" search_bar_only="yes" search_bar="KEYWORDS" show_count_desc="yes"] click to copy view demo	display search bar only and show results count
[bsk-pdfm-pdfs-dropdown id="ALL" search_bar_only="yes" search_bar="KEYWORDS" show_count_desc="yes" count_desc_singular="Total: %d" count_desc_plural="Total: %d"] click to copy view demo	display search bar only and show results count with custom text

* You may use search_bar_placeholder and search_bar_year_option_none to overwrite text on keyword input and year select

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-pdfs-dropdown id="ALL" search_bar="KEYWORDS" show_count_desc="yes"] click to copy view demo	display search bar and show results count
[bsk-pdfm-pdfs-dropdown id="ALL" 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

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-pdfs-dropdown id="40,111,113,114" show_date="yes"] click to copy view demo	append PDFs/documents date with default format( d/m/Y, example: 25/02/2020 ) after title.
[bsk-pdfm-pdfs-dropdown id="40,111,113,114" show_date="yes" date_format="--F d, Y" date_prefix="Published on: "] click to copy view demo	append PDFs/document date with custom format( F d, Y, example: February 25, 2020 ) after title. And display "Published on: " before PDF date.
[bsk-pdfm-pdfs-dropdown id="40,111,113,114" show_date="yes" date_format="Y-m-d " date_before_title="yes"] click to copy view demo	add PDFs/documents date with custom format( Y-m-d, example: 2020-02-25 ) 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-pdfs-dropdown id="ALL" 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 date weekday fitler above PDF list on right. * The date_weekday_filter & date_weekday_filter_order separated by - and can use one or all of them
[bsk-pdfm-pdfs-dropdown id="ALL" 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	display date weekday fitler above PDF list on right. * The text on year, month, day, day of week selects were overwritten
[bsk-pdfm-pdfs-dropdown id="ALL" date_weekday_filter="Y" date_weekday_filter_order="DESC"] click to copy view demo	only show year in filter
[bsk-pdfm-pdfs-dropdown id="ALL" date_weekday_filter="Y-D" date_weekday_filter_order="DESC-ASC"] click to copy view demo	show year and weekday in filter
[bsk-pdfm-pdfs-dropdown id="ALL" date_weekday_filter="m-D" date_weekday_filter_order="DESC-ASC" date_weekday_filter_right="yes"] click to copy view demo	show month and weekday in filter, month in descinding and weekday in ascending order

* 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-pdfs-dropdown id="ALL" order_by="date" order="DESC" date_weekday_query_filter="ALL_EXISTED" pdfs_per_page="10"] click to copy view demo	display date weekday query filter above PDFs, change dropdown to query PDFs with selected year, monthy, day and day of week
[bsk-pdfm-pdfs-dropdown id="ALL" 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-pdfs-dropdown id="ALL" 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-pdfs-dropdown id="ALL" order_by="date" order="DESC" extension_filter="ALL"] click to copy view demo	display all supported extensions above PDFs/documents list
[bsk-pdfm-pdfs-dropdown id="ALL" order_by="date" order="DESC" extension_filter="ALL" extension_filter_default="pdf"] click to copy view demo	display all supported extensions above PDFs/documents list. Default to show PDFs/documents with .pdf
[bsk-pdfm-pdfs-dropdown id="ALL" order_by="date" order="DESC" extension_filter="ALL_EXISTED"] click to copy view demo	only show extensions that have PDFs/documents managed. Extension filer bar placed above PDFs/documents results
[bsk-pdfm-pdfs-dropdown id="ALL" extension_filter="SPECIFIC" extension_filter_specific="pdf,zip,doc,docx"] click to copy view demo	show specifc extensions, the extension given by extension_filter_specific
[bsk-pdfm-pdfs-dropdown id="ALL" 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
[bsk-pdfm-pdfs-dropdown id="ALL" extension_filter="ALL_EXISTED" extension_filter_only="yes" show_count_desc="yes"] click to copy view demo	only show extensions bar that have PDFs/documents managed, without PDFs/documents. 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-pdfs-dropdown id="ALL" order_by="date" order="DESC" title_filter="ALPHABET"] click to copy view demo	display alphabet( A - Z ) as title start filter above PDFs/documents list
[bsk-pdfm-pdfs-dropdown id="ALL" order_by="date" order="DESC" title_filter="ALPHABET" title_filter_default="C" ] click to copy view demo	display alphabet( A - Z ) as title start filter, show documents start with A at first
[bsk-pdfm-pdfs-dropdown id="ALL" order_by="date" order="DESC" title_filter="ALPHABET_EXISTED"] click to copy view demo	display all available first char from database as title start filter above PDFs/documents list
[bsk-pdfm-pdfs-dropdown id="ALL" 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 from database as title start filter above PDFs/documents list
[bsk-pdfm-pdfs-dropdown id="ALL" 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 from database( and exclude In, Se ) as title start filter above PDFs/documents list
[bsk-pdfm-pdfs-dropdown id="ALL" title_filter="SPECIFIC" title_filter_specific="Traffic,Board" title_filter_default="Board"] click to copy view demo	show specifc title start string to filter documents, given by title_filter_specific
[bsk-pdfm-pdfs-dropdown id="ALL" title_filter="SPECIFIC" title_filter_specific="Traffic,Board" title_filter_only="yes" show_count_desc="yes"] click to copy view demo	show specifc title start string to filter documents, only show PDFs/documents after filter clicked, also show results count.

* 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-pdfs-dropdown id="ALL" order_by="date" order="DESC" tags="ALL" tags_order_by="date" tags_order="DESC"] click to copy view demo	display all tags
[bsk-pdfm-pdfs-dropdown id="ALL" 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-pdfs-dropdown id="ALL" 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-pdfs-dropdown id="ALL" output_container_class="my_idenfity_PDFs_container_class"]

Filters & Hooks

Purchase BSK PDF Manager Pro

Display all / specific PDFs / documents in dropdown

Shortcodes

Common uses

All PDFs in dropdown with date weekday filter

Shortcode attributes table

Advanced uses

Output container class

Filters & Hooks

Display all / specific

Display by category

Display with category selector

Embed PDF into Post / Page

Hooks

FAQ