laravel package untuk memudahkan penggunaan MCA dengan Telegram Bot USDI di aplikasi Universitas Udayana.
Proyek ini berfungsi sebagai library untuk mengirim pesan MCA melalui KubeMQ dan secara teknis mengurangi developer untuk menuliskan sintaks curl di PHP ketika memenuhi kebutuhan intern aplikasi Universitas Udayana, di samping juga memudahkan untuk menambahkan fitur tambahan atau menyesuaikan fitur di package MCA.
- PHP versi >= 7.2
- Laravel versi 5.4 ke atas
Via Composer
composer require ristekusdi/mca-kubemq-laravel
php artisan vendor:publish --tag=config-mca-kubemq
untuk pengaturan di bagian ini, sesuaikan dengan setting KUBEMQ yang sudah di sediakan oleh admin. buka file .env
dan tambahkan di bawah ini
MCAKUBEMQ_ADDRESS=
MCAKUBEMQ_PORT=
MCAKUBEMQ_CLIENTID=
MCAKUBEMQ_CHANNEL=
package ristekusdi/mca-kubemq-laravel
sudah ditest pada laravel versi 5.5, 5.8, dan 8.0.
untuk contoh pengiriman pesan ke MCA telegram dibutuhkan oarameter idsso, pesan
<?php
use Illuminate\Support\Facades\Route;
use Ristekusdi\McaKubemqLaravel\Facades\Messagemcakube;
Route::get('/', function () {
return view('welcome');
});
Route::get('/send-message', function () {
Messagemcakube::sendMessage(32018000182, 'ristek usdi');
return view('welcome');
});
untuk men-debug pesan yang di kirim pertu di tambahkan parameter ke-3 berupa boolean(true), default debug adalah false. berikut contohnya.
<?php
use Illuminate\Support\Facades\Route;
use Ristekusdi\McaKubemqLaravel\Facades\Messagemcakube;
Route::get('/', function () {
return view('welcome');
});
Route::get('/send-message', function () {
$debug = Messagemcakube::sendMessage(32018000182, 'ristek usdi', true);
echo $debug;
return view('welcome');
});
mengirim pesan dengan format HTML
<?php
use Illuminate\Support\Facades\Route;
use Ristekusdi\McaKubemqLaravel\Facades\Messagemcakube;
Route::get('/', function () {
return view('welcome');
});
Route::get('/send-message', function () {
$message = '[SIRAISA]
Ada surat masuk dari Rektor
DETAIL SURAT
<strong>Perihal:</strong>
BERITA ACARA SERAH TERIMA BARANG MILIK NEGARA KONOHA
<strong>Sifat surat:</strong> Biasa
<strong>Tgl. Surat:</strong> 09-11-2020
<strong>LAMPIRAN FILE</strong>
<a href="https://siraisa.unud.ac.id/uploads/surat-keluar/example.pdf">B_UN14_PL_2020_1607569648</a>';
Messagemcakube::sendMessage(32018000182, $message);
return view('welcome');
});
untuk penggunaan di laravel versi 5.4 kebawah perlu perlu di lakukan secara manual
- composer require ristekusdi/mca-kubemq-laravel
- buka file config/app.php
- tambahkan McaKubemqLaravelServiceProvider di bagian providers
/*
* Package Service Providers...
*/
Ristekusdi\McaKubemqLaravel\McaKubemqLaravelServiceProvider::class,
/*
- tambahkan juga alias di bagian list aliases
'Messagemcakube' => \Ristekusdi\McaKubemqLaravel\Facades\Messagemcakube::class,
- di dalam forlder
config
tambahkan filemcakubemqphp.php
- isikan dengan config seperti ini
<?php
return array(
'address' => env('MCAKUBEMQ_ADDRESS', '172.0.0.1'),
'port' => env('MCAKUBEMQ_PORT', '172.0.0.1'),
'clientid' => env('MCAKUBEMQ_CLIENTID', 'default'),
'channel' => env('MCAKUBEMQ_CHANNEL', 'default'),
);
-
tambahkan .env file seperti cara sebelumnya
-
jalankan perintah di terminal
php artisan cache:clear
php artisan config:clear
composer dump-autoload
- kirimkan pesan sesuai contoh sebelumnya
- selesai