Archive for LibAuth

LibApps release with new LibAuth, LibGuides, LibCal, LibAnswers, LibInsight, and LibStaffer Features

Wow, do we have a ton of end of year updates to share with you – we have new LibAuth, LibGuides, LibCal, LibAnswers, LibInsight, and LibStaffer features to share! This time we’re doing something different with the announcement – rather than spreading out the announcements in multiple blog posts (one per product) we’ll outline them all here, in a single post.

These releases are on their way to you next week, and will be live in all regions by the end of the day on Wednesday December 19th.

LibAuth & LibApps

LibAuth now supports SSO logins via OAuth2 and Sirsi Symphony. If your SSO supports the OAuth2 protocol, or if you have the Sirsi-Dynix Symphony ILS, you can now set up LibAuth configurations that will use these methods. Use LibAuth to authenticate patrons for LibCal Space Bookings, events, LibGuides E-Reserves, or to place your LibGuides site, group of guides, or a single guide behind authentication. LibApps admins can head to LibApps > Admin > LibAuth Authentication to see these two new options.

In LibApps, if you switch to a custom domain or change an existing custom domain for your LibGuides, LibCal, or LibAnswers site, we will request & install a free Let’s Encrypt security certificate before we put the domain change into effect. This ensures that all traffic to your sites continues to go over HTTPS rather than over the insecure HTTP protocol. If you haven’t yet read our blog post on making all your Springy traffic HTTPS, check it out now.

We’re also adding two more customizable fields to the Primo Search Source, when you set it up to show Primo results inside your LibGuides & LibAnswers search. The two new customizable fields are for changing the scope and tab name. Head to LibApps > Admin > Search Sources to set this up for Primo.

LibGuides

Over in LibGuides, if you have LibGuides CMS and have implemented IP Access Restrictions for your site, group, or guide, you will no longer see results for these IP-protected assets in search results, unless you are inside the required IP range. Your IP-protected guides will only show up in search results for users within valid ranges.

We also added a feature many of our A-Z Databases admins have asked for: the option to remove a “Trial” label from a trial Database when the trial expires. To set this up, go to Content > A-Z Databases > edit your database, apply the label, add the trial expiration date, and check the box labelled “Hide from public view on trial expiration date.”

Speaking of A-Z list, we’ve made a small change to the way that A-Z Databases search works with filters on the public A-Z page. Previously, if you filtered the page view to a subject, vendor, or type, and then did a search, these filters conflicted, resulting in incorrect search results. Now, when you search filtered results, you’ll correctly see databases that match your search term AND your filters.

There are also a bunch of small features and fixes to share:

  • We fixed the A-Z Databases map count, which were incorrect in a few instances.
  • We fixed the rendering of A-Z Database Description popovers in two cases:
    • When you’re using a A-Z page template that contains a custom content box with A-Z databases in it.
    • If you’re using IE11 or on a mobile device.

LibCal

We’re happy to announce that LibCal now has an online payments component built right into the system, and it comes with no additional fee – it’s a standard part of your LibCal system.


Online payments are being added to event registrations and spaces first. Support for payments on equipment bookings will be coming soon (late January/early February). We’re doing a limited online payments release to early adopters, until we polish all the payments features over the next few weeks (the wide release will be later in January). If you’re interested in being an early adopter for online payments in LibCal, let us know! For a sneak peek at how this functionality is integrated within LibCal, check out the December Springy Newsletter feature on LibCal – Way to Pay.

In addition to online payments, we have several other new features rolling out in this release, including:

  • The new “Next Available” quick link in Spaces and Equipment is now available via the APIs
  • We’ve added a simple honeypot captcha to Event booking forms, to help reduce spammy event registrations. This captcha method doesn’t display to the patron at all, so you won’t see anything different in your registration forms, but spambots will run into hidden fields that are designed to catch them and prevent the form from being submitted.
  • We’ve updated our Spaces Exchange Integration to support displaying Space reservations in Exchange using either the patron’s name, or a nickname they enter as part of the registration form. This is designed to assist folks who are relying on the Exchange integration to tie in with an external room panel. To try out this new setting, head to Admin > Equipment and Spaces > Exchange/Outlook and look for the Title Setting toggle.

LibAnswers/LibChat

We’re thrilled to announce that our new screensharing & webinars functionality is here! We went way beyond just basic librarian-to-patron sharing of screen during chat. Patrons and Librarians can also request control of each others’ screens, do an audio chat, start an optional webcam share for a face to face chat, annotate the screen to help guide your users in the right direction, save and send screenshots… and that’s just the basics. Also, why stop with two people – have a screensharing/webinar session with 3, 4, 5 or more people – the more the merrier! It’s all there, in LibChat.

  • Supported Across All Browsers – Whether you or the patron are using Chrome, Firefox, Safari, or some other browser… our screensharing works across all browsers.
  • Supported Across Multiple Operating Systems – From Windows to Mac OS, from Ubuntu to Mint… we’ve got you covered.
  • Works on Tablets & Mobile Devices – From Surface Pro 2 (running Win 8.1 / Win 10) to iOS/Andriod devices and even on Slaven’s beloved Blackberry (yes, we went there!)… you can screenshare with users on multiple device types.
  • Audio & Video Options – You and the patron have the option to turn on your mics and webcams to enhance the screensharing experience.
  • Screen Annotation – Annotate screens, draw attention to certain elements, type up notes, and then save the screenshot and send to the patron.
  • Multi-Person Webinars or Virtual Staff Meetings – Screenshare as a group for internal meetings, staff webinars, etc. Why should only two people have all the fun?
  • Distance Education Support – With our screensharing and webinars, your library can better support distance ed programs at your institution.
  • Saved Recordings – Optionally, save your screenshare session and share it with relevant parties.

