imagina/imedia-module

Imagina imedia laravel module

10.0.0 2024-06-11 16:26 UTC

Requires

• php: ^8.1
• composer/installers: ~1.0
• guzzlehttp/psr7: ^2.6
• imagina/tag-module: ^10.0
• intervention/image: ^2.5

Requires (Dev)

• doctrine/dbal: ^3.5
• friendsofphp/php-cs-fixer: ^3.27.0
• league/flysystem-aws-s3-v3: ^3.0
• mockery/mockery: ^1.4.4
• orchestra/testbench: ^8.5
• phpunit/phpunit: ^10

MIT

• Nicolas Widart

• media
• library
• files
• filters
• Thumbnails
• asgardcms

README

Private Files Configurations

- The bucker must have the permissions configured correctly
- Read and write should be set only for the allowed user

Implementation with Modules

In the Entity (Models/Entity)

• Add Events

 public array $dispatchesEventsWithBindings = [
    'created' => [['path' => 'Modules\Imedia\Events\CreateMedia']],
    'creating' => [],
    'updated' => [['path' => 'Modules\Imedia\Events\UpdateMedia']],
    'updating' => [],
    'deleting' => [['path' => 'Modules\Imedia\Events\DeleteMedia']],
    'deleted' => []
];

• Add the zones

/**
* Media Fillable
*/
public $mediaFillable = [
    'mainimage' => 'single'
];

• Add relation:

/**
* Relation Media
* Make the Many To Many Morph
*/
public function files()
{
    if (isModuleEnabled('Imedia')) {
        return app(\Modules\Imedia\Relations\FilesRelation::class)->resolve($this);
    }
    return new \Imagina\Icore\Relations\EmptyRelation();
}

In Transformer (Transformers/EntityTransformer)

• Add relation with files

//Implementation with Media
 return [
    'files' => $this->whenLoaded('files', fn() => $this->files->byZones($this->mediaFillable, $this)),
];

Endpoint | Attributes Example

• To Media single , add zone and file id.

attributes[medias_single][$zone] = $fileId

Example: Zone = mainimage

attributes[medias_single][mainimage] = 1

• To Media gallery, add zone and files array ids.

attributes[medias_multi][$zone][files][] = $fileId

Example: Zone = gallery

attributes[medias_multi][gallery][files][] = 1
attributes[medias_multi][gallery][files][] = 2