Manual:Parameters to index.php/cs

Tato stránka je částečný seznam parametrů u, hlavního skriptu softwaru MediaWiki, který poskytuje samotná MediaWiki. Většina z těchto argumentů se předává přes GET, jako součást URL, ale mohou být odesílané i přes POST. V některých případech je dokonce odeslání přes POST vyžadováno, jako např. u akce purge. S dalšími parametry, které zde nejsou, mohou pracovat některá rozšíření.



Revize stránky nebo verze
Parametry index.php obvykle platí a mají význam související se stránkou, ke které se vztahují. Stránku (nebo její verzi) lze zadat zadáním jednoho nebo více následujících parametrů: https:// en.wikipedia.org/w/index.php? title =Ferengi& curid =177126& diff =304901009& oldid =304764764

Některé akce (například zobrazení a úpravy) fungují také na konkrétní revizi stránky. Taková revize je identifikována dvěma následujícími parametry, což umožňuje vynechání názvu a ID stránky.

Akce
Následuje přehled použitelných hodnot (values) pro parametr  (akce).

Některou z těchto akcí lze povolit nebo zakázat pomocí vyhrazeného nastavení konfigurace v. Tato místní nastavení jsou uvedena, pokud jsou k dispozici.



Přepsání preferencí uživatele
Následující parametry přepíší některé preference uživatele. Další parametry vysvětlené v jiných oddílech jsou "difonly", "internaledit" a "externaledit". Níže uvedené parametry ovlivňují všechny akce kromě "vykreslení" (render) a "nezpracovaného" (raw).



Prohlížení a renderování obsahu
Výchozí akcí je zobrazení. Pokud k adrese URL není přidána žádná jiná akce, použije se. Tato akce zobrazuje stránku, revizi nebo rozdíl mezi dvěma revizemi stejné nebo dvou různých stránek. Níže je uveden (částečný) seznam.


 * diff
 * hodnota tohoto parametru označuje revizi. Vrací se rozdíl mezi jinou revizí a touto revizí:


 * Pokud není předán, zobrazí se rozdíl mezi touto revizí a předchozí verzí téhož článku.
 * Jinak se zobrazí rozdíl mezi revizí danou  a touto revizí. Hodnota tohoto parametru může být ID revize, hodnoty   (předchozí) nebo   (další) k identifikaci revize vzhledem k revizi dané   a hodnotě   k identifikaci nejnovější revize stránky;
 * Všimněte si, že  a   nemusí být dvě revize stejného článku, což umožňuje porovnání dvou revizí dvou různých stránek.


 * redirect
 * pokud je hodnota tohoto parametru 'ne' a stránka je přesměrována, zobrazí se samotná stránka, nikoli cíl přesměrování. Tento parametr má účinek pouze na  a   a pouze pokud není uveden žádný   ani  . Toto je jediný případ, kdy je místo přesměrování zobrazen cílový článek.


 * rdfrom
 * když je stránka následkem přesměrování z externí wiki, tento parametr řekne, která wiki byla původní, takže lze zobrazit řádek "Přesměrováno z ...".


 * diffonly
 * přepíše preference uživatele, zda se má stránka vykreslit, když je požadován rozdíl, např.


 * search
 * pokud není prázdné (a pokud jsou povolena vyhledávání), přepíší se všechny ostatní parametry a provede se vyhledávání.

Následující parametry platí pouze pro kategorie.


 * from
 * je-li stránka kategorií, zobrazí se pouze položky seznamu, jejichž řazení je stejné nebo odpovídá hodnotě tohoto parametru.
 * Příklad: https://en.wikipedia.org/w/index.php?title=Special:Log&type=upload & from =20070814233520&until=20070814233625
 * Odkazy na protokol všech obrázků nahraných 14. srpna 2007 od 23:35:20 do 23:36:25


 * until
 * pokud je stránka kategorií, zobrazí se pouze položky, jejichž předřazený klíč předchází hodnotě tohoto parametru. Používá se pouze pokud není předán.

Následující parametr platí pouze pro obrázky.


 * page
 * číslo stránky na vícestránkovém médiu. V současné době platí pouze pro soubory DjVu a PDF. První stránka je očíslována 1.

