Table of Contents
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 :-
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>
.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.
Note: Html and css on the code editor merged in one page but after submit the code you can 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
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
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
- 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 .
It supported rtl for arabic language (ar)
Author
License
MIT © Mohamed Allam