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
The following options tell the software what to do when submitting: saving, showing a preview, or showing the difference with the current version.


 * wpSave
 * this argument is generated when saving the content of an edit form returned by the server, but is not actually used nor required when submitting (see below for required arguments to save);


 * wpPreview
 * set in a POST request to request a preview of the page or section as if the value of wpTextbox1 were saved;


 * by default, returns an edit form with a preview of the value of wpTextbox1;
 * if the additional  argument is passed, only the rendering of the value of wpTextbox1 is shown, not the form and the other GUI element; this is similar to the result of saving and then viewing with  ; see  Manual:Live preview for more info;
 * the argument  is identical to wpPreview; therefore, a regular preview is returned if   is not passed;
 * wpDiff
 * set in a POST request to request a table showing the changes between the current version of the page or section and the version as if value of wpTextbox1 were saved;

Parameters that are needed to save
The following parameters are required when a user saves a page. The edit summary field may also be required if so configured (see below).


 * wpTextbox1
 * the new page/section content;


 * wpStarttime
 * the timestamp of when the user started editing the page; used to check whether the page has been deleted between this moment and the submission time (in this case, the user is asked to confirm saving);


 * wpRecreate
 * in case the page was deleted after wpStarttime, this field confirms that the page is to be saved;


 * wpEdittime
 * for new pages, it is equal to wpStarttime; otherwise, it is the timestamp of the last revision of the page; used to check edit conflicts;


 * wpEditToken
 * an edit token; this is used to avoid users from being tricked into saving a page by following a link or pressing a button in an external site. For non-logged-in users, wpEditToken is required since revision 18112; it currently contains only the characters  rather than a random string (see edit token suffix).

For the page to be saved,,  ,   and   are required in a POST request, and neither   nor   are passed. If the page was deleted after, the boolean option   is also required.

Optional additional data
The edit summary or the "ignore blank" parameter may be mandatory if "warn on blank summaries" is configured.


 * wpSummary
 * the edit summary;


 * wpMinoredit
 * if set in a save request, the edit is marked as minor; for preview and diff, it is the initial value of "this is a minor edit" checkbox in the edit form;


 * wpWatchthis
 * if passed on a save request, the page is added to the user's watchlist; if it is not passed in a save request, the page is removed from the user's watchlist; for preview or diff, this is the initial value of the "watch this page" checkbox of the edit form;


 * 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)