Historie

 * limit
 * počet úprav stránek, které lze zobrazit. Maximum je 5 000 úprav.
 * Příklad: https://en.wikipedia.org/w/index.php?title=Special:Contributions &limit=13 &contribs=user&target=Atlgirl052005 - uvádí 13 úprav na stránku.


 * dir
 * relativní pořadí stránek historie úprav.
 * Úpravy stránky jsou seřazeny podle klesající časové značky.


 * offset
 * používá časové razítko k určení, která část historie se zobrazí.
 * Vrátí úpravy, ke kterým došlo před časovou značkou.
 * Příklad: https://en.wikipedia.org/w/index.php?title=Special:Contributions &offset=20090815195334 &contribs=user&target=Atlgirl052005
 * Zobrazuje úpravy, ke kterým došlo bezprostředně před časovou značkou 20090815195334 (20090815195334 není zobrazena).
 * Formát parametrů je rrrrmmddhhmmss. Takže 20090815195334 byl vytvořen 15. srpna 2009 [20090815] v 19:53 (UTC) a 34 sekund [195334].
 * Viz Wikipedia:Kompletní průvodce rozdíly a odkazy.
 * pokud je přidán, funguje to opačně a uvádí všechny úpravy za časovou značkou.
 * Příklad: https://en.wikipedia.org/w/index.php?title=Special:Contributions&offset=20090815195334 &dir=prev &contribs=user&target=Atlgirl052005
 * Zobrazuje úpravy, k nimž došlo okamžitě po časové značce 20090815195334 (20090815195334 není zobrazena).
 * Příklad pro zobrazení pouze první úpravy na stránce: https://en.wikipedia.org/w/index.php?title=Wikipedia:Village_pump_(technical)&action=history& dir=prev &limit=1


 * feed
 * je vrácen zdroj změn v historii. Povolené hodnoty jsou  a  . Lze zakázat pomocí.


 * go
 * (zastaralé - je třeba se mu vyhnout, protože bylo nahrazeno)  je zobrazena první (nejstarší) stránka historie

Raw – neinterpretovaný obsah stránky
Předáním  se vrátí zdrojový kód stránky nebo revize. Z důvodu ukládání do mezipaměti a bezpečnostních důvodů by se toto mělo obecně používat pouze prostřednictvím cesty skriptu, tedy ]]. While "short urls" like  are only meant for action=view, they unofficially tend to work for other actions as well. This is expressly discouraged for action=raw as it leads to less effective caching and bypasses automatic purging after edits.


 * templates
 * pokud je předán s hodnotou, rozbalí se šablony na stránce.


 * ctype
 * hodnota typu obsahu, která se má použít v záhlaví HTTP při vracení nezpracovaného obsahu, místo výchozího . Toto může být pouze jeden z povolených typů, existujících v současné době ,  ,   a.


 * maxage
 * hodnota max-age v poli záhlaví HTTP Cache-Control, která se použije při návratu nezpracované stránky (klientská mezipaměť).


 * smaxage
 * hodnota s-maxage v poli záhlaví HTTP Cache-Control, která se má použít při vrácení nezpracované stránky (mezipaměť serveru cache).


 * oldid
 * ID konkrétní revize, která se má vrátit.


 * direction
 * buď,   nebo  . Namísto revize zadané oldid vrátí jednu, která ji následuje, jednu, která ji předcházela nebo aktuální (poslední).


 * section
 * omezuje výstup na konkrétní část nebo podčásti dokumentu. Sekce jsou specifikovány s nezápornými celými čísly: Sekce 0 je sekce před všemi pojmenovanými sekcemi, sekce jedna je první pojmenovanou sekcí nebo podsekcí atd. Schéma číslování považuje oddíly a podsekce za identické. Seznam sekcí a podsekcí lze získat prostřednictvím API s api.php?action=parse&text={{:My_page}}&#95;&#95;TOC&#95;&#95;&prop=sections.


 * příklad



Editace a odeslání změn k uložení
Příkazy úprav a odesílání provádějí téměř stejnou akci. Ve výchozím nastavení vrátí pro stránku formulář "Upravit stránku" (edit page). Různé výsledky lze získat předáním jiných argumentů.Některé výsledky (například uložení nové verze stránky) lze získat pouze pomocí POST. Tato akce používá standardní argumenty pro určení stránky nebo revize stránky.



