### Install Botble CMS

Source: https://docs.botble.com/cms/commands

Installs the Botble CMS by running migrations, creating a super user, activating plugins, and publishing assets. This is an interactive command that guides the user through the setup process.

```bash
php artisan cms:install
```

--------------------------------

### Form Submission Routes Example (PHP)

Source: https://docs.botble.com/cms/theme-development/theme-routes

This PHP code example shows how to set up routes for handling form submissions. It defines separate routes for displaying the form (GET request) and for processing the submitted data (POST request), ensuring proper handling of user input.

```php
Theme::registerRoutes(function (): void {
    Route::group(['controller' => YourThemeController::class], function (): void {
        Route::get('contact', 'getContact')->name('public.contact');
        Route::post('contact', 'postContact')->name('public.contact.post');
    });
});

```

--------------------------------

### Responsive Design CSS Example

Source: https://docs.botble.com/cms/theme-development/theme-seo-optimization

A basic CSS example demonstrating responsive design principles. It adjusts container width for smaller screens to ensure better mobile usability, contributing to SEO.

```css
/* Use responsive design */
@media (max-width: 768px) {
    .container {
        width: 100%;
        padding: 0 15px;
    }
}
```

--------------------------------

### Seed Database with Sample Data using Sail

Source: https://docs.botble.com/cms/installation-using-docker

Populates the database with sample data using Botble CMS's seeder classes. This is useful for development and testing to quickly get a populated environment.

```shell
sail artisan db:seed
```

--------------------------------

### TextField Example

Source: https://docs.botble.com/cms/form-builder-get-started

This snippet shows the configuration for a standard text input field. It includes options for label, placeholder, required status, and maximum length.

```php
use Botble\Base\Forms\Fields\TextField;
use Botble\Base\Forms\FieldOptions\TextFieldOption;

->add('name', TextField::class, TextFieldOption::make()
    ->label('Name')
    ->placeholder('Enter name')
    ->required()
    ->maxLength(255)
)
```

--------------------------------

### Rendering a Form from a Controller

Source: https://docs.botble.com/cms/form-builder-get-started

This example illustrates how to render a form within a controller method. It injects the form class and calls the renderForm method.

```php
use Botble\Todo\Forms\TodoForm;

public function create(TodoForm $form)
{
    return $form->renderForm();
}
```

--------------------------------

### Start Botble CMS Services with Docker

Source: https://docs.botble.com/cms/installation-using-docker

Starts the Docker services defined in the docker-compose.yml file in detached mode. This command is essential for running the Botble CMS application and its associated services (like database, cache) in the background.

```shell
sail up -d
```

--------------------------------

### PhoneNumberField Example

Source: https://docs.botble.com/cms/form-builder-get-started

This example configures a phone number input field, which may include formatting capabilities. Options for label are demonstrated.

```php
use Botble\Base\Forms\Fields\PhoneNumberField;
use Botble\Base\Forms\FieldOptions\PhoneNumberFieldOption;

->add('phone', PhoneNumberField::class, PhoneNumberFieldOption::make()
    ->label('Phone Number')
)
```

--------------------------------

### Install Composer Dependencies with Docker

Source: https://docs.botble.com/cms/installation-using-docker

Installs Composer dependencies for the project within a Docker container. It mounts the current directory and Composer's home directory into the container. This command is typically used for initial setup or when updating dependencies.

```shell
docker run --rm --interactive --tty \
  --volume $PWD:/app \
  --volume ${COMPOSER_HOME:-$HOME/.composer}:/tmp \
  composer install --ignore-platform-reqs
```

--------------------------------

### Form Layouts: 2 Columns

Source: https://docs.botble.com/cms/form-builder-get-started

This example shows how to arrange form fields into a two-column layout using the 'columns()' method and specifying the colspan for each field.

```php
use Botble\Base\Forms\Fields\TextField;
use Botble\Base\Forms\Fields\TextareaField;

$this
    ->columns() // Use 2 columns layout
    ->add('field1', TextField::class, TextFieldOption::make()->colspan(6))
    ->add('field2', TextField::class, TextFieldOption::make()->colspan(6));
```

--------------------------------

### NumberField Example

Source: https://docs.botble.com/cms/form-builder-get-started

This snippet shows the configuration for a numeric input field, suitable for integers and decimals. It includes options for label and setting minimum, maximum, and step values.

```php
use Botble\Base\Forms\Fields\NumberField;

->add('quantity', NumberField::class, [
    'label' => 'Quantity',
    'min' => 1,
    'max' => 1000,
    'step' => 1,
])
```

--------------------------------

### PHP Quick Reference for Botble CMS Features

Source: https://docs.botble.com/cms/ai-assistant-guide

