Pages

Pages help you to quickly add new pages to your admin application. This turns your admin panel into a cms.

Install the package via composer:

composer require aw-studio/fjord-pages

Publish the migrations and migrate:

php artisan vendor:publish --provider="FjordPages\FjordPagesServiceProvider" && php artisan migrate

Setup a pages collection

With the artisan command fjord:pages a new pages collection is created. For example blog:

php artisan fjord:pages Blog

A config is created and two controllers, one for the backend in ./fjord/app/Controllers/Pages and one for your application in ./app/Http/Controllers/Pages.

In the config you can configure the route prefix and the possible repeatabels. The url of the page consists of the route prefix specified in the config and the sluggified page title. So a route for the following case could be /blog/my-title. If the page is translatable a route is created for each locale specified in the config like so:

• en/blog/{slug}
• en/blog/{slug}

// ./fjord/app/Config/Pages/BlogConfig.php

namespace FjordApp\Config\Pages;

...

class BlogConfig extends PagesConfig
{
    ...

    public function appRoutePrefix(string $locale = null)
    {
        return "blog";
    }

    public function repeatables(Repeatables $rep)
    {
        // Build your repeatables in here.
    }
}

In the controller the page model is loaded with the method getFjordPage. This can now be passed to a view like this:

namespace App\Http\Controllers\Pages;

use FjordPages\ManagesFjordPages;
use Illuminate\Http\Request;

class PagesController
{
    use ManagesFjordPages;

    public function __invoke(Request $request, $slug)
    {
        $page = $this->getFjordPage($slug);

        return view('pages.blog')->withPage($page);
    }
}

Route Field

To be able to select the pages in a route field you must first add them to a route collection as described in the route field documentation.

FjordPages extends to Eloquent Collection with the helper method addToRouteCollection that lets you add a list of pages directly to a route collection:

use Fjord\Crud\Fields\Route;
use FjordPage\Models\FjordPage;

Route::register('app', function($collection) {
    FjordPage::collection('blog')->get()->addToRouteCollection('Blog', $collection);
});