Be notified of new releases
Create your free GitHub account today to subscribe to this repository for new releases and build software alongside 31 million developers.Sign up
Release Notes: 4.0.0-beta2
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.
These release notes accompany
There is no upgrade path from versions 2 or 3 to this release due to significant architectural changes.
Upgrading is possible from deployed instances of version 4. Note that during the upgrade there will be an interruption in service so it may be ideal to schedule this upgrade in off hours. To upgrade from prior versions (i.e. 4.0.0-beta1) follow these steps:
- Back up the database and the files that comprise the Web site.
- If you have modified any files in the application (such as
.cshtmlRazor template files), please make a note of which changes you’ve made, these changes will have to be performed again. Changes to the
shareddirectory (such as to
style.cssor uploaded files) will be maintained.
- Replace the application files with the files from this release. Ensure that your
shareddirectory is not overwritten when replacing application files.
appsettings.jsonfile in the application folder will be replaced when you copy in files from the release. If you modified this file please compare to the file you backed up in the first step above to ensure any configuration changes you made initially are set in the new file. If you added an
appsettings.jsonfile in the
shareddirectory with your settings it will not be overwritten and you shouldn’t need to change any settings.
- Load the site. It will take longer than normal as the database is upgraded (you can see evidence of the database upgrade in the log file in
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:
- Households can now be upgraded to groups by administrators regardless of household size
- Structured data for events
- Friendly 404 page
- Bundled CSS and JS assets (smaller and fewer files)
- Added the ability to set a culture for displaying dates and times (defaulting to ‘en-US’ with 12-hour times)
- Automatically select School District during registration if there’s only one
- Mission Control management of point translations, authorization codes, roles, participant role assignments
- Ability to send test emails from Mission Control
- Vendor code improvements (reports, additional email token)
- Fixed issues with household leads and groups in Mission Control
For more detailed information about changes in this release please review the change log.
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).