Pomoc:DynamicPageList

(Przekierowano z Wikinews:DPL)

DynamicPageList służy do generowania automatycznych spisów artykułów należących lub też nienależących do określonych kategorii.

Angielskojęzyczne opisy EN Wikinews, MediaWiki

Kod dostępny jest tu w SVN.

Używanie DynamicPageList

edytuj

Dynamiczna lista stron jest rozszerzeniem MediaWiki. Użycie wymaga wpisania do treści strony tekstu, który przypomina składnię XML:

<DynamicPageList>
...parametry...
</DynamicPageList>

Wynikiem będzie treść przypominająca:

  • [[Strona 1]]
  • [[Strona 2]]
  • ...

Przy pomocy dodawanych różnorodnych opcji można zmodyfikować sposób wyświetlania, zmienić sortowanie itp.

Opcje DynamicPageList

edytuj

Parametry ustawione w kodzie, o których warto wiedzieć:

  • Minimalna liczba kategorii 1
  • Maksymalna liczba kategorii 6
  • Minimalna liczba wyników 1
  • Maksymalna liczba wyników 50
  • Dostępna nieograniczona liczba wyników TAK
  • Dostępna nieograniczona liczba kategorii NIE

category

edytuj

Dodaje kategorię, z której generowana jest lista. Jeśli jest kilka wpisów category to wyświetlone zostaną tylko artykuły, które są we wszystkich wymienionych kategoriach.

Należy w jednej linii podać po category= nazwę jednej kategorii.

Przykład:

<DynamicPageList>
category=Polska
category=2007
</DynamicPageList>

Użycie treści z tego przykładu spowoduje wstawienie na stronę listy artykułów, które należą do obu kategorii zarówno [[Kategoria:Polska]] jak i [[Kategoria:2007]].

Uwaga: Musisz podać co najmniej jedną kategorię. To jest parametr ustawiony w kodzie na wstępie opisany jako Minimalna liczba kategorii.

Możesz użyć tutaj magicznych słów jak na przykład te:

  • {{CURRENTMONTHNAME}} - nazwa aktualnego miesiąca
  • {{CURRENTDAY}} - numer aktualnego dnia w miesiącu
  • {{CURRENTYEAR}} - bieżący rok

notcategory

edytuj

Kategorie zabronione. Jeśli artykuł jest w którejkolwiek z wymienionych kategorii, to nie zostanie wyświetlony.

Należy w jednej linii podać po notcategory= nazwę jednej kategorii.

Przykład:

<DynamicPageList>
category=Europa
notcategory=Polska
</DynamicPageList>

Wstawienie treści z przykładu na stronę spowoduje wyświetlenie artykułów, które są w kategorii Europa, ale nie są w kategorii Polska.

Aby dopisać więcej niż jedną kategorię, należy wymienić je w nowych liniach

Przykład:

<DynamicPageList>
category=Europa
notcategory=Polska
notcategory=Archiwalne
</DynamicPageList>

Wstawienie treści z przykładu na stronę spowoduje wyświetlenie artykułów, które są w kategorii Europa, ale nie są w kategorii Polska ani w kategorii Archiwalne.

namespace

edytuj

Liczba oznacza numer przestrzeni nazw. Domyślnie 0 czyli przestrzeń główna.

Należy podać liczbę oznaczającą przestrzeń nazw. Można też podać nazwę przestrzeni.

Maksymalna liczba artykułów do wyświetlenia na liście.

Należy podać maksymalną liczbę wyświetlanych artykułów.

Sposób wyświetlania:

  • none - tytuły jeden pod drugim w osobnych wierszach
  • ordered - lista numerowana jak z # na początku wiersza
  • unordered - lista nienumerowana jak z * na początku wiersza (domyślnie)

Kolejność sortowania

  • ascending - rosnąca
  • descending - malejąca (domyślnie)

ordermethod

edytuj

Sposób sortowania.

  • lastedit - ze względu na datę i czas ostatniej modyfikacji artykułu
  • categoryadd - ze względu na datę i czas dodania artykułu do kategorii (domyślnie)

redirects

edytuj

Określa czy strony przekierowujące mają być wyświetlone na liście.

  • include - na liście będą zarówno zwykłe artykuły jak i strony przekierowujące
  • only - na liście pojawią się tylko przekierowania
  • exclude - na liście pojawią się wyłącznie artykuły (domyślnie)

suppresserrors

edytuj

Określa czy mają być niewyświetlane błędy.

  • true - błędy nie będą wyświetlane
  • false - błędy zostaną wyświetlone (domyślnie)

addfirstcategorydate

edytuj

Określa czy ma być wyświetlana przed tytułem artykułu data dodania artykułu do pierwszej wymienionej kategorii category=

  • true - data będzie wyświetlona
  • false - data nie zostanie wyświetlona (domyślnie)

shownamespace

edytuj

Określa czy przestrzeń nazw zostanie wyświetlona w tytule artykułu.

  • false - przestrzeń nazw będzie niewidoczna
  • true - przestrzeń nazw będzie widoczna (domyślnie)

Problemy z artykułami, które nie są gotowe

edytuj

Jeżeli artykuł nie jest gotowy, potrzeba jeszcze coś dodać, uzupełnić, poprawić, aby można było go opublikować, wstawiamy do niego szablon {{Tworzone}}, najlepiej w postaci {{Tworzone|co trzeba poprawić}}, dzięki temu do artykułu będzie dodana kategoria Kategoria:Tworzone, a na listach wykorzystujących DPL, gdzie jest ona przy parametrze notcategory (notcategory=Tworzone), artykuł nie pojawi się na takiej liście - m.in. na stronie głównej czy w eksponowanych portalach regionalnych i tematycznych.

Przykład

edytuj

Wstawiając szablon do artykułu o sporcie, który ma wpisaną kategorię Sport, nie pojawi się on zarówno na stronie głównej, jak i w portalu Sport, ponieważ w DPL wykorzystują one parametr 'notcategory=Tworzone'

<DynamicPageList>
category=Sport
notcategory=Tworzone
namespace=0
count=20
addfirstcategorydate=true
</DynamicPageList>


Problemy z edytowaniem starszych artykułów

edytuj

Jeżeli edytuje się starsze artykuły, gdy dodaje się do nich kategorie obecne w DPL lub sekcję z kategoriami, gdzie te z DPL są wpisane, wówczas takie artykuły lądują na liście jako najnowsze. Można ten problem rozwiązać, poprzez wstawienie do DPL "notcategory=Archiwalne" i dodanie do artykułu także Kategoria:Archiwalne. Wówczas na liście ten stary artykuł, ale obecnie edytowany nie wyląduje.

Przykład

edytuj

na stronie głównej w szablonie: {{Wiadomości tematycznie}} do DPL został dodany parametr 'notcategory=Archiwalne' np. w sekcji

<DynamicPageList>
category=Polska
notcategory=Tworzone
notcategory=Archiwalne
notcategory=Polityka
namespace=0
count=10
suppresserrors=true
addfirstcategorydate=true
</DynamicPageList>


Dzięki temu starsze artykuły, w których dodana była kategoria Polska, jeśli dodamy kategorię Kategoria:Archiwalne, one nie wylądują jako nowe w tym szablonie, a przez to nie będą jako nowe na stronie głównej.