A collection of PHP code examples for common Botble CMS functionalities. This includes accessing enum values and labels, performing translations, using Eloquent, defining form fields, and security sanitization.

```php
// Enum value access
$model->status->getValue()           // Get value
$model->status->label()              // Get label
(string) $model->status              // Cast to string
BaseStatusEnum::PUBLISHED            // Constant value
BaseStatusEnum::PUBLISHED()          // Enum instance

// Translations
trans('plugins/name::file.key')      // Admin
__('theme.key')                      // Frontend

// Eloquent
Model::query()->where(...)->get()    // Always use query()
->with(['relation'])                 // Eager load

// Forms
NameFieldOption::make()->required()  // Field options
StatusFieldOption::make()            // Status select

// Security
BaseHelper::clean($html)             // Sanitize HTML
@json($data)                         // Safe JS embedding
```

--------------------------------

### Create Botble CMS Backup (Bash)

Source: https://docs.botble.com/cms/domain-migration

Creates a full backup of the Botble CMS installation, including database and files, before performing a domain migration. This command is part of the Botble CMS CLI tools.

```bash
php artisan cms:backup:create "pre-migration-backup" --description="Full backup before domain migration"
```

--------------------------------

### Semantic HTML Example

Source: https://docs.botble.com/cms/theme-development/theme-seo-optimization

This HTML snippet showcases the use of semantic elements like `<article>`, `<header>`, `<section>`, and `<footer>`. Using semantic HTML improves accessibility and helps search engines understand content structure.

```html
<article>
    <header>
        <h1>Article Title</h1>
        <time datetime="2023-01-01">January 1, 2023</time>
    </header>
    
    <section>
        <h2>Section Title</h2>
        <p>Content...</p>
    </section>
    
    <footer>
        <p>Author: John Doe</p>
    </footer>
</article>
```

--------------------------------

### Install Theme Sample Data

Source: https://docs.botble.com/cms/commands

Imports sample data for a theme by executing the SQL file located at `platform/themes/your-theme/data/sample.sql`. This command helps in setting up a theme with initial content.

```bash
php artisan cms:theme:install-sample-data
```

--------------------------------

### Update Botble CMS .env Configuration (Bash)

Source: https://docs.botble.com/cms/domain-migration

Example of updating the `.env` file on the new server after migration. Key variables like `APP_URL` and database credentials should be adjusted to match the new environment.

```bash
APP_URL=https://your-new-domain.com

# Database credentials (update if changed)
DB_HOST=localhost
DB_DATABASE=your_new_database
DB_USERNAME=your_new_username
DB_PASSWORD=your_new_password
```

--------------------------------

### EmailField Example

Source: https://docs.botble.com/cms/form-builder-get-started

This example demonstrates configuring an email input field, which includes built-in HTML5 validation for email formats. Options for label and required status are shown.

```php
use Botble\Base\Forms\Fields\EmailField;
use Botble\Base\Forms\FieldOptions\EmailFieldOption;

->add('email', EmailField::class, EmailFieldOption::make()
    ->label('Email Address')
    ->required()
)
```

--------------------------------

### Display Help for Screenshot Tool (Bash)

Source: https://docs.botble.com/cms/shortcode

This command displays the help message for the `npm run screenshot` tool, outlining all available options and their descriptions. This is useful for understanding the full capabilities of the tool.

```bash
npm run screenshot -- --help
```

--------------------------------

### Create a Plugin

Source: https://docs.botble.com/cms/commands

Creates a new plugin in the `/platform/plugins` directory with a predefined basic structure, including controllers, models, routes, views, migrations, language files, and a service provider.

```bash
php artisan cms:plugin:create <plugin>
```

--------------------------------

### Route with Multiple Parameters Example (PHP)

Source: https://docs.botble.com/cms/theme-development/theme-routes

This PHP code example illustrates how to define a route that accepts multiple parameters from the URL, such as a category and a product identifier. This allows for more specific and hierarchical URL structures.

```php
Theme::registerRoutes(function (): void {
    Route::group(['controller' => YourThemeController::class], function (): void {
        Route::get('products/{category}/{product}', 'getProduct')
            ->name('public.product');
    });
});

```

--------------------------------

### Route with Constraints Example (PHP)

Source: https://docs.botble.com/cms/theme-development/theme-routes

This PHP code example demonstrates how to apply constraints to route parameters, ensuring that a parameter matches a specific pattern (e.g., only digits for an ID). This helps in validating URL segments before they reach the controller.

```php
Theme::registerRoutes(function (): void {
    Route::group(['controller' => YourThemeController::class], function (): void {
        Route::get('products/{id}', 'getProduct')
            ->where('id', '[0-9]+')
            ->name('public.product');
    });
});

```

