BookStack v21.12.5

Links

• Update instructions

Full List of Changes

This release contains the following fixes and changes:

• Added text for "file" validation messages to provide better responses in Attachment API validation failures. (#3248)
• Fixed WYSIWYG editor code block creation across mulitple lines and block elements. Thanks to @Julesdevops. (#3246, #3200)
• Fixed markdown image data URI extraction failing on large images due to regex match limits. (#3249)
• Updated translations with latest Crowdin changes. (#3225)

BookStack v21.12.4

Links

• Update instructions

Full List of Changes

This release contains the following fixes and changes:

• Added --external-auth-id option to the bookstack:create-admin command for use with LDAP/SAML2/OIDC instances. (#3222)
• Added the ability select preferred language when creating a new user. (#2408, #2576)
• Added configuration option for PDF export page size. (#995)
• Updated 503 error view to simplify and prevent thrown errors. Thanks to @Julesdevops. (#3210, #3205)
• Updated translations with latest Crowdin changes. (#3214)
• Fixed mis-represented default registration role and allowed disabling of this option. (#3220, #2338)
• Fixed OIDC autodiscovery when keys are provided in a certain format, as provided by Azure. (#3206)
• Development change: The default development branch name is now development instead of master. (#3195)

BookStack v21.12.3

Links

• Update instructions

Upgrade Notices

• Composer Version Requirement Change - Composer v2.0 or greater is now required to install or update BookStack.
  • You can check your composer version by running composer -V.
  • You can often update composer by running sudo composer self-update
    • (Or you may be prompted to run sudo composer self-update --2).
  • If you're using a system-supplied composer package you may need to first uninstall that (eg. sudo apt remove composer) then follow the composer download documentation to get the latest version.
    • Take notice of the sudo mv composer.phar /usr/local/bin/composer command shown in the documentation to install composer globally for easier usage.

Full List of Changes

This release contains the following fixes and changes:

• Updated development docker environment with xdebug support. Thanks to @Julesdevops. (#3193)
• Updated user creation flow to not persist the user on invitation sending failure. Thanks to @Julesdevops. (#3179, #3174)
• Updated "Recently Updated Pages" view to show update author and date. Thanks to @Julesdevops. (#3177, #3045)
• Updated translations with latest Crowdin changes. (#3158)
• Updated PDF page export image display to help fix image sizing issues again. (#3120)
• Updated "Recently Updated Pages" view to show parent context chain. (#3183)
• Fixed potential errors in revision diff view when multi-byte characters are used. (#3170)
• Fixed duplicate display in image gallery when uploading multiple images at once. (#3160)
• Fixed inaccurate markdown editor cursor position upon sidebar usage. (#3186)

BookStack v21.12.2

Links

• Update instructions

Full List of Changes

This release contains the following fixes and changes:

• Improved handling of uploaded images when thumbnails fail to load. (#3142)
• Updated translations with latest Crowdin changes. (#3148)
• Fixed issue where webhooks would error for specific recycle bin operations. (#3154)
• Fixed Spanish invite email subject translation. Thanks to @AitorMatxi. (#3153)
• Fixed issue where custom homepage could cause strange deletion behavior and lead to errors. (#3150)

BookStack v21.12.1

Security Release

• Update Instructions
• Update details on blog

BookStack v21.12.1 has been released.
This is a security release that better enforces permissions on book-sort & chapter-move operations to address scenarios where content could be moved to non-permissible locations.

It's advised to upgrade as soon as possible if untrusted users can update books or chapters in your BookStack instance.

Thanks again to @Haxatron for discovering and reporting this vulnerability via huntr.dev.

Full List of Changes

• Added timeout and debugging statuses to webhooks. (#3139)
• Added new webhook_call_before logical theme system event hook. (#3138)
• Updated support for APNG images to retain animation. (#3136)
• Updated book sort and chapter move handling to enforce more permissions. (#3134)
• Updated item-search/select box to autofocus on search field. (#3127)
• Updated webhooks to not stop application on endpoint call failure. (#3122)
• Updated translations with latest Crowdin changes. (#3117)
• Fixed webhooks list view issue where columns would become to narrow. (#3135)
• Fixed linked images showing small in PDF export. (#3120)
• Fixed issue where pasting certain code blocks would cause erratic editor behavior. (#3133)

BookStack v21.12

Links

• Update instructions
• Update details on blog

Full List of Changes

• Added webhooks. (#147, #3099)
• Added ability to copy books, chapters & roles. (#3118, #1123)
• Added audit log IP address search. Thanks to @johnroyer. (#3081)
• Updated translations with latest Crowdin changes. (#3117)
• Fixed issue where non-ascii content could break search result previews. Thanks to @Kristian-Krastev. (#3113)
• Fixed mismatched password validation rules across the application. (#2237)

BookStack v21.11.3

Security Release

• Update Instructions
• Update details on blog

BookStack v21.11.3 has been released.
This is a security release that helps prevent potential discovery and harvesting of user details including name and email address.

It's advised to upgrade as soon as possible if your BookStack instance is public or is used by untrusted members.

Thanks to @Haxatron for discovering and reporting this vulnerability via huntr.dev.

Full List of Changes

• Helped prevent discovery and harvesting of user information. Thanks @Haxatron for reporting. (#3108)
• Updated search API results to include the highlighted preview content. (#3096)
• Updated search API results to include item URL. (#3080)
• Updated translations with latest Crowdin changes. (#3093)

BookStack v21.11.2

Security Release

• Update Instructions
• Update details on blog

BookStack v21.11.2 has been released.
This is a security release that address a couple of vulnerabilities relating to API access and page draft related content visibility:

• If the "Public" role was provided API access then the API could be accessed, in certain scenarios by non-authenticated users even if the "Allow public access" setting was disabled.
• In some specific scenarios, content related to page drafts (Such as attachments) could be visible to non-owners (Whom would have permission to view the page if saved as a non-draft at that point).

It's advised to upgrade as soon as possible if the API has been enabled for roles within your instance or if draft page content visibility could be a security concern for you.

Full List of Changes

• Fixed issue with greater-than-expected visibility on page-draft-related items. Thanks @Haxatron for reporting. (#3086)
• Fixed issue where public API access was not limited by system public control in certain conditions. (#3091)
• Updated translations from latest Crowdin changes. (#3076)

BookStack v21.11.1

Links

• Update instructions

Full List of Changes

This release contains the following fixes and changes:

• Added custom command support to the logical theme system. (#3072)
• Added support for prefers-contrast media setting to increase contrast in faded areas when active. (#2634)
• Updated TOTP confirmation view to autofocus on code input. Thanks to @raccettura. (#3068)
• Updated translations with latest changes from Crowdin. (#3057)
• Updated any links on homepage lists to be more obvious & accessible. (#3046)
• Fixed faulty page navigation links when headers are nested within other content. Thanks to @Julesdevops. (#3069, #3058)

BookStack v21.11

Links

• Update instructions
• Update details on blog

Upgrade Notices

• Security Releases - There were some security vulnerabilities found during the life of v21.10. See the v21.10.1, v21.10.2 and v21.10.3 posts for more details.
• API Changes - As of v21.11 any dates in API responses will be formatted as per ISO-8601, with 2019-12-02T20:01:00.283041Z reflecting an example of this format. You may need to review any of your scripts that utilise dates from API responses.
• Upload Limit - System file upload limits are now configured using a FILE_UPLOAD_SIZE_LIMIT option in your
  .env file. This value is specified as an integer and represents the max upload size in MegaBytes. This defaults to 50MB. This replaces the old window.uploadLimit HTML head option that could be set.
• Search Index Changes - There have been search indexing and scoring changes in v21.11.
  It's recommended to run php artisan bookstack:regenerate-search to ensure a consistent search experience and take
  advantage of these changes.
• Logout Endpoints - Logout endpoints have now changed to be CSRF protected POST endpoints instead of GET endpoints. If you were using these for any external purposes you may now need to implement an alternative workflow.

Full List of Changes

• Added a new tag view. (#3042, #738)
• Added a wide series of improvements to the search system, including: (#3043, #2840)
  • Added highlighting of search terms in search results. (#1891, #997)
  • Added matching of tag names and values through normal search terms. (#1577)
• Added search API endpoints. (#909)
• Added new .env option to limit file uploads. (#3033)
• Updated the used Laravel framework from version 6 to version 8. Thanks to @laravel-shift for accelerating this. (#3012, #3011)
• Implemented initial use of static analysis for PHP code. (#3039)
• Updated Slack and Facebook logos to be current. Thanks to @na3shkw. (#3032)
• Updated user invite/email-confirmation journeys to help prevent potential malicious user manipulation. Thanks again to @Haxatron for reporting. (#3050)
• Updated logout endpoints to be POST to prevent potential CSRF concerns. Thanks to @HDVinnie for reporting. (#3047)
• Updated page include system to retain the pre tags when including a code block. (#2406)
• Updated translations with latest changes from Crowdin. (#3040)
• Fixed issue where using the back button in the page editor could lead you to the same page. (#2834)
• Fixed issue where setting new search filters could remove existing created_by & updated_by filters. (#2736)
• Fixed issue where markdown draft pages could convert to HTML. (#3054)
• Fixed issue where "Skip to content" link could be visible on print views. (#3051)