Руководство:Формы
Please note: Some techniques recommended in this article require the use of extensions. Exercise caution when using them, as the status of each extension is self-assigned by its maintainer, and does not reflect the opinion of the MediaWiki development team.
Пожалуйста, обратите внимание: Некоторые методы, рекомендуемые в этой статье, требуют использования расширений. Статус, присвоенный каждому расширению, присваивается сопровождающим самостоятельно и не отражает мнение команды разработчиков MediaWiki. |
В экосистеме Mediawiki понятие "form" может иметь 3 различных значения:
- встроенные формы, включенные в программное обеспечение Mediawiki, с помощью которых пользователи могут входить в систему/логин, редактировать wikitext страниц и даже выполнять структурированный поиск по большому набору специальных страниц
- формы ввода для предоставления администраторам вики данных, введенных посетителями, размещенных в стандартных статьях Вики или специальных страницах
- формы, расположенные как в стандартных статьях вики, так и на специальных страницах, с помощью которых пользователи могут вводить структурированные данные для создания новой статьи вики и «предзагрузки» такой статьи с введенными данными (эти формы известны как «формы страниц»)
Built-in forms
Out-of-the-box MediaWiki использует формы для ввода данных для различных функций обслуживания страниц и административного управления. Статьи MediaWiki создаются с использованием свободного викитекста. Как и большинство других функций MediaWiki, есть много возможностей настройки.
Настройка встроенных элементов
Смотрите следующие статьи:
- Руководство:Интерфейс, Помощь:Системные сообщения - описать, как настроить/локализировать текст, который появляется на встроенных формах, используемых MediaWiki.
Входной формат
Формы ввода - это стандартные формы, размещенные либо в статьях вики, либо на специальных страницах, где посетители могут вводить структурированные данные (например, контактные данные) и администраторы могут легко и безопасно получить доступ к представлениям. Поскольку Out-of-the-Box MediaWiki не предоставляет эту функцию, вот список расширений, которые реализуют ее:
- Extension:ContactPage/ru - реализует простую контактную форму на фиксированной специальной странице
- Extension:EmailPage - позволяет отправлять полностью рендерированные статьи с встроенным CSS пользователям, группам или спискам контактов
- Extension:CIForms - формы с автоматической проверкой, вопросами с несколькими вариантами выбора и испытаниями клауза
- Extension:FlexForm - позволяет пользователям определять формы для создания и редактирования страниц, а также отправки электронных писем
- Расширение:QuickSurveys - опросы, появляющиеся на статьях на основе конфигурации PHP
- LimeSurvey - это может быть платная услуга, работающая на внешней среде
Формы лексемы
«Формы страниц» — это формы, расположенные либо в стандартных статьях вики, либо на специальных страницах, с помощью которых пользователи могут вводить структурированные данные для создания и/или редактирования статей вики, а также для «предзагрузки» таких статей с введенными данными. Разница по сравнению с "входной формой" заключается в том, что входное формо отправляет данные либо непосредственно на предоставленный адрес электронной почты (обычно системный администратор), либо хранит представления в базе данных, где они могут быть доступны уполномоченным пользователям. Напротив, "формы страниц" используют представления форм для заполнения стандартной статьи в вики (публично доступной на вики) с некоторыми структурированными данными. Это список расширений, реализующих эту функцию:
- Расширение:InputBox - Расширение для создания, перемещения страниц, вставки комментариев и поиска текста
- Расширение:Page Forms - Расширение для создания и редактирования страниц с шаблонами в стиле инфобокс через формы
- Extension:FlexForm - позволяет пользователям определять формы для создания и редактирования страниц, и отправки электронных писем
- Extension:Form - Расширение , которое позволяет пользователям создавать новые статьи с формой
- Extension:VisualData - полноценная система управления метаданными на основе схемы JSON, способная легко записывать, организовывать и запрашивать сбор данных на вашей вики
Пожалуйста, см. Extension:Page Forms/Related extensions для получения дополнительной информации по таким формам.
Создание/редактирование статей со структурированными данными
Некоторые статьи содержат смесь структурированных данных и текста свободной формы. Например, статья, в которой есть описание маркетингового контакта или сообщение об ошибках, обычно будет иметь набор вопросов, на которые всегда нужно ответить, чтобы создать полную статью. В этом случае может быть более подходящим форм или статья с предварительно загруженным текстом вики. Более подробная информация о данном подходе приведена в Manual:Создание страниц с предзагрузкой текста
Принимаю на себя процесс редактирования
Если вы разработчик расширения и хотите, чтобы ваше расширение перехватывало процесс редактирования, вам, возможно, стоит проверить следующие хуки:
- AlternateEdit - - Принимается на action=edit. Он дает установкам MediaWiki возможность предоставить альтернативный ответ на действие редактирования.
- EditPage::showEditForm:initial - называется, когда отображается окно текста, используемое для ввода викитекста. Он дает авторам расширений возможность определить альтернативу простому ящику редактирования. Список расширений, использующих этот крюк, см. Category:EditPage::showEditForm:initial extensions.