Description

Pryxo Document Listing & Category Filter adds a WordPress document manager and four ways to display your documents on the frontend: a [pryxdoli_documents] shortcode (works in the Classic Editor, text widgets, or any theme template), a Gutenberg block, an Elementor widget, and a WPBakery Page Builder element — for displaying PDF and file resources in a clean card, grid, or list layout.

The plugin works standalone; Elementor and WPBakery are entirely optional. If Elementor is active, the “Pryxo Document Listing” widget is registered automatically. If WPBakery is active, the “Pryxo Document Listing” element appears in its element list automatically. Neither is required to use the shortcode or the Gutenberg block.

Features include:

Backend document management with document categories.
PDF/file upload or HTTP(S) URL field.
Administrator-only document management by default.
HTTP(S)-only URL validation with common executable and active-content extensions blocked.
Per-document left and right icon selection from the full WordPress Dashicons library (~350 icons), with search.
Works with any editor: [pryxdoli_documents] shortcode, a Gutenberg block, an Elementor widget, and a WPBakery element.
A point-and-click Shortcode Builder admin page that generates a ready-to-paste shortcode.
One global Style Settings page (colors, borders, shadows, typography, hover effects, pagination) that applies to every listing, regardless of which builder displays it.
Optional background color/image per document card, and per listing section, overriding the global default.
Multi-category filtering (exclude specific categories per instance).
Optional All filter choice.
Optional default category when the All choice is disabled.
List or responsive grid layout.
Desktop, tablet, and mobile column controls.
Client-side items-per-page pagination.

Privacy note: The plugin does not send data to external services and does not include analytics or tracking. Document links displayed on the frontend are public links.

Blocks

This plugin provides 1 block.

Pryxo Document Listing Display a filterable, paginated listing of documents managed by Pryxo Document Listing & Category Filter.

Installation

Upload the Pryxo Document Listing & Category Filter plugin ZIP through Plugins > Add New > Upload Plugin, or install it from the WordPress Plugin Directory when available.
Activate Pryxo Document Listing & Category Filter.
Go to Pryxo Document Listing > Document Categories and create categories.
Go to Pryxo Document Listing > Add New and add documents.
Optional: go to Pryxo Document Listing > Style Settings to set colors, borders, typography, and hover effects for every listing on your site.
Display the listing using any of the following:
- Go to Pryxo Document Listing > Shortcode Builder, configure the options, and copy the generated shortcode.
- Add the [pryxdoli_documents] shortcode directly to any post, page, text widget, or theme template.
- Add the “Pryxo Document Listing” block in the block editor.
- If Elementor is active, edit a page with Elementor and add the Pryxo Document Listing widget.
- If WPBakery Page Builder is active, add the “Pryxo Document Listing” element from its Content group.

FAQ

Does this require Elementor or WPBakery?: No. The plugin works on its own with the [pryxdoli_documents] shortcode and the Gutenberg block. Elementor and WPBakery integrations are optional bonuses: if either page builder is active, its respective widget/element is registered automatically — no configuration needed.
What attributes does the shortcode support?: [pryxdoli_documents] supports: exclude_categories (comma-separated category IDs or slugs), default_category (ID or slug), show_filter, filter_label, show_all_option, all_text, items_per_page, pagination, link_target (_blank or _self), orderby (date, title, or menu_order), order (ASC or DESC), layout (grid or list), columns, columns_tablet, columns_mobile, column_gap, row_gap, and class. Example: [pryxdoli_documents exclude_categories="12,forms" columns="3" show_all_option="no" default_category="guides"].
Is there a block for the block editor?: Yes. Search for “Pryxo Document Listing” in the block inserter. It offers the same filtering, layout, and pagination options as the shortcode through the block’s sidebar settings.
Do I have to write the shortcode by hand?: No. Go to Pryxo Document Listing > Shortcode Builder, configure the categories, filter, layout, pagination, and background options with a form, and copy the generated shortcode.
Where do I change colors, borders, and hover effects?: Go to Pryxo Document Listing > Style Settings. It is a single, global set of style controls (Document Box, Category Filter, Pagination) that applies to every listing on your site no matter which builder displays it, so you only style your documents once.
Does it work with WPBakery Page Builder?: Yes. When WPBakery is active, “Pryxo Document Listing” appears as a regular element in its Content group with the same options as the shortcode, including WPBakery’s custom CSS box.
Can I upload PDFs?: Yes. Each document has a file upload/select button and also accepts HTTP(S) external file URLs.
Can I give a document its own background image or color?: Yes. Each document’s edit screen has a Card Background Image and Card Background Color field. Set either (or both) to override the global card background from Style Settings for that one document — handy for featuring or highlighting specific documents.
Can I add a background image or color behind the whole listing?: Yes. The shortcode accepts bg_color and bg_image attributes, the Shortcode Builder has matching fields, and the Gutenberg block, Elementor widget, and WPBakery element each have their own Section Background controls.
Can a document have no icon at all?: Yes. Choose “None” at the top of the icon picker for the left and/or right icon.
Can I use this for private or confidential documents?: No. Files linked by the listing are public. Use a dedicated protected-download or membership solution for confidential documents.
Can I filter by multiple categories?: Yes. Visitors can select multiple categories in the frontend filter.
Can I remove the All option from the filter?: Yes. Disable Show All Option (or pass show_all_option="no" to the shortcode) and choose a Default Category. The selected category is shown when the page first loads.
Can I hide specific document categories from one listing?: Yes. Use the Exclude Document Categories control (or the exclude_categories shortcode attribute) on each instance.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Pryxo Document Listing & Category Filter” is open source software. The following people have contributed to this plugin.

