]> BookStack Code Mirror - website/commitdiff
Added new debug section for dynamic bits not working
authorDan Brown <redacted>
Tue, 28 Feb 2023 14:57:11 +0000 (14:57 +0000)
committerDan Brown <redacted>
Tue, 28 Feb 2023 14:57:11 +0000 (14:57 +0000)
Closes #141

content/docs/admin/debugging.md

index 998cb9bb63c429d4fa7f4e01c5ff701acf5dfd6a..e017a144e1e9c434bb6ba31af347eb2395a6300c 100644 (file)
@@ -16,6 +16,7 @@ This page details how you can find out more information about errors you may fac
     - [Blank White Screen on Access](#blank-white-screen-on-access)
     - [No Styles and Large Icons on Access](#no-styles-and-large-icons-on-access)
     - [Failing Database or Auth System Credentials](#failing-database-or-auth-system-credentials)
+    - [Dynamic Elements Not Working](#dynamic-elements-not-working)
     - [Broken Links or No Images After APP_URL Change](#broken-links-or-no-images-after-app_url-change)
 - [Submitting Issues](#submitting-issues)
 
@@ -70,6 +71,16 @@ special characters being handled different in the `.env` configuration. Ensure t
 DB_PASSWORD="hunter#2@"
 ```
 
+##### Dynamic Elements Not Working
+
+If certain dynamic elements, like dropdown menus or section tabs, are not working it often indicates that there
+may be other scripts interfering with BookStack's JavaScript code.
+
+- Check that the `APP_URL` option is set in your `.env` file and ensure it matches the URL you're accessing BookStack on (Including the "https://" or "http://" component).
+- If using Cloudflare, with it's DNS proxy feature, ensure that ["Rocket Loader" is disabled](https://developers.cloudflare.com/fundamentals/speed/rocket-loader/enable/).
+- Check your "Custom HTML Head Content" customization setting and, if existing, temporarily remove any code in this setting to ensure it's not interfering. 
+- Use your browser developer tools to check the development console, and see if any errors exist.
+
 ##### Broken Links or No Images After APP_URL Change
 
 BookStack will store absolute URL paths for some content, such as images, in the database.