Расширение:Page Forms

Справка по расширениям MediaWiki

Page Forms Статус релиза: стабильно
Реализация	Служебная страница , API
Описание	Расширение, может быть использовано с Semantic MediaWiki либо Cargo , которое позволяет пользователям создавать формы, в свою очередь, создающие и редактирующие страницы с шаблонами типа карточек (инфобоксы). Формы определены внутри вики-страниц, написаны на особом языке разметки и анализируются на лету, когда форма отображается.
Автор(ы)	Yaron Koren <yaron57@gmail.com>, Stephan Gambke и прочие
Последняя версия	5.8.1 (октябрь 2024)
Политика совместимости	Мастер поддерживает обратную совместимость.
MediaWiki	1.38+
Composer	mediawiki/page-forms
Лицензия	GNU General Public License 2.0 или позднее
Скачать	Скачать расширение Git [?]: скачать текущую версию исходника репозиторий (Phabricator · GitHub) история изменений список разработчиков (GitHub) code review
Пример	Автоматически созданная форма позволяет пользователю править поле мнения
Параметры $wgPageForms24HourTime $wgPageFormsAutocompleteCacheTimeout $wgPageFormsAutocompleteOnAllChars $wgPageFormsAutoeditNamespaces $wgPageFormsCacheAutocompleteValues $wgPageFormsCacheFormDefinitions $wgPageFormsCheckboxesSelectAllMinimum $wgPageFormsDisableOutsideServices $wgPageFormsEmbedQueryCacheTTL $wgPageFormsGoogleMapsKey $wgPageFormsHeightForMinimizingInstances $wgPageFormsIgnoreTitlePattern $wgPageFormsLinkAllRedLinksToForms $wgPageFormsListSeparator $wgPageFormsMainFormsMinimum $wgPageFormsMaxAutocompleteValues $wgPageFormsMaxLocalAutocompleteValues $wgPageFormsRenameEditTabs $wgPageFormsRenameMainEditTab $wgPageFormsShowExpandAllLink $wgPageFormsShowTabsForAllHelperForms $wgPageFormsSimpleUpload $wgPageFormsUseDisplayTitle $wgPageFormsVisualEditorMaxHeight
Добавленные права viewedittab editrestrictedfields createclass multipageedit
Используемые хуки AdminLinks ArticlePurge BeforePageDisplay CanonicalNamespaces CargoTablesActionLinks CargoTablesSetActionLinks CargoTablesSetAllowedActions EditPage::importFormData HtmlPageLinkRendererEnd MakeGlobalVariablesScript MultiContentSave PageSaveComplete PageSchemasRegisterHandlers ParserFirstCallInit ResourceLoaderRegisterModules SkinTemplateNavigation::Universal TinyMCEDisable
Предоставляемые хуки PageForms::AddRLModules PageForms::BeforeFreeTextSubst PageForms::CreateFormField PageForms::CreateTemplateText PageForms::EditFormInitialText PageForms::EditFormPreloadText PageForms::FormPrinterSetup PageForms::HTMLBeforeForm PageForms::PrintRedirectForm PageForms::RenderingEnd PageForms::SetTargetName PageForms::TemplateFieldEnd PageForms::TemplateFieldStart PageForms::UserCanEditPage PageForms::WritePageData
Переведите расширение Page Forms
Роль Vagrant	pageforms
Проблемы	Открытые задачи · Сообщить об ошибке

Page Forms (известное до 2016 года как Semantic Forms) — расширение для MediaWiki, позволяющее пользователям добавлять, редактировать и запрашивать данные с помощью форм. Первоначально оно было создано как ответвление расширения Semantic MediaWiki , чтобы иметь возможность редактировать шаблоны, хранящие их параметры через SMW, поэтому оно первоначально называлось «Semantic Forms». Тем не менее, теперь оно может работать и с альтернативным расширением Cargo , либо без расширения.

Очень просто, Page Forms позволяет создавать формы для создания и редактирования страниц на вашей вики, а также для запроса данных, всё без программирования. Формы могут создаваться и редактироваться не только администраторами, но и самими пользователями.

Основными компонентами функциональности Page Forms являются страницы определения формы, которые существуют в отдельном пространстве имен 'Form:'. Это страницы, состоящие из кода разметки, который анализируется, когда пользователь переходит к форме. Поскольку формы определяются строго через эти страницы, пользователи могут сами создавать и редактировать формы без необходимости какого-либо реального программирования.

Расширение Page Forms чаще всего используется для добавления и редактирования на страницах шаблонов карточек. Форма позволяет пользователю заполнять заранее определенный набор шаблонов, а также разделов страниц для любой страницы; если используются Cargo или Semantic MediaWiki, данные в шаблонах могут быть сохранены и запрошены.

Формы также могут использоваться для редактирования данных на существующей странице, и вы можете активировать вкладку "edit with form" для отображения на любой странице.

Page Forms также поддерживают autocompletion of fields (автозаполнение полей), поэтому пользователи могут легко увидеть, какие ранее введенные значения были для данного поля. Это очень помогает избежать проблем, связанных с двусмысленностью, орфографией и т.д.

