Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
de:plugins:installation [2020/11/14 07:53] – fassede:plugins:installation [2021/09/22 11:06] (current) – fasse
Line 8: Line 8:
 ===== Wie baue ich Plugins ein ? ===== ===== 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. 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 3 einbauen ==== 
- 
-Der Einbau des Plugins innerhalb von Admidio ist sehr einfach. Gehe dazu idealerweise in die Datei **adm_themes/modern/my_body_bottom.php** und füge dort an der entsprechenden Stelle den folgenden Codeschnipsel hinzu: 
-<code php><?php include(ADMIDIO_PATH . FOLDER_PLUGINS . '/birthday/birthday.php'); ?></code> 
-Befindest du dich bereits innerhalb eines PHP-Teils der Seite, dann musst du nur folgenden Code hinzufügen: <code php>include(ADMIDIO_PATH . FOLDER_PLUGINS . '/birthday/birthday.php');</code> 
- 
-Lade nun die Admidio-Seite neu und das Plugin sollte jetzt angezeigt werden.\\   
-Seit Version 3.0 werden auch CSS-Dateien des Plugins automatisch geladen und müssen nicht separat aufgerufen werden. 
  
 ==== Plugin in die Admidio 4 einbauen ==== ==== Plugin in die Admidio 4 einbauen ====
Line 24: Line 15:
 Andere Plugins können sich mit einem kleinen HTML-Script auf der Übersichtsseite einbinden lassen. Dazu muss das entsprechende Script in die Template-Datei ''adm_themes/simple/templates/overview.tpl'' eingebunden werden. Andere Plugins können sich mit einem kleinen HTML-Script auf der Übersichtsseite einbinden lassen. Dazu muss das entsprechende Script in die Template-Datei ''adm_themes/simple/templates/overview.tpl'' eingebunden werden.
  
-Dort sind mehrere DIV-Blöcke hinterlegt und ihr müsst hinter einem DIV-Block euren neuen DIV-Block ergänzen. Die DIV-Blöcke sehen so aus: +Dort sind mehrere DIV-Blöcke hinterlegt und ihr müsst hinter einem existierenden DIV-Block euren neuen DIV-Block ergänzen. Die DIV-Blöcke sehen so aus: 
 <code html><div class="col-sm-6 col-lg-4 col-xl-3"> <code html><div class="col-sm-6 col-lg-4 col-xl-3">
     <div class="card admidio-roles" id="role_details_panel_'.$rolId.'">     <div class="card admidio-roles" id="role_details_panel_'.$rolId.'">
Line 34: Line 25:
 Ersetzt in diesem DIV-Block den **plugin-name** durch den Namen des Ordners eures Plugins und ersetzt **plugin-datei-name** durch den Dateinamen der das Html-Script beinhaltet. Ersetzt in diesem DIV-Block den **plugin-name** durch den Namen des Ordners eures Plugins und ersetzt **plugin-datei-name** durch den Dateinamen der das Html-Script beinhaltet.
  
-Wollt ihr zum Beispiel das Plugin **adm_plugins/calendar/calendar.php** einbinden, so ist sieht der Code-Block anschließend so aus: +Wollt ihr zum Beispiel das Plugin ''adm_plugins/calendar/calendar.php'' einbinden, so ist sieht der Code-Block anschließend so aus: 
 <code html><div class="col-sm-6 col-lg-4 col-xl-3"> <code html><div class="col-sm-6 col-lg-4 col-xl-3">
     <div class="card admidio-roles" id="role_details_panel_'.$rolId.'">     <div class="card admidio-roles" id="role_details_panel_'.$rolId.'">
Line 44: Line 35:
  
 Anschließend könnt ihr die Übersichtsseite neu laden und euer Plugin sollte sichtbar sein. Anschließend könnt ihr die Übersichtsseite neu laden und euer Plugin sollte sichtbar sein.
 +
 +
 +==== Plugin in die Admidio 3 einbauen ====
 +
 +Der Einbau des Plugins innerhalb von Admidio ist sehr einfach. Gehe dazu idealerweise in die Datei **adm_themes/modern/my_body_bottom.php** und füge dort an der entsprechenden Stelle den folgenden Codeschnipsel hinzu:
 +<code php><?php include(ADMIDIO_PATH . FOLDER_PLUGINS . '/birthday/birthday.php'); ?></code>
 +Befindest du dich bereits innerhalb eines PHP-Teils der Seite, dann musst du nur folgenden Code hinzufügen: <code php>include(ADMIDIO_PATH . FOLDER_PLUGINS . '/birthday/birthday.php');</code>
 +
 +Lade nun die Admidio-Seite neu und das Plugin sollte jetzt angezeigt werden.\\  
 +Seit Version 3.0 werden auch CSS-Dateien des Plugins automatisch geladen und müssen nicht separat aufgerufen werden.
  
 ==== Plugin außerhalb von Admidio-Seiten einbauen ==== ==== Plugin außerhalb von Admidio-Seiten einbauen ====
Line 95: Line 96:
  
 ===== Wo kann ich Plugins konfigurieren ? ===== ===== Wo kann ich Plugins konfigurieren ? =====
-Konfigurieren kannst du die meisten Plugins über eine **config.php** Datei, die sich im selben Ordner wie das Plugin befindet. Hier stehen einige Variablen mit Default-Werten zur Verfügung. Diese kannst du nach euren Bedürfnissen anpassen.+Konfigurieren kannst du die meisten Plugins über eine **config.php** Datei. Dazu wird meistens eine **config_sample.php** Datei ausgeliefert, welche sich im Ordner des Plugins befinden sollte. Diese Datei kannst du dann einfach in **config.php** umbenennen. Hier stehen einige Variablen mit Default-Werten zur Verfügung. Diese kannst du nach euren Bedürfnissen anpassen.
  
 Besitzt das Plugin eine eigene CSS Datei, kann über diese das Layout des Plugins angepasst werden. Besitzt das Plugin eine eigene CSS Datei, kann über diese das Layout des Plugins angepasst werden.
  
-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 den heruntergeladenen Dateien in die bisherige Dateien //(config.php und pluginname.css)// des Plugins kopiert und die gewünschten Werte eingesetzt werden.+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 seht ihr auf diesem Screenshot im hervorgehobenen Bereich: Ein Beispiel für eine Integration von mehreren Plugins in einer Seitenleiste seht ihr auf diesem Screenshot im hervorgehobenen Bereich:
Line 106: Line 107:
  
 ===== Wie aktualisiere ich ein Plugin ? ===== ===== 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 [[http://forum.admidio.org/viewforum.php?f=9|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.+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.
  • de/plugins/installation.1605336813.txt.gz
  • Last modified: 2020/11/14 07:53
  • by fasse