Možnosti ovlivňující formulář pro úpravu
Následující možnosti mají vliv na editační formulář. (Poznámka: 'sekce' také ovlivňuje způsob uložení stránky. Navíc 'preload' a 'preloadparams' fungují pouze na wikitext contentmodel)


 * section
 * určuje index sekce v dokumentu, který se má předem načíst a upravit. Sekce jsou číslovány postupně od 0. Sekce 0 je část článku před záhlavím první sekce. Hodnota  se používá k připojení nové sekce k dokumentu.


 * preload
 * určuje stránku, jejíž wikitext se použije jako počáteční hodnota textové oblasti (textarea) v editačním formuláři, pokud neexistuje upravovaná stránka nebo sekce. Pokud existuje, je příkaz preload ignorován. Viz také.
 * Příklad: https://en.wikipedia.org/wiki/Talk:Main_Page?action=edit&section=new&preload=Project:Sandbox


 * preloadparams[] (nebo preloadparams%5B%5D): nahrazení parametrů stylu  v předpřipraveném textu. Například https://mediawiki.org/wiki/Project:Sandbox?action=edit&section=new&preload=Manual:Creating_pages_with_preloaded_text/param_demo&preloadparams%5b%5d=first%20value&preloadparams%5b%5d=second%20value způsobí, že Příručka:Vytváření stránek s předběžným načtením textu nebo param demo bude předběžně načtena do editačního formuláře, ale   bude nahrazen první hodnotou a   bude nahrazen druhou hodnotou.
 * editintro
 * název existujícího článku nebo šablony, který bude zobrazen nad editačním formulářem.


 * preloadtitle
 * v případě section=new poskytuje počáteční obsah pole "Předmět/nadpis" (subject/headline). Před uložením jej lze upravit.
 * Příklad: https://en.wikipedia.org/w/index.php?title=User_talk:5dsddddd&action=edit&section=new&preloadtitle=The+%5B%5BWP%3AARS%7CArticle+Rescue+Squadron%5D%5D
 * Příklad s předběžným názvem a předběžným načtením: https://en.wikipedia.org/wiki/User_Talk:Ikip?action=edit&section=new&preload=Template:Article_Rescue_Squadron_ invite&preloadtitle=Invitation


 * nosummary
 * nezobrazovat pole "titulek" (headline), když děláte novou sekci section=new.


 * summary
 * jeho hodnota se použije jako souhrn úprav namísto výchozí.


 * preview
 * pokud je nastaveno na  nebo , přepíše preferenci uživatele "".


 * internaledit/externaledit : přepíše preference uživatele na externí editory.
 * mode
 * tento parametr ovlivní stránku s výsledky, pokud je předán s hodnotou  a používá externí editor.


 * undo, undoafter
 * pokusí se vrátit zpět řadu úprav, od revize  až po revizi  . Technicky se to provádí pokusem o sloučení inverze těchto úprav se sekvencí všech následných úprav. Hodnoty těchto parametrů jsou IDy starých revizí stránky. Pokud sloučení není možné, je vrácen formulář určený pro tuto revizi.



Co dělat
Následující možnosti sdělují softwaru, co dělat při odesílání: Uložení, zobrazení náhledu nebo zobrazení rozdílu oproti aktuální verzi.


 * wpSave
 * tento argument je generován při ukládání obsahu editačního formuláře vráceného serverem. Ve skutečnosti se nepoužívá ani nevyžaduje při odesílání (požadované argumenty k uložení viz níže).


 * wpPreview
 * nastavení požadavku v POST na vyžádání náhledu stránky nebo sekce, jako by byla uložena hodnota wpTextbox1.


 * Ve výchozím nastavení vrací editační formulář s náhledem hodnoty wpTextbox1.
 * Pokud je předán další argument, zobrazí se pouze vykreslení hodnoty wpTextbox1. Nikoli forma a další prvek GUI. Je to podobné výsledku uložení a následnému prohlížení pomocí  . Viz pro více informací .
 * Argument  je identický s wpPreview. Proto se vrací pravidelný náhled, pokud není předán  .
 * wpDiff
 * nastavení požadavku v POST na vyžádání tabulky ukazující změny mezi aktuální verzí stránky nebo sekce a verzí, jako by byla uložena hodnota wpTextbox1.



Parametry potřebné k uložení
Když uživatel stránku uloží, jsou vyžadovány následující parametry. Pole souhrnu úprav může být také vyžadováno, pokud je nakonfigurováno (viz níže).


 * wpTextbox1
 * nový obsah stránky nebo sekce.


 * wpStarttime
 * časové razítko, kdy uživatel začal upravovat stránku. Slouží ke kontrole, zda byla stránka odstraněna mezi tímto okamžikem a časem odeslání (v tomto případě je uživatel požádán o potvrzení uložení).


 * wpRecreate
 * v případě, že byla stránka po wpStarttime odstraněna, toto pole potvrzuje, že se stránka má uložit.


 * wpEdittime
 * pro nové stránky je to stejné jako wpStarttime. V opačném případě je to časové razítko poslední revize stránky. Slouží ke kontrole konfliktů při úpravách.


 * wpEditToken
 * Uprava tokenu se používá k tomu, aby uživatelé zabránili v naléhání na uložení stránky sledováním odkazu nebo stisknutím tlačítka na externím webu. Pro nepřihlášené uživatele je vyžadováno wpEditToken od rSVN18112. Aktuálně obsahuje pouze znaky , nikoli náhodný řetězec (viz přípona k úpravě tokenu).

