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"

  1. Otwarcie okna preferencji jest możliwe poprzez:

    • Kliknięcie ikony Kupfera w obszarze powiadamiania i wybranie Preferencje

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

    • Użycie skrótu klawiszowego Ctrl+;

  2. 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:

Wtyczka nie może być wczytana ze względu na błąd:

Wymagany jest moduł Pythona 'gdata'.

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.