The Document Libraries module is great for collecting and presenting groups of documents about one subject or the whole council or city. The module uses the OC Module Interface and OC Document content types to create a document listing and entries.
The Document Library listing is built to present multiple documents efficiently. The listing presents in a stream and alphabetical order, with an accordion entry for each OC Document page. Each accordion expands to reveal any WYSIWYG content, and each document is attached to the page. Two WYSIWYG Editors are on the listing page for introductory or supplemental content and a search function allowing your community to search documents by keyword.
Document Library listings can be used for different purposes. We've seen some councils or cities use them to create an overall listing of all their forms and documents and link them to their Top Tasks, creating a pathway to find key forms easily.
We've also seen their use in listing documents from just one site section, such as listing all the governance policies, budgets, and other financial documents by year. Organizing your documents will depend on which template you use for your listing page.
Create a Document Library Listing Page
- Right-click in the site tree where you want to create your listing page.
- Select Create Page.
- Choose the OC Module Interface content type.
- Select the OC Document Library - Global or OC Document Library - Relative template from the Template Name drop-down menu.
- Fill out the necessary fields on your listing page.
- Save and Publish your page.
Document Library Templates
There are two templates for document libraries. Each template will show accordion panels with the document title for each OC Document page. Both templates have a search function that your community can use to search for a document by phrase or keyword.
OC Document Library - Global
This template lists all document pages created on your site, regardless of where they exist in the site tree. It’s best practice, though, to make OC Document pages child pages of this listing page so they’re easy to find.
- Stream layout.
- Search function on the right.
- 2 WYSIWYG content areas.
- Organized alphabetically.
- Use for an overall forms, policies, and documents listing, which can apply to your whole site.
OC Document Library - Relative
This template only lists document pages that are direct child pages of your listing page.
- Stream layout.
- Search function on the right.
- 2 WYSIWYG content areas.
- Organized alphabetically.
- Use for listing forms, policies, or documents that fall under one section, such as government policies or financial documents.
Document Library Listing Order
Both of the document library listing templates display documents in alphabetical order. A common request we've seen is to change this to a sequential order which mirrors your site tree. Here's how to do this: