Topics Map > UW Theme Functionality > Custom Post Types
WiscWeb - Using a Documents List
In this document:
Purpose and use
The Documents Listing page element will allow you to display a list of documents on a page. This page element can be used on a one-, two-, and three-column layout on your page.
This page element is useful for displaying documents like:
- Monthly meeting minutes
- Agendas
- Historical documents
Each document that you want to use on the page will have to have an associated Document custom post, which contains details about the document. You then choose which documents you want to display on a page by using the Documents Listing page element.
Document Pages use Document Types. They function similarly to Categories, but they are used specifically for documents. If you are maintaining a site which logs monthly minutes for a several meetings, you can create different Document Types (e.g. Staff Meeting and Student Meeting) for each meeting. This allows you to display just Staff Meeting minutes on one page, and just Student Meeting minutes on another.
The intent is to showcase a specific document (e.g. project charter, department mission statement) or set of Document Types (e.g. meeting minutes) for easy download or linking. When there is not a need to showcase or categorize, you can always just add documents as links in Text Blocks: WiscWeb - Text Block Page Element
Creating a Document post
Before displaying any Documents on pages with the listing page element, you must first create the custom posts themselves. Access these by clicking on Documents Page in the left hand column of your main WordPress administrator screen.
- Click Add New to create a new document post
- Add a Document Title
- Provide a relevant Document Summary for this particular document
- You can add a Document File to this particular document post
- Please note: If you add a document file through this option, the site visitors will not be redirected to the Document Post itself, but rather will open or download the attached file (based on browser preference).
- Add further information, context, and even images to this document post.
- Please note: If you would rather have site visitors come to this post before being able to download a document, you can instead link to it in this text block.
- On the right, apply any Document Type values that you would like to, including creating new document type values by clicking on the Add Document Type link and giving it a value.
- Document Types allow you to categorize your document posts and control what displays on any given page using the Documents Listing page element. For example, if you wanted a page with meeting minutes, you could create document post with those meeting minute documents, add the Document Type "Meeting Minutes" to all of them.
- Document Types allow you to categorize your document posts and control what displays on any given page using the Documents Listing page element. For example, if you wanted a page with meeting minutes, you could create document post with those meeting minute documents, add the Document Type "Meeting Minutes" to all of them.
- Once you have made your edits, click the Publish button.
Adding the Documents Listing page element
To add the Documents Listing page element, navigate to your page and the column layout you want to add it to.
- Click the Add Page Element button
- Choose Documents Listing
- Give this page element a Title
- Choose what types of documents you want to be displayed (All documents, documents by type, or individual documents)
- Choose if you want to Include Summary
- Publish or Update your page to display this list