Screensharing is an optional module but it’s included free to all our Suite customers. Non Suite users can join in the fun too for $199 for this module – we worked hard to bring enterprise-class screensharing & webinars solution that costs thousands to every library that needs it, for less than a daily cup of joe at the local deli. That’s what we’re all about – delivering outstanding value to our libraries that we’re privileged to serve and work with.

Based on the amount of emails and inquiries we received since we told you about our screensharing plans, we know that you will want this installed, like, yesterday. But in order to ensure the stability of the infrastructure the rollout will be gradual, over the next couple of months. If you want to be an early adopter please let us know you’re interested and we’ll go from there.

In addition to screensharing, we have a couple of additional updates to share:

  • New Chat Status: Internal – With all of the screensharing excitement around the potential for internal staff meetings and support, we realized that our existing availability options in LibChat needed some tweaks. Thus as of this release there are now 3 presence/status settings for LibChat:
    • Online – You’re available to answer all public and internal chats
    • Internal – You’re offline as far as public chat departments are concerned, but online and available for internal chat departments and 1:1 operator chats
    • Offline – You’re entirely offline and unavailable to chat
  • Department Monitoring Update – We’ve updated the way we display information on who is publicly monitoring chats for each LibChat department. Previously we were displaying availability for each user in each department based on their overall online/offline status. Now, we’ll display this information based on whether the user is specifically publicly monitoring/not monitoring each individual chat department. To see this in action, head to the LibChat dashboard > Select a Department > Click Department Members.

LibInsight

We are working on integration of COUNTER Release 5 datasets into LibInsight, which we expect to be available before the end of March 2019. Meanwhile, we have a slew of small fixes for you:

  • We fixed field editing bug in circulation datasets
  • We fixed the error message displayed if you do not specify a “# of transactions” field in an Aggregate Circulation dataset
  • We fixed Dashboard charts for LibCal, LibAnswers, and LibGuides datasets
  • We’ve made it possible for you to choose whether to require “Required” fields when uploading a file to a custom dataset
  • We fixed a broken export button in the Circulation and Acquisitions Datasets Analysis “Popular” tab
  • We fixed the “Reset” button on widgets, which was not getting appropriate keyboard focus

LibStaffer

We’ve been working hard to bring you some special gifts this holiday season including awesome new features like copying shifts, SMS alert notifications, Geofencing and OAuth authentication for Outlook/Exchange calendar syncing.

  • Copy Shifts – By popular demand, you now have the ability to copy shifts and their assignments to the same or different calendar.  Open any schedule, select the settings icon drop down and select Copy Shifts access this feature.
  • SMS Alert Notifications – SMS alert notifications are here!  Select which LibStaffer alerts to receive through SMS text messages or email (or both).  Head to Admin > Accounts > Edit > Email & SMS Alerts to check out this new feature.
  • Geofencing – We’ve developed a way to put a distance restriction on where staff members can either clock in or clock out within a specified radius from a schedules physical geographic location.  Check out this new feature to set your geofence restrictions and schedule locations latitude/longitude by going to Admin > Schedule Settings > Edit Settings > Location & Time Clock.
  • OAuth Authentication for Outlook/Exchange Sync – A brand new way of syncing to Outlook/Exchange, using OAuth tokens instead of having to enter and update login passwords.  This new way is more secure than storing of Outlook/Exchange passwords.  Head to Admin > Accounts > Edit Account > Outlook/Exchange.
  • Workflow Submissions Explorer Recipient Filter – We’ve improved the workflow forms submission explorer to include a notification recipient filter.  You will now be able to use this filter to see only relevant form submissions that included a specific notification recipient.  To run the explorer with this new filter head to Forms > Submissions Explorer.
  • Max Hours per Day – The ability to set the maximum number of hours a day a staff member can work across all schedules in one day.  Manual shift assignments and the auto scheduler will take this new value into account when checking availability when scheduling staff members.  To set a staff members max hours per day that they can work, go to Admin > Accounts > Edit > Manage Account.
  • Custom Week Start Date – Beyond Sunday and Monday, we’ve now brought you the ability to set the ‘Week starts’ date to any day of the week.  The proper support has also been added for manually assigning staff and running the auto scheduler to determine availability.  Go to Admin > System Settings to set your ‘Week starts’ value to any day of the week.
  • Multi View Start Date – We’ve modified the multi schedule view display where if all the calendars selected for the multi view have the same week start date, the calendar view will start on that same day of the week.  To view this change, go to Schedules > Multi-Schedule View Only and select calendars that all have the same week start date.
  • Shift Swaps with Outlook/Exchange sync – We’ve improved the shift swap sync process for Outlook/Exchange where after a shift is successfully swapped between two staff members, the shift that each staff member was assigned to prior to the swap will be removed from the Outlook/Exchange calendars.
  • Consistent first and last name display – We’ve gone through all of LibStaffer and anywhere an account name appears it will display as First Name Last Name sorted by Last Name.

 

Many of the new features and functionality in Springshare tools came as a direct result of you, our customers, sending us your ideas, suggestions, pain points, constructive criticism, and kudos. We can’t thank you enough, and we promise so much more good stuff coming your way in 2019 – new features, enhanced functionality, new products… all with one singular purpose – to make your library workflows better and for you to continue impressing your customers and making them love and appreciate their library and their librarians even more. Thank you for your amazing suggestions and ideas in 2018, and here’s to a lot more goodies in 2019 and beyond. As always we’re here for you if any questions pop up.

LibGuides and LibApps Updates Coming Your Way!

LibGuides Update

We have some great updates coming by the end of this week to LibGuides, LibApps, and LibAuth to go with the official changing of the seasons. Happy fall to our fellow Northern Hemisphere denizens, and Happy Spring to our customers on the other side of the world!

To kick us off, we’re pleased to announce that you can now Export All Rows for LibGuides Homepage and Guides statistical reports. So many have requested this that I’m sure there will be fireworks and bonfires in celebration. 🙂  To export your results, just run a report from Statistics > Homepage or Statistics > Guides, then click the Export All button. No more paging through results! Just download and slice and dice to your heart’s content.

