novius / laravel-nova-page-manager

A page manager for Laravel Nova
0 stars 2 forks source link
laravel-package nova page-manager

Laravel Nova Page Manager

This package allows you to manage pages with custom templates.

Requirements

NOTE: These instructions are for Laravel >= 10.0 and PHP >= 8.2 If you are using prior version, please see the previous version's docs.

Installation

composer require novius/laravel-nova-page-manager

NOTE: These instructions are for Laravel Nova >= 4.0. If you are using prior version, please see the previous version's docs.

Validator translation

Please add this line to resource/lang/{locale}/validation.php (on first level) :

// EN version : resource/lang/en/validation.php
'unique_page' => 'The field :attribute must be unique in this language.',

// FR version : resource/lang/fr/validation.php
'unique_page' => 'Le champ :attribute doit être unique dans cette langue.',

Front Stuff

If you want a pre-generated front controller and route, you can run following command :

php artisan page-manager:publish-front

This command appends a route to routes/web.php and creates a new App\Http\Controllers\FrontPageController.

In Page templates use the documentation of laravel-meta to implement meta tags

Configuration

Some options that you can override are available.

php artisan vendor:publish --provider="Novius\LaravelNovaPageManager\LaravelNovaPageManagerServiceProvider" --tag="config"

Locales

You can add / remove any locale from config files.

Example if you want 2 languages (FR and EN):

// ...

'locales' => [
    'en' => 'English',
    'fr' => 'French',
],

// ...

Templates

To add a template, just add your custom class to templates array in configuration file.

Your class must extend Novius\LaravelNovaPageManager\Templates\AbstractPageTemplate.

Example :

In config/laravel-nova-page-manager.php

// ...

'templates' => [
    \App\Nova\Templates\StandardTemplate::class,
],

In app/Nova/Templates/StandardTemplate.php

<?php

namespace App\Nova\Templates;

use Laravel\Nova\Fields\Trix;
use Novius\LaravelNovaPageManager\Templates\AbstractPageTemplate;

class StandardTemplate extends AbstractPageTemplate
{
    public function templateName(): string
    {
        return trans('laravel-nova-page-manager::template.standard_template');
    }

    public function templateUniqueKey(): string
    {
        return 'standard';
    }

    public function fields(): array
    {
        return [
            Trix::make(trans('laravel-nova-page-manager::template.field_content'), 'content'),
        ];
    }
}

Lint

Run php-cs with:

composer run-script lint

Contributing

Contributions are welcome!

Leave an issue on GitHub, or create a Pull Request.

Licence

This package is under GNU Affero General Public License v3 or (at your option) any later version.