Расширение:InputBox

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:InputBox and the translation is 48% complete.

Outdated translations are marked like this.
Other languages:
English • ‎español • ‎français • ‎polski • ‎português do Brasil • ‎čeština • ‎русский • ‎中文 • ‎日本語 • ‎한국어
This extension comes with MediaWiki 1.21 and above. Thus you do not have to download it again. However, you still need to follow the other instructions provided.
Справка по расширениям MediaWiki
OOjs UI icon advanced.svg
InputBox
Статус релиза: стабильный
Simple Input Form.png
Реализация Tag , Page action , Search
Описание Позволяет пользователям добавлять предопределенные HTML формы на вики-страницы
Автор(ы)
  • Erik Möller
  • Leonardo Pimenta
  • Rob Church
  • Trevor Parscal
  • Daniel Schuba
Последняя версия Continuous updates
MediaWiki 1.30+
Изменения БД Нет
Лицензия MIT License
Загрузка
* <inputbox>
Переведите расширение InputBox если оно доступно на translatewiki.net
Проверьте использование и версию.
Проблемы Открытые задачи · Сообщить об ошибке

Расширение InputBox добавляет уже созданные HTML формы к страницам вики. Пользователи могут «заполнить» форму (вводя текст, выбирая пункты меню и т. Д.), вводя текст в поле.

InputBox был первоначально создан пользователем Erik Möller с целью добавления поля Создать статью на Wikinews.

Установка

  • Скачайте и распакуйте файл(ы) в папку с названием InputBox в вашей папке extensions/.
  • Добавьте следующий строки в конец файла LocalSettings.php:
    wfLoadExtension( 'InputBox' );
    
  • Yes Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

Для использующих MediaWiki 1.24 или более ранние:

В приведенных выше инструкциях описывается новый способ установки этого расширения с использованием wfLoadExtension()

Если вам нужно установить это расширение на более ранние версии (MediaWiki 1.24 и более ранние), вместо wfLoadExtension( 'InputBox' );, вам необходимо использовать:

require_once "$IP/extensions/InputBox/InputBox.php";

Примеры

Поле, позволяющее задать новый заголовок

Wiki-код

<inputbox>
type=create
break=no
</inputbox>

Результат


Общий синтаксис

Поля ввода создаются на подобии данного:

<inputbox>
type=
bgcolor=
width=
page=
default=
preload=
editintro=
buttonlabel=
hidden=
searchbuttonlabel=
break=
namespaces=
prefix=
placeholder=
preloadparams[]=
</inputbox>

Параметр type обязателен. Все другие параметры не обязательны. preloadparams[] могут использоваться более одного раза.

Типы полей

Положение "по умолчанию" кнопки(кнопок) “Отправить” ниже поля ввода.


Кнопка “Отправить” может быть сдвинута вправо с помощью параметра разрыва строки чтобы устранить разрыв строки между полем и кнопкой: break=no.

Положение кнопки “Отправить” справа полезно для полей поиска, когда поисковые запросы могли бы перекрыть кнопку поиска под окном поиска.

Тип Пример Описание
type=search
Создает окно поиска с шириной по умолчанию 50 символов. Ищет информацию, добавленную в текстовое поле.
type=create

Создание новой страницы Информация, добавленная в текстовое поле, - это имя редактируемой страницы.
type=comment

Добавляет новый раздел в нижней части страницы, указанной в текстовом поле.
type=commenttitle

Добавляет новый раздел с заголовком раздела, введенным в текстовое поле. Заголовок может быть указан параметром default=. Страница должна быть указана с параметром page=. (introduced in rev:47203)
type=fulltext
Искать только с помощью кнопки полнотекстового поиска без кнопки “Перейти”. (introduced in rev:45269)
type=move

Переместите страницу на другое имя. (introduced in gerrit:97559)

Для type=search2 расположение по умолчанию для кнопки поиска находится справа. В настоящее время не представляется возможным добавлять другие параметры в этот тип поля ввода. В этом поле поиска выполняется поиск по всей вики, в которую он помещен.

Тип Пример
type=search2
 

Параметры

Параметр Описание Область Совместимость Пример Результат
bgcolor= Устанавливает цвет фона таблицы (значения цвета HTML). Не используйте кавычки Все типы ?
<inputbox>
type=search
bgcolor=#eeeeff
</inputbox>
width= Устанавливает ширину InputBox в символах. Все типы ?
<inputbox>
type=create
width=24
</inputbox>

default= Текст по умолчанию для ввода в InputBox. Все типы ?
<inputbox>
type=comment
default=User talk:Eloquence
</inputbox>

preload= Страница под этим заголовком будет предварительно загружена (см. Manual:Creating pages with preloaded text ) в пустое поле редактирования при создании новой страницы. create, comment, commenttitle ?
<inputbox>
type=create
preload=Log
</inputbox>

Введите заголовок несуществующей страницы в примере InputBox выше или ниже и нажмите «Создать статью» или «Новый раздел» соответственно, чтобы проверить этот эффект.
editintro= The page which is given under this parameter will be shown, as instructions, above the editing window. create, comment ?
<inputbox>
type=comment
editintro=MediaWiki:Missingcommenttext
</inputbox>