Also new in LibGuides:

If the database that you’re adding to a guide is hidden, you’ll see text indicating that:
screenshot

Ability to edit the friendly URL of a blog post! Note that guide blogs must have friendly URLs assigned at the guide and page level for this feature to appear:
screenshot of the post edit screen

Ability to add Primo as a search source for LibGuides. Now you can add search results from your Primo system as a tab or Bento box in your LibGuides system. This will be available from LibAnswers search in a future release.
screenshot

We try to do at least one accessibility fix each LibGuides release, and this one is no exception: If your databases’ descriptions are set to “hover over title” or “hover over (i) icon,” those pop-over descriptions aren’t read aloud when databases appear on a guide. Thanks for letting us know, Ken! We’ve fixed that in your honor. ❤️

We also have a swarm of little fixes to report:

  • AZ Import > vendors are added and updated properly.
  • AZ.php > the correct container class is applied when you use a custom footer.
  • Accounts > Email options > Help ID has been corrected.
  • Names now appear underneath profile boxes on the A-Z and Subject pages.
  • XML exports sent to Summon now use the correct “last updated” date for guides.
  • Accounts > Add > Contributor level is no longer grayed out.
  • The Guides list filters properly when you have an apostrophe in a group name.
  • We corrected an issue with password-protected reserves documents and the www version of a domain.
  • Discussion Boards: Regular level accounts can invite patron accounts from the guide edit page.
  • Guide edit > add editor > we fixed the ability to create a new Editor account from here.
  • Custom metadata has been added to guides rendered via widgets (and therefore to LTI).

We have also done a ton of performance and optimization fixes all across the codebase, so you’ll see things like the Assets data table perform better.

Also don’t miss this month’s Brunch ‘n’ Learn: “LibGuides Lab Work-In: Hands-On Help for Your Staff.” Check out this and other LibGuides training sessions live, or watch recorded videos.

LibApps

We have made a couple of improvements to LibApps as well. Now when you export all your LTI instances, the Content column just has the name of the matches content rather than the HTML link.

We also made it so that if you request that we remove your custom SSL certificate so that you can start using Let’s Encrypt (free!), there’s no gap in HTTPS coverage.

LibAuth

Over in LibAuth, we now support the Location attribute for SIP2 Connections, updated Federation metadata to use SHA256, and fixed an issue where the General pane of the LDAP configuration screen was not saved when you edited the login form tab.

New LibAuth US Hardware Coming Your Way!

Update image

Just a quick post to let you know that on Wednesday, July 18, at 11:00 a.m. Eastern time, we will be moving the US LibAuth server to new hardware. We’ve chosen this time because it seems to be the slowest time for all our US and Australian customers using this server. There will be up to 5 minutes of downtime while we make this change, which means that logging in via LibAuth for US customers may be unavailable during this time. No other application or function will be affected. The IP address of the server will NOT change, so if your use of LibAuth relies on letting a certain IP address through the firewall, you can rest assured; that will still work.

Brand New Season, Brand New LibGuides Features

We are excited to bring you some big new LibGuides features by the end of this week, just in time for Spring (or Fall, depending on where you are!), including the ability to put your entire site behind your Single Sign-On system with LibAuth authentication, search-and-replace for E-Reserves Items, and a bevy of other fixes.

Read on!

screenshot

Full SSO for Your Guides with LibAuth

Coming this week is the ability to place more public LibGuides pages behind your SSO with LibAuth, whether it’s a single guide, a restricted group of guides (LibGuides CMS only) or your entiresite. We’ve got you covered whether you are required to hide your entire site from the open web, would like to provide access to a group of guides to your campus, or make a single guide available just to one constituent group.

You can set up a LibAuth connection using any of the supported configurations: SAML/Shibboleth/ADFS, CAS, LDAP, SIP2, your own hosted script, or either the InCommon or UK Federation. Securing a guide, group, or site is done in two steps:

  • Set up and test your LibAuth configuration in LibApps at Admin > LibAuth Authentication
  • Set up the desired restriction in LibGuides at Admin > System Settings > Access Restrictions > LibAuth Authentication Rules

Let’s Encrypt Automation

We’ve written a lot lately about site security, and this post is no exception. Coming this week is automation for the installation of Let’s Encrypt certificates for LibCal and LibAnswers sites. Need a secure site but can’t really shell out for a custom security certificate? We got you! Just change your custom domain’s DNS to point to the correct secure endpoint, and we’ll do the rest.

For more in depth information about Let’s Encrypt, read this blog post.

Filters for Non-Database Assets

We’ve updated the Assets page with new filters so that you can search your growing repository with ease! Search not only by type, but owner, subject, URL, and even for code contained in your Media/Widget content. Want to know how many YouTube widgets you have? No problem! Want to see the vast array of Animal Husbandry resources you have? A cinch! Just go to Content > Assets and search to your heart’s content.

screenshot

Profile Box: Random Settings!

Are you one of those folks that used the rotating box code to show off a selection of your guide owners in LibGuides v1? Well now you can do that in LibGuides v2! After adding a profile box to your guide, you can set it to display a random profile each time the page is loaded. You’ll see two options: one will display a random profile selected from all profiles in your system, Admins, Regular, Editors, and Contributors; the other will choose only from profiles that own published guides.

screenshot

E-Reserves Items Search & Replace

We have added E-Reserves items to the Search & Replace tool. If you’ve discovered that a title was recorded incorrectly and you’ve re-used the item in every. single. English. course. for the semester, you can save a slew of clicks by using S&R.

It works like the other S&R tools: you can search for E-Reserve item name, description, URL, and the fields that are particular to the various E-Reserves Item types, like Article Title and DOI. Head over to Tools > Search & Replace to get started.

screenshot

Smaller Features and Fixes

