optix/draftable

Eloquent Draftable

, _(*1)

Add draftable functionality to your eloquent models., _(*2)

Installation

You can install this package via composer., _(*3)

composer require optix/eloquent-draftable

Setup

1. Add a nullable timestamp published_at column to your model's database table., _(*4)

   $table->timestamp('published_at')->nullable();
   

2. Include the Optix\Draftable\Draftable trait in your model., _(*5)

   class Post extends Model
   {
       use Draftable;
   }
   

Usage

Query scopes, _(*6)

When the Draftable trait is included in a model, a global scope will be registered to automatically exclude draft records from query results. Therefore, in order to query draft records you must apply one of the local scopes outlined below., _(*7)

// Only retrieve published records...
$onlyPublished = Post::all();

// Retrieve draft & published records...
$withDrafts = Post::withDrafts()->get();

// Only retrieve draft records...
$onlyDrafts = Post::onlyDrafts()->get();

Publish a model, _(*8)

$post = Post::withDrafts()->first();

// Publish without saving...
$post->setPublished(true);

// Publish and save...
$post->publish(); // or $post->publish(true);

When you attempt to publish a model that's already been published, the published_at timestamp will not be updated., _(*9)

Draft a model, _(*10)

// Draft without saving...
$post->setPublished(false);

// Draft and save...
$post->draft(); // or $post->publish(false);

Schedule a model to be published, _(*11)

$publishDate = Carbon::now()->addWeek();
// $publishDate = '2020-01-01 00:00:00';
// $publishDate = '+1 week';

// Schedule without saving...
$post->setPublishedAt($publishDate);

// Schedule and save...
$post->publishAt($publishDate);

The methods outlined above both require a $date parameter of type DateTimeInterface|string|null., _(*12)

Get the published status of a model, _(*13)

// Determine if the model is published...
$post->isPublished();

// Determine if the model is draft...
$post->isDraft();

License

This package is licensed under the MIT license., _(*14)