Шаблон:Extension
This template employs intricate features of template syntax.
Перед редактированием шаблона рекомендуется ознакомиться с его настройкой и функциями парсера. Если ваше редактирование вызывает непредвиденные проблемы, пожалуйста, отмените его быстро, так как этот шаблон может появиться на большом количестве страниц. Помните, что вы можете проводить эксперименты и должны тестировать все улучшения либо в общей песочнице, либо в своем пользовательском пространстве, прежде чем что-либо здесь менять. |
Используется Lua |
Этот шаблон использует Стили шаблонов: |
Этот шаблон следует добавлять на все страницы расширений в этой вики (но только на основные страницы). Он добавит полезную информационную карточку (см. ниже) и автоматически добавит расширение в Категория:Все расширения вместе с соответствующим статусом и типом имплементации категорий. It autofills some fields of the infobox with extension data collected by wikitech:Tool:Extjsonuploader.
Использование
Скопируйте и вставьте: {{Extension |templatemode = |name = |status = |type1 = |type2 = |hook1 = |hook2 = |newhook1 = |newhook2 = |username = |author = |description = |image = |imagesize = |version = |update = |version preview = |update preview = |compatibility policy = |mediawiki = |php = |needs-updatephp = |composer = |virtual domain = |table1 = |table2 = |license = |download = |repo = |readme = |changelog = |help = |example = |namespace = |parameters = |tags = |rights = |compatibility = |phabricator = |translate = |vagrant-role = }}Справку по значениям параметров см. ниже. |
|
Параметры содержания
В этом разделе описываются параметры, которые управляют содержимым инфобокса. Для получения помощи с templatemode и другими параметрами управления, пожалуйста, посмотрите страницу Параметры управления.
Параметр | Описание |
---|---|
name | название расширения |
status |
текущий статус релиза Один из:
Если статус отличается от вышеуказанного, он будет проигнорирован, а вместо этого в шаблоне будет отображаться значение по умолчанию — «Неизвестно». В тех случаях, когда значение отсутствует, оно будет классифицировано как неизвестное. В случаях, когда значение недействительно, оно будет помещено в специальную категорию для того, чтобы ошибка могла быть обнаружена и исправлена. |
type1 type2 type3 type4 type5 type6 | тип реализации
Стратегия(-и) реализации, используемая(-ые) при создании этого расширения. Этот параметр используется для создания категорий, которые помогают программистам найти примеры различных определённых стратегий или паттернов реализации MediaWiki. Несмотря на то, что значения этого параметра иногда совпадают со сценарием или целью использования расширений, это не обосновывает этот параметр. If the values you have chosen for this parameter do not adequately identify the purpose or possible use cases, we recommend you add additional category links as needed. Allowed values for the type1, type2, ... parameters are:
Any other value for 'type' is invalid, and will cause the extension to be placed in Category:Extensions with invalid or missing type/ru. Note: Many extensions have more than one type, if this applies to yours, replace|type= with |type1=|type2=|type3=... . You may define up to six types for an extension. |
hook1 hook2 hook3 hook4 ... |
name of each hook used by the extension
Entering values in this field is a good way to get exposure for your extension and help other developers. Each documented hook will automatically add the extension to a category listing extensions that use that hook. This category is autolinked to each hook page so that programmers can easily find examples of extensions that use a particular hook. For multiple hooks, assign the first hook to hook1, the second to hook2 and so on. |
newhook1 newhook2 newhook3 newhook4 ... newhook90 |
name of each hook provided by the extension You might also want to add the hooks to Extension hook registry. |
username | The author's username on MediaWiki.org (if they have one). May be omitted, but if present it will be used to link to the author's user & user_talk page. It should be provided without namespace and without [[]]s. |
The extension author's name, if different from their MediaWiki.org username. Free text. If omitted then the 'username' field will be used (if present). | |
description | краткое описание |
image | скриншот или логотип расширения. Это должно быть предоставлено без пространства имени и без [[]]s. |
imagesize | Необязательный, размер изображения без добавления px, например 360 (по умолчанию размер — 300px) |
version | Последняя версия |
update | Дата последнего обновления |
version preview | Preview version |
update preview | Date of the last update to the preview version |
compatibility policy | Compatibility policy (accepted values: master, main, rel, ltsrel). (backlog ) |
mediawiki | Требуемая версия MediaWiki. Most extensions should not need to use this — it defaults to the value of the 'requires' property of extension.json. Смотрите также Category:Extensions without MediaWiki version и Category:Extensions with manual MediaWiki version . |
php | требуемая версия PHP |
needs-updatephp |
Extensions that conform to MediaWiki extension standards come with a schema change script which you need to start manually (once) before starting and accessing the MediaWiki through your browser, and after you copied all the extension files to
$IP — это путь установки (или «папка») к вашей установленной копии MediaWiki, та же папка, в которой находятся LocalSettings.php , index.php , и т. д.. |
composer | The extension's Composer package name, in the standard format. It will be automatically included if set in an extension's "composer.json" file (i.e. this parameter is not required in that case). It will be linked to the extension's page on Packagist. |
virtual domain | The virtual database domain used by the extension. |
table1 table2 table3 table4 ... table30 | name of each non-core table used by the extension Links to a subpage of your extension page. For instance, "table1 = cu_changes" at Extension:CheckUser will link to Extension:CheckUser/cu_changes table . Don't list core tables such as page or revision ; only list tables that are added by extensions. |
license | License governing use of this extension, as one of the codes found in https://spdx.org/licenses/, e.g. GPL-2.0-or-later , GPL-2.0-only or GPL-3.0-or-later , etc. |
download | ссылка на скачивание : Git, {{WikimediaDownload/ru }}. |
repo | Name of the Gerrit repository the extension's code is stored in, if different from the page name. Setting this automatically sets |download= , and allows the template to automatically load data from the appropriate extension.json file. |
readme | внешняя ссылка на файл readme, например, https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README |
changelog | внешняя ссылка на файл журнала изменений, например, Extension:GeoGebra/Changelog |
help | Link to user-help for the extension. If not provided, will look for Help:Extension:ExtensionName . If provided, full wikitext link should be given (because you may want to link to e.g. an external page). |
example | Example, website or screenshot of working extension |
namespace | namespace in which this extension is used |
parameters | доступные параметры для LocalSettings.php |
Any tags your extension uses (e.g. <tag1>, <tag2>). | |
rights | Rights added by the extension. Not to be confused with the license! Rights are such as makebot or desysop , not such as GFDL or LGPL or GPL - those are licenses! |
compatibility | Additional compatibility information, for instance compatibility charts. It's encouraged to add any client-side compatibility information here too, especially when diverging from expectations of full support for a browser. |
bugzilla | Bugzilla MediaWiki extension component name |
phabricator | Название проекта в Фабрикаторе |
translate |
Optional parameter to link the exact page where (message group id with which) the extension will be translatable on translatewiki.net if enabled. If the default link is incorrect, manually set it to:
|
vagrant-role | MediaWiki-Vagrant role |
CheckUsageNameOverride | Override the page name used for the check usage link. |
Параметры управления
Параметр | Описание |
---|---|
templatemode |
Controls auto-categorisation of host page. Normally left blank. Alternate values are:
|
Использование инфобокса
Существующие страницы расширения
If you want to add the infobox to an existing page, copy and paste the code at the top of this page.
Create a new extension page
If you want to create a new extension page, enter the name below and click the button. A new page will be created with the infobox template already in place.
Разработчик, публикующий свой код в репозитории кода MediaWiki, должен ожидать:
- Feedback / Criticism / Code reviews
- Review and comments by other developers on things like framework use, security, efficiency and usability.
- Developer tweaking
- Other developers modifying your submission to improve or clean-up your code to meet new framework classes and methods, coding conventions and translations.
- Improved access for wiki sysadmins
- If you do decide to put your code on the wiki, another developer may decide to move it to the MediaWiki code repository for easier maintenance. You may then create a Учётная запись разработчика to continue maintaining it.
- Future versions by other developers
- New branches of your code being created automatically as new versions of MediaWiki are released. You should backport to these branches if you want to support older versions.
- Incorporation of your code into other extensions with duplicate or similar purposes — incorporating the best features from each extension.
- Credit
- Credit for your work being preserved in future versions — including any merged extensions.
- Similarly, you should credit the developers of any extensions whose code you borrow from — especially when performing a merger.
Any developer who is uncomfortable with any of these actions occurring should not host in the code repository. You are still encouraged to create a summary page for your extension on the wiki to let people know about the extension, and where to download it.
Enhancing this template
If you would like to improve on this template, thanks! This is a complicated template so here is some help along the way:
Кнопка создать расширение
Чтобы улучшить поведение кнопки «Создать расширение»:
- Template:Extension/Sample : Стандартное расширение, которое предварительно загружается во вновь созданные страницы.
- Template:Extension/CreateExtensionInputBox : Поле ввода, которое можно вставить в любое место, где вы хотите, чтобы пользователи могли легко создавать расширения. Для документации по тегу
<inputbox>
, посмотри пожалуйста Extension:InputBox .
Параметры инфобокса
В общем:
- To make this template easy to use, each label in the infobox is linked to documentation on the template parameter(s) it displays. If you add a parameter, please be sure to also add it to the content parameter documentation and link its label to that documentation.
To change/correct/add to the implementation type parameters:
- Check the talk page - there have been some extensive discussions about this field.
- The valid types and what they link to are defined at Module:Extension
To change the behavior of the hook parameters:
- Template:Extension/HookInUse: Adds links and categories for a hook in use. Multiple hooks in use are implemented by calling this template with Template:Foreach.
- Template:Extension/HookInUseNoCats: Used instead of Template:Extension/HookInUse when this template is used in
templatemode=nocats
. Templates used with Template:Foreach can only take one parameter so we need to wrap the call to Template:Extension/HookInUse with another template that sets the mode.
Прецедент
Посмотрите, исправны ли следующие страницы после редактирования этого шаблона.
TemplateData
TemplateData | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Это документация TemplateData для этого шаблона, используемого VisualEditor и другими инструментами. Extension An infobox for a MediaWiki extension.
|
Maintenance: vulnerabilities, archived