Templat:Pengaya
| Templat ini mempekerjakan fitur-fitur rumit dari sintaks templat.
Anda disarankan untuk membiasakan diri dengan penyetelan dan fungsi pengurai-nya sebelum menyunting templat ini. Jika suntingan Anda menyebabkan masalah tak terduga, harap batalkan suntingan tersebut dengan cepat, karena templat ini mungkin muncul di banyak halaman. Ingatlah bahwa Anda dapat melakukan uji coba, dan harus menguji semua peningkatan, baik di bak pasir umum atau ruang pengguna Anda sebelum mengubah apa pun di sini. |
| Uses Lua: |
| Templat ini menggunakan TemplateStyles: |
Templat ini sebaiknya ditambahkan ke semua halaman pengaya di wiki ini (tetapi hanya di halaman utamanya). Tempat ini akan menambahkan kotak info berguna (lihat di bawah) dan menambahkan pengaya tersebut secara otomatis ke Category:All extensions, beserta kategori status dan jenis penerapan yang sesuai. Templat mengisi otomatis beberapa bidang kotak info dengan data pengaya yang dikumpulkan oleh wikitech:Tool:Extjsonuploader.
Penggunaan
|
Salin dan tempel: {{Extension |templatemode =
|name =
|status =
|type1 =
|type2 =
|hook1 =
|hook2 =
|newhook1 =
|newhook2 =
|username =
|author =
|maintainer =
|description =
|image =
|imagesize =
|version =
|update =
|version preview =
|update preview =
|compatibility policy =
|mediawiki =
|php =
|needs-updatephp =
|composer =
|virtual domain =
|table1 =
|table2 =
|license =
|download =
|show-popularity =
|repo =
|readme =
|changelog =
|help =
|example =
|namespace =
|parameters =
|tags =
|rights =
|compatibility =
|phabricator =
|translate =
|vagrant-role =
}}
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Parameter isi
Bagian ini menjelaskan parameter yang mengatur isi kotak info. Untuk bantuan mengenai templatemode dan parameter kendali lainnya, lihatlah Parameter kendali.
| Parameter | Deskripsi |
|---|---|
| name | nama pengaya |
| status |
status keluaran terkini Salah satu:
Jika status yang diisi bukanlah salah satu di antara yang di atas, status yang diisi akan diabaikan dan nilai bawaan 'Tak diketahui' akan ditampilkan dalam templat. Jika nilainya dihilangkan, maka akan dikategorikan sebagai tak diketahui. Jika nilainya tidak valid, ekstensinya akan diletakkan di kategori khusus agar galatnya bisa ditemukan dan diperbaiki. |
| type1 type2 type3 type4 type5 type6 | jenis penerapan
Strategi penerapan yang diterapkan dalam membangun pengaya ini. Parameter ini digunakan untuk membuat kategori yang membantu para pemrogram menemukan contoh berbagai strategi atau pola penerapan tertentu MediaWiki. Meskipun nilai parameter ini terkadang sama dengan kasus penggunaan atau tujuan dari pengaya, 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 menyarankan Anda menambahkan pranala kategori tambahan yang diperlukan. Nilai yang dibolehkan untuk parameter type1, type2, ... adalah:
Nilai lain untuk 'type' tidak sah, dan akan menyebabkan pengaya ditempatkan di Category:Extensions with invalid or missing type/id. Catatan: Banyak pengaya punya lebih dari satu jenis, jika ini berlaku untuk pengaya Anda, ganti|type= dengan |type1=, |type2=, |type3=… Anda dapat menakrif hingga enam jenis untuk sebuah pengaya. |
| hook1 hook2 hook3 hook4 ... hook90 |
nama tiap pengait yang digunakan oleh pengaya
Memasukkan nilai di bidang ini adalah cara yang baik untuk meningkatkan keterlihatan pengaya Anda dan membantu pengembang lain. Setiap pengait yang didokumentasikan akan secara otomatis menambahkan pengaya ke dalam kategori yang mencantumkan pengaua yang menggunakan pengait tersebut. Kategori ini secara otomatis tertaut ke setiap halaman pengait sehingga para pemrogram dapat dengan mudah menemukan contoh pengaya yang menggunakan pengait tertentu. Untuk pengait lebih daei satu, tetapkan hook pertama ke hook1, hook kedua ke hook2 dan seterusnya. |
| newhook1 newhook2 newhook3 newhook4 ... newhook90 |
nama setiap pengait yang disediakan oleh pengaya Anda mungkin juga ingin menambahkan pengaya ke Extension hook registry. |
| username | Nama pengguna penulis di MediaWiki.org (jika mereka memilikinya). Boleh dihilangkan, tetapi jika ada akan digunakan untuk menghubungkan ke halaman pengguna dan halaman pembicaraan pengguna penulis. Seharusnya disediakan tanpa ruang nama dan tanpa [[]]. |
| Nama pengarang pengaya, bila berbeda dari nama pengguna Mediawiki.org mereka. Teks bebas. Bila dihilangkan maka bidang 'nama pengguna' akan digunakan (bila ada). | |
| maintainer | Pemelihara pengaya saat ini. Boleh dihilangkan, tetapi bila ada akan digunakan untuk menautkan ke laman pengguna & pembicaraan pengguna si pemelihara, bila laman pengguna ada. Seharusnya disediakan tanpa ruang nama dan tanpa [[]]. |
| description | deskripsi singkat |
| image | tangkapan layar atau logo ekstensi. Seharusnya disediakan tanpa ruang nama dan tanpa [[]]. |
| imagesize | Fakultatif, ukuran gambar tanpa menambah px, misal 360 (ukuran bawaan yaitu 300px) |
| version | versi terakhir |
| update | tanggal pembaruan terakhir |
| version preview | Versi pratayang |
| update preview | Tanggal pembaruan terakhir untuk versi pratayang |
| compatibility policy | Kebijakan kompatibilitas (nilai yang disetujui: master, main, rel, ltsrel). (log tunggakan) |
| mediawiki | versi MediaWiki yang dibutuhkan Kebanyakan pengaya seharusnya tak perlu menggunakan ini — secara bawaan nilainya adalah nilai properti requires dari extension.json. Lihat pula Category:Extensions without MediaWiki version dan Category:Extensions with manual MediaWiki version. |
| php | versi PHP yang dibutuhkan |
| needs-updatephp |
Pengaya yang sesuai dengan standar pengaya MediaWiki dilengkapi dengan skrip perubahan skema yang perlu Anda jalankan secara manual (sekali) sebelum memulai dan mengakses MediaWiki melalui peramban Anda, dan setelah Anda menyalin semua berkas pengaya ke
$IP stands for the Installation Path (or "directory") of your MediaWiki installation, the same directory that holds LocalSettings.php, index.php etc.. |
| composer | Nama paket Composer pengaya, dalam format baku. Akan disertakan secara otomatis jika diatur dalam berkas composer.json ekstensi (yakni parameter ini tak diperlukan dalam kasus itu). Akan ditautkan ke laman pengaya pada Packagist. |
| virtual domain | Domain pangkalan data virtual yang digunakan oleh pengaya. |
| 'table1 table2 table3 table4 ... table20 | nama dari tiap tabel non-inti yang digunakan oleh pengaya Tautan ke sublaman dari laman pengaya Anda. Misalnya, "table1 = cu_changes" di Extension:CheckUser akan mengarah ke Extension:CheckUser/cu_changes table. Jangan cantumkan tabel inti seperti page atau revision; hanya cantumkan tabel yang ditambahkan oleh pengaya. |
| license1 license2 license3 license4 license5 license-alt |
Lisensi yang mengatur penggunaan pengaya ini, sebagai salah satu kode yang terdapat dalam $url, misalnya GPL-2.0-or-later, GPL-2.0-only atau GPL-3.0-or-later, dll.
Optionally, use If the extension comprises several components that are each licensed under different terms, you're strongly encouraged to give the specifics in the main text. |
| download | tautan untuk mengunduh : Git, {{WikimediaDownload/id}}. |
| show-popularity | Enable/disable popularity fields (Quarterly downloads and Public wikis using the extension) based on Template:Extension/popularity.json, which may not reflect real usage |
| repo | Nama repositori Gerrit tempat kode pengaya disimpan, jika berbeda dari nama laman. Mengatur ini secara otomatis mengatur |download=, dan memungkinkan templat untuk secara otomatis memuat data dari berkas extension.json yang sesuai. |
| readme | Tautan luar ke berkas README, misal https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README |
| changelog | Tautan luar ke berkas log perubahan, misal Extension:GeoGebra/Changelog. |
| help | Tautan ke bantuan pengguna untuk pengaya. Bila tak disediakan, akan mencari Help:Extension:ExtensionName. BIla disediakan, tautan teks wiki penuh seharusnya diberikan (karena Anda mungkin ingin menautkan ke misal suatu halaman luar). |
| 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 | Hak-hak yang ditambahkan pengaya. Jangan disamakan dengan lisensi! Hak-hal yaitu semacam $makebot atau $desysop, bukan semacam GFDL atau LGPL atau GPL - itu adalah lisensi! |
| compatibility | Informasi kompatibilitas tambahan, misalnya bagan kompatibilitas. Disarankan untuk menambahkan informasi kompatibilitas sisi kelayan di sini juga, terutama ketika menyimpang dari harapan dukungan penuh untuk peramban. |
| bugzilla | Nama komponen ekstensi MediaWiki Bugzilla |
| phabricator | Nama proyek Phabricator |
| translate |
Parameter opsional untuk menautkan halaman persis tempat (ID kelompok pesan yang dengannya) pengaya akan dapat diterjemahkan di translatewiki.net bila dinyalakan. Bila tautan bawaan salah, atur secara manual menjadi:
|
| vagrant-role | Peran MediaWiki-Vagrant |
| CheckUsageNameOverride | Mengesampingkan nama halaman yang digunakan untuk mengecek penggunaan tautan. |
Parameter kendali
| Parameter | Deskripsi |
|---|---|
| templatemode |
Mengendalikan pengategorian otomatis halaman hos. 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! Templat ini agak rumit, jadi berikut beberapa bantuan yang mungkin mempermudah kemajuan:
Tombol Buat ekstensi
Untuk memperbagus tingkah tombol buat pengaya:
- Template:Extension/Sample: Pengaya boilerplate yang dimuat sebelumnya ke halaman yang baru dibuat.
- Template:Extension/CreateExtensionInputBox: Kotak masukan yang dapat disisipkan di mana pun Anda ingin pengguna membuat pengaya dengan mudah. Untuk dokumentasi tentang tanda
<inputbox>, harap lihat Extension:InputBox.
Parameter kotak info
Pada umumnya:
- Agar templat ini mudah digunakan, setiap label di kotak info ditautkan ke dokumentasi parameter templat yang ditampilkannya. Jika Anda menambahkan parameter, pastikan juga untuk menambahkannya ke dokumentasi parameter isi dan menautkan labelnya ke dokumentasi tersebut.
Untuk mengubah/meralat/menambahkan parameter jenis penerapan:
- Periksa halaman pembicaraan - telah ada beberapa perbincangan meluas tentang bidang ini.
- Jenis yang absah dan apa yang hal ini tautkan ke didefinisikan pada 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