--------------------------------

### Create Backup via CLI (Bash)

Source: https://docs.botble.com/cms/plugin-backup

Creates a new backup using the Artisan command. You can specify a name and an optional description for the backup. This is useful for scripting and automation.

```bash
php artisan cms:backup:create [name of backup] --description=[description]

php artisan cms:backup:create "Weekly Backup" --description="Regular weekly backup"
```

--------------------------------

### Basic Page Route Example (PHP)

Source: https://docs.botble.com/cms/theme-development/theme-routes

This PHP code example shows how to define a basic route for a static page like 'about-us' using the `Theme::registerRoutes()` method. It maps a URL to a specific controller method and assigns a name to the route for easy referencing.

```php
Theme::registerRoutes(function (): void {
    Route::group(['controller' => YourThemeController::class], function (): void {
        Route::get('about-us', 'getAboutUs')->name('public.about-us');
    });
});

```

--------------------------------

### PasswordField Example

Source: https://docs.botble.com/cms/form-builder-get-started

This snippet shows how to create a password input field, which masks the entered characters for security. It includes basic configuration for label and required status.

```php
use Botble\Base\Forms\Fields\PasswordField;

->add('password', PasswordField::class, [
    'label' => 'Password',
    'required' => true,
])
```

--------------------------------

### Create a Basic Table in Botble CMS (PHP)

Source: https://docs.botble.com/cms/table-builder

This snippet demonstrates how to create a basic table by extending `TableAbstract` and implementing the `setup()` method. It configures the model, adds various column types, header actions, row actions, and bulk actions, and defines a custom query.

```php
<?php

namespace YourPlugin\Tables;

use Botble\Table\Abstracts\TableAbstract;
use Botble\Table\Columns\IdColumn;
use Botble\Table\Columns\NameColumn;
use Botble\Table\Columns\CreatedAtColumn;
use Botble\Table\Columns\StatusColumn;
use Botble\Table\Actions\EditAction;
use Botble\Table\Actions\DeleteAction;
use Botble\Table\BulkActions\DeleteBulkAction;
use Botble\Table\HeaderActions\CreateHeaderAction;
use YourPlugin\Models\YourModel;
use Illuminate\Database\Eloquent\Builder;

class YourModelTable extends TableAbstract
{
    public function setup(): void
    {
        $this
            ->model(YourModel::class)
            ->addColumns([
                IdColumn::make(),
                NameColumn::make()->route('your-model.edit'),
                CreatedAtColumn::make(),
                StatusColumn::make(),
            ])
            ->addHeaderAction(CreateHeaderAction::make()->route('your-model.create'))
            ->addActions([
                EditAction::make()->route('your-model.edit'),
                DeleteAction::make()->route('your-model.destroy'),
            ])
            ->addBulkAction(DeleteBulkAction::make()->permission('your-model.destroy'))
            ->addBulkChanges([
                NameBulkChange::make(),
                StatusBulkChange::make(),
                CreatedAtBulkChange::make(),
            ])
            ->queryUsing(function (Builder $query) {
                return $query
                    ->select([
                        'id',
                        'name',
                        'created_at',
                        'status',
                    ]);
            });
    }
}
```

--------------------------------

### Adding Tabs to a Form

Source: https://docs.botble.com/cms/form-builder-get-started

This example illustrates how to add tabs to a form. It shows adding a text field and then defining tabs with labels and content, which can include Blade views.

```php
use Botble\Base\Forms\Fields\TextField;
use Botble\Base\Forms\FormTab;

$this
    ->add('title', TextField::class)
    ->addTab(FormTab::make()->label('General')->content('General information'))
    ->add(FormTab::make()->label('Tab 2')->content(view('your-view')))
```

--------------------------------

### Capture UI Block with Specified Theme (Bash)

Source: https://docs.botble.com/cms/shortcode

This command captures a UI block (e.g., faqs) and specifies the theme name. The output path for the screenshot will be relative to the specified theme's public directory.

```bash
npm run screenshot -- faqs --theme=starter --site=http://localhost --url=/faqs
```

--------------------------------

### Plugin.php Lifecycle Methods in Botble CMS

Source: https://docs.botble.com/cms/ai-assistant-guide

Details the lifecycle methods within the `Plugin.php` file for Botble CMS plugins. These methods (`activate`, `deactivate`, `remove`) are called during plugin installation, activation, deactivation, and removal, allowing for necessary setup and cleanup operations.

