PHPagebuilder

PHPagebuilder is a drag and drop pagebuilder to manage pages in any PHP project.

PHPagebuilder can be used as an ultra lightweight CMS to quickly spin up new websites, or can be integrated into existing projects or your favorite frameworks (such as this version for Laravel). The server-side code does not depend on any other libraries and is blazing fast. It includes an optional website manager with a Bootstrap UI and integrates the most popular open source drag and drop pagebuilder: GrapesJS. This package is made with customization in mind, allowing you to configure, disable or replace any of its modules.

Table of Contents

• How does it help me?
• Features
• Installation
• Customization

How does it help me?

Whether you are a novice or an experienced web developer, PHPagebuilder can make your life easier if you find yourself in any of the following:

• You just want to create a basic website that you can easily manage from any device.
• You get lost installing, configuring, updating or simply using feature abundant CMS systems like Wordpress, Drupal.
• You don't like the limited page editors in CMSs you've tried.
• You want to build a custom website for a client within a few hours.
• Your clients get lost in feature abundant admin panels like Drupal.
• You hate to rely on messy plugins for features you can write in no-time in plain PHP yourself, but still want to have some admin functionality to allow other people to manage the websites you create.
• You would like to have advanced functionality (search functionality, views displaying data of remote sources, etc.) easily manageable by your clients.

Features

Page Builder

PHPagebuilder features a page builder built on GrapesJS.

Website Manager

A basic website manager is included with a Bootstrap UI. This website manager offers basic functionality to add or remove pages and to edit page settings like page title or URL. Clicking the edit button will open the page builder.

You don't want to use the website manager? No worries, it is included for people who want to use PHPagebuilder directly out of the box. Read here how to disable or replace the website manager.

Installation

To install PHPagebuilder you either follow the quick start path, for quickly spinning up a new website, or you integrate it in your own framework or favorite project structure.

Requirements

• PHP version >= 7
• A cool project

Quick start :rocket:

If you want to quickly start a new project with drag and drop page management functionality, you can download the boilerplate project structure and follow the steps over there.

Integrate into existing project or framework

Add code with Composer

If you are using Composer for managing PHP dependencies, you can simply run:

composer require hansschouten/phpagebuilder

Next, the PHPagebuilder can be initialised using the following PHP code: ```PHP requireonce _DIR__ . '/vendor/autoload.php';

$config = require DIR . '/config.php';

$builder = new PHPageBuilder\PHPageBuilder($config); $builder->handleRequest(); ```

config.php

config/config.example.php

Add code without Composer

Are you not using Composer? No worries, this project is written in plain PHP without any dependencies, so it can be directly included in any PHP project!

Just download the latest release into a separate folder inside your project (we named the folder:

phpagebuilder

Next, you simply include the following code in the PHP file that should launch the page builder:

$installationFolder = __DIR__ . '/phpagebuilder';
require_once $installationFolder . '/src/Core/helpers.php';
spl_autoload_register('phpb_autoload');

$config = require DIR . '/config.php';
$builder = new PHPageBuilder\PHPageBuilder($config);
$builder->handleRequest();

config.php

config/config.example.php

Configure a database

If you use PHPagebuilder out of the box, it requires a database for storing your pages. Just create a database and run the queries from

config/create-tables.sql

Create a theme

The

config.php

theme

themes_folder

active_theme

theme > active_theme

A theme should have the following folder structure:

• /blocks
  The blocks folder contains a sub folder for each block that can be used in the page builder. The folder of a single block contains a

  view.php

  or a

  view.html

  . If a

  view.html

  is used, the block content (the html elements) are fully editable inside the page builder. If

  view.php

  is used, the block can be rendered with server-side logic (PHP) and hence the html content itself cannot be changed from within the page builder.
• /layouts
  The layouts folder contains a sub folder for each page layout. A page layout contains a

  view.php

  file which defines the base html structure with all stylesheets and scripts needed for the blocks dragged on this type of page. Each layout requires the string:

  = $body ?>

  on the location at which the html blocks need to be added in the page layout.
• /public
  The public folder contains all assets (css, javascript, images, etc) that should be publicly accessible. The

  [theme-url]

  shortcode can be used to point to a file in the public folder of the currently active theme. For instance the file

  public/css/style.css

  can be loaded via
  .

Blocks inside blocks

Include a block into a block or layout file

A shortcode can be used to include a block inside another block or into a layout file. For instance, adding the shortcode:

[block slug="header"]

layouts/master/view.php

blocks/header/view.php

master

Nested blocks in the page builder

To allow dropping blocks into a block in the page builder, a blocks container should be added. To add a blocks container, simply add

[blocks-container]

html

    [block-container]

phpb-blocks-container

html

    

    
    

    

Customize PHPageBuilder

PHPagebuilder is build with customization in mind. It comes with an extensive example config file in wich you can easily adapt the pagebuilder to your needs.

PHPagebuilder consists of four modules (Auth, Website Manager, Pagebuilder, Routing) each of which you can disable or replace with your own implementation. To replace a module with your own implementation, implement the corresponding Contract and replace the default class by your own class in the config file.

Customize the Website Manager

Disable the module

Do you already have admin login functionality in your project? Then you can disable the website manager module by setting

use_website_manager

false

PHPageBuilder\Modules\GrapesJS\PageBuilder

Replace the module

If you want to use the CMS routing functionality of PHPagebuilder, but you want to have a different website manager, you can replace the website manager for your own implementation. Make sure leave

use_website_manager

true