added configurable variables to docs and apps settings

Author: marcanuy

docs/ref/settings.rst

@@ -25,3 +25,26 @@ Default: ``False``
 Wheter to show or hide breadcrumbs at site's root.
 
 
+DYNAMIC_BREADCRUMBS_PATH_ONLY_ALPHANUMERIC
+------------------------------------------
+
+Default: ``True``
+
+Only allows alphanumeric characters in breadcrumb item names. If
+someone contains non-alphanumeric values it will show an empty string.
+
+
+DYNAMIC_BREADCRUMBS_PATH_MAX_DEPTH
+----------------------------------
+
+Default: ``5``
+
+The maximum number of breadcrumb items to show
+
+
+DYNAMIC_BREADCRUMBS_PATH_MAX_COMPONENT_LENGTH
+---------------------------------------------
+
+Default: ``50``
+
+Each path component's maximum length.

dynamic_breadcrumbs/app_settings.py

@@ -6,10 +6,13 @@
 SHOW_AT_BASE_PATH = getattr(
     settings, "DYNAMIC_BREADCRUMBS_SHOW_AT_BASE_PATH", False
 )
-SHOW_VERBOSE_NAME = getattr(
-    settings, "DYNAMIC_BREADCRUMBS_SHOW_VERBOSE_NAME", True
-)
 
 PATH_ALPHANUMERIC = getattr(
     settings, "DYNAMIC_BREADCRUMBS_PATH_ONLY_ALPHANUMERIC", True
 )
+PATH_MAX_DEPTH = getattr(
+    settings, "DYNAMIC_BREADCRUMBS_PATH_MAX_DEPTH", 5
+)
+PATH_MAX_COMPONENT_LENGTH = getattr(
+    settings, "DYNAMIC_BREADCRUMBS_PATH_MAX_COMPONENT_LENGTH", 50
+)

dynamic_breadcrumbs/utils.py

@@ -12,10 +12,6 @@
 
 logger = logging.getLogger(__name__)
 
-#ALLOWED_BASE_URLS = [settings.ALLOWED_HOSTS]  # Add your allowed base URLs here
-MAX_PATH_DEPTH = 5
-MAX_PATH_COMPONENT_LENGTH = 50
-
 
 def sanitize_url(url):
     """Sanitize the URL to prevent malicious content."""
@@ -33,21 +29,21 @@ def validate_path(path):
         logger.warning("Invalid path type provided: %s", type(path))
         return ""
 
-    if app_settings.PATH_ONLY_ALPHANUMERIC:
+    if app_settings.PATH_ALPHANUMERIC:
         # Ensure the path contains only alphanumeric characters, dashes, underscores, and slashes
         if not re.match(r'^[a-zA-Z0-9_\-/]*$', path):
             logger.warning("Invalid path provided: %s", path)
             return ""
 
     components = path.split('/')
     # Check path depth
-    if len(components) > MAX_PATH_DEPTH:
+    if len(components) > app_settings.PATH_MAX_DEPTH:
         logger.warning("Path depth exceeded for: %s", path)
         return ""
 
     # Check each path component's length
     for component in components:
-        if len(component) > MAX_PATH_COMPONENT_LENGTH:
+        if len(component) > app_settings.PATH_MAX_COMPONENT_LENGTH:
             logger.warning("Path component length exceeded in: %s", path)
             return ""