Archive for Accessibility

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.

LibCal Equipment Booking Update Coming Your Way

On the heels of last month’s major LibCal Spaces update, this month we’re bringing the same types of accessibility and mobile-friendly updates to the Equipment Booking module! 🙂  This required some changes to the Equipment Booking grid and the booking details / confirmation pages, so if you’ve customized those, you’ll want to check your system post-update on August 16, 2017 (U.S. time) to make sure everything looks as it should. Remember, we’re here to help if you have any questions.

Here’s what’s new:

  1. The screens for Equipment Booking (the availability grid and the checkout process) are now fully accessible and mobile-optimized. The previous version was not fully up to par in this regard. We apologize for this omission, but we worked hard to address this problem quickly.
  2. Major API improvement: check whether or not the booking will go through, before actually making the booking! (This is applicable to the Spaces and Equipment APIs.)
  3. Admins can set up LibAuth rules on a Category-level and individual Item-level for Equipment pieces.
  4. Category-level mediators and visibility settings now available in Equipment Booking. Previously, the mediation and visibility was setup at the Location level only. This update introduces the same settings on the category level, for additional flexibility in organizing your Equipment Booking rules.
  5. Availability grid colors (for available slots, booked/unavailable slots, and “your selection” slots) are now customizable via color picker. The customized colors appear on both the public and admin sides of the system. Head to Admin > Equipment & Spaces > Settings to find these options.

Get Trained / Take a Tour
Note: All times listed are U.S. EDT.

Attend an Equipment Booking training webinar!

Next Sessions: Wednesday, August 16, 2017:

Don’t have Equipment Booking yet? Take a tour!

We’ve also squashed several bugs and shined up some screens:

  • When exporting lists of events via CSV, HTML is now stripped from the event description text.
  • Closing hours no longer overlap with opening hours, so there’ll be no more entering the 4th dimension of the space-time continuum!
  • The “system time” format now displays consistently in all modules (spaces, equipment booking, events, hours).
  • The “Add Item” button no longer shows when Equipment Booking is disabled.
  • Event organizer profiles now show on event pages when LibAuth is enabled.
  • My Scheduler widgets now display properly within the LibApps LTI tool.
  • You can now use calendar widgets from different locations on the same webpage.
  • Fixed an issue where recurring bookings sometimes couldn’t be created before existing bookings.
  • Fixed a display problem with the “no timeslots are available” message in widgets.

In addition to all of these changes and fixes, we’ve made further iterative improvements to the speed of the system, so the screens are now even zippier and more responsive. After August 16th, LibCal will be an even better calendaring and booking platform for libraries, but our work is not done. Your amazing feedback, suggestions, and ideas are central to our success, so please keep them coming! In the upcoming months we’ll release more updates based on customer feedback, so you can expect more good things to come LibCal’s way.

Thanks to everyone who contributed the ideas that went into this release! 🙂

-The Springshare Crew

LibCal Space Bookings Update – All About Accessibility and Mobile Access

We love collaborating closely with our clients and taking their feedback & ideas to make our tools better for the entire community. Today’s LibCal code update is the result of one such collaboration. Namely, the LibCal implementation team at the University of Arizona was getting ready to roll out the Spaces booking system using LibCal when they noticed several accessibility and usability issues with the default spaces booking screens on mobile devices.

 

So, we worked with them on fixing many Spaces booking mobile-view issues and implementing accessibility improvements as well. Given the importance of accessibility for our clients, and the fact that an increasing number of patrons use mobile devices for bookings,  we wanted to release these improvements to production servers asap. Basically, the accessibility and mobile improvements trump everything else! Today (Monday) the changes were made live on US servers, and tomorrow (Tuesday) the changes will be live on EU and Canadian servers, too.

 

What Has Changed?

The booking process for Spaces (not the old Room Bookings, but the new Spaces Bookings) is very slightly different but much improved! We did a thorough testing run to ensure that nothing broke with existing customizations. The results were encouraging but we urge all admins to check their Spaces customizations and go through a sample booking of a space, to ensure everything looks good in your system. If you need assistance with any customization tweaks, please reach out to support and we’ll take care of it asap.

It’s important to know that these changes only affect the Spaces booking. The Equipment booking is next in line for accessibility and mobile-view improvements, and we plan to release Equipment booking improvements in a few weeks (around Aug 15th). Here are the changes:

  1. The Spaces booking grid now looks good on mobile devices, with larger/more tap-able grid which can now be used to book multiple spaces. Plus, it’s accessible, too!
  2. The Dates-related buttons in the top right corner of the booking grid are now larger, for easier emphasis, and accessible / they “glow” nicely into new line on small mobile screens.
  3. The legend for color coding of the grid now looks like real legend, rather than looking like small button labels which can be confusing to users.
  4. The Spaces booking calendar now defaults to the current hour of the day as much as possible given the screen size issues. This is great for mobile screens because it minimizes the amount of scrolling required.
  5. The Info button for more information about a space is now accessible and mobile-friendly, as is the resulting modal window showing more info about a given space.
  6. The Booking Details section is now presented in a grid for better mobile layout and accessibility.
  7. Separate Terms & Conditions sections are now condensed into one shaded area so that it looks better on mobile screens.
  8. The Thank You screen is more verbose with a bit more detail on what happens next (this text is customizable as well, via language tokens).
  9. The customizable Date formats now apply consistently across the Spaces bookings screens.
  10. “Add Equipment” button no longer appears unless there is equipment a the location the user is at (duh, right? We agree, and sorry about this bug).
  11. “Submit Times” button wording is now fully customizable using the language tokens.

 

What Is New? 

Besides these mobile and accessibility changes to the existing screens, we also used this code update opportunity to introduce bunch of important new features. We know you are going to love these, and they will make LibCal even more fully featured spaces booking platform. This is the new stuff/new functionality we rolled out:

  1. LibAuth authentication booking restrictions now work (optionally, of course) on a Category level or even on individual Item level too. Imagine the possibilities – set the rules as to who can reserve a given space on an item level – this specific conference room can only be booked by Staff, or this Category of auditorium spaces can only be booked by Faculty… this new feature truly opens exciting possibilities for the utility and usefulness of LibCal at your institution.
  2. Capacity display is now optional in the booking grid/table. So many of you asked to hide this using CSS tricks. Now you can do it “the right way”  – head to admin>equipment & spaces>settings>public spaces settings>capacity information, and you can choose to hide the capacity label.
  3. Spaces can now be set to show either a single day’s worth of availability, or the multi-day slider we use right now. Change under admin>E&S>settings. This was another frequent feature request.

 

That’s it for this release! We know, it’s a lot. And all good stuff, too. Over the next 2 weeks we will work on similar changes (accessibility improvements and mobile-friendly view) for the Equipment Bookings so stay tuned… and please do not hesitate to reach out about any of the changes we have introduced today. We stand ready to help with any customization issue that may pop up.

Big thanks to the library team at the University of Arizona for their help in getting these improvements out quickly, for the benefit of the entire 1,000+ strong LibCal community.