The short answer: When a photo is added to your Piwigo gallery, S3Upload plugin uploads the (full size) image to your Amazon S3 account, and when viewing an individual photo a download link to the S3 image is provided.
The long answer: When a photo is added to your Piwigo gallery (your database table holding the index of images is updated), S3Upload queues those newly added photos to be processed for uploading a full-size copy to your configured Amazon S3 bucket of choice.
When a queued image is confirmed successfully uploaded to S3, it is cleared from an index of queued files pending upload.
Any upload transfer attempts that fail are displayed in the "10 Most Recent Pending Uploads to S3" table in this tab. The status column indicates the error code. Common problems: 'failed_code_0' likely means bad AWS bucket or location constraint. 'failed_code_403' likely means bad AWS key and/or password. 'failed_code_404' likely means bad bucket.
Once a bad configuration is corrected, the previously failed uploads should succeed and the failure records in the Pending table will clear and the (last 10) uploads will appear in the Success table.
Each S3 uploaded photo will (optional) have a download link in the Piwigo photo display info box.
2 methods of photo uploading are provided. Method 1#: Active Monitoring (while enabled) will queue and upload every photo that's added to the gallery *AFTER* the installation of the S3Upload plugin. Method #2: the Piwigo Batch Manager will have an S3Upload command in the dropdown—it queues for uploading files selected in the Batch Manager. The Batch manager method can be used to S3 upload photos that were added to gallery before the plugin was installed.
Photos added while Active Monitoring is disabled will not be queued/uploaded when monitoring is re-enabled. Use Batch Manager method to select any photos to be S3 uploaded.
Requirements:
Limitations:
Notes:
The bucket to storage copy of photo uploads to Piwigo. (you can create a new one just for Piwigo photos or use an existing one.
Examples:
photos.mydomain.com, piwigo_originals, photography
The bucket path used as the AWS file key for storing a copy of each photo upload. This is the base path used for S3 (option: Add Timestamp/Unique to Path/File for S3 Image Location, under S3Upload Configuration tab, adds a subpath to the base path per image.
Examples:
i/, images/, piwigo/photos/originals/
If left blank then the root of the bucket is used for file storage (unless augmented by Add Timestamp/Unique to Path/File for S3 Image Location option).
Special thanks to the Piwigo team / extension developer community, especially J.Commelin and mistic100, for the Skeleton plugin (scaffolding code to build new plugins), upon which this S3Upload was bootstrapped.
Copyright (c) 2013 Micah Wittman <wittman.org>
Dual licensed under the MIT and GPL licenses.