Great Reading Adventure v4.5.0

Release Notes: 4.5.0

Introduction

The Great Reading Adventure is a robust, open source software designed to manage library reading programs. The GRA is free to use, modify, and share. Check out www.greatreadingadventure.com for an overview of its functionality and capabilities.

Release

These release notes accompany 📚 The Great Reading Adventure version 4.5.0 which can be downloaded from GitHub or run in Docker from the Docker Hub or GitHub Packages.

Upgrading

If you wish to upgrade from a previous release of version 4 see the upgrading section of the manual. There is no upgrade path from versions 2 or 3 to this release due to significant architectural changes.

Documentation

For information on what is required to run the Great Reading Adventure, please refer to the online manual. The software requires a hosting environment including Microsoft .NET 8.0 and Microsoft SQL Server. If you don’t have such an environment, there are plenty of Web hosting services you can use.

Changes in this release

Notable changes:

• Upgrade to ASP.NET Core version 8.0

Notable changes from the prior release:

• Retain participant challenge filter selections in the session
• Change display of "Program" on the participant side to "Age Group"
• Welcome email capability with sending delay after program signup, maximum number of emails limit
• Fix avatar scrolling bug at mobile responsive level
• Streamlined account creation abilities via authorization codes
• Performer scheduling enhancements including coversheet generation, streaming improvements
• Performer spreadsheet export
• Job system with scheduled tasks for sending emails
• Improve hold slips to include age group and group name, allow generation without marking received
• Fix issues resulting in participants having multiple assigned vendor codes

For more detailed information about changes in this release please review the change log.

Known issues

For up-to-date information about known issues please refer to the discussions and the GitHub issue list.

Great Reading Adventure v4.4.2

Release Notes: 4.4.2

Introduction

The Great Reading Adventure is a robust, open source software designed to manage library reading programs. The GRA is free to use, modify, and share. Check out www.greatreadingadventure.com for an overview of its functionality and capabilities.

Release

These release notes accompany 📚 The Great Reading Adventure version 4.4.2 which can be downloaded from GitHub or run in Docker from the Docker Hub or GitHub Packages.

Upgrading

If you wish to upgrade from a previous release of version 4 see the upgrading section of the manual. There is no upgrade path from versions 2 or 3 to this release due to significant architectural changes.

Documentation

For information on what is required to run the Great Reading Adventure, please refer to the online manual. The software requires a hosting environment including Microsoft .NET 7.0 and Microsoft SQL Server. If you don’t have such an environment, there are plenty of Web hosting services you can use.

Changes in this release

Here are some notable changes:

• Retain participant challenge filter selections in the session
• Change display of "Program" on the participant side to "Age Group"
• Welcome email capability with sending delay after program signup, maximum number of emails limit
• Fix avatar scrolling bug at mobile responsive level
• Streamlined account creation abilities via authorization codes
• Performer scheduling enhancements including coversheet generation, streaming improvements
• Performer spreadsheet export
• Job system with scheduled tasks for sending emails
• Improve hold slips to include age group and group name, allow generation without marking received
• Fix issues resulting in participants having multiple assigned vendor codes

For more detailed information about changes in this release please review the change log.

Known issues

For up-to-date information about known issues please refer to the discussions and the GitHub issue list.

Great Reading Adventure v4.4.1

Release Notes: 4.4.1

Introduction

The Great Reading Adventure is a robust, open source software designed to manage library reading programs. The GRA is free to use, modify, and share. Check out www.greatreadingadventure.com for an overview of its functionality and capabilities.

Release

These release notes accompany 📚 The Great Reading Adventure version 4.4.1 which can be downloaded from GitHub or run in Docker from the Docker Hub or GitHub Packages.

Upgrading

If you wish to upgrade from a previous release of version 4 see the upgrading section of the manual. There is no upgrade path from versions 2 or 3 to this release due to significant architectural changes.

Documentation

For information on what is required to run the Great Reading Adventure, please refer to the online manual. The software requires a hosting environment including Microsoft .NET 7.0 and Microsoft SQL Server. If you don’t have such an environment, there are plenty of Web hosting services you can use.

