pvtl/voyager-page-blocks

Ahoy! - A package to implement page blocks into Voyager

This repository is no longer actively maintained, _(*1)

Voyager Page Blocks

, _(*2)

This Laravel/Voyager Frontend module is designed to give developers the ability to easily design page blocks, for Voyager admin users to build stunning frontend pages., _(*3)

Built by Pivotal Agency., _(*4)

Prerequisites

• Composer Installed
• Install Laravel
• Install Voyager
• Install Voyager Frontend

Installation

# 1. Require this Package in your fresh Laravel/Voyager project
composer require pvtl/voyager-page-blocks

# 2. Run the Installer
php artisan voyager-page-blocks:install

# 3. (Optional) Seed the database with example page blocks.
php artisan voyager-page-blocks:seed

Creating & Modifying Blocks

Page blocks are created & configured in 2 steps:, _(*5)

1. Define the block - in /config/page-blocks.php
2. Build the block's HTML layout - create the template in /resources/views/vendor/voyager-page-blocks/blocks

1. Define a Block

Familiarize yourself with /config/page-blocks.php. This is where you'll define each block - you'll tell it which fields the block should have (for the admin to manage) and which Blade template it should use on the frontend., _(*6)

• Each array inside this configuration file is a page block
• Each block contains fields
• Each field contains a unique field key
• Each field is based on a Voyager Data Type

The below table explains what each property does and how it is relevant to the block itself:, _(*7)

2. Build the HTML

When you're ready to start structuring the display of your block, you'll need to create (or override our defaults) your blade template (located at /resources/views/vendor/voyager-page-blocks/blocks/your_block.blade.php) and use the accessors you defined in your module's configuration file to fetch each fields data ({!! $blockData->image_content !!})., _(*8)

Example. Putting it all together

Let's say we want to create a new block with 1 WYSIWYG editor, called 'Company Overview'., _(*9)

Step 1. Define the new block, _(*10)

In /config/page-blocks.php, we'll add:, _(*11)

$blocks['company_overview'] = [
    'name' => 'Company Overview',
    'template' => 'voyager-page-blocks::blocks.company_overview',
    'fields' => [
        'content' => [
            'field' => 'content',
            'display_name' => 'Company Overview Content',
            'type' => 'rich_text_box',
            'required' => 1,
            'placeholder' => '<p>Lorem ipsum dolor sit amet. Nullam in dui mauris.</p>',
        ],
    ],
];

Step 2. Build the HTML, _(*12)

In /resources/views/vendor/voyager-page-blocks/blocks, we'll create a new file called company_overview.blade.php with:, _(*13)

<div class="page-block">
    <div class="grid-container column text-center">
        {!! $blockData->content !!}
    </div>
</div>

Step 3. Add the block to a page, _(*14)

Next, jump into the Voyager Admin > Pages and click 'Content' next to a page. You'll now be able to select Company Overview from the 'Add Block' section. Add the block to the page, drag/drop it into place, edit the text etc., _(*15)

Developer Controller Blocks

You may also wish to include custom logic and functionality into your page blocks. This can be done with a Developer Controller Block - simply specify your controller namespace'd path and the method you wish to call, which should return a view and you'll be on your way., _(*16)

For example, the Voyager Frontend package comes with a Recent Posts method/view that you can play with and review., _(*17)

From the Add Block section of the page in the admin, add the block type of Developer Controller, then input the following into the path field:, _(*18)

Pvtl\VoyagerFrontend\Http\Controllers\PostController::recentBlogPosts(2)

This will output 2 blog posts on the frontend. You could change the first paramter of the method to 6, to output 6 blog posts. Simples., _(*19)

Troubleshooting

It is important to sanitise your field output, null values will cause errors., _(*20)

It is very important that you follow the naming scheme that is setup in the example page blocks as the keys reference other cogs in the system to stitch the blocks together. There are example blocks already set up in the resources/views directory and configuration file for you to get started., _(*21)