```php
class Plugin extends PluginOperationAbstract
{
    public static function activate(): void
    {
        // Run when plugin is activated
        // Create tables, seed data, register permissions
    }

    public static function deactivate(): void
    {
        // Run when plugin is deactivated
        // Clean up if needed
    }

    public static function remove(): void
    {
        // Run when plugin is removed
        // Drop tables, clean up data
    }
}
```

--------------------------------

### Example Bulk Change Configurations (PHP)

Source: https://docs.botble.com/cms/table-builder

Demonstrates various built-in bulk change types available in Botble CMS, including name, status, select, date, and featured toggles. These examples show how to instantiate and configure each type.

```php
// Name change
NameBulkChange::make()
    ->title(trans('core/base::tables.name'))

// Status change
StatusBulkChange::make()
    ->title(trans('core/base::tables.status'))

// Custom select change
SelectBulkChange::make()
    ->name('category')
    ->title(trans('plugins/blog::posts.category'))
    ->searchable()
    ->choices(fn () => Category::query()->pluck('name', 'id')->all())

// Date change
DateBulkChange::make()
    ->name('published_date')
    ->title(trans('plugins/blog::posts.published_date'))

// Featured toggle
IsFeaturedBulkChange::make()
    ->title(trans('core/base::tables.is_featured'))
```

--------------------------------

### Install Botble CMS Dependencies with Sail

Source: https://docs.botble.com/cms/installation-using-docker

Installs or updates project dependencies using Composer via the Laravel Sail CLI. This command ensures all necessary PHP packages are downloaded and configured for the project.

```shell
sail composer install
```

--------------------------------

### Create a Theme

Source: https://docs.botble.com/cms/commands

Creates a new theme in the `/platform/themes` directory with a complete structure, including all necessary files and directories for theme development.

```bash
php artisan cms:theme:create <theme>
```

--------------------------------

### Configure SSL with Certbot on Nginx

Source: https://docs.botble.com/cms/domain-migration

Uses Certbot to obtain and install an SSL certificate for Nginx, securing traffic for the specified domain and its www subdomain. This command assumes Certbot is installed and configured for Nginx.

```bash
# Using Let's Encrypt with Certbot
certbot --nginx -d new-domain.com -d www.new-domain.com
```

--------------------------------

### Prepare and Serve Asset Groups in PHP

Source: https://docs.botble.com/cms/theme-development/theme-assets

Shows how to define groups of assets that can be loaded together conditionally. This is useful for managing dependencies and loading assets only when they are needed, improving performance.

```php
// Define a group of assets
Theme::asset()->cook('slider', function($asset) {
    $asset->add('owl-carousel-css', 'libraries/owl-carousel/owl.carousel.css');
    $asset->add('owl-carousel-js', 'libraries/owl-carousel/owl.carousel.js', ['jquery']);
    $asset->add('slider-js', 'js/slider.js', ['owl-carousel-js']);
});

// Later, load the group when needed
Theme::asset()->serve('slider');
```

--------------------------------

### Setting Up Twitter Card (PHP)

Source: https://docs.botble.com/cms/seo-helper

Configures Twitter Card metadata, including title, description, URL, type, and image. This enhances content presentation when shared on Twitter.

```php
SeoHelper::twitter()
    ->setTitle('Your Twitter Card Title')
    ->setDescription('Your Twitter Card Description')
    ->setUrl(url()->current())
    ->setType('summary_large_image')
    ->addImage(RvMedia::getImageUrl('path/to/image.jpg'));
```

--------------------------------

### Checkbox Field in PHP

Source: https://docs.botble.com/cms/form-builder-get-started

A single checkbox for boolean selections. It can be configured with a label and a value.

```php
use Botble\Base\Forms\Fields\CheckboxField;

->add('is_featured', CheckboxField::class, [
    'label' => 'Featured',
    'value' => 1,
])
```

--------------------------------

### Theme Configuration Example in Botble CMS

Source: https://docs.botble.com/cms/theme-development/theme

This PHP code snippet shows an example of theme configuration in Botble CMS, located at `/platform/themes/[theme]/config.php`. It demonstrates how to set up events like 'before' and 'beforeRenderTheme' for meta tags, breadcrumbs, and asset management.

```php
'events' => [
    
    // Before event inherit from package config and the theme that call before,
    // you can use this event to set meta, breadcrumb template or anything
    // you want inheriting.
    'before' => function($theme)
    {
        // You can remove this line anytime.
        $theme->setTitle('Copyright ©  2017 - Botble CMS');
    },
    
    // Listen on event before render a theme,
    // this event should call to assign some assets,
    // breadcrumb template.
    'beforeRenderTheme' => function($theme)
    {
        // You may use this event to set up your assets.
        // $theme->asset()->usePath()->add('core', 'core.js');
        // $theme->asset()->add('jquery', 'vendor/jquery/jquery.min.js');
        // $theme->asset()->add('jquery-ui', 'vendor/jqueryui/jquery-ui.min.js', array('jquery'));
    
    
        // $theme->partialComposer('header', function($view)
        // {
        //     $view->with('auth', Sentinel::user());
        // });
    },
    
    // Listen on event before render a layout,
    // this should call to assign style, script for a layout.
    'beforeRenderLayout' => array(

        'default' => function($theme)
        {
            // $theme->asset()->usePath()->add('ipad', 'css/layouts/ipad.css');
        }

    )
]
```