We are also including a bunch of smaller features and fixes that we’re sure you’ll love!

  • Gallery boxes added as custom boxes to E-Reserves course pages display properly.
  • If you uncheck “use this image in my guide” while uploading a new image to Image Manager, the Upload New Image button persists after upload.
  • The mSite builder “site visited” cookie is now 2 minutes instead of 2 hours.
  • We fixed the ability to add an IP restriction from inside a guide as well as from Group settings.
  • We added missing content types to the Add Content Item dialog on the Content > Assets page.
  • Editor account levels are now able to delete rich text content items on guides they edit.
  • In Tools > Data Exports > XML, the Download icon is not available until the file is ready to be downloaded.
  • Links to guides submitted via publishing workflow are no longer relative.
  • An error in the search sources was fixed, allowing EBSCO Discovery Service contents to be retrieved.
  • We removed the outdated “scheme” attribute from meta tags.
  • We changed the way that guide titles sort, so that whole and decimal numbers are sorted properly.
  • We added the URL to the export for non-database assets.
  • We changed the text for the unsubscribe links in blog post emails to be more accessible.

Some Impending LibGuides Updates to Warm your January!

We’ve been kindling the fires of Midwinter (will we see you there??) up here at Springy HQ by coding up some great winter features you can use to spruce up your LibGuides. Just for funsies, we’re throwing in an update to LibAuth configurations, too. 🙂 These features will be live in all regions within a few days. Check ‘em out:

LibAuth supports uploading authorized values

Screenshot

Click to Enlarge

If you use LibAuth groups, you now have a couple of ways to automate the population of the Allowed Values field for your group attributes. Head over to LibApps > Admin > LibAuth Authentication and click the edit button for your LibAuth configuration. You can either upload a CSV file containing your Allowed Values, or you can specify a URL from which we can fetch the Allowed Values, which we’ll do nightly. What does this feature do for you? You might have a group of rooms in LibCal that are only bookable by current students from a certain college, or by patrons who meet certain requirements. Use this field to let LibAuth know which people are allowed to book.

Additional customizable language keys

All of the below have been added to Admin > Look & Feel > Language Options > Language Customization. Don’t see one of these for your language? Kindly shoot us an email, and we’ll add it for you. Please include a translated phrase in your language that is as close to the English original as is possible. You can customize it further in your system if desired.

Interested in contributing translations for the public side of LibGuides in a language that’s not currently available? We’d love your help!

  • Screenshot of the AZ list

    Click to enlarge

    Key 373 is the phrase “Alt. Names/Keywords” that is used for that field in your A-Z Databases list. When you change this key, the changes will be visible on the public and admin side, for consistency.

  • Key 375 is the label “Popular” that appears next to Database assets that you’ve designated as such.
  • Key 387 is the text of the tooltip that appears when you hover over the website/blog icon in a profile box.
  • Key 376 is the word “for” in Database search results.
  • Key 275 is the word “All” that appears at the beginning of the alphabetical browse listing on your A-Z Databases page.
  • Key 123 is the phrase “Last updated” that appears when you hover over a guide’s last updated date on your system homepage.
  • Key 380 is the button text that appears next to the guide sort options on your system homepage guides list.
  • Keys 362 and 365 pertain to the Courses tab on Subject pages and apply only if you have the E-Reserves module.
  • Keys 100, 376, and 322 pertain to information shown on system search results screens in Bento Box format.
  • E-Reserves item modals now correctly display your customized language when you view an individual e-reserves item.

API response changes (LibGuides CMS only)

We’ve made some small changes to the v1.2 API used for creating and updating database assets. If you’re using these API calls, you’ll now be warned if it contains errors. If your API call is successful, we’ll let you know which fields were updated. For more information, please see the documentation for each API call in LibGuides > Tools > API > v1.2. Here is a sample successful call showing all the fields that were updated. Please note that GET requests for A-Z assets were not changed.

Screenshot of API response

E-Reserves updates!

  • When you have item search turned on, “Documents” becomes the default tab.
  • When you do a search but then click to another section of E-Reserves, your search terms are cleared, and you are presented with the entire list of available items.
  • When an item appears in more than one course, its name is spelled out in search results, rather than the phrase “View Item.”
  • In E-Reserves > Settings, you can specify whether the proxy setting is on when creating new items.
  • When adding a new E-Reserves item, required fields are marked with a red asterisk.

Other small updates

  • Email notifications sent to subscribers of your blogs will contain the blog name in the subject line.
  • We replaced the orange “loading dots” with ones that move at an accessible refresh rate.
  • If your custom SSL certificate is expiring in under 60 days, we will email you. We will email you again 7 days before it expires, if you have not renewed it. Please note that this email is sent to the person who uploaded the certificate files.

Things we fixed

  • Sites with guide titles using CJK characters display correctly when displayed in an LMS via the LTI tool.
  • Regular-level users can edit database assets that they own.
  • You can add a book to a blog post by just pasting its ISBN into the Add Book dialog.
  • When you check “Show entire post” for a blog widget, the “Show Images” checkbox works properly.
  • When you add a Database asset to a guide, the Description Display preference is preserved, unless you choose a different option.
  • When you go to a specific page in our support site and log in, you’re taken to the proper page instead of the support site home page.
  • We optimized the query behind the LTI Instances page; it’s super, super fast!
  • We fixed the “Filter by Owner” menu on the A-Z list so that it includes everyone.
  • The number of profiles listed on the profiles page matches the number of profiles displayed.

LibGuides Accessibility Updates, AZ Page Stats, HTTPS Certificates and more!

Accessibility fixes

This week at Springy HQ we are pleased to bring you the following accessibility fixes. Our first pass of fixes in the last few months focused on “errors” on all public pages; this pass hits the E-Reserves module as well as many things classified as “alerts”—things that could technically adhere to guidelines but needed examining. See something else we need to consider? Let us know! Click the Support tab on any admin-side LibGuides page to send us a ticket.
Please include:
  • Name of the accessibility tool you’re using
  • Description of the issue, including any code snippets that trigger the alert
  • Screenshot of the accessibility tool’s overlay highlighting the issue, if possible
  • URL of the page (included automatically if you use the Support form)
