J3.x

Pasang Dari Web (Untuk Developer)

From Joomla! Documentation

This page is a translated version of the page J3.x:Install From Web (For Developers) and the translation is 100% complete.
Other languages:
Bahasa Indonesia • ‎English • ‎Nederlands • ‎español • ‎français • ‎русский
Joomla! 
≥ 3.2
versi

Joomla! 3.2 memperkenalkan fitur baru Pasang Dari Web yang memberikan kemampuan pemasangan langsung ekstensi-ekstensi yang terdaftar di JED. Menjadikan ekstensi Anda terdaftar di JED untuk dipasang dari web adalah dua langkah proses:

  1. Isi dua kolom baru di JED
  2. Sesuaikan situs Anda

Isi dua kolom baru di JED

Install from Web JED Listing-id.png

Jika Anda mengedit ekstensi Anda yang terdaftar di JED maka Anda akan melihat dua kolom baru.

Yang pertama adalah Jenis Unduh, dimana Anda dapat memilih jenis unduh ekstensi Anda dari empat opsi yang disediakan:

  1. Tidak ada
  2. Tautan Unduh Langsung Gratis:
  3. Gratis tapi Wajib Daftar pada Tautan:
  4. Pembelian Komersial Wajib pada Tautan:

Kolom kedua adalah URL Unduh/pendaftaran/pembelian dan dapat mengandung salah satu URL berikut:

  1. Sebuah URL zip, contoh http://www.example.com/updates/com_extension_v9.9.zip
  2. Sebuah URL XML perbaru, contoh http://www.example.com/updates/extension_update.xml

Mohon dicatat: tembolok fitur "Pasang dari Web" pada server diatur untuk 2-6 jam sehingga Anda mungkin tidak akan melihat perubahan langsung di backend Joomla.

Kalau ekstensi Anda berupa tautan unduh langsung maka semua pekerjaan Anda telah selesai dan Anda bisa abaikan langkah kedua.

Berikut detail jenis unduh selengkapnya.

Tidak ada

Ini apa yang biasa ditemukan sekarang, dan itu artinya adalah Anda tidak dapat atau tidak ingin menyediakan URL pasang langsung untuk ekstensi Anda. Hanya saja, kolom JED wajib diisi, dan kolom "Pasang dari Web" tetap dikosongkan.

Ketika seorang pengguna pergi ke backend mereka dan mengklik tab "Pasang dari Web", ekstensi Anda ditemukan, tombol "Unduh" ditampilkan tapi tidak ada tombol "Pasang".

Tautan Unduh Langsung Gratis

Ini adalah opsi yang dipilih kalau ekstensi Anda tersedia dengan bebas, tanpa perlu pendaftaran atau pembelian. Pada "URL Unduh/pendaftaran/pembelian" Anda harus meletakkan URL XML perbaru atau URL berkas zip langsung.

Ketika seorang pengguna pergi ke backend mereka dan mengklik tab "Pasang dari Web", ekstensi Anda ditemukan dan tombol "Pasang" muncul, sehingga mereka bisa langsung mengkliknya untuk memasang ekstensi Anda.

Gratis tapi Wajib Daftar pada Tautan

Ini adalah opsi yang dipilih kalau ekstensi Anda memerlukan pendaftaran sebelum diunduh. Pada "URL Unduh/pendaftaran/pembelian" Anda harus meletakkan URL Halaman Pendaftaran situs Anda.

Ketika seorang pengguna pergi ke backend mereka dan mengklik tab "Pasang dari Web", ekstensi Anda ditemukan dan tombol "Pasang" muncul; ketika pengguna itu mengklik tombol pasang, maka dia akan dialihkan ke halaman pendaftaran di situs Anda.

Kalau Anda menyetel situs Anda dengan benar (lihat Langkah 2 dibawah) maka setelah berhasil mendaftar pengguna akan dialihkan kembali ke situs mereka untuk menyelesaikan pasang dari web.

Pembelian Komersial Wajib pada Tautan

Ini adalah opsi yang dipilih kalau ekstensi Anda mewajibkan pembelian sebelum bisa diunduh. Pada "URL Unduh/pendaftaran/pembelian" Anda harus meletakkan URL Halaman Pembelian ekstensi Anda.

Ketika seorang pengguna pergi ke backend mereka dan mengklik tab "Pasang dari Web", ekstensi Anda ditemukan dan tombol "Pasang" muncul; ketika pengguna tersebut mengklik tombol pasang, dia akan dialihkan ke halaman pembelian di situs Anda.

