nova-page

by whitecube

whitecube / nova-page

Static pages content management for Laravel Nova

144 Stars 28 Forks Last release: 5 months ago (v0.2.5) MIT License 219 Commits 14 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Nova Page

Maintainability Test Coverage

Ever wanted to expose static content of an "About" page as editable fields in your app's administration without having to create specific models & migrations? Using this package, you'll be able to do so. By default, it will store the content in JSON files in the application's

resources/lang
directory, making them available for version control. A database source is also available.

This package adds basic flat-file CMS features to Laravel Nova in a breeze using template configurations as if it were administrable Laravel Models, meaning it allows the usage of all the available Laravel Nova fields and tools.

Quick start

Here's a very condensed guide to get you started asap. For more details, examples and advanced features, take a look at the full docs.

Install

composer require whitecube/nova-page

Then register the Nova tool in

app/Providers/NovaServiceProvider.php
:
public function tools()
{
    return [
        \Whitecube\NovaPage\NovaPageTool::make(),
    ];
}

Usage

In order to assign fields (and even cards!) to a page's edition form, we'll have to create a

Template
class and register this class on one or more routes. You'll see, it's quite easy.

Creating Templates

php artisan make:template About
namespace App\Nova\Templates;

use Illuminate\Http\Request; use Laravel\Nova\Fields\Text; use Whitecube\NovaPage\Pages\Template;

class About extends Template {

/**
 * Get the fields displayed by the resource.
 *
 * @param  \Illuminate\Http\Request $request
 * @return array
 */
public function fields(Request $request)
{
    return [
        Text::make('Title of the page', 'title')
    ];
}

/**
 * Get the cards available for the request.
 *
 * @param  \Illuminate\Http\Request  $request
 * @return array
 */
public function cards(Request $request)
{
    return [];
}

}

Route::get('/about-me', '[email protected]')
    ->template(\App\Nova\Templates\About::class)
    ->name('about');

Fields and cards definition is exactly the same as regular Laravel Nova Resources.

Loading the data in your pages

The easiest way is to use middleware.

In the

App\Http\Kernel
file:
protected $middlewareGroups = [
    'web' => [
        'loadNovaPage',
    ],
};

// ...

protected $routeMiddleware = [ 'loadNovaPage' => \Whitecube\NovaPage\Http\Middleware\LoadPageForCurrentRoute::class, ];

Accessing the data in your views

Retrieving the page's static values in your application's blade templates is possible with the

get
directive or using the
Page
facade.

@get('title')

// or

{{ Page::get('title') }}

Please note it is also possible to define Option Templates for repeated data, which can be accessed using:

@option('footer.copyright')

// or

{{ Page::option('footer')->copyright }}

💖 Sponsorships

If you are reliant on this package in your production applications, consider sponsoring us! It is the best way to help us keep doing what we love to do: making great open source software.

Contributing

Feel free to suggest changes, ask for new features or fix bugs yourself. We're sure there are still a lot of improvements that could be made and we would be very happy to merge useful pull requests.

Thanks!

Made with ❤️ for open source

At Whitecube we use a lot of open source software as part of our daily work. So when we have an opportunity to give something back, we're super excited!
We hope you will enjoy this small contribution from us and would love to hear from you if you find it useful in your projects.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.