From: Dan Brown <redacted>
Date: Tue, 28 Feb 2023 14:57:11 +0000 (+0000)
Subject: Added new debug section for dynamic bits not working
X-Git-Url: http://source.bookstackapp.com/website/commitdiff_plain/4d68de922aeb38377f47a36f67a7cf2c9ebcd00c

Added new debug section for dynamic bits not working

Closes #141
---

diff --git a/content/docs/admin/debugging.md b/content/docs/admin/debugging.md
index 998cb9b..e017a14 100644
--- a/content/docs/admin/debugging.md
+++ b/content/docs/admin/debugging.md
@@ -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 "https://" 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.