Changes in this release

Here are some notable changes:

• Configurable side-wide point goal displayed on dashboard to participants
• Better supports for Google Analytics 4 and events
• Decouple vendor codes from participants; allow a participant to be reassigned a code if needed
• Handle participant reassignment if their branch is deleted
• Packing slip improvements in display and ability to print hold slips
• View user change history from Mission Control
• Prize view for participants
• Allow assocation of a certificate (PDF file) to a trigger
• Mission Control news posts can now be updated and jumped back to the top of the display queue
• Allow vendor code list upload to invalidate and assign new codes to customers
• Return proper HTTP codes on page errors

For more detailed information about changes in this release please review the change log.

Known issues

For up-to-date information about known issues please refer to the discussions and the GitHub issue list.

Great Reading Adventure v4.4.0

Release Notes: 4.4.0

Introduction

The Great Reading Adventure is a robust, open source software designed to manage library reading programs. The GRA is free to use, modify, and share. Check out www.greatreadingadventure.com for an overview of its functionality and capabilities.

Release

These release notes accompany 📚 The Great Reading Adventure version 4.4.0 which can be downloaded from GitHub or run in Docker from the Docker Hub or the GitHub Packages.

Upgrading

If you wish to upgrade from a previous release of version 4 see the upgrading section of the manual. There is no upgrade path from versions 2 or 3 to this release due to significant architectural changes.

Documentation

For information on what is required to run the Great Reading Adventure, please refer to the online manual. The software requires a hosting environment including Microsoft .NET 7.0 and Microsoft SQL Server. If you don’t have such an environment, there are plenty of Web hosting services you can use.

Changes in this release

Here are some notable changes:

• Update framework to ASP.NET 7.0

Notable changes in the last release include:

• Fully-integrate email templating and sending
• Add challenge sorting options (most recent, most popular) and category colors
• Add challenge groups
• Show reasons in Mission Control why user history items cannot be deleted
• Add ability to set a program-wide alert on the dashboard page
• Site setting to show secret code on streaming event pages
• Allow administrative toggle of avatar sharing, mail
• Additional vendor code reports and packing slip functionality
• Fix social card cache expirations
• Improve front-end packaging for stylesheets and scripts

For more detailed information about changes in this release please review the change log.

Known issues

For up-to-date information about known issues please refer to the discussions and the GitHub issue list.

Great Reading Adventure v4.3.17

Release Notes: 4.3.17

Introduction

The Great Reading Adventure is a robust, open source software designed to manage library reading programs. The GRA is free to use, modify, and share. Check out www.greatreadingadventure.com for an overview of its functionality and capabilities.

Release

These release notes accompany 📚 The Great Reading Adventure version 4.3.17 which can be downloaded from GitHub or run in Docker from the Docker Hub or the GitHub Packages.

Upgrading

If you wish to upgrade from a previous release of version 4 see the upgrading section of the manual. There is no upgrade path from versions 2 or 3 to this release due to significant architectural changes.

Documentation

For information on what is required to run the Great Reading Adventure, please refer to the online manual. The software requires a hosting environment including Microsoft .NET 6.0 and Microsoft SQL Server. If you don't have such an environment, there are plenty of Web hosting services you can use.

Changes in this release

Here are some notable changes:

• Update framework to ASP.NET 6.0
• Fully-integrate email templating and sending
• Add challenge sorting options (most recent, most popular) and category colors
• Add challenge groups
• Show reasons in Mission Control why user history items cannot be deleted
• Add ability to set a program-wide alert on the dashboard page
• Site setting to show secret code on streaming event pages
• Allow administrative toggle of avatar sharing, mail
• Additional vendor code reports and packing slip functionality
• Fix social card cache expirations
• Improve front-end packaging for stylesheets and scripts

For more detailed information about changes in this release please review the change log.

Known issues

For up-to-date information about known issues please refer to the discussions and the GitHub issue list.

Great Reading Adventure v4.2.1

