cloudmyn/bookmark

A simple package of laravel that allows you to bookmark your model

v1.1.0 2021-09-27 19:18 UTC

Requires

• php: ^7.2.5|^8.0
• laravel/framework: ^7.29
• laravel/tinker: ^2.5

Requires (Dev)

• orchestra/testbench: ^5.0
• phpunit/phpunit: 9.5.x-dev

MIT

• CloudMyn

• laravel
• bookmark
• cloudmyn

README

requirement: php ^7.2.5 & laravel 7

Brief

Package ini memunkinkan anda melakukan bookmark terhadap model yang anda inginkan, tampa harus repot membuatnya dari awal!

Instalation

Silahkan jalankan perintah dibawah, kami menganggap composer telah terinstal di mesin anda

composer require cloudmyn/bookmark

Usage

untuk tahap selanjutnya anda harus published vendor package seperti migrations dan config

php artisan vendor:publish --provider="CloudMyn\Bookmark\BookmarkServiceProvider" --tag="config"

php artisan vendor:publish --provider="CloudMyn\Bookmark\BookmarkServiceProvider" --tag="migrations"

Silahkan masukkan trait CloudMyn\Bookmark\Traits\Bookmarker di model user anda

namespace App\Models\User;

use CloudMyn\Bookmark\Traits\Bookmarker;
    
class User extends Illuminate\Database\Eloquent\Model 
{
    use Bookmarker;

    ...
}

Begitupun dengan model yang ingin di bookmark, silahkan masukkan CloudMyn\Bookmark\Traits\Bookmarkable untuk menandainya

namespace App\Models\Post;

use CloudMyn\Bookmark\Traits\Bookmarkable;
    
class Post extends Illuminate\Database\Eloquent\Model 
{
    use Bookmarkable;

    ...
}

Untuk melakukan Bookmark di sebuah model, silahkan masukkan code dibawah ini

// Bookmark untuk di model user
$user->bookmark($post);

// Bookmark untuk di model post
$post->bookmark($user)

Untuk mendapatkan model yang di bookmark:

$user->getBookmarks();

Untuk melihat siapa saja yang mem-bookmark model post:

$post->getBookmarkers();

Untuk menghapus model yang telah di-bookmark:

// Method untuk di model user
$user->unBookmark($post);

// Method untuk di model post
$post->unBookmark($user);

Untuk menemukan object yang telah di-bookmark:

// Method untuk di model user
$user->findBookmarkable($post);

// Method untuk di model post
$post->findBookmarker($user);

Untuk mengecek apakah object telah di bookmark atau tidak:

$user->isBookmarked($post);