Display all / specific PDFs / documents in list

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

There are two list types and you need call different shortcodes to display what you want.

Shortcodes

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

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

Common uses

show all PDFs order by date with pagination

[bsk-pdfm-pdfs-ul id="ALL" order_by="date" order="DESC" pdfs_per_page="20" target="_blank"]

view demo

show all PDFs order by date in ordered list with search bar, date filter and pagination

[bsk-pdfm-pdfs-ul id="ALL" order_by="date" order="DESC" pdfs_per_page="40" target="_blank" show_date="yes" date_format="l - " date_before_title="yes" search_bar="YEAR_KEYWORDS" search_bar_year_range="2015-2018" search_bar_year_order="DESC" date_weekday_filter="Y-M-D" date_weekday_filter_order="DESC-ASC-ASC" date_weekday_filter_right="yes"]

view demo

Specific PDFs in ordered list with featured image and description

[bsk-pdfm-pdfs-ol id="50, 51, 52, 53, 54, 55, 56, 57" featured_image="yes" order_by="date" order="DESC" show_pdf_title="yes" show_description="yes" target="_blank" show_date="yes" date_format="l - " date_before_title="yes"]

view demo

Shortcode attributes table

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

You may choose the features you want and then add associated 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-ul 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.
[bsk-pdfm-pdfs-ul 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 )
[bsk-pdfm-pdfs-ul id="ALL" extension="pdf"] click to copy view demo	show all PDFs
[bsk-pdfm-pdfs-ul id="ALL" extension="doc,docx,xlsx, pptx"] click to copy view demo	show all Microsoft Office files

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

Examples	Description
[bsk-pdfm-pdfs-ul id="ALL" order_by="title" order="ASC"] click to copy view demo	display all PDFs/documents order by title in ascending
[bsk-pdfm-pdfs-ul id="ALL" order_by="date" order="DESC"] click to copy view demo	display all PDFs/documents order by date in descending
[bsk-pdfm-pdfs-ul 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-ul 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-ul 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
link_only	yes, no	no
link_only_no_desc	yes, no	no
link_only_no_close	yes, no	no
url_only	yes, no	no
target	_blank
nofollow_tag	yes	no
noopener_tag	yes	no
noreferrer_tag	yes	no

Examples	Description
[bsk-pdfm-pdfs-ul id="1" link_only="yes"] click to copy view demo	display the link of PDF/document of id = 1, no list wrap output.
[bsk-pdfm-pdfs-ul id="1" link_only="yes" link_only_no_desc="yes"] click to copy view demo	display the FIRST PART of link of PDF/document of id = 1, no list wrap output. Eg: <a href="http://your_pdf">
[bsk-pdfm-pdfs-ul id="1" link_only="yes" link_only_no_close="yes"] click to copy view demo	display the link of PDF/document of id = 1 except the close tag <a/>, no list wrap output. Eg: <a href="http://your_pdf">PDF Title
[bsk-pdfm-pdfs-ul id="1" url_only="yes"] click to copy view demo	display the url of PDF/document of id = 1, no anchor or list wrap output.
[bsk-pdfm-pdfs-ul id="7" target="_blank"] click to copy view demo	display PDFs/documents link with target="_blank" attribute, it lets visitor open PDF/document in new window/tab
[bsk-pdfm-pdfs-ul id="7" nofollow_tag="yes"] click to copy view demo	display PDFs link with rel="nofollow" attribute. * nofollow is used by Google, to specify that the Google search spider should not follow that link
[bsk-pdfm-pdfs-ul id="7" noopener_tag="yes" noreferrer_tag="yes"] click to copy view demo	display PDFs link with rel="noopener noreferrer" attribute. * nofollow is used by Google, to specify that the Google search spider should not follow that link

Attribute	Values	Default
featured_image	yes, no	no
featured_image_size	thumbnail(and its "thumb" alias), medium, large, full	thumbnail
show_pdf_title	yes, no	no
image_position	left, right	left

Examples	Description
[bsk-pdfm-pdfs-ul id="52,54,56,44,60,61" featured_image="yes"] click to copy view demo	display featured images( deault size ) for PDFs/documents of special id
[bsk-pdfm-pdfs-ul id="52,56,55,57" featured_image="yes" featured_image_size="medium" show_pdf_title="yes" show_description="yes"] click to copy view demo	display medium size featured images, title and description for PDFs/documents of special id
[bsk-pdfm-pdfs-ul id="52,54,56,44,60,61" featured_image="yes" featured_image_size="medium" show_pdf_title="yes" image_position="right"] click to copy view demo	display medium size featured images for PDFs/documents together with title of special id, place featured image on right

* Check for how to register image size and set default image size >>

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

* 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-pdfs-ul id="ALL" order_by="date" order="DESC" pdfs_per_page="10"] click to copy view demo	display all PDFs/documents with pagination and every 10 PDFs/documents on each page
[bsk-pdfm-pdfs-ul id="ALL" 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
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-ul id="ALL" pdfs_per_page="10" 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-ul id="ALL" pdfs_per_page="10" 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-ul 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-ul id="ALL" pdfs_per_page="10" 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-ul 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-ul 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-ul id="ALL" search_bar="KEYWORDS" show_count_desc="yes"] click to copy view demo	display search bar and show results count
[bsk-pdfm-pdfs-ul 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
show_description	yes	no

Examples	Description
[bsk-pdfm-pdfs-ul id="40,111,113,114" show_date="yes"] click to copy view demo	show PDF/document date with default format( d/m/Y, example: 25/02/2020 ) after title.
[bsk-pdfm-pdfs-ul id="40,111,113,114" show_date="yes" date_format="--F d, Y"] click to copy view demo	show PDF date with custom format( F d, Y, example: February 25, 2020 ) after title.
[bsk-pdfm-pdfs-ul id="40,111,113,114" show_date="yes" date_format="Y-m-d " date_before_title="yes" date_prefix="Published on: "] click to copy view demo	show PDF date with custom format( Y-m-d, example: 2020-02-25 ) before title. And display "Published on: " before PDF date.
[bsk-pdfm-pdfs-ul id="56,52,55,57" show_description="yes"] click to copy view demo	display PDF/document 's description under 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-pdfs-ul 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-ul 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-ul id="ALL" date_weekday_filter="Y" date_weekday_filter_order="DESC"] click to copy view demo	only show year in filter
[bsk-pdfm-pdfs-ul 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-ul 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-ul 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-ul id="ALL" 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-pdfs-ul 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-ul 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" 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-pdfs-ul 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-ul 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-ul 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-ul 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-ul 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-ul 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-ul 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-ul 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-ul 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-ul 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-ul 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-ul 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-ul 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-ul 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-ul id="ALL" order_by="date" order="DESC" tags="ALL"] click to copy view demo	display all tags
[bsk-pdfm-pdfs-ul id="ALL" order_by="date" order="DESC" tags="ASSIGNED" tags_exclude="1,2" tags_align_right="yes" tags_order_by="date" tags_order="DESC"] 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-ul 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-ul id="ALL" output_container_class="my_idenfity_PDFs_container_class"]

Filters & Hooks

Purchase BSK PDF Manager Pro

Display all / specific PDFs / documents in list

Shortcodes

Common uses

show all PDFs order by date with pagination

show all PDFs order by date in ordered list with search bar, date filter and pagination

Specific PDFs in ordered list with featured image and description

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