To ensure that content that you add keeps your guides accessible, please see our help guide on LibGuides and Accessibility accessible as well as the upcoming training session on the topic.
E-Reserves fixes
  • We rebuilt the E-Reserves request form using plain HTML & Bootstrap select menus, eliminating several issues with keyboard and screenreader navigation.
  • We eliminated a few errors and alerts on the main E-Reserves listing page and on course pages.
  • We changed the H4 element used to mark up the number of courses shown to an H2 to maintain proper page outline.
Public Pages fixes
  • We’ve replaced the select menus on the Subject and Profiles by Subject pages with simpler HTML that eliminates several alerts and errors.
  • We changed an H4 tag on the Subjects page to H2 in order to maintain proper outline order.
  • We added a missing ARIA label on the system homepage and changed the Sort control to a <div> rather than a <form> tag.
  • We removed a hidden field that was triggering a “redundant ALT text” alert.
  • We wrapped the profile image and name together in a single link tag to eliminate the “redundant link” alerts.
Gallery boxes
  • We incorporated an updated version of the component used in Gallery boxes as it contained several accessibility updates.
  • We changed the slide title field to H3 since the box title is H2, to maintain proper outline order.
A few changes might require the updating of your system’s CSS and custom templates, but only if you make extensive use of CSS and custom templates. Most folks won’t have to worry about these! Here are the gritty details, should you need them:

CSS Changes:

System & Group Home Pages
WAS:
The element around the “Display” area, which allows you to control the order in which guide lists are displayed should not have been a <form> element.
NOW:
It is now a <div> element, so any customizations targeting the form element should be updated to use <div> instead.
Gallery Boxes
WAS:
Slide titles were <h4> elements.
NOW:
This is now an <h3>, following proper sequential numbering of heading tags on the page.
E-Reserves – er.php
WAS:
“Search for Courses” label next to the search box was a <span> element.
NOW:
This is now correctly in a <label>. Heading above the list of courses, subjects, etc., was an <h4> element. This is now an <h2>, following proper sequential numbering of heading tags on the page.
E-Reserves Request Form – er_request.php
WAS:
We had been using a component for some of the select options on the page that we determined was not accessible to screen readers / keyboard navigation. It had its own set of classes, which all started with “select2”.
NOW:
We’re using simple HTML styled by Bootstrap’s default classes. All classes starting with “select2” are removed. These include: select2-drop, select2-display-none, select2-with-searchbox, select2-drop-active, select2-offscreen, select2-input, etc.
Password-Protected Pages – Groups, Guides, Courses
WAS:
The message prompting users to enter the password (above the text box) was not in a <label>.
NOW:
That text correctly has a <label>, as it is associated with the password input below. Any CSS changes should target the <label> element.
Profile Landing Page – prf.php
WAS:
“By Subject” dropdown was using a component that we found was not accessible to screen readers / keyboard navigation. It had its own set of classes, which all started with “chosen”.
NOW:
We’re using simple HTML styled by Bootstrap’s default classes. All classes starting with “chosen” are removed. These include: chosen-select, chosen-container chosen-container-single, chosen-default, chosen-single, etc.
Profile names are not linked, so style changes could be made using:
div.s-lib-profile-nameProfile names are now linked to their profile (in addition to the picture being linked), so any style changes to the profile name must be adjusted to include the anchor tag:
div.s-lib-profile-name a
Subjects Pages: sb.php and individual subject pages
WAS:
Subject dropdown selection was using a component that we found was not accessible to screen readers / keyboard navigation. It had its own set of classes, which all started with “chosen”.
NOW:
We’re using simple HTML styled by Bootstrap’s default classes. All classes starting with “chosen” are removed. These include: chosen-select, chosen-container chosen-container-single, chosen-default, chosen-single, etc.  Headings above the list of guides, databases, etc., (“Showing x guides”, etc.) were <h4> elements. This is now an <h2>, following proper sequential numbering of heading tags on the page.

Template Changes:

Both the Profile and Subject pages now have ARIA labels for the <section> tags. If you are using the default templates, you do not need to make any changes to implement this update. Default templates automatically update.

If you have customized these templates, however, you will need to update your template to include the accessibility update, as outlined below.

Right now, each of these is coded as simply <section>. Now they are coded as follows. You can update customized templates to reflect these changes at any time.

Profiles Templates:

Main Landing Page – prf.php:

<section aria-label=”List of Profiles”>

Individual Profile Page – prf.php?account_id=x
<section aria-label=”Profile Content”>

Subjects Templates:

Search Bar:
<section aria-label=”Subject Search Bar”>Content area below Search Bar:
<section aria-label=”Content by Subject”>

Manage Your Domains!

New in LibApps is the ability to view and manage your systems’ domains, including the ability to add and change custom domains and upload a custom HTTPS certificate for LibGuides. Need a certificate installed for your LibCal or LibAnswers system? No sweat! Please email us at support@springshare.com or open a ticket by clicking the Support tab from the admin side of your product. We’ll get you set up right away, and the ability to manage these certificates on your own will be coming soon.
So what can you do on the new Manage Domains page? Go to LibApps > Admin > Manage Domains to:
  • View the domains for all your Springy apps
  • Add or change a Custom Domain Mapping for your LibAnswers, LibCal, or LibGuides site(s)
  • Create a Certificate Signing Request in order to request a custom HTTPS certificate for your LibGuides site with a custom domain
  • Manage the current HTTPS certificate for your LibGuides site with a custom domain
Also see our help guide on the topic.

Databases Page Stats

We’re pleased to add a long-awaited addition to your statistics interface: A-Z Databases Page hits. These stats show how many hits are made daily or monthly to your AZ list. From August 16, they also show the referring URLs, when that data exists.
Screenshot: the A to Z databases page stats include a graph and data table of hits to az.php

