1. Document Library Pro
  2. Document Library Options

Document folders

The folders option in Document Library Pro controls the overall structure of your document libraries.

Folders disabled

This is the default option and lists all your documents together, regardless of their category. You can disable folders on the plugin settings page, or by adding folders="false" to the shortcode, for example: [doc_library folders="false"]

Folders enabled

This structures your document library into a hierarchical folder tree structure listing the document categories, sub-categories, and so on. The tree view allows users to drill down into the document library by category.

When the user clicks on a folder, they will see a list of documents from that category and/or folders for the sub-categories. The user can then click on a sub-category to view a list of documents in the sub-category, and so on.

The folders are collapsible and only one folder will ever be open at a time. This helps to make the document library easy to navigate, so that the user never gets lost.

You can enable folders on the plugin settings page, or by adding folders="true" to the shortcode, for example: [doc_library folders="true"]

FAQ

Does it support sub-categories?

Yes, sub-categories will be indented to show the folder structure. You can have as many levels of categories as you like, and the child categories will always be nested under their parent category. Of course, this assumes that the page is wide enough to accommodate deep category structures with many levels!

If a category has documents AND sub-categories, then it will show like this:

  • Category 1
    • List of documents that are in category 1 but not any of its sub-categories
    • Category 1a name and folder icon
      • List of documents in category 1a

How are the categories ordered?

The order of the folders can be changed from the Documents → Settings → Folders subsection. Simply select the 'Sort by' factor and the direction (order) from the drop-down lists.

For the 'sort by' option, you can choose to order by name, category ID, category slug, category order (menu order), and the number of terms.  For the direction, you can set it as ascending or descending.

Can a document appear in multiple folders?

Yes, if a document is in multiple categories then it will appear in multiple folders, under each of its categories. The exception is if it is in a parent category and its child category, in which case it will only appear in the child category.

Can I add a search option to the folder view?

Yes, if you enable the search box on the plugin settings page then this will appear above the list of folders. That way, users can search within all the folders at once.

The results will appear as a flat list of documents and will not be structured into folders. Users can use the 'Reset' button to return to the folder review.

Can I exclude specific categories from the folders list?

Yes, please see our article about how to edit the shortcode to control which documents to include and exclude. This includes options on excluding specific categories or sub-categories.

Related Articles

If searching the knowledge base hasn't answered your question, please contact support.