Uploaded image for project: 'Sakai'
  1. Sakai
  2. SAK-44160

Lessons - Allow instructor to customize the title attribute description for tool menu pages

    XMLWordPrintable

    Details

    • Type: Feature Request
    • Status: OPEN
    • Priority: Minor
    • Resolution: Unresolved
    • Affects Version/s: 19.0, 19.1, 19.2, 19.3, 19.4, 19.5, 20.0, 20.1, 20.2 [Tentative], 21.0 [Tentative]
    • Fix Version/s: None
    • Component/s: Lessons, Portal, Site Info
    • Labels:

      Description

      BACKGROUND

      A Sakai community member asked whether it would be possible to modify the title attribute (on hover tooltip) for individual Lessons pages that appear in the left tool menu.

      "Does anyone know of a way to get to this message that shows on hover over a Lessons page to modify it to good purpose (like providing the student a short description of the page)?"

      https://groups.google.com/a/apereo.org/d/msg/sakai-user/k6NBYKlUGrM/qQscR55YAAAJ

      REQUEST

      Offer a way for a professor to modify the tool description for an individual Lessons page. Currently, the tooltip repeats the description of the tool from the Manage Tools page (i.e. "Lessons - For creating, organizing, and delivering content modules and sequences, such as by week or unit"). The goal would be for an instructor to provide a short purpose or direction for learners when the tooltip is displayed. 

      POSSIBLE SOLUTIONS

      Manage Tools

      When an instructor adds a new Lessons page, perhaps offer a description field that would replace the default tool description for the new instance of Lessons?  Site Info > Manage Tools > select Lessons > Continue > enter name for Lessons page and also the description.

      Tool Order

      Once a Lessons page is added, if an instructor made a spelling mistake there needs to be a way to edit the description.

      Perhaps in addition to "Edit Tool Title," there could be an "Edit Tool Description" for Lessons tools?

      Lessons

      In Lessons, an instructor can rename a Lessons menu item through the main page settings (gear icon) of the Lessons page.

      Below the "Page title" field, perhaps add "Page description" field for top-level Lessons pages?  (Subpages have item description fields, but a top-level page would need a different option to impact the tool name title attribute?)

      CONCERNS

      There is an accessibility concern to this request since the title attribute is not universally accessible for screen readers or other assistive technologies. If the content is important for all learners, the appropriate solution should be explored to offer access to this information without hindering the user experience when using assistive technologies (i.e. don't repeat the same detail twice).

      ADDITIONAL NOTES

      The tool label feature was created years ago, starting in Sakai 2.4. See SAK-10120. An update happened later for versions Sakai 2.7, 2.8, and 2.9. See SAK-20645.

      Per the notes in these tickets, an institution can control the display of these tool descriptions.  Per ticket SAK-10120, "This is easy to disable in the includePageNav.vm - but this does also add a title tag for use by screen readers." Since I am not a developer, I am not sure if the property or setting to enable/disable this feature has changed.  If this option exists, then institutions could turn off the tooltips altogether if desired.

        Gliffy Diagrams

          Zeplin

            Attachments

              Issue Links

                Activity

                  People

                  Assignee:
                  maintenanceteam Core Team
                  Reporter:
                  alanregan Alan Regan
                  Votes:
                  1 Vote for this issue
                  Watchers:
                  5 Start watching this issue

                    Dates

                    Created:
                    Updated:

                      Git Integration