They can cause instability, introduce issues and may conflict with future updates. Apply at your own risk!
Username-based Login
This is a hack to BookStack, using the theme system, so that login presents itself as a username.
Upon login attempt, this will match to a user of <username>@<configured-domain>
within the database.
Considerations
- This assumes all users in your BookStack instance shares the same email domain.
- This overrides a large part of the login form so be extra aware this will be overriding any default changes to BookStack upon updates.
- Login page errors may still reference email address, and username will not be auto prefilled after failed login submission.
- Other functionality within BookStack can still require or use email, so it’s generally a good idea to ensure the resulting email addresses would be valid, or email is disabled at a system level in some manner.
Options
- Change the
$emailDomain
variable on line 8 offunctions.php
to be the common email domain used in your BookStack instance (This will be auto-appended to usernames on login).
Code
functions.php
|
|
auth/parts/login-form-standard.blade.php
|
|
Request an Update
Hack not working on the latest version of BookStack?
You can request this hack to be updated & tested for a small one-time fee.
This helps keeps these hacks updated & maintained in a sustainable manner.
Latest Hacks
Prune Revisions Command
This hack registers a custom command using the logical theme system, which will prune the revisions of a specific page to just those with a changelog provided (in addition to the current revision), before resetting the revision numbers across the remaining versions to be sequential without gaps. »
Format Webhooks for Pushover
This is a hack to adapt outgoing webhooks from BookStack so that they are directly compatible with the pushover message API. »
WYSIWYG Docx Import
This hack adds the ability to import “.docx” files into the WYSIWYG editor, by dragging and dropping a “docx” file into the editor area. »
WYSIWYG Editor Autocomplete Suggestions
This hack adds custom autocomplete suggestions to the WYSIWYG page editor (TinyMCE). An autocomplete popup box will show after a “trigger character” (: as configured by default in this hack) is entered after a space, or at the start of a line. »