README

Table of Contents

About Laravel Grapes
Diffrence Between Regular Version And Pro Version
Installation Steps
Usage
Translations
Author
License

About Laravel Grapes

Laravel Grapes is a library for laravel framework, that offer cms drag and drop page builder for frontend which support all Laravel functionality and help user to change all frontend and content just in simple clicks.

Laravel Grapes Comes With A Pro Version Will Be Available On Code Canyon SOON !.

Diffrence Between Regular Version And Pro Version

Feature	Regular Version	Pro Version
Laravel CSRF	yes	yes
Laravel Auth User Condition	yes	yes
Laravel Auth Dynamic Guard	yes	yes
Multilingual	yes	yes
Dynamic Laravel Shortcode widgets	1	unlimted
Dynamic Routes /{id}	No	yes

Installation Steps

composer require msa/laravel-grapes

php artisan vendor:publish --provider="MSA\LaravelGrapes\LaravelGrapesServiceProvider" --tag="*"

php artisan migrate

Go to config/lg.php

    <?php

    return [
        // routes configurations
        'builder_prefix' => 'hello', // prefix for builder

        'middleware' => null, // middleware for builder

        'frontend_prefix' => '', // prefix for frontend

        /* Define additional translation languages. */
        'languages' => [
            'ar',
            'es',
        ],
    ];`

1) builder_prefix

The builder by default come with route route('website.builder') which consists of your-domain.com/hello/front-end-builder.
you can change the builder prefix to hi so now the builder load with route prefix hi instead of hello.

2) middleware

Assign any middleware you want to the builder for example auth:admin.

3) frontend_prefix

The frontend prefix by default it comes empty that mean that any generated front end page builder it load directly with your slug that created by you so if you need to set prefix for your generated frontend so change it to your prefix that you want.

Now laravel grapes is working.

Navigate to builder route your-domain.com/builder_prefix/front-end-builder.

Usage

The Controll Panel Consists Of 3 Panels :-

1) Options Panel

2) Page Panel

3) View Panel

4) Customize Builder Style Sheet

1. Options Panel

The options panel consists of 11 buttons :-

View Components
Preview
Full Screen
View Code
Create New Page
Edit Code
Component Manager
Page Manager
Clear Canvas
Save Component
Save Changes

View Components

The view component button show grid lines for all components droped in the canvas, this help to to select each component individual for example take a look on the screenshot below.

Preview

The preview button help you to show page without pannels like screenshot below

Full Screen

The full screen mode button hide all browser utils and show only the builder.

View Code

The view code button show you the html and css code of the page like sceenshot below

Create New Page

The create new page button at topbar when you press on it, the popup modal open with new page form, so fill page name and slug and if you need the page become a home page type slug / .

After submit the form will receive toast notification that page has been created successfully, so select the new page throw select page input on the top bar to start modifying the page.

Don't forget to remove the default route in routes/web.php becaues it will conflict with home page, you don't need web.php for frontend routes because laravel grapes come with it own route file

<?php

use Illuminate\Support\Facades\Route;

/*
|--------------------------------------------------------------------------
| Web Routes
|--------------------------------------------------------------------------
|
| Here is where you can register web routes for your application. These
| routes are loaded by the RouteServiceProvider within a group which
| contains the "web" middleware group. Now create something great!
|
*/

// Route::get('/', function () {
//     return view('welcome');
// });

Edit Code

The edit code button it will open a popup code editor modal that hold page code including html and css.

So you can edit the html and css code from the code editor popup, for editing syles you will find page style inside tag <style></style>.

Note: Html and css on the code editor merged in one page but after submit the code you can View Code, you will find styles and html each of them seperate and each generated page has it's own blade file and css file.

Component Manager

The Component Manager button will open a popup hold all custome components that has been saved to reused on another page to let you edit name of the component or delete it.

Page Manager

The page manager button will open a popup hold all pages and let you to edit page name and slug.

Clear Canvas

The clear canvas button will remove all components from the canvas.

Save Component

Laravel Grapes let you to save any custome component for reuse it on other pages all you need to select the component and click on Save Component Button.

Save Changes

The save changes button update the page content and if you check the page slug you will find that page content has been changed.

2. Page Panel

The options panel consists of 2 select input :-

Select Page
Select Device

Select Page

The select page input let you to select page that you need to modify it.

Select Device

The select device input let you to modify page html and styles on different screens with the following sizes

Desktop
Extra Large
Large
Tablet
Medium
Mobile Landscape
Small
Extra Small
Mobile Portrait

3. View Panel

The View Panel consists of 4 buttons :-

Block Manager
Layer Manager
Components Settings
Style Manager

Block Manager

The Block Manager Comes with Bootstrap Components :-

Layout which holds
- Navbar
- Section
- Container
- Row
- Column
- Column break
- Media Object
Components which holds
- Dropdown Menu
- Menu
- Menu Link
- Alert
- Link
- Tabs
- Tab
- Badge
- Card
- Card Container
- Collapse
- Dropdown Item
- Dropdown Button
Typography which holds
- Header
- Paragraph
- Separator
Templates which holds
- 5 prebuilt templates
Saved which holds
- All your saved custom

Layer Manager

Another utility tool you might find useful when working with web elements is the layer manger. It's a tree overview of the structure nodes and enables you to manage it easier.

Components Settings

Each component come with it's own settings you can modify it for example, if you select from the canvas link element and got to component settings you will find the following:

The attribute of href link
The attribute of target
The attribute of toggle
Show Laravel Auth User Email
Laravel Auth User option, for show element
Laravel Auth Guard option, for show element. (default is web)
The attribute of id
The attribute of title

Style Manager

The Style manager is composed by sectors, which group inside different types of CSS properties. So you can add, for instance, a Dimension sector for width and height, and another one as Typography for font-size and color and more. So it's up to you decide how organize sectors.

Classes
- State (for styling the hover effect, and click, etc...)
- Add class
- remove class
General
- Float Options
- Display Options
- Position Options
Flex Options
Dimension Options
Typography Options
Decorations Options
Extra
- Tarnsitions
- Prespective
- Transform

4. Customize Builder Style Sheet

Go to public/css/laravel-grapes.css and start Customizing Laravel Grapes Builder style sheet As You Wish.

Translations

Each text component have translation input trait for your languages that you were defined in config/lg.php, In the example below you will find Ar Local and Es Local .

msa / laravel-grapes

Maintainers

Details