[dd-sso/api] Cover all cases, add docs for megamenu internal links

These documentation convering these changes should be visible in:
https://dd.digitalitzacio-democratica.xnet-x.net/docs/customising.ca/

dd-sso/docker/api/src/api/lib/menu.py

@@ -78,15 +78,22 @@ class Menu:
 
         apps_internal = []
         for app in system["apps_internal"]:
-            if app["href"].startswith('/') and 'subdomain' in app:
+            app_href = app["href"] if app.get("href", "") else "/"
-                app["href"] = (
+            # Only modify href if it is a relative URL
-                    "https://"
+            if app_href.startswith("/") or app_href.startswith("#"):
-                    + app["subdomain"]
+                # Get the subdomain part, not using it if it is missing
-                    + "."
+                subdomain_part = ""
-                    + application.config["DOMAIN"]
+                if "subdomain" in app:
-                    + app["href"]
+                    # We pop 'subdomain' so it is not in apps_internal
-                )
+                    # note this includes a trailing dot if defined
-                del app["subdomain"]
+                    subdomain_part = f"{ app.pop('subdomain') }.".lstrip(".")
+                # Actually construct the full URL
+                app["href"] = "".join([
+                    "https://",
+                    subdomain_part,
+                    application.config["DOMAIN"],
+                    app_href,
+                ])
             apps_internal.append(app)
 
         with open(r"menu/custom.yaml") as yml:

docs/customising.ca.md

@@ -1,5 +1,58 @@
 # Personalitzacions
 
+## Enllaços al Megamenú
+
+[El Megamenú][megamenu-internes] te dues parts:
+
+- [Interna / de sistema][megamenu-internes]
+- [Externa / configurable][megamenu-externes]
+
+[megamenu-internes]: https://dd.digitalitzacio-democratica.xnet-x.net/manual-usuari/menu-principal-dd/
+[megamenu-externes]: https://dd.digitalitzacio-democratica.xnet-x.net/manual-usuari/eines-externes-megamenu/
+
+Els enllaços [externs del Megamenú][megamenu-externes] es poden modificar fent
+servir la interfície a `https://admin.DOMINI`, els enllaços
+[interns][megamenu-internes] no.
+
+En ambdós casos es pot fer aprovisionament o personalització avançada d'aquests
+enllaços fent servir els fitxers `custom/menu/custom.yaml` i
+`custom/menu/system.yaml`.
+
+Un exemple d'aquests fitxers, i el seu contingut per defecte es troba a
+`custom.sample/menu/custom.yaml` i `custom.sample/menu/system.yaml`.
+
+### `custom/menu/system.yaml`
+
+Pel fitxer `custom/menu/system.yaml` cal tenir en compte que en funció dels
+valors de `href` i i la presència o absència de `subdomain`, els enllaços es
+generen de manera diferent.
+
+També cal tenir en compte que les adreces relatives han de començar amb
+`/` o `#`.
+
+```yaml
+# Exemple de apps_internal a custom/menu/system.yaml
+apps_internal:
+# Això resulta en un enllaç https://moodle.DOMINI/ADREÇA
+- subdomain: moodle
+  href: /ADREÇA
+  icon: fa fa-graduation-cap
+  name: Aules
+  shortname: courses
+# Això resulta en un enllaç https://ADREÇA_EXTERNA
+# perquè href és un enllaç absolut
+- href: https://ADREÇA_EXTERNA
+  icon: fa fa-book
+  name: Manual
+  shortname: manual
+# Això resulta en un enllaç https://DOMINI/ADREÇA_DOMINI_PRINCIPAL
+- href: /ADREÇA_DOMINI_PRINCIPAL
+  icon: fa fa-rss
+  name: Quant a
+  shortname: about
+```
+
+
 ## Peu de pàgina en el login
 
 El peu de pàgina fa part del tema de login de Keycloak, per tal de modificar-lo,