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.
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.
Laravel | Nova | nova-page |
---|---|---|
\< 9.x | < 4.0 | < 0.3.0 |
9.x | 4.0 | ^ 0.3.0 |
composer require whitecube/nova-page
Then register the Nova tool in app/Providers/NovaServiceProvider.php
:
public function tools()
{
return [
\Whitecube\NovaPage\NovaPageTool::make(),
];
}
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.
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 \Laravel\Nova\Http\Requests\NovaRequest $request
* @return array
*/
public function fields(NovaRequest $request)
{
return [
Text::make('Title of the page', 'title')
];
}
/**
* Get the cards available for the request.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @return array
*/
public function cards(NovaRequest $request)
{
return [];
}
}
Route::get('/about-me', 'AboutController@show')
->template(\App\Nova\Templates\About::class)
->name('about');
Fields and cards definition is exactly the same as regular Laravel Nova Resources.
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,
];
Retrieving the page's static values in your application's blade templates is possible with the get
directive or using the Page
facade.
<p>@get('title')</p>
// or
<p>{{ Page::get('title') }}</p>
Please note it is also possible to define Option Templates for repeated data, which can be accessed using:
<p>@option('footer.copyright')</p>
// or
<p>{{ Page::option('footer')->copyright }}</p>
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.
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!
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.