README

Nova Page Manager Tool

Manage static pages from your Nova panel.

Prerequisites

This tool depends on the following packages:

binomeway/nova-taxonomies-tool

Please, refer to its documentation for installation and usage instructions.

Installation

public function tools(){
    return [
        \BinomeWay\NovaPageManagerTool\NovaPageManagerTool::make(),
    ];
}

Publish the migrations.

php artisan vendor:publish --provider="\BinomeWay\NovaPageManagerTool\ToolServiceProvider" --tag="migrations"

Configure the tool.

php artisan vendor:publish --provider="\BinomeWay\NovaPageManagerTool\ToolServiceProvider" --tag="config"

Optionally, customise the tool's views.

php artisan vendor:publish --provider="\BinomeWay\NovaPageManagerTool\ToolServiceProvider" --tag="views"

Usage

Templates

Defining Templates

You can define a new template by creating a class and extend it from BinomeWay\NovaPageManagerTool\Template.

namespace App\Templates;

use BinomeWay\NovaPageManagerTool\Template;

class AboutTemplate extends Template
{
    protected string $group = 'General'; // Displayed in the select field
    protected string $label = 'About Us'; // Displayed in the select field
    protected string $path = 'pages.about-us';
}

or use the generator command:

php artisan nova-page-manager:template AboutTemplate

It will generate for you the template class, and the view file.

Registering Templates

After you have defined your template, register it from a ServiceProvider. It can be placed in the AppServiceProvider , ViewServiceProvider or any other service provider.

use  \BinomeWay\NovaPageManagerTool\Facades\TemplateManager;

public function boot() {
    TemplateManager::register([
   
       \App\Templates\AboutTemplate::class,
   
    ]);
}

Page Builder

Blocks

Define Blocks

namespace App\Blocks;

use BinomeWay\NovaPageManagerTool\Block;
use Laravel\Nova\Fields\Textarea;

class DescriptionSectionBlock extends Block
{
    /**
     * The layout's unique identifier
     *
     * @var string
     */
    protected $name = 'description-section';

    /**
     * The displayed title
     *
     * @var string
     */
    protected $title = 'Description Section';

    /**
     * The view path associated with this block.
     * @var string
     */
    protected string $component = 'blocks.description-section';

    /**
     * Get the fields displayed by the layout.
     *
     * @return array
     */
    public function fields()
    {
        return [
            Textarea::make(__('Description'), 'description')
        ];
    }
    
    public function customLogic(){
        // You can define custom methods and use them within view.
    }
}

Register Blocks

In your AppServiceProvider within the boot method, you can use the PageBuilder facade to register blocks.

// AppServiceProvider.php
use BinomeWay\NovaPageManagerTool\Facades\PageBuilder;

function boot() {
    
    PageBuilder::register([
        'description-section' => \App\Blocks\DescriptionSectionBlock::class,
    ]);
}

Rendering Blocks

In your template you can iterate over each block and just include the associated component of the block.

<x-app-layout>
    <x-slot name="header">
        {{ $page->title }}
    </x-slot>

    <div class="py-12 max-w-2xl mx-auto">
        <article class="prose prose-lg">
            @foreach($page->blocks as $block)
                @include($block->component())
            @endforeach
        </article>
    </div>
</x-app-layout>

Presets

Define Presets

TODO: documentation

Register Presets