# Plugins

CrunchyFrog kann durch Plugins erweitert werden. crunchyfrog-plugins-working beschreibt die Installation und Aktivierung von Plugins; crunchyfrog-plugins-builtin stelle Plugins vor, die zusammen mit CrunchyFrog vertrieben werden; gibt eine kurze Übersicht über die Entwicklung eigener Plugins.

## Umgang mit Plugins

Plugins werden im Einstellungsdialog verwaltet: Datei Einstellungen Plugins .

Im linken Teil der Registerkarte werden alle verfügbaren Plugins gruppiert nach Kategorien in einer Liste angezeigt. Standardmäßig werden nur lokal verfügbare Plugins angezeigt. Damit Plugins, die im Online-Repository verfügbar sind, ebenfalls in der Liste angezeigt werden, aktivieren Sie die Option Repository aktivieren.

Sie aktivieren ein Plugin, indem Sie das Häkchen vor dem Namen des Plugins in der Pluginliste setzen. Falls Sie ein Plugin aktivieren möchten, dass im Plugin-Repository verfügbar ist, werden Sie zuvor gefragt, ob Sie dieses Plugin herunterladen möchten.

Mit den Schaltflächen können folgende Aktionen ausgeführt werden:

Plugin installieren

- Lokale Installation von Plugins, die als `*.zip`-Datei vorliegen.

Infos zu diesem Plugin

- Zeigt weitere Informationen zu einem selektiertem Plugin an.

Plugin konfigurieren

- Öffnet einen Dialog zur Konfiguration eines Plugins. Diese Schaltfläche ist nur aktiv, wenn das selektierte Plugin weitere Einstellungen erfordert.

Plugin-Verzeichnis öffnen

- Öffnet die Standard-Dateiverwaltung und zeigt das Verzeichnis mit Plugins an, die vom Benutzer installiert wurden (`~/.crunchyfrog/plugins`). Änderungen in diesem Ordner werden ohne Neustart von CrunchyFrog wirksam.

Synchronisieren

- Synchronisiert die Liste der online verfügbaren Plugins.

## Standard-Plugins

### Datenbank-Anbindungen

LDAP

- Anbindung an LDAP-Server

MySQL

- Anbindung an MySQL-Datenbanken (ab Version 5)

PostgreSQL

- Anbindung an PostgreSQL-Datenbanken (ab Version 8.1)

SQLite3

- Anbindung an SQLite3-Datenbanken

### Export

CSV

- Export von Daten als CSV-Datei

OpenDocument

- Export von Daten als OpenDocument-Tabelle

### SQL-Bibliothek

Dieses Plugin ergänzt die Menüleiste um den Eintrag Bibliothek. Wählen Sie aus diesem Menü den Eintrag Zur Bibliothek hinzufügen, um den Inhalt des aktuellen SQL-Editors in der Bibliothek abzulegen. Einträge in der Bibliothek können Kategorien zugeordnert werden.

Die SQL-Bibliothek dient als eine Art Ablage für häufig benötigte Abfragen.

### Python-Konsole

Die Python-Konsole dient vor allem zum Debuggen von selbst entwickelten Plugins. Sie bietet Zugriff auf die interne Programmstruktur von CrunchyFrog.

Weitere Informationen zur Python-Konsole finden Sie auf der Wiki-Seite. Beachten Sie auch die API-Dokumentation.

## Plugin-Entwicklung

Wenn Sie den Funktionsumfang von CrunchyFrog durch eigene Plugins erweitern möchten, lesen Sie bitte die folgenden Dokumentationen:

Plugin Development

- Zusammenstellung der wichtigsten Klassen und Funktionen zur Entwicklung von Plugins für CrunchyFrog.

API-Dokumentation

- Vollständige Dokumentation der CrunchyFrog-API.

Wenn Sie die Source-Distribution von CrunchyFrog heruntergeladen haben, finden Sie im Verzeichnis `docs` ein einfaches Beispiel-Plugin.