Xerte Community Documentation

User Tools

Site Tools

Trace:
optional_properties3.12

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
optional_properties3.12 [2023/05/18 10:53] – [Project-level optional properties] jsmithoptional_properties3.12 [2023/07/31 09:44] (current) – [Project-level Optional Properties] jsmith
Line 12: Line 12:
   * **General Optional Properties** (added at the page level)   * **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)   * **Page-specific Optional Properties** (also added at the page level, and specific to that page or a group of pages)
- 
  
 ===== Project-level Optional Properties ===== ===== 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.+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 logo and link... | Hide the accessibility logo and link or change the link to an alternative statement. |+| Accessibility... | Hide the accessibility logo and link or change the link to an alternative statement. |
 | Author Support | Enabled, this property adds support comments (in red text) to help authors design pages.  These support comments only show in the Preview and not in the published project, and include unique IDs and Labels. Helpful for complex page setup such as with the Inventory page (where answers are matched to categories) or the Decision tree page.  | | Author Support | Enabled, this property adds support comments (in red text) to help authors design pages.  These support comments only show in the Preview and not in the published project, and include unique IDs and Labels. Helpful for complex page setup such as with the Inventory page (where answers are matched to categories) or the Decision tree page.  |
 | Background... | Add a background image to all pages in this project. | | Background... | Add a background image to all pages in this project. |
-| |   | 
 | Decimal Separator | Select the appropriate symbol for numbers with decimal points.  The default is period (fullstop) with comma as the alternative. (E.g. £5.10 or €5,10).  | | Decimal Separator | Select the appropriate symbol for numbers with decimal points.  The default is period (fullstop) with comma as the alternative. (E.g. £5.10 or €5,10).  |
-| Disable theme url | By default the theme can now be changed with a url parameter e.g. &theme=default, which is useful for a variety of reasons. However, as an author you can tick this optional property, if you wish, to disable this feature. The theme url parameter to use, when changing a theme by this method, is shown in each theme's description and is often shorter and not the same as the display name of the theme. | +| Disable Theme url | If you set access to Public in the Project Properties a Learning Object's theme can be overridden __in the browser__ by adding a url parameter (i.e. a string of characters) to the url.  For example, this url parameter, //&theme=flatblue// , changes the theme to the Flat Blue theme. The theme can only be changed to one of those available in the host installation. The theme url parameter to use, when changing a theme by this method, is shown in each theme's description in the Project Settings, and is often shorter and not the same as the display name of the theme. However, as an author you can tick this optional property, if you wish, to disable this feature. This stops learners and other users changing the theme you have chosen. |
-| 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{{:flashonly.png?nolink|Flash Only}} | A deprecated feature that used the old Flash interface.  |+
 | 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.  An icon will also be added to the footer of the project. Individual page types have the optional property to 'Disable Glossary' where this support would interfere with student activity.  | +| 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**).  You can customise the icon and the text displayed on mouseover for both **Fixed Size **and **Full Screen**.%% | 
-| Header Icon/Logo...8-) | Provides the ability to upload an image to display (for example as a logo) in the project header.  The image dimensions should be small.  The image can be hidden/unhidden and positioned left or right in the header. | +| 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.  An icon will also be added to the footer of the project.   The icon can be customised, and the text of the tooltip can be edited.  Individual page types have the optional property to 'Disable Glossary' where this support would interfere with student activity.  | 
-| Help File | Provides the ability to upload a file (e.g. PDF) or add a URL, to contain instructions or support material.  An icon link will be added to the project's footer to make access to the file/link available on all pages.  |+| Header Icon/Logo... | Provides the ability to upload an image to display (for example as a logo) in the project header.  The image dimensions should be small.  The image can be hidden/unhidden and positioned left or right in the header. | 
 +| Help File... | Provides the ability to upload a file (e.g. PDF) or add a URL, to contain instructions or support material.  An icon link will be added to the project's footer to make access to the file/link available on all pages.   The icon can be customised, and  the text of the tooltip displayed on mouseover of the icon can be edited.  |
 | Hide Footer | Enabled, this will hide the footer of your project.  | | Hide Footer | Enabled, this will hide the footer of your project.  |
 | Hide Header | Enabled, this will hide the header of your project.  | | Hide Header | Enabled, this will hide the header of your project.  |
-| Home Page 8-) | Makes the LO Title  a clickable link to the Home Page.  By default, the home page is the first page in the project; if you want a different home page, select a page from the drop-down which appears when you add this optional property. |+| Home Page ... | Makes the LO Title in the header a clickable link to the Home Page.  By default, the home page is the first page in the project; if you want a different home page, select a page from the drop-down which appears when you add this optional property. |
 | 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.  | | 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.  |
 | 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. | | 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. |
