Skip to main content
ExLibris
Ex Libris Knowledge Center

Getting Started Guide

Last updated April 22, 2024. Updates are highlighted in yellow.

How to access the new UI

When you are ready to completely switch to the new UI, go to  Configuration > Leganto > General > Settings and change the parameter leganto_new_ui to true. This will change all links to Leganto to use the new UI for all users. 

While you are testing the new UI, there are a few different options for accessing it on a per session, per link, or per user basis. This video will show you a few of the options. They are described in more detail below.

1. Modify Leganto URL

After logging into Leganto, modify the Leganto URL by changing the word "readinglist" to “nui”:

Before: /leganto/readinglist/lists

After: /leganto/nui/lists

clipboard_e3b49ddfaa6e60130adc583cb1c434209.png

Change the URL to see the new UI

2. Browser bookmark toggle

You can create a browser bookmark which will toggle between the classic UI and the new UI each time you click it. 
  1. Create a new bookmark in your browser, to anything
  2. Edit the bookmark
    1. Change the name e.g. "UI change" 
    2. Edit the link, then replace the existing URL with the following:

javascript:(function(){ var url = window.location.href; var replace = (url.indexOf("/nui") > -1? "nui" : "readinglist"); window.open(url.replace(replace, (replace === "nui" ? "readinglist" : "nui")), %27_blank%27); })();

When you are logged into Leganto you can click on the bookmark to open the new UI in a new tab. If in the new UI, click on the bookmark to open the classic UI in a new tab.

Many thanks to our early adopters group for developing this bookmark!

clipboard_eb31429cc32478cf9fbb6e42b88530cbf.png

Bookmark toggle

3. Modify shareable link: 

You can add to any Leganto sharable link the following parameter: &nui=true

Example: https://<domain>/leganto/public/01MY_INST/lists/18556427310001021?auth=local&nui=true

4. Configure per user

You can configure that specific users be redirected to the new interface by default. In Configuration > Leganto > General > Settings > new_ui_tester_usernames, add the user identifiers, separated by commas. Primary and non primary identifiers are supported. Each username configured will be redirected to the new interface by default in all cases, including when starting from the LMS. Note that the capitalization must be the same as on the user record.

clipboard_eff7cf2d6d9badbfb6b06e61cef94b9b7.png

New UI user configuration

New enhancements added in the new UI

While developing the new UI, we added additional enhancements based on feedback we have received from our customers, including via Ideas Exchange, the product working group, support tickets, the listserv, and conversations with customers. The new UI includes several new features and enhancements and additional features will be added with each monthly release. 

Features which are no longer available

Some features from the classic UI were removed from the new UI. You can view a list here: Leganto New UI: Not planned to be supported

Some features will be in the new UI but have not been developed yet. You can view a list here: Leganto New UI Known Issues

Labels

There are many new and updated labels, as well as many labels which were not changed. If you previously customized labels which were not changed in the new UI, the labels were copied to the new UI. You may want to review your customized labels to ensure they are still appropriate in the new UI.

To customize labels in the new UI go to Configuration > Leganto > General > Labels – New UI

You should be aware of the following label changes:

  • My collection has been renamed Favorites
  • The citation statuses that instructors see have been changed:
    • Citations that have been added but not sent to the library have the status of Draft
    • Citations that have been sent to the library but are not complete have the status of Library processing

In the June 2024 release libraries will have the option to configure whether the Complete status displays to instructors, librarians or both. When enabled, Complete citations will have the status of Complete

clipboard_ee86ec2884beefa4e48213365d13ddfb8.png

Workflow changes

Most of the changes made to the new UI are small and should not require configuration changes. However, there are a few bigger workflows changes.

"My list is ready" workflow

For more information about these changes and the options available, view the recording and slides from the New workflows in the new user experience webinar.

The Publish/Send actions have been combined into a single button for instructors. Before the list is published, the instructor will see a banner letting them know that students cannot view the list. 

clipboard_e5a8285a37add1d5f1f2704eb86f9d979.png

You can configure which workflow for publishing and sending the list to the library best fits your needs.

  1. The instructor sends the list to the library. The library reviews and publishes the list. Instructors do not have permission to publish lists.
  2. The instructor sends the list to the library with the option to either publish the list now or later. Either the library or the instructor can publish the list. This is the default.
  3. The instructor publishes the list, and the list is automatically sent to the library at the same time.
  4. Available in June 2024: The instructor can publish the list and/or send it to the library.
  5. All lists created in the Leganto UI are published by default. The list is published immediately after it is created, and the items are automatically sent to the library for review.

For all options, any citations added to the list once the list has been published will be automatically sent to the library.

Default option:

clipboard_e498a34895d014f18511a6b7fd84d882c.png

Take action:

Review the three options to determine which is the best fit for your library. If needed, change the setting in the parameter instructor_publishing_options (Configuration > Leganto > List Management > Settings) to 1, 2, or 3. The default is 2.

If you prefer to have lists published by default, set the parameter auto_publish_on_create (Configuration > Leganto > List Management > Publishing) to Yes.

In the June 2024 release, you will be able to configure that items added to a published list are not automatically sent to the library. 

Documentation

Advanced publishing options:

We removed the option to have advanced publishing options display to instructors.

Before:

clipboard_e8fe777aba653530a1c5f772e9e36c06e.png

After:

clipboard_e5f5153a4e1532a86ef361a7fd81fce16.png

The library can still configure:

  • Which publishing option will be the default
  • Whether the three options above will display to instructors or if all lists will be published using the default option
  • Whether access to materials (files, etc.) will be restricted for lists published to All students at the institution and Anyone