Release Notes: 4.2.1

Introduction

The Great Reading Adventure is a robust, open source software designed to manage library reading programs. The GRA is free to use, modify, and share. Check out www.greatreadingadventure.com for an overview of its functionality and capabilities.

Release

These release notes accompany 📚 The Great Reading Adventure version 4.2.1 which can be downloaded from GitHub or run in Docker from the Docker Hub or the GitHub Packages.

Upgrading

If you wish to upgrade from a previous release of version 4 see the upgrading section of the manual. There is no upgrade path from versions 2 or 3 to this release due to significant architectural changes.

Documentation

For information on what is required to run the Great Reading Adventure, please refer to the online manual. The software requires a hosting environment including Microsoft .NET 5.0 and Microsoft SQL Server. If you don’t have such an environment, there are plenty of Web hosting services you can use.

Changes in this release

Here are some notable changes:

• Improve accessibility on the public-facing areas of the site
• Import and export of Systems/Branches and Districts/Schools
• Daily images: Mission Control interface; click tracking
• Mission Control interface to manage and schedule social cards
• Vendor codes: Mission Control management interface; packing slip uploads
• Expanded length of streaming program links to 2000 characters
• News posts now send emails through the job interface to avoid timeouts
• Search for nearby events based on coordinates or ZIP code
• Allow special characters in authorization codes
• Fix operation of "Add Book" button prior to program open
• Show participating libraries and link to participant's library in the footer

For more detailed information about changes in this release please review the change log and related issues on GitHub.

Known issues

For up-to-date information about known issues please refer to the discussions and the GitHub issue list.

Great Reading Adventure v4.2.0

Release Notes: 4.2.0

Introduction

The Great Reading Adventure is a robust, open source software designed to manage library reading programs. The GRA is free to use, modify, and share. Check out www.greatreadingadventure.com for an overview of its functionality and capabilities.

Release

These release notes accompany 📚 The Great Reading Adventure version 4.2.0 which can be downloaded from GitHub or run in Docker from the Docker Hub or the GitHub Container Registry.

Upgrading

If you wish to upgrade from a previous release of version 4 see the upgrading section of the manual. There is no upgrade path from versions 2 or 3 to this release due to significant architectural changes.

Documentation

For information on what is required to run the Great Reading Adventure, please refer to the online manual. The software requires a hosting environment including the Microsoft .NET 5.0 framework and Microsoft SQL Server. If you don’t have such an environment, there are plenty of Web hosting services you can use.

Changes in this release

There are a lot of changes in this release, here are some of the more notable ones:

• Update to the Microsoft .NET 5.0 framework
• Internationalization of the customer-facing site including Spanish language translations
• Add method for staff to activate unfired triggers via Mission Control
• Schedulable carousel of materials or links can now be placed on the dashboard
• Functionality to allow performers to self-register and staff to select performances for their locations
• News area (with categories) of Mission Control for providing communications to staff with email subscriptions
• Proximity search for events (i.e. 'find events near me')
• Add exit page to provide call-to-action after logout
• Built-in job system using WebSockets so long-running processes don't time out (e.g. avatar import, reports, sending emails, etc.)
• Ability to send emails from in the software to people who have signed up for pre- or post-program lists and participants
• Allow participants to add books to their book list independent of logging activity
• Add maximum file size, dimensional size, and square dimensional requirement for badge images
• New streaming event category with ability to allow scheduled viewing of streams
• Lots of bug fixes and performance improvements

For more detailed information about changes in this release please review the change log and related issues on GitHub.

Known issues

For up-to-date information about known issues please refer to the discussions and the GitHub issue list.

Great Reading Adventure v4.1.1

Release Notes: 4.1.1

Introduction

The Great Reading Adventure is a robust, open source software designed to manage library reading programs. The GRA is free to use, modify, and share. Check out www.greatreadingadventure.com for an overview of its functionality and capabilities.

Release

These release notes accompany 📚 The Great Reading Adventure version 4.1.1 which can be downloaded from GitHub!

Upgrading