--------------------------------

### Media File Field in PHP

Source: https://docs.botble.com/cms/form-builder-get-started

A field for uploading and selecting files using the media manager. It can be configured with a label.

```php
use Botble\Base\Forms\Fields\MediaFileField;

->add('attachment', MediaFileField::class, [
    'label' => 'File Attachment',
])
```

--------------------------------

### List Plugins

Source: https://docs.botble.com/cms/commands

Displays a list of all installed plugins along with their current activation status (active or inactive).

```bash
php artisan cms:plugin:list
```

--------------------------------

### On/Off Field in PHP

Source: https://docs.botble.com/cms/form-builder-get-started

A toggle switch for true/false selections, providing a user-friendly way to enable or disable options. It includes a label.

```php
use Botble\Base\Forms\Fields\OnOffField;

->add('is_active', OnOffField::class, [
    'label' => 'Active',
])
```

--------------------------------

### Retrieve FAQs Programmatically in PHP

Source: https://docs.botble.com/cms/plugin-faq

Demonstrates how to retrieve FAQs using the Botble CMS ORM. It shows examples for fetching all published FAQs, FAQs from a specific category, and FAQs with their associated categories. Dependencies include BotbleFaqModelsFaq and BotbleFaqModelsFaqCategory.

```php
use Botble\Faq\Models\Faq;
use Botble\Faq\Models\FaqCategory;

// Get all published FAQs
$faqs = Faq::query()->wherePublished()->get();

// Get FAQs from a specific category
$category = FaqCategory::query()->find($categoryId);
$faqs = $category->faqs()->wherePublished()->get();

// Get FAQs with their categories
$faqs = Faq::query()->with('category')->wherePublished()->get();
```

--------------------------------

### Capture Shortcode Screenshot with Arguments (Bash)

Source: https://docs.botble.com/cms/shortcode

These bash commands illustrate how to use the 'screenshot' npm script to capture preview images of shortcodes. They show basic usage, capturing from a specific URL, and capturing the full page instead of just an element, passing arguments using `--`.

```bash
# Capture a shortcode from homepage

npm run screenshot -- hero-banner --site=http://localhost

# Capture from a specific page

npm run screenshot -- contact-form --site=https://example.com --url=/contact

# Capture full page instead of element

npm run screenshot -- coming-soon --site=http://localhost --url=/coming-soon --full

```

--------------------------------

### Radio Field in PHP

Source: https://docs.botble.com/cms/form-builder-get-started

A field presenting multiple radio buttons for selecting one option from a set. It includes labels and choices.

```php
use Botble\Base\Forms\Fields\RadioField;

->add('status', RadioField::class, [
    'label' => 'Status',
    'choices' => [
        'published' => 'Published',
        'draft' => 'Draft',
        'archived' => 'Archived',
    ],
])
```

--------------------------------

### Activate All Plugins

Source: https://docs.botble.com/cms/commands

Activates all plugins located in the `/platform/plugins` directory. This command simplifies the process of enabling multiple plugins at once.

```bash
php artisan cms:plugin:activate:all
```

--------------------------------

### Select Field in PHP

Source: https://docs.botble.com/cms/form-builder-get-started

A dropdown select field for choosing a single option from a list. It supports labels, choices, and a searchable interface.

```php
use Botble\Base\Forms\Fields\SelectField;
use Botble\Base\Forms\FieldOptions\SelectFieldOption;

->add('category', SelectField::class, SelectFieldOption::make()
    ->label('Category')
    ->choices([
        'tech' => 'Technology',
        'business' => 'Business',
        'lifestyle' => 'Lifestyle',
    ])
    ->searchable()
)
```

--------------------------------

### OnOffCheckboxField: Toggle Switch Input

Source: https://docs.botble.com/cms/form-builder-get-started

Implements a toggle switch styled as a checkbox for boolean options. It's a simple field for binary choices.

```php
use Botble\Base\Forms\Fields\OnOffCheckboxField;

->add('is_visible', OnOffCheckboxField::class, [
    'label' => 'Visible',
])
```

--------------------------------

### Textarea Field in PHP