The library also has the option to publish lists using any of the existing visibility options using Alma.

We did not change any of the existing settings, other than removing the option for instructors to see the advanced publishing options. You should not need to make changes.

Documentation

Duplicate and rollover lists

For more information about these changes and the options available, view the recording and slides from the New workflows in the new user experience webinar.

The instructor rollover and duplicate list options have been combined into a single “Duplicate list” function.

From a Leganto list:

When enabled, instructors will have the option to Duplicate list from the list menu.

clipboard_ec193da75f9f8a4d8683caa5a21f6a6a9.png

clipboard_eea3a8dd75092b38a44996874e2d40ea5.png

There is now the option to add a course association as the list is created/duplicated. If the new copy is linked to a course, and if you have enabled that instructors can customize what will happen with the sharable links (in the instructor rollover options table), a new configuration will appear: “Do you want sharable links to the original list to redirect to the duplicated list one it is published?” The tooltip includes additional guidance.

clipboard_e8454a6f4e245e7d297cc4f72763cfe1c.png

The instructor can also expand the Advanced settings section to view and/or change any of the default settings the library has enabled in the instructor rollover configuration. Note that the library will see all options, but instructors will only see the ones which have been enabled for instructor view.

clipboard_ee8f34b249a4c3724320ff19072ac838f.png

From the Quick Start screen:

When the instructor begins in the LMS, they will see a new version of the quick start screen. If you have enabled instructor rollover from the quick start screen, there will be the option to Create a list from an existing reading list.

clipboard_e2b523f0b9b707cc2fe4c8444c586b034.png

When the instructor clicks the Select existing list button, they see a list of all their existing reading lists. They also have the option to search for lists.

clipboard_ef801abc81bc896bbfd2bb26017559f9d.png

For any reading list, the instructor has the option to duplicate the list, which will copy the list and link it to the course.

If the instructor is an owner or collaborator on a list, they will also have a new option to link the course to that list, which will link the current course to the existing copy of the list, adding a new/additional course association.

clipboard_edf51ddf5353b186511b44f773d9d4a72.png

Take action:

  • Out of the box, Leganto will add the text (Rolled Over) to the end of the reading list name when it is duplicated. You can change the label, for example, to (2) or the year. Go to Configuration > Leganto > General > Labels New UI and customize the label duplicateList.addRolledOverToTitle
  • We recommend you review the instructor rollover settings. You can configure the default options, as well as which settings display to instructors. We recommend you do not expose any options related to statuses (copyright, list, or citation) or internal library information, keeping the options as simple as possible for instructors. 

Note: When testing, note that the library will see all options. Test as a user with only the instructor role to see what your instructors will see.

  • If you have not enabled the duplicate option from the Leganto list menu, you can enable in Configuration > Leganto > UI > List menu,  duplicate or rollover (either option will display the "duplicate" menu in the Leganto new UI.)
  • If your instructors have been previously trained to rollover lists and will be looking for the term "rollover", we recommend changing the label. Go to: Configuration > Leganto > General > Labels New UI and customize the label list.menu.duplicate_list.
  • If you have not enabled instructor rollover from the quick start menu, we recommend adding it so instructors will see the option to reuse an existing list. In the LTI Settings table (Configuration > Leganto > LTI > Settings) set the parameter cms_entry_actions to all or include the value rollover. This parameter accepts multiple values, separated by commas.
  • If you do not want instructors to be able to link courses to existing lists from the quick start menu you can remove the option. In the LTI Settings table (Configuration > Leganto > LTI > Settings) set the parameter cms_entry_actions to include only the desired options. Don't include "link."

Enabling instructor rollover documentation

Link to section or item from LMS

The classic UI included two different options to link to a specific section or item from the LMS: "Link from <LMS> to here" and "Re-link from <LMS> to here." 

clipboard_ef8bda919e05f671e61bf9eddb5857613.png

Both of these options have been removed from the new UI and replaced with an option to "Link to <LMS>", accessible from the "Share" icon. It will only display when accessing Leganto from an LTI link.

clipboard_ea69fc4b1a80a310e38ae9d7159027b31.png

All existing links to sections and items will continue to work.

The new option provides a user experience that is the same as copying and pasting shareable links. The instructor simply copies the link and then pastes it into the external tool of the LMS. Leganto provides linked instructions per LMS on pasting the links. The option to provide custom documentation will be added in a future release. 

Take action:

  • To enable the new "Link to <LMS>" option, go to Configuration > Leganto > UI > Section menu and Configuration > Leganto > UI > Item menu and set the parameter direct_link_from_LMS to Yes.
  • If you had been using one of the previous linking options, ensure your instructor training materials are up to date.
  • If you are using LTI 1.3, consider enabling the Link selection feature in the LMS. The Link selection feature provides the best end-user-experience for linking to specific sections or items within Leganto. See the documentation for Blackboard, Canvas, Moodle and D2L Brightspace on the Developer Network to enable Link Selection.

More information

For more information about the new UI, see:

New User Experience

Leganto New UI Known Issues

For additional questions, or to share you feedback with the Leganto product team, please contact: pq-leganto_customers_feedback@clarivate.com

The IGeLU Working Group has created a video showcase for switching to the new UI. It features short 5-20 minute videos from community members, sharing insights into their preparation for the transition. If you would like to contribute please reach out to the IGeLU working group at leganto@igelu.org. You don’t have to have already implemented the new UI to contribute.

Additionally, we recommend you join the Leganto listserv to participate in conversations about the new UI and to receive ongoing updates from Ex Libris. you can join here

  • Was this article helpful?