Differences

This shows you the differences between two versions of the page.

--- de:plugins:installation [2026/01/11 11:24] – fasse
+++ de:plugins:installation [2026/01/24 12:13] (current) – fasse
@@ Line 1: / Line 1: @@
 ====== Plugins in die Homepage einbauen ======
-===== Der Unterschied zwischen Plugins und Modulen =====
+===== Welche Plugins kann ich auf anderen Webseiten einbauen? =====
-Plugins sind kleine Php-Scripte für bestimmte Aufgaben (z.B. nächsten 2 Termine anzeigen, aktuelle Geburtstage anzeigen ...). Sie müssen im Gegensatz zu Modulen aber nicht unbedingt als eigene Seite aufgerufen werden, sondern können in jede beliebige Html- oder Php-Seite eingebunden werden. Du kannst die Plugins auch in der body_top.php oder body_bottom.php von Admidio einbauen, so dass bestimmte Informationen auf allen Admidio-Seiten angezeigt werden.
+Du möchtest bestimmte Informationen von Admidio auf deiner Vereinsseite oder anderswo anzeigen? Dazu kannst du die Plugins auf der Übersichts-Seite von Admidio nutzen. Es gibt hier für fast jedes Modul ein Plugin, welches sich auch individuell anpassen lässt. Hier kannst du z.B. die nächsten 2 Veranstaltungen oder aktuelle Geburtstage anzeigen. Diese Übersichts-Plugins müssen im Gegensatz zu Modulen aber nicht unbedingt als eigene Seite aufgerufen werden, sondern können als HTML-Schnipsel in andere Webseiten integriert werden.
+===== Wie baue ich Plugins ein? =====
+Das entsprechende Plugin sollte im Ordner **adm_plugins** bereits eingerichtet sein.
+==== Plugin in die Admidio-Übersicht einbauen ====
-===== Wie baue ich Plugins ein ? =====
-Lade das Plugin aus [[de:plugins| unserem Pluginbereich]] herunter und entpacken die Zip-Datei. Kopiere das Verzeichnis mit den Dateien in den Ordner **adm_plugins** in euren Admidio-Ordner. Falls der Ordner adm_plugins noch nicht existiert, muss dieser zuerst noch erstellt werden. Dieser sollte sich auf derselben Ebene wie adm_my_files befinden.
-==== Plugin in die Admidio einbauen ====
 Prüfe im ersten Schritt auf der Pluginseite die Installationsanleitung. Einige Plugins liefern ein eigenes Installationsscript und integrieren sich damit selbstständig in unser Menü. In diesem Fall sind dann keine weiteren Schritte notwendig.
@@ Line 16: / Line 14: @@
 Dort sind mehrere DIV-Blöcke hinterlegt und du musst hinter einem existierenden DIV-Block deinen neuen DIV-Block ergänzen. Die DIV-Blöcke sehen so aus:
-<code html><div class="admidio-overview-plugin col-sm-6 col-lg-4 col-xl-3" id="admidio-plugin-datei-name">
+<code html><div class="admidio-overview-plugin col-sm-6 col-lg-4 col-xl-3" id="admidio-plugin-name">
     <div class="card admidio-card">
         <div class="card-body">
@@ Line 27: / Line 25: @@
 Willst du zum Beispiel das Plugin ''adm_plugins/calendar/calendar.php'' einbinden, so sieht der Code-Block anschließend so aus:
 <code html><div class="admidio-overview-plugin col-sm-6 col-lg-4 col-xl-3" id="admidio-plugin-calendar">
-        <div class="card admidio-card">
+   <div class="card admidio-card">
-            <div class="card-body">
+      <div class="card-body">
-                {load_admidio_plugin plugin="calendar" file="index.php"}
+         {load_admidio_plugin plugin="calendar" file="index.php"}
-            </div>
+      </div>
-        </div>
+   </div>
-    </div></code>
+</div></code>
 Anschließend kannst du die Übersichtsseite neu laden und dein Plugin sollte sichtbar sein.
@@ Line 39: / Line 37: @@
 Du kannst die Plugins in der Regel auch außerhalb der Admidio-Seiten nutzen und in deine eigenen HTML/PHP-Seiten einbinden. Allerdings sind hier ein paar zusätzliche Schritte notwendig.
