Hello to my magnificent Flarumites!
As we meet the month of May, it is with great merriment that I present our newest release:
Flying Fox
π£ The Release
This release contains several new items and fixes, as we continue to refine the core software on the way to our stable version.
π Whatβs Changed?
We spent this release focused on changes to make the experience better for Flarum, both for the great developers in our community and for administrators of Flarum sites.
There are a bunch more! If you're into this, feel free to scour our changelogs and releases on GitHub.
π¨βπ» For Developers
If you are a developer please read this carefully, there are several breaking changes in this release!
Due to popular request, we're including information about extension breaking changes into this announcement. Beta 13 has several breaking changes that you should be aware of! See the full upgrade guide in our docs.
- PHP 7.1 is no longer supported.
- Zend libraries have been completely removed, please update to the Laminas packages instead.
- The
Flarum\Util\Str
class has been been removed.
- Several events have been removed, please use the new extenders as a replacement..
- The LanguagePack extender now only adds translation keys for extensions that are enabled. In case language packs do not seem to load all extension translations, language pack authors should confirm the yaml files in their language extension use the correct extension id (replace / with - and drop flarum-ext- or flarum-; fancy/flarum-ext-boo becomes fancy-boo).
- Other changes are mentioned in the Beta 13 Upgrade guide below.
Developers are recommended to check the changelogs of relating packages when they discover issues. You can review the Beta 13 Update 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.
β€΄οΈ Upgrading
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.12 in your Admin Dashboard or by running php flarum info
(use the previous release notes for upgrading from an earlier version)
Step 2: Disable all 3rd party extensions.
Step 3: Run the following commands:
If Composer v1:
composer update --prefer-dist --no-dev -a --with-all-dependencies
php flarum migrate
php flarum cache:clear
If Composer v2:
Warning: Composer 2 may cause issues during install/update, if you experience issues please open a new discussion under the support tag.
composer update --prefer-dist --no-plugins --no-dev -a --with-all-dependencies
php flarum migrate
php flarum cache:clear
Step 4: 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 mention the Flarum version you are on or the output of php flarum info
. Please also include the output of composer why-not flarum/core v0.1.0-beta.13
πββοΈ Acknowledgements
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 @rob006, @SychO, @Kylo, oddjob79, @Littlegolden, @IanM, andreasjacobsen93, w-4 and anyone else we've missed;
To our eagle-eyed bug reporters, especially @Littlegolden, @matteocontrini, davwheat, markiemm and anyone else we've missed;
To the incredible team behind Flarum, including @Franz, @luceos, @jordanjay29, @datitisev, @clarkwinkelmann, @tankerkiller125, @askvortsov, @Prosperous, @Digital, @Pollux, @katos, @Kyrne and @Ralkage;
To every Open Collective supporter and Github Sponsor, but especially Glowing Blue AG and @QuiteNicely. And also @IanM, @danielunited, @[deleted], Jian Gong, Donald Broussard, Timotheus Pokorra, Shridhar Kamma, Ken Lam, Guitar, @BartVB, Patrik Kernstock, @tankerkiller125, @demianh, @Edmilerad, Andrei Telteu, @tlingc, @malago, @hrvoje_hr and @cubixel ;
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!