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

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



    • 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, 21.0 [Tentative]
    • Fix Version/s: None
    • Component/s: Lessons, Portal, Site Info
    • Labels:



      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)?"



      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. 


      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?


      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?)


      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).


      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



              Issue Links



                  maintenanceteam Core Team
                  alanregan Alan Regan
                  1 Vote for this issue
                  5 Start watching this issue



                      Git Integration