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

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

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

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

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

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

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

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

mode

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

Kolejność sortowania

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

ordermethod

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

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

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

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

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

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

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>

• 24 gru 2011: Piłka nożna: wygrana Borussii Dortmund z SC Freiburg, 2 gole Lewandowskiego
• 24 gru 2011: W pierwszym konkursie skoków narciarskich zwyciężył Bardal, Stoch 12.
• 24 gru 2011: EURO 2012: do końca lutego trwa druga faza sprzedaży biletów
• 24 gru 2011: Polak pobił rekord świata w nurkowaniu z zamkniętym obiegiem
• 24 gru 2011: Polscy siatkarze wygrali z reprezentacją USA 3:0
• 24 gru 2011: Tour of South Africa anulowany po pierwszej edycji
• 24 gru 2011: Formuła 1: Grand Prix Indii 2011
• 24 gru 2011: Sebastian Vettel wystartuje z pierwszego pola do Grand Prix Indii Formuły 1
• 24 gru 2011: MotoGP: Marco Simoncelli zginął w czasie wyścigu na torze Sepang
• 24 gru 2011: Lewis Hamilton wystartuje z pierwszego pola do Grand Prix Korei Południowej Formuły 1
• 24 gru 2011: Piłka nożna: reprezentacja Polski pokonała Białoruś
• 24 gru 2011: Ekstraklasa: Porażka Lecha z Wisłą
• 24 gru 2011: Ranking FIFA: Holandia liderem, awans Polski
• 24 gru 2011: Koszykówka: Michał Ignerski podpisał kontrakt z klubem BK Niżny Nowogród
• 24 gru 2011: Tenis ziemny: Radwańska zwycięża w turnieju w Carlsbad
• 24 gru 2011: Zwycięstwo Petera Sagana w Tour de Pologne
• 24 gru 2011: Tenis: Đoković wygrał Wimbledon
• 24 gru 2011: Piłka nożna: w sobotę nowi zawodnicy Sandecji powinni podpisać kontrakty
• 24 gru 2011: Łódź: pierwsza edycja wyścigu par rowerowych
• 24 gru 2011: Konferencja dotycząca wyścigu Maja Włoszczowska MTB Race

Problemy z edytowaniem starszych artykułów

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

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>

• 24 gru 2011: Zmarł reżyser "07 zgłoś się"
• 24 gru 2011: Kąpieliska w Bytomiu zamknięte, w najbliższych miesiącach nie będą otwarte
• 24 gru 2011: Bytom: trwa wyburzanie budynków w Karbiu
• 24 gru 2011: GUS: przybyło kobiet i osób wykształconych – wyniki wstępne Narodowego Spisu Powszechnego
• 24 gru 2011: Ministrowie zdrowia Polski i Niemiec podpisali umowę o współpracy transgranicznej w ratownictwie medycznym
• 24 gru 2011: Spotkanie premiera z Czesławem Doleckim, mieszkańcem Giszowca
• 24 gru 2011: "Kilka dni układam sobie w głowie, co chcę przekazać" – wywiad z dziennikarką obywatelską Mariolą Morcinkovą
• 24 gru 2011: Bytom posiada własną kolędę
• 24 gru 2011: Obowiązują nowe zasady kredytu konsumenckiego
• 24 gru 2011: Bytom: przygotowywany jest budżet na 2012 rok

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.