Source: https://docs.botble.com/cms/form-builder-get-started

A multi-line text input field for capturing longer text entries. It can be configured with labels, rows, and placeholder text.

```php
use Botble\Base\Forms\Fields\TextareaField;
use Botble\Base\Forms\FieldOptions\TextareaFieldOption;

->add('description', TextareaField::class, TextareaFieldOption::make()
    ->label('Description')
    ->rows(5)
    ->placeholder('Enter description')
)
```

--------------------------------

### Displaying a Form

Source: https://docs.botble.com/cms/form-builder-get-started

This code snippet shows how to render a form using its class. It utilizes Blade templating to embed the form directly into your views.

```php
{!! \Botble\Todo\Forms\TodoForm::create()->renderForm() !!}
```

--------------------------------

### Create Spanish Locale using Artisan Command (Bash)

Source: https://docs.botble.com/cms/localization

A specific example of the `cms:locale:create` command, demonstrating how to add Spanish ('es') as a new locale to the admin panel.

```bash
php artisan cms:locale:create es
```

--------------------------------

### Real-World Example: PostTable in Botble CMS Blog Plugin (PHP)

Source: https://docs.botble.com/cms/table-builder

A comprehensive example of a `PostTable` class extending `TableAbstract` from the Botble CMS Blog plugin. It showcases setting up default sorting, adding header and row actions, defining various column types (ID, Image, Name, Formatted, CreatedAt, Status), bulk actions, and bulk changes. The `queryUsing` method demonstrates how to define relationships and select specific fields for the table data.

```php
class PostTable extends TableAbstract
{
    public function setup(): void
    {
        $this->defaultSortColumnName = 'created_at';

        $this
            ->model(Post::class)
            ->addHeaderAction(CreateHeaderAction::make()->route('posts.create'))
            ->addActions([
                EditAction::make()->route('posts.edit'),
                DeleteAction::make()->route('posts.destroy'),
            ])
            ->addColumns([
                IdColumn::make(),
                ImageColumn::make(),
                NameColumn::make()->route('posts.edit'),
                FormattedColumn::make('categories_name')
                    ->title(trans('plugins/blog::posts.categories'))
                    ->width(150)
                    ->orderable(false)
                    ->searchable(false)
                    ->getValueUsing(function (FormattedColumn $column) {
                        $categories = $column
                            ->getItem()
                            ->categories
                            ->sortBy('name')
                            ->map(function (Category $category) {
                                return Html::link(route('categories.edit', $category->getKey()), $category->name, ['target' => '_blank']);
                            })
                            ->all();

                        return implode(', ', $categories);
                    })
                    ->withEmptyState(),
                FormattedColumn::make('author_id')
                    ->title(trans('plugins/blog::posts.author'))
                    ->width(150)
                    ->orderable(false)
                    ->searchable(false)
                    ->getValueUsing(function (FormattedColumn $column) {
                        return $column->getItem()->author_name;
                    })
                    ->renderUsing(function (FormattedColumn $column) {
                        $url = $column->getItem()->author_url;

                        if (! $url) {
                            return null;
                        }

                        return Html::link($url, $column->getItem()->author_name, ['target' => '_blank']);
                    })
                    ->withEmptyState(),
                CreatedAtColumn::make(),
                StatusColumn::make(),
            ])
            ->addBulkActions([
                DeleteBulkAction::make()->permission('posts.destroy'),
            ])
            ->addBulkChanges([
                NameBulkChange::make(),
                StatusBulkChange::make(),
                CreatedAtBulkChange::make(),
                SelectBulkChange::make()
                    ->name('category')
                    ->title(trans('plugins/blog::posts.category'))
                    ->searchable()
                    ->choices(fn () => Category::query()->pluck('name', 'id')->all()),
                IsFeaturedBulkChange::make(),
            ])
            ->queryUsing(function (Builder $query) {
                return $query
                    ->with([
                        'categories' => function (BelongsToMany $query): void {
                            $query->select(['categories.id', 'categories.name']);
                        },
                        'author',
                    ])
                    ->select([
                        'id',
                        'name',
                        'image',
                        'created_at',
                        'status',
                        'updated_at',
                        'author_id',
                        'author_type',
                    ]);
            });
    }
}
```

--------------------------------

### Get Theme Asset URLs in PHP

Source: https://docs.botble.com/cms/theme-development/theme-assets

Explains how to retrieve the URL for a specific theme asset, which can then be used in HTML, for example, to set the `src` attribute for an image.

```php
<img src="{{ Theme::asset()->url('images/logo.png') }}" alt="Logo">
```

--------------------------------

### Gallery Meta Box Implementation

Source: https://docs.botble.com/cms/meta-box

