Посібник:Параметри index.php

Ця сторінка — частковий список параметрів index.php — основного скрипту програмного забезпечення MediaWiki, яке надає сама MediaWiki. Більшість із цих аргументів, як правило, вказуються як параметри GET в URL-адресі, але також можуть передаватися як дані POST. У деяких випадках насправді потрібен POST, наприклад, для дії очищення. Деякі розширення надають додаткові параметри.

Інформація на цій сторінці неповна.

Редакція або версія сторінки

Параметри index.php зазвичай застосовуються та мають значення, пов'язане зі сторінкою, до якої вони застосовуються. Сторінку (або її версію) можна вказати, ввівши один або декілька таких параметрів: https://en.wikipedia.org/w/index.php?title=Ferengi&curid=177126&diff=304901009&oldid=304764764

Назва	Опис
title	Заголовок сторінки. Це може бути вікі-сторінка чи спеціальна сторінка, залежно від інших параметрів. Для вимкнення спеціальної сторінки у своїй конфігурації вікі можна використати хук SpecialPage_initList .
curid	Ідентифікатор вікі-сторінки; перекриває значення заголовку.

Деякі дії (такі, як перегляд і редагування) також працюють на конкретній версії сторінки. Така версія ідентифікується двома наступними параметрами, дозволяючи упущення заголовку й ідентифікатора сторінки.

Назва	Опис
oldid	Ідентифікатор версії
direction	Замість версії, даної oldid, використовуйте: direction=prev: попередню direction=next: наступну

Дії

Далі наведено список значень параметру action.

Деякі з цих дій можна вмикати/вимикати, використовуючи виділене налаштування конфігурації в LocalSettings.php . Де доступні, ці локальні налаштування перелічені.

Name	Функція	Приклад
view	Перегляд — дія за замовчуванням; перегляд — дія, що використовується тоді, коли жодну дію не задано явно	www.mediawiki.org/w/index.php?title=Project:Sandbox&action=view
watch	Додає сторінку до списку спостереження користувача	www.mediawiki.org/w/index.php?title=Project:Sandbox&action=watch
unwatch	Вилучає сторінку зі списку спостереження користувача	www.mediawiki.org/w/index.php?title=Project:Sandbox&action=unwatch
delete	Видаляє сторінку За замовчуванням видалення повертає користувачеві форму підтвердження та зазначення причини.	www.mediawiki.org/w/index.php?title=Project:Sandbox&action=delete
revert	Скасування до попередньої версії зображення. Вимагаються наступні два інші параметри: oldimage — ідентифікатор версії, до якої скасовується; wpEditToken — дійсний токен редагування;
rollback	Відкоти останніх редагувань, зроблені останнім дописувачем сторінки; іншими словами, відновлюється остання версія статті, дописувач якої не є останнім. Редагування позначається незначним і використовується його опис за замовчуванням. Вимагаються наступні два інші параметри: from — ім'я користувача, чиї редагування скасовуються token — токен відкоту; використовується для запобігання ошукуванню користувачів у виконанні небажаних відкотів, шляхом слідування посиланням або натисканням кнопки на зовнішньому веб-сайті.	www.mediawiki.org/w/index.php?title=Project:Sandbox&action=rollback&from=John&token=d7aaa6c\
protect	Показує чи змінює рівні захисту сторінки: За замовчуванням скрипт повертає форму, що показує поточні рівні захисту сторінки, дозволяючи користувачеві змінити їх.	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 on Meta. rcid — ідентифікатор редагування в таблиці recentchanges
render	Виводить рендеринг HTML вмісту всієї сторінки; подібно дії view, але виводиться тільки нестилізований текст статті, а не будь-яка частина інтерфейсу користувача (додаткові інструментальні поля, поле пошуку, таблиці стилів тощо). Для стабільнішого програмного доступу чи отримання HTML лише шматка вмісту сторінки слід використовувати API parse з параметрами page чи pageid.	www.mediawiki.org/w/index.php?title=Project:Sandbox&action=render
purge	Очищає кеш сторінки, змушуючи її повторно відображуватися з її джерела. Ця дія виконується тільки, якщо запитана через запит POST; інакше показується форма підтвердження очищення (натискання кнопки OK публікує запит очищення, який потім виконується).	www.mediawiki.org/w/index.php?title=Project:Sandbox&action=purge
submit	Виконує різні дії, пов'язані зі зміною сторінки (докладніше див. нижче): За замовчуванням показується сторінка у формі редагування з полем редагування. Різні інші аргументи можуть використовуватися для: Зміни сторінки, попереднього перегляду нової версії сторінки, чи показу різниці з новою версією (докладніше див. розділ редагування та надсилання нижче); If the default editor is set to VisualEditor , action=submit will force showing the source code editor. VisualEditor can be selected with veaction=edit URL parameter. The #/editor/… overlay of Extension:MobileFrontend on Skin:Minerva does not appear with action=submit. Instead, the default submission form is shown, which allows marking edits as "minor".	www.mediawiki.org/w/index.php?title=Project:Sandbox&action=submit
edit	Показує сторінку у формі редагування, «edit» робить майже те саме, що й submit.	www.mediawiki.org/w/index.php?title=Project:Sandbox&action=edit
editredlink	Те саме, що edit.	www.mediawiki.org/w/index.php?title=Project:Sandbox&action=editredlink
history	Показує історію сторінки (Див. історію, нижче).	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.	www.mediawiki.org/w/index.php?title=Project:Sandbox&action=raw
ajax	(deprecated in 1.27); (removed in 1.38) Якщо увімкнено, то викликає функцію php, зареєстровану через $wgAjaxExportList ; див. Manual:Ajax .
credits	Показує список людей, котрі зробили внесок до сторінки в запитанні, використовуючи справжнє ім'я, зазначене в налаштуваннях користувача. Наразі вимкнено у wiki Вікімедіа, але увімкнено за замовчуванням у чистому MediaWiki.	translatewiki.net/w/i.php?title=Translating:MediaWiki&action=credits
info	Показує таку інформацію про сторінку, як кількість користувачів, що мають її у своїх списках спостережень, кількість редагувань і кількість авторів. Контекст див. у Повторно реалізуйте інформаційну дію RfC.	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)

