Jump to content

Panduan:Pengaya

From mediawiki.org
This page is a translated version of the page Manual:Extensions and the translation is 100% complete.
Languages:
Extensions:

Sebuah pengaya atau ekstensi memungkinkan Anda menyesuaikan tampilan dan cara kerja MediaWiki.

  • Pengurus sistem dapat memasang (atau menghapus) pengaya pada pemasangan MediaWiki yang mereka kelola.
  • Pengembang dapat menulis pengaya baru atau bersumbangsih ke pengaya yang ada.
Sementara beberapa pengaya dikelola oleh pengembang MediaWiki, pengaya lainnya dikembangkan oleh pihak ketiga dan mungkin tidak dikelola. Akibatnya, banyak pengaya mungkin mengandung kekutu—termasuk, dalam beberapa kasus, kerentanan keamanan. Tidak semua pengaya kompatibel dengan setiap versi MediaWiki, dan dua atau lebih pengaya tersebut mungkin tidak berfungsi dengan baik saat digunakan bersama-sama. Gunakan pengaya dengan risiko Anda sendiri, terutama yang ditandai sebagai tidak aman. Jika suatu pengaya memerlukan tambalan pada perangkat lunak inti, pastikan untuk mencadangkan pangkalan data Anda terlebih dahulu guna meminimalkan risiko kerusakan wiki Anda.

Memilih pengaya

Pengaya yang dibundel

Beberapa pengaya dibundel dengan MediaWiki sebagai standar.

Pengaya tersebut secara umum harus bermanfaat tinggi, berkinerja efisien, stabil, ditulis dengan baik, dan tidak memiliki masalah keamanan besar yang diketahui. Ini juga harus kompatibel dengan versi MediaWiki terkini, dan satu sama lain (misalnya satu pengaya tidak boleh menghalangi fungsi pengaya lainnya). Pengaya terbundel dapat memiliki kebergantungan pada satu atau beberapa pengaya lain, asalkan pengaya tersebut juga dibundel.

Pengurus situs mendapatkannya secara otomatis saat memasang atau memutakhirkan MediaWiki. Saat memutakhirkan MediaWiki, pemutakhiran pengaya apa pun akan diterapkan secara otomatis juga. Pengurus situs dapat memilih untuk menghapus pemasangan salah satu pengaya-pengaya ini, jika mereka menginginkannya.

Ada pembahasan terbuka dan berkelanjutan tentang pengaya mana yang harus menjadi bagian dari kelompok ini. Anda dapat menyarankan pengaya tambahan untuk dibundel . Pengaya akan dibundel setelah pengembang mencapai konsensus untuk melakukannya.

Suatu pengaya dapat dihapus dari pembundelan jika fungsionalitasnya digabungkan ke dalam inti MediaWiki , digantikan oleh alternatif, atau dalam kejadian yang tidak terduga, yakni ditemukannya kerentanan keamanan utama yang tidak dapat dipecahkan.

Menelusuri pengaya

Telusuri Category:All extensions , atau Kategori:Pengaya menurut kategori untuk melihat jangkauan lengkap pengaya yang tersedia.

Memeriksa pengaya yang terpasang

