Pemberkasan bug dan isu

This page is a translated version of the page Filing bugs and issues and the translation is 100% complete.

Other languages:
català • ‎English • ‎español • ‎français • ‎Bahasa Indonesia • ‎italiano • ‎Nederlands • ‎português • ‎русский • ‎svenska • ‎Türkçe • ‎中文(台灣)‎

Untuk melaporkan sebuah bug ke dalam penelusur bug Joomla, sebelumnya Anda harus membuat sebuah butir penelusur. Setelah butir penelusur itu dibuat, para pengembang akan memeriksa validitasnya dan melakukan tindakan yang dianggap perlu. Jika Anda ingin membantu pengujian patch Joomla, silahkan ikuti petunjuk detail tentang bagaimana melakukannya.

Melaporkan bug

Daftar sebuah Akun di GitHub

Anda harus mendaftarkan sebuah akun di GitHub; Penelusur Isu Joomla! menggunakan akun GitHub sebagai otentikasi.

Akses ke penelusur isu Joomla!

Periksa apakah bug yang ingin Anda laporkan itu sudah pernah dilaporkan

Sekumpulan filter yang menampilkan butir-butir penelusur dapat diakses dengan mengklik tombol "Perangkat Pencarian (Search Tools)" yang ada di bagian paling atas daftar. Arahkan tetikus Anda ke butir penelusur untuk memeriksa kontennya. Apabila isu yang sedang Anda alami belum pernah dilaporkan, klik tombol "Butir Baru (New Item)" yang ada di area navigasi utama tersebut.

Sebuah layar baru akan tampil dan disana, semakin banyak informasi yang Anda berikan, maka akan semakin mudah bagi para pengembang.

Isikan data sebanyak mungkin. Anda dapat mengaktifkan tips untuk setiap kolomnya dengan mengalihkan "Mode Tampilan (View Mode)" yang ada di bagian kanan layar Pro untuk Bantuan.

  • Priority : Gunakan standar "Menengah (Medium)" kecuali Anda tahu banyak tentang pengkodean sebagai pilihan lainnya.
  • Build : Ketik disini versi yang terkena dampak isu tersebut.
  • Categories : Ini sedikit rumit. Gunakan "Administrator" bila Anda tidak tahu.
  • Title : Sebuah ringkasan singkat dari isu tersebut.
  • Description : Detail isu tersebut. Silahkan lihat bagian dibawah berikut ini untuk info lebih lengkap.
  • Uploads : Para pengguna diizinkan untuk mengunggah gambar-gambar guna melaporkan isu. Informasi seputar persyaratan unggah ada di formulir laporan.

Sediakan sebuah ringkasan

Jelaskan dengan singkat isu yang Anda miliki. Adalah sesuatu yang baik bila menggunakan butir-butir penelusur yang sudah ada sebagai contohnya bila ini adalah kali pertama Anda melaporkan sebuah bug.

Contoh:

  • Front-end: Peringatan ini dan itu.
  • Back-end: Tidak dapat menyimpan artikel ketika "namaplugin" diaktifkan.

Catatan: Perhatikan penjelasan di dalam ringkasan Anda karena ini adalah yang pertama kali dilihat oleh para pengembang ketika mereka membaca dengan teliti penelusur tersebut saat memperbaiki sesuatu.

Sediakan detail tentang bug tersebut

