Wikinews

Pomoc:DynamicPageList

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.

count

edytuj

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

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

mode

edytuj

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)

order

edytuj

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.

Źródło: „https://pl.wikinews.org/w/index.php?title=Pomoc:DynamicPageList&oldid=241763”