Manual:Parameters to index.php/cs

Tato stránka je částečný seznam parametrů u, hlavního skriptu softwaru MediaWiki. Většina z těchto argumentů se obvykle uvádí jako parametry GET v adrese URL, ale lze je také předávat jako data POST. POST je ve skutečnosti vyžadován v některých případech, jako je například čistící akce.

Revize stránky nebo verze
Parametry index.php obvykle platí a mají význam související se stránkou, na kterou 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 / 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é uživatele preferencí. 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í“ a „nezpracovaného“.

Prohlížení a renderování obsahu
Výchozí akce 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 hodnotu   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 povoleny vyhledávání), přepíší všechny ostatní parametry a provede 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=20070814233525
 * 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ílem 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  vrátí zdrojový kód stránky nebo revize. Z bezpečnostních důvodů je to v některých verzích MediaWiki povoleno pouze při použití "přístupového bodu primárního skriptu", tj. Při použití "ošklivého" URL formuláře s


 * 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ů, které existují 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=&#123;&#123;:My_page&#125;&#125;&#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ář (první také ovlivňuje způsob uložení stránky).


 * 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říručka: Vytváření stránek s předinstalovaným textem;
 * 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 / 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“, 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 pravidelný formulář 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
 * nastavit v POST požadavku 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ého prohlížení pomocí  ; viz Příručka: Živý náhled pro více informací;
 * argument  je identický s wpPreview; proto se vrací pravidelný náhled, pokud není předán  ;
 * wpDiff
 * nastavit v POST požadavku 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 / 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
 * Upravit token 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 revision 18112. 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é“ může být povinný, pokud je nakonfigurováno „upozornění na prázdné souhrny“.


 * wpSummary
 * shrnutí úprav;


 * wpMinoredit
 * pokud je nastavena v požadavku na uložení, je úprava označena jako menší. Pro náhled a rozdíl je to počáteční hodnota zaškrtávacího políčka „Toto je drobná úprava“ ve formuláři úpravy;


 * 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án 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“ v editačním formuláři;


 * wpSection
 * specify the index of a section within a document to submit to; sections are numbered sequentially from 0 on; section 0 is the part of the article before the first section header; value  is used to append a new section to the document;


 * wpChangeTags
 * an optional comma-separated list of tags to be added to the edit. If any of the provided tags are not activated for manual use, the edit will be rejected.


 * wpAutoSummary
 * contains the MD5-hashing of the edit summary field as initially presented to the user in the edit form; this field is used to check if the user has modified that field before submitting: if the MD5 hashing of the value of  is the same as this field, the edit summary has not been modified;


 * wpIgnoreBlankSummary
 * save page even if user has not modified the edit summary, while they were supposed to;


 * wpTextbox2
 * in case of an edit conflict, it contains the value of wpTextbox1 of the save request that generated the conflict;


 * safemode
 * some browsers are known to have problems with editing text containing Unicode characters; when a request for an edit form come from one such browser, the non-ascii characters in the initial content of the textarea are converted into the form  and the value   is hidden in the form; when submitting, the   field indicate that the the inverse translation is to be performed; a browser is considered non-Unicode-compliant if the User-Agent HTTP header matches a regular expressions in the variable ;


 * wpScrolltop
 * used to preserve the scrollbar position in the edit textbox when loading a preview.


 * redlink
 * if the user does not have permission to edit the page, redirect to the empty article page (e.g., "Wikipedia does not have an article with this exact name") instead of showing the permission error notice; this parameter is used on red links.


 * wpExtraQueryRedirect
 * hidden input to modify after save URL and is not used by actual edit form. Intended to be used by gadgets and such.

Speciální stránky
Most special pages have additional parameters, specific to the function they perform. As an example, the parameters for Special:Export are outlined in

The following URL parameters provide initial values for some input fields; they can be edited before submitting the form.

Special:MovePage

 * wpReason
 * text field with reason.


 * wpNewTitle
 * text field with new title.


 * wpLeaveRedirect
 * whether to select the "Leave a redirect behind" checkbox.

Special:BlockIP

 * wpDisableEmail
 * whether to select the "" checkbox.


 * wpDisableUTEdit
 * whether to select the "" checkbox.


 * wpReason
 * initially selected item in the drop-down box, value should match a row in the MediaWiki:Ipbreason-dropdown.


 * wpReason-other
 * text field with custom reason; require


 * wpAutoBlock
 * whether to select the "" checkbox.


 * wpWatch
 * whether to select the "" checkbox.

Special:UserRights

 * user-reason
 * text field with reason.

extension

 * stable
 * if set to, last stable version is shown.


 * stableid
 * like oldid except with stable image/template inclusion. Setting  will give the best version (pristine > quality > sighted > last).


 * filetimestamp
 * view the file version created at a certain date (applies only to viewing file pages)

Userscript parameters and Autoedit extension
Userspace JavaScript scripts and gadgets may interpret arbitrary parameters passed via GET or POST. If the user's or global JavaScript script include Lupin's Autoedit Script, the following parameters are used for automated editing: autoedit, autosummary, autoclick, and autominor. Some more details are given in Autoedit extension.

Parametr maxlag
The  is used only if the software is running on a replicated database cluster.

The maxlag parameter makes it so a request is not served if there is high server traffic. maxlag parameter applies to all actions. maxlag parameter value is a number; the lower this value, the lower the traffic that causes the request not to be served. Zero is not allowed.

Viz též

 * m:Help:URL
 * Přehled funkcí
 * Snippets/Load JS and CSS by URL (adds withJS and withCSS parameters which are processed on the client side)
 * Přehled funkcí
 * Snippets/Load JS and CSS by URL (adds withJS and withCSS parameters which are processed on the client side)