...
- Prezentacje JPG - jeśli wybrano folder zawierający pliki .jpg, ta wtyczka pozwala na zdefiniowanie kolejności obrazków i przypisanie opisu do każdego obrazka. Informacje te są zapisywane w pliku PresentationData.xml, który jest oznaczany jako plik główny (
).dlproj os 1 dlibra-app-extension-fh-jpg os
Rozszerzenie tool
Opis ogólny
To rozszerzenie pozwala dodać nowe elementy do menu Narzędzia w aplikacji administratora lub redaktora, jak pokazano na poniższym rysunku.
Rozszerzenie to przyjmuje jeden parametr dwa parametry:
...
- class, który specyfikuje nazwę klasy implementującej interfejs programistyczny rozszerzenia. Interfejs programistyczny (język Java) dla tego rozszerzenia to
...
...
- . Szczegółowe informacje związane z tym interfejsem znajdują się w komentarzach metod i samego interfejsu (JavaDocs).
- type, który określa przeznaczenie narzędzia, tj. czy jest to narzędzie aplikacji administratora czy aplikacji redaktora. W związku z tym parametr ten może przyjąć tylko dwie wartości: ADMIN (określający aplikację administratora) oraz EDITOR (określający aplikację redaktora). W efekcie określenie parametru sprawi, że narzędzie będzie wyświetlane w menu „Narzędzia” w aplikacji administratora, bądź aplikacji redaktora.
Lista domyślnie zainstalowanych rozszerzeń tego typu jest następująca:
- Lista publikacji w publikacji grupowej - zapisuje publikacje należące do wybranej publikacji grupowej w pliku html (
dlproj os 1 dlibra-app-extension-tl-leafslistos ). - Narzędzie do czyszczenia słownika atrybutu - pozwala usunąć ze słownika wartości, które nie są przypisane do żadnej publikacji. To rozszerzenie jest zintegrowane bezpośrednio z aplikacją administratora - nie jest zdefiniowane w odrębnym projekcie.
Przykładowe rozszerzenie tool
Instalacja
Narzędzie ilustrujące możliwości rozszerzeń typu tool zostało przygotowane przez zespół rozwijający system dLibra i jest dostępne do pobrania tutaj.
Aby zainstalować wtyczkę w systemie dLibra należy skopiować plik .jar wtyczki do katalogu /WEB-INF/jnlp-jars aplikacji czytelnika i uruchomić w panelu administracyjnym proces uaktualnienia aplikacji redaktora/administratora. Więcej na temat panelu administracyjnego aplikacji czytelnika można dowiedzieć się tutaj.
Funkcjonalność
Rozszerzenie realizuje następujące funkcje:
- odczytuje zaznaczone obiekty cyfrowe w ramach listy elementów aplikacji redaktora i wyświetla je na panelu rozszerzenia (panel „Tabela wyników selekcji” – patrz rysunek poniżej)
- umożliwia wybieranie obiektów na liście elementów aplikacji redaktora, poprzez wskazanie obiektu do zaznaczenia na panelu rozszerzenia (panel „Tabela selekcji” – patrz rysunek poniżej).
Okno rozszerzenia zawiera dwie tabele:
- Aktualnie zaznaczone publikacje na liście elementów AR
- Publikacje zaznaczone na liście elementów AR przy uruchomieniu narzędzia
Pierwsza tabela wyświetla podstawowe informacje na temat aktualnie zaznaczonych publikacji na liście elementów aplikacji redaktora. Zmiana zaznaczonych publikacji na liście elementów aplikacji redaktora powoduje zmianę wyświetlanych informacji w tej tabeli.
Tabela druga wyświetla podstawowe informacje na temat publikacji zaznaczonych w momencie uruchamiania rozszerzenia. Oznacza to, że zmiana zaznaczenia po uruchomieniu rozszerzenia nie wpływa na listę wyświetlonych publikacji w ramach tej tabeli. Tabela druga ma dodatkową właściwość, mianowicie zaznaczenie na niej publikacji przekłada się na zaznaczenie tej publikacji na liście elementów aplikacji redaktora. Jeśli przed uruchomieniem rozszerzenia z menu „Narzędzia” nie był zaznaczony żaden element na liście elementów aplikacji redaktora, wówczas druga tabela będzie pusta. Warto zaznaczyć, iż zmiana zaznaczenia na tabeli drugiej w sposób pośredni zmienia listę publikacji umieszczonych w tabeli pierwszej. To dlatego, iż zaznaczenia w tabeli drugiej wpływają na zaznaczenia na liście elementów aplikacji redaktora. Z kolei zaznaczenia na liście elementów aplikacji redaktora odzwierciedlane są na bieżąco w tabeli pierwszej.
Kod źródłowy wtyczki oraz jego pełną dokumentację techniczną można znaleźć tutaj.
Rozszerzenie miniatureProvider
...