Skip to content

customberg/customberg-php

Repository files navigation

Demo GIF

Instalation

composer require customberg/customberg-php:"*"

Add vendor files to your project (CSS, JS, Config, Views):

php artisan vendor:publish --provider="VanOns\Laraberg\LarabergServiceProvider"
php artisan vendor:publish --provider="Customberg\PHP\CustombergServiceProvider"

Usage

The model that you want to use this block editor should have:

use VanOns\Laraberg\Traits\RendersContent;

class Page extends Model
{
    use RendersContent;
}

In the backpack crud controller you must create the crud field like this:

CRUD::field('content')
    ->label('Page content')
    ->type('customberg')
    ->view_namespace('customberg::');

Update

After an update, get the latest assets using:

php artisan vendor:publish --tag="customberg-assets" --force
php artisan vendor:publish --provider="VanOns\Laraberg\LarabergServiceProvider" --tag="public" --force

Example project

git clone https://github.com/customberg/customberg-php
cd customberg-php/example
docker compose up -d
docker-compose exec php su app -c 'cd example; composer install'
docker-compose exec php su app -c 'cd example; cp .env.example .env; php artisan key:generate'
docker-compose exec nginx su app -c 'cd /app/example/public/; ln -s ../storage/app/public storage'

Navigate to http://localhost:8084 and press login.

Enjoy !

Roadmap:

A checkbox and a switch field
Radio field
Slider field
Google Maps field
Documentation !
Icon picker field

Changelog:

v0.14 - 2024-08-07

  • Bugfix: Preview API while rendering a block with multilanguage, when i'm selecting the new language that does not have translation saved.

v0.13 - 2024-07-08

  • Allow laravel 11 installation

v0.12 - 2023-11-09

  • Bugfix error cannot redeclare str_replace_limit

v0.11 - 2023-11-08

  • Update requirements to laravel 10

v0.10 - 2023-04-02

  • Added file extension validation to upload_image.
    Use 'allowed_types' => ['png', 'jpg', 'webp', 'svg'],
  • Added upload_file for files without preview.
    Use 'multiple' => true, if you want multiple files in the same field.

v0.9 - 2023-01-01

  • Multilanguage fine tuning, made configurable language list and bugfixing
  • Multilanguage only supports fields text and rich_text, and works inside repeatable field.

v0.8 - 2022-12-31

  • Fine tuning for repeatable field frontend
  • Added buttons to move and duplicate a item inside repeatable
  • Added example block for repeatable

v0.7 - 2022-12-30

  • First version published to packagist.org ! 🎉🥳
  • Only available fields are: text, rich_text, color, upload_image
  • Repeatable is present but untested. Multilanguage present but untested and hardcoded.