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 | edytuj kod]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 | edytuj kod]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 | edytuj kod]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 | edytuj kod]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 | edytuj kod]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 | edytuj kod]Maksymalna liczba artykułów do wyświetlenia na liście.
Należy podać maksymalną liczbę wyświetlanych artykułów.
mode
[edytuj | edytuj kod]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 | edytuj kod]Kolejność sortowania
- ascending - rosnąca
- descending - malejąca (domyślnie)
ordermethod
[edytuj | edytuj kod]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 | edytuj kod]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 | edytuj kod]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 | edytuj kod]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 | edytuj kod]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 | edytuj kod]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 | edytuj kod]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 lip 2024: Ekstraklasa 2024/2025: Pogoń Szczecin 3:0 Korona Kielce
- 22 lip 2024: Ekstraklasa 2024/2025: GKS Katowice 1:2 Radomiak Radom
- 21 lip 2024: Tadej Pogačar zwycięzcą Tour de France 2024
- 20 lip 2024: Ekstraklasa 2024/2025: Śląsk Wrocław 1:1 Lechia Gdańska
- 20 lip 2024: Ekstraklasa 2024/2025: Jagiellonia Białystok 2:0 Puszcza Niepołomice
- 16 lip 2024: Euro 2024: Czechy 1:2 Turcja
- 15 lip 2024: Euro 2024: Gruzja 2:0 Portugalia
- 15 lip 2024: Euro 2024: Ukraina 0:0 Belgia
- 15 lip 2024: Euro 2024: Słowacja 1:1 Rumunia
- 14 lip 2024: Euro 2024: Anglia 0:0 Słowenia
- 14 lip 2024: Copa América 2024: Kanada 2:2 Urugwaj (k. 3:4)
- 13 lip 2024: Euro 2024: Dania 0:0 Serbia
- 12 lip 2024: Euro 2024: Holandia 2:3 Austria
- 12 lip 2024: François Letexier sędzią głównym finału Euro 2024
- 12 lip 2024: Euro 2024: Francja 1:1 Polska
- 11 lip 2024: Copa América 2024: Urugwaj 0:1 Kolumbia
- 10 lip 2024: Copa América 2024: Argentyna 2:0 Kanada
- 10 lip 2024: Copa América 2024: Argentyna 2:0 Kanada (półfinał)
- 8 lip 2024: Euro 2024: Chorwacja 1:1 Włochy
- 8 lip 2024: Euro 2024: Albania 0:1 Hiszpania
Problemy z edytowaniem starszych artykułów
[edytuj | edytuj kod]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 | edytuj kod]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>
- 21 lip 2024: Dwudziesty Quiz na polskim Wikinews
- 17 lip 2024: Kraków kolejnym polskim miastem z nocnym burmistrzem
- 17 lip 2024: MPK Kraków unieważniło przetarg na dostawę 90 nowych tramwajów
- 16 lip 2024: Zmiany cen biletów miesięcznych w komunikacji miejskiej w Krakowie
- 14 lip 2024: W II drugim kwartale 2024 tylko Play zanotował zysk numerów
- 13 lip 2024: Pobicie na terenie Zalewu Zakrzówek w Krakowie
- 12 lip 2024: Wypadek na ulicy Opolskiej w Krakowie
- 11 lip 2024: Protest pod krakowską siedzibą Polskiego Stronnictwa Ludowego
- 11 lip 2024: Prace na parkingu przy Muzeum Narodowym w Krakowie
- 11 lip 2024: Samochód dachował na alei Zygmunta Krasińskiego w Krakowie
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.