Google Maps in beliebige Vtiger-Module einbinden – Schnellanleitung

Google Maps in beliebige Vtiger-Module einbinden – Schnellanleitung

In diesem Artikel zeigen wir, wie Sie Google Maps in ein beliebiges Vtiger-Modul (z. B. „Potentials“) integrieren – ähnlich wie in den Standardmodulen „Leads“ oder „Contacts“.

Schritt 1: Button für Karte im Detail-View hinzufügen

Erweitern Sie die Template-Datei des gewünschten Moduls um einen Karten-Button.

Datei: layouts/v7/modules/Potentials/DetailViewHeaderTitle.tpl

<div class="info-row">
    <i class="fa fa-map-marker"></i>&nbsp;
    <a class="showMap" href="javascript:void(0);" 
       onclick='Vtiger_Index_Js.showMap(this);' 
       data-module='{$RECORD->getModule()->getName()}' 
       data-record='{$RECORD->getId()}'>
       {vtranslate('LBL_SHOW_MAP', $MODULE_NAME)}
    </a>
</div>

Schritt 2: Adressfelder konfigurieren

Definieren Sie die Adressfelder des Moduls in modules/Google/helpers/Map.php.

// modules/Google/helpers/Map.php
case 'Potentials':
    $locationFields = [
        'street'   => 'cf_1148', // Straßenfeld (Custom Field)
        'city'     => 'cf_1142', // Stadt
        'state'    => 'cf_1203', // Bundesland
        'zip'      => 'cf_984',  // Postleitzahl
        'country'  => 'cf_777'   // Land
    ];
    break;

Hinweis:

• Ersetzen Sie cf_xxx durch die Feldnamen Ihres Moduls.
• Custom Fields (CFs) finden Sie unter:
  CRM-Einstellungen > Studio > Modul > Felder verwalten.

Schritt 3: Kartenfunktion testen

1. Cache leeren:

   rm -rf tmp/ && php cron.php

2. Datensatz öffnen: Navigieren Sie zu einem Potential-Datensatz.
3. Karte anzeigen: Klicken Sie auf den „Karte anzeigen“-Button.

Häufige Probleme & Lösungen

Erweiterung für weitere Module

Wiederholen Sie die Schritte 1–2 für jedes gewünschte Modul:

1. Template-Datei des Moduls anpassen (z. B. Quotes).
2. Adressfelder in Map.php hinterlegen.

// Für Modul "Quotes"
case 'Quotes':
    $locationFields = [
        'street'   => 'cf_2001',
        // ...
    ];
    break;

🔗 Nützliche Links:

• Vtiger-Dokumentation: Custom Fields
• Google Maps API Key anfordern

„Eine Karte sagt mehr als tausend Datensätze.“ – Unbekannter Vtiger-Entwickler