laravel-admin

You can display data from related models using Eloquent relationship names. This works for One-to-One, One-to-Many, and Many-to-Many relationships.

Syntax Options:

1. Dot notation: $grid->column('relation.field');
2. Relationship method: $grid->relation()->field();

Relationship Types:

• One-to-One: Access fields from the related model (e.g., profile.age).
• One-to-Many: Access the collection of related models. You can use display() to count or format the related items (e.g., counting comments).
• Many-to-Many: Access the collection of related models (e.g., roles). Use display() to iterate through the collection and format them (e.g., as labels).

// One-to-One: Accessing profile age from User grid
$grid->column('profile.age');
// or
$grid->profile()->age();

// One-to-Many: Counting comments in a Post grid
$grid->comments('Comments count')->display(function ($comments) {
    return count($comments);
});

// Many-to-Many: Displaying roles in a User grid
$grid->roles()->display(function ($roles) {
    return join(' ', array_map(function ($role) {
        return "<span class='label label-success'>{$role['name']}</span>";
    }, $roles));
});

laravel-admin utilizes the Bootstrap grid system, where each row is divided into 12 units. You can structure your content using row(), column(), and nested structures.

Basic Row and Columns

Use $content->row() to add a full-width line or a container for columns. Inside a row, use $row->column(size, content) where size is an integer from 1 to 12.

Nesting Rows and Columns

You can nest columns within columns, and rows within columns, to create complex layouts.

• Column in a Column: Pass a closure to $row->column() to receive a Column object, then call $column->row() inside it.
• Row in a Row: Pass a closure to $column->row() to receive a Row object, then call $row->column() inside it.

// Example of nested columns and rows
$content->row(function (Row $row) {
    $row->column(4, 'xxx');

    $row->column(8, function (Column $column) {
        $column->row('111');
        $column->row(function(Row $row) {
            $row->column(6, '444');
            $row->column(6, '555');
        });
    });
});

Use the Encore Adminorm method via the Admin facade to generate a form based on an Eloquent model. Inside the callback, use the Form instance to define various input fields that correspond to your database columns.

Common field methods include:

• $form->display('column', 'Label'): Displays a read-only value.
• $form->text('column', 'Label'): Text input.
• $form->textarea('column', 'Label'): Textarea.
• $form->select('column', 'Label')->options($array): Dropdown selection.
• $form->number('column', 'Label'): Numeric input.
• $form->switch('column', 'Label'): Boolean switch.
• $form->dateTime('column', 'Label'): Date and time picker.

use App\Models\Movie;
use Encore\Admin\Form;
use Encore\Admin\Facades\Admin;

Admin::form(Movie::class, function (Form $form) {
    $form->display('id', 'ID');
    $form->text('title', 'Movie title');
    
    $directors = [1 => 'John', 2 => 'Smith'];
    $form->select('director', 'Director')->options($directors);
    
    $form->textarea('describe', 'Describe');
    $form->number('rate', 'Rate');
    $form->switch('released', 'Released?');
    $form->dateTime('release_at', 'release time');
});

Since version 1.5, laravel-admin no longer includes built-in chart components. To add charts, you must manually include a JavaScript library (like chartjs) and render it via a custom Blade view.

Follow these steps:

1. Download the library: Place the library files in your public directory (e.g., public/vendor/chartjs).
2. Register the assets: Use Admin::js() in app/Admin/bootstrap.php to make the library available globally in the admin panel.
3. Create a view: Create a Blade file containing the HTML <canvas> element and the <script> logic required by your chosen library.
4. Render the view: Use $content->body(view('your.view.path')) within an admin controller to display the chart.

// 1. In app/Admin/bootstrap.php
use Encore	Admin\Facades\Admin;
Admin::js('/vendor/chartjs/dist/Chart.min.js');

// 2. In your Controller
public function index()
{
    return Admin::content(function (Content $content) {
        $content->header('Chart Overview');
        $content->body(view('admin.charts.bar'));
    });
}