Pryxo Tech

Translate “Pryxo Document Listing & Category Filter” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.7.0

Overlay Opacity now uses the CSS 0 to 1 scale instead of 0 to 100, so 1 is solid, 0.5 is half, and steps of 0.01 are accepted. Previously an entry of 1 meant one percent, which looked like the overlay was doing nothing.
Existing overlay opacity values are converted automatically on update; anything above 1 is divided by 100, so a stored 50 becomes 0.5.
Fixed document boxes darkening on hover when only a normal-state overlay was set. The hover layer is now skipped when it resolves to the same thing as the normal layer, instead of stacking two identical translucent layers.

1.6.0

Added a Layout & Spacing section to Style Settings: gap between the filter bar and the listing, grid column gap, grid row gap, list-view item gap, and the gap above pagination.
Grid view and List view now have independent spacing, so switching layout no longer inherits the other layout’s gap.
A gap set on an individual Elementor widget or shortcode instance still overrides the site-wide value.
Shortcode column_gap and row_gap values are now validated as CSS lengths; a bare number is read as pixels.

1.5.0

Card background images now have separate Normal and Hover states. Each state has its own image, background color, size, position, repeat, overlay color, and overlay opacity.
Added the same background controls to Style Settings under Document Box Background Image, so one setting covers every document box on the site.
The per-document background fields on the Edit Document screen now mirror the Style Settings controls exactly. Any control left empty falls back to the global value, so a document can override only what it needs.
Hover backgrounds cross-fade instead of swapping instantly, and honour the visitor’s reduced-motion preference.
Added an overlay tint so titles and icons stay readable over busy photos.

1.4.0

Added an optional background image and/or color per document card, overriding the global default from Style Settings for that document only.
Added an optional background image and/or color for the whole listing section, settable in the shortcode (bg_color, bg_image), the Shortcode Builder, the Gutenberg block, the Elementor widget, and the WPBakery element.

1.3.0

Added a Shortcode Builder admin page (Pryxo Document Listing > Shortcode Builder) that generates a ready-to-paste shortcode from a form.
Added a global Style Settings page (Pryxo Document Listing > Style Settings): colors, borders, box shadow, typography, icon size, hover effects, filter styling, and pagination styling, shared by every builder.
Moved styling out of the Elementor widget’s Style tab into the new global Style Settings page, so the same visual theme now applies consistently across the shortcode, block, Elementor, and WPBakery — previously, styling only worked in Elementor.
Added a “None” choice to the icon picker so a document can have no left and/or right icon.

1.2.0

Removed the hard Elementor dependency. The plugin now activates and works standalone via the shortcode and Gutenberg block.
Added a WPBakery Page Builder element (“Pryxo Document Listing”) mapped onto the existing shortcode.
Elementor and WPBakery integrations now register only when their respective plugin is active; neither is required.
Switched the icon library from Font Awesome to WordPress core Dashicons, so icons always render on every site with no bundled or third-party assets. A small number of presets without a Dashicons equivalent were removed; existing documents using a removed preset fall back to the default icon.
Expanded the icon picker to the full set of ~350 WordPress core Dashicons (previously a curated subset of ~35), so users can choose any icon that fits their content.

1.1.0

Added a [pryxdoli_documents] shortcode as a display option alongside the Elementor widget.
Added a Gutenberg block (“Pryxo Document Listing”) with matching filter, layout, and pagination controls.
Refactored listing rendering into a shared internal renderer used by the widget, shortcode, and block.

1.0.7

Raised the minimum WordPress version to 6.5 so the Elementor dependency notice (Requires Plugins) is enforced correctly.
Removed leftover unused widget control code.

1.0.6

Added an option to show or hide the All filter choice.
Added a default category option when All is disabled.
Improved frontend initialization for Elementor-rendered widgets.
Localized frontend and media-library interface strings.
Declared Elementor as a plugin dependency.
Added uninstall cleanup for plugin options and administrator capabilities.
Updated WordPress.org metadata and documentation.

1.0.5

Restricted document and category management to plugin-specific administrator capabilities.
Disabled unnecessary REST API exposure for the private document post type and taxonomy.
Restricted document URLs to HTTP(S) and blocked common executable/active-content extensions.
Revalidated stored URLs during frontend rendering.
Escaped localized admin modal text before HTML insertion.
Added a public-document security notice in the document editor.

1.0.4

Added a backend Document Category filter on the All Documents admin list.

1.0.3

Changed the category dropdown back to overlay style.
Fixed dropdown stacking so document item titles stay behind the dropdown.

1.0.2

Fixed category dropdown overlap with document titles.
Improved frontend Font Awesome icon loading.
Added filter box text, hover, dropdown, checkbox, width, typography, and spacing style controls.

1.0.1

Added visual icon library popup for document icons.
Added document box background overlay controls.
Added separate whole-item and right-icon hover animation controls.

1.0.0

Initial release.

Description

Blocks

Installation

FAQ

Does this require Elementor or WPBakery?

What attributes does the shortcode support?

Is there a block for the block editor?

Do I have to write the shortcode by hand?

Where do I change colors, borders, and hover effects?

Does it work with WPBakery Page Builder?

Can I upload PDFs?

Can I give a document its own background image or color?

Can I add a background image or color behind the whole listing?

Can a document have no icon at all?

Can I use this for private or confidential documents?

Can I filter by multiple categories?

Can I remove the All option from the filter?

Can I hide specific document categories from one listing?