Manual: Parâmetros para index.php
Esta página é uma lista parcial dos parâmetros de index.php, o comando principal do programa MediaWiki, fornecido pelo próprio MediaWiki. A maioria destes argumentos são geralmente dados como parâmetros GET no URL, mas também podem ser passados como dados POST. POST é atualmente necessário em alguns casos, como a ação de purgar. Algumas extensões fornecem parâmetros adicionais.
Revisão de página ou versão
Parameters to index.php usually apply and have a meaning related to the page they apply to. The page (or a version of it) can be specified by typing one or more of the following parameters: https://en.wikipedia.org/w/index.php?title=Ferengi&curid=177126&diff=304901009&oldid=304764764
| Nome | Descrição |
|---|---|
| title | O título da página. It can be a wiki page or a special page, depending on the other parameters. To disable a special page in your wiki configuration, you can use the SpecialPage_initList hook. |
| curid | The ID of the wiki page; overrides the value of title. |
Some actions (such as view and edit) also work on a particular revision of a page. Such a revision is identified by the following two parameters, allowing the omission of the title and the ID of the page.
| Nome | Descrição |
|---|---|
| oldid | A id. de uma revisão |
| direction | Em vez da revisão indicada por oldid, utilizar:
|
Ações
The following is a list of values for the action parameter.
Some of these actions can be enabled/disabled by using a dedicated configuration setting in LocalSettings.php. Where available, these local settings are listed.[2]
| Nome | Função | Exemplo |
|---|---|---|
| view | View is the default action; view is the one action that is used when no action is explicitly given | www.mediawiki.org/w/index.php?title=Project:Sandbox&action=view |
| watch | Adiciona a página à lista de vigias do utilizador | www.mediawiki.org/w/index.php?title=Project:Sandbox&action=watch |
| unwatch | Remove a página da lista de vigias do utilizador | www.mediawiki.org/w/index.php?title=Project:Sandbox&action=unwatch |
| delete | Elimina uma página
By default, delete returns a form for the user to confirm deletion and specify a reason.[3] |
www.mediawiki.org/w/index.php?title=Project:Sandbox&action=delete |
| revert | Reverts to a previous version of an image. The following two other parameters are required:
|
|
| rollback | Rollbacks the last edits made by the last editor of the page; in other words, it restores the last version of the article whose editor is not the last one. The edit is marked as minor and a default edit summary is used.[4]
The following two other parameters are required:
|
www.mediawiki.org/w/index.php?title=Project:Sandbox&action=rollback&from=John&token=d7aaa6c\ |
| protect | Mostra ou altera os níveis de proteção de uma página:
|
www.mediawiki.org/w/index.php?title=Project:Sandbox&action=protect |
| unprotect | Same page as protect (unprotect and protect are the same page, and do the same thing). | www.mediawiki.org/w/index.php?title=Project:Sandbox&action=unprotect |
| markpatrolled | Marks an edit as patrolled; see Help:Patrolled edit.
|
|
| render | Outputs the HTML rendering of the entire page content; similar to the view action, but only the unstyled article text is output, not any part of the user interface (additional toolboxes, search box, stylesheets, etc.). For more stable programmatic access or to retrieve the HTML of only a piece of page content, you should use the
parse API with page or pageid parameters. |
www.mediawiki.org/w/index.php?title=Project:Sandbox&action=render |
| purge | Clears the page's cache, forcing the page to be redisplayed from its source.
|
www.mediawiki.org/w/index.php?title=Project:Sandbox&action=purge |
| edit | Mostra o editor para a página.
O editor mostrado depende das preferências do utilizador. See Editor. |
www.mediawiki.org/w/index.php?title=Project:Sandbox&action=edit |
| submit | When viewed directly (HTTP GET), shows the editor, like "edit".
When viewing by submitting a form (HTTP POST), performs various actions related to changing the page (see #What to do below for more details):
|
www.mediawiki.org/w/index.php?title=Project:Sandbox&action=submit |
| editredlink | O mesmo que edit.[6] | www.mediawiki.org/w/index.php?title=Project:Sandbox&action=editredlink |
| history | Mostra o histórico da página. (Veja o histórico, em baixo) | www.mediawiki.org/w/index.php?title=Project:Sandbox&action=history |
| historysubmit | When viewing the difference between revisions, after clicking "compare selected revisions" on the history page. This requires a "diff" and/or "oldid" parameter, otherwise it just shows the page itself. | www.mediawiki.org/w/index.php?title=Project:Sandbox&action=historysubmit&diff=456290&oldid=456270 |
| raw | Shows the raw content of the page. (See Raw, below) A pop up window will open up, asking whether you would like to save the page in index.php.[7] | www.mediawiki.org/w/index.php?title=Project:Sandbox&action=raw |
| credits | Shows a list of people who contributed to the page in question using the real name specified in the user's preferences. Currently disabled on Wikimedia wikis, but is enabled by default on vanilla MediaWiki. | translatewiki.net/w/i.php?title=Translating:MediaWiki&action=credits |
| info | Shows information about the page, such as the number of users having it in their watchlist, the number of edits, the number of authors. See the Reimplement info action RfC for context. | www.mediawiki.org/w/index.php?title=Project:Sandbox&action=info |
| revisiondelete | Set visibility restrictions on revision text, edit summary, and editor's username/IP address (requires deleterevision user right) |
Substituição da preferência do utilizador
Os parâmetros seguintes substituem algumas das preferências do utilizador. Outros parâmetros explicados noutras secções são "diffonly", "internaledit" e "externaledit". Os parâmetros em baixo afetam todas as ações, exceto "render" e "raw".
| Nome | Função | Exemplo |
|---|---|---|
| useskin | Especificar um tema | www.mediawiki.org/w/index.php?useskin=modern |
| uselang | Specify a language for the UI elements (such as the "my talk" link, etc.), i.e. the user interface language; this is especially useful for creating an account, because at that stage no preference settings apply.
The special language code " |
www.mediawiki.org/w/index.php?title=Special:Userlogin&type=signup&uselang=de |
| variant | Specify a language variant for the UI elements (this is used for example in the Chinese Wikipedia, as the Chinese language has variants); | |
| printable | (deprecated in 1.35) When set to yes, the page is shown in a form that is suitable for printing.
|
|
| debug | When set to true (e.g. 1 or true), the ResourceLoader serves non-minified JavaScript and CSS. "Consulte ResourceLoader/Features#Debug mode."
|
www.mediawiki.org/w/index.php?title=Project:Sandbox&debug=true |
| safemode | When enabled (e.g. set to 1 or true), user-provided CSS and JS will not be loaded. This disables personal scripts and styles (e.g. "User:" common.js and css), and site-wide scripts and styles (e.g. "MediaWiki:Common.js" and "MediaWiki:Common.css"), and all gadgets.[8] It is possible to mark site-wide styles ("MediaWiki:Common.css") as safe via $wgAllowSiteCSSOnRestrictedPages, which permits them in safemode.
|
www.mediawiki.org/w/index.php?title=MediaWiki&safemode=1 |
| useskinversion | Especificar uma versão do tema[9] | www.mediawiki.org/w/index.php?title=MediaWiki&useskinversion=2 |
| vectornightmode | When set to 1, the page is shown in dark mode on skins like Vector 2022 that support dark mode. | www.mediawiki.org/w/index.php?title=MediaWiki&useskin=vector-2022&vectornightmode=1 |
Ver e renderizar
View is the default action. If no other action is added to the URL, action=view is used. This action shows a page, a revision, or the difference between two revisions of the same or two different pages. Below is a (partial) list.
- diff
- the value of this parameter identifies a revision; the difference between another revision and this one is returned:
- if
oldidis not passed, the difference between this revision and the previous one on the same article is shown; - otherwise, the difference between the revision given by
oldid/directionand this one is shown; the value of this parameter can be a revision ID, the valuesprevornextto identify a revision relative to the one given byoldid/direction, and the valuecurto identify the latest revision of the page;
- if
- Note that
oldidanddiffneed not be two revisions of the same article, allowing two revisions of two different pages to be compared - redirect
- if the value of this parameter is 'no' and the page is a redirect, the page itself is shown and not the target of the redirect; this parameter has effect only on
action=viewandaction=renderand only if neitheroldidnordiffis given, as this is the only case where the target article is shown instead of the redirect; - rdfrom
- when the page is the result of following a redirect from an external wiki, this parameter tells which wiki that was, so that the "Redirected from ..." line can be shown
- diffonly
- override the user's preference on whether to render the page when a diff is requested, eg.
diffonly=yes - search
- if non-blank (and if searches are enabled), override all other parameters and perform a search
The following parameters apply only to categories.
- from
- if the page is a category, only list entries whose sortkey are equal or follows the value of this parameter;
- Exemplo: https://en.wikipedia.org/w/index.php?title=Special:Log&type=upload&from=20070814233520&until=20070814233625
- Links to a log of all the images uploaded on August 14, 2007 from 23:35:20 until 23:36:25
- until
- if the page is a category, only list entries whose sortkey precedes the value of this parameter; only used if
fromis not passed;
The following parameter apply only to images.
- page
- a page number in a multi-page media; it currently only applies to DjVu and PDF files; first page is numbered 1;
Histórico
- limit
- O número de edições de página a listar, o máximo é 5.000 edições.
- Exemplo: https://en.wikipedia.org/w/index.php?title=Special:Contributions&limit=13&contribs=user&target=Atlgirl052005 - lista 13 edições por página.
- dir
- a ordem relativa das páginas do histórico de edição.
- as edições de página são ordenadas por data/hora decrescente.
- offset
- utiliza uma data/hora para especificar qual a parte do histórico que é exibida;
- Devolve as edições que ocorreram antes da data/hora;
- Exemplo: https://en.wikipedia.org/w/index.php?title=Special:Contributions&offset=20090815195334&contribs=user&target=Atlgirl052005
- Shows the edits which occurred immediately before the timestamp 20090815195334 (20090815195334 is not shown).
- O formato do parâmetro é yyyymmddhhmmss. Assim, 20090815195334 foi criado em 15 de agosto de 2009 [20090815] às 19:53 (UTC) e 34 segundos [195334].
- Consulte Wikipedia:Complete diff and link guide.
- Exemplo: https://en.wikipedia.org/w/index.php?title=Special:Contributions&offset=20090815195334&contribs=user&target=Atlgirl052005
- if
dir=previs added, it works the other way around, listing all edits after the timestamp[10]- Exemplo: https://en.wikipedia.org/w/index.php?title=Special:Contributions&offset=20090815195334&dir=prev&contribs=user&target=Atlgirl052005
- Shows the edits which occurred immediately after the timestamp 20090815195334 (20090815195334 is not shown).
- Example to show only the very first edit on a page: https://en.wikipedia.org/w/index.php?title=Wikipedia:Village_pump_(technical)&action=history&dir=prev&limit=1
- Exemplo: https://en.wikipedia.org/w/index.php?title=Special:Contributions&offset=20090815195334&dir=prev&contribs=user&target=Atlgirl052005
- feed
- a feed for the changes in the history is returned; allowed values are
atomandrss. Can be disabled with $wgFeed. - go
- (deprecated - should be avoided, because it has been superseded)
go=firstthe first (earliest) page of history is shown
Raw
Passing action=raw returns the source code of a page or revision. For caching and security reasons, this should generally only be used via the script path, that is, index.php?title=....
While "short urls" like /wiki/ 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
- if passed with value
expand, templates within the page are expanded; - ctype
- the content-type value to be used in the HTTP header when returning the raw content, instead of the default
text/x-wiki; this can only be one of the allowed types, which currently aretext/x-wiki,text/javascript,text/css, andapplication/x-zope-edit - oldid
- the ID of a specific revision to return
- direction
- either
next,prev, orcur; instead of the revision specified by oldid, returns the one following it, the one preceding it, or the current (last) one; - section
- Limits output to a particular section or subsections of the document. Sections are specified with non-negative integers : section 0 being the section before any named sections, section one being the first named section or subsection and so on. The numbering scheme treats sections and subsections as identical. A list of the sections and subsections can be obtained via API with api.php?action=parse&text={{:My_page}}__TOC__&prop=sections.
Editar e submeter
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.
Opções que afetam a forma de edição
The following options produce an effect on the edit form. (Note: 'section' also affects how the page is saved. Additionally, 'preload' and 'preloadparams' only work on wikitext contentmodel)
- 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
newis 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: Criar páginas com texto pré-carregado;
- preloadparams[] (or preloadparams%5B%5D):
- Replace
$1style parameters in preload text. - For example https://mediawiki.org/wiki/Project:Sandbox?action=edit§ion=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
$1replaced by first value and$2replaced by second value. (introduzido(a) na 1.23)- The only way to set a default value for
$1style parameters is with<includeonly>{{SUBST:#ifeq:$1|$1|default value|$1}}</includeonly>
- The only way to set a default value for
- 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;
- Exemplo: https://en.wikipedia.org/w/index.php?title=User_talk:5dsddddd&action=edit§ion=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§ion=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
yesorno, overrides user preference "Mostrar a antevisão ao começar a editar(T11936); - internaledit/externaledit (removed in 1.22)
- overrides user preference on external editors;
- mode (removed in 1.22)
- this parameter affects the result page if passed with value
fileand using an external editor; - undo, undoafter
- attempts to undo a sequence of edits, from the
undoafterrevision up to theundorevision; 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
O que fazer
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
liveargument 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 withaction=render; see Manual:Live preview for more info; - the argument
wpLivePreviewis identical to wpPreview; therefore, a regular preview is returned ifliveis 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;
Parâmetros que são precisos para guardar
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 phab:rSVN18112; it currently contains only the characters
+\rather than a random string (see edit token suffix).
For the page to be saved, wpStarttime, wpEdittime, wpTextbox1 and wpEditToken are required in a POST request, and neither wpPreview nor wpDiff are passed.
If the page was deleted after wpStarttime, the boolean option wpRecreate is also required.
Dados adicionais opcionais
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.
- wpWatchlistExpiry
- page is added to watchlist with the given expiry time.
- 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
newis 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
wpEditSummaryis 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.
- 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. If the target page exists, ignore the
editparameter and display the (now-)existing page instead. 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.
Páginas especiais
Most special pages have additional parameters, specific to the function they perform. As an example, the parameters for Special:Export are outlined in Manual:Parameters to Special:Export
The following URL parameters provide initial values for some input fields; they can be edited before submitting the form.
- wpNewTitle
- campo do texto com o novo título.
- wpReasonList
- razão para a pré-seleção na lista suspensa.
- wpReason
- campo do texto com o motivo.
- wpLeaveRedirect
- whether to select the "Leave a redirect behind" checkbox.
- wpDisableEmail
- whether to select the
Enviar correio eletrónicocheckbox. - wpDisableUTEdit
- whether to select the
Editar a sua própria página de discussãocheckbox. - 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
wpReason=other - wpAutoBlock
- whether to select the
Bloquear o último endereço de IP desta conta, e quaisquer endereços de IP subsequentes que eles tentem editar, por $1checkbox. - wpWatch
- whether to select the
Vigiar a página do utilizador e a página de discussãocheckbox.
- user-reason
- campo do texto com o motivo.
Parâmetro de Maxlag
| Versões do MediaWiki: | 1.10 – 1.27 |
The maxlag parameter 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.
Notas
- ↑ Os clientes que submetem formulários devem enviar todos os parâmetros do formulário presentes no HTML; confiar em qualquer tipo de lista estática pode levar a uma rutura futura. Para registar novas ações com uma instalação do MediaWiki, consulte $wgActions.
- ↑ Any action, except
view, can be disabled using the $wgActions variable, which is now available for all actions.If searches are enabled and the
searchparameter is supplied (and non-blank) then all actions are ignored and the search is performed. - ↑
Deletion is performed upon a POST request, if a valid edit token is passed as the value of
wpEditToken; this is what happens when the user confirms deletion. The delete reason is passed as the value of argumentwpReason; this string is recorded in the deletion log (thelog_comment_idfield of the logging table). Deletion is also performed when deleting a single version of an image; this requires the version ID to be passed in the parameteroldimageand a valid edit token inwpEditToken; in this case, the request can also be passed via GET. - ↑
- if the optional
summaryargument is passed, its value is used as the edit summary in place of the default one - if the optional
botargument is passed, the edit will be marked as a bot one (the edit is markedrc_bot=1in the recentchanges table) - the
botargument can also be used on any page a [rollback] link will appear on, to cascade&bot=1to all rollback links generated - if the optional
hidediffargument is passed, the success message is shown instead of a diff of the change (this can be forced via user preferences)
- if the optional
- ↑ These levels are changed to the values of
mwProtect-level-editandmwProtect-level-moveif the request is a POST one and a valid edit token is passed aswpEditToken; parametermwProtect-reasongives the reason for protection or unprotection which will be recorded in the page log; ifmwProtect-cascadeis also passed, cascading protection is applied (all transcluded pages are set to the same protection levels)- more generally, the actions that can be limited are those listed in the $wgRestrictionTypes array; this array is initialized to
array('edit','move')and can be changed in LocalSettings.php; the protection action then accept a parametermwProtect-level-$actionfor each action in that array
- more generally, the actions that can be limited are those listed in the $wgRestrictionTypes array; this array is initialized to
- ↑ Before rev:r31291, Editredlink did the same thing that is now achieved by
action=edit&redlink=1(see below for an explanation of the redlink parameter) - ↑ For security reasons, in some versions of MediaWiki Raw is only allowed when using the "primary script access point", that is, when using the "ugly" URL form with
index.php?title=... - ↑ Project:Tech News/2017#Tech News: 2017-16
- ↑ Reading/Web/Desktop Improvements#May 2020: First deployment - officewiki and testwiki
- ↑ For performance reasons, the value of this field is not actually an offset (the index of the first entry to show)
Consultar também
- Markup spec
- API: Módulo principal
- Ajuda: URL
- Listagem de funções
- Snippets/Load JS and CSS by URL (adiciona os parâmetros withJS e withCSS que são processados no lado do cliente)