====== Project-level Optional Property: Page Resources ======

You create lists of resources using the **Resource files/links** page-level optional property. This optional property enables you to customise the settings for and appearance of those lists of resources.

===== Editor interface =====

{{ :playground:page_resources.jpg?direct&600 |}}


===== Properties =====

^ Property ^ Sub-property ^ Description ^ Type ^
| Title || The title that is displayed at the top of each list of resources. | Text  |
| Text || Text (and other content) displayed below the title.  | Text+ (Toolbar)  |
| Files | Open in | { **This window** / New window / Lightbox }  Determines how a file is displayed when it is opened.  | Drop-down  |
| ::: | Always allow Download | Determines whether the download file button is shown for some file types (e.g. PDFs).  If the file type cannot open in the browser (e.g. Word Docs in Chrome) the download button will always show, even if download is off.  | Tick box  |
| ::: | File Extensions for Download Only | Some files that cannot be viewed in the browser will only have a download option.  Add a comma-separated list of files types that should always be available for download (by default dox, docx, xls, xlsx, ppt pptx are already only available for download.  | Text  |
| URLs | Open in | { **This window** / New window / Lightbox }  Determines how a webpage is displayed when it is opened. | Drop-down  |
| Resources icons || Include an icon in the first column of the resources list, to indicate what type of resource it is.  | Tick box  |
| Completion  | Track completion  | Add if you want learners to open __all__ the resources.  Adds a **Mark as complete** column, with boxes for learners to tick when they have  | Tick box  |
| ::: | Percentage text | The text which indicates which percentage of resources have been marked as complete. | Text |
| ::: | Warning | A warning displayed if a learner attempts to move to another page before marking all items as complete. If this icon is ticked, two sub-properties are displayed in the editor, allowing you to edit the title and text of the warning pop-up.  | Tick box |
| Button | Appearance  | This relates to the button displayed in the header, for pages which have had resources added. {**Icon only** / Icon and text }  If you select **Icon and text**, and you have also selected **Track Completion**,  the learner can see how many of the resources have been marked as complete, without having to open the Resources lightbox.  | Drop-down  |
| ::: | Customise icon  | Allows you to choose a different icon for the button.  | Tick box  |
| ::: | Icon | Choose your icon here.  | Link to icon library |