Данные на странице, которая не вписывается в форму, как текстовое описание свободной формы объекта страницы, не игнорируются, когда страница редактируется с помощью формы; Скорее, он помещается в отдельное поле ввода под названием "свободный текст".

Page Forms также включают в себя множество других функций, связанных с формами.

Ниже приведены ссылки на всю документацию.

• Загрузка и установка

Как загрузить Page Forms через Git, стандартную загрузку или программный пакет; и как его установить.

• Краткое руководство

Как начать работу с Page Forms сразу.

• Хостинг

Сайты вики-хостинга, поддерживающие Page Forms, а также общедоступные вики-файлы, которые можно использовать для тестирования программного обеспечения.

• Спецстраницы

Все «спецстраницы», Page Forms: страницы которые предоставляют вспомогательные формы (Служебная:CreateProperty, Служебная:CreateTemplate, Служебная:CreateForm, Служебная:CreateCategory, Служебная:CreateClass), страницы которые отображают списки (Служебная:Templates, Служебная:Forms) и страницы которые используются для отображения фактических форм (Служебная:FormEdit, Служебная:FormStart, Служебная:RunQuery, Служебная:UploadWindow).

• Page Forms и шаблоны

Основанная на шаблонах философия Page Forms — плюс информация о чотирёх функциях парсера, которые PF определяет для шаблонов: #template_params, #template_display, #arraymap and #arraymaptemplate.

• Определение форм

Это первый из двух основных разделов. Как определить форму через страницу в пространстве имён «Форма:». Про весь синтаксис определения форм, включая теги {{{info}}}, {{{for template}}}, {{{end template}}}, {{{field}}}, {{{section}}} и {{{standard input}}}. Также про то, как добавлять вкладки и подсказки.

• Input types

The second major section. A listing of all allowed input types, as well as parameters for each, and the set of SMW and Cargo data types that each can be used with.

• Values, mappings and autocompletion

The third major section. Information on setting possible/allowed values for the relevant input types, including "mapping" values to friendlier display names, options related to autocompletion, and the "show on select" parameter.

• Вкладка «редактировать с помощью формы»

Как сделать так, чтобы вкладка «редактировать с помощью формы» отображалась на страницах, использующих функцию парсера #default_form. Плюс как переименовать вкладку в просто «править» и как удалить стандартную вкладку «править» (при желании).

• Ссылки на формы

Как привести пользователей к формам через функции #forminput, #formlink, #formredlink и #queryformlink. И как использовать #formredlink, чтобы статьи по красным ссылкам создавались автоматически. И как создавать ссылки, непосредственно изменяющие страницу, посредством функции #autoedit.

• Создавая формы запросов

Создание форм для запроса информации (а не для её изменения) посреддством страницы Служебная:Запустить_запрос.

• Общие проблемы

Общие проблемы, с которыми сталкиваются люди, и их решения, касающиеся форм, структуры данных и использования Page Forms с другими расширениями.

• Известные баги и планируемые возможности

Известные баги в ПО и их потенциальные временные решения, плюс возможности, планируемые в текущем «плане разработки».

• Получите поддержку

Где задавать вопросы, куда отправлять отчёты о багах, запросы о возможностях, исправления и где добавлять новые переводы.

• Документация для разработчиков

Информация для разработчиков, которые хотят изменить Page Forms, или создать расширение, которое работает в тандеме с ним.

• Авторы и отсылки

Главные авторы, прочие содействовавшие разработке и отсылки к другим организациям и проектам ПО.

• История версий

История версий Page Forms, с мая 2007 года по настоящее время.

• Сайты, использующие Page Forms

Небольшая выборка вики, в которых используется Page Forms, а также ссылки на более полный список.

• Связанные расширения

Расширения, требующие наличия Page Forms, расширения, которые могут использоваться вместе с Page Forms и расширения, которые имеют аналогичную цель Page Forms.

Шпаргалка
Ссылки	SMW краткий справочник · Cargo краткий справочник · Песочница
Функции парсера	{{#arraymap :value|delimiter|var|formula|new_delimiter|conjunction}} {{#arraymaptemplate :value|template|delimiter|new_delimiter}} {{#forminput :form=|size=|default value=|button text=|query string=|autocomplete on category=|autocomplete on namespace=|placeholder=|popup|no autofocus|namespace selector|query string parameters}} {{#formlink :form=|link text=|link type=|query string=|target=|tooltip=|popup|new window|query string parameters}} {{#formredlink :form=|link text=|existing page link text=|query string=|target=|popup|new window|create page|query string parameters}} {{#queryformlink :form=|link text=|link type=|query string=|tooltip=|popup|new window|query string parameters}} {{#template_params :}} {{#template_display :_format=|_title=}} {{#autoedit :form=|target=|link text=|link type=|minor|query string=|reload|tooltip=|redirect|bring to page=|summary=|confirm|query string parameters}} {{#autoedit_rating :form=|target=|value=|star width=|num stars=|allow half stars=|minor|reload|tooltip=|summary=|confirm|query string parameters}} {{#default_form :form name}}
Типы вывода	text , textarea , tokens , combobox , date , datetime , year , datepicker , datetimepicker , checkbox , dropdown , radiobutton , checkboxes , listbox , tree , rating , regexp , googlemaps , leaflet , openlayers