Download the PHP package laravolt/mural without Composer
On this page you can find all versions of the php package laravolt/mural. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download laravolt/mural
More information about laravolt/mural
Files in laravolt/mural
Package mural
Short Description Laravel comment stream
License MIT
Homepage https://github.com/laravolt/mural
Informations about the package mural
Laravolt Mural
Laravolt Mural bertujuan menyediakan fitur komentar yang siap dipakai dan mudah diintegrasikan ke dalam aplikasi berbasis Laravel.
Package ini masih dalam tahap pengembangan dan belum dianjurkan untuk digunakan dalam produksi.
Requirement
- Jquery
- Semantic-ui or Bootstrap
Instalasi
Update composer.json
Untuk Laravel 5.2
Bisa dengan menjalankan perintah:
composer require laravolt/mural
Atau menambahkan deklarasi berikut ke file composer.json:
"require": {
...
"laravolt/mural": "^1.0"
},
Untuk Laravel 5.1
Tambahkan deklarasi berikut ke file composer.json:
"require": {
...
"laravolt/mural": "^0.5"
}
Service Provider
Laravolt\Mural\ServiceProvider::class,
Facade
'Mural' => Laravolt\Mural\Facade::class,
Migration
php artisan vendor:publish
php artisan migrate
Ini akan menambahkan file migrasi baru 2015_08_17_101000_create_comments_table.php
sekaligus menjalan migrasi tersebut. Tabel baru bernama comments
akan ditambahkan ke basisdata.
Config mural.php
Isi default_commentable
dengan deklarasi class model yang bisa dikomentari
'default_commentable' => \App\Post::class,
Penggunaan
Untuk setiap model yang bisa dikomentari, tambahkan trait
dan interface
seperti berikut:
Penambahan CommentableTrait otomatis akan menjadikan model Post memiliki relasi morphMany
terhadap Laravolt\Mural\Comment
. Karena ini relasi eloquent biasa, maka Anda bisa melakukan hal-hal berikut ini:
Untuk model yang ditunjuk sebagai komentator, tambahkan interface Commentator
.
Shortcut
Menampilkan Widget Komentar
Untuk menampilkan widget komentar, seperti yang biasa ditemui di kebanyakan blog, tambahkan kode berikut di view Anda:
$post = App\Models\Post::find(1);
{!! Mural::render($post, 'sample-room') !!}
Selesai, laravolt/mural
sudah dilengkapi dengan Model
, Controller
, dan View
yang siap pakai, hasilnya seperti dibawah ini:
Anda juga bisa mengelompokkan komentar berdasar room
tertentu, sehingga untuk satu konten bisa memiliki banyak kelompok komentar.
{!! Mural::render($post, 'collaborator') !!}
{!! Mural::render($post, 'you-can-put-anything-here') !!}
// readonly, user tidak bisa submit komentar
{!! Mural::render($post, 'room', ['readonly' => true]) !!}
Untuk masalah tampilan, saat ini skin yang didukung adalah semantic-ui. Bootstrap segera menyusul (yang berminat bisa kirim Pull Request).
Menambah Komentar
Mural::addComment($post, 'komentar lagi', 'collaborator'); // room = collaborator
Mendapatkan Komentar
Mural::getComments($post, 'room', []);
Event
Nama event | Kapan dipanggil | Parameter |
---|---|---|
mural.render | Ketika widget mural ditampilkan di view | $content |
mural.comment.add | Ketika ada komentar baru | $comment, $content, $user, $room |
mural.comment.remove | Ketika suatu komentar dihapus | $comment, $user |
Configuration
Testing
Karena sepertinya akibat package Orchestral/testbench, phpunit
harus dijalankan dari lokal vendor, tidak bisa dari global phpunit
Roadmap
- Basic comment stream (done)
- Multi room (done)
- Skin: semantic-ui (done)
- Skin: bootstrap
- Validasi komentar
- Translasi (done)
- Permalink untuk komentar tertentu
- Realtime update jika ada komentar baru
- Event (done)
- Edit komentar
- Hapus komentar (done)
- Laporkan sebagai spam
- Vote (like dislike) komentar (done)
- Sort comment by latest or liked (done)