Pengaya mana yang aktif pada satu contoh MediaWiki dapat diperiksa dengan mengakses halaman Special:Version, dan menggulir ke bawah ke tajuk Pengaya terpasang (jangkar #mw-version-ext). Misalnya, pengaya ini dipasang di wiki ini, dan pengaya ini menyala di Wikipedia bahasa Inggris.

Pengaya populer

WikiApiary menghitung wiki tempat pengaya dipasang. Ini mewakili pemasangan sebenarnya dan bukan sekadar unduhan (yakni menanyakan API wiki), tetapi juga (per 2023) tidak sepenuhnya terkini. Itu juga tidak menghitung pemasangan pada wiki pribadi.

Memasang pengaya

Untuk panduan lebih lanjut, lihat Manual:Pengaya/Pemasangan dan pembaruan

MediaWiki siap menerima ekstensi tepat setelah pemasangan selesai. Untuk menambahkan pengaya ikuti langkah-langkah ini:

  1. Sebelum Anda mulai
    Banyak pengaya menyediakan petunjuk yang dirancang untuk pemasangan menggunakan perintah Unix. Anda memerlukan akses cangkang (SSH) untuk memasukkan perintah-perintah yang tercantum pada halaman bantuan pengaya.
  2. Unduh pengaya Anda
    Pengedar Pengaya membantu Anda memilih dan mengunduh sebagian besar pengaya populer.
    Pengaya biasanya diedarkan sebagai paket modular. Ini umumnya masuk ke subdirektorinya sendiri di $IP /extensions/. Daftar pengaya yang disimpan di repositori Git Wikimedia terletak di git:mediawiki/extensions. Beberapa pengaya tidak menggunakan kendali versi dan tidak direkomendasikan.
    Beberapa pengaya juga tersedia dalam bundel, Composer atau repositori paket.
    Disarankan untuk membaca berkas README sebelum pemasangan. Ini biasanya berisi info penting tentang konfigurasi.
  3. Pasang pengaya Anda
    Di akhir berkas LocalSettings.php , tambahkan:
    wfLoadExtension( 'ExtensionName' );
    Baris ini memaksa penafsir PHP untuk membaca berkas pengaya, dan dengan demikian membuatnya dapat diakses oleh MediaWiki.
    Beberapa pengaya dapat bertentangan dengan skrip pemeliharaan, misalnya jika pengaya tersebut langsung mengakses $_SERVER (tidak disarankan). Dalam kasus ini, pengayanya dapat dibungkus dalam kondisi sehingga skrip pemeliharaan masih dapat dijalankan.
    if ( !$wgCommandLineMode ) {
   wfLoadExtension ( 'ExtensionName' );
}
    Skrip pemeliharaan importDump.php akan gagal untuk pengaya apa pun yang memerlukan ruang nama khusus yang disertakan di dalam kondisi di atas seperti Ekstensi:Semantic MediaWiki , Extension:Page Forms .
Pastikan izin yang diperlukan telah ditetapkan untuk pengaya!
Meskipun prosedur pemasangan ini memadai untuk sebagian besar pengaya, beberapa memerlukan prosedur pemasangan yang berbeda. Periksa dokumentasi pengaya Anda untuk rincian.
Jika Anda ingin mengubah peubah konfigurasi di LocalSettings.php, Anda biasanya harus melakukannya setelah menyertakan pengaya. Jika tidak, pengaturan bawaan yang ditetapkan dalam pengaya akan menimpa pengaturan pilihan Anda.

Meningkatkan pengaya

Beberapa pengaya perlu diperbarui setiap kali Anda memperbarui MediaWiki, sementara yang lain berfungsi dengan beberapa versi. Untuk meningkatkan ke versi pengaya yang baru:

  1. Unduh versi baru pengaya
  2. Ganti semua berkas pengaya di direktori extensions/ExtensionName dengan berkas baru. Jangan hapus konfigurasi pengaya yang ada di LocalSettings.php
  3. Jika pengaya memerlukan perubahan pada pangkalan data MediaWiki, Anda perlu menjalankan skrip pemeliharaan update.php . Sebagian besar pengaya akan menyebutkan apakah skrip ini perlu dijalankan atau tidak. (Lakukan pencadangan data Anda sebelum menjalankan skrip). Jika Anda tidak memiliki akses baris perintah, Anda juga dapat menggunakan pembaru web.
Petunjuk ini mencakup 99% pengaya. Jika pengaya khusus yang Anda tingkatkan memiliki petunjuk yang berbeda dari ini, Anda mungkin harus mengikuti petunjuk khusus pengaya tersebut

Menghapus pemasangan pengaya

Hapus baris dari LocalSettings.php dengan nama pengaya untuk menghapus pemasangannya: 

wfLoadExtension( 'ExtensionName' );
  • Anda juga harus menghapus baris apa pun yang berkaitan dengan konfigurasi pengaya.

Mengembangkan pengaya

Inti MediaWiki menyediakan beberapa cara bagi pengaya untuk mengubah perilaku dan tampilan wiki. Berbagai titik pengaya memberi pengaya keluwesan untuk menambahkan fitur dan fungsionalitas, seperti menampilkan halaman khusus atau menakrifkan modul API. Untuk memulai, lihat panduan untuk mengembangkan pengaya . Sebelum menulis pengaya baru, pertimbangkan untuk bersumbangsih ke pengaya yang sudah ada atau membantu pengaya yang tak terpelihara .

Pengguna juga dapat mengajukan permintaan umum di Phabricator, dan berharap gagasan bagus Anda diterima oleh pengembang. Lihat https://phabricator.wikimedia.org/tag/mediawiki-extension-requests/

Lihat pula

Retrieved from "https://www.mediawiki.org/w/index.php?title=Manual:Extensions/id&oldid=8179872"