Sposób działania rozszerzenia
To rozszerzenie pozwala na wygenerowanie pliku html zawierającego listę publikacji należących do wybranej publikacji grupowej. Lista ta nie zawiera innych publikacji grupowych, ale uwzględnia ewentualne publikacje zgrupowane w innych publikacjach (również publikacje zagnieżdżone wielokrotnie).
Po wybraniu polecenia z menu Narzędzia w aplikacji administratora, pojawia się okno dialogowe (zobacz rysunek poniżej), w które należy wpisać identyfikator publikacji grupowej. W kolejnym oknie należy wskazać plik, do którego ma zostać zapisana wygenerowana lista. Jeśli operacja zostanie przeprowadzona poprawnie, pojawi się komunikat o zapisaniu listy.
Konfiguracja rozszerzenia
W celu zmiany ustawień wtyczki, należy w aplikacji redaktora wybrać z menu Program pozycję Konfiguracja, po czym w zakładce Konfiguracja rozszerzeń wybrać wtyczkę (Lista publikacji w publikacji grupowej) i kliknąć przycisk Konfiguruj. Pojawi się standardowe okno konfiguracji rozszerzenia, w którym można wprowadzić katalog na dysku lub adres www, skąd ma być pobrany plik konfiguracyjny. Jak zwykle, należy pamiętać o zaznaczeniu opcji Używaj konfiguracji z podanego źródła.
Plik wymagany przez generator listy publikacji ma nazwę index.vm
i jest to szablon pliku HTML, który ma zostać wygenerowany. Szablon jest zapisany w formacie Apache Velocity. Więcej informacji na temat tej technologii znajduje się tutaj. Poniżej przedstawiono budowę szablonu wykorzystywanego w domyślnym ustawieniu.
Jak pokazuje przykład, w szablonie można korzystać ze zmiennej $pubs, która jest listą obiektów opisujących publikacje należące do wybranej publikacji grupowej. Obiekty te udostępniają następujące metody:
getId()
zwraca identyfikator publikacjigetLabel()
zwraca nazwę publikacji (widoczną w aplikacji redaktora, niezwiązaną bezpośrednio z wartościami widocznymi dla czytelnika)