Polished and published

website/src/_posts/2017-05-0.17.md

@@ -2,16 +2,16 @@
 title: "Uppy 0.17: Restrictions"
 date: 2017-07-11
 author: arturi
-published: false
+published: true
 ---
 
-Hi! We are back with yet another release: file restrictions and better file type detection, Instagram plugin, UI improvements and more.
+Hi! We are back with yet another Uppy release that contains some often requested features such as file restrictions and better file type detection, alongside a brand new Instagram plugin, UI improvements and more!
 
 <!-- more -->
 
 ## ⚠️ File Restrictions 
 
-Finally, something some of our biggest fans were asking for, is here. The gist:
+Something that a few of our biggest fans were asking for, is finally here! Here's the gist of it:
 
 ```js
   Uppy({
@@ -40,7 +40,7 @@ Finally, something some of our biggest fans were asking for, is here. The gist:
 
 Basically, there are two ways to set restrictions:
 
-1\. Using the `restrictions` object in Uppy core settings:
+1. Using the `restrictions` object in Uppy's core settings:
 
 ```js
 restrictions: {
@@ -51,15 +51,15 @@ restrictions: {
 }
 ```
 
-Translation: allow only images and videos of any type, minimum 2 and maximum 5 files must be selected, less that 300 KB.
+Translation: allow only images and videos of any type, a minimum of 2 and maximum of 5 files must be selected, amounting to a total of less than 300 KB.
 
-`allowedFileTypes` must be an array of strings with supported file mime-types. Anything from this list https://www.iana.org/assignments/media-types/media-types.xhtml should work, as long as Uppy is able to detect it (Uppy promises to try hard, see below for details). Both wildcards `video/*` and specicifc types `image/jpeg` are supported!
+`allowedFileTypes` must be an array of strings with supported file mime-types. Anything from [this list](https://www.iana.org/assignments/media-types/media-types.xhtml) should work, as long as Uppy is able to detect it (and Uppy promises to try real hard, see below for details). Both wildcards `video/*` and specicifc types `image/jpeg` are supported!
 
-2\. Using the more advanced callbacks: `onBeforeFileAdded(currentFile, files)` that fires before a file is added, so you are free to run whatever checks you wish against the one file that is about to be added or all files currently selected / uploaded. And `onBeforeUpload(files)`, where you can check stuff before proceeding with the upload.
+2. Using the more advanced callbacks: `onBeforeFileAdded(currentFile, files)`, which fires before a file is added and allows you to run whatever checks you wish against either the single file that is about to be added or all files currently selected / uploaded, and `onBeforeUpload(files)`, where you are able to check stuff before proceeding with the upload.
 
-Basically, use the first options for the simple stuff like limiting uploads to images or 3 files. Use the second option for things like “we need users to upload 5 photos and an audio file, so we can make a short clip out of it”. Let us know if this suits your needs, we are all 👂.
+Basically, use the first option for the simple stuff such as limiting uploads to images or a maximum of three files. Use the second option for things like “we need users to upload 5 photos and an audio file, so we can make a short clip out of it”. Let us know if this suits your needs, we are all 👂ears👂!
 
-Also a new `note` option has been added to the Dashboard, as a simple and lazy way to inform users about the restrictions you choose to set up:
+Also, a new `note` option has been added to the Dashboard, as a quick and easy way to inform users about the restrictions you choose to set up:
 
 ```js
 uppy.use(Dashboard, {
@@ -71,7 +71,7 @@ uppy.use(Dashboard, {
 
 ## 📸 Instagram plugin and UI overhaul
 
-Yes, Instagram is now supported in Uppy, so you can easily import all those cat (and dog) and food pictures.
+Yes, Instagram is now supported in Uppy, so you can easily import all of your cat, dog and food pictures!
 
 <figure class="wide">
   <img class="border" src="/images/blog/0.17/instagram-ui.jpg">
@@ -79,15 +79,15 @@ Yes, Instagram is now supported in Uppy, so you can easily import all those cat
 
 You can try it live in the [Dashboard example](https://uppy.io/examples/dashboard/).
 
-The UI for all “provider” plugins, that’s how we call Google Drive, Dropbox and other external services, have been revamped to better use the space.
+The UI for all “provider” plugins, which is the way we call Google Drive, Dropbox and other external services, have been revamped to make better use of the space.
 
-Files are now selected, or added, on click/tap, rather than double click, which is easier and also works on mobile 🙀
+Files are now selected, or added, on click/tap, rather than double click, which is easier and also works on mobile. 🙀
 
 <img class="border" src="/images/blog/0.17/provider-search.jpg">
 
 ## StatusBar
 
-The Dashboard’s StatusBar has been improved. First of all, even though it still comes bundled with the Dashboard like before, it is now a separate plugin that can be used anywhere, like with Drag and Drop plugin or your custom thing. And, it now shows fatal upload errors in addition to the upload / processing / transcoding progress 💪
+The Dashboard’s StatusBar has been improved. First of all, even though it still comes bundled with the Dashboard like before, it is now a separate plugin that can be used anywhere, like with the Drag and Drop plugin or your own custom thing. Furthermore, it now shows fatal upload errors in addition to the upload / processing / transcoding progress. 💪
 
 In the Dashboard, you can now disable the StatusBar and/or Informer if you don’t need them or want something custom, by setting `disableStatusBar: true` and `disableInformer: true`.
 
@@ -95,17 +95,17 @@ Details: [#217](https://github.com/transloadit/uppy/pull/217)
 
 ## Better file type detection
 
-We’ve added a [`file-type`](https://github.com/sindresorhus/file-type) module that helps figure out the file type by reading first magic bytes of the file. If that doesn’t work, we try to use the mime-type provided by the system/browser, and if that is still a no, we attempt to figure it out by extension. All in all, this leads to a more robust file type detecting experience. Personally, I’m just happy my Sex and the City 🍸 `.avi` files are now recognized as `video` on a Mac ;-)
+We’ve added a [`file-type`](https://github.com/sindresorhus/file-type) module that helps with figuring out the file type by reading the first magic bytes of the file. If that doesn’t work, we try to use the mime-type provided by the system/browser, and if that is still a dead end, we attempt to figure it out by extension. All in all, this leads to a more robust file type detecting experience. Personally, I’m just happy my Sex and the City 🍸 `.avi` files are now recognized as `video` on a Mac! 
 
-Details: [#219](https://github.com/transloadit/uppy/pull/219)
+Further details can be found here: [#219](https://github.com/transloadit/uppy/pull/219)
 
 ## Extracting metadata from `<form>` inputs
 
-If a plugin’s `target` is a `form` element, we are going to try to extract all the data from that form’s inputs and add it as `meta` to Uppy’s state. That `meta` is then merged with file’s meta when it’s being added.
+If a plugin’s `target` is a `form` element, we are going to try to extract all the data from that form’s inputs and add it as `meta` to Uppy’s state. That `meta` is then merged with file’s meta when it is being added.
 
-Uppy’s core options has gotten a new `meta` property, where you can define some metadata from the start, and a new `setMeta` method that can be called anytime.
+Uppy’s core options have received a new `meta` property, where you can define some metadata from the start, as well as a new `setMeta` method that can be called at any time.
 
-Details: [#238](https://github.com/transloadit/uppy/pull/238) 
+See here for more details: [#238](https://github.com/transloadit/uppy/pull/238) 
 
 ## More
 
@@ -117,33 +117,33 @@ Details: [#238](https://github.com/transloadit/uppy/pull/238)
 
 Here is the full list of changes for version 0.17:
 
-- core: restrictions — by file type, size, number of files (@arturi)
-- provider: improve UI: improve overall look, breadcrumbs, more responsive (@arturi)
+- core: added restrictions — by file type, size, number of files (@arturi)
+- provider: improved UI: improve overall look, breadcrumbs, more responsive (@arturi)
 - core: css-in-js demos, try template-css (@arturi @goto-bus-stop #239)
-- core: add `uppy.reset()` as discussed in #179 (@arturi)
-- core: add nanoraf https://github.com/yoshuawuyts/choo/pull/135/files?diff=unified (@goto-bus-stop, @arturi)
+- core: added `uppy.reset()` as discussed in #179 (@arturi)
+- core: added nanoraf https://github.com/yoshuawuyts/choo/pull/135/files?diff=unified (@goto-bus-stop, @arturi)
 - core: file type detection: archives, markdown (possible modules: file-type, identify-filetype) example: http://requirebin.com/?gist=f9bea9602030f1320a227cf7f140c45f, http://stackoverflow.com/a/29672957 (@arturi)
-- dashboard: make file icons prettier: https://uppy.io/images/blog/0.16/service-logos.png (@arturi, @nqst / #215)
-- fileinput: allow retriving fields/options from form (@arturi #153)
+- dashboard: made file icons prettier: https://uppy.io/images/blog/0.16/service-logos.png (@arturi, @nqst / #215)
+- fileinput: allow retrieving fields/options from form (@arturi #153)
 - server: configurable server port (@ifedapoolarewaju)
-- server: support for custom providers (@ifedapoolarewaju)
+- server: added support for custom providers (@ifedapoolarewaju)
 - statusbar: also show major errors, add “error” state (@goto-bus-stop)
 - statusbar: pre/postprocessing status updates in the StatusBar (@goto-bus-stop, #202)
 - statusbar: show status “Upload started...” when the remote upload has begun, but no progress events received yet (@arturi)
-- statusbar: work towards extracting StatusBar to a separate plugin, bundle that with Dashboard? (@goto-bus-stop, @arturi)
-- tus/uppy-server: Support metadata in remote tus uploads (@ifedapoolarewaju, @goto-bus-stop / #210)
-- uploaders: add direct-to-s3 upload plugin and test it with the flow to then upload to transloadit, stage 1, WIP (@goto-bus-stop)
-- uppy/uppy-server: Make a barely working Instagram Plugin (@ifedapoolarewaju / #21)
+- statusbar: work towards extracting StatusBar to a separate plugin, still bundle it with Dashboard (@goto-bus-stop, @arturi)
+- tus/uppy-server: support metadata in remote tus uploads (@ifedapoolarewaju, @goto-bus-stop / #210)
+- uploaders: added direct-to-s3 upload plugin and test it with the flow to then upload to transloadit, stage 1, WIP (@goto-bus-stop)
+- uppy/uppy-server: Made a barely working Instagram Plugin (@ifedapoolarewaju / #21)
 - uppy/uppy-server: allow google drive/dropbox non-tus (i.e multipart) remote uploads (@arturi, @ifedapoolarewaju / #205)
-- uppy/uppy-server: some file types cannot be downloaded/uploaded on google drive (e.g google docs). How to handle that? (@ifedapoolarewaju)
-- uppy: fix google drive uploads on mobile (double click issue) (@arturi)
-- core: update prettier-bytes to fix the IE support issue https://github.com/Flet/prettier-bytes/issues/3 (@arturi)
+- uppy/uppy-server: do not show files that cannot be downloaded from Google Drive (@ifedapoolarewaju)
+- uppy: fixed Google Drive uploads on mobile (double click issue) (@arturi)
+- core: updated prettier-bytes to fix the IE support issue https://github.com/Flet/prettier-bytes/issues/3 (@arturi)
 - core: use URL.createObjectURL instead of resizing thumbnails (@arturi, @goto-bus-stop / #199)
-- dashboard: Fix ETA when multiple files are being uploaded (@goto-bus-stop, #197)
-- transloadit: Fix receiving assembly results that are not related to an input file (@arturi, @goto-bus-stop / #201)
-- transloadit: Use the `tus_upload_url` to reliably link assembly results with their input files (@goto-bus-stop / #207)
-- transloadit: move user-facing strings into locale option (@goto-bus-stop / https://github.com/transloadit/uppy/commit/87a22e7ee37b6fa3754fa34868516a6700306b60)
-- webcam: Mute audio in realtime playback (@goto-bus-stop / #196)
+- dashboard: fixed ETA when multiple files are being uploaded (@goto-bus-stop, #197)
+- transloadit: fixed receiving assembly results that are not related to an input file (@arturi, @goto-bus-stop / #201)
+- transloadit: use the `tus_upload_url` to reliably link assembly results with their input files (@goto-bus-stop / #207)
+- transloadit: moved user-facing strings into locale option (@goto-bus-stop / https://github.com/transloadit/uppy/commit/87a22e7ee37b6fa3754fa34868516a6700306b60)
+- webcam: mute audio in realtime playback (@goto-bus-stop / #196)
 - temporarily downgrade yo-yoify, until shama/yo-yoify#45 is resolved (@arturi / https://github.com/transloadit/uppy/commit/6292b96)
 
 Enjoy!