Greetings magnificent Flarumites!
"I believe we are most beautiful when we are constantly shedding our old selves and moving into new light."
-- Suki Waterhouse
Australian Southern Cassowary
📣 The Release
After a 2 month release cycle, we are excited to bring you Flarum beta 16! In addition to being packed full of features, fixes, and other improvements, this is a very special release because it is the first release candidate for Flarum 1.0. Essentially, this means that Beta 16 contains all the essentials needed to be considered stable; from here to the stable release, it's just fixes, cleanup, and additional improvements. Barring catastrophe, the next release will be the long awaited Flarum stable!
🔔 What’s Changed?
This release was geared towards stabilizing the extension API and completing some important refactors in our code base, but it also comes with multiple improvements to the end user experience and the great developers in our community. Bringing us closer than ever to stable, here are some highlights:
There are a bunch more! If you're into this, feel free to scour our changelogs and releases for all bundled extensions on GitHub.
👨💻 For Developers
If you are a developer please understand there are many changes (some breaking) in this release, make sure to read the full upgrade guide in our docs! Some key points:
- PHP 7.2 is no longer supported.
- The search system has been revamped and split into searching and filtering, this means many classes are now deprecated and will be removed in the next release.
- A frontend typings package for core has been released; to use it, run
npm install --save-dev email@example.com
- Access tokens have been refactored, details can be found in the upgrade guide.
- Many events have been removed, please use the new extenders as replacement.
app helper has been renamed to
resolve, and the
event helper deprecated, a new package
flarum/laravel-helpers has been introduced.
- Support for
bootstrap.php has been dropped, use
- Other changes are mentioned in the upgrade guide for this release.
Developers are urged to check the changelogs of relating packages when they discover issues. You can review the Beta 16 Upgrade Guide to ensure your extensions are up to date.
If you have any questions or run into any obstacles in upgrading, please open a new discussion in the Dev tag or find us in #extend on our Discord.
Before you run the upgrade, make sure to create a backup of your
public/assets directory, your
composer.json and your database!
Step 1: Ensure you are on version 0.1.0-beta.15 in your Admin Dashboard or by running
php flarum info (use the previous release notes for upgrading from an earlier version)
Step 2: Uninstall every 3rd party extension that isn't compatible with beta 16 yet. You can check which extensions are compatible at Extiverse (it needs up to one hour after release to display compatible extensions) or use the extiverse helper.
Step 3: Disable the remaining extensions. Re-enabling them one at a time after you update will make it easier to debug if any issues occur.
Step 4: Run the following commands:
If Composer v1 (please upgrade to v2):
composer update --prefer-dist --no-dev -a --with-all-dependencies
php flarum migrate
php flarum cache:clear
If Composer v2:
composer update --prefer-dist --no-plugins --no-dev -a --with-all-dependencies
php flarum migrate
php flarum cache:clear
Step 5: Use your newly-upgraded Flarum site!
If you run into any problems, please open a new discussion in the Support tag. There may be discussions of similar issues, but open a new one anyway, it helps us get your specific problem resolved faster.
If the problem persists – we're here to help! Make sure to include the output of
php flarum info. Please also include the output of
composer why-not flarum/core v0.1.0-beta.16.
Flarum releases wouldn't be possible without a multitude of people, our thanks go out to all of them! Thank you...
To everyone who contributed code this release, especially @davwheat, @rob006, @ajaypayne, @w-4, @010101, @Qiaeru, @OrangeTurtle197, @skmedix, imzhi , daniellesniak, emamulkhan.
To our eagle-eyed bug reporters, especially @matteocontrini, @davwheat, @ajaypayne, @Justoverclock, @ornanovitch, @iPurpl3x, @Kakifrucht, @ctml, @Dem13n. harry-wg.
To the incredible team behind Flarum, including @luceos, @jordanjay29, @datitisev, @clarkwinkelmann, @tankerkiller125, @askvortsov, @SychO, @Kyrne, @Prosperous, @Digital, @Pollux, @katos, @Ralkage, @ianm and @Deebug.
To every Open Collective supporter and Github Sponsor, but especially:
Your continued support is extremely helpful, being fundamental to stable development for Flarum! Help us become a sustainable project by backing us on Open Collective or on GitHub.
And finally, to you for your ongoing support and enthusiasm that keeps us all going!