gorankrgovic/larablog

Larablog is simple but yet powerful Blog package for the Laravel 5.6 and up.

Larablog

A package for easier maintenance of the blog (or news) articles., _(*1)

Installation, Configuration and Usage

Via Composer:, _(*2)

$ composer require gorankrgovic/larablog

Configuration

Once you install the package, it should be automatically discovered by the Laravel. To check this, in your terminal simply run the:, _(*3)

$ php artisan

Once you run the command, you shoul dbe able to find all larablog commands available., _(*4)

First step is to publish the vendor files. In this case only the config file., _(*5)

$ php artisan vendor:publish --tag="larablog"

After you inspect the configuration file, it depends on your skills :). I recommend running the:, _(*6)

$ php artisan larablog:setup

The above command will install models, make the migration file and add a trait to your User model., _(*7)

After the setup please run the migration command, _(*8)

$ php artisan migrate

Which will create the tables for this package: articles and categories. (you can change the names in your config file)., _(*9)

Once the tables are ready, please make sure to seed the initial category., _(*10)

$ php artisan larablog:seeder

The above command will create a seeder class. After you created a seeder, please run the, _(*11)

$ composer du

And then run the seeder, _(*12)

$ php artisan db:seed --class=LarablogSeeder

Thats. basically it., _(*13)

Usage

Create your controller resource or whatever and then simply:, _(*14)

$article = new Article([
            'title' => 'This is my title',
            'slug' => 'this-is-my-slug',
            'excerpt' => 'This is my excerpt',
            'content' => 'This is my content',
            'is_featured' => false,
            'status' => 'publish',
            'publish_at' => Carbon::now()
]);

// associate the user
$article->associateUser(1);
// save the article
$article->save();

// attach the category
$article->attachCategory('uncategorized'); // name or the ID

// or multiple categories
$article->attachCategories([1, 2, 3]); // names or ID's

To get the article you can, for example:, _(*15)

$article = Article::find(1);

// get the categories (cacheable)
$article->getCategories();

Or you can fetch all articles from a user, _(*16)

$user = User::find(1);

$articles = $user->getArticles();

// or
$articles = $user->getArticlesPaginated(20);

// or
$articles = $user->articles()->get();

Also you can use provided scopes, _(*17)

$articles = Article::whereCategoriesAre([1, 2, 3])->get(); // pass an array of IDs

// or

$articles = Article::whereCategoryIs(1)->get(); // pass an id

Facade

Larablog provides you with convenient helpers to make your life easier, _(*18)

use Gorankrgovic\Larablog\Facades\Larablog;

// ... and then in your methods...

// to generate a unique slug which will append number at the end of the slug if the same slug exists
$slug = Larablog::slug($title);

// to convert string to paragraph delimited text
$text = Larablog::autop($content);

// to generate the excerpt
$excerpt = Larablog::excerpt($content);

// to just sanitize the title and to get a slug
$slug = Larablog::sanitize_title($title);

Basically thats it..., _(*19)