categories = ["Releases"]
tags = ["Releases"]
title = "Beta Release v0.24.0"
-date = 2018-09-23T18:00:00Z
+date = 2018-09-24T12:00:00Z
author = "Dan Brown"
image = "/images/blog-cover-images/shelves-michael-d-beckwith.jpg"
description = "Bookshelves arrive in BookStack v0.24 along with a treasure chest of other features, fixes and updates"
Need a way to categorise your Books? Well BookStack v0.24 is the release for you bringing Bookshelves along with a host of other notable features such as revision removals, social authentication auto-registration and Arabic support.
-**Please Note, Due to some required re-working of some settings you may have to re-apply any homepage options you've previsouly set after updating. See the update instructions page linked below for further info.**
+**Please Note, Due to required re-working of some settings you may have to re-apply any homepage options you've previously set upon updating to v0.24. See the update instructions page linked below for further info.**
* [Update instructions](https://www.bookstackapp.com/docs/admin/updates)
* [GitHub release page](https://github.com/BookStackApp/BookStack/releases/tag/v0.24.0)
### Bookshelves
+Bookshelves have now been added as a new layer to the organisation system. Bookshelves offer a way to group and categorise books. A single bookshelf can contain multiple books and a single book can be contained in multiple bookshelves.
+<video src="/images/2018/09/bookshelves.mp4" muted="true" controls></video>
+
+This is only the initial functional implementation of bookshelves. Currently the interface for bookshelves is very similar to that for books and chapters. As part of a bigger design update we'll be looking to make bookshelves more unique in respect to their functionality and design.
+
+As with books, bookshelves can have custom permissions set upon them but they differ in the fact the permissions won't cascade down to child items as they do with books & chapters. This is due to fact a book can be in multiple bookshelves. Instead, within the permissions view for the shelf, you have the option to copy the shelf permission settings to all child books:
+
+
### Page Revision Updates
--- Removals
+Thanks to [@Abijeet](https://github.com/BookStackApp/BookStack/pull/1008) it's now possible to remove particular revisions. This can be useful if you ever need to remove sensitive information that was part of a previous page version without having to delete all revision history in the system.
+
+
+
+A new configuration option has also been added to control the amount of revisions kept by BookStack. Previously there was a limit of 50 versions enforced. This remains the default but it is now possible to increase or even remove this limit by setting the following in your `.env` file:
+
+```bash
+# Set the revision limit to 100
+REVISION_LIMIT=100
+
+# Alternatively, You can set to 'false' to disable the limit altogether.
+REVISION_LIMIT=false
+```
+
--- Limit Setting
+### Social Auto-Registration & Auto-Email-Confirmation
+Previously, to register in the system, you'd need to visit the register page and select your login option, you were not able to register via the login page. This also required registrations to be enabled and prevented social registration if using LDAP as your authentication option.
-### Social Auth Updates
+With this release it's now possible to configure, per authentication option, if users should be auto-registered upon login in the event they do not already have an account. This allows a much smoother sign-up process. It's also possible to automatically mark emails as confirmed for particular authentication options if you trust the service to provide the correct email address. Domain restrictions will still be respected, if set, for both of these options.
--- Auto-registration & auto-email-confirm
+[Details on configuring these options can be found here.](/docs/admin/third-party-auth/#automatic-registration-email-confirmation)
### Arabic and Right-to-Left Text Support
-Styles to bullet-points have been updated to ensure they display correctly when displayed in a RTL manner and page content should show in the correct direction depending on the text detected within.
+Bullet-point styles have been updated to ensure they display correctly when displayed in a right-to-left manner and page content should show in the correct direction depending on the text detected within.
Note, Right-to-left text support is in its early stages so there's likely to be further updates needed. Please feel free to raise any issues found on GitHub.
### Additional Language Updates
-Once again, We've recieved a whole load of translations by wonderful people. Here are the languages that have recieved updates and their contributors:
+Once again, We've received a whole load of translations by wonderful people. Here are the languages that have received updates and their contributors:
🇪🇸 Spanish - Thanks to [@moucho](https://github.com/BookStackApp/BookStack/pull/1025). <br>
🇩🇪 German - Thanks to [@vriic](https://github.com/BookStackApp/BookStack/pull/983). <br>
* Updated export templates to include custom styles. ([#981](https://github.com/BookStackApp/BookStack/issues/981))
* Updated database migrations so MyISAM engine is never forced and so that fulltext index support is not required. ([#726](https://github.com/BookStackApp/BookStack/issues/726))
* Updated Spanish translations. Thanks to [@moucho](https://github.com/BookStackApp/BookStack/pull/1025). ([#1025](https://github.com/BookStackApp/BookStack/pull/1025), [#1021](https://github.com/BookStackApp/BookStack/pull/1021))
-* Updated German translations. Thanks to [@vriic](https://github.com/BookStackApp/BookStack/pull/983). ([#983](https://github.com/BookStackApp/BookStack/pull/983))
+* Updated German translations. Thanks to [@vriic](https://github.com/BookStackApp/BookStack/pull/983). ([#983](https://github.com/BookStackApp/BookStack/pull/983), [#1026](https://github.com/BookStackApp/BookStack/pull/1026))
* Updated Russian translations. Thanks to [@mullinsmikey](https://github.com/BookStackApp/BookStack/pull/1002). ([#1002](https://github.com/BookStackApp/BookStack/pull/1002))
* Updated Brazilian Portuguese translations. Thanks to [@DeehSlash](https://github.com/BookStackApp/BookStack/pull/986). ([#986](https://github.com/BookStackApp/BookStack/pull/986))
* Fixed chapter content dropdown acting unreliably. Thanks to [@Abijeet](https://github.com/BookStackApp/BookStack/pull/1009). ([#1009](https://github.com/BookStackApp/BookStack/pull/1009), [#960](https://github.com/BookStackApp/BookStack/issues/960))
### Next Steps
-As mentoined above, The Bookshelves implementation has been functionality focused for this release so I'll be thinking about how to bring in a unique Bookshelf design to make them more effective in use. I'm sure we'll also see some further thoughts and requests as people start to use Bookshelves.
+As mentioned above, The Bookshelves implementation has been functionality focused for this release so I'll be thinking about how to bring in a unique Bookshelf design to make them more effective in use. I'm sure we'll also see some further thoughts and requests as people start to use Bookshelves.
To support the implemented, but not documented, themeing system I'd like to revamp and clean-up all views used by the system. This would probably tie in with fleshing-out the Bookshelf design work as part of a bigger design update which also enhances mobile support.
projects / website / commitdiff