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í
The edit and submit actions perform almost the same action. By default, they return an "edit page" form for the page. Different results can be obtained by passing other arguments; some results (such as saving the new version of a page) can only be obtained using POST. This action takes the standard arguments for specifying a page or a page revision.

Options affecting the edit form
The following options produce an effect on the edit form (the first one also affects how the page is saved).


 * section
 * specifies the index of a section within a document to preload and edit; 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;


 * preload
 * specifies a page, of which the wikitext is used as the initial value of the textarea in the edit form if the page or section to be edited does not exist; if it exists the preload command is ignored; also see Manual:Creating pages with preloaded text;
 * Example: https://en.wikipedia.org/wiki/Talk:Main_Page?action=edit&section=new&preload=Project:Sandbox


 * preloadparams[] (or preloadparams%5B%5D): Replace  style parameters in preload text. For example 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 would cause Manual:Creating pages with_preloaded text/param demo to be preloaded into the edit form, but with   replaced by first value and   replaced by second value.
 * editintro
 * title of an existing article or template to be rendered above the edit form;


 * preloadtitle
 * in the case of section=new, provides initial content of the "Subject/headline" box; it can be edited before saving;
 * 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
 * Example with both preloadtitle and preload: https://en.wikipedia.org/wiki/User_Talk:Ikip?action=edit&section=new&preload=Template:Article_Rescue_Squadron_ invite&preloadtitle=Invitation


 * nosummary
 * Do not show the "headline" box when doing section=new.


 * summary
 * its value is used as the edit summary in place of the default one.


 * preview
 * if set to  or , overrides user preference "" ;


 * internaledit/externaledit : overrides user preference on external editors;
 * mode
 * this parameter affects the result page if passed with value  and using an external editor;


 * undo, undoafter
 * attempts to undo a sequence of edits, from the  revision up to the   revision; technically, this is done by trying to merge the inverse of these edits with the sequence of all subsequent edits; the values of these parameters are ids of old revisions of a page; if merge is not possible, a regular edit form for that revision is returned

What to do
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)