Kalau Anda menyetel situs Anda dengan benar (lihat Langkah 2 dibawah) maka setelah pembelian berhasil dilakukan pengguna akan dialihkan kembali ke situs mereka untuk menyelesaikan pasang dari web.

[Bagaimana dengan berlangganan? Apakah lebih ke "berbasis-pendaftaran" atau "berbasis-komersial"?]

Menyetel situs Anda

Seperti disebutkan sebelumnya, kalau ekstensi Anda tersedia dengan bebas tanpa harus melakukan pendaftaran atau pembelian, Anda tidak perlu melakukan apa-apa lagi, maka lewati langkah ini.

Menyetel situs dan ekstensi Anda untuk Ekstensi -Gratis tapi Wajib Daftar pada Tautan

Apabila Anda mewajibkan seorang pelanggan untuk mendaftar maka Anda harus menyetel situs Anda untuk berurusan dengan pendaftaran pengguna.

Jika tidak, maka ketika pengguna mengisi pendaftaran tersebut, langkah terakhir pemasangan web TIDAK akan selesai.

Bagaimana pemasangan web bekerja

Ketika pengguna mengklik tombol 'Pasang', maka Joomla! akan mengirimkan parameter-parameter berikut:

  1. installat, contoh http://client.domain.com/administrator/index.php?option=com_installer&view=install
  2. installapp, contoh 99999

installat adalah URL kembalian, dan installapp adalah ID ekstensi JED.

Untuk mengisi langkah pemasangan web, backend Anda harus menerima parameter-parameter berikut, proses pendaftaran, dan kembali ke URL installat.

Sementara pendaftaran diisi dan diproses, Joomla! mengharapkan untuk menerima URL zip atau sebuah URL XML perbaru. Saat sudah diterima, Joomla! akan menyelesaikan pemasangannya.

Pemasangan web dengan jefreg-plugin

jefreg-plugin adalah implementasi referensi. Sebuah langkah awal yang baik yang dikembangkan secara khusus untuk tujuan ini dapat ditemukan disini.

Plugin tersebut memiliki dua parameter:

  1. Berkas untuk diunduh
  2. Entri URL

Dalam parameter Berkas untuk Diunduh, parameter pertama yang harus Anda atur adalah mengarahkan plugin itu ke berkas XML perbaru ekstensi Anda, berkas zip atau skrip (satu per baris).

99999=>http://www.example.com/updates/com_extension_v9.9.zip

30458=>http://www.example.com/updates/extension_update.xml

77777=>http://www.example.com/updates/download.php

Apabila barisnya dimulai dengan sebuah tanda bintang [*], maka akan diabaikan dan ditinggalkan untuk dikendalikan oleh plugin yang mendukung pengunduhan paska pembayaran diterima. Contoh plugin seperti itu bisa ditemukan pada cabang repositori yang disebutkan diatas.

Tentang Entri URL: plugin ini secara khusus dibuat untuk Komponen Pengguna Joomla! (nilai standarnya index.php?option=com_users&view=login) namun juga bisa berintegrasi dengan baik dengan halaman pendaftaran apapun. Contohnya, dalam kasus Community Builder yang hanya mengubah entri poin URL di dalam parameter pluginnya - secara umum direkomendasikan (tapi tidak diharuskan) untuk mengarahkannya ke halaman masuk (login) Anda. Catatan: sebuah nilai parameter yang kosong akan secara standar mengarah ke halaman Masuk (Login) Komponen Pengguna Joomla!.

Bagaimana membangun jefreg-plugin

  1. Unduh berkasnya dari github
  2. Salin berkas bahasa ke dalam direktori plugin sistem
  3. Zip semua berkas, dan pasang melalui Pengelolaan Ekstensi

Mengatur situs dan ekstensi Anda untuk Ekstensi Komersial

Ini akan memerlukan kerja ekstra daripada langkah sebelumnya. Disarankan Anda mengunduh plugin yang sama - namun Anda harus periksa ulang ketika mengintegrasikannya ke plugin untuk melihat apakah pengguna telah membeli ekstensi Anda. Disebabkan ekstensi yang berbeda mengimplementasikan hal ini dengan cara yang berbeda pula maka tergantung para pengembang ekstensi untuk mengimplementasikan fungsi ini.

Plugin tersebut dapat dipakai untuk memanggil parameter installat dan installapp, tapi plugin itu TIDAK boleh mengembalikan URL zip atau URL XML perbaru onUserLogin. Ketika pembelian telah dilengkapi, pengoperasian dapat dikembalikan untuk mengisi pemasangan web.

Kode sumber untuk masa yang akan datang

Anda dapat berkontribusi memperbaiki bugs dan menambah fitur-fitur baru ke repositori berikut ini: