Pomoc:DynamicPageList

Z Wikinews, wolnego źródła informacji.
Przejdź do nawigacji Przejdź do wyszukiwania

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.

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 <nowik>{{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=190886”