Other Fixes and Features

This release also included:
  • LibAuth:
    • The ability to specify a custom port for SIP2 and LDAP LibAuth configurations.
    • Automatic updating of LibAuth certification fingerprints and IdP configurations.
    • Now when you view an E-Reserves Course’s settings, you’ll see the name of the default LibAuth configuration, if one exists.
  • Resumption of the ability for customers to enter translation files for us. Interested? Please get in touch!
  • Ability to limit AZ Holdings Analysis to library type and location.

Just out: Authenticate to view LibGuides E-Reserves with LibAuth

We have some cool updates to LibAuth-related functionality to share with you today! Need to limit E-Reserves viewing to students and faculty? Limit a LibCal room to just faculty bookings? You totally can, with LibAuth Groups. Please note: currently SAML, Shibboleth / ADFS and CAS are the only authorization protocols that support groups; if you do not see the Group Permissions, then your selected protocol does not support Groups.

More about the existing LibCal functionality in a minute; what we’re really excited about is that you can now enable LibAuth authentication with LibGuides E-Reserves. You can specify which LibAuth profile to use at the system level or at the course level; both make use of Group Permissions.

To designate a LibAuth profile that governs access to all public E-Reserves content, go to Content > E-Reserves > Settings > Authentication.

Screenshot of LibGuides E-Reserves Settings with Authentication accordion expanded

To specify a profile to provide public access to the contents of an individual course, look for the Enable LibAuth Authentication menu in the course’s settings. You can choose the System Default profile, no profile, or a different profile.

Screenshot of E-Reserves Course Settings

LibAuth authentication for E-Reserves only grants access to public pages. Access to manage E-Reserves happens through LibApps accounts and not by virtue of assigning a LibAuth profile in E-Reserves settings. Want to enable LibApps login with LibAuth? You can! Edit your LibAuth profile and enable LibApps authentication, near the bottom of the screen.

To give permission to an authentication group to a group of rooms in LibCal, go to the settings page of the group of rooms and choose the appropriate option from Enable LibAuth Authentication.

LibCal Room Group settings: Study Rooms

If you use LibCal spaces, to go Admin > Spaces & Equipment > Manage Location > Edit > General > Enable LibAuth Authentication.

Screenshot of LibCal Spaces Settings

To enable LibAuth authentication for a calendar, go to Calendars > click the calendar name > Settings > Calendar Settings > Enable LibAuth Authentication.

screenshot of LibCal Calendar settings

Note as with the above configuration: if you choose a protocol that supports groups but do not have groups defined in LibAuth, the additional drop-down to choose a group will not appear.

You can also enable LibAuth authentication for My Scheduler by going to My Scheduler > Appointment Scheduler Settings > Enable LibAuth Authentication.

Need help setting up LibAuth? See our help documentation for more information.

We also squashed a few bugs and put out a few smaller features with this LibGuides code release, namely:

  • Access to v1 statistics
  • EU customer access to the Support site
  • When you clicked on a guide tag, search results weren’t limited to that tag
  • Re-enabled language options

Exciting LTI and LibAuth Updates, and Some LibGuides Fixes, Too

The year may be winding down, but here at Springshare we’re still moving full steam ahead! This latest release provides some great new features for LTI and LibAuth, and some key LibGuides fixes to boot. Let’s get started with the LTI updates…

LTI Updates

Just in time for spring semester planning/course building, we’re rolling out a few updates to LTI that make it easier to set up and provide more options for Automagic display behavior! Everyone does things just a little differently, so we’ve been tweaking and tweaking over time (thanks to your feedback!) to provide as much flexibility with setup as possible, while still using the same overall code for everyone. (We’d particularly like to thank Linda, Chris, and Amanda at Penn State for their invaluable feedback, which resulted in many of the improvements in this update! 🙂 )

Quick reminder:

  • Who can use LTI?
    LibGuides CMS customers; LibGuides customers who subscribe to the E-Reserves module (for E-Reserves content only)
  • Where would I add this tool?
    So far, this is mainly used by Learning Management (LMS) / courseware systems, like Blackboard, Canvas, Desire2Learn, Moodle, and Sakai…though it can be used in any software that supports the LTI framework.

Metadata Importing / Updating

Show of hands…how many of you have been holding off on implementing LTI Automagic because you had to manually add metadata to each guide, course, and/or subject you wanted to pull into your course site? Mmmm hmmm…that’s what we thought. Well, wait no more! And for those of you who have done it already and need to add/update items, rejoice! Metadata importing & updating is here!

Import Metadata

  • Just download the import template, fill it in, and upload to add metadata to guides, courses, and subjects simultaneously. Awesome, right?
  • Even better? Either keep that file handy or do an export of all metadata (use the Template export option) and use that file to update your metadata using that same import function!
  • Head to LibGuides > Admin > Metadata & URLs (previously Subjects, Tags & URLs) to review metadata currently in your system and run your import!

Automagic Matching & Display

Over the past year & a half of LibApps LTI availability, we’ve expanded what you can do with the Manual and Automagic tools greatly, thanks to your feedback. We realized the Automagic content matching options are no longer relevant…matching happens largely in the same way for all 3 original options – it was only the display options that differed. So we made some adjustments to the Setup Options area to reflect the display options instead. We also added a second “failover guide” option!

Content Display BehaviorFor matching, if a single guide or course matches (only one, not one of each), the tool automatically displays that one item. Otherwise, the Library LTI page displays, with all matches listed (if any). You can alter this behavior using the following options…and you can use them in any any combination you wish:

  • When no matches are found, display the following guide. (The dropdown lists all published & private guides from your LibGuides site.)
    This option automatically displays a specific guide instead of the Library LTI page if nothing (no guides, courses, or subjects) matches the parameter value sent from the LMS.
  • Display the Library LTI page when a single matching guide or course is found.
    Basically, always display the Library LTI page – single match, multiple matches, or no matches.
  • (New Option!) When displaying the Library LTI page, display a link to this guide if no matching guides are found. (The dropdown lists all published & private guides from your LibGuides site.)
    Anytime the Library LTI page is displayed, if there is no matching guide to display, the selected guide will display instead.

