YurbaCMF

$user = App\Models\User::first();   // or User::factory()->create([...])
$user->is_admin = true;
$user->save();

composer update yurba/cmf
php artisan vendor:publish --tag=yurba-assets --force
php artisan migrate

// database/migrations/…_create_posts_table.php
Schema::create('posts', function (Blueprint $table) {
    $table->id();
    $table->string('title');
    $table->string('slug')->unique();
    $table->string('status')->default('draft');
    $table->foreignId('category_id')->nullable()->constrained();
    $table->text('body')->nullable();
    $table->json('tags')->nullable();
    $table->string('cover')->nullable();
    $table->timestamp('published_at')->nullable();
    $table->timestamps();
});

// app/Models/Post.php
class Post extends Model
{
    protected $guarded = [];

    protected $casts = [
        'tags'         => 'array',    // Tags / Repeater fields
        'published_at' => 'datetime', // Date field
    ];

    public function category()
    {
        return $this->belongsTo(Category::class);
    }
}

namespace App\Admin;

use App\Models\Post;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Http\Request;
use Yurba\Cmf\Resources\Resource;

class PostResource extends Resource
{
    public static string $model = Post::class;

    public function label(): string { return 'Article'; }

    public function icon(): ?string
    {
        return '<span class="material-symbols-rounded">article</span>';
    }

    // eager-load the author so the index list avoids N+1
    public function indexQuery(Request $request): Builder
    {
        return parent::indexQuery($request)->with('author');
    }

    public function fields(): array
    {
        return [ /* ... */ ];
    }
}

use Yurba\Cmf\Fields\{Text, Number, Boolean, Select, Date, Image, Editor, Computed, SeoField};

public function fields(): array
{
    return [
        Text::make('title')->searchable()->sortable()->rules('required|max:255'),
        Number::make('price')->rules('numeric|min:0'),
        Boolean::make('is_featured')->default(false),
        Select::make('status')
            ->options(['draft' => 'Draft', 'publish' => 'Published'])
            ->default('draft'),
        Date::make('published_at')->withTime()->onlyOnForm(),
        Image::make('cover')->dir('covers')->onlyOnForm(),
        Editor::make('body')
            ->toolbar(['bold', 'italic', 'link', 'ul', 'ol'])
            ->maxChars(5000)
            ->onlyOnForm(),
        Computed::make('reading_time', 'Read time')
            ->using(fn ($post) => ceil(str_word_count(strip_tags((string) $post->body)) / 200).' min'),
        SeoField::make('seo')->tab('SEO'),
    ];
}

use Yurba\Cmf\Fields\{BelongsTo, BelongsToMany, Repeater, Date, Image, Tags};

// FK select - field name is the FK column; say which model and title column
BelongsTo::make('category_id', 'Category')
    ->relatedModel(Category::class)
    ->title('name')
    ->nullable(),

// many-to-many multi-select - synced to the pivot after save.
// field name is the relation method (override with ->relation('...'))
BelongsToMany::make('tags')
    ->relatedModel(Tag::class)
    ->title('name'),

// repeating rows in a json column - declare the columns
Repeater::make('specs')
    ->columns(['label' => 'Label', 'value' => 'Value'])
    ->addLabel('Add spec')
    ->stacked(),

Date::make('published_at')->withTime(),
Image::make('cover')->dir('covers'),
Tags::make('keywords'),

use Yurba\Cmf\Filters\SelectFilter;
use Yurba\Cmf\Filters\BooleanFilter;
use Yurba\Cmf\Filters\DateRangeFilter;

public function filters(): array
{
    return [
        SelectFilter::make('status')->options([
            'draft'   => 'Draft',
            'publish' => 'Published',
        ]),
        BooleanFilter::make('featured'),
        DateRangeFilter::make('created_at', 'Created'),
    ];
}

use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Collection;

// one button per row, keyed by action name
public function rowActions(?Model $record = null): array
{
    // 'icon' is a Material Symbols name or your own HTML
    return ['duplicate' => ['label' => 'Duplicate', 'icon' => 'content_copy']];
}

public function runAction(string $action, Model $record): void
{
    if ($action === 'duplicate') {
        $record->replicate()->save();
    }
}

// [key => label]; non-empty enables the selection checkboxes
public function bulkActions(): array
{
    return ['publish' => 'Publish selected'];
}

public function runBulk(string $action, Collection $records): void
{
    if ($action === 'publish') {
        $records->each->update(['status' => 'publish']);
    }
}

public function hasRevisions(): bool { return true; }
public function revisionsLimit(): int { return 50; }

