About the Documents Module

The Documents Module produces a list of documents with links to view or download the document (depending on the user's browser settings). Documents can be located within the portal, or can be a link to another website or portal.

The document title, category, description, document owner, name of the user who created the document, the user who last updated the document, creation date, the date that the document was added or last updated, and the file size (internal documents only) are available for each listing. Link click tracking and logging are also available.

In the module settings page, you can configure the columns that are displayed, the column order and the sort order of the documents listed. The documents module supports the DotNetNuke core "secure storage" feature, so that documents stored securely are not available to unauthorized users.

Document Module Settings

1. Use Documents Categories List: Sets whether to use a free-text field for the document category field, or use a list defined in the Host->Lists page. If you want to use a drop-down list, create a list in the Lists page called "Document Categories".
2. Show Title Link: Sets whether or not to show the document title (if included in the display columns) as a hyperlink to the document.
3. Display Columns: Sets which columns to display, and allows you to set what order to display the columns in.
4. Sorting: Sets the sort order that documents are displayed in. You can add multiple sort orders to add more than one "key" to sort by.

Add a Document

1. Add a Documents module, or go to an existing Documents module.
2. Click Add New Document.
3. At Title, enter a title for the document.
4. At Link Type, select URL or File and then at Link select or enter the required URL or file.
5. At Track Number Of Times This Link Is Clicked? (optional), check the box if required.
6. At Log The User, Date, And Time For Every Link Click (optional), check the box if required.
7. At Category (optional), enter a category for the document.
8. Click Update.

CSS Styling for the Documents Module

The documents module renders an "outside" DIV tag with a CLASS attribute of "DNN_Documents". Each header cell has a CLASS attribute of [Name]Header, where [Name] is the column name - for example "TitleHeader", "SizeHeader", "CategoryHeader". Each data cell has a CLASS attribute of [Name]Item, for example "TitleItem", "SizeItem", "CategoryItem".

This allows skin developers to control the CSS style of individual columns. For example, use the following CSS to render the size column in red and set the column width to 50 pixels:

  .DNN_Documents .SizeItem {color: red; width: 50px}