-| Max Width 8-) | %%Provides the option to set the maximum width (e.g. 1400px) at which the page contents will be displayed on larger displays. In 3.12 this now applies to __all__ pages.%% | +| Max Width | %%Provides the option to set the maximum width (e.g. 1400px) at which the page contents will be displayed on larger displays. In 3.12 this now applies to __all pages__.%% | 
-| Media... | Adds a link to uploaded media to the footer.  | +| 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/subject of this learning object, used to create meta data in SCORM objects. This is also stored in xAPI events. | 
-| 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/subject of this learning object, used to create meta data in SCORM objects. This is also stored in xAPI events. | +| 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.  Icons can be chosen from those available as Font Awesome characters. |
-| Navigation Buttons 8-) | This allows you to customise the tooltips and the icons for the navigation buttons (Previous Page, Next Page) and for the Table of Contents.  Icons can be chosen from those available as Font Awesome characters. |+
 | 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. |
-| Page Introduction Button 8-) | On each page of your project, you have the option to add an Introduction, which displays as a lightbox, when you click on an icon in either the footer or the sidebar.  This property allows you to customise the icon and the tooltip for the icon. |+| Page Introduction Button... | On each page of your project, you have the option to add an Introduction, which displays as a lightbox, when you click on an icon in either the footer or the sidebar.  The icon can be customised, and the text of the tooltip displayed on mouseover of the icon can be edited. |
 | Progress bar | Adds a graphical progress bar (with optional page counter) to the footer of the project.  This shows the percentage of the project completed as the user clicks through the project.  | | Progress bar | Adds a graphical progress bar (with optional page counter) to the footer of the project.  This shows the percentage of the project completed as the user clicks through the project.  |
-| Script | Provides the ability to add custom JavaScript to the project.  | +| 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.   The icon can be customised, and the text of the tooltip displayed on mouseover of the icon can be edited.  This lightbox can be used to provide an introduction to the Learning Object.  | 
-| Series Title | Use this to label your project if it is part of a wider category, or series, or projects.  | +| Script | Provides the ability to add custom JavaScript to 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.  |+| 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.  The icon can be customised, and the text of the tooltip displayed on mouseover of the icon can be edited.  | 
 +| Side Bar... | Adds a collapsible side bar to the Learning Object containing buttons which would normally be found in the footer. |
 | Styles | Provides the ability to add custom CSS to change the appearance of HTML elements in the project.  At root level the CSS will affect all pages, or it can be added to individual pages to just affect that one.  | | Styles | Provides the ability to add custom CSS to change the appearance of HTML elements in the project.  At root level the CSS will affect all pages, or it can be added to individual pages to just affect that one.  |
 | Stylesheet | Provides the ability to upload and apply a separate CSS stylesheet file to change the appearance of HTML elements of the whole project.  | | Stylesheet | Provides the ability to upload and apply a separate CSS stylesheet file to change the appearance of HTML elements of the whole project.  |
-| Table of Contents... {{https://xerte.org.uk/wiki/lib/images/smileys/cool.svg?16x16|8-)}} | This set of properties varies depending on the Navigation setting selected.  1) For **all Navigation options except Historic**, it allows you to hide/unhide the page numbering and the "Tick When Viewed" function.  You can also choose whether to have the Table of Contents display in a Dialog or Lightbox format.  2) For the **Menu **and **Menu with Page Controls** Navigation options, you can also select an image to display, either in a panel to the right of the menu options, or as a background to the menu options.  | 
-| 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. | 
-| Twitter Card | 8-) Note - needs a page of its own. | 
-| Variables... | Provides the ability to add custom variables which can be called in subsequent pages in the project.  A linked guide is provided with instructions and examples.  | 
-|   |   | 
 | Surface Global Variables | Enabled, this provides the ability to call the following data %%within text fields using the following markup:%%{globalVars.dateCreated} or {globalVars.lastUpdated} or {globalVars.numViews} | | Surface Global Variables | Enabled, this provides the ability to call the following data %%within text fields using the following markup:%%{globalVars.dateCreated} or {globalVars.lastUpdated} or {globalVars.numViews} |
 +| Table of Contents... | This set of properties varies depending on the Navigation setting selected.  1) For **all Navigation options except Historic**, it allows you to hide/unhide the page numbering and the "Tick When Viewed" function.  You can also choose whether to have the Table of Contents display in a Dialog or Lightbox format.  2) For the **Menu **and **Menu with Page Controls** Navigation options, you can also select an image to display, either in a panel to the right of the menu options, or as a background to the menu options.  |
 +| 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... | Provides the ability to add custom variables which can be called in subsequent pages in the project.  A linked guide is provided with instructions and examples.  |
 +
  
 ===== Deprecated Project-level Optional Properties ===== ===== Deprecated Project-level Optional Properties =====
 +
 +These are properties available in Release 3.11, but deprecated in 3.12.
  
 | **Property** | **Tooltip** | | **Property** | **Tooltip** |
-| Custom Interface{{:flashonly.png?nolink|Flash Only}}  |A deprecated feature that used the old Flash interface.  | +| Custom Interface{{:flashonly.png?nolink|Flash Only}}  | 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{{:flashonly.png?nolink|Flash Only}}  | 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. |
  
  
optional_properties3.12.1684407217.txt.gz · Last modified: 2023/05/18 10:53 by jsmith