buttonlabel= This label will be used for the main button of the form. All types ?
<inputbox>
type=comment
buttonlabel=Add new rumor
</inputbox>

hidden= This specifies that there is no InputBox.

It is used with parameter "default", now not being a default, but the fixed value of the name of the page.

create, comment ?
<inputbox>
type=comment
editintro=Extension:InputBox/editintro comment
preload=Extension:InputBox/preload
hidden=yes
default=Extension talk:InputBox
buttonlabel=Post a comment on the talk page
</inputbox>

searchbuttonlabel= This label will be used for the "Search full text" button of the search form. search, fulltext ?
<inputbox>
type=search
searchbuttonlabel=Dig deeper
</inputbox>
fulltextbutton= Show the full text search button on search2 form search2 ?
<inputbox>
type=search2
searchbuttonlabel=Dig deeper
fulltextbutton=true
</inputbox>
labeltext= Текст для отображения рядом с кнопкой search2 ?
<inputbox>
type=search2
searchbuttonlabel=Dig deeper
labeltext=Look for: 
</inputbox>
 
break= Whether or not to insert a line break between the input box and the button(s). Defaults to yes (use a line break). All types ?
<inputbox>
type=create
width=24
break=no
</inputbox>
namespaces= Support for namespace checkboxes in fulltext search.

With "Main**", main article namespace is checked by default.

search, fulltext ?
<inputbox>
type=search
namespaces=Main**,Help
</inputbox>
prefix=
  • Narrow down search to pages beginning with certain prefix. Note this only works with certain search back-ends, currently only Extension:CirrusSearch . Defaults to empty string (search all pages).
  • Create new page beginning with a certain prefix.
  • In type=move, the prefix is prepended to the default parameter.

Remark: underscores aren't recognized as spaces.

search, fulltext, create ?
<inputbox>
type=search
prefix={{FULLPAGENAME}}/Archive
</inputbox>

The button below prefixes the name with Special:Mypage/.


placeholder= Define placeholder text that will display in the input box when it is empty. All types 1.19+
<inputbox>
type=search
placeholder=Search this Wiki
</inputbox>
page= Page to posts comment to, or page to move. comment, move
<inputbox>
type=comment
page=Project:Sandbox
</inputbox>

minor= Minor edit. comment, create
<inputbox>
type=comment
page=Project:Sandbox
minor=true
</inputbox>

nosummary= Edit summary (headline) not required for new comment. comment
<inputbox>
type=comment
page=Project:Sandbox
nosummary=true
</inputbox>

summary= Edit summary or move reason. create, move
<inputbox>
type=create
default=Special:Mypage/inputbox test
summary=Foo
</inputbox>

id= id attribute for <form>. All types 1.23 for some types
<inputbox>
type=comment
page=Project:Sandbox
summary=Foo
id=bar
</inputbox>

inline= Make the InputBox be an inline element (no line break at beginning). search2
Text here: <inputbox>
type=search2
inline=true
width=10
</inputbox>
Text here:
 
dir= Right to left (rtl) or left to right (ltr). Defaults to directionality of the page's language. All types
<inputbox>
dir=rtl
type=comment
page=Project:Sandbox
summary=Foo
</inputbox>

preloadparams[]= Specify parameters to the preload text. See Creating pages with preloaded text. create, comment, commenttitle 1.25+
<inputbox>
type=create
preload=Log
preloadparams[]=param1
preloadparams[]=param2
</inputbox>

searchfilter= Specify parameters to append to the search search 1.30+
<inputbox>
type=search
searchfilter=insource:foo
</inputbox>
useve= When creating a page the input box will use the new visual editor, if the extension is installed, and this parameter is set to true. create, comment
<inputbox>
type=create
break=no
useve=true
</inputbox>

Applying create to an existing page simply gives the edit page. In that case preload is ignored. Applying comment for a new page works.

The texts taken from the MediaWiki: namespace are of course only examples, any existing page can be used for editintro or preload. Unfortunately preload does not yet work for the Upload summary.

Выравнивание

If you want to create an inputbox on the right side of the page, do something like:

<div style="float:{{dir|{{pagelang}}|left|right}}; width:42em">
<inputbox>
type=create
</inputbox>
</div>

Функция парсера

Using InputBox in a template

In order to create many similar input boxes, InputBox can be used in a template. However, passing template parameters to InputBox parameters only works if the <inputbox>...</inputbox> tag is written as {{#tag:inputbox | ...}} inside the template.

The following example is a template to create a new wiki page from a named template:

{{#tag:inputbox |
type=create
buttonlabel=<span class="mw-translate-fuzzy">Создать следующую</span>
preload={{{2|Template:Article}}} }}

При создании экземпляра шаблона первый параметр дает элемент, который создается (по умолчанию: article), как указано в кнопке, второй параметр указывает имя шаблона, используемого для создания элемента (по умолчанию: Template:Article).

Например, код для окна ввода для создания нового проекта из шаблона проекта может выглядеть следующим образом:

{{Template:CreateNew|project|Template:Project}}

См. также