Craft Coconut

Transcode your Craft video assets with Coconut.co.

Usage

• Create a new coconut.php file in your Craft-CMS config folder with the contents of vendor/yoannisj/craft-coconut/src/config.php
• Change the configuration settings according to your needs (see comments for more info)
• Use $outputs = Coconut::$plugin->transcodeVideo($video, $outputs) %} in PHP
• Use {% set outputs = craft.coconut.transcodeVideo(video, outputs) %} in Twig

The syntax for the outputs parameter is explained in the config file (see comment for the jobs setting).

Development

Manual Testing

1. docker-compose up -d
2. http://localhost:8080
   • username: craftcms
   • password: craftcms2018!!

Todo

• Fix "Transcode Video Assets" element action

• Fix "Clear Coconut Outputs" element action

• Add support for job settings (e.g. ultra-fast mode)

• Better job error handling

• Preserve coconutJobId value in database (check if it is of any use after the job has completed)?

• Add file path to outputs db so legacy files can be deleted even if volume's baseUrl changes (e.g. a CDN/proxy was added)

• Write tests for the upload controller action

• Write tests for the webhook controller action

• Better management of output files

  • 1. Check if output record was deleted in upload action, and don't create corresponding file
  • 2. Check if output record was deleted in webhook action, and remove corresponding file from volume (careful if newer job uses the output url)

• Check asset file modified date in TranscodeVideo action

• Implement "Transcode Video Assets" CLI command

• Implement "Transcode Video Assets" utility

• Implement "Clear Coconut Outputs" CLI command

• Implement "Clear Coconut Outputs" utility