optional_properties
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
optional_properties [2022/12/08 13:48] – yvonne_moore | optional_properties [2025/01/18 10:16] (current) – [Project-level Optional Properties] jsmith | ||
---|---|---|---|
Line 7: | Line 7: | ||
Optional properties are added from the right-hand pane in the page editor window, and will apply to that page. Removing an optional property will remove its functionality from that page and/or reset its configuration back to the default setting. | Optional properties are added from the right-hand pane in the page editor window, and will apply to that page. Removing an optional property will remove its functionality from that page and/or reset its configuration back to the default setting. | ||
- | ===== Project-level | + | There are three types of optional |
- | Some optional properties are also available at the project level on the project root view. Adding one of these will add the functionality across the whole project. | + | * **Project-level Optional Properties ** |
+ | * **General Optional Properties** (added at the page level) | ||
+ | * **Page-specific Optional Properties** (also added at the page level, and specific to that page or a group of pages) | ||
+ | |||
+ | ===== Project-level Optional Properties ===== | ||
+ | |||
+ | Some optional properties are also available at the project level on the project root view. Adding one of these will add the functionality across the whole project. A number of Project-level Optional Properties were deprecated in Release 3.12, and these are listed separately, after the table below. | ||
^ Property ^ Tooltip ^ | ^ Property ^ Tooltip ^ | ||
- | | Accessibility | + | | [[accessibility_project_properties|Accessibility...]] | Hide the accessibility logo and link or change the link to an alternative statement. | |
- | | Author Support | Enabled, this property adds support comments | + | | Author Support | Enabled, this property adds support comments (in red text) to help authors design pages. |
- | | Background... | Add a background image to all pages in this project. | + | | [[background_images|Background...]] | Add a background image to all pages in this project. | |
- | | Custom Interface{{: | + | | Decimal Separator | Select the appropriate symbol for numbers with decimal points. |
- | | Decimal Separator | Select the appropriate symbol for numbers with decimal points. | + | | Disable |
- | | Disable | + | |
- | | Enable Resuming | Enabled, this feature works with LTI and SCORM to allow users to leave a project, and when they return, are allowed | + | |
- | | Fixed Display Size | Authors can specify the width and height of the project when launched, in the format 800,600 (where the numbers represent pixels). This sets the minimum dimensions for the project, and if the screen size is larger than the fixed display size the project can still be resized to fit. | | + | |
- | | Flash Engine Visuals{{: | + | |
| Force First Page | Enabled, forces the project to open on the first page of the project, even if the URL includes specific page information. %%Useful when creating projects, such as escape rooms, where you don't want users to be able to jump ahead.%% | | | Force First Page | Enabled, forces the project to open on the first page of the project, even if the URL includes specific page information. %%Useful when creating projects, such as escape rooms, where you don't want users to be able to jump ahead.%% | | ||
- | | Glossary | Adds a table to the root page of the project, where terms and definitions can be added. Wherever these terms are used in the project they will be highlighted by a dashed underline. Hovering the mouse over the term will reveal a tooltip with the definition. | + | | Full Screen Button... | This property is only visible if you have selected **Fixed Size** from the **Display Mode** drop-down in the core properties for the project (the toolbar button that toggles between full screen and fixed size is now hidden by default and will only be shown if the **Display Mode** is set to **Fixed Size**). |
- | | Help File | Provides the ability to upload a file (e.g. PDF) or add a URL, to contain instructions or support material. | + | | [[xot_glossary|Glossary...]] | Adds a table to the root page of the project, where terms and definitions can be added. Wherever these terms are used in the project they will be highlighted by a dashed underline. Hovering the mouse over the term will reveal a tooltip with the definition. |
- | | Hide Footer | Enabled, this will hide the footer of your project. | + | | Header Icon/ |
- | | Hide Header | Enabled, this will hide the header of your project. | + | | [[xot_help_file|Help File...]] | Provides the ability to upload a file (e.g. PDF) or add a URL, to contain instructions or support material. |
- | | Home Page | Home page used when navigation is set to ' | + | | Hide Footer | Enabled, this will hide the footer of your project. | |
- | | Icon/ | + | | Hide Header | Enabled, this will hide the header of your project. | |
- | | Keyboard Language | Provides the ability to give the user keyboard language support when they are required to enter text on an interactive page. E.g., if a language other than English is selected, a pop-up dialog of special characters (appropriate to the chosen language) will appear when the user enters a text box. | | + | | Home Page ... | Makes the LO Title in the header a clickable link to the Home Page. By default, |
- | | Lightbox... | By default, clicked images will open in a lightbox (i.e. a pop up that overlays the main page). Use these properties to turn the lightbox functionality on/off for the whole project. A lightbox property is also available on each page. | | + | | Keyboard Language | Provides the ability to give the user keyboard language support when they are required to enter text on an interactive page. E.g., if a language other than English is selected, a pop-up dialog of special characters (appropriate to the chosen language) will appear when the user enters a text box. | |
- | | Max Width | %%Provides the option to set the maximum width (e.g. 1400px) | + | | [[lightbox|Lightbox...]] | By default, clicked images will open in a lightbox (i.e. a pop up that overlays the main page). Use these properties to turn the lightbox functionality on/off for the whole project. A lightbox property is also available on each page. | |
- | | Media... | Adds a link to uploaded media to the footer. | + | | Max Width | %%Provides the option to set the maximum width (e.g. 1400px) |
- | | Meta data... | Course: Label indicating the course this learning object is part of, used to create meta data in SCORM objects. This is also stored in xAPI events.\\ Module: Label indicating the module/ | + | | Metadata... | Course: Label indicating the course this learning object is part of, used to create meta data in SCORM objects. This is also stored in xAPI events.\\ Module: Label indicating the module/ |
+ | | Navigation Buttons... | This allows you to customise the tooltips and the icons for the navigation buttons (Previous Page, Next Page) and for the Table of Contents. | ||
| Notes | Your notes for the project. These are not shown in the live project. | | | Notes | Your notes for the project. These are not shown in the live project. | | ||
- | | Progress bar | Adds a graphical progress bar (with optional page counter) to the footer of the project. | + | | Page Introduction Button... | On each page of your project, you have the option to add an Introduction, |
- | | Script | Provides the ability to add custom JavaScript to the project. | + | | Progress bar | Adds a graphical progress bar (with optional page counter) to the footer of the project. |
- | | Series Title | Use this to label your project if it is part of a wider category, or series, or projects. DELETEME**Does this have any impact anywhere, e.g. in xAPI stats? | + | | [[project_introduction|Project Introduction...]] | Adds a lightbox which can be displayed automatically when the Learning Object is launched by the learner, or opened by clicking on an icon in the footer or sidebar. |
- | | Show/Hide Footer Tools | This provides options for showing or hiding the footer icons for tools such as the Accessibility Options, Full Screen, Glossary etc. | | + | | Script | Provides the ability to add custom JavaScript to the project. | |
- | | Styles | Provides the ability to add custom CSS to change the appearance of HTML elements in the project. | + | | Show/Hide Footer Tools... | This provides options for showing or hiding the footer icons for tools such as the Accessibility Options, Full Screen, Glossary etc. |
- | | Stylesheet | Provides the ability to upload and apply a separate CSS stylesheet file to change the appearance of HTML elements of the whole project. | + | | [[xot_side_bar|Side Bar...]] | Adds a collapsible side bar to the Learning Object containing buttons which would normally be found in the footer. |
- | | Table of Contents... | Provides the ability to customise the table of contents for use as a menu on the first page of the project, when Menu or Menu with Page Controls is selected as the Navigation method. | + | | Styles | Provides the ability to add custom CSS to change the appearance of HTML elements in the project. |
- | | Tracking... | FIXME{summarise} Passing Score: Passing score as a decimal fraction or percentage when tracking\\ Page timeout for completion: The number of seconds a page as to be viewed to count as completed\\ Force tracking mode behaviour: Force tracking mode behaviour, even in non-tracking LO's. This changes the behaviour of some page types, i.e. in Quiz the restart button will be disabled and in drag/drop exercises, the labels will stick, even if the answer is wrong\\ Tracking Category: Label indicating the category of this learning object, stored in xAPI events, to be used for categorising in xAPI reports. | | + | | Stylesheet | Provides the ability to upload and apply a separate CSS stylesheet file to change the appearance of HTML elements of the whole project. | |
- | | Variables... | Provides the ability to add custom variables which can be called in subsequent pages in the project. | + | |
| Surface Global Variables | Enabled, this provides the ability to call the following data %%within text fields using the following markup: | | Surface Global Variables | Enabled, this provides the ability to call the following data %%within text fields using the following markup: | ||
+ | | Table of Contents... | This set of properties varies depending on the Navigation setting selected. | ||
+ | | Tracking... | Passing Score: Passing score as a decimal fraction or percentage when tracking\\ Page timeout for completion: The number of seconds a page as to be viewed to count as completed\\ Force tracking mode behaviour: Force tracking mode behaviour, even in non-tracking LO's. This changes the behaviour of some page types, i.e. in Quiz the restart button will be disabled and in drag/drop exercises, the labels will stick, even if the answer is wrong\\ Tracking Category: Label indicating the category of this learning object, stored in xAPI events, to be used for categorising in xAPI reports. The icon for the Save Session button can be customised, and the text of the tooltip displayed on mouseover of the icon can be edited. | | ||
+ | | Twitter Card... | Enables a Twitter Card to be created for when a public link to this LO is shared via Twitter. | | ||
+ | | [[variables|Variables...]] | Provides the ability to add custom variables which can be called in subsequent pages in the project. | ||
- | ===== General optional | + | |
+ | ===== Deprecated Project-level Optional Properties ===== | ||
+ | |||
+ | These are properties | ||
+ | |||
+ | | **Property** | **Tooltip** | | ||
+ | | Custom Interface | A deprecated feature that used the old Flash interface. | | ||
+ | | Enable Resuming | Enabled, this feature works with LTI and SCORM to allow users to leave a project, and when they return, are allowed to resume from the last visited page. This has no effect on projects shared via the normal project URL or embed code. | | ||
+ | | Fixed Display Size | Authors can specify the width and height of the project when launched, in the format 800,600 (where the numbers represent pixels). This sets the minimum dimensions for the project, and if the screen size is larger than the fixed display size the project can still be resized to fit. | | ||
+ | | Flash Engine Visuals | A deprecated feature that used the old Flash interface. | | ||
+ | | Media... | Adds a link to uploaded media to the footer. | | ||
+ | | Series Title | Use this to label your project if it is part of a wider category, or series, or projects. | | ||
+ | |||
+ | ===== General Optional Properties | ||
The General set of optional properties is normally available on every [[pagetypes|page type]]. Adding a property from these will apply that functionality to the specific page only. | The General set of optional properties is normally available on every [[pagetypes|page type]]. Adding a property from these will apply that functionality to the specific page only. | ||
^ Property ^ Tooltip ^ | ^ Property ^ Tooltip ^ | ||
- | | Access Code... | %%Allows individual pages to be hidden until an access code is entered. The access code field should contain a comma separated list of all valid access codes. When a page or section is hidden behind an access code, a password box will be shown until a correct code is entered. A padlock icon will display against any page (in the page tree) which includes an access code.%% | + | | Access Code... | %%Allows individual pages to be hidden until an access code is entered. The access code field should contain a comma separated list of all valid access codes. When a page or section is hidden behind an access code, a password box will be shown until a correct code is entered. A padlock icon will display against any page (in the page tree) which includes an access code. %%**New in 3.13**. The Access code optional property group is available on every page, and there are four types available: Standard (default), Standard (centred), Vault and Keypad. [[https:// |
| [[op_background|Background...]] | Add a background image to this page. | | | [[op_background|Background...]] | Add a background image to this page. | | ||
| [[op_completion_not_required|Completion Not Required]] | Remove the page from project tracking data. | | | [[op_completion_not_required|Completion Not Required]] | Remove the page from project tracking data. | | ||
Line 67: | Line 86: | ||
| [[op_tracking|Tracking...]] | Set identifier and grouping for tracking with SCORM/xAPI. | | | [[op_tracking|Tracking...]] | Set identifier and grouping for tracking with SCORM/xAPI. | | ||
| [[op_variables|Variables...]] | Use in conjunction with the project level ' | | [[op_variables|Variables...]] | Use in conjunction with the project level ' | ||
+ | |||
===== Page-specific optional properties ===== | ===== Page-specific optional properties ===== |
optional_properties.1670507311.txt.gz · Last modified: 2022/12/08 13:48 by yvonne_moore