Verwendung von Plugins in Kupfer.

# Konfigurieren der Plugins

Functionality in Kupfer is organized by extentsion modules called "plugins". Each plugin provides additional functionality, for example integration with an external application.

# Einrichten von Plugins

## Öffnen Sie die Kupfer-Einstellungen und wechseln Sie zum Plugins-Reiter

Verwenden Sie eine der folgenden Methoden:

Click the Kupfer icon in the notification area and select the item Preferences

.

Suchen Sie nach dem Objekt Kupfer-Einstellungen in Kupfer selbst. Drücken Sie die Eingabetaste zum Öffnen.

Verwenden Sie das Tastenkürzel Strg;

Wählen Sie den Reiter Plugins.

Select plugins in the list to read about them, and tick the box next to its name to activate the plugin, or untick to deactivate.

If the plugin has any configurable parameters, they will be visible below the plugin information.

The plugin Kupfer Plugins allows fast access to each plugin's information page as well as the action "Show Source Code" which reveals the implementation.

# Wenn ein Plugin nicht aktiviert werden kann

Falls das Laden eines Plugins scheitert, weil ein bestimmtes benötigtes Softwaremodul nicht verfügbar ist, wird eine Meldung wie die folgende angezeigt:

Plugin could not be read due to an error:

Python module 'gdata' is needed

Dies bedeutet, dass Sie ein Python-Modul aus ihrer Distribution installieren müssen. Die Dokumentation des Plugins gibt möglicherweise dazu nähere Auskünfte.

Das Laden des Plugins könnte auch aus unerwartetem Grund scheitern und eine andere Fehlermeldung anzeigen. Es kann sich dann um einen Programmierfehler entweder im Plugin oder in Kupfer handeln.

# Weitere Plugins installieren

Sie können benutzerdefinierte Plugins in den Ordner `~/.local/share/kupfer/plugins` installieren. Jedes Plugin ist entweder eine einzelne `.py`-Datei oder ein Python-Package (ein Ordner, der direkt eine Datei namens `__init__.py` enthält). Plugins im Paketformat können Symboldateien enthalten. Python-Pakete können auch als `.zip`-Dateien installiert werden.

Achtung: Betrachten Sie Plugins als Computerprogramme. Installieren Sie keine Plugins aus Quellen, die nicht vertrauenswürdig sind.

# Plugins erstellen

Documentation for plugin creators is available in the file `Documentation/Manual.rst` in the source distribution on the webpage at Kupfer Manual.

An easy way to start is to copy an existing plugin and experimenting with it.

# Der Katalog-Reiter in den Einstellungen

Each plugin can export a number of sources which contain objects. Normally, all these objects are directly accessible from a top-level search. Some plugins export so specialized or so many objects that their catalogs should better not have their objects exported to the top level. To reach those objects, you have to first find the catalog by name, then enter the catalog using the action Search Contents.

In the tab Catalog in Kupfer Preferences, a ticked box next to each source means that its objects are exported. An unticked box means that its contents are hidden from the top level.

Hinweis: Kupfer kann sehr langsam werden, falls größere Unterkataloge in die oberste Ebene exportiert werden.