Untuk memberikan informasi sebanyak mungkin, penelusur mempopulasikan kolom deskripsi dengan sebuah templat yang terdiri dari lima sub-bagian.:

  • Steps to reproduce the issue (Langkah-langkah untuk mereproduksi isu) : Langkah-langkah rinci tentang bagaimana orang lain dapat menghasilkan isu yang sama.
  • Expected result (Hasil yang diharapkan) : Apa yang harus terjadi menurut Anda ketika Anda melakukan langkah diatas.
  • Actual result (Hasil yang didapatkan) : Apa yang sebenarnya terjadi ketika melakukan langkah-langkah diatas
  • System information (Informasi sistem) : Informasi seputar pengaturan atau bagaimana lingkungan sistem Anda dikonfigurasikan. Ini termasuk peramban yang Anda gunakan, versi PHP server Anda, atau jenis basisdata yang sedang Anda gunakan. Untuk hasil optimal, Anda dapat menyalin data ini dari tampilan Informasi Sistem situs Anda ketika Anda masuk ke bagian administrator.
  • Additional comments (Komentar tambahan) : Informasi tambahan apapun yang tidak diberikan diatas yang mungkin menguntungkan terhadap pemeriksaan masalah dan penyelesaian isu tersebut.

Format umumnya bisa seperti ini:

  1. "Here is exactly what I did."
  2. "This is what happened."
  3. "This is what I think should have happened."
  4. "Other information, possible solution, proposed code patch."

Semakin rinci, semakin baik. Pun, adalah sangat penting untuk memproduksi bug dengan menggunakan contoh situs web Joomla! atau dengan petunjuk yang jelas—dan mudah—tentang bagaimana menghasilkannya. Ingatlah bahwa orang lain tidak memiliki akses ke basisdata Anda, jadi Anda harus beritahukan orang lain bagaimana caranya melihat bug tersebut dengan data yang sudah tersedia apa adanya—situs contoh itu.

Contoh A

What I did 
Started with sample website. Everything was ok. I enabled "nameofplugin". Try to save any article from back end.
What happened 
I get a blank screen and article is not saved.
What should have happened 
Articles should save correctly.
Other information 
These are the plugins enabled at the same time. SEF is on (or Off). My site is in a sub-folder. I also remark that... etc. Files such and such are the issues IMHO (if you know what you are talking about).

Contoh B

What I did 
Navigate to Back-end. Click on "menu_name" Menu.
What happened
Page opened is blank.
What should have happened 
Menu should have opened correctly.
Other information 
Any other menu works OK. etc.

Contoh Nyata

  • What I did
  1. Started with the sample website.
  2. Added an unpublished article from the back end, with Section=FAQ, Category=General.
  3. In the advanced parameters for the article, set Show Title to "No" and Print, PDF, and Email Icons to "Hide".
  4. Save the article and navigate to front end. Login to the front end as admin and navigate to the Example Pages -> Category Blog menu item.
  • What happened : The newly added article shows but there is no edit icon for the front-end user to click on.
  • What should have happened : The edit icon should show, allowing a front end user to edit this article.
  • Other information : This only happens with the rhuk_milkyway template. By changing this code [code proposed] in file [name and hierarchy of file], line(s) #, the issue looks solved on my settings.

Isukan tarik permintaan langsung pada repositori GitHub Joomla!

Apabila Anda ingin mengajukan sebuah perbaikan langsung dengan menyediakan kode di Joomla! itu sendiri, Anda bisa melakukannya dengan mengisukan sebuah "pull request" (tarik permintaan) di dalam kode repositori Joomla! yang ada di GitHub.com, disini: https://github.com/joomla/joomla-cms

Proses ini mewajibkan beberapa pengetahuan terkait sistem Pengelolaan Kendali Sumber dan Git khususnya. Jika Anda tidak tahu apa itu Git SCM dan bagaimana cara kerjanya, prosesnya sangatlah sederhana:

  • Daftar sebuah akun gratis GitHub.com
  • Fork repo Joomla!
  • Beralih ke cabang "staging" (tahapan) bila Anda ingin mengajukan sebuah perbaikan terhadap rilis Joomla! 3.x saat ini atau ke cabang "3.x-dev" apabila Anda ingin mengajukan sebuah perbaikan ke Versi Joomla! 3.x berikutnya.
  • Tambah/perbarui berkas-berkas terkait yang ada di dalam Joomla! di cabang sebelah kanan dan klik tombol "review & compare" (ulas & bandingkan) - info selengkapnya tentang ini bisa dilihat di https://help.github.com/articles/using-pull-requests - untuk memulai proses pengisuan "pull request".

