home / ExpressionEngine add-ons / Simple S3 Uploader / Settings

Simple S3 Uploader Settings

General Settings

S3 Key

Your Amazon Web Services "Access Key ID". You can find this by logging into your AWS account (http://aws.amazon.com/account/) and clicking on the Security Credentials link.

S3 Secret

Your Amazon Web Services "Access Key ID". You can find this by logging into your AWS account (http://aws.amazon.com/account/) and clicking on the Security Credentials link.

S3 Bucket

The bucket you want to upload your files into. This can be a preexisting bucket that you have access to or it can be a new bucket name. Note that bucket names must be unique across all S3 users.

S3 Bucket Region

The region you would like to create your new bucket in. This setting does nothing for preexisting buckets. Note that not all regions have the same pricing for storage and bandwidth (https://aws.amazon.com/s3/#pricing).

Public Can View Files?

If yes, then anyone with the correct url can access the files uploaded to this bucket. If no, then you must use authenticated urls to allow temporary access to files in this bucket. Note that either way, there is no public access to the bucket itself... that is, nobody but you has access to list all the files contained in the bucket.

Cache Files for # of Days (available since 1.2.1)

The number of days after requesting the file that the user's browser is allowed to cache it. This will improve subsequent page load times and reduce your S3 bill if users request pages that use the same files repeatedly.

Max Filesize

This is the maximum filesize in bytes that can be uploaded to the bucket. Anything larger will be rejected. For example if you want to limit your user to 1 MB files you'd set this to approximately 1000000. Note that if the file uploaded is an image and you have set image resizing options this limit will be ignored.

Format for S3 Filenames (available since 1.3.0)

This setting lets you organize your S3 filenames by letting you build them the way you want them to appear. Use the variable replacements below to construct the filename:

Available Variables:

%t : current unix timestamp
%Y : current year (4 digits)
%M : current month (2 digits)
%D : current day (2 digits)
%f : filename (no extension)
%e : filename extension (no period)
%m : member ID
%u : member's username
%s : member's screenname
%g : name of the group member is a part of
%w : name of the current weblog
%c : name of the current channel

Example:
A member with username "emarketsouth" in group "admin" is uploading "my-image.jpg" to a custom field in the "content" weblog on July 20, 2010 at 12:00 noon (timestamp at this time is 1279645200).

If the filename format is set to the default of "%t-%f.%e" the resulting filename will be "1279645200-my-image.jpg".

If the filename format is set to "%Y-%M-%D/%w/%g/%u/%f.%e" the resulting filename will be "2010-07-20/content/admin/emarketsouth/my-image.jpg".

Image Resize Settings

The Simple S3 Uploader can resize the original image before uploading it to S3. This can be useful if your users might upload a digital picture straight from their 12 MP camera when all you want is an 800x600 picture. If you need to store the unaltered file but still want to generate a thumbnail, set the image width and height to 0 and use the thumbnail settings in the next section.

Image Width

The maximum width of the resized image. To disable the maximum image width set this to 0.

Image Height

The maximum height of the resized image. To disable the maximum image height set this to 0.

Image Quality

The image quality setting. Larger numbers will result in higher quality jpegs, but the files will be larger. Accepted values range from 1 to 100.

Image Resize Method

This setting controls what algorithm is used to resize the image:

  • fit in box: - this setting will scale the image down so that the entire image fits in the maximum dimensions specified above. If only one dimension is specified, it will ignore the other dimension.
  • fill box: - this setting will center the image in the box created by the maximum dimensions specified above, then scale the image down until it just barely fills the box. The remaining part of the image that does not fit in the box will be cropped. This is particularly good for generating thumbnails so that they are all the same size.
  • stretch to fit: - this setting will resample the image at the dimensions specified above. It does not preserve the original aspect ratio of the image.

Upscale Images?

If set to no, images that are smaller than the dimensions specified will not be resized. If set to yes, small images will be upscaled to a larger size. This tends to make the image look grainy or blocky and not very pleasing to the eye, but it has its uses.

Thumbnail Settings

In addition to resizing the original image with the settings above, the Simple S3 Uploader can generate another thumbnail image (which also gets stored in your S3 bucket). These settings control how the thumbnail is generated. Set the thumbnail image width and height to 0 if you do not wish to have thumbnails generated. The thumbnail generated will be of the same format as the original (jpeg, gif, png). Additionally, gif and png thumbnails will attempt to preserve the transparency of the original file.

Format for S3 Thumbnail Filenames (available since 1.3.0)

This setting lets you organize your S3 filenames by letting you build them the way you want them to appear. Use the variable replacements below to construct the filename:

Available Variables:

%t : current unix timestamp
%Y : current year (4 digits)
%M : current month (2 digits)
%D : current day (2 digits)
%f : filename (no extension)
%e : filename extension (no period)
%m : member ID
%u : member's username
%s : member's screenname
%g : name of the group member is a part of
%w : name of the current weblog
%c : name of the current channel

Example:
A member with username "emarketsouth" in group "admin" is uploading "my-image.jpg" to a custom field in the "content" weblog on July 20, 2010 at 12:00 noon (timestamp at this time is 1279645200).

If the filename format is set to the default of "%t-%f-thumb.%e" the resulting filename will be "1279645200-my-image-thumb.jpg".

If the filename format is set to "%Y-%M-%D/%w/%g/%u/thumbs/%f.%e" the resulting filename will be "2010-07-20/content/admin/emarketsouth/thumbs/my-image.jpg".

Thumbnail Width

The maximum width of the resized thumbnail. To disable the maximum thumbnail width set this to 0.

Thumbnail Height

The maximum height of the resized thumbnail. To disable the maximum thumbnail height set this to 0.

Thumbnail Quality

The thumbnail quality setting. Larger numbers will result in higher quality jpegs, but the files will be larger. Accepted values range from 1 to 100.

Thumbnail Resize Method

This setting controls what algorithm is used to generate the thumbnail:

  • fit in box: - this setting will scale the image down so that the entire image fits in the maximum dimensions specified above. If only one dimension is specified, it will ignore the other dimension.
  • fill box: - this setting will center the image in the box created by the maximum dimensions specified above, then scale the image down until it just barely fills the box. The remaining part of the image that does not fit in the box will be cropped. This is particularly good for generating thumbnails so that they are all the same size.
  • stretch to fit: - this setting will resample the image at the dimensions specified above. It does not preserve the original aspect ratio of the image.

Upscale Thumbnails?

If set to no, images that are smaller than the dimensions specified will not be resized. If set to yes, small images will be upscaled to a larger size. This tends to make the image look grainy or blocky and not very pleasing to the eye, but it has its uses.

information

Price: $29 per site - buy now at devot-ee.com

Compatibility:

  • ExpressionEngine 1.6
  • ExpressionEngine 2.x

Most Recent Version:

  • EE 1.6: Simple S3 Uploader 1.3.5
    October 28, 2010
  • EE 2.x: Simple S3 Uploader 1.3.6
    May 17, 2011

documentation