aboutsummaryrefslogtreecommitdiffstats
path: root/guides/source/active_storage_overview.md
Commit message (Collapse)AuthorAgeFilesLines
* Include warning in docs about polymorphism in underlying tablesAlex Gomez2019-06-061-0/+2
| | | We had a bug whereby we changed the namespace on a model using ActiveStorage, which resulted in broken download links. The reason this happened is because the `active_storage_attachments` table is a polymorphic join table that records the model's class name at the time of record creation, and uses this `record_type` in queries. Since the model namespace changed, the queries did not return the blob as expected. Discussed with @rafaelfranca, who suggested adding a warning about this in the docs.
* Mirror direct uploadsGeorge Claghorn2019-05-221-8/+18
|
* Update links and code examples in the guides to use HTTPS where the host ↵Nathaniel Suchy2019-03-061-1/+1
| | | | supports it.
* Prefer ImageProcessing's resize_to_limit macro over resize_to_fitGeorge Claghorn2019-01-241-1/+1
| | | | Don't upsize images smaller than the specified dimensions.
* Minimize boilerplate setup code for JavaScript librariesJavan Makhmali2019-01-161-2/+1
|
* Move all npm packages to @rails scopeJavan Makhmali2019-01-101-3/+3
| | | | Fixes #33083
* Prepend module in ActiveStorage overviewSam Bostock2018-12-101-8/+14
| | | | [ci skip]
* fix example code syntax [ci skip]Greg Molnar2018-12-011-1/+1
|
* Add instruction for test environmentSean Collins2018-10-051-0/+8
|
* Added mandatory region and bucketAsaf Bartov2018-09-231-0/+2
| | | The 'setup' section was misleadingly leaving out :bucket and :region in the sample, but servers don't start without them.
* Update `google-cloud-storage` gem version [ci skip]yuuji.yaginuma2018-08-191-1/+1
| | | | Now requires version 1.11 or newer. Ref: bf5f41d948b6f3f27db7fdc2b70897aec991065f
* AST Guide: install and migrate tasks in new apputilum2018-07-261-4/+4
| | | | | | This line refers only to an upgrade situation, but same is need to setup AST in a new application. [ci skip]
* Rails guides are now served over httpsPaul McMahon2018-07-241-1/+1
| | | | | http links will be redirected to the https version, but still better to just directly link to the https version.
* Incompatibility of Direct Uploads & Mirror ServiceStanislas Boyet2018-06-291-0/+2
| | | | [ci skip] It adds a note to the Active Storage documentation regarding the use of Mirror Service not being compatible with the use of the Direct Uploads as described later on in the documentation, as described in issue #32732
* Active Storage: Explicit form field in basic exampleHenrik Nyh2018-06-221-1/+5
| | | Also fix syntax highlighting in the more advanced JS example.
* Add comma to example in guides/source/active_storage_overview.md [ci skip]Matt Sias2018-06-111-1/+1
|
* Remove backticks around proejct namesutilum2018-06-111-2/+2
| | | | [ci skip]
* Update ffmpeg -> FFmpeg, mutools|mupdf -> muPDFutilum2018-06-081-0/+1
| | | | [ci skip]
* Dev-Dep guide: mention AST third party requirementsutilum2018-06-081-5/+5
| | | | | | | | | | | | | | | Avoid the likes of: ``` Error: ActiveStorage::RepresentationTest#test_representing_an_MP4_video: Errno::ENOENT: No such file or directory - ffmpeg test/models/representation_test.rb:27:in `block in <class:RepresentationTest>' ``` Also note additiona macOS requirements in ActiveStorage guide. [ci skip]
* Escape newlines in the GCS private key for valid YAML [ci skip]George Claghorn2018-06-061-1/+1
|
* Remove 'Current.' prefix from example.Yong Bakos2018-06-011-2/+2
| | | | | The prior sentence is referring just to an existing user object, so the sudden magical 'Current.' prefix doesn't make sense. Remove it.
* Fix markdown [ci skip]Rafael Mendonça França2018-05-171-1/+1
|
* Demonstrate ActiveStorage::Blob#open in the Active Storage guideGeorge Claghorn2018-05-161-42/+9
|
* Add option to ActiveStorage::Blob to set extract_content_type_from_ioRyan Davidson2018-05-081-0/+12
| | | | | | | This adds a boolean argument called identify to ActiveStorage::Blob methods #create_after_upload, #build_after_upload and #upload. It allows a user to bypass the automatic content_type inference from the io.
* Minor edits to the Active Storage guideTyler Hunt2018-05-031-5/+5
| | | | | | Fix spelling, grammar, and formatting. [ci skip]
* Merge pull request #32698 from zealot128/patch-1George Claghorn2018-04-281-0/+172
|\ | | | | [ci skip] update ActiveStorage documentation
| * [ci skip] update ActiveStorage documentationStefan Wienert2018-04-281-0/+172
| | | | | | | | | | | | | | | | - added documentation on how to download files, with example of ActiveStorage::Downloading - documentation about linking files outside of controller/view - added section about DirectUpload JavaScript integration into libraries/frameworks, as well as usage in combination with Drag and Drop
* | Correct typosJanko Marohnić2018-04-231-2/+2
| |
* | Recommend using :resize_to_fit after allJanko Marohnić2018-04-231-2/+2
| |
* | Replace :resize_to_fit with :resize in the guideJanko Marohnić2018-04-231-1/+1
| |
* | Rename ActiveStorage.processor to .variant_processorJanko Marohnić2018-04-221-1/+1
| |
* | Use ImageProcessing gem for ActiveStorage variantsJanko Marohnić2018-04-181-6/+15
|/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ImageProcessing gem is a wrapper around MiniMagick and ruby-vips, and implements an interface for common image resizing and processing. This is the canonical image processing gem recommended in [Shrine], and that's where it developed from. The initial implementation was extracted from Refile, which also implements on-the-fly transformations. Some features that ImageProcessing gem adds on top of MiniMagick: * resizing macros - #resize_to_limit - #resize_to_fit - #resize_to_fill - #resize_and_pad * automatic orientation * automatic thumbnail sharpening * avoids the complex and inefficient MiniMagick::Image class * will use "magick" instead of "convert" on ImageMagick 7 However, the biggest feature of the ImageProcessing gem is that it has an alternative implementation that uses libvips. Libvips is an alternative to ImageMagick that can process images very rapidly (we've seen up 10x faster than ImageMagick). What's great is that the ImageProcessing gem provides the same interface for both implementations. The macros are named the same, and the libvips implementation does auto orientation and thumbnail sharpening as well; only the operations/options specific to ImageMagick/libvips differ. The integration provided by this PR should work for both implementations. The plan is to introduce the ImageProcessing backend in Rails 6.0 as the default backend and deprecate the MiniMagick backend, then in Rails 6.1 remove the MiniMagick backend.
* Allow full use of the AWS S3 SDK authentication options (#32270)Brian Knight2018-03-191-0/+7
| | | | | | | | | If an explicit AWS key pair and/or region is not provided in config/storage.yml, attempt to use environment variables, shared credentials, or IAM role credentials. Order of precedence is determined by the AWS SDK[1]. [1]: https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/setup-config.html
* Remove path config option from Azure serviceAndrew White2018-03-121-1/+0
| | | | | | | | | | | The Active Storage service for Azure Storage has an option called `path` that is ambiguous in meaning. It needs to be set to the primary blob storage endpoint but that can be determined from the blobs client anyway. To simplify the configuration this commit removes the `path` option and gets the endpoint from the blobs client instead. Closes #32225.
* Generate root-relative paths in Active Storage disk service URL methodsGeorge Claghorn2018-03-051-9/+0
| | | | Fixes #32129.
* Add note to Active Storage guide about S3 permissions [ci skip]Andrew White2018-02-211-0/+2
|
* ActiveStorage file cleanup in Integration TestsJeremy Prevost2018-02-151-0/+24
| | | | | Documents ActiveStorage file cleanup in Integration Tests which is similar but slightly different than the existing docs for System Tests.
* Update `google-cloud-storage` gem version [ci skip]yuuji.yaginuma2018-01-281-1/+1
| | | | | | | Because we use `credentials` in an example of configuration files, but `credentials` can not be used unless it is 1.8.0 or later. Ref: 9d65ac3
* Provide a sensible default hostGeorge Claghorn2018-01-161-3/+9
|
* Extract content types from blob dataGeorge Claghorn2018-01-151-0/+3
|
* Merge pull request #31534 from claudiob/kaspth-approachKasper Timm Hansen2018-01-091-3/+0
|\ | | | | Don't include Active Storage migrations in new apps
| * Don't run rails active_storage:install in new appsclaudiob2017-12-141-3/+0
| | | | | | | | See #31315 for full discussion
* | Tweak headings [ci skip]George Claghorn2017-12-291-16/+16
| |
* | Demonstrate providing keyfile data in lieu of a path [ci skip]George Claghorn2017-12-281-24/+33
| |
* | Link to the client gems [ci skip]George Claghorn2017-12-281-3/+4
| |
* | Fix Active Storage Overview guide [ci skip]Yoshiyuki Hirano2017-12-161-5/+5
| |
* | [ci skip] Use :amazon, not :s3, to reflect codeClaudio B2017-12-151-6/+6
| | | | | | | | | | | | | | | | The [template](https://github.com/rails/rails/blob/master/railties/lib/rails/generators/rails/app/templates/config/storage.yml.tt#L10) that generates the `config/storage.yml` file has the Amazon S3 key specified as `:amazon`, not `:s3`. The guides should reflect the nomenclature, given that every other service also has the name of the company as the key (:google, :microsoft).
* | Sync header title with file name [ci skip]Ryuta Kamizono2017-12-151-2/+2
| | | | | | | | Like other Basics and Overview guides.
* | Fix in ASt guide [ci skip]Yauheni Dakuka2017-12-151-5/+5
|/
* Tweak whitespaceJeffrey Guenther2017-12-141-0/+1
|