Documents
Using the Documents Widgets
The documents widgets are used to create lists of downloadable documents. Individual document items need to be nested within document lists. See the diagram below to get a better idea of how this works:
Documents Widgets Nesting
DOCUMENTS: List
This widget "encloses" the downloadable document links within the page. You can have multiple separate document lists within the same page, each enclosed between the list-start and list-end widget directives. The first Document Item is placed automatically inside the list.
Syntax
<w:documents/list-start />
DOCUMENT ITEM
<w:documents/list-end />
Attributes
- This widget does not include any attributes
DOCUMENTS: Item
This widget lets you include a downloadable document within the page. You need to add the document Items within the document List. The document is then automatically linked for download.
Note:
If adding a single document for download you still need to put it inside the documents list. You can think of this as a list of one document.
Syntax
<w:documents/item link="REPLACE" title="REPLACE" show-size="yes|no" description="REPLACE" />
Attributes
- link="REPLACE"
Path to the document you wish to enable for download. Use the Link to File button to upload, locate and select the document. - title="REPLACE"
This attribute creates a "tool-tip" for the link. It is useful for Search Engines to classify the destination of the link. - show-size="yes|no"
If set to yes, the widget will automatically include the file size behind the download link. It is very helpful to show the download file size to the visitors especially with larger downloads. - description="REPLACE" optional
Include the document description. This attribute is optional. Simply delete the REPLACE text and leave the empty quotes or delete the entire attribute if no description is necessary.