We’ve mapped your original selections to these new options, so you don’t have to worry about going in to make changes, unless you want to check out / change the options, of course! Here’s how we mapped the old to the new:

  • Option 1 was: “Load a specific guide if there is a direct match, otherwise load the Library LTI page.”
    Now: No additional options are selected.
  • Option 2 was: “Always load the Library LTI page.”
    Now: “Display the library LTI page when a single matching guide / course is found.” is selected.
  • Option 3 was: “Load a specific guide if there is a direct match, otherwise load this pre-selected guide.”
    Now: “When no matches are found, display the following guide.” is selected, with the appropriate guide selected from the dropdown.

Translation Table Updates

LTI Translation Table TemplateIf you use the Translation Table option, especially if you subscribe to E-Reserves, get ready for some great news… The template has been updated to allow matching on different metadata for guides, courses, and subjects for a single entry! For example, if you want to populate the Library LTI page for any given LMS (Blackboard, Canvas, etc.) course section with a general guide and subject, but a specific E-reserves course (for that specific section/instructor), this is perfect! Simply add the different metadata for the guide, course, and/or subject to the template, and you’re good to go! (For example, for my LMS course number 2017S-12345, I might add ENG100 for the related guide, 2017S-12345 for the course, and ENG for the subject.)

And since you can use this in conjunction with the matching options in the previous section, you could also set a general guide (general research, library, or even LibGuides info) to display if there is no matching course-related guide!

As with the matching section above, we’ve mapped your existing Translation Table files to this new format on the back end so it continues to work as before: guide, course, and subject fields all contain the same value.

Other LTI Updates:

  • Manual Tool - Custom NameManual tool + Canvas users: You can now customize the name of your Manual tool so it’s easier to find when adding links in Canvas courses! Go to LibApps > Admin > LTI Tool > Manual > Setup Options to customize yours.
    Important: If you already have the Manual tool installed in Canvas, you must reinstall it to use this feature, which will break existing connections.
  • Desire2Learn customers: LTI should be working (and has been for a little while now). As is true for other LMSes, D2L Admins need to configure the tool to enable sending the user role (Faculty, Student, etc.) & that should do it! The role tells the tool whether or not the user can edit the item, which is required by the Manual tool to initially select the guide / course / database(s) to display to students.
  • Automagic matching no longer returns published Internal or Template guides. In fact, we also removed matching on friendly URL to further ensure this type of thing doesn’t happen in future.
  • Profile pictures on the Library LTI page are now linked to that user’s profile page in LibGuides. (The link will open in a new window.)
  • When an instructor-level user clicked the Automagic link in the LMS course site and the Library LTI page was displayed, there was a note at the top in a yellow box that should’ve only appeared the first time the link was clicked…but appeared every time. That was confusing (and annoying 😉 ), so we removed it.
  • Guides with only one page now display the nav button, as they do when accessed from your LibGuides site.

LibAuth - Add ConfigurationLibAuth Update

We heard from some of you that you have more than one authentication system available at your institution, so we’ve added the capability to utilize any and all of those in LibAuth. Even if you already have an authentication method added in LibAuth, you’ll see the Add Configuration button to get you started on another.

LibGuides Updates

Admin Menu ChangeRemember the Metadata Import news in the LTI section? Well, since LibGuides CMS allows for metadata for more than just LTI, you can use that functionality for any metadata you’d like to add, without having to go to every guide (etc.) to add it! If you skipped that section, scroll back up to learn more…then come on back here to continue reading about LibGuides updates. 😉

Also, this new functionality resulted in an Admin menu name change: Subjects, Tags & URLs is now Metadata & URLs…because otherwise, we’d end up with a crazy-long menu name!

Lastly, there are a few small bugs that we’ve swatted here at Springy HQ to make your LibGuides experience even more awesome!

  • We added a character counter for Twitter posts so that you’ll know when you’re approaching that magic 140 character limit.
  • Patron accounts will no longer be recorded as [Deleted] if they write a long discussion board post and their cookie expires in the meantime.
  • Permitted Uses fields in A-Z Assets now save and delete properly.
  • We changed the text options that you see when editing an RSS asset to reflect the current behavior: show item under title / click on (i) icon.
  • It’s now possible to delete custom metadata from a guide.
  • We’ve fixed the link to E-Reserves contained in E-Reserve Request notification emails.
  • E-Reserves pages in guides with friendly URLs no longer prevent E-Reserve item pop-ups from displaying.

Login to LibGuides (And Other Springy v2 Tools!) Using Your Authentication Layer

LibAuth Login

LibAuth Login

Early this year, we announced greater LibAuth integration with Springshare Tools. One of the components of this integration is the ability to use your own authentication method to login to your v2 Springy tools!

Basically, if you’re using LDAP, CAS, Shibboleth, SAML, ADFS, or a self-hosted authentication tool – you can use that protocol for logging into your LibGuides, LibCal, LibAnswers, etc.

While you’ll still need to have an account in those Springshare tools, you won’t have to remember separate passwords for your Authentication layer and your Springshare apps.

Setting It Up – Cool Winter Project!

Navigate to LibApps > Admin > LibAuth Authentication. You need to be a LibApps admin in order to see this menu. Being a LibApps admin is different than being a LibGuides admin. Contact your LibApps admin if you need to elevate your account status.

On the configuration tab, set up your authentication protocol and be sure to run tests to make sure it’s working. At the bottom of the screen, click “YES” under Allow logging into LibApps using this authentication. Inside your authentication layer, you’ll need to release the email attribute.

LibAuth Authentication

Creating a lot of LibGuides Accounts?

