Attachments

Cover and slides media collections for pages and blocks.

Pages and blocks use oi-lab/oi-laravel-attachments for media. The collections are:

Pages: cover (single image).
Blocks: cover (single image) and slides (ordered gallery, used by the slides carousel template).

Attaching files

php

$page->attachFile($file, 'cover');
$page->cover;                  // MorphOne attachment
$page->cover?->file;           // the File model

$block->attachFile($file, 'cover');
$block->syncAttachments([$slideA, $slideB], 'slides'); // ordered
$block->slides()->get();       // ordered slides

Storing uploads

Use the attachments package action to store an upload and attach it in one step:

php

use OiLab\OiLaravelAttachments\Actions\AttachUploadedFiles;

AttachUploadedFiles::handle($block, $request->file('slides') ?? [], 'slides');

if ($request->file('cover')) {
    AttachUploadedFiles::handle($block, [$request->file('cover')], 'cover');
}

The form requests validate cover and slides uploads for you.

Configuring collections

The collections and upload limits are configurable under the attachments key:

php

'attachments' => [
    'page'  => ['cover'],
    'block' => ['cover', 'slides'],
    'max_files' => 30,
    'max_file_size' => 10240, // kilobytes
],

Typed props

How the props JSON column is typed with spatie/laravel-data and the PropsCast.

Configuration

Overview of configuring OI Laravel Publish — the config file and its available keys.