<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="managing-plugins" xml:lang="pl">

  <info>
   <link type="guide" xref="index#usage"/>
   <desc>Używanie wtyczek w <app>Kupfera</app></desc>
  </info>

  <title>Konfiguracja wtyczek</title>

  <p>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.</p>

  <section>
    <title>Konfiguracja wtyczek</title>
    <steps>
      <title>Otwarcie <app>Preferencji Kupfera</app> i karty "Wtyczki"</title>
      <item>
        <p>Otwarcie okna preferencji jest możliwe poprzez:</p>
        <list>
          <item><p>Click the Kupfer icon in the notification area and select
              the item <em>Preferences</em></p>.
          </item>
          <item>
            <p>Znalezienie obiektu <app>Preferencje Kupfera</app> w Kupferze. Naciśnięcie klawisza <key>Return</key> otwiera okno preferencji.</p>
          </item>
          <item><p>Użycie skrótu klawiszowego <keyseq><key>Ctrl</key><key>;</key></keyseq></p>
          </item>
        </list>
      </item>
      <item>
        <p>Wybranie karty <em>Wtyczki</em></p>
      </item>
    </steps>

    <p>Zaznaczenie wtyczki na liście wyświetli informacje o niej. Zaznaczenie pola obok nazwy wtyczki aktywuje ją, odznaczenie - wyłącza ją.</p>
    <p>Jeżeli wtyczka posiada konfigurowalne parametry, zostaną one wyświetlone poniżej informacji o wtyczce.</p>
    <p>Wtyczka <app>Wtyczki Kupfera</app> 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.</p>
  </section>
  <section>
    <title>Problemy z aktywacją wtyczki</title>
      <p>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:</p>
      <p><em>Plugin could not be read due to an error:</em>
      </p><p><em>Python module 'gdata' is needed</em></p>
      <p>Komunikat taki oznacza, że należy zainstalować wymagany moduł Pythona - prawdopodobnie dokumentacja wtyczki dostarcza więcej informacji jak to zrobić.</p>
      <p>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 <app>Kupferze</app>.</p>
  </section>
  
  <section>
    <title>Instalacja kolejnych wtyczek</title>
    <p>Użytkownik ma możliwość instalacji dodatkowych wtyczek w katalogu <code>~/.local/share/kupfer/plugins</code>. Każda wtyczka jest w postaci pojedynczego pliku <code>.py</code> lub w postaci pakietu Pythona (katalog zawierający przynajmniej plik <code>__init__.py</code>). Wtyczki w postaci pakietów mogą zawierać pliki ikon. Pakiety Pythona mogą być instalowane jako pliki <code>.zip</code>.</p>
    <note style="warning">
    <p><em>Uwaga:</em> Wtyczki są programami komputerowymi. Nie należy instalować wtyczek z niezaufanych źródeł.</p>
    </note>
  </section>

  <section>
    <title>Tworzenie wtyczek</title>
    <p>Dokumentacja dla twórców wtyczek jest dostępna w pliku <code>Documentation/Manual.rst</code> dostarczanym ze źródłami programu na stronie <link href="http://kaizer.se/wiki/kupfer/Manual/">Kupfera</link>. Najprostszą metodą na rozpoczęcie pracy jest skopiowanie istniejącej wtyczki i eksperymentowanie z nią.</p>
  </section>
  <section>
    <title>Karta <em>Katalog</em> w oknie preferencji</title>
    <p>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 <em>Przeszukaj zawartość</em>.</p>
    <p>W karcie <em>Katalog</em> w <app>Preferencjach Kupfera</app> 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.</p>
    <p><em>Uwaga:</em> Kupfer może zachowywać się wolno, jeżeli znacząca ilość podkatalogów jest eksportowana na najwyższy poziom listy.</p>
  </section>
</page>