No one wants to click ‘Add Account’ 100+ times when adding all of your LibGuides authors. But, they do need to have a LibGuides account for the authentication integration to ‘connect’. So, we’ve got a workaround that will make things much faster for LibGuides admins!

  • Setup your LibAuth login credentials (see above)
  • Login to LibGuides > Admin > Accounts
  • Click ‘Invitations’ Tab > Invite Users Button
  • Paste in email addresses for all your LibGuides authors (paste in hundreds of emails!)
  • Choose account level > hit send!
  • Authors will receive an invitation to create an account password however, their account has been ‘created’ so they can sign into LibGuides using your authentication layer!

Important Things to Note:

  • Not available with SIP2 – SIP does not contain the email attribute, so we’re not able to offer this option for SIP2 authentication services.
  • Granular Permissions – Are still managed at the Springshare Tool level. So granting access to specific tools and areas within those tools are handled inside LibGuides, LibAnswers, LibCal, etc.

But Wait, There’s More!

Authentication in LibCalIf you haven’t had a chance to check it out, there are amazing LibAuth integrations with LibCal. You can route users through your authentication layer for Room Bookings, Calendar Event Registrations, Equipment Bookings module, and even My Scheduler Librarian appointments.

It’s Just the Beginning!

This release is just phase one of our big plans for LibAuth integration with Springy Tools. We hope to integrate authentication services inside all of our Springshare apps! Just imagine, routing LibWizard quiz takers through your authentication service. Or allowing students to post on discussion boards or comments on your blog through your active directory of users. Or using your authentication protocols before patrons can initiate a LibChat chat exchange. This is just the beginning of great things to come!

Introducing LibAuth – Authentication for Springshare Tools

We are excited to announce a new tool in Springshare’s cloud platform of apps – LibAuth. LibAuth is our implementation of patron authentication inside Springshare apps and systems. This is important new functionality which will make Springshare tools even more useful and more applicable to a wide variety of use-case scenarios within libraries. We have big plans for LibAuth and will be enhancing it further to offer innovative authentication-based solutions and services to our libraries.

But first things first. LibAuth is a free module inside our LibApps platform.  In essence, if you use any of our v2 tools (LibGuides, LibAnswers, LibCal, LibInsight, etc.) you automatically get LibAuth. Your Springshare LibApps admin configures LibAuth to link to the authentication method used at your institution. We currently support Shibboleth, LDAP, SAML, CAS, SIP2, and a remote self-hosted script option. If your institution relies on a method not listed here, please contact us and we’ll investigate how to make it happen! Springshare is also a member of InCommon and the UK Federation which makes authentication setup even easier for institutions who are members of either of these federations.

So, if you are the super-admin of Springshare tools at your institution (we call these LibApps admins) head to LibApps Dashboard -> Admin -> Manage Authentication (see screenshot below) and configure your authentication method.

LibAuth Setup Location

 

 

Click on the “Manage Authentication” link in the navbar to enter the details of your authentication method and select attributes to release to Springshare. It is very likely that you will need to work closely with your IT folks to set this up so we recommend that you have your IT folks on good terms 😉 while setting up LibAuth. The setup form also provides testing tools to ensure you set things up correctly.

Pro tip: LibAuth also lets you define and configure any number of “rules” – for example if certain functionality should only be available to faculty or to undergraduates etc – as long as your authentication supports it and you release the necessary attributes to Springshare, you can setup all sorts of rules to be used in Springshare (and later in non-Springshare) apps.

 

libauth-setup

 

 

Once you successfully setup your authentication scheme in LibAuth, here’s what happens next.

  1. At your option, your librarians with access to a LibApps account (to work on LibGuides, LibAnswers, LibInsight etc) can login to these tools using LibAuth, i.e. using their campus/library username/pwd.
  2. Starting tomorrow, LibCal room booking functionality is ready to work with LibAuth. Once you set up and verify your authentication method via LibApps, head to LibCal > Room Bookings > Settings > Edit Group to require LibAuth authentication for that group of rooms. If you’ve previously setup room booking authentication inside LibCal, we’ll automatically transfer those settings to LibAuth so you’re all set (but check the LibAuth console to confirm and do a couple of room booking tests, just to make sure).
  3. Over the next few weeks we will turn on authentication support for Event Registrations and Librarian Appointments so you will be able to restrict these (optionally of course) to your authenticated users (or groups) only.
  4. Over the next month we will turn on LibAuth authentication in our E-reserves module (our library reserves/reading list solution). This way our ER module will not only be the most affordable Reserves/Reading solution, but also one of the most secure ones too ;).
  5. In the next 3-4 months we will add support for LibAuth inside all of our apps, wherever and whenever needed. We’d love your feedback and ideas on this – email our support or sales teams and let us know where you think we should add authentication support (inside which Springshare apps and for what use-case scenarios). This is a really exciting and really big development for us, and we truly feel that adding authentication points inside our apps will bring many more use-case scenarios which will make your Springshare tools even more useful and will make you love ’em even more!
  6. Over the next 6-12 months we will be adding new products and services based on LibAuth capabilities, and we will be releasing an API to use LibAuth anywhere. Yes, we’re going there! We believe there are many opportunities ahead for providing seamless authentication that “just works” inside other library products and services. Send us your ideas, we’d love to hear from you.

 

Last but not least – please bear with us over the next few weeks regarding support and fixing any issues you may encounter while setting up your authentication method in LibAuth. We did tons of testing but with so many different authentication setups out there the best way to test and fix any issues is to release it into the wild and invite everyone to start using it. So while this is not “beta” because the full functionality is there and it works, we appreciate your patience while we ensure that it works well for everyone.

Thank you to all our clients who helped us during LibAuth development, with your excellent feedback and suggestions. We’re starting 2016 with a bang, and we have so many new things in store for our clients this year (and beyond). Thank you all for being the best clients, ever!

-Slaven & The Springshare Team