There is no upgrade path from versions 2 or 3 to this release due to significant architectural changes. If you wish to upgrade from a previous release of version 4 see the upgrading section of the manual.

Documentation

For information on what is required to run the Great Reading Adventure, please refer to the online manual. The software requires a hosting environment including the Microsoft .NET Core 2.2 framework and Microsoft SQL Server. If you don’t have such an environment, there are plenty of Web hosting services you can use.

Changes in this release

Notable changes in this release:

• Update to the Microsoft .NET Core 2.2 framework
• Add better capabilities to customize the site (and document them)
• Fix a number of bugs that were introduced in the move from ASP.NET Core 1.1 to 2.1 (sorry about that!)

For more detailed information about changes in this release please review the change log and related issues on GitHub.

Known issues

For up-to-date information about known issues please refer to the forum and the GitHub issue list.

Great Reading Adventure v4.1.0

Release Notes: 4.1.0

NOTE: After version 4.1.0 was released we caught some additional issues in the software. Our recommendation is to move to v4.1.1 when you can.

Introduction

The Great Reading Adventure is a robust, open source software designed to manage library reading programs. The GRA is free to use, modify, and share. Check out www.greatreadingadventure.com for an overview of its functionality and capabilities.

Release

These release notes accompany 📚 The Great Reading Adventure version 4.1.0 which can be downloaded from GitHub!

Upgrading

There is no upgrade path from versions 2 or 3 to this release due to significant architectural changes. If you wish to upgrade from a previous release of version 4 see the upgrading section of the manual.

Documentation

For information on what is required to run the Great Reading Adventure, please refer to the online manual. The software requires a hosting environment including the Microsoft .NET Core 2.1 framework and Microsoft SQL Server. If you don’t have such an environment, there are plenty of Web hosting services you can use.

Changes in this release

Notable changes in this release:

• Update to the Microsoft .NET Core 2.1 framework
• Add official Docker image support
• Allow maximum allowable activity to be configured without requiring code changes

For more detailed information about changes in this release please review the change log.

Known issues

For up-to-date information about known issues please refer to the forum and the GitHub issue list.

Great Reading Adventure v4.0.0

Release Notes: 4.0.0

Introduction

The Great Reading Adventure is a robust, open source software designed to manage library reading programs. The GRA is free to use, modify, and share. Check out www.greatreadingadventure.com for an overview of its functionality and capabilities.

Release

These release notes accompany 📚 The Great Reading Adventure version 4.0.0 which can be downloaded from GitHub!

Two release packages are available:

• The v4.0.0 release package includes over 4,000 avatar assets extracted from Glitch the Game.
• The v4.0.0-noavatars release package excludes avatar assets (they can be downloaded and added later from the defaultavatars-4.0.0 file).

For more information on installing and configuring avatars, see the avatar section of the manual.

Upgrading

There is no upgrade path from versions 2 or 3 to this release due to significant architectural changes. If you wish to upgrade from a previous release of version 4 (i.e. 4.0.0-beta1 and 4.0.0-beta2) see the upgrading section of the manual.

Documentation

For information on what is required to run the Great Reading Adventure, please refer to the online manual. The software requires a hosting environment including the Microsoft .NET Core 1.1 framework and Microsoft SQL Server. If you don’t have such an environment, there are plenty of Web hosting services you can use.

Changes in this release

Notable changes in this release:

• If Google Analytics is configured, an event triggers when a participant joins (track the source of sign-ups)
• Ability to add links to external survey (can be a different link for first time participants)
• Added new and enhanced existing reports, improved reporting date selection, showing report criteria on report and in exports
• Added templates for front page and dashboard views to the shared folder to make customization easier

For more detailed information about changes in this release please review the change log.

Known issues

Here’s a selection of some notable currently-known issues:

• Once a broadcast is created it cannot be deleted, only superseded with subsequent broadcasts (issues #308 and #309).
• Avatar management is designed to use our Glitch avatar package, full avatar management isn’t functional yet (issue #261).

For up-to-date information about known issues please refer to the forum and the GitHub issue list.