Tips dan Trik ekstra

Laporan bug yang ditulis dengan baik adalah sangat membantu sekali. Meskipun demikian, ada sejumlah kelebihan terkait pekerjaan sistem penelusuran bug dimanapun, jadi bantuan Anda menjaga penelusur tiket kita seberguna mungkin sangat dihargai. Secara khususnya:

  • Bacalah FAQ guna melihat kemungkinan apakah isu Anda adalah sebuah pertanyaan yang sangat terkenal.
  • Lakukanlah pencarian penelusur untuk melihat apakah isu Anda sudah pernah diberkaskan.
  • Bertanyalah sebelumnya ke forum pelaporan bug untuk Joomla 3.x jika Anda belum yakin apakah yang sedang Anda lihat itu adalah sebuah bug.
  • Tulislah laporan bug yang lengkap, dapat diproduksi, dan spesifik. Sertakan informasi sebanyak mungkin, lengkap dengan potongan kode, uji kasus, dll. Suatu contoh minimal yang menggambarkan bug dalam suatu uji kasus sederhana adalah laporan bug terbaik.
  • Jangan gunakan sistem penelusur untuk bertanya pertanyaan seputar dukungan. Gunakan forum Joomla, atau kanal IRC #joomla di freenode untuk itu.
  • Jangan gunakan penelusur untuk meminta fitur berskala besar. Kami senang bisa mendiskusikan perubahan-perubahan besar apapun terhadap inti Joomla! di forum pengembang sebelum benar-benar mengerjakannya.
  • Jangan buka kembali isu-isu yang telah ditandai sebagai "not a bug" (bukan sebuah bug). Tanda ini berarti bahwa kami telah buat keputusan bahwa kami tidak dapat atau tidak akan memperbaiki isu tersebut. Jika Anda tidak yakin mengapa, silahkan bertanya di forum pengembang.
  • Jangan gunakan penelusur untuk diskusi yang bertele-tele, karena biasanya akan tersesat. Jika sebuah butir penelusur tertentu adalah kontroversial, silahkan pindahkan diskusinya ke forum pengembang.

Melaporkan isu keamanan

Laporkan isu-isu keamanan ke security [at] joomla [dot] org. Ini khusus daftar pribadi yang terbuka untuk masa yang panjang, para pengembang Joomla! yang sangat terpercaya, dan diarsipkan untuk tidak dapat dibaca oleh umum.

Perihal kerentanan yang telah dikonfirmasikan terhadap Joomla! itu sendiri, kami akan mengambil tindakan-tindakan berikut ini:

  • Memberitahukan kepada pelapor bahwa kami telah menerima laporannya dan sebuah perbaikan akan dilakukan. Kami akan berikan sebuah tabel waktu dan meminta pelapor untuk menjaga kerahasiaan isu tersebut sampai kami mengumumkannya.
  • Menahan semua pengembangan yang lain selama waktu yang dibutuhkan untuk masa perbaikan, termasuk patch terhadap rilis-rilis terkini dan dua versi sebelumnya.
  • Menetapkan tanggal terbuka untuk umum atas pengumuman kerentanan dan perbaikannya. Mencoba untuk mengurangi kemungkinan "perlombaan persenjataan" diantara mereka yang menerapkan patch dengan mereka yang mencoba mengeksploitasi lubangnya, kami tidak akan mengumumkan masalah-masalah keamanan dengan cepat.
  • Mengumumkan secara publik atas kerentanan dan perbaikan terhadap pra-penetapan tanggal terbuka untuk umum. Ini kemungkinannya berarti bahwa sebuah rilis baru Joomla! tapi dalam beberapa kasus mungkin hanya berupa patch terhadap rilis terkini.
Advertisement