Download the PHP package bnomei/kirby3-cloudconvert without Composer
On this page you can find all versions of the php package bnomei/kirby3-cloudconvert. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download bnomei/kirby3-cloudconvert
More information about bnomei/kirby3-cloudconvert
Files in bnomei/kirby3-cloudconvert
Package kirby3-cloudconvert
Short Description Plugin to convert anything to anything using cloudconvert.
License MIT
Informations about the package kirby3-cloudconvert
Kirby 3 Cloudconvert
Plugin to convert anything to anything using cloudconvert.
Commerical Usage
Support open source!
This plugin is free but if you use it in a commercial project please consider to sponsor me or make a donation.
If my work helped you to make some cash it seems fair to me that I might get a little reward as well, right?
Be kind. Share a little. Thanks.
‐ Bruno
M | O | N | E | Y |
---|---|---|---|---|
Github sponsor | Patreon | Buy Me a Coffee | Paypal dontation | Hire me |
Installation
- unzip master.zip as folder
site/plugins/kirby3-cloudconvert
or git submodule add https://github.com/bnomei/kirby3-cloudconvert.git site/plugins/kirby3-cloudconvert
orcomposer require bnomei/kirby3-cloudconvert
How to convert files on demand (synchronously)?
Example 1: docx to pdf
Hooks: How to convert files on upload/replace (asynchronously by default)?
Example 2: gif to webm and mp4
In Kirbys config file add this... then use panel to upload a gif to an image/file section.
Other Usecases
Example 3: convert ai to svg and optimize
This example shows how to use this plugin with my thumb imageoptim plugin.
Example 4: How to convert image files for srcsets? jpg to webp.
This example shows how to use this plugin with my srcset plugin.
config file
Global cloudconvert helper function
This plugin provides a helper function to call the cloudconvert api.
Retrun Values
Kirby\Cms\File
if$options['file']
is one as well and$async == false
- otherwise it returns an instance of
CloudConvert\Process
- or
null
on error
Performance
TD;DR Calling File-Method has best performance since it only converts the file if it was modified or is new.
File-Object
Using Kirby\Cms\File
object for $options['file']
is recommended. In that case the modified timestamp will be checked against a cached value and a conversion triggered only if a file was modified or output does not exist. This is the default behaviour for the FileMethod provided by this plugin.
DANGER: There is no check (yet) if a file is currently processed by cloudconvert. This might be improved at a later point.
Path
When a path is used then file will be created only if ouput does not exist. You need to do modification checks and removing of old files yourself before starting the conversion.
Settings
bnomei.cloudconvert. | Default | Description |
---|---|---|
apikey | null |
your cloudconvert apikey as string |
convert | callback |
asynchronous or synchronous conversion depending on params. |
async | true |
|
options | ['input' => 'download'] |
By default this plugin requires the file to be public otherwise use upload here. On localhost upload is used as a default. |
log.enabled | false |
|
log | callback |
to kirbyLog() |
TIP: you can also set a callback if you use the dotenv Plugin
'bnomei.cloudconvert.apikey' => function() { return env('CLOUDCONVERT_APIKEY'); },
TIP: consider setting up presets to manage your settings from within the cloudconvert dashboard instead of the Kirby config file.
Disclaimer
This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please create a new issue.
License
It is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.
All versions of kirby3-cloudconvert with dependencies
cloudconvert/cloudconvert-php Version ^2.2
getkirby/composer-installer Version ^1.1