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.

Bisa dengan menjalankan perintah:

composer require laravolt/mural

Atau menambahkan deklarasi berikut ke file composer.json:

"require": {
    ...
    "laravolt/mural": "^0.2"
},

Laravolt\Mural\ServiceProvider::class,

'Mural'  => Laravolt\Mural\Facade::class,

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.

Untuk setiap model yang bisa dikomentari, tambahkan trait seperti berikut:

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Laravolt\Mural\CommentableTrait;

class Post extends Model
{
    use CommentableTrait;
}

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:

// mendapatkan semua komentar
Post::find(1)->comments;

// melakukan paginasi komentar
Post::find(1)->comments()->paginate();

// atau aksi apapun, sama seperti relasi Eloquent biasa
Post::find(1)->comments()->orderBy('created_at', 'desc');

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).

Mural::addComment($post, 'komentar lagi', 'collaborator'); // room = collaborator

Mural::getComments($post, 'room', []);

<?php

return [
    // semantic-ui or bootstrap
    'skin'                => 'semantic-ui',

    // comment per page
    'per_page'            => 5,

    // whether user enable to vote comment or not
    'vote'                => false,

    // default commentable class (deprecated)
    'default_commentable' => \App\Models\Post::class,
];

• jquery
• semantic-ui or bootstrap

• 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)