bblstudio/bblstudio

The BblStudio package is a versatile file editing tool designed for laravel bootstrap to streamline content management and editing within web applications

1.1.0 2024-11-02 13:52 UTC

Requires

• php: >=8.0
• laravel/framework: >=8.0

MIT

• Elidi Naili

• bootstrap
• wysiwyg
• content management
• laravel
• web development
• file editor
• text editor
• PHP Package
• blade templates
• view management

README

BBL Studio

Description

BBL Studio is a powerful tool for managing and editing your application views. 
This configuration file sets up the VEDITOR mode and various options for 
customizing how the editor operates within your Laravel application.

Requirements

- Laravel: Minimum version 8
- PHP: Minimum version 8

Installation

1. Run the following command to install BBL Studio:
   composer require bblstudio/bblstudio


Publish the package assets(if not run auto!):
php artisan vendor:publish --tag=laravel-assets --ansi --force


Publish the package views:
php artisan vendor:publish --tag=laravel-views --ansi --force


Publish the package config:
php artisan vendor:publish --tag=config --ansi --force

For using Bootstrap components

add this imoprt in page Edit :
         
   <script src="https://code.jquery.com/jquery-3.3.1.slim.min.js" integrity="sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo" crossorigin="anonymous"></script>
    <script src="/vendor/BblStudio/js/popper.min.js"></script>
    <script src="/vendor/BblStudio/js/bootstrap.min.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/holderjs@2.9.4/holder.js"></script>

BBL Studio Configuration .env file

Mode Options

# - AUTO: Automatic configuration.
# - CONFIG: Manual configuration.
# - AUTO + CONFIG: Automatic with additional configurations.
VEDITOR = "AUTO"  # Required for AUTO mode.

Path Configuration

VEDITOR_FOLDER_VIEWS_PATH = "user_page/auth"  # Required for AUTO mode or Default =Views.

URL and Routing

VEDITOR_URL = "bblstudio"  # Required for AUTO + CONFIG.
VEDITOR_ROUTE_NAME = "bblstudio"  # Required for AUTO + CONFIG.

Save Configuration

# Options: origin / copy / fun
# - origin: Save directly to the original file.
# - copy: Save a copy of the file.
# - fun: Use a custom function to save.
VEDITOR_SAVE = "origin"  # Required for AUTO {origin / copy / fun} + CONFIG {fun}.

Custom Save Function Configuration

# Required if VEDITOR_SAVE is set to "fun".
VEDITOR_SAVE_DATA_FUN_CONTROLLER_NAME = ""  # Controller name for the custom save function.
VEDITOR_SAVE_DATA_FUN_METHOD_NAME = ""  # Method name for the custom save function.
# The function signature should be: fun($filePath or $fileName, $newContent).

Content Retrieval Configuration

# Required for CONFIG mode.
VEDITOR_GET_CONTENT_BY_NAME_CONTROLLER_NAME = ""  # Controller name for retrieving content by name.
VEDITOR_GET_CONTENT_BY_NAME_METHOD_NAME = ""  # Method name for retrieving content by name.
# The function signature should be: fun($fileName).

Structure Listing Configuration

# Required for CONFIG mode.
VEDITOR_LIST_STRUCTER_CONTROLLER_NAME = ""  # Controller name for listing the structure.
VEDITOR_LIST_STRUCTER_METHOD_NAME = ""  # Method name for listing the structure.
# The structure format should be: [[fileName => string (unique), folderName => string], [...]].

Additional Configuration

VEDITOR_SHOW_PHP = true  # Enable or disable PHP code display in the editor.
VEDITOR_MIDDLEWARE_ALIAS = ""  # Middleware alias used for routing if needed.