Download the PHP package optimistdigital/nova-page-manager without Composer

Nova Page Manager

This Laravel Nova package allows you to create and manage pages and regions for your frontend application.

Requirements

Features

• Page and region management w/ custom fields
• Multiple locale support

Screenshots

Installation

Install the package in a Laravel Nova project via Composer and run migrations:

Publish the nova-page-manager configuration file and edit it to your preference:

Register the tool with Nova in the tools() method of the NovaServiceProvider:

Usage

Creating templates

Templates can be created using the following Artisan command:

This will ask you a few additional details and will create a base template in App\Nova\Templates.

The base template exposes a few overrideable functions:

Registering templates

All your templates have to be registered in the config/nova-page-manager.php file.

Defining locales

The locales are defined in the config file.

Add links to front-end pages

To display a link to the actual page next to the slug, add or overwrite the closure in config/nova-page-manager.php for the key base_url.

Overwriting models and resources

You can overwrite the page/region models or resources, just set the new classes in the config file.

Custom locale display

To customize the locale display you can use Nova::provideToScript to pass customLocaleDisplay as in the example below.

Advanced usage

Non-translatable panels

There's some cases where it's more sensible to translate sub-fields of a panel instead of the whole panel. This is possible, but is considered an "advanced usecase" as the feature is really new and experimental, also the developer experience of it is questionable.

You can create a non-translatable panel like so:

This will create a key with __ in the page data object. This means that the page data will end up looking something like this:

Helper functions

Helper functions can be found in the Outl1ne\PageManager\Helpers\NPMHelpers class.

NPMHelpers::getPagesStructure()

Calls resolve() on their template class and returns all pages as a tree where child pages are nested inside the children array key recursively.

NPMHelpers::getPages()

Calls resolve() on their template class and returns all pages. Returns an array of arrays.

NPMHelpers::getRegions()

Calls resolve() on their template class and returns all regions. Returns an array of arrays.

NPMHelpers::getPageByTemplate($templateSlug)

Finds a single page by its template slug (from the config file), calls resolve() on its template class and returns it.

NPMHelpers::getPagesByTemplate($templateSlug)

Same as getPageByTemplate, but returns an array of pages.

NPMHelpers::formatPage($page)

Calls resolve() on the page's template class and returns the page as an array.

NPMHelpers::formatRegion($region)

Calls resolve() on the region's template class and returns the region as an array.

Localization

The translation file(s) can be published by using the following command:

You can add your translations to resources/lang/vendor/nova-page-manager/ by creating a new translations file with the locale name (ie et.json) and copying the JSON from the existing en.json.

Credits

• Tarvo Reinpalu
• Kaspar Rosin

License

Nova page manager is open-sourced software licensed under the MIT license.