+=== Plugin als iFrame einbauen ===
+Die einfachste und empfohlene Möglichkeit Plugins der Übersichts-Seite in eine andere Webseite zu integrieren ist diese als iFrame in den HTML-Code der anderen Webseite einzubauen. Dazu kannst du die nachfolgende HTML-Code genau an der Stelle platzieren an der du das Plugin anzeigen möchtest:
+<code html><iframe src="#URL-zu-Admidio#/adm_plugins/#Ordner-des-konkreten-Plugins#/#Startdatei-des-Plugins#"></iframe></code>
+Die konkrete Implementation für das Login-Plugin sähe dann so aus, wenn Admidio in deinem Webspace in dem Unterordner **admidio** installiert ist:
+<code html><iframe src="admidio/adm_plugins/login_form/index.php"></iframe></code>
+Die Größe, Rahmen und Abstände des Plugins kannst du dann ganz einfach für CSS festlegen, was dann so aussehen könnte:
+<code css>iframe {
+   width: 80%;
+   height: 600px;
+   border: 1px solid #ccc;
+}</code>
+Jetzt kann du deine Webseite neu aufrufen und das entsprechende Plugin wird nun angezeigt :-)
+\\ \\
+=== Plugin als Code-Block in Webseite einbauen ===
 Falls du das Plugin nun in eine reine Html-Seite einbinden möchtest, solltest du die Dateierweiterung der Seite zuerst von html in php umbenennen. Nun kannst du das Modul mit Hilfe von PHP in deine ehemals reine Html-Seite integrieren. Füge nun das Plugin (als Beispiel wird hier das Plugin //login_form// benutzt) mit einer der folgenden Methoden in deinen Html-Code an der Stelle ein, an der die Ausgabe des Plugins dargestellt werden soll:
@@ Line 45: / Line 60: @@
 <code php><?php
-  include_once($_SERVER['DOCUMENT_ROOT']. '/Pfad-zu-Admidio-Ordner /adm_program/system/common.php');
+  include_once($_SERVER['DOCUMENT_ROOT']. '/Pfad-zu-Admidio-Ordner /system/common.php');
 ?></code>
 Der //Pfad-zu-Admidio-Ordner// muss dabei die Ordnerstruktur beinhalten, die man von der Datei gehen muss, in der du das Plugin einbauen willst, bis zum Admidio-Ordner.
@@ Line 57: / Line 72: @@
   Include-Befehl:
-  include_once($_SERVER['DOCUMENT_ROOT']. '/admidio/adm_program/system/common.php');
+  include_once($_SERVER['DOCUMENT_ROOT']. '/admidio/system/common.php');
 **Beispiel 2**
@@ Line 67: / Line 82: @@
   Include-Befehl:
-  include_once($_SERVER['DOCUMENT_ROOT']. '/../admidio/adm_program/system/common.php');
+  include_once($_SERVER['DOCUMENT_ROOT']. '/../admidio/system/common.php');
 . Danach folgt der Einbau der Plugins an der gewünschten Stellen:
 <code php><?php
-  include($_SERVER['DOCUMENT_ROOT']. '/Pfad-zu-Admidio-Ordner /adm_plugins/login_form/login_form.php');
+  include($_SERVER['DOCUMENT_ROOT']. '/Pfad-zu-Admidio-Ordner /adm_plugins/login_form/index.php');
 ?></code>
@@ Line 78: / Line 93: @@
 <code php><?php
-  include('http://www.example.org/Pfad-zu-Admidio /adm_plugins/login_form/login_form.php');
+  include('http://www.example.org/Pfad-zu-Admidio /adm_plugins/login_form/index.php');
 ?></code>
@@ Line 92: / Line 107: @@
 Bei einem Update des Plugins brauchen und sollten diese beiden Dateien nicht überschrieben werden. Sind durch das Update neue Einstellungen oder CSS-Einstellungen hinzugekommen, so können die neuen Variablen bzw. CSS-Einstellungen, aus der **config_sample.php** in die bisherige Dateien (//config.php// und //pluginname.css//) des Plugins kopiert und die gewünschten Werte eingesetzt werden.
-Ein Beispiel für eine Integration von mehreren Plugins in einer Seitenleiste siehst du auf diesem Screenshot im hervorgehobenen Bereich:
+Ein Beispiel für eine Integration eines Plugins mittels iFrame in eine Webseite siehst du auf diesem Screenshot im hervorgehobenen Bereich:\\
+{{:de:plugins:plugin_integration_de.png?300|Plugins per iFrame einbauen}}
-{{:de:2.0:documentation:plugins:plugins_show.png?400|Plugins einbauen}}
+Ein Beispiel für eine Integration der Plugins auf der Übersichtsseite siehst du auf diesem Screenshot:\\
+{{:de:plugins:plugin_overview_de.png?400|Plugins in Übersichtsseite einbauen}}
 ===== Wie aktualisiere ich ein Plugin ? =====
 Steht ein Update an, sei es wegen einer Fehlerbehebung, einer neuen Funktion oder aufgrund einer Inkompatiblität zur aktuellen Admidio-Version, so kann einfach der Ordner des entsprechenden Plugins ausgetauscht werden. Lade dir dazu die aktuelle Version aus dem [[de:plugins:index|Pluginbereich]] herunter und ersetze den vorhandenen Pluginordner durch den neuen Ordner aus der Zip-Datei. Besonderheiten beim Update werden in der **readme.txt** im Pluginordner erwähnt.