xippo/msgraph-bundle

Contao Bundle mit einem Notification Center Gateway für MS Graph E-Mail

Maintainers

Details

gitlab.xippo.net/xippo-gmbh-public/xippomsgraphbundle.git

Installs: 0

Dependents: 0

Suggesters: 0

Security: 0

Type:contao-bundle

v1.0.1 2025-05-09 14:12 UTC

Requires

MIT c977090851d5d3b8cd8c2f6a1178250c46f866b3

This package is auto-updated.

Last update: 2025-05-09 14:42:20 UTC

README

Das XippoMsGraphBundle ist ein Contao-Bundle, das die Integration der Microsoft Graph API ermöglicht. Es bietet Funktionen wie den Zugriff auf Microsoft-Dienste (z. B. E-Mails, Kalender, Benutzerverwaltung) und erweitert Contao um entsprechende Konfigurationsmöglichkeiten.

Features

  • Integration der Microsoft Graph API in Contao.
  • Unterstützung für den Versand von E-Mails über die Microsoft Graph API.
  • Mandantenfähige Konfiguration der Microsoft Graph API-Zugangsdaten im Contao-Root-Seitenbaum.
  • Erweiterung des Contao-Mailers um einen Microsoft Graph Transport.

Installation

  1. Installieren Sie das Bundle über Composer:

    composer require xippo/ms-graph-bundle

  2. Führen Sie ein Datenbank-Update im Contao-Manager oder über die Kommandozeile aus:

    vendor/bin/contao-console contao:migrate

  3. Konfigurieren Sie die Microsoft Graph API-Zugangsdaten im Contao-Backend im Root-Seitenbaum.

Konfiguration

Die Zugangsdaten für die Microsoft Graph API werden direkt im Contao-Root-Seitenbaum konfiguriert. Öffnen Sie dazu die Einstellungen der Root-Seite und tragen Sie die folgenden Werte ein:

  • Tenant ID: Ihre Microsoft Tenant ID.
  • Client ID: Ihre Microsoft Client ID.
  • Client Secret: Ihr Microsoft Client Secret.

Diese Werte werden pro Mandant gespeichert und ermöglichen eine mandantenfähige Nutzung der Microsoft Graph API.

Nutzung

E-Mail-Versand über Microsoft Graph

Das Bundle erweitert den Contao-Mailer um einen neuen Transport. Um den Microsoft Graph Transport zu verwenden, konfigurieren Sie den Mailer wie folgt:

MAILER_DSN=microsoft+graph://default

Der Transport verwendet automatisch die Zugangsdaten, die im Root-Seitenbaum konfiguriert wurden.

Weitere Funktionen

  • Zugriff auf Microsoft-Dienste wie Kalender, Benutzerverwaltung und mehr (zukünftige Erweiterungen geplant).

Voraussetzungen

  • Contao 4.13 oder höher
  • PHP 8.1 oder höher
  • Microsoft Azure App mit aktivierter Microsoft Graph API

Entwicklung

Falls Sie das Bundle erweitern oder anpassen möchten, klonen Sie das Repository und installieren Sie die Abhängigkeiten:

git clone https://github.com/xippo/ms-graph-bundle.git
cd ms-graph-bundle
composer install

Lizenz

Dieses Bundle steht unter der MIT-Lizenz.

Support

Bei Fragen oder Problemen erstellen Sie bitte ein Issue im GitHub-Repository.

Hinweis: Dieses Bundle befindet sich in aktiver Entwicklung. Feedback und Beiträge sind willkommen!