BookStack Code Mirror - website/blob - content/blog/2023/bookstack-release-v23-10.md

   1 +++
   2 categories = ["Releases"]
   3 tags = ["Releases"]
   4 title = "BookStack Release v23.10"
   5 date = 2023-10-30T11:43:00Z
   6 author = "Dan Brown"
   7 image = "/images/blog-cover-images/cc-by-2/peter-trimming-squirrel.jpg"
   8 slug = "bookstack-release-v23-10"
   9 draft = false
  10 +++
  11
  12 This October maintenance release brings with it a little more than originally planned,
  13 with a significant revamp of user self-management in addition to an updated editor design,
  14 along with many other additions & improvements.
  15
  16 * [Update instructions](/docs/admin/updates)
  17 * [GitHub release page](https://github.com/BookStackApp/BookStack/releases/tag/v23.10)
  18
  19
  20 **Upgrade Notices**
  21
  22 - **URL Changes** - Many of the URLs related to user details & preferences have changed in this release with the addition of the "My Account" area. If you have documented these links you may need to update your documentation.
  23
  24 TODO - Video
  25 <!-- {{<pt oMVSWxsayhfL7rjtzJLqNF>}} -->
  26
  27 ### My Account Area
  28
  29 With the added options over the years, user self-management was getting rather fractured within the
  30 user interface with some options within "Preferences", but with many other options (including some which could be considered preferences)
  31 within the "Edit Profile" view.
  32 Additionally that "Edit Profile" was located in the application users settings which was acting dual-purpose for admin and end-user usage.
  33
  34 To address this, in this release there's a new central "My Account" area accessed via the header user dropdown menu:
  35
  36 TODO - Screenshot of my account area, with dropdown in view
  37
  38 The "My Account" area combines the pre-existing preference views, with end-user specific "Profile Details" and "Access & Security" views
  39 to contain all user self-management within one neatly organised area.
  40 The "Access & Security" view bundles the existing password, MFA and API token controls:
  41
  42 TODO - Screenshot of "Access & Security" area
  43
  44 These changes should now provide a much more intuitive end-user experience when it comes to finding account options.
  45
  46 ### Admin User Form Changes
  47
  48 With the above addition of a "My Account" area, we can now focus the pre-existing "Settings > Users > Edit" view
  49 to be targeted on admin use.
  50 Access to these views is now limited to just those with role permission to "Manage Users", since all other required end-user
  51 abilities can now be managed via "My Account".
  52
  53 When third-party/social login options are in use, admin users will not be able to see what external
  54 accounts users have connected to their BookStack profile. This was previously only visible to the user which they applied to.
  55
  56 TODO - Image of social acccounts for non-current user
  57
  58 Lastly, the "External Authentication ID" field will now always display on this form, even if using just normal email & password authentication.
  59 This is to make it easier to manage and set-up external authentication accounts when required, negating the awkward need to swap
  60 active system authentication system  when attempting to set this up.
  61
  62 TODO - Image of external auth id field
  63
  64 ### Editor Design Update
  65
  66 TODO
  67
  68 ### Refresh Avatar Command
  69
  70 TODO
  71
  72 Thanks to [@MarcHagen](https://github.com/BookStackApp/BookStack/pull/4560)
  73
  74 [Command in docs](/docs/admin/commands/#refresh-user-avatars)
  75
  76
  77 ### Basic PWA Support
  78
  79 TODO
  80
  81 Thanks to [@GamerClassN7](https://github.com/BookStackApp/BookStack/pull/4430)
  82
  83 ### Visual Theme System Header Partials
  84
  85 TODO
  86
  87 ### Editor Entity Search Prefill
  88
  89 TODO
  90
  91 ### Fixes & Cleanup
  92
  93 TODO
  94
  95 ### Translations
  96
  97 TODO
  98
  99 Added Uzbek
 100
 101 - Name - *Language - x words*
 102
 103
 104 *\* Word counts are those tracked by Crowdin, indicating original EN words translated.*
 105
 106 ### Next Steps
 107
 108 TODO
 109
 110 ### Full List of Changes
 111
 112 **Released in v23.10**
 113
 114 * Added new "My Account" area. ([#4615](https://github.com/BookStackApp/BookStack/pull/4615))
 115 * Added Uzbek language translations. Thanks to [@mrmuminov](https://github.com/BookStackApp/BookStack/pull/4527). ([#4527](https://github.com/BookStackApp/BookStack/pull/4527))
 116 * Added artisan command for re-fetching existing user avatar images. Thanks to [@MarcHagen](https://github.com/BookStackApp/BookStack/pull/4560). ([#4560](https://github.com/BookStackApp/BookStack/pull/4560), [#1893](https://github.com/BookStackApp/BookStack/issues/1893))
 117 * Added basic PWA support. Thanks to [@GamerClassN7](https://github.com/BookStackApp/BookStack/pull/4430). ([#4430](https://github.com/BookStackApp/BookStack/pull/4430), [#1253](https://github.com/BookStackApp/BookStack/issues/1253))
 118 * Added new header bar partials for easier customization. ([#4564](https://github.com/BookStackApp/BookStack/issues/4564))
 119 * Added "View Tags" button to non-default homepage views. ([#4558](https://github.com/BookStackApp/BookStack/issues/4558))
 120 * Updated page editor interface with a new design. ([#4604](https://github.com/BookStackApp/BookStack/pull/4604))
 121 * Updated app caching behaviour to avoid expiry scenarios. ([#4600](https://github.com/BookStackApp/BookStack/issues/4600))
 122 * Updated cleanup-images command to allow non-interactive running. ([#4541](https://github.com/BookStackApp/BookStack/issues/4541))
 123 * Updated comment notification options to only show if comments active. Thanks to [@tusharnain4578](https://github.com/BookStackApp/BookStack/pull/4552). ([#4552](https://github.com/BookStackApp/BookStack/pull/4552), [#4508](https://github.com/BookStackApp/BookStack/issues/4508))
 124 * Updated editor entity selector to pre-fill with selected text. ([#4571](https://github.com/BookStackApp/BookStack/issues/4571))
 125 * Updated file & image upload handling for better indication of issues. ([#4578](https://github.com/BookStackApp/BookStack/pull/4578), [#4454](https://github.com/BookStackApp/BookStack/issues/4454))
 126 * Updated guest user logic to reduce complexity and overlapping methods. ([#4554](https://github.com/BookStackApp/BookStack/pull/4554), [#4448](https://github.com/BookStackApp/BookStack/issues/4448))
 127 * Updated HTTP calling in the codebase to align all handling. ([#4525](https://github.com/BookStackApp/BookStack/pull/4525))
 128 * Updated icon handling to remove unneeded global helper. ([#4553](https://github.com/BookStackApp/BookStack/issues/4553))
 129 * Updated language handling to reduce complexity and duplicated logic. ([#4555](https://github.com/BookStackApp/BookStack/pull/4555), [#4501](https://github.com/BookStackApp/BookStack/issues/4501))
 130 * Updated logical theme system to capture load errors for better reporting & debugging. ([#4504](https://github.com/BookStackApp/BookStack/issues/4504))
 131 * Updated mixed entity endpoints to share and align logic. ([#4444](https://github.com/BookStackApp/BookStack/issues/4444))
 132 * Updated OIDC config handling to move logic out of config file. ([#4494](https://github.com/BookStackApp/BookStack/issues/4494))
 133 * Updated OIDC request timeout to 5 seconds. ([#4397](https://github.com/BookStackApp/BookStack/issues/4397))
 134 * Updated older notifications codebase to align with newer code organisation. ([#4500](https://github.com/BookStackApp/BookStack/issues/4500))
 135 * Updated print view to ignore extra elements. ([#4594](https://github.com/BookStackApp/BookStack/issues/4594))
 136 * Updated Slack authentication to use official Laravel implementation. ([#4464](https://github.com/BookStackApp/BookStack/issues/4464))
 137 * Updated the default email settings to use example domain. ([#4518](https://github.com/BookStackApp/BookStack/issues/4518))
 138 * Updated translations with latest Crowdin changes. ([#4523](https://github.com/BookStackApp/BookStack/pull/4523))
 139 * Updated username truncation to always show some part of the name. Thanks to [@Bajszi97](https://github.com/BookStackApp/BookStack/pull/4533). ([#4533](https://github.com/BookStackApp/BookStack/pull/4533), [#4489](https://github.com/BookStackApp/BookStack/issues/4489))
 140 * Updated security docs to remove huntr references. Thanks to [@radiantwave](https://github.com/BookStackApp/BookStack/pull/4618). ([#4616](https://github.com/BookStackApp/BookStack/issues/4616), [#4618](https://github.com/BookStackApp/BookStack/pull/4618))
 141 * Fixed awkward sidebar scroll behaviour at mid-level screen sizes. Thanks to [@LawssssCat](https://github.com/BookStackApp/BookStack/pull/4562). ([#4562](https://github.com/BookStackApp/BookStack/pull/4562))
 142 * Fixed buggy dark/light mode button when dark mode is the default. ([#4543](https://github.com/BookStackApp/BookStack/issues/4543))
 143 * Fixed enter press incorrectly clearing tag input field. ([#4570](https://github.com/BookStackApp/BookStack/issues/4570))
 144 * Fixed issue where "?" would show shortcuts when typing in an input. ([#4606](https://github.com/BookStackApp/BookStack/issues/4606))
 145 * Fixed lack of content in plaintext export options. ([#4557](https://github.com/BookStackApp/BookStack/issues/4557))
 146 * Fixed missing notification text in German-language emails. ([#4567](https://github.com/BookStackApp/BookStack/issues/4567))
 147 * Fixed odd default homepage layout at iPad-like width. ([#4596](https://github.com/BookStackApp/BookStack/issues/4596))
 148 * Fixed un-aligned text across elements when they show their empty states. ([#4563](https://github.com/BookStackApp/BookStack/issues/4563))
 149 * Enabled Albanian translations for BookStack on Crowdin. ([#4065](https://github.com/BookStackApp/BookStack/issues/4065))
 150 * Enabled Finnish translations for BookStack on Crowdin. ([#4614](https://github.com/BookStackApp/BookStack/issues/4614))
 151 * Enabled Norwegian Nynorsk translations for BookStack on Crowdin. ([#4447](https://github.com/BookStackApp/BookStack/issues/4447))
 152
 153 **Released in v23.08.3**
 154
 155 * Fixed comment reply notifications not being sent to the correct/expected user. ([#4548](https://github.com/BookStackApp/BookStack/issues/4548))
 156 * Fixed JavaScript error that could appear when not having comment permissions. ([#4531](https://github.com/BookStackApp/BookStack/issues/4531))
 157 * Fixed wrong French translation in notification preferences. ([#4511](https://github.com/BookStackApp/BookStack/issues/4511))
 158 * Updated translations with latest Crowdin changes. ([#4512](https://github.com/BookStackApp/BookStack/pull/4512))
 159
 160 **Released in v23.08.2**
 161
 162 * Fixed WYSIWYG filtering issue, introduced in v23.08.1, which breaks page editing and drawing use when certain elements exist in page content. ([#4510](https://github.com/BookStackApp/BookStack/issues/4510), [#4509](https://github.com/BookStackApp/BookStack/issues/4509))
 163 * Updated translations with latest Crowdin changes. ([#4506](https://github.com/BookStackApp/BookStack/pull/4506))
 164
 165 **Released in v23.08.1**
 166
 167 * Updated preferences view styles to better respond to content and screen sizes to prevent wrapping buttons. ([#4502](https://github.com/BookStackApp/BookStack/issues/4502))
 168 * Updated WYSIWYG editor filtering to help prevent page pointer being pasted into pages. ([#4474](https://github.com/BookStackApp/BookStack/issues/4474))
 169 * Updated translations with latest Crowdin changes. ([#4481](https://github.com/BookStackApp/BookStack/pull/4481))
 170 * Fixed a range of typos in our dev docs. Thanks to [@omahs](https://github.com/BookStackApp/BookStack/pull/4484). ([#4484](https://github.com/BookStackApp/BookStack/pull/4484))
 171 * Fixed deleted watched books/chapters/pages breaking notification preferences view from loading. ([#4499](https://github.com/BookStackApp/BookStack/issues/4499))
 172 * Fixed notifications not being sent in receiver language preference. ([#4497](https://github.com/BookStackApp/BookStack/pull/4497), [#4480](https://github.com/BookStackApp/BookStack/issues/4480))
 173
 174 ----
 175
 176 <span style="font-size: 0.8em;opacity:0.9;">Header Image Credits: <span>Photo by <a href="https://www.flickr.com/photos/peter-trimming/31839968058/">Peter Trimming (CC-BY-2)</a> - Image Modified</span></span>