Unwichtige Korrekturen ausblenden - Änderungen im Wiki Quelltext
verfügbar ab Stud.IP-Version 1.3.0
(:toc:)
Neben den schon in Stud.IP fest eingebauten Grundfunktionen gibt es die Möglichkeit, verschiedene Erweiterungen in Form von Plugins nachträglich im System zu installieren. Diese können das Stud.IP um neue Funktionen erweitern oder bereits vorhandene Funktionen verbessern oder sogar komplett ersetzen. Eine Übersicht über die meisten der für alle Betreiber frei verfügbaren Plugins gibt das Plugin-Repository (auch "Plugin-Marktplatz" genannt):
Alle auf dem System installierten Plugins werden in dem Verzeichnis public/plugins_packages abgelegt. Dieses Verzeichnis muss für den Webserver-Nutzer schreibbar sein. Die Plugin-Schnittstelle in Stud.IP ist standardmäßig aktiviert und läßt sich über zwei Konfigurationsvariablen in der Datei config/config_local.inc.php anpassen:
public/plugins_packages
config/config_local.inc.php
Die Administration von Plugins geschieht in der Plugin-Verwaltung, die auf der Startseite des Root-Administrators als Menüeintrag Verwaltung von Plugins erscheint. Die Plugin-Verwaltung ermöglicht das Ein- und Ausschalten der installierten Plugins sowie die Installation von Plugins aus einem Plugin-Repository und den Upload von Plugin-Paketen. Eine Aktualisierung der installierten Plugins ist ebenfalls möglich.
Anfangs sind noch keine Plugins im System vorhanden. Um ein Plugin zu installieren, klicken Sie rechts in der Info-Box auf den Punkt "Weitere Plugins installieren".
Hier wird zunächst eine Liste von empfohlenen Plugins angezeigt, die bereits an vielen anderen Standorten eingesetzt werden. Weitere Plugins lassen sich mit Hilfe der Suchfunktion finden. Zu jedem Plugin wird jeweils ein Vorschaubild und eine kurze Beschreibung angezeigt. Durch einen Klick auf das Installations-Symbol wird das gewählte Plugin dann im eingenen Stud.IP installiert. Alternativ zur Auswahl aus der Liste und der Plugin-Suche kann auch ein Plugin als ZIP-Datei hochgeladen werden (wenn diese Funktion nicht deaktiviert wurde). Dazu gibt es unter der Liste der Empfehlungen ein ensprechendes Upload-Formular.
Nach dem Installieren eines neuen Plugins ist dieses erst mal deaktiviert und muß noch eingeschaltet werden. Das geschieht ebenfalls in der Plugin-Verwaltung, in der die verschiedenen Plugins aktiviert bzw. deaktiviert und Berechtigungen zugewiesen werden können.
In der linken Spalte wird für jedes installierte Plugin angezeigt, ob es zur Zeit aktiviert ist. Dort kann das Plugin auch ein- oder ausgeschaltet werden. Auf der rechten Seite gibt es für jedes Plugin die Möglichkeit, eine Position festzulegen und verschiedene Aktionen auszuführen. Die Position gibt die Reihenfolge des Plugins in der Navigation - z.B. auf der Startseite oder in den Reitern einer Veranstaltung - an. Erlaubt sind hier nur Zahlenwerte größer als 0. Daneben gibt es noch die folgenden Aktionen:
Falls eine Aktualisierung für eines oder mehrere Plugins verfügbar ist, wird darauf normalerweise direkt beim Betreten der Plugin-Verwaltung hingewiesen:
Die entsprechenden Updates werden nach dem Klick auf starten automatisch heruntergeladen und installiert. Ist eine Aktualisierung nur als ZIP-Datei verfügbar oder soll eine ältere Version eines Plugins wieder installiert werden, so muss dies durch das Hochladen der entsprechenden Version des Plugins als ZIP-Datei (wie oben beschrieben) passieren.
Die Verwaltung von Rechten für Plugins geschieht in der Rollenverwaltung, die auf der Startseite des Root-Administrators als Menüeintrag Verwaltung von Rollen erscheint und auch direkt von der Plugin-Verwaltung aus über die Aktion Zugriffsrechte bearbeiten aufgerufen werden kann.
Über die Rollenverwaltung können Nutzer und Plugins den im System vorhandenen Rollen zugeordnet werden.
Standardmäßig gibt es bereits eine Reihe von Systemrollen, die jeder Nutzer automatisch auf Basis seines globalen Nutzerstatus zugewiesen bekommt:
Daneben gibt es noch eine spezielle Rolle, die automatisch für alle Nutzer verwendet wird, die nicht im System angemeldet sind, z.B. beim Aufruf einer freien Veranstaltung oder der externen Seiten:
In der Rollenverwaltung kann nun für jedes Plugin einzeln festgelegt werden, welche Nutzergruppen darauf Zugriff haben sollen. Die Voreinstellung nach dem Installieren eines neuen Plugins ist dabei: alle angemeldeten Nutzer (d.h. alle Systemrollen außer Nobody). Soll ein Plugin auch für nicht angemeldete Nutzer sichtbar sein, muß das hier entsprechend angepaßt werden.
Für Plugins, die nur einer ganz speziellen, selbst zusammengestellten Nutzergruppe zugänglich sein sollen, gibt es die Möglichkeit, eine eigene Rolle zu erstellen (z.B. Evaluationsbeauftragte) und die Liste der Nutzer für diese Rolle zu bearbeiten. Dazu können auf der Übersichtsseite der Rollenverwaltung eigene Rollen angelegt und gelöscht werden. Diese können dann genauso wie die Systemrollen verwendet werden.
(:redirect 'http://docs.studip.de/admin/Admins/PluginVerwaltung':)
Hier wird zunächst eine Liste von empfohlenen Plugins angezeigt, die bereits an vielen anderen Standorten eingesetzt werden. Weitere Plugins lassen sich mit Hilfe der Suchfunktion finden. Zu jedem Plugin wird jeweils ein Vorschaubild und eine kurze Beschreibung angezeigt. Durch einen Klick auf das Installations-Symbol wird das gewählte Plugins im eingenen Stud.IP installiert. Alternativ zur Auswahl aus der Liste oder der Suche kann auch ein Plugin als ZIP-Datei hochgeladen werden (wenn diese Funktion nicht deaktiviert wurde). Dazu gibt es unter der Liste der Empfehlungen ein ensprechendes Upload-Formular.
Nachdem man ein neues Plugin installiert hat, muß es noch eingeschaltet werden. Das geschieht ebenfalls in der Plugin-Verwaltung, in der die verschiedenen Plugins aktiviert bzw. deaktiviert und Nutzerrollen zugewiesen werden können.
In der linken Spalte wird für jedes installierte Plugins angezeigt, ob es aktuell aktiv ist. Dort kann das Plugin auch ein- oder ausgeschaltet werden. Auf der rechten Seite gibt es für jedes Plugin die Möglichkeit, eine Position festzulegen und verschiedene Aktionen auszuführen. Die Position gibt die Reihenfolge des Plugins in der Navigation - z.B. auf der Startseite oder in den Reitern einer Veranstaltung - an. Erlaubt sind hier nur Zahlenwerte größer als 0. Daneben gibt es noch die folgenden Aktionen:
Die Verwaltung von Rechten für Plugins geschieht in der Rollenverwaltung, die auf der Startseite des Root-Administrators als Menüeintrag Verwaltung von Rollen erscheint oder von der Plugin-Verwaltung aus über die Aktion Zugriffsrechte bearbeiten aufgerufen werden kann.
Standardmäßig gibt es bereits eine Reihe von Systemrollen, die Nutzer automatisch auf Basis ihres globalen Nutzerstatus zugewiesen bekommen:
Daneben gibt es noch eine spezielle Rolle, die automatisch für Nutzer verwendet wird, die nicht im System angemeldet sind, z.B. bei Nutzung einer freien Veranstaltung oder der externen Seiten:
Die Plugin-Schnittstelle ist standardmäßig aktiviert und läßt sich über zwei Konfigurationsvariablen in der Datei config/config_local.inc.php anpassen. In der Standardkonfiguration kann der Root-Administrator Plugin-Pakete über ein Upload-Formular hochladen. Falls man nicht möchte, daß der Root-Administrator beliebigen PHP-Code in das System bringen darf, kann man alternativ die Installation nur aus einem (öffentlichen oder privaten) Plugin-Repository zulassen. Dazu wird die Variable $PLUGINS_UPLOAD_ENABLE auf false gesetzt und die entsprechende URL in die Variable $PLUGIN_REPOSITORIES mit aufgenommen. Standardmäßig ist hier bereits das offizielle Plugin-Repository des Stud.IP-Projekts eingetragen, in dem die meisten Plugins verfügbar sind.
Alle auf dem System installierten Plugins werden in dem Verzeichnis public/plugins_packages abgelegt. Dieses Verzeichnis muss für den Webserver-Nutzer schreibbar sein.
Die Installation von Plugins geschieht in der Plugin-Verwaltung, die auf der Startseite des Root-Administrators als Menüeintrag Verwaltung von Plugins erscheint. Die Plugin-Verwaltung ermöglicht das Ein- und Ausschalten der installierten Plugins sowie die Installation von Plugins aus einem Plugin-Repository und den Upload von Plugin-Paketen. Eine Aktualisierung der installierten Plugins ist ebenfalls möglich.
TODO
Nachdem man ein Plugin installiert hat, muß es noch eingeschaltet werden. Das geschieht ebenfalls in der Plugin-Verwaltung, in der die verschiedenen Plugins aktiviert bzw. deaktiviert und Nutzerrollen zugewiesen werden können.
Die Verwaltung von Rechten geschieht in der Rollenverwaltung, die auf der Startseite des Root-Administrators als Menüeintrag Verwaltung von Rollen erscheint.
Die Plugin-Schnittstelle ist standardmäßig aktiviert und läßt sich über verschiedene Konfigurationsvariablen in der Datei config/config_local.inc.php anpassen. Falls man sie nicht benötigt und abschalten möchte, muß die Variable $PLUGINS_ENABLE auf false gesetzt werden.
In der Standardkonfiguration kann der Root-Administrator Plugin-Pakete über ein Upload-Formular hochladen. Falls man nicht möchte, daß der Root-Administrator beliebigen PHP-Code in das System bringen darf, kann man alternativ die Installation nur aus einem definierten Verzeichnis auf dem Web-Server zulassen. Dazu wird die Variable $PLUGINS_UPLOAD_ENABLE auf false gesetzt und das entsprechende Verzeichnis über die Variable $NEW_PLUGINS_PATH festgelegt. Hier muß ein absoluter Pfad zu einem für den Webserver-Benutzer lesbaren Verzeichnis angegeben werden.
Die Installation von Plugins geschieht in der Plugin-Verwaltung, die auf der Startseite des Root-Administrators als Menüeintrag Verwaltung von Plugins erscheint. Die Plugin-Verwaltung ermöglicht den Upload von Plugin-Paketen, entpackt diese im System und registriert sie in der Datenbank. Eine Aktualisierung von Plugins ist ebenfalls möglich.
Die Plugin-Schnittstelle ist in der Voreinstellung aktiviert und läßt sich über verschiedene Konfigurationsvariablen in der Datei config/config_local.inc.php anpassen. Falls man sie abschalten möchte, muß die Variable $PLUGINS_ENABLE auf false gesetzt werden.
Die Installation von Plugins geschieht in der Plugin-Verwaltung, die auf der Startseite des Root-Administrators als Menüeintrag Verwaltung von Plugins erscheint.
Quelle: Basis-Wiki-Hilfe | Letzte Änderung: 01.02.2011 13:48 Uhr, tthelen | Local view: Basis-Hilfe
