====== Plugins ======

===== Plugin hochladen =====

==== Plugin automatisch mit dem Installer hochladen ====
Wechseln Sie in Ihrer Sefrengo Version in den Bereich Administration -> Plugins. Klicken Sie oben rechts auf "Plugin importieren". Am unteren Ende des Bereichs
befindet sich ein Uploadfeld. Wählen Sie hier die gewünschte "*.cmsplug"- Datei aus. Mit einem Klick auf das Diskettensymbol wird das Plugin in das CMS importiert. Das Plugin ist nun innerhalb des CMS nutzbar. Installieren Sie das Plugin einem [[#Plugin importieren|Importiert]].

==== Plugin manuell auf den Server kopieren ====

Wenn in der Serverkonfiguration für PHP die Einstellung **safe-mode** eingeschaltet ist, klappt das automatische Installieren von Plugins in Sefrengo eventuell nicht. Beim Installieren erscheint dann die folgende Fehlermeldung:

**Tar Fehler. Funktion wird nicht ausgeführt!**

Meistens wird der Provider diese Einstellung aus gutem Grund vorgenommen haben und es kann schwer werden, ihn von etwas anderem zu überzeugen. Können wir nichts an der Serverkonfiguration ändern, müssen wir die gewünschten Plugins von Hand installieren.


Zuerst muß das Plugin natürlich heruntergeladen werden. Die meisten Plugins werden als .zip-Files zum Download angeboten. In dem .zip-File gibt es drei Dateien:

<code>
changelog.txt
readme.txt
pluginname.cmsplugin
</code>

Dateien mit der Endung .cmsplugin sind selbst wieder gepackte Archive. Entpacken wir dieses, so befindet sich darin eine Datei namens

<code>
[[Content]]
</code>

Bei dieser Datei handelt es sich wiederum um ein Archiv, welches wir erneut entpacken. In dem entpackten Ordner befindet sich schließlich ein **Ordner mit dem Namen unseres Plugins**. Er enthält auch die für Plugins typische Dateistruktur. Diesen Ordner benötigen wir.

Nachdem wir den benötigten Ordner gefunden und entpackt haben, müssen wir ihn per FTP auf unseren Server kopieren. Das Zielverzeichnis ist:

<code>
backend/plugins/
</code>

Den Rest der Installation können wir in Sefrengo selbst erledigen. Dazu rufen wir den Bereich **Administration => Plugins** auf.

  * Dort wählen wir die Option **Neues Plugin**, worauf sich anschließend eine neue Seite öffnet, in der wir allerhand Angaben zum Plugin machen könnten.
  * Wir wählen stattdessen die Option **Verzeichnis importieren** (oben rechts).
  * Anschließend können wir im **Dropdown-Feld Root-Verzeichnis** den Namen unseres Plugins auswählen. Daraufhin werden alle Felder automatisch mit den entsprechenden Informationen ausgefüllt.
  * Abschließend bestätigen wir die Einstellungen mit dem Speichern-Button.

Damit ist das Plugin in Sefrengo verfügbar und kann wie gewohnt importiert werden.



===== Plugin importieren =====
Ein Plugin muss aus dem "Plugin-Pool" in das jeweilige Projekt importiert werden. Wechseln Sie im gewünschten Projekt dazu in den Bereich Administration -> Plugins -> Plugin importieren.

Über den Button {{:faq:import.gif?nolink}} **Plugin importieren**, fügen Sie das Plugin dem aktuellen Projekt hinzu. Es wird automatisch in den Bereich Administration -> Plugins gewechselt und in der Liste angezeigt. Wenn für das Plugin ein Navigationspunkt vorgesehen ist, so ist dieser nun ebenfalls hinzugefügt. Das Plugin kann über diesen Navigationspunkt aufgerufen und genutzt werden.

===== Plugin konfigurieren =====
Nach dem das Plugin hochgeladen und importiert wurde, kann es über den {{:handbuch:administration:but_config.gif?nolink}} **Schraubenschlüssel** konfiguriert werden. Standardmäßig sind zwei Bereiche zum Konfigurieren vorgesehen.

Hinweis: Nicht jedes Plugin bringt eine Konfiguration mit.

==== Globale Konfiguration ====
In der globalen Konfiguration werden Einstellungen für alle importierten Plugins festgelegt. Die Einstellungen gelten unabhängig vom Projekt.
Sie gelangen zu dieser Seite wenn Sie im Bereich Administration -> Plugins -> Plugin importieren auf den {{:handbuch:administration:but_config.gif?nolink}} **Schraubenschlüssel** des gewünschten Plugins klicken.

==== Projektabhängige Konfiguration ====
Die projektabhängige Konfiguration gibt die Möglichkeit ein Plugin für ein bestimmtes Projekt zu konfigurieren. Damit kann bspw. erreicht werden, dass ein Plugin in Projekt 1 aktiviert ist und im Projekt 2 deaktiviert.

Sie gelangen zu dieser Seite wenn Sie im Bereich Administration -> Plugins auf den {{:handbuch:administration:but_config.gif?nolink}} **Schraubenschlüssel** des gewünschten Plugins klicken.

===== Plugin deinstallieren =====
==== Für ein Projekt deinstallieren ====

Soll ein Plugin aus einem Projekt deinstalliert werden, wechseln Sie in den Bereich Administration -> Plugins. Wählen Sie das gewünschte Plugin aus und klicken auf {{:handbuch:administration:but_delete.gif?nolink}} **Löschen**.

**Achtung:** Beim Deinstalliren, gehen alle Daten und Einstellungen für das Plugin in diesem(!) Projekt verloren! (Importe in anderen Projekten bleiben davon unberührt.)

Das Plugin steht damit für das aktuelle Projekt nicht mehr zu Verfügung. Evtl. Navigationspunkte wurden ebenfalls entfernt.

==== Komplett deinstallieren ====
Möchten Sie das Plugin entgültig aus Sefrengo entfernen, wechseln Sie in den Bereich Administration -> Plugins -> Plugin importieren. Wählen Sie das gewünschte Plugin aus und klicken auf {{:handbuch:administration:but_delete.gif?nolink}} **Löschen**.

Hinweis: Das entgültige Löschen ist nur möglich, wenn sich kein Import mehr in einem Projekt befindet, andernfalls ist der Löschen-Button ausgeblendet.
Nachdem Löschen steht das Plugin nicht mehr zur Verfügung. 


<note autor>
  * [[profil>11|Holger Stitz]]
</note>