Pro uložení stránky jsou v požadavku POST vyžadovány,  ,   a   a   ani   nejsou předány. Pokud byla stránka odstraněna po, je vyžadována také booleovská volba.



Nepovinná dodatečná data
Souhrn úprav nebo parametr "ignorovat prázdné" (ignore blank) může být povinný, pokud je nakonfigurováno "upozornění na prázdné souhrny" (warn on blank summaries).


 * wpSummary
 * shrnutí úprav.


 * wpMinoredit
 * pokud je nastavena v požadavku na uložení, je úprava označena jako malá. Pro náhled a rozdíl je to počáteční hodnota zaškrtávacího políčka "Toto je drobná úprava" (this is a minor edit) ve formuláři úprav.


 * wpWatchthis
 * pokud je předána na žádost o uložení, stránka se přidá do seznamu sledovaných uživatelů. Pokud není předána v požadavku na uložení, bude stránka odebrána ze seznamu sledovaných uživatelů. Pro náhled nebo rozdíl je to počáteční hodnota zaškrtávacího políčka "sledovat tuto stránku" (watch this page) v editačním formuláři.


 * wpSection
 * určuje index sekce v dokumentu, který má být předložen. Sekce jsou číslovány postupně od 0. Sekce 0 je část článku před záhlavím první sekce. Hodnota  se používá k připojení nové sekce k dokumentu.


 * wpChangeTags
 * volitelný seznam tagů oddělených čárkami, který bude přidán do úpravy. Pokud některá z poskytnutých značek není aktivována pro ruční použití, bude úprava odmítnuta.


 * wpAutoSummary
 * obsahuje MD5-hašování pole souhrnu úprav, jak bylo původně prezentováno uživateli ve formě úprav. Toto pole se používá ke kontrole, zda uživatel toto pole před odesláním upravil: Pokud je hašování MD5 hodnoty  stejné jako toto pole, shrnutí úprav nebude změněno.


 * wpIgnoreBlankSummary
 * uloží stránku, i když uživatel neupravil shrnutí úprav, přestože měl.


 * wpTextbox2
 * v případě konfliktu úprav obsahuje hodnotu wpTextbox1 požadavku na uložení, který konflikt vygeneroval.


 * wpScrolltop
 * slouží k zachování pozice posuvníku v textovém poli pro úpravy při načítání náhledu.


 * redlink
 * pokud uživatel nemá oprávnění k úpravě stránky, přesměrujte na prázdnou stránku článku (např. "Wikipedie nemá článek s tímto přesným názvem") namísto zobrazení upozornění o chybě oprávnění. Tento parametr se používá u červených odkazů.


 * wpExtraQueryRedirect
 * skrytý vstup pro úpravu po uložení URL a není použit ve skutečném formuláři úpravy. Určeno k použití miniaplikacemi apod.



Speciální stránky
Většina speciálních stránek má další parametry, specifické pro funkci, kterou vykonávají. Jako příklad lze uvést parametry pro Special:Export ve

Následující parametry adresy URL poskytují počáteční hodnoty pro některá vstupní pole. Mohou být upraveny před odesláním formuláře.

Special:MovePage

 * wpReason
 * textové pole s důvodem.


 * wpNewTitle
 * textové pole s novým názvem.


 * wpLeaveRedirect
 * zda zaškrtnete políčko "Nechat přesměrování na později" (leave a redirect behind).

Special:BlockIP

 * wpDisableEmail
 * zda zaškrtnete políčko "".


 * wpDisableUTEdit
 * zda zaškrtnete políčko "".


 * wpReason
 * původně vybraná položka v rozevíracím seznamu by se hodnota měla shodovat s řádkem v MediaWiki:Ipbreason-dropdown.


 * wpReason-other
 * textová pole s vlastním důvodem. Vyžadují.


 * wpAutoBlock
 * zda zaškrtnete políčko "".


 * wpWatch
 * zda zaškrtnete políčko "".

Special:UserRights

 * user-reason
 * textové pole s důvodem.



Parametr maxlag
 se používá, pouze pokud je software spuštěn v replikovaném databázovém clusteru.

Parametr maxlag umožňuje, aby požadavek nebyl doručen, pokud je velký provoz serveru. Parametr maxlag platí pro všechny akce. Hodnota parametru maxlag je číslo. Čím nižší je tato hodnota, tím nižší je provoz, který způsobí, že požadavek nebude doručen. Nula není povolena.

Poznámky


Související odkazy

 * m:Help:URL
 * Přehled funkcí
 * Snippets/Load JS and CSS by URL (přidá parametry withJS a withCSS, které jsou zpracovány na straně klienta)
 * Přehled funkcí
 * Snippets/Load JS and CSS by URL (přidá parametry withJS a withCSS, které jsou zpracovány na straně klienta)