FAQ content

LTI: Customize Automagic LTI tool settings

In this article

There are 3 major pieces when customizing the Automagic LTI tool:

  1. Customize the basic setup options for things like the tool name and use of LibGuides customizations.
  2. Configure the content matching and content display options.
  3. Customize the options of what will be displayed on the Library LTI Page.

This FAQ takes you through the first part: options for the general setup. For more on configuring the Automagic content matching and set up of the Library LTI page, see this FAQ.


Tool settings

Most of the "customizations" you'll want to make with the Automagic tool involve content matching and display, which are explained here. There are a few options that LibApps Admins can modify in relation to the display of the Automagic tool (for version 1.0 and 1.3), though:

Change Tool Name / Tool Description Before Adding to Your LMS (Blackboard, Canvas, D2L, Moodle, Sakai, etc.):

If the Tool Name and/or Tool Description are not modified before you add it to your LMS, you cannot change it later and have it update automatically in your LMS. Not every LMS actually uses these fields, but for the ones that do (like Canvas), it's a one-time addition. If you want to change it after initial installation, you'd need to remove the tool and re-add it to your system.

Please work with your LMS Admins to determine what name displays for your system.

Change These At Any Time:

  • Custom Header/Footer: This either displays or hides your LibGuides header & footer when content is displayed within your LMS. Please be aware that this option does not affect your Library LTI Page itself. It only affects the display of guides & course pages​.
  • Custom JS/CSS: This either applies or removes the custom JS/CSS from your system when displaying content within your LMS. Please be aware that this option does not affect your Library LTI Page itself. It only affects the display of guides & course pages.

Adjust tool settings

To adjust the tool setting options for an Automagic tool:

  1. Go to the LibApps Dashboard.
    • Log in using your LibApps login URL, or
    • Log into any of your Springshare products, click the blue menu on the left, and choose LibApps.
  2. Go to Admin > LTI Tool Builder.
    • LibApps Admins can access this area. If you are on the LibApps dashboard and do not see an Admin menu, you are not a LibApps Admin.
  3. Click the View/Edit Tool () icon for the Automagic tool you are using.
    • Note: the process for adjusting the setup options is the same for Version 1.0 and Version 1.3 tools.
modifying the setup options for an Automagic tool, part 1
  1. Modify the setup options from the Tool Settings tab:
    1. Tool Name: Modify the name of the tool as needed.
      • Reminder:  this field will not update in your LMS after this tool is installed, so choose wisely! If you choose to change the tool after installing it in your LMS, you'll need to reinstall it, which will break all existing connections.
    2. Tool Description: Modify the description of the tool as needed.
      • Reminder:  this field will not update in your LMS after this tool is installed, so choose wisely!
    3. Custom Header / Footer: this option is disabled by default -- click Enabled to activate it.
    4. Custom JS/CSS: this option is disabled by default -- click Enabled to activate it.
  2. Click Save.
modifying the setup options for an automagic tool, part 2