Updating: to 2.0.0
Version 2 of Lorekeeper brings several new features and improvements, including the integration of the previous modified-main branch and its extensions, the integration of Extensions:Galleries, and the expansion of social media sites available for user authentication. On a technical level, this includes updating Lorekeeper to Laravel 8 (from version 1.x's 5.8); while the impact of this is relatively limited, it has some minor impacts in what methods are used for some tasks.
Contents
New in v2
Extensions and features from modified-main
modified-main was a branch incorporating several community-developed Extensions selected for their wide applicability and for falling into one of the following categories:
- An unavoidable change in behavior, but one that is arguably a net quality-of-life improvement. May also be highly useful as a base for other extensions to build upon.
- Opt-in/must be deliberately enabled for significant changes in the behavior of the site to occur. No more obtrusive than effectively optional functions in core Lorekeeper if not in use.
It includes certain extensions on an opt-in basis via a config file; these extensions tend to be sufficiently contained for this to be a viable option.
Also included are several minor but useful features:
- Grouped Notifications: To account for the potentially large variety and potentially volume of notifications, they are grouped by notification type and collapse when there are more than 5 notifications of a type.
- Toggleable Comments on Site Pages: Adds a toggle to site pages which enables/disables commenting on them. Disabled by default.
- Extension Service: A utility for use by extension developers. By default, facilitates adjusting notification type IDs in a site's DB to comply with the Community Notification Standard. See the this command (made for Character Items) for an example of how to use this functionality.
Included Extensions
Documentation (where it exists) for these extensions can be viewed via Category: Extensions in modified-main.
- Draginraptor : Extensions:Stacked Inventories
- itinerare : Extensions:Submission Addons
- itinerare : Extensions:Character Items
- Preimpression : Extensions:Bootstrap Tables
- itinerare : Extensions:Watermarking
- itinerare : Extensions:Separate Prompts
- Preimpression & Ne-wt : Extensions:Comments
- Ne-wt : Reports System : Adds the ability for users to submit general and bug reports, as well as providing a visible list of current, non-sensitive (exploit) bugs.
- Junijwi : Extensions:Masterlist Sublists
- Junijwi : Extensions:MYO Item Tag
Opt-In Extensions
- Junijwi : Navbar News Notif - Has also been modified to apply to sales
- itinerare : Species Trait Index
- Junijwi : Character Status Badges
- Junijwi : Character TH Profile Link
- itinerare : Design Update Voting
- itinerare : Item Entry Expansion (Stacked Inventories version)
Updating to v2
As of v2, Lorekeeper now requires php 7.4 (previously was 7.2). No other requirements are changed.
Summary
- Update your server to use php 7.4
- Pull the updates, resolving any merge conflicts as appropriate
- Make any config file changes
- (Recommended) Put your site in maintenance mode via
php artisan down
- Push updates
- Run
composer update
or equivalent and thenphp artisan update-lorekeeper-v2
- (Recommended) Verify that no errors have occurred and use
php artisan up
to remove your site from maintenance mode - Perform any configuration desired within the site