Używanie wtyczek w Kupfera

# Konfiguracja wtyczek

Funkcje w Kupferze są umieszczone w modułach rozszerzających zwanych "wtyczkami". Każda wtyczka dostarcza dodatkowe funkcje, na przykład - integrację z zewnętrznymi programami.

# Konfiguracja wtyczek

## Otwarcie Preferencji Kupfera i karty "Wtyczki"

Otwarcie okna preferencji jest możliwe poprzez:

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

.

Znalezienie obiektu Preferencje Kupfera w Kupferze. Naciśnięcie klawisza Return otwiera okno preferencji.

Użycie skrótu klawiszowego Ctrl;

Wybranie karty Wtyczki

Zaznaczenie wtyczki na liście wyświetli informacje o niej. Zaznaczenie pola obok nazwy wtyczki aktywuje ją, odznaczenie - wyłącza ją.

Jeżeli wtyczka posiada konfigurowalne parametry, zostaną one wyświetlone poniżej informacji o wtyczce.

Wtyczka Wtyczki Kupfera pozwala na szybki dostęp do informacji na temat poszczególnych wtyczek, a także udostępnia akcję "Wyświetl kod źródłowy" umożliwiającą podgląd implementacji.

# Problemy z aktywacją wtyczki

Jeżeli wtyczka nie może zostać włączona z powodu braku wymaganego, zewnętrznego modułu na panelu informacyjnym pokazuje się odpowiednia informacja, na przykład:

Plugin could not be read due to an error:

Python module 'gdata' is needed

Komunikat taki oznacza, że należy zainstalować wymagany moduł Pythona - prawdopodobnie dokumentacja wtyczki dostarcza więcej informacji jak to zrobić.

Podczas ładowania wtyczki może także wystąpić nieoczekiwany błąd i pojawić się inny komunikat błędu. Może to oznaczać błąd programistyczny we wtyczce lub w Kupferze.

# Instalacja kolejnych wtyczek

Użytkownik ma możliwość instalacji dodatkowych wtyczek w katalogu `~/.local/share/kupfer/plugins`. Każda wtyczka jest w postaci pojedynczego pliku `.py` lub w postaci pakietu Pythona (katalog zawierający przynajmniej plik `__init__.py`). Wtyczki w postaci pakietów mogą zawierać pliki ikon. Pakiety Pythona mogą być instalowane jako pliki `.zip`.

Uwaga: Wtyczki są programami komputerowymi. Nie należy instalować wtyczek z niezaufanych źródeł.

# Tworzenie wtyczek

Dokumentacja dla twórców wtyczek jest dostępna w pliku `Documentation/Manual.rst` dostarczanym ze źródłami programu na stronie Kupfera. Najprostszą metodą na rozpoczęcie pracy jest skopiowanie istniejącej wtyczki i eksperymentowanie z nią.

# Karta Katalog w oknie preferencji

Każda wtyczka ma możliwość eksportowania pewnej ilości źródeł zawierających obiekty. W normalnej sytuacji, wszystkie z tych obiektów są bezpośrednio dostępne na najwyższym poziomie listy wyszukiwania. Niektóre wtyczki eksportują bardzo wyspecjalizowane obiektu lub bardzo dużą ich ilość i niekoniecznie powinny być wyświetlone na najwyższym poziomie listy. Aby dostać się do tych obiektów należy najpierw wyszukać katalog na podstawie jego nazwy, a następnie wejść do niego używając akcji Przeszukaj zawartość.

W karcie Katalog w Preferencjach Kupfera zaznaczenie pola przy poszczególnych źródłach oznacza, że jego obiekt będą eksportowane. Odznaczenie pola oznacza, że obiekty danego źródła są ukryte na najwyższym poziomie listy.

Uwaga: Kupfer może zachowywać się wolno, jeżeli znacząca ilość podkatalogów jest eksportowana na najwyższy poziom listy.