Templat:Pengembangan
This template employs intricate features of template syntax.
You are encouraged to familiarize yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages. Remember that you can conduct experiments, and should test all improvements, in either the general sandbox or your user space before changing anything here. |
Uses Lua: |
Templat ini menggunakan TemplateStyles: |
Templat ini sebaiknya ditambahkan ke semua halaman ekstensi di wiki ini (tetapi hanya di halaman utamanya). Tempat ini akan menambahkan kotak info berguna (lihat di bawah) dan menambahkan ekstensi tersebut secara otomatis ke Category:All extensions , beserta kategori status dan jenis implementasi yang sesuai. It autofills some fields of the infobox with extension data collected by wikitech:Tool:Extjsonuploader.
Penggunaan
Salin dan tempel: {{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 = }}Untuk bantuan mengenai nilai parameter, lihat di bawah. |
|
Parameter konten
Bagian ini menjelaskan parameter-parameter yang mengisi konten kotak info. Untuk bantuan mengenai templatemode dan parameter kendali lainnya, lihatlah Parameter kendali.
Parameter | Deskripsi |
---|---|
name | nama ekstensi |
status |
status rilis terkini Pilih salah satu:
Jika status yang diisi bukanlah salah satu di antara yang di atas, status yang diisi akan diabaikan dan nilai default 'Tidak diketahui' akan ditampilkan di dalam templat. Jika nilainya tidak diberikan, ekstensinya akan dikategorikan sebagai tidak diketahui. Jika nilainya tidak valid, ekstensinya akan diletakkan di kategori khusus agar galatnya bisa ditemukan dan diperbaiki. |
type1 type2 type3 type4 type5 type6 | jenis implementasi
Strategi implementasi yang diterapkan dalam membangun ekstensi ini. Parameter ini digunakan untuk membuat kategori yang membantu para pemrogram menemukan contoh berbagai strategi atau pola implementasi tertentu MediaWiki. Meskipun nilai parameter ini terkadang sama dengan kasus penggunaan atau tujuan dari ekstensi, itu bukanlah alasan untuk parameter ini. Jika nilai yang Anda pilih untuk parameter ini tidak cukup untuk mengidentifikasi tujuan atau kasus-kasus penggunaan yang mungkin, kami merekomendasikan Anda menambahkan pranala kategori tambahan yang diperlukan. Nilai yang dibolehkan untuk parameter type1, type2, ... adalah:
Any other value for 'type' is invalid, and will cause the extension to be placed in Category:Extensions with invalid or missing type/id. 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. Teks bebas. If omitted then the 'username' field will be used (if present). | |
description | deskripsi singkat |
image | tangkapan layar atau logo ekstensi. It should be provided without namespace and without [[]]s. |
imagesize | Facultative, size of the image without adding px, e.g. 360 (default size is 300px) |
version | versi terakhir |
update | tanggal pembaruan terakhir |
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 | versi MediaWiki yang dibutuhkan Most extensions should not need to use this — it defaults to the value of the 'requires' property of extension.json. See also Category:Extensions without MediaWiki version and Category:Extensions with manual MediaWiki version . |
php | versi PHP yang dibutuhkan |
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 stands for the Installation Path (or "directory") of your MediaWiki installation, the same directory that holds LocalSettings.php , index.php etc.. |
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 | tautan untuk mengunduh : Git, {{WikimediaDownload/id }}. |
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 | External link to the readme file, e.g. https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README |
changelog | External link to the changelog file, e.g. 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 | contoh, situs web atau tangkapan layar dari ekstensi yang bekerja |
namespace | ruang nama ekstensi ini digunakan |
parameters | parameter yang tersedia untuk LocalSettings.php |
tag apa saja yang ekstensi Anda pergunakan (contoh <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 | Nama proyek 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. |
Control parameters
Parameter | Deskripsi |
---|---|
templatemode |
Controls auto-categorisation of host page. Biasanya dibiarkan kosong. Nilai alternatifnya adalah:
|
Menggunakan kotak info
Halaman ekstensi yang sudah ada
Jika Anda ingin menambahkan kotak info ke halaman yang sudah ada, silakan salin dan tempel kode di atas halaman ini.
Buat sebuah halaman ekstensi baru
Jika Anda ingin membuat sebuah halaman ekstensi baru, masukkan namanya di bawah lalu tekan tombol Buat. Halaman baru akan dibuat dengan templat kotak info sudah diletakkan di tempat.
A developer sharing their code in the MediaWiki code repository should expect:
- 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 Akun pengembang 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.
Meningkatkan templat ini
Jika Anda ingin meningkatkan templat ini, terima kasih! This is a complicated template so here is some help along the way:
Tombol Buat ekstensi
To improve the create extension button behavior:
- Template:Extension/Sample : The boilerplate extension that is preloaded into newly-created pages.
- Template:Extension/CreateExtensionInputBox : An input box that can be inserted wherever you want users to easily create extensions. For documentation on the
<inputbox>
tag, please see Extension:InputBox .
Parameter kotak info
Pada umumnya:
- 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.
Kasus uji
Lihat apakah halaman berikut masih baik, setelah menyunting templat ini
TemplateData
TemplateData | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
This is the TemplateData documentation for this template used by VisualEditor and other tools. Extension An infobox for a MediaWiki extension.
|
Maintenance: vulnerabilities, archived