Add UTM parameters and related fields to CVmhErstgespraech entity and layouts

README.md

@@ -170,3 +170,28 @@ Zukünftige Ziele:
 - **Erweiterte Features**: Mehrsprachigkeit, Mandanten-Isolation für mehrere Kanzlei-Teams, Integration mit externen Systemen (z. B. Gerichts-APIs, Buchhaltung).
 
 Die KI kann diese Ziele unterstützen, indem sie JSON-Strukturen analysiert, Änderungen vorschlägt (z. B. neue Felder für Compliance) und Workflows modelliert. Das System soll skalierbar, GDPR-konform und benutzerfreundlich sein, um die Effizienz in der Rechtsbranche zu steigern.
+
+6. Bearbeitung von Entitäten und Layouts
+
+Um EspoCRM anzupassen, bearbeite JSON-Dateien im custom/-Verzeichnis. Änderungen bleiben bei Updates erhalten, da sie Core-Dateien nicht überschreiben.
+
+    Entitäten bearbeiten:
+        Pfad: custom/Espo/Custom/Resources/metadata/entityDefs/{EntityType}.json (z. B. CVmhErstgespraech.json).
+        Struktur: JSON-Objekt mit "fields" (Felder definieren), "links" (Beziehungen), "collection" (Sortierung/Filter), "indexes" (Performance).
+        Beispiel: Feld hinzufügen – Füge in "fields" ein neues Objekt ein, z. B. {"type": "varchar", "required": true}.
+        Beispiel: Feld entfernen – Lösche den entsprechenden Schlüssel aus "fields".
+        Hinweis: Änderungen wirken sich auf die Datenbank aus (z. B. neue Spalten bei Rebuild).
+
+    Layouts bearbeiten:
+        Pfad: custom/Espo/Custom/Resources/layouts/{EntityType}/{LayoutType}.json (z. B. detail.json für Detail-View).
+        Struktur: Array von Panels, jedes mit "label" und "rows" (Arrays von Zellen mit {"name": "feldname"}).
+        Beispiel: Feld hinzufügen – Füge {"name": "neuesFeld"} in eine "rows"-Zeile ein.
+        Beispiel: Feld entfernen – Lösche die entsprechende Zelle aus "rows".
+        LayoutTypes: detail, list, edit, etc. – Passe Views an, um UI zu optimieren.
+
+    Rebuild durchführen:
+        Nach Änderungen muss ein Rebuild ausgeführt werden, um Caches zu leeren und Metadata neu zu mergen.
+        CLI-Befehl (im Docker-Container): docker exec espocrm php /var/www/html/command.php Rebuild
+        Alternative: Web-Interface > Administration > Clear Cache & Rebuild.
+        Effekt: Aktualisiert DB-Schema, Views und entfernt alte Caches. Ohne Rebuild sind Änderungen unsichtbar.
+        Hinweis: Führe den Befehl auf dem Host aus, da der Container den PHP-Zugang hat.

custom/Espo/Custom/Resources/i18n/de_DE/CVmhErstgespraech.json

@@ -27,6 +27,18 @@
         }
     },
     "fields": {
-        "erfolgsaussichten": "Erfolgsaussichten"
+        "erfolgsaussichten": "Erfolgsaussichten",
+        "aquiseplattform": "Akquisitionsplattform",
+        "gclid": "Google Click ID",
+        "utm_source": "UTM Source",
+        "utm_medium": "UTM Medium",
+        "utm_campaign": "UTM Campaign",
+        "utm_term": "UTM Term",
+        "utm_content": "UTM Content",
+        "ad_group": "Ad Group",
+        "keyword": "Keyword",
+        "campaign_id": "Campaign ID",
+        "landing_page": "Landing Page",
+        "referrer": "Referrer"
     }
 }

custom/Espo/Custom/Resources/i18n/en_US/CVmhErstgespraech.json

@@ -38,6 +38,16 @@
         "eMailErstgesprch2": "E-Mail Erstgespräch II.",
         "aquiseplattform": "Aquiseplattform",
         "gclid": "gclid",