Provides an example of implementing a gallery meta box, showing how to add the meta box, define a callback method to render the gallery field, and save the gallery data using actions.

```php
MetaBox::addMetaBox(
    'gallery_wrap',
    __('Gallery'),
    [$this, 'galleryMetaField'],
    $object::class,
    'advanced'
);

// Callback method
public function galleryMetaField($object)
{
    $value = gallery_meta_data($object);

    return view('plugins.gallery.gallery-box', compact('value', 'object'))->render();
}

// Saving the data
add_action(BASE_ACTION_AFTER_CREATE_CONTENT, function ($type, $request, $object) {
    if (in_array(get_class($object), Gallery::getSupportedModules()) && $request->has('gallery')) {
        MetaBox::saveMetaBoxData($object, 'gallery', $request->input('gallery'));
    }
}, 230, 3);
```

--------------------------------

### HiddenField: Input Hidden Values

Source: https://docs.botble.com/cms/form-builder-get-started

An input field that is not displayed on the form but its value is submitted with the form data. Useful for passing hidden data or tokens.

```php
use Botble\Base\Forms\Fields\HiddenField;

->add('hidden_value', HiddenField::class, [
    'value' => 'some-hidden-value',
])
```

--------------------------------

### GoogleFontsField: Google Fonts Selector

Source: https://docs.botble.com/cms/form-builder-get-started

A specialized field for selecting fonts from the Google Fonts library. It simplifies the process of integrating web fonts into your application.

```php
use Botble\Base\Forms\Fields\GoogleFontsField;

->add('body_font', GoogleFontsField::class, [
    'label' => 'Body Font',
])
```

--------------------------------

### Automate Backups with Cron (Bash)

Source: https://docs.botble.com/cms/plugin-backup

Sets up a cron job to automate weekly backups. This involves editing the crontab and adding a line to execute the backup Artisan command at a specified schedule.

```bash
crontab -e

0 0 * * 0 cd /path/to/your/project && php artisan cms:backup:create "Weekly Backup" --description="Automated weekly backup"
```

--------------------------------

### Multi Check List Field in PHP

Source: https://docs.botble.com/cms/form-builder-get-started

Allows users to select multiple options from a list using checkboxes. It requires labels and a set of choices.

```php
use Botble\Base\Forms\Fields\MultiCheckListField;

->add('features', MultiCheckListField::class, [
    'label' => 'Features',
    'choices' => [
        'featured' => 'Featured',
        'popular' => 'Popular',
        'trending' => 'Trending',
    ],
])
```

--------------------------------

### Configure Database Paths (.env)

Source: https://docs.botble.com/cms/plugin-backup

Specifies the paths to MySQL and PostgreSQL executables in the .env file if they are not in the system's PATH. This ensures the backup plugin can locate and use the necessary database tools.

```dotenv
BACKUP_MYSQL_EXECUTE_PATH=/path/to/mysql/bin/
BACKUP_PGSQL_EXECUTE_PATH=/path/to/pgsql/bin/
```

--------------------------------

### Create Database and File Backup

Source: https://docs.botble.com/cms/commands

Generates a backup of both the database and uploaded files. You can optionally provide a name and description for the backup.

```bash
php artisan cms:backup:create [name] --description=[description]
```

--------------------------------

### File Field in PHP

Source: https://docs.botble.com/cms/form-builder-get-started

A standard file upload field that does not integrate with the media manager. It allows specifying accepted file types via attributes.

```php
use Botble\Base\Forms\Fields\FileField;

->add('document', FileField::class, [
    'label' => 'Upload Document',
    'attr' => [
        'accept' => '.pdf,.doc,.docx',
    ],
])
```

--------------------------------

### Time Field and TimePicker Field in PHP

Source: https://docs.botble.com/cms/form-builder-get-started

Offers standard time input and an interactive time picker. These fields can be configured with labels and time formats.

```php
use Botble\Base\Forms\Fields\TimeField;

->add('event_time', TimeField::class, [
    'label' => 'Event Time',
    'format' => 'HH:mm',
])
```

```php
use Botble\Base\Forms\Fields\TimePickerField;

->add('event_time', TimePickerField::class, [
    'label' => 'Event Time',
])
```

--------------------------------

### Render Icons using Helper Method

Source: https://docs.botble.com/cms/icons

Shows how to render icons programmatically in PHP using the `BaseHelper::renderIcon()` method. This method allows for basic rendering, specifying size, adding attributes, and enabling a safe mode to prevent errors if an icon does not exist. It's useful for dynamic icon rendering in backend logic.

