J3.x

Membuat sebuah modul sederhana/Menambahkan Update Otomatis

From Joomla! Documentation

< J3.x:Creating a simple module
This page is a translated version of the page J3.x:Creating a simple module/Adding Auto Update and the translation is 100% complete.

Other languages:
English • ‎español • ‎français • ‎Bahasa Indonesia • ‎Nederlands
Joomla! 
3.x
Tutorial
Membuat sebuah modul sederhana

Ini adalah sebuah multi seri artikel tentang bagaimana caranya membuat sebuah modul untuk Joomla! Versi Joomla 3.x. Anda dapat menavigasikan artikel-artikel di dalam seri ini dengan menggunakan menu dropdown navigasi.

Mulai dengan Pendahuluan, dan navigasikan artikel di dalam seri ini dengan menggunakan tombol navigasi yang ada pada bagian bawah atau kotak di sebelah kanan (Artikel dalam seri ini).



Bagian dari tutorial ini akan membantu Anda dalam membuat sebuah server update agar modul bisa memanfaatkan sistem upgrade-sekali-klik.

Pendahuluan & Pra-membaca

Yang harus dilakukan pertama kali adalah membaca tutorial Mengelola Komponen Upgrade Joomla 2.5 - Bagian 1 untuk memberikan gambaran bagaimana proses upgrade itu bekerja di dalam Joomla. Meskipun ditulis untuk 2.5, prosesnya tidak berubah untuk Joomla 3.x. Baca juga Deploy sebuah server update - inilah yang akan kita implementasikan di dalam tutorial ini..

Masih ingatkah Anda tentang berkas update sql yang disebutkan di bagian Menggunakan database? Itu masih terpakai untuk memperbarui database kita. Ditambah, sebuah versi zip modul baru yang akan digunakan untuk memperbarui semua berkas php yang ada. Untuk tetap menyederhanakannya, sekarang kita akan memperbarui berkas-berkas dan database sql tanpa melakukan pemeriksaan versi Joomla dan versi modul yang sedang terpasang (direkomendasikan untuk modul produksi).

Memperbarui modul kita

Satu-satunya cara untuk memperbarui modul-modul yang ada adalah menambahkannya ke dalam berkas xml.

<updateservers>
	<server type="extension" name="Helloworld" priority="1">http://www.example.com/helloworld_update.xml</server>
</updateservers>

Sekarang, Joomla! akan mencari http://www.example.com/helloworld_update.xml untuk pembaruan-pembaruan yang memiliki aturan frekuensi tertentu di dalam opsi pengelolaan ekstensi.

Membuat sebuah pembaruan

Joomla sedang mencari pembaruan-pembaruan ekstensi kita - sekarang, mari kita buat pembaruannya untuk menguji prosesnya.

Salinlah sebuah modul. Update nomor versinya ke 1.0.1, dan tambahkan sesuatu ke dalam berkas Update SQL-nya - dalam contoh ini, sebuah tambahan berkas Bahasa Jerman.

<version>1.0.1</version>
INSERT INTO `#__helloworld` (`hello`, `lang`) VALUES ('Hallo Welt', 'de-DE');

Ingat, kita juga dapat menyunting berkas-berkas php yang ada - semua berkas php yang ada akan diubah oleh satu berkas update (Catatan. Inilah alasan mengapa meretas ekstensi inti itu tidak dianjurkan - ia akan hilang bilamana terdapat sebuah update ekstensi).

Sekarang, kita harus buat berkas xml-nya di http://www.example.com/helloworld_update.xml untuk memberitahu Joomla bahwa terdapat sebuah pembaruan yang kini tersedia.

<updates>
	<update>
		<name>Helloworld</name>
		<description>This is mod_helloworld 1.0.1</description>
		<element>mod_helloworld</element>
		<type>module</type>
		<version>1.0.1</version>
		<downloads>
			<downloadurl type="full" format="zip">http://www.example.com/mod_helloworld_101.zip</downloadurl>
		</downloads>
		<maintainer>Joomla</maintainer>
		<maintainerurl>http://www.example.com</maintainerurl>
		<targetplatform name="joomla" version="3.6"/>
		<client>site</client>
	</update>
</updates>

dimana http://www.example.com/mod_helloworld_101.zip adalah folder zip dari update yang baru saja kita buat. Bila sekarang Anda masuk ke backend Joomla Anda, maka di sana akan terlihat sebuah update otomatis yang kini telah tersedia (bila tidak ada, maka Anda perlu membersihkan cache yang terdapat di bagian update di dalam pengelolaan ekstensi). Klik saja update (atau, teksnya mungkin, perbarui) dan Anda akan temukan modul yang baru saja diperbarui ke versi 1.0.1 tersebut.

Catatan. Ingat, dalam contoh ini, tagar update adalah spesifik untuk Joomla Versi 3.6 dan ia tidak akan dikenali oleh versi yang lama maupun selanjutnya. Lihat bagian Deploy sebuah Server Update untuk mengetahui tagar update secara lebih mendalam, dan yang paling penting adalah targetplatform.

Modul Komersial

Ingat, berkas-berkas kita telah tertaut ke berkas xml pembaruan ekstensi. Dan dari berkas xml tersebut kita memiliki sebuah lokasi dimana folder zip modulnya berada. Ini artinya, bila seseorang mencarinya maka ia akan menemukan sumber fisik zip modul Anda (yang tersedia/dapat digunakan setelah sebuah berlangganan diatur menjadi kadaluwarsa, dsb). Karena itu, biasanya modul-modul komersial tidak memiliki pembaruan otomatis (alih-alih menginformasikannya lewat cara yang lain).

Kesimpulan

Memperbarui modul-modul dalam Joomla adalah sangat mudah, baik bagi para pengguna maupun para pengembang ekstensinya, ini adalah sangat mudah dilakukan dan harus menjadi standar modul sejak Joomla! 3.1.