public function publishing(): ?array
{
    return [
        'status'    => 'status',       // the status column
        'date'      => 'published_at', // when to go live
        'draft'     => 'draft',        // status values ↓
        'scheduled' => 'scheduled',
        'published' => 'publish',
    ];
}

# a single cron entry drives Laravel's scheduler
* * * * * cd /path/to/app && php artisan schedule:run >> /dev/null 2>&1

// in the resource
public function previewRoute(Model $record): ?array
{
    return ['blog.show', ['post' => $record->slug]];
}

// on the frontend route
Route::get('/blog/{post}', PostController::class)
    ->middleware('signed')   // or check $request->hasValidSignature()
    ->name('blog.show');

use Yurba\Cmf\Fields\SeoField;

public function fields(): array
{
    return [
        // ...content fields...
        SeoField::make()->tab('SEO'),
    ];
}

use Yurba\Cmf\Seo\Seo;

$meta = Seo::resolve($post, [
    'title'       => $post->title,
    'description' => $post->excerpt,
]);
// => ['title' => ..., 'description' => ..., 'image' => ..., 'noindex' => false]

<title>{{ $meta['title'] }}</title>
<meta name="description" content="{{ $meta['description'] }}">
@if($meta['noindex']) <meta name="robots" content="noindex"> @endif

use Yurba\Cmf\Fields\Media;
use Yurba\Cmf\Fields\Image;

Media::make('cover'),
Image::make('thumbnail')->dir('thumbs'),

use Yurba\Cmf\Fields\Media;
use Yurba\Cmf\Media\Media as MediaFile;

// in a resource - render the 'small' preset in the table
Media::make('cover')->thumb('small'),

// on the frontend - a preset name or a raw width
<img src="{{ MediaFile::thumb($post->cover, 'large') }}" alt="">
<img src="{{ MediaFile::thumb($post->cover, 800) }}" alt="">

// config/yurba.php
return [

    // Branding
    'brand'      => env('YURBA_BRAND', 'YurbaCMF'),
    'logo'       => env('YURBA_LOGO', null),
    'hide_brand' => env('YURBA_HIDE_BRAND', false),

    // Panel interface language (English needs no language pack)
    'locale'  => env('YURBA_LOCALE', 'en'),
    'locales' => [
        'en' => 'English',
        'ru' => 'Русский',
        'uk' => 'Українська',
    ],

    // Routing & auth
    'prefix'     => env('YURBA_PREFIX', 'admin'),
    'middleware' => ['web'],
    'guard'      => env('YURBA_GUARD', 'web'),

    // Your resources & settings pages
    'resources' => [
        // App\Admin\PostResource::class,
    ],
    'settings' => [
        // App\Admin\Settings\GeneralSettings::class,
    ],
    'builtin_settings' => true,

    // Custom panel screens (classes extending Yurba\Cmf\Pages\Page)
    'pages' => [
        // App\Admin\Pages\ReportsPage::class,
        // [App\Admin\Pages\SectionPage::class, 'header', 'Header'],   // with args
    ],

    'action_icons'      => true,
    'publish_scheduler' => true,
    'per_page'          => 20,

    // Extra assets injected into the panel
    'styles'  => [],
    'scripts' => [],
    'head'    => null,
    'foot'    => null,

    // Inline editor image uploads
    'uploads' => [
        'dir'    => 'uploads/editor',
        'max_kb' => 4096,
        'mimes'  => 'jpeg,jpg,png,gif,webp,avif',
    ],

    // Media library
    'media' => [
        'enabled'       => env('YURBA_MEDIA', true),
        'disk'          => env('YURBA_MEDIA_DISK', 'public'),
        'relative_urls' => env('YURBA_MEDIA_RELATIVE_URLS', true),
        'dir'           => 'media',
        'mimes'         => 'jpeg,jpg,png,gif,webp,avif,pdf',
        'max_kb'        => 8192,
        'per_page'      => 28,
        'optimize'      => env('YURBA_MEDIA_OPTIMIZE', true),
        'max_width'     => 2560,
        'quality'       => 82,
        // thumbnails are generated on demand and cached under {dir}-thumbs/{width}/
        'thumb_presets' => ['small' => 320, 'medium' => 640, 'large' => 1280],
        'thumb_default' => 'small',
        // optimization log (Settings → Optimize images → log); log_keep bounds the table
        'log'           => env('YURBA_MEDIA_LOG', true),
        'log_keep'      => env('YURBA_MEDIA_LOG_KEEP', 1000),
    ],

    // URL redirects
    'redirects' => [
        'enabled'  => env('YURBA_REDIRECTS', true),
        'log_hits' => true,
    ],

    // Public XML sitemap
    'sitemap' => [
        'enabled' => env('YURBA_SITEMAP', true),
        'static'  => [],
        'sources' => [
            // [
            //     'model' => App\Models\Post::class,
            //     'route' => 'blog.show', 'param' => 'post', 'key' => 'slug',
            //     'scope' => 'published', 'lastmod' => 'updated_at',
            //     'changefreq' => 'weekly', 'priority' => '0.7',
            // ],
        ],
        // Optional: split into several files. When set, /sitemap.xml becomes a
        //  and each entry is served at /sitemap-{name}.xml.
        // 'sitemaps' => [
        //     'pages' => ['static' => ['/', '/about']],
        //     'blog'  => ['sources' => [/* …as above… */]],
        // ],
    ],

    // Rich-text editor driver: 'yurba' | 'none' | 'custom'
    'editor' => [
        'driver'  => env('YURBA_EDITOR', 'yurba'),
        'styles'  => [],
        'scripts' => [],
        'init'    => null,
        'icons'   => [], // YurbaEditor's icons, by its keys
    ],

    // Progressive UI enhancements (turn any off to fall back to native)
    'ui' => [
        'select' => env('YURBA_UI_SELECT', true),
        'viewer' => env('YURBA_UI_VIEWER', true),
        'icons'  => env('YURBA_UI_ICONS', true),
        'icon_html'    => [], // your own icons in place of the panel's symbols
        'viewer_icons' => [], // YurbaPV's icons, by its keys
    ],
];