```php
use Botble\Base\Facades\BaseHelper;

// Basic usage
BaseHelper::renderIcon('ti ti-user-heart');

// With size
BaseHelper::renderIcon('ti ti-user-heart', 'lg');

// With additional attributes
BaseHelper::renderIcon('ti ti-user-heart', null, [
    'class' => 'text-primary',
    'data-bs-toggle' => 'tooltip',
    'title' => 'User Profile',
]);

// Safe mode (won't throw an error if icon doesn't exist)
BaseHelper::renderIcon('ti ti-nonexistent-icon', null, [], true);
```

--------------------------------

### Removing Master Layout from Form

Source: https://docs.botble.com/cms/form-builder-get-started

This code shows how to create a form that only renders its content without any master layout wrapper, using the 'contentOnly()' method.

```php
use Botble\Base\Forms\Fields\TextField;

$this
    ->contentOnly() // Remove master layout from form
    ->add('field1', TextField::class, TextFieldOption::make())
    ->add('field2', TextField::class, TextFieldOption::make());
```

--------------------------------

### Create a Package

Source: https://docs.botble.com/cms/commands

Generates a new package structure within the `/platform/packages` directory. After creation, the package needs to be registered in `composer.json` and `composer update` must be run.

```bash
php artisan cms:package:create <package>
```

--------------------------------

### Stop Botble CMS Services with Sail

Source: https://docs.botble.com/cms/installation-using-docker

Stops the running Docker services for Botble CMS. This command gracefully shuts down the containers managed by Laravel Sail.

```shell
sail down
```

--------------------------------

### Capture UI Block with Custom URL and Output (Bash)

Source: https://docs.botble.com/cms/shortcode

This command captures a UI block (e.g., testimonials) from a production site, specifying a custom page URL and an output directory for the screenshot. This allows for targeted capture and organized storage.

```bash
npm run screenshot -- testimonials --site=https://example.com --url=/about --output=~/Downloads
```

--------------------------------

### HtmlField: Render Raw HTML

Source: https://docs.botble.com/cms/form-builder-get-started

Allows rendering raw HTML content directly within a form. This field is intended for display purposes and is not an input field.

```php
use Botble\Base\Forms\Fields\HtmlField;

->add('custom_html', HtmlField::class, [
    'html' => '<div class="alert alert-info">Custom HTML content</div>',
])
```

--------------------------------

### Install Botble CMS using Composer

Source: https://docs.botble.com/cms/index

This command installs Botble CMS by creating a new project using Composer. It requires Composer to be installed on your system. The command downloads the latest version of Botble CMS and sets up a new project directory.

```bash
composer create-project botble/cms your-project-name
cd your-project-name
php artisan cms:install
```

--------------------------------

### Install Puppeteer for Screenshot Generation (Bash)

Source: https://docs.botble.com/cms/shortcode

This bash command installs the Puppeteer library as a development dependency in your project. Puppeteer is a Node.js library that provides a high-level API to control Chrome or Chromium over the DevTools Protocol, used here for capturing shortcode screenshots.

```bash
npm install puppeteer --save-dev

```

--------------------------------

### UiSelectorField: UI Element Selector

Source: https://docs.botble.com/cms/form-builder-get-started

A field for selecting predefined UI elements. This can be used to choose specific components or styles within the application's interface.

```php
use Botble\Base\Forms\Fields\UiSelectorField;

->add('ui_element', UiSelectorField::class, [
    'label' => 'UI Element',
])
```

--------------------------------

### ColorSelectorField: Advanced Color Palette

Source: https://docs.botble.com/cms/form-builder-get-started

An advanced color selector that provides a palette of predefined colors for users to choose from. This offers a more curated selection than a simple picker.

```php
use Botble\Base\Forms\Fields\ColorSelectorField;

->add('theme_color', ColorSelectorField::class, [
    'label' => 'Theme Color',
])
```

--------------------------------

### Import Database Backup using MySQL

Source: https://docs.botble.com/cms/domain-migration

Imports a SQL database backup file into your MySQL database. Ensure you have the correct username, password, and database name. This command assumes the backup file is in the current directory.

```bash
mysql -u user -p database < backup.sql
```

--------------------------------

### Media Image and Media Images Fields in PHP

Source: https://docs.botble.com/cms/form-builder-get-started

Fields for uploading and selecting single or multiple images via the media manager. They allow for setting labels.

```php
use Botble\Base\Forms\Fields\MediaImageField;
use Botble\Base\Forms\FieldOptions\MediaImageFieldOption;

->add('featured_image', MediaImageField::class, MediaImageFieldOption::make()
    ->label('Featured Image')
)
```

```php
use Botble\Base\Forms\Fields\MediaImagesField;

->add('gallery_images', MediaImagesField::class, [
    'label' => 'Gallery Images',
])
```