+        "utm_source": "UTM Source",
+        "utm_medium": "UTM Medium",
+        "utm_campaign": "UTM Campaign",
+        "utm_term": "UTM Term",
+        "utm_content": "UTM Content",
+        "ad_group": "Ad Group",
+        "keyword": "Keyword",
+        "campaign_id": "Campaign ID",
+        "landing_page": "Landing Page",
+        "referrer": "Referrer",
         "anzahlVermieter": "Anzahl Vermieter",
         "anzahlMieter": "Anzahl Mieter",
         "anzahlSonstigeVolljhrigeBewohner": "Anzahl sonst. Besitzer",

custom/Espo/Custom/Resources/layouts/CVmhErstgespraech/detail.json

@@ -8,12 +8,6 @@
                 {
                     "name": "nchsterAnruf"
                 }
-            ],
-            [
-                {
-                    "name": "testArray"
-                },
-                false
             ]
         ],
         "dynamicLogicVisible": null,
@@ -211,6 +205,48 @@
                 {
                     "name": "gclid"
                 }
+            ],
+            [
+                {
+                    "name": "utm_source"
+                },
+                {
+                    "name": "utm_medium"
+                }
+            ],
+            [
+                {
+                    "name": "utm_campaign"
+                },
+                {
+                    "name": "utm_term"
+                }
+            ],
+            [
+                {
+                    "name": "utm_content"
+                },
+                {
+                    "name": "ad_group"
+                }
+            ],
+            [
+                {
+                    "name": "keyword"
+                },
+                {
+                    "name": "campaign_id"
+                }
+            ],
+            [
+                {
+                    "name": "landing_page"
+                }
+            ],
+            [
+                {
+                    "name": "referrer"
+                }
             ]
         ],
         "dynamicLogicVisible": null,

custom/Espo/Custom/Resources/layouts/CVmhErstgespraech/list.json

@@ -15,6 +15,10 @@
         "link": true,
         "align": "left"
     },
+    {
+        "name": "aquiseplattform",
+        "width": 16
+    },
     {
         "name": "assignedUser",
         "width": 16

custom/Espo/Custom/Resources/metadata/entityDefs/CVmhErstgespraech.json

@@ -278,6 +278,66 @@
             "options": [],
             "isCustom": true
         },
+        "utm_source": {
+            "type": "varchar",
+            "maxLength": 255,
+            "readOnly": true,
+            "isCustom": true
+        },
+        "utm_medium": {
+            "type": "varchar",
+            "maxLength": 255,
+            "readOnly": true,
+            "isCustom": true
+        },
+        "utm_campaign": {
+            "type": "varchar",
+            "maxLength": 255,
+            "readOnly": true,
+            "isCustom": true
+        },
+        "utm_term": {
+            "type": "varchar",
+            "maxLength": 255,
+            "readOnly": true,
+            "isCustom": true
+        },
+        "utm_content": {
+            "type": "varchar",
+            "maxLength": 255,
+            "readOnly": true,
+            "isCustom": true
+        },
+        "ad_group": {
+            "type": "varchar",
+            "maxLength": 255,
+            "readOnly": true,
+            "isCustom": true
+        },
+        "keyword": {
+            "type": "varchar",
+            "maxLength": 255,
+            "readOnly": true,
+            "isCustom": true
+        },
+        "campaign_id": {
+            "type": "varchar",
+            "maxLength": 100,
+            "readOnly": true,
+            "isCustom": true
+        },
+        "landing_page": {
+            "type": "varchar",
+            "maxLength": 500,
+            "readOnly": true,
+            "isCustom": true
+        },
+        "referrer": {
+            "type": "varchar",
+            "maxLength": 500,
+            "readOnly": true,
+            "isCustom": true
+        },
         "anzahlVermieter": {
             "type": "int",
             "required": true,
@@ -371,14 +431,6 @@
             "default": null,
             "buttonLabel": "Erstberatung versenden",
             "readOnly": true
-        },
-        "testArray": {
-            "type": "array",
-            "storeArrayValues": true,
-            "noEmptyString": true,
-            "default": [],
-            "itemsEditable": true,
-            "isCustom": true
         }
     },
     "links": {

data/config.php

@@ -349,8 +349,8 @@ return [
     0 => 'youtube.com',
     1 => 'google.com'
   ],
-  'cacheTimestamp' => 1768612623,
-  'microtime' => 1768612623.631556,
+  'cacheTimestamp' => 1768843792,
+  'microtime' => 1768843792.806048,
   'siteUrl' => 'https://crm.bitbylaw.com',
   'fullTextSearchMinLength' => 4,
   'appTimestamp' => 1768581056,