Usage:
This shortcode is designed to generate an Amazon S3 self-expiring link, based on information provided in the “Amazon S3 Links” option panel or override parameters in the shortcode itself.
This shortcode does NOT supports conditional branching with [ELSE_s3link].
Shortcode nesting is NOT supported.
Parameters:
| s3key | Your S3 Key, to override anything entered in the settings panel. Default: none/See options panel. Required: no. |
| s3secret | Your S3 Secret, to override anything entered in the settings panel. Default: none/See options panel. Required: no. |
| protocol | The protocol to be used in building the URL, either ‘http’ or ‘https’. Use this parameter when creating download links (<a href>). Leave it out when building link for video and audio players. Default: https. Required: no. |
| host | The Amazon host name where your file is located, if you want to override the information provided in the ‘Amazon S3 Links” options panel. In 99.99% of the cases, it will always be s3.amazonaws.com Default: none/See options panel. Required: no. |
| bucket | The name of the bucket where the file is stored, if other than the one specified in the options panel. The bucket name should not include any path information. Default: none/See options panel. Required: no. |
| object | The file name for which a self-expiring link should be generated. If the file is located in a folder, specify the file path relative to the bucket. Default: none. Required: yes. |
| expire | Specifies the number of seconds after which the generated link loses validity. Default: none/See options panel. Required: no. |
Example:
[i4w_s3link object='folder/file']
[i4w_s3link protocol='https' bucket='bucketname' object='folder/file']
[i4w_s3link s3key='myS3key' s3secret='myS3secret' bucket='bucketname' object='folder/file']
[i4w_s3link protocol='https' host='s3.amazonaws.com' object='folder/file' expire='240']
<a>Your anchor text</a>(following normal HTML rules for links)
Notes:
This shortcode generates a link with a number of S3-specific parameters. Some video player plugins are not able to handle these types of links.
Please note that we cannot provide support for those plugins and shortcodes.
API:
There is no API function equivalent for this shortcode.