namespace App\Admin\Settings;

use Yurba\Cmf\Settings\SettingsPage;
use Yurba\Cmf\Fields\Text;
use Yurba\Cmf\Fields\Boolean;

class GeneralSettings extends SettingsPage
{
    public function fields(): array
    {
        return [
            Text::make('site_title', 'Site title')->rules('required'),
            Text::make('support_email', 'Support email')->rules('nullable|email'),
            Boolean::make('maintenance', 'Maintenance mode'),
        ];
    }
}

use Yurba\Cmf\Settings\Store;

$title = Store::get('site_title', 'My site');
$down  = (bool) Store::get('maintenance', false);

namespace App\Admin\Pages;

use Illuminate\Http\Request;
use Yurba\Cmf\Pages\Page;

class ReportsPage extends Page
{
    public function label(): string { return 'Reports'; }

    public function icon(): ?string
    {
        return '<span class="material-symbols-rounded">bar_chart</span>';
    }

    public function render(Request $request): mixed
    {
        return view('admin.reports', [
            'signups' => \App\Models\User::whereDate('created_at', today())->count(),
        ]);
    }
}

namespace App\Admin\Pages;

use Yurba\Cmf\Content\ContentPage;
use Yurba\Cmf\Fields\Editor;
use Yurba\Cmf\Fields\Image;
use Yurba\Cmf\Fields\Repeater;
use Yurba\Cmf\Fields\Text;

class HomeContent extends ContentPage
{
    public function label(): string { return 'Home page'; }

    public function fields(): array
    {
        return [
            Text::make('hero_title'),
            Editor::make('intro'),
            Image::make('hero_bg')->dir('content'),
            // repeating blocks - the whole point of per-page structure
            Repeater::make('features')->columns(['title' => 'Title', 'text' => 'Text']),
        ];
    }
}

use Yurba\Cmf\Content\Content;

$home = Content::get('home');                 // ['hero_title' => ..., 'features' => [...]]
$title = Content::field('home', 'hero_title', 'Welcome');

// or the global shorthand (same thing), handy in Blade:
content('home', 'hero_title', 'Welcome');

// config/yurba.php
'locale'  => env('YURBA_LOCALE', 'en'),
'locales' => [
    'en' => 'English',
    'ru' => 'Русский',
    'uk' => 'Українська',
],

php artisan vendor:publish --tag=yurba-lang   # copies lang/{ru,uk}.json into your app

{{ $post->tr('title') }}

// config/yurba.php
'multilang' => [
    'enabled' => true,
    'default' => 'en',
    'locales' => [
        'en' => ['label' => 'English', 'slug' => 'en'],
        'uk' => ['label' => 'Українська', 'slug' => 'uk'],
    ],
],

[data-yurba] {
    --y-accent: #16a34a;
    --y-accent-ink: #15803d;
}

'ui' => [
    'icon_html' => [
        'edit'   => '<svg viewBox="0 0 24 24" width="20" height="20">…</svg>',
        'delete' => '<i class="my-icon my-icon-trash"></i>',
    ],
],