README

Laravel Nova Blogs

This packages add the resources you need to create a simple blog in Nova. This is fully extendable.

Requirements

• PHP ^8.3
• Laravel Nova ^5.0

Installation

Composer

You can install the package via composer:

composer require marshmallow/blogs

Run the install command

The package ships an install command that publishes the config file, runs the migrations (creating the blogs and blog_tags tables), generates the Blog and BlogTag Nova resources, and registers the blog detail and tag routes:

php artisan blogs:install

Make sure the routes work

Create a page in your Nova Pages Resource. This page should have the route name blog-detail-page. Create a page in your Nova Pages Resource. This page should have the route name blog-tag-page.

Configuration

The config file is published to config/blogs.php. Every value can be overridden to swap in your own models, Nova resources and route names.

Usage

Blogs are managed through the generated Nova resources. On the frontend you work with the Marshmallow\Blogs\Models\Blog model, which exposes a number of query scopes and helper methods:

use Marshmallow\Blogs\Models\Blog;

// Published blogs, newest first.
$blogs = Blog::published()->ordered()->get();

// Apply the ?q= search filter from the current request.
$results = Blog::published()->filtered()->ordered()->get();

// Blogs for a single tag.
$tagged = Blog::tagged($tag)->get();

foreach ($blogs as $blog) {
    $blog->route();          // URL to the blog detail page
    $blog->dateFormatted();  // publish_date in config('blogs.publish_date_format')
    $blog->getImage();       // asset URL, defaults to the overview_image column
    $blog->tag;              // related BlogTag
    $blog->user;             // related user
}

The Blog model also implements Marshmallow's Seoable and sitemap traits, so published blogs are automatically included in the generated sitemap.

Changelog

Please see CHANGELOG for more information what has changed recently.

Security

If you discover any security related issues, please email stef@marshmallow.dev instead of using the issue tracker.

Credits

• Stef
• All Contributors

License

The MIT License (MIT). Please see License File for more information.