README

laravel package untuk memudahkan penggunaan MCA dengan Telegram Bot USDI di aplikasi Universitas Udayana.

Motivasi

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.

Persyaratan

• PHP versi >= 7.2
• Laravel versi 5.4 ke atas

Instalasi

Via Composer

composer require ristekusdi/mca-kubemq-laravel

publish config

php artisan vendor:publish --tag=config-mca-kubemq

Setting environment file untuk package ini

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=

tested

package ristekusdi/mca-kubemq-laravel sudah ditest pada laravel versi 5.5, 5.8, dan 8.0.

Penggunaan Dasar

pengiriman pesan

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');
});

debug

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');
});

format html

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');
});

setup laravel versi 5.4 kebawah

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 file mcakubemqphp.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