Перекриття налаштування користувача

Наступні параметри перекривають деякі налаштування користувача. Інші параметри, пояснені в інших розділах, — «diffonly», «internaledit» і «externaledit». Параметри нижче впливають на всі дії, крім «render» і «raw».

Назва	Функція	Приклад
useskin	Визначає скін	www.mediawiki.org/w/index.php?useskin=modern
uselang	Визначає мову елементів інтерфейсу користувача (як-от ланка «моє обговорення» тощо), тобто мову інтерфейсу користувача; це особливо корисно для створення облікового запису, оскільки на цьому етапі не застосовуються налаштування. Спеціальний мовний код «qqx » можна використати для відображення ідентифікаторів усіх системних повідомлень, які використовуються на сторінці.	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. See 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. 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	Specify a skin version	www.mediawiki.org/w/index.php?title=MediaWiki&useskinversion=2

View and render

Перегляд — дія за замовчуванням. Якщо жодна інша дія не додана до URL, то використовується action=view. Ця дія показує сторінку, версію чи різницю між двома версіями тієї ж або двох різних сторінок. Нижче наведено (частковий) список.

diff

значення цього параметру визначає версію, повертається різниця між іншою та цією версіями:

• якщо oldid не передано, то показується різниця між цією та попередньою версіями тієї ж статті;
• інакше показується різниця між версією, даною oldid/direction та цією; значення цього параметру може бути ідентифікатором версії, значеннями prev або next для визначення версії відносно даної oldid/direction, і значенням cur для визначення останньої версії сторінки;

Зверніть увагу, що oldid і diff не потребують бути двома версіями тієї ж статті, дозволяючи порівнювати дві версії двох різних сторінок

redirect

Якщо значення цього параметру дорівнює «no», а сторінка є перенаправленням, показується сама сторінка, а не ціль перенаправлення; цей параметр має ефект тільки на action=view і action=render та тільки, якщо ні oldid, ні diff не дані, адже це єдиний випадок, де показується цільова стаття замість перенаправлення;

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

Наступні параметри застосовуються тільки до категорій.

from

якщо сторінка є категорією, то тільки записи списку, ключі сортування яких дорівнюють або починаючи зі значення цього параметру;

Приклад: 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

якщо сторінка є категорією, то тільки записи списку, ключі сортування яких передують значенню цього параметру; використовується тільки, якщо from не переданий;

Наступний параметр застосовується тільки до зображень.

page

номер сторінки в багатосторінковому медіа; наразі він застосовується тільки до файлів DjVu та PDF; перша сторінка пронумерована 1;

Історія

limit

Кількість редагувань сторінки у списку, максимум — 5000 редагувань.

Приклад: https://en.wikipedia.org/w/index.php?title=Special:Contributions&limit=13&contribs=user&target=Atlgirl052005 - перелічує 13 редагувань на сторінку.

