51 lines
1.3 KiB
Markdown
51 lines
1.3 KiB
Markdown
|
# Kirby ZipDownload
|
||
|
|
|
||
|
|
This [Kirby CMS](http://getkirby.com) plugin provides basic capacity to select & download multiple files as a zip.
|
||
|
|
|
||
|
|
|
||
|
|
## Version
|
||
|
|
|
||
|
|
0.1 : initial release
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
1. Copy the plugin folder to `site/plugins`.
|
||
|
|
2. Make the folder `kirby-zipdownload/temp` writable.
|
||
|
|
3. Setup your server's `cron` file to execute `kirby-zipdownload/cron.php` regularly, so it empties `kirby-zipdownload/temp`.
|
||
|
|
4. Modify your template files and customize the snippets to your needs.
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
There's two way to use the plugin.
|
||
|
|
|
||
|
|
### The simple way
|
||
|
|
|
||
|
|
Use the `asset_gallery` snippet, it's adapted from Kirby default theme's Projects template.
|
||
|
|
|
||
|
|
### The custom way
|
||
|
|
|
||
|
|
Use the `btn_dl` snippet where you want it. It's got an ID attribute so it's better if you don't reuse it.
|
||
|
|
|
||
|
|
Then, in the loop calling all the images/documents, use the snippet `checkbox`.
|
||
|
|
|
||
|
|
### Going further
|
||
|
|
|
||
|
|
The checkboxes can be styled and scripted at will, it's the checked/unchecked state that counts when the form is sent (via a POST request). You can hide the checkboxes and check them in JavaScript through other means.
|
||
|
|
|
||
|
|
## TODO
|
||
|
|
|
||
|
|
- i18n of the error message
|
||
|
|
- Using smaller versions of the images to fill the zip through the thumbnail API
|
||
|
|
(or ask the content editors to upload smaller images?)
|
||
|
|
- Basic CSS styles
|
||
|
|
|
||
|
|
## Copyright
|
||
|
|
|
||
|
|
© 2016 Joachim Robert
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
MIT License
|
||
|
|
|
||
|
|
|