Templat:AdvancedSiteNotices
Perhatian: Mohon hanya tambahkan maklumat yang penting untuk diketahui komuniti, misalnya tentang perubahan besar, penyelenggaraan pelayan (server), pemilihan pengurus, mengumpul dana, dan aktiviti global lain. Jangan ulangi mesej yang sudah tertampil melalui sistem CentralNotice. Untuk mencadangkan pengumuman baru, sila ke laman perbincangan.
- Ingin menyumbang kepada Wikipedia? Lawati laman pengenalan Wikipedia, dan jadilah sukarelawan Wikipedia Bahasa Melayu!
- Perbincangan: Rencana pilihan (jadual) · Rencana baik · Gambar pilihan · Senarai pilihan · Penghapusan
- Ikuti media sosial
Wikipedia Bahasa Melayu di Facebook · Instagram · Twitter · Discord · Telegram
Ikuti media sosial
Wikimedia Malaysia di Facebook · Instagram · Twitter · Telegram (saluran) · (laman sembang) · WhatsApp (saluran) - Pelayan Discord dan Telegram untuk Wikipedia Bahasa Melayu sudah dilancarkan!
Sila sertai kami dengan memuat turun aplikasi ini pada peranti anda bagi memudahkan komunikasi!
Discord · Telegram - Anda diundang untuk menyunting di projek Wikimedia yang lain juga:
Wikikamus · 
Wikibuku · 
Wikisumber · 
Wikipetik
Wikiberita · 
Wikilayar · 
Wikiversiti
Wikidata · 
Wikispesies · 
Wikimedia Commons - Penyelia, terdapat 19 halaman yang layak untuk dihapuskan
Penggunaan
[sunting sumber]Apabila menambah pengumuman, sila letakkan pengumuman tersebut di dalam templat {{AdvancedSiteNotices/core}} pada kod sumber {{AdvancedSiteNotices}}.
Jika kod asal adalah seperti berikut:
{{AdvancedSiteNotices/core|
{{AdvancedSiteNotices/item|Selamat datang ke Wikipedia Bahasa Melayu.}}
}}
Kod selepas menambah pengumuman baharu boleh menjadi seperti berikut:
{{AdvancedSiteNotices/core|
{{AdvancedSiteNotices/item|Selamat datang ke Wikipedia Bahasa Melayu.}}
{{AdvancedSiteNotices/item|Apa khabar, dunia!}}
}}
Parameter {{AdvancedSiteNotices/item}}
[sunting sumber]{{AdvancedSiteNotices/item}} mempunyai dua parameter tanpa nama dan satu parameter bernama:
{{AdvancedSiteNotices/item|{{{1}}}|{{{2}}}|criteria=syarat}}
- Parameter pertama, iaitu
{{{1}}}, ialah parameter wajib. Parameter ini mengandungi teks pengumuman sebenar. - Parameter kedua, iaitu
{{{2}}}, ialah parameter pilihan lama untuk menentukan kumpulan pengguna sasaran melalui kelas CSS. - Parameter
criteriaialah parameter pilihan baharu untuk menentukan kumpulan pengguna sasaran melalui ungkapan syarat.
Contoh asas:
{{AdvancedSiteNotices/item|Mesej ini dipaparkan kepada semua pengguna.}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk penyelia.|criteria=in_group('sysop')}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk pengguna berdaftar.|criteria=is_named()}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk pengguna tanpa log masuk.|criteria=is_anon()}}
Parameter criteria
[sunting sumber]Parameter criteria hendaklah mengandungi ungkapan JavaScript yang sah. Atas sebab keselamatan, hanya sintaks terhad berikut disokong:
- Rentetan aksara yang dibalut dengan
'atau". Aksara lepas seperti\n,\t,\r,\b,\f,\xdan\udisokong. - Nilai Boolean, iaitu
truedanfalse. - Operator logik
&&dan||. - Operator unary
!. - Ungkapan dalam tanda kurung, contohnya
(a && b) || c. - Panggilan fungsi dalam bentuk
func(arg1, arg2). Hanya fungsi yang disenaraikan di bawah disokong.
- Fungsi yang memerlukan nilai:
in_group– menguji sama ada pengguna berada dalam salah satu kumpulan pengguna yang diberikan. Fungsi ini akan mengembalikantruejika sekurang-kurangnya satu kumpulan sepadan.in_group_every– menguji sama ada pengguna berada dalam semua kumpulan pengguna yang diberikan. Fungsi ini hanya akan mengembalikantruejika pengguna mempunyai semua kumpulan tersebut.in_lang– menguji bahasa antara muka pengguna. Fungsi ini akan mengembalikantruejika bahasa antara muka pengguna sepadan dengan salah satu nilai yang diberikan.
- Fungsi yang tidak memerlukan nilai:
**is_anon– menguji sama ada pengguna ialah pengguna tanpa log masuk. **is_temp– menguji sama ada pengguna ialah pengguna akaun sementara. **is_named– menguji sama ada pengguna ialah pengguna berdaftar.
Contoh penggunaan criteria:
{{AdvancedSiteNotices/item|Mesej ini hanya untuk penyelia.|criteria=in_group('sysop')}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk penyelia antara muka.|criteria=in_group_every('sysop', 'interface-admin')}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk pengguna yang menggunakan antara muka Bahasa Melayu.|criteria=in_lang('ms')}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk pengguna berdaftar.|criteria=is_named()}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk pengguna tanpa log masuk.|criteria=is_anon()}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk pengguna akaun sementara.|criteria=is_temp()}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk penyelia yang menggunakan antara muka Bahasa Melayu.|criteria=in_group('sysop') && in_lang('ms')}}
{{AdvancedSiteNotices/item|Mesej ini dipaparkan kepada penyelia atau penyelia antara muka.|criteria=in_group('sysop', 'interface-admin')}}
{{AdvancedSiteNotices/item|Mesej ini dipaparkan kepada pengguna berdaftar, tetapi bukan penyelia.|criteria=is_named() && !in_group('sysop')}}
Perhatian: in_group('sysop', 'interface-admin') bermaksud pengguna berada dalam sekurang-kurangnya salah satu kumpulan tersebut. Sebaliknya, in_group_every('sysop', 'interface-admin') bermaksud pengguna mesti berada dalam kedua-dua kumpulan tersebut.
Parameter kedua lama
[sunting sumber]Jika parameter criteria tidak diisi, sistem akan menggunakan parameter kedua, iaitu {{{2}}}, untuk menentukan kumpulan pengguna sasaran.
Parameter kedua lama boleh menggunakan beberapa kelas berikut. Beberapa kelas boleh digabungkan dengan ruang kosong.
only_sysop– hanya dipaparkan kepada penyelia.only_loggeddanonly_logged_in– hanya dipaparkan kepada pengguna berdaftar.is_named– hanya dipaparkan kepada pengguna berdaftar.only_anondanonly_logged_out– hanya dipaparkan kepada pengguna yang tidak log masuk.is_anon– hanya dipaparkan kepada pengguna tanpa log masuk.is_temp– hanya dipaparkan kepada pengguna akaun sementara.
Sintaks parameter kedua lama masih disokong untuk keserasian lama, tetapi penggunaan criteria adalah lebih disarankan kerana ia lebih jelas dan lebih fleksibel.
Contoh lama:
{{AdvancedSiteNotices/item|Mesej ini hanya untuk penyelia.|only_sysop}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk pengguna berdaftar.|only_logged}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk pengguna tanpa log masuk.|only_anon}}
Contoh baharu yang disarankan:
{{AdvancedSiteNotices/item|Mesej ini hanya untuk penyelia.|criteria=in_group('sysop')}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk pengguna berdaftar.|criteria=is_named()}}
{{AdvancedSiteNotices/item|Mesej ini hanya untuk pengguna tanpa log masuk.|criteria=is_anon()}}
Perhatian
[sunting sumber]- Sila hanya tambahkan pengumuman yang mustahak untuk diketahui oleh komuniti, seperti perubahan besar, penyelenggaraan pelayan, pemilihan penyelia/birokrat/pemeriksa, undian komuniti, aktiviti Wikimedia, dan pengumuman teknikal yang berkaitan.
- Jangan ulangi mesej yang sudah dipaparkan melalui sistem CentralNotice.
- Jika pengumuman mengandungi templat lain yang boleh berubah secara automatik tanpa suntingan baharu, seperti kira detik atau statistik langsung, anda mungkin perlu membersihkan cache laman ajax supaya kandungan baharu dipaparkan. Untuk membersihkan cache, sila gunakan pautan nyahcache ini.
- Untuk melihat sifat paparan pengumuman semasa, sila gunakan Templat:AdvancedSiteNotices/viewer jika laman tersebut tersedia.
- Oleh sebab pengumuman ini dipaparkan kepada ramai pengguna, laman templat berkaitan sebaiknya dilindungi. Pengguna yang ingin mencadangkan pengumuman baharu boleh menggunakan laman perbincangan templat.