dir

відносний порядок сторінок історії редагувань.

редагування сторінки відсортовані за спаданням часової мітки.

offset

використовує часову мітки для визначення того, яку частину історії показувати;

Повертає редагування, які відбулися до часової мітки;

Приклад: https://en.wikipedia.org/w/index.php?title=Special:Contributions&offset=20090815195334&contribs=user&target=Atlgirl052005

Показує редагування, які відбулися одразу перед часовою міткою 20090815195334 (20090815195334 не показується).

Формат параметру — yyyymmddhhmmss. Тому, 20090815195334 створено 15 серпня 2009 року [20090815] о 19:53 (UTC) і 34 секундах [195334]. So 20090815195334 was created on August 15, 2009 [20090815] at 19:53 (UTC) and 34 seconds [195334].

Див. w:Wikipedia:Complete diff and link guide.

якщо додано dir=prev, то працює навпаки, перелічуючи всі редагування після часової мітки

Приклад: https://en.wikipedia.org/w/index.php?title=Special:Contributions&offset=20090815195334&dir=prev&contribs=user&target=Atlgirl052005

Показує редагування, які відбулися одразу після часової мітки 20090815195334 (20090815195334 не показується).

Приклад показу тільки найпершого редагування на сторінці: https://en.wikipedia.org/w/index.php?title=Wikipedia:Village_pump_(technical)&action=history&dir=prev&limit=1

feed

a feed for the changes in the history is returned; allowed values are atom and rss. Можна вимкнути з $wgFeed .

go

(застаріло — слід уникати, тому що було витіснене) go=first — перша (найранніша) показана сторінка історії

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 are text/x-wiki, text/javascript, text/css, and application/x-zope-edit

oldid

the id of a specific revision to return

direction

either next, prev, or cur; 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.

приклад

Edit and submit

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. (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 new 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 ;

Приклад: https://en.wikipedia.org/wiki/Talk:Main_Page?action=edit&section=new&preload=Project:Sandbox

preloadparams[] (або preloadparams%5B%5D)

Replace $1 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 $1 replaced by first value and $2 replaced by second value. (introduced in 1.23)

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;

Приклад: 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 yes or no, overrides user preference "Показувати попередній перегляд під час початку редагування" (завдання 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 file and using an external editor;

undo, undoafter

attempts to undo a sequence of edits, from the undoafter revision up to the undo 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

Що робити

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;

• за замовчуванням повертає форму редагування з попереднім переглядом значення wpTextbox1;
• якщо додатковий аргумент live передано, то показується тільки рендеринг значення wpTextbox1, а не форма й інші елементи ГІК; це подібно до результату збереження й подальшого перегляду з action=render; докладніше див. Manual:Live preview ;
• аргумент wpLivePreview ідентичний wpPreview; таким чином, повертається звичайний попередній перегляд, якщо live не переданий;

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 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.

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 new 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 wpEditSummary 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;

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 edit parameter 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.

Спеціальні сторінки

Більшість спеціальних сторінок мають додаткові параметри, специфічні для функції, яку вони виконують. Як приклад, параметри для Special:Export описані в Manual:Parameters to Special:Export

Наступні параметри URL-адреси надають початкові значення для деяких полів введення; їх можна відредагувати перед поданням форми.

Special:MovePage

wpNewTitle

text field with new title.

wpReasonList

reason to pre-select in the dropdown.

wpReason

text field with reason.

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 wpReason=other

wpAutoBlock

whether to select the "Автоматично блокувати останню IP-адресу, яку використовував цей користувач, і будь-які наступні IP-адреси, які він намагається використати, на період $1" checkbox.

wpWatch

whether to select the "Додати до списку спостереження сторінку користувача і його сторінку обговорення" checkbox.

Special:UserRights

user-reason

text field with reason.

Параметр maxlag

Версії MediaWiki:

1.10 – 1.27

Параметр maxlag використовується тільки, якщо програмне забезпечення працює на кластері баз даних, що реплікується.

Параметр maxlag робить так, що запит не обслуговується за високого серверного трафіку. Параметр maxlag застосовується до всіх дій. Значенням параметру maxlag є число; що нижче це значення, то нижче трафік, що спричинює необслуговування запиту. Нуль не дозволяється.

Див. також

• Markup spec
• API:Main module
• m:Help:URL
• Лістинг функцій
• Snippets/Load JS and CSS by URL (додає параметри withJS і withCSS, які обробляються на боці клієнта)