Drafts & Revisions

Creating a Draft

When you create new content in InspireCMS, it starts as a draft by default:

1. Navigate to Content in the admin panel
2. Click Create Content
3. Add your content details, fields, and settings
4. Click Save (not "Publish") to store as a draft

Drafts are visible only in the admin panel and not on your live site.

Identifying Drafts

Drafts are clearly marked in the content list:

• Status indicator shows "Draft"
• Often color-coded differently from published content
• Show an editing icon

Editing Drafts

You can freely modify drafts without affecting your live content:

1. Find the draft in your content list
2. Click to open it in the editor
3. Make your changes
4. Click Save to update the draft

Draft Preview

Preview your draft to see how it will look when published:

1. Open the draft in the editor
2. Click the Preview button in the editor toolbar
3. Your draft will appear in a modal window showing how it will appear on the site

This preview is visible only to authenticated admin users.

Scheduling Publication

For content that should go live at a specific time:

1. Edit your content as usual
2. In the publishing options, select Schedule
3. Set the desired publish date and time
4. Click Schedule

The system will automatically change the content status from "Scheduled" to "Published" at the specified time.

Viewing Revision History

To see the history of changes to a content item:

1. Open the content item in the editor
2. Look for the Content History tab/button
3. View the list of all revisions with timestamps and authors

Adding a Custom Content Status

A basic approval workflow can be set up using custom states and notifications:

use SolutionForest\InspireCms\Facades\ContentStatusManifest;
use SolutionForest\InspireCms\DataTypes\Manifest\ContentStatusOption;
use Filament\Actions\Action;

// In your service provider
public function boot()
{
     // Add "In Review" status
     ContentStatusManifest::addOption(
          new ContentStatusOption(
                value: 2,
                name: 'in_review',
                formAction: fn () => Action::make('submit_for_review')
                    ->authorize('inReview')
                    ->successNotificationTitle('Send to Review')
                    ->action(function ($record, $action) {
                        $if (is_null($record)) {
                        $action->cancel();

                        return;
                    }
            
                    $publishableState = 'in_review';

                    if (! \SolutionForest\InspireCms\Helpers\ContentHelper::handlePublishableRecord($record, $publishableState, $livewire, [])) {
                        return;
                    }

                    $action->success();
                    })
          )
     );
}

Customizing Models and Authorization Policies

To fully implement a review workflow, you may need to extend the default content model and define authorization policies:

Custom Content Model

namespace App\Models;

use SolutionForest\InspireCms\Models\Content as BaseContent;

class Content extends BaseContent
{
}

Custom Content Policy

namespace App\Policies;

use App\Models\Content;
use App\Models\User;
use SolutionForest\InspireCms\Policies\ContentStatusPolicy as BasePolicy;

class ContentPolicy extends BasePolicy
{
    public function viewAny(User $user): bool
    {
        return true;
    }
    
    public function view(User $user, Content $content): bool
    {
        return true;
    }
    
    public function create(User $user): bool
    {
        return $user->hasAnyRole(['author', 'editor', 'admin']);
    }
    
    public function update(User $user, Content $content): bool
    {
        // Authors can only edit drafts they created
        if ($user->hasRole('author') && $content->user_id === $user->id) {
            return $content?->display_status?->getName() === 'draft';
        }
        
        // Editors can review content in review status and edit any draft
        if ($user->hasRole('editor')) {
            return in_array($content?->display_status?->getName(), [
                'draft',
                'in_review',
            ]);
        }
        
        // Admins can edit anything
        return $user->hasRole('admin');
    }
    
    public function publish(User $user, Content $content): bool
    {
        return $user->hasAnyRole(['editor', 'admin']);
    }

    public function inReview(User $user, Content $content): bool
    {
        return $content?->display_status?->getName() !== 'in_review';
    }
}

Register your custom model and policy in your AppServiceProvider:

use Illuminate\Support\Facades\Gate;
use Illuminate\Support\ServiceProvider;
use SolutionForest\InspireCms\Facades\InspireCms;
use SolutionForest\InspireCms\Facades\ModelManifest;
use SolutionForest\InspireCms\Models\Contracts\Content;

class AppServiceProvider extends ServiceProvider
{
    public function register(): void
    {
        ModelManifest::replace(Content::class, \App\Models\Content::class);
    }

    public function boot()
    {
        Gate::policy(\App\Models\Content::class, \App\Policies\ContentPolicy::class);
    }
}

Or update in config:

// config/inspirecms.php
return [
    'models' => [
        'fqcn' => [
            'content' => \App\Models\Content::class,
        ],
        'policies' => [
            'content' => \App\Policies\YourContentPolicy::class,
        ]
    ],
];