Поле ввода InputBox - История изменений

WikiSysop в 09:22, 6 сентября 2011

2011-09-06T09:22:34Z

WikiSysop в 06:43, 6 сентября 2011

2011-09-06T06:43:03Z

WikiSysop в 06:42, 6 сентября 2011

2011-09-06T06:42:25Z

WikiSysop в 06:40, 6 сентября 2011

2011-09-06T06:40:23Z

WikiSysop: Новая страница: «{{Extension/ru|templatemode = |name = InputBox |status = stable |type1 = tag |type2 = page action |type3 = search |hook1 ...»

2011-09-06T06:37:43Z

Новая страница: «{{Extension/ru|templatemode = |name = InputBox |status = stable |type1 = tag |type2 = page action |type3 = search |hook1 ...»

Новая страница

{{Extension/ru|templatemode =
|name = InputBox
|status = stable
|type1 = tag
|type2 = page action
|type3 = search
|hook1 = ParserFirstCallInit
|hook2 =
|username =Eloquence
|author = Ерик Мёллер (''Erik Möller'')
|description = Позволяет пользователям добавлять предопределённые формы HTML в текст вики-страниц.
|image =
|imagesize =
|version =
|update =
|mediawiki = 1.11
}}

'''InputBox''' (''ФормаВвода'') — [[Extensions|расширение MediaWiki]], позволяющее добавлять на вики-страницы предопределённые [[:en:HTML form|формы HTML]]. Пользователь может "заполнить" форму (ввести текст, выбрать пункт меню, и т.п.), вводя текста в поле ввода.

Исходно InputBox создавался [[User:Eloquence|Эриком Мёллером]] для того, чтобы можно было добавить форму ''Создать статью'' в [[m:Wikinews|Викиновости]].<Ref>[http://meta.wikimedia.org/w/index.php?title=Help:Inputbox&oldid=151485 2 июля 2005 года]</ref> Для Extension:InputBox требуется как минимум MediaWiki 1.5.

==Установка==
1. Создайте в папке, где расположены расширения, подпапку InputBox.

2. Скачайте и сохраните файлы
:# <tt>[http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/InputBox/InputBox.php?view=co InputBox.php]</tt>
:# <tt>[http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/InputBox/InputBox.i18n.php?view=co InputBox.i18n.php]</tt>
:# <tt>[http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/InputBox/InputBox.classes.php?view=co InputBox.classes.php]</tt> и
:# <tt>[http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/InputBox/InputBox.hooks.php?view=co InputBox.hooks.php]</tt>

:...в эту подпапку ''extensions/InputBox/'' вашей инсталляции MediaWiki.

:Самая последняя версия <tt>InputBox.php</tt> не заработает со старыми инсталляциями MediaWiki.<ref>Версия Extension:InputBox [http://wikipedia.cvs.sourceforge.net/*checkout*/wikipedia/extensions/InputBox/InputBox.php?revision=1.17 1.17]/1.18 не работает с [http://meta.wikimedia.org/w/index.php?title=Help:Inputbox&diff=653100&oldid=653090 MediaWiki 1.6.8],  [[Extension_talk:InputBox#Call_to_undefined_function_wfloadextensionmessages.28.29_in_wiki.2Fextensions.2FInputBox.2FInputBox.classes.php_on_line| MediaWiki 1.7.1, or Mediawiki 1.9.3 (согласно трём сообщениям пользоваателей, достаточно обновить версию до 1.11, чтобы расширение нормально заработало)]]. Более старые версии Extension:InputBox можно найти в папке репозитоия по ссылке: https://svn.wikia-code.com/wikia/branches/Bartek/extensions/inputbox/ </ref>

3. В [[Manual:LocalSettings.php/ru|LocalSettings.php]] добавьте следующий вызов расширения — там же, где находятся другие "require_once" строки: <source lang="php">require_once($IP.'/extensions/InputBox/InputBox.php');</source>

==Пример==
<table class="wikitable"><tr><td width="50%" valign="top">
===Вики-код===
<inputbox>
type=search
width=42
buttonlabel=Перейти
searchbuttonlabel=Найти
break=no
</inputbox>
</td><td width="50%" valign="top">

===Результат===
<inputbox>
type=search
width=42
height=100
buttonlabel=Перейти
searchbuttonlabel=Найти
break=no
</inputbox>
</tr></table>
Форму такого вида можно найти на главной странице Википедии. Её можно использовать, чтобы начать новую статью, поскольку она не переходит в режим редактирования для уже существующих статей.

== Основной синтаксис ==

InputBoxes устроен следующим образом:
{| border="0" cellspacing="5" cellpadding="5" frames="border" rules="all" bgcolor="#ffffff"
|-
|<pre>
<inputbox>
type=
bgcolor=
width=
default=
preload=
editintro=
buttonlabel=
hidden=
searchbuttonlabel=
break=
namespaces=
prefix=
</inputbox>
</pre>
|}

Параметр ''type'' обязателен. Все остальные параметры опциональны.

== Типы форм ввода ==

{| class="wikitable" width="79%"
!Тип
!Пример
!Описание
|-
| type=search
|
<inputbox>
type=search
</inputbox>
| Создаёт форму для поиска с шириной поля ввода по умолчанию в 50 символов. Производится поиск информации, добавленной в текстовое поле.
|-
| type=create
|
<inputbox>
type=create
</inputbox>
| Создаёт новую страницу. Введённая в текстовое поле информация становится именем новой страницы, открываемой в режиме редактирования.
|-
| type=comment
|
<inputbox>
type=comment
</inputbox>
| Добавляет новый раздел внизу страницы, имя которой задано в текстовом поле ввода.
|-
| type=commenttitle
|
<inputbox>
type=commenttitle
page={{TALKPAGENAME}}
</inputbox>
| Добавляет новый раздел c заголовком, определённом в тестовом поле. Целевая страница определяется через значение параметра <code>page=</code>. Добавлено в [[rev:42703]].
|-
| type=fulltext
|
<inputbox>
type=fulltext
</inputbox>
| Форма поиска только с одной кнопкой полнотекстового поиска, без кнопки «{{int:searcharticle}}». Добавлено в [[rev:45269]].
|}

<div style="clear:both;"></div>

== Параметры ==

{| border="1" cellspacing="5" cellpadding="5" frames="border" rules="all" bgcolor="#ffffff"
!Параметр ''Назначение''
!Пример
|-
||'''bgcolor=''' ''Все типы''   Задаёт цвет фона таблицы (значения цветов HTML). Без кавычек.
|<pre><inputbox>
type=search
bgcolor=#eeeeff
</inputbox></pre>
<inputbox>
type=search
bgcolor=#eeeeff
</inputbox>
|-
||'''width=''' ''Все типы''   Задаёт ширину формы ввода в символах.
|<pre><inputbox>
type=create
width=24
</inputbox></pre>
<inputbox>
type=create
width=24
</inputbox>
|-
||'''default=''' ''Все типы''   Текст, помещаемый в InputBox по умолчанию.
|<pre><inputbox>
type=comment
default=User talk:Eloquence
</inputbox></pre>
<inputbox>
type=comment
default=User talk:Eloquence
</inputbox>
|-
||'''preload=''' ''comment'', ''create''   Текст, взятый со страницы с заданным здесь названием (см. [[Manual:Creating pages with preloaded text]]), будет помещён в открывшуюся при создании новой страницы форму редактирвоания.
|<pre><inputbox>
type=create
preload=Log
</inputbox></pre>
<inputbox>
type=create
preload=Log
</inputbox>
|-
|colspan="2"|Введите название ещё не существующей страницы в примерах InputBox выше или ниже, и нажмите «{{int:createarticle}}» или «Оставить комментарий», соответственно, для проверки эффекта.
|-
||'''editintro=''' ''comment'', ''create''   текст со страницы, имя которой задано через этот параметр, будет отображаться в качестве инструкции ''над'' окном редактирования.
|<pre><inputbox>
type=comment
editintro=MediaWiki:Missingcommenttext
</inputbox></pre>
<inputbox>
type=comment
editintro=Mediawiki:Missingcommenttext
</inputbox>
|-
||'''buttonlabel=''' ''Все типы''   Этот текст будет отображаться на основной кнопке формы.
|<pre><inputbox>
type=comment
buttonlabel=Добавить новую сплетню
</inputbox></pre>
<inputbox>
type=comment
buttonlabel=Добавить новую сплетню
</inputbox>
|-
||'''hidden=''' ''create, comment''   Этот параметр отключает собственно поле ввода. Используется в паре с параметром "default", который в этом случае определяет не умолчание, но фиксированное имя страницы.
|<pre><inputbox>
type=comment
editintro=Extension:InputBox/editintro comment
preload=Extension:InputBox/preload
hidden=yes
default=Extension talk:Inputbox
buttonlabel=Оставить комментарий на странице обсуждения
</inputbox></pre>
<inputbox>
type=comment
editintro=Extension:InputBox/editintro comment
preload=Extension:InputBox/preload
hidden=yes
default=Extension talk:InputBox
buttonlabel=Оставить комментарий на странице обсуждения
</inputbox>
|-
||'''searchbuttonlabel=''' ''search, fulltext''   Этот текст будет отображаться на кнопке «{{int:searchfulltext}}» формы поиска.
|<pre><inputbox>
type=search
searchbuttonlabel=Копать глубже
</inputbox></pre>
<inputbox>
type=search
searchbuttonlabel=Копать глубже
</inputbox>
|-
||'''break=''' ''Все типы''   Определяет, будет или не будет делаться перевод строки между полем ввода и кнопкой (кнопками). Значение по умолчанию — '''yes''' (разрыв строки добавлен).
|<pre><inputbox>
type=create
width=24
break=no
</inputbox></pre>
<inputbox>
type=create
width=24
break=no
</inputbox>
|-
||'''namespaces=''' ''search, fulltext''   Поддержка флажков пространств имён при полнотекстовом поиске. Значение вида "<tt>Namespace'''**'''</tt>" задаёт режим использования настроек по умолчанию.
|<pre><inputbox>
type=search
namespaces=Main**,Help
</inputbox></pre>
<inputbox>
type=search
namespaces=Main**,Help
</inputbox>
|-
||'''prefix=''' ''search, fulltext''   Сузить область поиска, ограничив его страницами, начинающимися с определённого префикса. Заметьте, что это работает не для всех поисковых движков, в настоящее время — только с последней версией [[Extension:lucene-search]]. По умолчанию — пустая строка (искать среди всех страниц).

Примечание: подчеркивания не распознаются как пробелы.
|<pre><inputbox>
type=search
prefix={{FULLPAGENAME}}/Archive
</inputbox></pre>
<inputbox>
type=search
prefix={{FULLPAGENAME}}/Archive
</inputbox>
|}

Применение форм типа «''create''» для существующей страницы просто откроет её в режиме редактирования. В этом случае страница, заданная в качестве <tt>preload</tt>, будет проигнорирована.
Применение форм типа «''comment''» допустимо и для новых страниц.

Тексты из пространства имён <tt>MediaWiki:</tt> приведены только для примера, в качестве значений <tt>editintro</tt> или <tt>preload</tt> могут быть указаны любые существующие страницы.
К сожалению, режим <tt>preload</tt> пока не применим для поля «{{int:fileuploadsummary}}» страницы [[Special:Upload]].

Пожалуйста, не забывайте, что переменные, шаблоны, функции парсера и параметры шаблонов не поддерживаются в качестве параметров InputBox.

==Закрепление выравнивания==
Редакторам может потребоваться определять выравнивание отдельно для каждого случая использования форм ввода. Для этого можно просто удалить тег <tt>div</tt> tag из HTML-кода и задавать <tt>div</tt> при размещении InputBox в вики-тексте. Вместо этого редакторы могут установить [[Extension:InputBox/Align|модифицированную версию расширения]] со встроенной поддержкой возможности для редакторов измененять способ выравнивания — через определение значений параметра <tt>align=left</tt>, <tt>align=center</tt>, или <tt>align=right</tt>.

==Использование InputBox в шаблонах==
Когда требуется создавать множество похожих форм ввода, InputBox можно использовать внутри шаблона. Однако, передача значений параметров шаблона в значения параметров InputBox работает, только если тег <tt><nowiki><inputbox>...</inputbox></nowiki></tt> записан внутри шаблона в форме <tt><nowiki>{{#tag:inputbox | ...}}</nowiki></tt>.

В следующем примере представлен текст шаблона для создания вики-страницы на основе некотрого именованного шаблона:
<pre>
{{#tag:inputbox |
type=create
buttonlabel=Создание новой {{{1|статьи}}}
preload={{{2|Template:Статья}}} }}
</pre>

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

Например, код формы ввода для создания нового проекта из шаблона проекта может выглядеть следующим образом:
<pre>
{{Template:CreateNew|проект|Template:Проект}}
</pre>

← Предыдущая		Версия 09:22, 6 сентября 2011
Строка 259:		Строка 259:
	{{Template:CreateNew\|проект\|Template:Проект}}		{{Template:CreateNew\|проект\|Template:Проект}}
	</pre>		</pre>
		+
		+	[[Категория:Справка]]

@@ Строка 240: / Строка 240: @@
 ==Закрепление выравнивания==
-Редакторам может потребоваться определять выравнивание отдельно для каждого случая использования форм ввода. Для этого можно просто удалить тег <tt>div</tt> tag из HTML-кода и задавать <tt>div</tt> при размещении InputBox в вики-тексте. Вместо этого редакторы могут установить [[Extension:InputBox/Align|модифицированную версию расширения]] со встроенной поддержкой возможности для редакторов измененять способ выравнивания — через определение значений параметра <tt>align=left</tt>, <tt>align=center</tt>, или <tt>align=right</tt>.
+Редакторам может потребоваться определять выравнивание отдельно для каждого случая использования форм ввода. Для этого можно просто удалить тег <tt>div</tt> tag из HTML-кода и задавать <tt>div</tt> при размещении InputBox в вики-тексте. Вместо этого редакторы могут установить модифицированную версию расширения со встроенной поддержкой возможности для редакторов измененять способ выравнивания — через определение значений параметра <tt>align=left</tt>, <tt>align=center</tt>, или <tt>align=right</tt>.
 ==Использование InputBox в шаблонах==

@@ Строка 88: / Строка 88: @@
 page={{TALKPAGENAME}}
 </inputbox>
-| Добавляет новый раздел c заголовком, определённом в тестовом поле. Целевая страница определяется через значение параметра <code>page=</code>.  <small>Добавлено в [[rev:42703]].</small>
+| Добавляет новый раздел c заголовком, определённом в тестовом поле. Целевая страница определяется через значение параметра <code>page=</code>.
 |-
 | type=fulltext
@@ Строка 95: / Строка 95: @@
 type=fulltext
 </inputbox>
-| Форма поиска только с одной кнопкой полнотекстового поиска, без кнопки «{{int:searcharticle}}». <small>Добавлено в [[rev:45269]].</small>
+| Форма поиска только с одной кнопкой полнотекстового поиска, без кнопки «{{int:searcharticle}}».
 |}
@@ Строка 136: / Строка 136: @@
 </inputbox>
 |-
-||'''preload='''<br />''comment'', ''create''<br />&#160;<br />Текст, взятый со страницы с заданным здесь названием (см. [[Manual:Creating pages with preloaded text]]), будет помещён в открывшуюся при создании новой страницы форму редактирвоания.
+||'''preload='''<br />''comment'', ''create''<br />&#160;<br />Текст, взятый со страницы с заданным здесь названием, будет помещён в открывшуюся при создании новой страницы форму редактирвоания.
 |<pre><inputbox>
 type=create
@@ Строка 218: / Строка 218: @@
 </inputbox>
 |-
-||'''prefix='''<br />''search, fulltext''<br />&#160;<br />Сузить область поиска, ограничив его страницами, начинающимися с определённого префикса. Заметьте, что это работает не для всех поисковых движков, в настоящее время — только с последней версией [[Extension:lucene-search]].<br/>По умолчанию — пустая строка (искать среди всех страниц).
+||'''prefix='''<br />''search, fulltext''<br />&#160;<br />Сузить область поиска, ограничив его страницами, начинающимися с определённого префикса. Заметьте, что это работает не для всех поисковых движков, в настоящее время — только с последней версией.<br/>По умолчанию — пустая строка (искать среди всех страниц).
 Примечание: подчеркивания не распознаются как пробелы.

@@ Строка 1: / Строка 1: @@
-{{Extension/ru|templatemode =
+'''InputBox''' (''ФормаВвода'') — расширение MediaWiki, позволяющее добавлять на вики-страницы предопределённые формы HTML. Пользователь может "заполнить" форму (ввести текст, выбрать пункт меню, и т.п.), вводя текста в поле ввода.
-'''InputBox''' (''ФормаВвода'') — [[Extensions|расширение MediaWiki]], позволяющее добавлять на вики-страницы предопределённые [[:en:HTML form|формы HTML]]. Пользователь может "заполнить" форму (ввести текст, выбрать пункт меню, и т.п.), вводя текста в поле ввода.
+Исходно InputBox создавался Эриком Мёллером для того, чтобы можно было добавить форму ''Создать статью'' в Викиновости.
 ==Пример==