From c558d5b175d8fc6796f8aaba60d07390638a9af7 Mon Sep 17 00:00:00 2001
From: Sean Fraser <sean@plankdesign.com>
Date: Fri, 30 Sep 2016 11:22:52 -0400
Subject: [PATCH 1/7] fixed case where variable is undefined

---
 src/SourceAdapters/SourceAdapterFactory.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/SourceAdapters/SourceAdapterFactory.php b/src/SourceAdapters/SourceAdapterFactory.php
index c8db2af..666b253 100644
--- a/src/SourceAdapters/SourceAdapterFactory.php
+++ b/src/SourceAdapters/SourceAdapterFactory.php
@@ -33,6 +33,8 @@ class SourceAdapterFactory
      */
     public function create($source)
     {
+        $adapter = null;
+
         if ($source instanceof SourceAdapterInterface) {
             return $source;
         } elseif (is_object($source)) {

From ce41effc27e62904e265f34587dad2bf57bbf520 Mon Sep 17 00:00:00 2001
From: Sean Fraser <sean@plankdesign.com>
Date: Fri, 30 Sep 2016 11:23:58 -0400
Subject: [PATCH 2/7] added handling for symlinked local storage disks

---
 docs/build/doctrees/commands.doctree          | Bin 4336 -> 4332 bytes
 docs/build/doctrees/configuration.doctree     | Bin 19563 -> 27641 bytes
 docs/build/doctrees/environment.pickle        | Bin 19567 -> 19924 bytes
 docs/build/doctrees/index.doctree             | Bin 9830 -> 9831 bytes
 docs/build/doctrees/installation.doctree      | Bin 5701 -> 5702 bytes
 docs/build/doctrees/media.doctree             | Bin 13275 -> 13276 bytes
 docs/build/doctrees/mediable.doctree          | Bin 45516 -> 45459 bytes
 docs/build/doctrees/types.doctree             | Bin 5244 -> 5240 bytes
 docs/build/doctrees/uploader.doctree          | Bin 21201 -> 21197 bytes
 docs/build/html/.buildinfo                    |   2 +-
 docs/build/html/_sources/configuration.txt    |  86 ++++-
 docs/build/html/_sources/mediable.txt         |   2 +-
 docs/build/html/commands.html                 |   8 +-
 docs/build/html/configuration.html            | 327 +++++++++++-------
 docs/build/html/genindex.html                 |   8 +-
 docs/build/html/index.html                    |   8 +-
 docs/build/html/installation.html             |   8 +-
 docs/build/html/media.html                    |   8 +-
 docs/build/html/mediable.html                 |  10 +-
 docs/build/html/objects.inv                   |   2 +-
 docs/build/html/search.html                   |   8 +-
 docs/build/html/searchindex.js                |   2 +-
 docs/build/html/types.html                    |   8 +-
 docs/build/html/uploader.html                 |   8 +-
 docs/source/conf.py                           |   4 +-
 docs/source/configuration.rst                 |  86 ++++-
 docs/source/mediable.rst                      |   2 +-
 src/UrlGenerators/BaseUrlGenerator.php        |   8 +
 src/UrlGenerators/LocalUrlGenerator.php       |  13 +-
 src/UrlGenerators/S3UrlGenerator.php          |  10 -
 src/UrlGenerators/UrlGeneratorInterface.php   |   2 +
 tests/TestCase.php                            |  10 +-
 .../UrlGenerators/LocalUrlGeneratorTest.php   |   7 +
 33 files changed, 451 insertions(+), 186 deletions(-)

diff --git a/docs/build/doctrees/commands.doctree b/docs/build/doctrees/commands.doctree
index 073603eff493cfa9725028875b17c95aaa8e3cb2..f90228f4c005096fc530786ecf6d5a16bee7500a 100644
GIT binary patch
delta 28
jcmeyM_(pMqAtS#v0|SG8XmM&$v3_xCV%}yK#x?u^g}4b7

delta 32
ncmaE(_(5@lA)~N80|SG8XmM&$v3^=nVsUO_dg^8e#x?u^upJ7x

diff --git a/docs/build/doctrees/configuration.doctree b/docs/build/doctrees/configuration.doctree
index fd5e76f60bf44c5a3ec3d8b7f75916a7d8fa3704..d19b551a695356cd1efb8461849538dd209f4626 100644
GIT binary patch
literal 27641
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
R36VYYan9akRjYmJ{|87E?n3|o

literal 19563
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

diff --git a/docs/build/doctrees/environment.pickle b/docs/build/doctrees/environment.pickle
index 48209474996836eca572d45e5fd5d83669af61ba..68ba116cce69cfc6f99a2b2fb2b67f643e45d3ee 100644
GIT binary patch
literal 19924
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
GHUA$+PPFd;

literal 19567
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
Z@oS`zzSyN+N6MKHD+cKe<PoIS{{!T5A<X~)

diff --git a/docs/build/doctrees/index.doctree b/docs/build/doctrees/index.doctree
index 73005869ab9b747cc6c20ca9ea5cf3258075a237..17b0b10a0605b55e09d18b3daee009d6248aa2c9 100644
GIT binary patch
delta 186
zcmaFn^W0~{Vn%)o1_lQG(BjmhV*TRO#JtVh7}qO%6is7fU<egU%gjlQ&&&f#mSpDV
z#i!;aCgr526io+8c7$>lC6>d5W&nk}8AEwfN^=Y1i&INVGV{`li)Kz<p(-al3na%7
z%AA=}Tr?ZVt}U7~`KGFY@LVu^9+1pX$k549sx6v7Sw>AuVF6GiwrC-c3}q`yO#^9L
N1Xj8jNR}q)0RZ~WJ5~Sy

delta 185
zcmaFv^UP<%Vn$&b1_lQG(BjmhV*RwD#Nyn<^wiCp7}qO1hl-_T=A_1F<^knOGV}A|
zQ}Ys&a#B-@rZF-wbcAvjC6>d5rUQk%8AEwfN^=Y1i&INVGV{`li)Kt-sVXNt6C}qF
z%AA=}Tr>;Ft}U89`If4I@EkCEE|APn$k549sx6u~SyoL;VLnhKwrBy63}q`yO#^9L
N2v)iXNR}q)0RTo^JK+ET

diff --git a/docs/build/doctrees/installation.doctree b/docs/build/doctrees/installation.doctree
index 548b901033936d9f8c164fca8150847f25c21116..70d09aa6eed1d6f3ac1cbc09db4dffcca161d51b 100644
GIT binary patch
delta 186
zcmX@Ab4+K0CL_N+0|SG8XmM&$v3_xCV%}yOMrjd`B1T3AhETDz%$(Ht%silENoIat
zd}>}|Qch}05ff0dBb2)+u^cYM3>5Na4CPHJ%`J#8PAw_P%u6pWVwpTkR8E)`B*zfS
zoS9Nw#0F&77O_u0Eh;O_0cLXo$qcCswG5fsBCg55MYR;Tfg-U*JU}v(ttd4Oq>UG>
Lln+RjCg}kHjA}89

delta 185
zcmX@6b5v)8CZn)30|SG8XmM&$v3^=nVsUO_dg^8iMrje}P_eYkoYeTtJfK`jW`16L
zYF=VePHIXKBO?PtM<{nuVmVxh2`J>v7|NScnp+TGoLW+nnU`K%#5{SnsGKkhNRA<t
zIWwiWh!x1LEn=H|MpRaq9n9tck{MDNY8f)MMVyoWh-xWt0YzeqxPfFSTTyBnNE;7W
LDKC&LP0|AZIZ86C

diff --git a/docs/build/doctrees/media.doctree b/docs/build/doctrees/media.doctree
index 5fd6b8494280b2438d08950a5da55bc5e3dea5d9..2287229752c480ae7d0b7a1040a6040313e8ae07 100644
GIT binary patch
delta 186
zcmcbeekXmyPey(V1_lQG(BjmhV*TRO#JtTsOeYOIias$iFocSwW#**DXXXJVOEUBG
z;#2bylX6m1iarA+J3_gO63gL2Uw}g1jG??KrMU(1#i=DFnR)5OMPDaN7|RKN1IaOj
zGH0d~7kvk^Ym0tN_B1vX{t0IP0+Jaj83q|@wMD-tPc+t2_yZJ)E&2;2L)nT_(?Ht(
MftCITlBG#{01nkZ;Q#;t

delta 185
zcmcbUemi}`Pex%I1_lQG(BjmhV*RwD#Nyn<^wiB9OeYPTL&efEb5i3o^MG<CnfZC~
zsd<S>IjJc{pBNb!IzqXN63gL2pMgT&jG??KrMU(1#i=DFnR)5OMPDXM8p{cP1<5gl
zGH0d~7kvY=Ym2^5_A)jV{sCtH1d<sl83q|@wMD-sPcqh0_ze_^E&2l_L)nT_(?Ht(
Mf|dRQlBG#{03=vI5C8xG

diff --git a/docs/build/doctrees/mediable.doctree b/docs/build/doctrees/mediable.doctree
index 65bd979ee4ece30f299757a8d31eb87611c05c27..6716d9cce863b674aa03c5f1b07b047bed9f3c80 100644
GIT binary patch
delta 13915
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
WTs?`gv;&s|R``^tK8>-lGWY)#n4^6F

delta 13565
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
PJA!#ZRA0ncUs3RXU^P)+

diff --git a/docs/build/doctrees/types.doctree b/docs/build/doctrees/types.doctree
index 2d97dedbbd6ad61b5febeccde88a18178f5439a3..4e2b0cf5eae8fc5646ea0bcff18de089ab574311 100644
GIT binary patch
delta 28
jcmeyP@k3*SJ|n*c0|SG8XmM&$v3_xCV%}yaMk`?eh*}87

delta 32
ncmeyN@ke8WKBKS=0|SG8XmM&$v3^=nVsUO_dg^97Mk`?evqK7L

diff --git a/docs/build/doctrees/uploader.doctree b/docs/build/doctrees/uploader.doctree
index a8a357ebe46e6577f816e84909cd22088ec92b01..19dcbc65944acc972f67dae81aa141312890a939 100644
GIT binary patch
delta 30
mcmcb(l=19R#tkzW`K=ik81zGnQ;UlAi&GQxHm_k+4FmwFzY1&s

delta 34
qcmX@Rl=0$H#tkzWh3y#_81zGnQ;UlA(~1&{a}(23H?Lq+4Fmw!@C*+C

diff --git a/docs/build/html/.buildinfo b/docs/build/html/.buildinfo
index 717ba21..49bb039 100644
--- a/docs/build/html/.buildinfo
+++ b/docs/build/html/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 2722b2b5df7612bff4385ecba0d7e59f
+config: bbf7cac85fbbf9441e0e7eba39880a50
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/docs/build/html/_sources/configuration.txt b/docs/build/html/_sources/configuration.txt
index ab60e27..25fed20 100644
--- a/docs/build/html/_sources/configuration.txt
+++ b/docs/build/html/_sources/configuration.txt
@@ -14,6 +14,7 @@ An example setup with one private disk (``local``) and one publicly accessible d
 
 ::
 
+    <?php
     //...
     'disks' => [
         'local' => [
@@ -33,6 +34,7 @@ Once you have set up as many disks as you need, edit ``config/mediable.php`` to
 
 ::
 
+    <?php
     //...
     /*
      * Filesystem disk to use if none is specified
@@ -47,6 +49,85 @@ Once you have set up as many disks as you need, edit ``config/mediable.php`` to
     ],
     //...
 
+
+Disk Visibility
+^^^^^^^^^^^^^^^
+
+This package is able to generate public URLs for accessing media, and uses the disk config to determine how this should be done.
+
+URLs can always be generated for ``Media`` placed on a disk located below the webroot.
+
+::
+
+    <?php
+    'disks' => [
+        'uploads' => [
+            'driver' => 'local',
+            'root' => public_path('uploads'),
+        ],
+    ]
+
+    //...
+
+    $media->getUrl(); // returns http://domain.com/uploads/foo.jpg
+
+``Media`` placed on a disk located elsewhere will throw an exception.
+
+::
+
+    <?php
+    'disks' => [
+        'private' => [
+            'driver' => 'local',
+            'root' => storage_path('private'),
+        ],
+    ]
+
+    //...
+
+    $media->getUrl(); // Throws a Plank\Mediable\Exceptions\MediableUrlException
+
+If you are using symbolic links to make local disks accessible, you can instruct the package to generate URLs with the ``'visibility' => 'public'`` key. By default, the package will assume that the symlink is named ``'storage'``, as per `laravel's documentation <https://laravel.com/docs/5.3/filesystem#the-public-disk>`_. This can be modified with the ``'prefix'`` key.
+
+::
+
+    <?php
+    'disks' => [
+        'public' => [
+            'driver' => 'local',
+            'root' => storage_path('public'),
+            'visibility' => 'public',
+            'prefix' => 'assets'
+        ],
+    ]
+
+    //...
+
+    $media->getUrl(); // returns http://domain.com/assets/foo.jpg
+
+
+Permissions for S3-based disks is set on the buckets themselves. You can inform the package that ``Media`` on an S3 disk can be linked by URL by adding the ``'visibility' => 'public'`` key to the disk congfig.
+
+::
+
+    <?php
+    'disks' => [
+        'cloud' => [
+            'driver' => 's3',
+            'key'    => env('S3_KEY'),
+            'secret' => env('S3_SECRET'),
+            'region' => env('S3_REGION'),
+            'bucket' => env('S3_BUCKET'),
+            'version' => 'latest',
+            'visibility' => 'public'
+        ],
+    ]
+
+    //...
+
+    $media->getUrl(); // returns https://s3.amazonaws.com/bucket/foo.jpg
+
+
 .. _validation:
 
 Validation
@@ -56,6 +137,7 @@ The `config/mediable.php` offers a number of options for configuring how media u
 
 ::
 
+    <?php
     //...
     /*
      * The maximum file size in bytes for a single uploaded file
@@ -106,10 +188,11 @@ Aggregate Types
 
 Laravel-Mediable provides functionality for handling multiple kinds of files under a shared aggregate type. This is intended to make it easy to find similar media without needing to constantly juggle multiple MIME types or file extensions.
 
-The package defines a number of common file types in the config file (config/mediable.php). Feel free to modify the default types provided by the package or add your own. Each aggregate type requires a key used to identify the type and a list of MIME types and file extensions that should be recognized as belonging to that aggregate type. For example, if you wanted to add an aggregate type for different types of markup, you could do the following.
+The package defines a number of common file types in the config file (``config/mediable.php``). Feel free to modify the default types provided by the package or add your own. Each aggregate type requires a key used to identify the type and a list of MIME types and file extensions that should be recognized as belonging to that aggregate type. For example, if you wanted to add an aggregate type for different types of markup, you could do the following.
 
 ::
 
+    <?php
     //...
     'aggregate_types' => [
         //...
@@ -145,6 +228,7 @@ The ``config/mediable.php`` file lets you specify a number of classes to be use
 
 ::
 
+    <?php
     /*
      * FQCN of the model to use for media
      *
diff --git a/docs/build/html/_sources/mediable.txt b/docs/build/html/_sources/mediable.txt
index 9540d67..ae809a8 100644
--- a/docs/build/html/_sources/mediable.txt
+++ b/docs/build/html/_sources/mediable.txt
@@ -72,7 +72,7 @@ You can retrieve media attached to a file by refering to the tag to which it was
     <?php
     $media = $post->getMedia('thumbnail');
 
-This returns a collection of all media assigned to that tag. In cases where you only need one `Media` entity, you can instead use `firstMedia()`.
+This returns a collection of all media assigned to that tag. In cases where you only need one ``Media`` entity, you can instead use ``firstMedia()``.
 
 ::
 
diff --git a/docs/build/html/commands.html b/docs/build/html/commands.html
index 124da73..046dc5b 100644
--- a/docs/build/html/commands.html
+++ b/docs/build/html/commands.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Artisan Commands &mdash; Laravel-Mediable 2.0.0 documentation</title>
+  <title>Artisan Commands &mdash; Laravel-Mediable 2.2.0 documentation</title>
   
 
   
@@ -30,7 +30,7 @@
   
 
   
-    <link rel="top" title="Laravel-Mediable 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="Laravel-Mediable 2.2.0 documentation" href="index.html"/>
         <link rel="prev" title="Aggregate Types" href="types.html"/> 
 
   
@@ -59,7 +59,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.2.0
               </div>
             
           
@@ -192,7 +192,7 @@ <h1>Artisan Commands<a class="headerlink" href="#artisan-commands" title="Permal
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.2.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/configuration.html b/docs/build/html/configuration.html
index ab6d61b..3045652 100644
--- a/docs/build/html/configuration.html
+++ b/docs/build/html/configuration.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Configuration &mdash; Laravel-Mediable 2.0.0 documentation</title>
+  <title>Configuration &mdash; Laravel-Mediable 2.2.0 documentation</title>
   
 
   
@@ -30,7 +30,7 @@
   
 
   
-    <link rel="top" title="Laravel-Mediable 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="Laravel-Mediable 2.2.0 documentation" href="index.html"/>
         <link rel="next" title="Uploading Files" href="uploader.html"/>
         <link rel="prev" title="Installation" href="installation.html"/> 
 
@@ -60,7 +60,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.2.0
               </div>
             
           
@@ -85,7 +85,10 @@
 <ul class="current">
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>
 <li class="toctree-l1 current"><a class="current reference internal" href="#">Configuration</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="#disks">Disks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#disks">Disks</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#disk-visibility">Disk Visibility</a></li>
+</ul>
+</li>
 <li class="toctree-l2"><a class="reference internal" href="#validation">Validation</a></li>
 <li class="toctree-l2"><a class="reference internal" href="#aggregate-types">Aggregate Types</a></li>
 <li class="toctree-l2"><a class="reference internal" href="#extending-functionality">Extending functionality</a></li>
@@ -149,112 +152,183 @@ <h1>Configuration<a class="headerlink" href="#configuration" title="Permalink to
 <span id="id1"></span><h2>Disks<a class="headerlink" href="#disks" title="Permalink to this headline">¶</a></h2>
 <p>Laravel-Mediable is built on top of Laravel&#8217;s Filesystem component. Before you use the package, you will need to configure the filesystem disks where you would like files to be stored in <code class="docutils literal"><span class="pre">config/filesystems.php</span></code>. <a class="reference external" href="https://laravel.com/docs/5.2/filesystem">Learn more about filesystem disk</a>.</p>
 <p>An example setup with one private disk (<code class="docutils literal"><span class="pre">local</span></code>) and one publicly accessible disk (<code class="docutils literal"><span class="pre">uploads</span></code>):</p>
-<div class="highlight-php"><div class="highlight"><pre><span></span><span class="x">//...</span>
-<span class="x">&#39;disks&#39; =&gt; [</span>
-<span class="x">    &#39;local&#39; =&gt; [</span>
-<span class="x">        &#39;driver&#39; =&gt; &#39;local&#39;,</span>
-<span class="x">        &#39;root&#39;   =&gt; storage_path(&#39;app&#39;),</span>
-<span class="x">    ],</span>
-
-<span class="x">    &#39;uploads&#39; =&gt; [</span>
-<span class="x">        &#39;driver&#39; =&gt; &#39;local&#39;,</span>
-<span class="x">        &#39;root&#39;   =&gt; public_path(&#39;uploads&#39;),</span>
-<span class="x">    ],</span>
-<span class="x">]</span>
-<span class="x">//...</span>
+<div class="highlight-php"><div class="highlight"><pre><span></span><span class="cp">&lt;?php</span>
+<span class="c1">//...</span>
+<span class="s1">&#39;disks&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+    <span class="s1">&#39;local&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+        <span class="s1">&#39;driver&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;local&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;root&#39;</span>   <span class="o">=&gt;</span> <span class="nx">storage_path</span><span class="p">(</span><span class="s1">&#39;app&#39;</span><span class="p">),</span>
+    <span class="p">],</span>
+
+    <span class="s1">&#39;uploads&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+        <span class="s1">&#39;driver&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;local&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;root&#39;</span>   <span class="o">=&gt;</span> <span class="nx">public_path</span><span class="p">(</span><span class="s1">&#39;uploads&#39;</span><span class="p">),</span>
+    <span class="p">],</span>
+<span class="p">]</span>
+<span class="c1">//...</span>
 </pre></div>
 </div>
 <p>Once you have set up as many disks as you need, edit <code class="docutils literal"><span class="pre">config/mediable.php</span></code> to authorize the package to use the disks you have created.</p>
-<div class="highlight-php"><div class="highlight"><pre><span></span><span class="x">//...</span>
-<span class="x">/*</span>
-<span class="x"> * Filesystem disk to use if none is specified</span>
-<span class="x"> */</span>
-<span class="x">&#39;default_disk&#39; =&gt; &#39;uploads&#39;,</span>
-
-<span class="x">/*</span>
-<span class="x"> * Filesystems that can be used for media storage</span>
-<span class="x"> */</span>
-<span class="x">&#39;allowed_disks&#39; =&gt; [</span>
-<span class="x">    &#39;uploads&#39;,</span>
-<span class="x">],</span>
-<span class="x">//...</span>
+<div class="highlight-php"><div class="highlight"><pre><span></span><span class="cp">&lt;?php</span>
+<span class="c1">//...</span>
+<span class="cm">/*</span>
+<span class="cm"> * Filesystem disk to use if none is specified</span>
+<span class="cm"> */</span>
+<span class="s1">&#39;default_disk&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;uploads&#39;</span><span class="p">,</span>
+
+<span class="cm">/*</span>
+<span class="cm"> * Filesystems that can be used for media storage</span>
+<span class="cm"> */</span>
+<span class="s1">&#39;allowed_disks&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+    <span class="s1">&#39;uploads&#39;</span><span class="p">,</span>
+<span class="p">],</span>
+<span class="c1">//...</span>
+</pre></div>
+</div>
+<div class="section" id="disk-visibility">
+<h3>Disk Visibility<a class="headerlink" href="#disk-visibility" title="Permalink to this headline">¶</a></h3>
+<p>This package is able to generate public URLs for accessing media, and uses the disk config to determine how this should be done.</p>
+<p>URLs can always be generated for <code class="docutils literal"><span class="pre">Media</span></code> placed on a disk located below the webroot.</p>
+<div class="highlight-php"><div class="highlight"><pre><span></span><span class="cp">&lt;?php</span>
+<span class="s1">&#39;disks&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+    <span class="s1">&#39;uploads&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+        <span class="s1">&#39;driver&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;local&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;root&#39;</span> <span class="o">=&gt;</span> <span class="nx">public_path</span><span class="p">(</span><span class="s1">&#39;uploads&#39;</span><span class="p">),</span>
+    <span class="p">],</span>
+<span class="p">]</span>
+
+<span class="c1">//...</span>
+
+<span class="nv">$media</span><span class="o">-&gt;</span><span class="na">getUrl</span><span class="p">();</span> <span class="c1">// returns http://domain.com/uploads/foo.jpg</span>
+</pre></div>
+</div>
+<p><code class="docutils literal"><span class="pre">Media</span></code> placed on a disk located elsewhere will throw an exception.</p>
+<div class="highlight-php"><div class="highlight"><pre><span></span><span class="cp">&lt;?php</span>
+<span class="s1">&#39;disks&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+    <span class="s1">&#39;private&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+        <span class="s1">&#39;driver&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;local&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;root&#39;</span> <span class="o">=&gt;</span> <span class="nx">storage_path</span><span class="p">(</span><span class="s1">&#39;private&#39;</span><span class="p">),</span>
+    <span class="p">],</span>
+<span class="p">]</span>
+
+<span class="c1">//...</span>
+
+<span class="nv">$media</span><span class="o">-&gt;</span><span class="na">getUrl</span><span class="p">();</span> <span class="c1">// Throws a Plank\Mediable\Exceptions\MediableUrlException</span>
 </pre></div>
 </div>
+<p>If you are using symbolic links to make local disks accessible, you can instruct the package to generate URLs with the <code class="docutils literal"><span class="pre">'visibility'</span> <span class="pre">=&gt;</span> <span class="pre">'public'</span></code> key. By default, the package will assume that the symlink is named <code class="docutils literal"><span class="pre">'storage'</span></code>, as per <a class="reference external" href="https://laravel.com/docs/5.3/filesystem#the-public-disk">laravel&#8217;s documentation</a>. This can be modified with the <code class="docutils literal"><span class="pre">'prefix'</span></code> key.</p>
+<div class="highlight-php"><div class="highlight"><pre><span></span><span class="cp">&lt;?php</span>
+<span class="s1">&#39;disks&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+    <span class="s1">&#39;public&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+        <span class="s1">&#39;driver&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;local&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;root&#39;</span> <span class="o">=&gt;</span> <span class="nx">storage_path</span><span class="p">(</span><span class="s1">&#39;public&#39;</span><span class="p">),</span>
+        <span class="s1">&#39;visibility&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;public&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;prefix&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;assets&#39;</span>
+    <span class="p">],</span>
+<span class="p">]</span>
+
+<span class="c1">//...</span>
+
+<span class="nv">$media</span><span class="o">-&gt;</span><span class="na">getUrl</span><span class="p">();</span> <span class="c1">// returns http://domain.com/assets/foo.jpg</span>
+</pre></div>
+</div>
+<p>Permissions for S3-based disks is set on the buckets themselves. You can inform the package that <code class="docutils literal"><span class="pre">Media</span></code> on an S3 disk can be linked by URL by adding the <code class="docutils literal"><span class="pre">'visibility'</span> <span class="pre">=&gt;</span> <span class="pre">'public'</span></code> key to the disk congfig.</p>
+<div class="highlight-php"><div class="highlight"><pre><span></span><span class="cp">&lt;?php</span>
+<span class="s1">&#39;disks&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+    <span class="s1">&#39;cloud&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+        <span class="s1">&#39;driver&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;s3&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;key&#39;</span>    <span class="o">=&gt;</span> <span class="nx">env</span><span class="p">(</span><span class="s1">&#39;S3_KEY&#39;</span><span class="p">),</span>
+        <span class="s1">&#39;secret&#39;</span> <span class="o">=&gt;</span> <span class="nx">env</span><span class="p">(</span><span class="s1">&#39;S3_SECRET&#39;</span><span class="p">),</span>
+        <span class="s1">&#39;region&#39;</span> <span class="o">=&gt;</span> <span class="nx">env</span><span class="p">(</span><span class="s1">&#39;S3_REGION&#39;</span><span class="p">),</span>
+        <span class="s1">&#39;bucket&#39;</span> <span class="o">=&gt;</span> <span class="nx">env</span><span class="p">(</span><span class="s1">&#39;S3_BUCKET&#39;</span><span class="p">),</span>
+        <span class="s1">&#39;version&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;latest&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;visibility&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;public&#39;</span>
+    <span class="p">],</span>
+<span class="p">]</span>
+
+<span class="c1">//...</span>
+
+<span class="nv">$media</span><span class="o">-&gt;</span><span class="na">getUrl</span><span class="p">();</span> <span class="c1">// returns https://s3.amazonaws.com/bucket/foo.jpg</span>
+</pre></div>
+</div>
+</div>
 </div>
 <div class="section" id="validation">
 <span id="id2"></span><h2>Validation<a class="headerlink" href="#validation" title="Permalink to this headline">¶</a></h2>
 <p>The <cite>config/mediable.php</cite> offers a number of options for configuring how media uploads are validated. These values serve as defaults, which can be overridden on a case-by-case basis for each <code class="docutils literal"><span class="pre">MediaUploader</span></code> instance.</p>
-<div class="highlight-php"><div class="highlight"><pre><span></span><span class="x">//...</span>
-<span class="x">/*</span>
-<span class="x"> * The maximum file size in bytes for a single uploaded file</span>
-<span class="x"> */</span>
-<span class="x">&#39;max_size&#39; =&gt; 1024 * 1024 * 10,</span>
-
-<span class="x">/*</span>
-<span class="x"> * What to do if a duplicate file is uploaded. Options include:</span>
-<span class="x"> *</span>
-<span class="x"> * * &#39;increment&#39;: the new file&#39;s name is given an incrementing suffix</span>
-<span class="x"> * * &#39;replace&#39; : the old file and media model is deleted</span>
-<span class="x"> * * &#39;error&#39;: an Exception is thrown</span>
-<span class="x"> *</span>
-<span class="x"> */</span>
-<span class="x">&#39;on_duplicate&#39; =&gt; Plank\Mediable\MediaUploader::ON_DUPLICATE_INCREMENT,</span>
-
-<span class="x">/*</span>
-<span class="x"> * Reject files unless both their mime and extension are recognized and both match a single aggregate type</span>
-<span class="x"> */</span>
-<span class="x">&#39;strict_type_checking&#39; =&gt; false,</span>
-
-<span class="x">/*</span>
-<span class="x"> * Reject files whose mime type or extension is not recognized</span>
-<span class="x"> * if true, files will be given a type of `&#39;other&#39;`</span>
-<span class="x"> */</span>
-<span class="x">&#39;allow_unrecognized_types&#39; =&gt; false,</span>
-
-<span class="x">/*</span>
-<span class="x"> * Only allow files with specific MIME type(s) to be uploaded</span>
-<span class="x"> */</span>
-<span class="x">&#39;allowed_mime_types&#39; =&gt; [],</span>
-
-<span class="x">/*</span>
-<span class="x"> * Only allow files with specific file extension(s) to be uploaded</span>
-<span class="x"> */</span>
-<span class="x">&#39;allowed_extensions&#39; =&gt; [],</span>
-
-<span class="x">/*</span>
-<span class="x"> * Only allow files matching specific aggregate type(s) to be uploaded</span>
-<span class="x"> */</span>
-<span class="x">&#39;allowed_aggregate_types&#39; =&gt; [],</span>
-<span class="x">//...</span>
+<div class="highlight-php"><div class="highlight"><pre><span></span><span class="cp">&lt;?php</span>
+<span class="c1">//...</span>
+<span class="cm">/*</span>
+<span class="cm"> * The maximum file size in bytes for a single uploaded file</span>
+<span class="cm"> */</span>
+<span class="s1">&#39;max_size&#39;</span> <span class="o">=&gt;</span> <span class="mi">1024</span> <span class="o">*</span> <span class="mi">1024</span> <span class="o">*</span> <span class="mi">10</span><span class="p">,</span>
+
+<span class="cm">/*</span>
+<span class="cm"> * What to do if a duplicate file is uploaded. Options include:</span>
+<span class="cm"> *</span>
+<span class="cm"> * * &#39;increment&#39;: the new file&#39;s name is given an incrementing suffix</span>
+<span class="cm"> * * &#39;replace&#39; : the old file and media model is deleted</span>
+<span class="cm"> * * &#39;error&#39;: an Exception is thrown</span>
+<span class="cm"> *</span>
+<span class="cm"> */</span>
+<span class="s1">&#39;on_duplicate&#39;</span> <span class="o">=&gt;</span> <span class="nx">Plank\Mediable\MediaUploader</span><span class="o">::</span><span class="na">ON_DUPLICATE_INCREMENT</span><span class="p">,</span>
+
+<span class="cm">/*</span>
+<span class="cm"> * Reject files unless both their mime and extension are recognized and both match a single aggregate type</span>
+<span class="cm"> */</span>
+<span class="s1">&#39;strict_type_checking&#39;</span> <span class="o">=&gt;</span> <span class="k">false</span><span class="p">,</span>
+
+<span class="cm">/*</span>
+<span class="cm"> * Reject files whose mime type or extension is not recognized</span>
+<span class="cm"> * if true, files will be given a type of `&#39;other&#39;`</span>
+<span class="cm"> */</span>
+<span class="s1">&#39;allow_unrecognized_types&#39;</span> <span class="o">=&gt;</span> <span class="k">false</span><span class="p">,</span>
+
+<span class="cm">/*</span>
+<span class="cm"> * Only allow files with specific MIME type(s) to be uploaded</span>
+<span class="cm"> */</span>
+<span class="s1">&#39;allowed_mime_types&#39;</span> <span class="o">=&gt;</span> <span class="p">[],</span>
+
+<span class="cm">/*</span>
+<span class="cm"> * Only allow files with specific file extension(s) to be uploaded</span>
+<span class="cm"> */</span>
+<span class="s1">&#39;allowed_extensions&#39;</span> <span class="o">=&gt;</span> <span class="p">[],</span>
+
+<span class="cm">/*</span>
+<span class="cm"> * Only allow files matching specific aggregate type(s) to be uploaded</span>
+<span class="cm"> */</span>
+<span class="s1">&#39;allowed_aggregate_types&#39;</span> <span class="o">=&gt;</span> <span class="p">[],</span>
+<span class="c1">//...</span>
 </pre></div>
 </div>
 </div>
 <div class="section" id="aggregate-types">
 <span id="id3"></span><h2>Aggregate Types<a class="headerlink" href="#aggregate-types" title="Permalink to this headline">¶</a></h2>
 <p>Laravel-Mediable provides functionality for handling multiple kinds of files under a shared aggregate type. This is intended to make it easy to find similar media without needing to constantly juggle multiple MIME types or file extensions.</p>
-<p>The package defines a number of common file types in the config file (config/mediable.php). Feel free to modify the default types provided by the package or add your own. Each aggregate type requires a key used to identify the type and a list of MIME types and file extensions that should be recognized as belonging to that aggregate type. For example, if you wanted to add an aggregate type for different types of markup, you could do the following.</p>
-<div class="highlight-php"><div class="highlight"><pre><span></span><span class="x">//...</span>
-<span class="x">&#39;aggregate_types&#39; =&gt; [</span>
-<span class="x">    //...</span>
-<span class="x">    &#39;markup&#39; =&gt; [</span>
-<span class="x">        &#39;mime_types&#39; =&gt; [</span>
-<span class="x">            &#39;text/markdown&#39;,</span>
-<span class="x">            &#39;text/html&#39;,</span>
-<span class="x">            &#39;text/xml&#39;,</span>
-<span class="x">            &#39;application/xml&#39;,</span>
-<span class="x">            &#39;application/xhtml+xml&#39;,</span>
-<span class="x">        ],</span>
-<span class="x">        &#39;extensions&#39; =&gt; [</span>
-<span class="x">            &#39;md&#39;,</span>
-<span class="x">            &#39;html&#39;,</span>
-<span class="x">            &#39;htm&#39;,</span>
-<span class="x">            &#39;xhtml&#39;,</span>
-<span class="x">            &#39;xml&#39;</span>
-<span class="x">        ]</span>
-<span class="x">    ],</span>
-<span class="x">    //...</span>
-<span class="x">]</span>
-<span class="x">//...</span>
+<p>The package defines a number of common file types in the config file (<code class="docutils literal"><span class="pre">config/mediable.php</span></code>). Feel free to modify the default types provided by the package or add your own. Each aggregate type requires a key used to identify the type and a list of MIME types and file extensions that should be recognized as belonging to that aggregate type. For example, if you wanted to add an aggregate type for different types of markup, you could do the following.</p>
+<div class="highlight-php"><div class="highlight"><pre><span></span><span class="cp">&lt;?php</span>
+<span class="c1">//...</span>
+<span class="s1">&#39;aggregate_types&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+    <span class="c1">//...</span>
+    <span class="s1">&#39;markup&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+        <span class="s1">&#39;mime_types&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+            <span class="s1">&#39;text/markdown&#39;</span><span class="p">,</span>
+            <span class="s1">&#39;text/html&#39;</span><span class="p">,</span>
+            <span class="s1">&#39;text/xml&#39;</span><span class="p">,</span>
+            <span class="s1">&#39;application/xml&#39;</span><span class="p">,</span>
+            <span class="s1">&#39;application/xhtml+xml&#39;</span><span class="p">,</span>
+        <span class="p">],</span>
+        <span class="s1">&#39;extensions&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+            <span class="s1">&#39;md&#39;</span><span class="p">,</span>
+            <span class="s1">&#39;html&#39;</span><span class="p">,</span>
+            <span class="s1">&#39;htm&#39;</span><span class="p">,</span>
+            <span class="s1">&#39;xhtml&#39;</span><span class="p">,</span>
+            <span class="s1">&#39;xml&#39;</span>
+        <span class="p">]</span>
+    <span class="p">],</span>
+    <span class="c1">//...</span>
+<span class="p">]</span>
+<span class="c1">//...</span>
 </pre></div>
 </div>
 <p>Note: a MIME type or extension could be present in more than one aggregate type&#8217;s definitions (the system will try to find the best match), but each Media record can only have one aggregate type.</p>
@@ -262,36 +336,37 @@ <h1>Configuration<a class="headerlink" href="#configuration" title="Permalink to
 <div class="section" id="extending-functionality">
 <span id="id4"></span><h2>Extending functionality<a class="headerlink" href="#extending-functionality" title="Permalink to this headline">¶</a></h2>
 <p>The <code class="docutils literal"><span class="pre">config/mediable.php</span></code> file lets you specify a number of classes to be use for internal behaviour. This is to allow for extending some of the the default classes used by the package or to cover additional use cases.</p>
-<div class="highlight-php"><div class="highlight"><pre><span></span><span class="x">/*</span>
-<span class="x"> * FQCN of the model to use for media</span>
-<span class="x"> *</span>
-<span class="x"> * Should extend Plank\Mediable\Media::class</span>
-<span class="x"> */</span>
-<span class="x">&#39;model&#39; =&gt; Plank\Mediable\Media::class,</span>
-
-<span class="x">/*</span>
-<span class="x"> * List of adapters to use for various source inputs</span>
-<span class="x"> *</span>
-<span class="x"> * Adapters can map either to a class or a pattern (regex)</span>
-<span class="x"> */</span>
-<span class="x">&#39;source_adapters&#39; =&gt; [</span>
-<span class="x">    &#39;class&#39; =&gt; [</span>
-<span class="x">        Symfony\Component\HttpFoundation\File\UploadedFile::class =&gt; Plank\Mediable\SourceAdapters\UploadedFileAdapter::class,</span>
-<span class="x">        Symfony\Component\HttpFoundation\File\File::class =&gt; Plank\Mediable\SourceAdapters\FileAdapter::class,</span>
-<span class="x">    ],</span>
-<span class="x">    &#39;pattern&#39; =&gt; [</span>
-<span class="x">        &#39;^https?://&#39; =&gt; Plank\Mediable\SourceAdapters\RemoteUrlAdapter::class,</span>
-<span class="x">        &#39;^/&#39; =&gt; Plank\Mediable\SourceAdapters\LocalPathAdapter::class</span>
-<span class="x">    ],</span>
-<span class="x">],</span>
-
-<span class="x">/*</span>
-<span class="x"> * List of URL Generators to use for handling various filesystem disks</span>
-<span class="x"> */</span>
-<span class="x">&#39;url_generators&#39; =&gt; [</span>
-<span class="x">    &#39;local&#39; =&gt; Plank\Mediable\UrlGenerators\LocalUrlGenerator::class,</span>
-<span class="x">    &#39;s3&#39; =&gt; Plank\Mediable\UrlGenerators\S3UrlGenerator::class,</span>
-<span class="x">],</span>
+<div class="highlight-php"><div class="highlight"><pre><span></span><span class="cp">&lt;?php</span>
+<span class="cm">/*</span>
+<span class="cm"> * FQCN of the model to use for media</span>
+<span class="cm"> *</span>
+<span class="cm"> * Should extend Plank\Mediable\Media::class</span>
+<span class="cm"> */</span>
+<span class="s1">&#39;model&#39;</span> <span class="o">=&gt;</span> <span class="nx">Plank\Mediable\Media</span><span class="o">::</span><span class="na">class</span><span class="p">,</span>
+
+<span class="cm">/*</span>
+<span class="cm"> * List of adapters to use for various source inputs</span>
+<span class="cm"> *</span>
+<span class="cm"> * Adapters can map either to a class or a pattern (regex)</span>
+<span class="cm"> */</span>
+<span class="s1">&#39;source_adapters&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+    <span class="s1">&#39;class&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+        <span class="nx">Symfony\Component\HttpFoundation\File\UploadedFile</span><span class="o">::</span><span class="na">class</span> <span class="o">=&gt;</span> <span class="nx">Plank\Mediable\SourceAdapters\UploadedFileAdapter</span><span class="o">::</span><span class="na">class</span><span class="p">,</span>
+        <span class="nx">Symfony\Component\HttpFoundation\File\File</span><span class="o">::</span><span class="na">class</span> <span class="o">=&gt;</span> <span class="nx">Plank\Mediable\SourceAdapters\FileAdapter</span><span class="o">::</span><span class="na">class</span><span class="p">,</span>
+    <span class="p">],</span>
+    <span class="s1">&#39;pattern&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+        <span class="s1">&#39;^https?://&#39;</span> <span class="o">=&gt;</span> <span class="nx">Plank\Mediable\SourceAdapters\RemoteUrlAdapter</span><span class="o">::</span><span class="na">class</span><span class="p">,</span>
+        <span class="s1">&#39;^/&#39;</span> <span class="o">=&gt;</span> <span class="nx">Plank\Mediable\SourceAdapters\LocalPathAdapter</span><span class="o">::</span><span class="na">class</span>
+    <span class="p">],</span>
+<span class="p">],</span>
+
+<span class="cm">/*</span>
+<span class="cm"> * List of URL Generators to use for handling various filesystem disks</span>
+<span class="cm"> */</span>
+<span class="s1">&#39;url_generators&#39;</span> <span class="o">=&gt;</span> <span class="p">[</span>
+    <span class="s1">&#39;local&#39;</span> <span class="o">=&gt;</span> <span class="nx">Plank\Mediable\UrlGenerators\LocalUrlGenerator</span><span class="o">::</span><span class="na">class</span><span class="p">,</span>
+    <span class="s1">&#39;s3&#39;</span> <span class="o">=&gt;</span> <span class="nx">Plank\Mediable\UrlGenerators\S3UrlGenerator</span><span class="o">::</span><span class="na">class</span><span class="p">,</span>
+<span class="p">],</span>
 </pre></div>
 </div>
 </div>
@@ -338,7 +413,7 @@ <h1>Configuration<a class="headerlink" href="#configuration" title="Permalink to
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.2.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/genindex.html b/docs/build/html/genindex.html
index c5184d2..8595801 100644
--- a/docs/build/html/genindex.html
+++ b/docs/build/html/genindex.html
@@ -9,7 +9,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Index &mdash; Laravel-Mediable 2.0.0 documentation</title>
+  <title>Index &mdash; Laravel-Mediable 2.2.0 documentation</title>
   
 
   
@@ -31,7 +31,7 @@
   
 
   
-    <link rel="top" title="Laravel-Mediable 2.0.0 documentation" href="index.html"/> 
+    <link rel="top" title="Laravel-Mediable 2.2.0 documentation" href="index.html"/> 
 
   
   <script src="_static/js/modernizr.min.js"></script>
@@ -59,7 +59,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.2.0
               </div>
             
           
@@ -173,7 +173,7 @@ <h1 id="index">Index</h1>
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.2.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/index.html b/docs/build/html/index.html
index 1ba8bd7..2622dc0 100644
--- a/docs/build/html/index.html
+++ b/docs/build/html/index.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Plank/Laravel-Mediable &mdash; Laravel-Mediable 2.0.0 documentation</title>
+  <title>Plank/Laravel-Mediable &mdash; Laravel-Mediable 2.2.0 documentation</title>
   
 
   
@@ -30,7 +30,7 @@
   
 
   
-    <link rel="top" title="Laravel-Mediable 2.0.0 documentation" href="#"/>
+    <link rel="top" title="Laravel-Mediable 2.2.0 documentation" href="#"/>
         <link rel="next" title="Installation" href="installation.html"/> 
 
   
@@ -59,7 +59,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.2.0
               </div>
             
           
@@ -243,7 +243,7 @@ <h2>Features<a class="headerlink" href="#features" title="Permalink to this head
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.2.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/installation.html b/docs/build/html/installation.html
index 28772fd..503a9c5 100644
--- a/docs/build/html/installation.html
+++ b/docs/build/html/installation.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Installation &mdash; Laravel-Mediable 2.0.0 documentation</title>
+  <title>Installation &mdash; Laravel-Mediable 2.2.0 documentation</title>
   
 
   
@@ -30,7 +30,7 @@
   
 
   
-    <link rel="top" title="Laravel-Mediable 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="Laravel-Mediable 2.2.0 documentation" href="index.html"/>
         <link rel="next" title="Configuration" href="configuration.html"/>
         <link rel="prev" title="Plank/Laravel-Mediable" href="index.html"/> 
 
@@ -60,7 +60,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.2.0
               </div>
             
           
@@ -210,7 +210,7 @@ <h1>Installation<a class="headerlink" href="#installation" title="Permalink to t
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.2.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/media.html b/docs/build/html/media.html
index dfa80f3..ba491a6 100644
--- a/docs/build/html/media.html
+++ b/docs/build/html/media.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Using Media &mdash; Laravel-Mediable 2.0.0 documentation</title>
+  <title>Using Media &mdash; Laravel-Mediable 2.2.0 documentation</title>
   
 
   
@@ -30,7 +30,7 @@
   
 
   
-    <link rel="top" title="Laravel-Mediable 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="Laravel-Mediable 2.2.0 documentation" href="index.html"/>
         <link rel="next" title="Aggregate Types" href="types.html"/>
         <link rel="prev" title="Handling Media" href="mediable.html"/> 
 
@@ -60,7 +60,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.2.0
               </div>
             
           
@@ -268,7 +268,7 @@ <h3>Soft Deletes<a class="headerlink" href="#soft-deletes" title="Permalink to t
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.2.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/mediable.html b/docs/build/html/mediable.html
index 8bd68f4..5d5ce5b 100644
--- a/docs/build/html/mediable.html
+++ b/docs/build/html/mediable.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Handling Media &mdash; Laravel-Mediable 2.0.0 documentation</title>
+  <title>Handling Media &mdash; Laravel-Mediable 2.2.0 documentation</title>
   
 
   
@@ -30,7 +30,7 @@
   
 
   
-    <link rel="top" title="Laravel-Mediable 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="Laravel-Mediable 2.2.0 documentation" href="index.html"/>
         <link rel="next" title="Using Media" href="media.html"/>
         <link rel="prev" title="Uploading Files" href="uploader.html"/> 
 
@@ -60,7 +60,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.2.0
               </div>
             
           
@@ -213,7 +213,7 @@ <h2>Retrieving Media<a class="headerlink" href="#retrieving-media" title="Permal
 <span class="nv">$media</span> <span class="o">=</span> <span class="nv">$post</span><span class="o">-&gt;</span><span class="na">getMedia</span><span class="p">(</span><span class="s1">&#39;thumbnail&#39;</span><span class="p">);</span>
 </pre></div>
 </div>
-<p>This returns a collection of all media assigned to that tag. In cases where you only need one <cite>Media</cite> entity, you can instead use <cite>firstMedia()</cite>.</p>
+<p>This returns a collection of all media assigned to that tag. In cases where you only need one <code class="docutils literal"><span class="pre">Media</span></code> entity, you can instead use <code class="docutils literal"><span class="pre">firstMedia()</span></code>.</p>
 <div class="highlight-php"><div class="highlight"><pre><span></span><span class="cp">&lt;?php</span>
 <span class="nv">$media</span> <span class="o">=</span> <span class="nv">$post</span><span class="o">-&gt;</span><span class="na">firstMedia</span><span class="p">(</span><span class="s1">&#39;thumbnail&#39;</span><span class="p">);</span>
 <span class="c1">// shorthand for</span>
@@ -437,7 +437,7 @@ <h3>Soft Deletes<a class="headerlink" href="#soft-deletes" title="Permalink to t
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.2.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/objects.inv b/docs/build/html/objects.inv
index 9556af9..0f3cca2 100644
--- a/docs/build/html/objects.inv
+++ b/docs/build/html/objects.inv
@@ -1,6 +1,6 @@
 # Sphinx inventory version 2
 # Project: Laravel-Mediable
-# Version: 2.0.0
+# Version: 2.2.0
 # The remainder of this file is compressed using zlib.
 xڅ�Mo!���
 �n�^{3�Njbb۫��,`����.hSo;/�;3���AW�GK�c��(i�@[�6�����n�:9��7���~�����@����6��ڐ�Ό}J*��Ծ���TH�	����>��ѡbB�զWm8)����kj�K�i��J(��:qV�=>§'�~��8d�a�'�k2��|��v�v�}J���m�	-$���'8�l���%z�/*��۔z�Ҩ�.�K~"�mC�C���:W��"��wD�������k���q������/��8��/H�B�܋]��RCS�YKW������q���Y���?g���1RY
\ No newline at end of file
diff --git a/docs/build/html/search.html b/docs/build/html/search.html
index 34dd7ab..145fffc 100644
--- a/docs/build/html/search.html
+++ b/docs/build/html/search.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Search &mdash; Laravel-Mediable 2.0.0 documentation</title>
+  <title>Search &mdash; Laravel-Mediable 2.2.0 documentation</title>
   
 
   
@@ -30,7 +30,7 @@
   
 
   
-    <link rel="top" title="Laravel-Mediable 2.0.0 documentation" href="index.html"/> 
+    <link rel="top" title="Laravel-Mediable 2.2.0 documentation" href="index.html"/> 
 
   
   <script src="_static/js/modernizr.min.js"></script>
@@ -58,7 +58,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.2.0
               </div>
             
           
@@ -176,7 +176,7 @@
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.2.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/searchindex.js b/docs/build/html/searchindex.js
index 52936d5..d10d841 100644
--- a/docs/build/html/searchindex.js
+++ b/docs/build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({envversion:49,filenames:["index","mediable"],objects:{},objnames:{},objtypes:{},terms:{"case":1,"class":1,"default":1,"function":[0,1],"import":[0,1],"new":1,"return":1,"true":1,"while":1,abl:1,accept:1,access:[0,1],add:1,after:1,aggreg:0,aggregat:0,alia:1,all:1,allow:[0,1],alreadi:1,also:1,alwai:1,ani:[0,1],anoth:1,any:1,app:1,appli:1,applic:1,approach:[0,1],argument:1,arrai:1,artisan:0,assign:[0,1],associ:1,assume:1,attach:0,attachmedia:1,attempt:1,automat:0,avail:1,avoid:1,basi:1,behaviour:1,between:1,both:1,builder:1,call:1,can:1,care:1,chang:1,check:0,claus:1,code:1,collect:1,command:0,commit:1,condition:1,config:1,configur:0,consid:1,consider:1,content:1,coupl:1,databas:1,deal:1,defin:1,delet:0,describ:1,destin:0,detach:0,detach_on_soft_delet:1,detachmedia:1,detachmediatag:1,differ:0,directli:1,directori:0,dirti:1,disabl:1,disk:0,down:1,download:0,driven:0,duplic:0,each:1,easili:0,echo:1,either:1,eloqu:1,eloquent:1,empti:1,enabl:1,entiti:1,exampl:1,execut:1,exist:1,extend:[0,1],extens:0,fals:1,file:[0,1],filenam:0,filesystem:0,first:1,firstmedia:1,follow:1,footer:1,forcedelet:1,foreach:1,from:1,galleri:[0,1],get:[0,1],getallmediabytag:1,getkei:1,getmedia:1,getmediamatchal:1,gettagsformedia:1,geturl:1,gif:0,given:1,group:1,guid:0,handl:0,hasmedia:1,have:1,header:1,how:1,illumin:1,imag:0,index:1,indiviud:1,input:1,insert:1,installat:0,instanc:1,instead:1,issu:1,item:1,jpeg:0,keep:1,kei:1,least:1,like:1,limit:1,load:0,loadmedia:1,loadmediamatchal:1,mani:[0,1],manipul:1,mark:1,match_al:1,media1:1,media2:1,media:0,method:1,mime:0,model:[0,1],modifi:[0,1],more:1,move:0,multipl:1,namespac:1,need:[0,1],new_media:1,next:1,note:1,number:[0,1],numer:1,oen:1,onli:1,optim:1,order:0,other:[0,1],packag:[0,1],page:1,paramet:1,parent:1,part:1,particular:1,pass:1,path:0,perform:1,php:1,png:0,polymorph:0,post:1,prefer:1,preload:1,prepend:1,presenc:0,previous:1,problem:1,properti:1,protect:1,provid:1,purg:1,purpos:0,queri:[0,1],read:1,record:1,refer:1,rehydr:0,rehydrate_media:1,rehydrates_media:1,relat:1,relationship:[0,1],reload:1,remov:1,render:1,replac:0,restrict:0,retriev:0,run:1,same:1,schema:0,scope:1,second:1,separ:1,set:[0,1],share:1,shorthand:1,should:1,similarli:1,simpli:1,singl:1,slow:1,softdelet:1,sourc:0,specif:[0,1],specifi:[0,1],standard:1,start:0,still:1,string:1,sum:1,syncmedia:1,system:1,tag:[0,1],take:1,taken:1,tell:1,thei:1,thi:1,those:1,thumbnail:[0,1],time:1,track:1,trait:1,type:0,unord:1,update:0,upload:0,url:0,using:0,valid:0,valu:1,verifi:1,wai:1,want:1,when:1,where:1,wherehasmedia:1,which:1,wide:1,withmedia:1,withmediamatchal:1,without:[0,1],would:1,you:1,your:1},titles:["Plank/Laravel-Mediable","Handling Media"],titleterms:{attach:1,automat:1,check:1,delet:1,detach:1,eager:1,featur:0,handl:1,laravel:0,lazi:1,load:1,media:1,mediabl:[0,1],order:1,plank:0,presenc:1,rehydr:1,replac:1,retriev:1,soft:1}})
\ No newline at end of file
+Search.setIndex({envversion:49,filenames:["configuration","index","mediable"],objects:{},objnames:{},objtypes:{},terms:{"byte":0,"case":[0,2],"class":[0,2],"default":[0,2],"import":[1,2],"new":[0,2],"public":0,"return":[0,2],"throw":0,"true":[0,2],"try":0,"while":2,abl:[0,2],about:0,accept:2,access:[0,1,2],adapt:0,adapter:0,add:[0,2],addit:0,after:2,aggreg:[0,1],aggregate_typ:0,alia:2,all:2,allow:[0,1,2],allow_unrecognized_typ:0,allowed_aggregate_typ:0,allowed_disk:0,allowed_extens:0,allowed_mime_typ:0,alreadi:2,also:2,alwai:[0,2],amazonaw:0,ani:[1,2],anoth:2,any:2,app:[0,2],appli:2,applic:[0,2],approach:[1,2],argument:2,arrai:2,artisan:1,asset:0,assign:[1,2],associ:2,assum:0,assume:2,attach:1,attachmedia:2,attempt:2,author:0,automat:1,avail:2,avoid:2,base:0,basi:[0,2],befor:0,behaviour:[0,2],belong:0,below:0,best:0,between:2,both:[0,2],bucket:0,builder:2,built:0,call:2,can:[0,2],care:2,chang:2,check:1,claus:2,cloud:0,code:2,collect:2,com:0,command:1,commit:2,common:0,compon:0,condition:2,config:[0,2],congfig:0,consid:2,consider:2,constantli:0,content:2,could:0,coupl:2,cover:0,creat:0,databas:2,deal:2,default_disk:0,defin:[0,2],definit:0,delet:[0,1],describ:2,destin:1,detach:1,detach_on_soft_delet:2,detachmedia:2,detachmediatag:2,determin:0,differ:[0,1],directli:2,directori:1,dirti:2,disabl:2,document:0,domain:0,done:0,down:2,download:1,driven:1,driver:0,duplic:[0,1],each:[0,2],easi:0,easili:1,echo:2,edit:0,either:[0,2],eloqu:2,eloquent:2,elsewher:0,empti:2,enabl:2,entiti:2,env:0,error:0,exampl:[0,2],except:0,exception:0,execut:2,exist:2,extens:[0,1],fals:[0,2],feel:0,file:[0,1,2],fileadapt:0,filenam:1,filesystem:[0,1],find:0,first:2,firstmedia:2,follow:[0,2],foo:0,footer:2,forcedelet:2,foreach:2,fqcn:0,free:0,from:2,galleri:[1,2],gener:0,get:[1,2],getallmediabytag:2,getkei:2,getmedia:2,getmediamatchal:2,gettagsformedia:2,geturl:[0,2],gif:1,given:[0,2],group:2,guid:1,handl:[0,1],hasmedia:2,have:[0,2],header:2,how:[0,2],htm:0,html:0,http:0,httpfoundat:0,identifi:0,illumin:2,imag:1,includ:0,increment:0,index:2,indiviud:2,inform:0,input:[0,2],insert:2,installat:1,instanc:[0,2],instead:2,instruct:0,intend:0,intern:0,issu:2,item:2,jpeg:1,jpg:0,juggl:0,keep:2,kei:[0,2],kind:0,laravel:[],latest:0,learn:0,least:2,let:0,like:[0,2],limit:2,link:0,list:0,load:1,loadmedia:2,loadmediamatchal:2,local:0,localpathadapt:0,localurlgener:0,locat:0,make:0,mani:[0,1,2],manipul:2,map:0,mark:2,markdown:0,markup:0,match:0,match_al:2,max_siz:0,maximum:0,media1:2,media2:2,media:[0,1],mediabl:[],mediableurlexcept:0,mediaupload:0,method:2,mime:[0,1],mime_typ:0,model:[0,1,2],modifi:[0,1,2],more:[0,2],move:1,multipl:[0,2],name:0,namespac:2,need:[0,1,2],new_media:2,next:2,none:0,note:[0,2],number:[0,1,2],numer:2,oen:2,offer:0,old:0,on_dupl:0,on_duplicate_increment:0,once:0,onli:[0,2],only:0,optim:2,option:0,order:1,other:[0,1,2],overridden:0,own:0,packag:[0,1,2],page:2,paramet:2,parent:2,part:2,particular:2,pass:2,path:1,pattern:0,per:0,perform:2,permiss:0,php:[0,2],place:0,plank:[],plankmediablemediaupload:[],png:1,polymorph:1,post:2,prefer:2,prefix:0,preload:2,prepend:2,presenc:1,present:0,previous:2,privat:0,problem:2,properti:2,protect:2,provid:[0,2],public_path:0,publicli:0,purg:2,purpos:1,queri:[1,2],read:2,recogn:0,record:[0,2],refer:2,regex:0,region:0,rehydr:1,rehydrate_media:2,rehydrates_media:2,reject:0,relat:2,relationship:[1,2],reload:2,remoteurladapt:0,remov:2,render:2,replac:[0,1],requir:0,restrict:1,retriev:1,root:0,run:2,s3_bucket:0,s3_key:0,s3_region:0,s3_secret:0,s3urlgener:0,same:2,schema:1,scope:2,second:2,secret:0,separ:2,serv:0,set:[0,1,2],setup:0,share:[0,2],shorthand:2,should:[0,2],similar:0,similarli:2,simpli:2,singl:[0,2],size:0,slow:2,softdelet:2,some:0,sourc:[0,1],source_adapt:0,sourceadapt:0,specif:[0,1,2],specifi:[0,1,2],standard:2,start:1,still:2,storag:0,storage_path:0,store:0,strict_type_check:0,string:2,suffix:0,sum:2,symbol:0,symfoni:0,symlink:0,syncmedia:2,system:[0,2],tag:[1,2],take:2,taken:2,tell:2,text:0,than:0,thei:2,themselv:0,thi:[0,2],those:2,thrown:0,thumbnail:[1,2],time:2,top:0,track:2,trait:2,under:0,unless:0,unord:2,update:1,upload:[0,1],uploadedfil:0,uploadedfileadapt:0,url:[0,1],url_gener:0,urlgener:0,using:1,valu:[0,2],variou:0,verifi:2,version:0,wai:2,want:[0,2],webroot:0,what:0,when:2,where:[0,2],wherehasmedia:2,which:[0,2],whose:0,wide:2,withmedia:2,withmediamatchal:2,without:[0,1,2],would:[0,2],xhtml:0,xml:0,you:[0,2],your:[0,2]},titles:["Configuration","Plank/Laravel-Mediable","Handling Media"],titleterms:{"function":0,aggregat:0,attach:2,automat:2,check:2,configur:0,delet:2,detach:2,disk:0,eager:2,extend:0,featur:1,handl:2,laravel:1,lazi:2,load:2,media:2,mediabl:[1,2],order:2,plank:1,presenc:2,rehydr:2,replac:2,retriev:2,soft:2,type:0,valid:0,visibl:0}})
\ No newline at end of file
diff --git a/docs/build/html/types.html b/docs/build/html/types.html
index 7e24643..bd2e909 100644
--- a/docs/build/html/types.html
+++ b/docs/build/html/types.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Aggregate Types &mdash; Laravel-Mediable 2.0.0 documentation</title>
+  <title>Aggregate Types &mdash; Laravel-Mediable 2.2.0 documentation</title>
   
 
   
@@ -30,7 +30,7 @@
   
 
   
-    <link rel="top" title="Laravel-Mediable 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="Laravel-Mediable 2.2.0 documentation" href="index.html"/>
         <link rel="next" title="Artisan Commands" href="commands.html"/>
         <link rel="prev" title="Using Media" href="media.html"/> 
 
@@ -60,7 +60,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.2.0
               </div>
             
           
@@ -196,7 +196,7 @@ <h1>Aggregate Types<a class="headerlink" href="#aggregate-types" title="Permalin
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.2.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/build/html/uploader.html b/docs/build/html/uploader.html
index c3f7bbd..598c9f6 100644
--- a/docs/build/html/uploader.html
+++ b/docs/build/html/uploader.html
@@ -8,7 +8,7 @@
   
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   
-  <title>Uploading Files &mdash; Laravel-Mediable 2.0.0 documentation</title>
+  <title>Uploading Files &mdash; Laravel-Mediable 2.2.0 documentation</title>
   
 
   
@@ -30,7 +30,7 @@
   
 
   
-    <link rel="top" title="Laravel-Mediable 2.0.0 documentation" href="index.html"/>
+    <link rel="top" title="Laravel-Mediable 2.2.0 documentation" href="index.html"/>
         <link rel="next" title="Handling Media" href="mediable.html"/>
         <link rel="prev" title="Configuration" href="configuration.html"/> 
 
@@ -60,7 +60,7 @@
             
             
               <div class="version">
-                2.0.0
+                2.2.0
               </div>
             
           
@@ -311,7 +311,7 @@ <h2>Updating Files<a class="headerlink" href="#updating-files" title="Permalink
     <script type="text/javascript">
         var DOCUMENTATION_OPTIONS = {
             URL_ROOT:'./',
-            VERSION:'2.0.0',
+            VERSION:'2.2.0',
             COLLAPSE_INDEX:false,
             FILE_SUFFIX:'.html',
             HAS_SOURCE:  true
diff --git a/docs/source/conf.py b/docs/source/conf.py
index b027c9a..472cda4 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -59,9 +59,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = u'2.0.0'
+version = u'2.2.0'
 # The full version, including alpha/beta/rc tags.
-release = u'2.0.0'
+release = u'2.2.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/docs/source/configuration.rst b/docs/source/configuration.rst
index ab60e27..25fed20 100644
--- a/docs/source/configuration.rst
+++ b/docs/source/configuration.rst
@@ -14,6 +14,7 @@ An example setup with one private disk (``local``) and one publicly accessible d
 
 ::
 
+    <?php
     //...
     'disks' => [
         'local' => [
@@ -33,6 +34,7 @@ Once you have set up as many disks as you need, edit ``config/mediable.php`` to
 
 ::
 
+    <?php
     //...
     /*
      * Filesystem disk to use if none is specified
@@ -47,6 +49,85 @@ Once you have set up as many disks as you need, edit ``config/mediable.php`` to
     ],
     //...
 
+
+Disk Visibility
+^^^^^^^^^^^^^^^
+
+This package is able to generate public URLs for accessing media, and uses the disk config to determine how this should be done.
+
+URLs can always be generated for ``Media`` placed on a disk located below the webroot.
+
+::
+
+    <?php
+    'disks' => [
+        'uploads' => [
+            'driver' => 'local',
+            'root' => public_path('uploads'),
+        ],
+    ]
+
+    //...
+
+    $media->getUrl(); // returns http://domain.com/uploads/foo.jpg
+
+``Media`` placed on a disk located elsewhere will throw an exception.
+
+::
+
+    <?php
+    'disks' => [
+        'private' => [
+            'driver' => 'local',
+            'root' => storage_path('private'),
+        ],
+    ]
+
+    //...
+
+    $media->getUrl(); // Throws a Plank\Mediable\Exceptions\MediableUrlException
+
+If you are using symbolic links to make local disks accessible, you can instruct the package to generate URLs with the ``'visibility' => 'public'`` key. By default, the package will assume that the symlink is named ``'storage'``, as per `laravel's documentation <https://laravel.com/docs/5.3/filesystem#the-public-disk>`_. This can be modified with the ``'prefix'`` key.
+
+::
+
+    <?php
+    'disks' => [
+        'public' => [
+            'driver' => 'local',
+            'root' => storage_path('public'),
+            'visibility' => 'public',
+            'prefix' => 'assets'
+        ],
+    ]
+
+    //...
+
+    $media->getUrl(); // returns http://domain.com/assets/foo.jpg
+
+
+Permissions for S3-based disks is set on the buckets themselves. You can inform the package that ``Media`` on an S3 disk can be linked by URL by adding the ``'visibility' => 'public'`` key to the disk congfig.
+
+::
+
+    <?php
+    'disks' => [
+        'cloud' => [
+            'driver' => 's3',
+            'key'    => env('S3_KEY'),
+            'secret' => env('S3_SECRET'),
+            'region' => env('S3_REGION'),
+            'bucket' => env('S3_BUCKET'),
+            'version' => 'latest',
+            'visibility' => 'public'
+        ],
+    ]
+
+    //...
+
+    $media->getUrl(); // returns https://s3.amazonaws.com/bucket/foo.jpg
+
+
 .. _validation:
 
 Validation
@@ -56,6 +137,7 @@ The `config/mediable.php` offers a number of options for configuring how media u
 
 ::
 
+    <?php
     //...
     /*
      * The maximum file size in bytes for a single uploaded file
@@ -106,10 +188,11 @@ Aggregate Types
 
 Laravel-Mediable provides functionality for handling multiple kinds of files under a shared aggregate type. This is intended to make it easy to find similar media without needing to constantly juggle multiple MIME types or file extensions.
 
-The package defines a number of common file types in the config file (config/mediable.php). Feel free to modify the default types provided by the package or add your own. Each aggregate type requires a key used to identify the type and a list of MIME types and file extensions that should be recognized as belonging to that aggregate type. For example, if you wanted to add an aggregate type for different types of markup, you could do the following.
+The package defines a number of common file types in the config file (``config/mediable.php``). Feel free to modify the default types provided by the package or add your own. Each aggregate type requires a key used to identify the type and a list of MIME types and file extensions that should be recognized as belonging to that aggregate type. For example, if you wanted to add an aggregate type for different types of markup, you could do the following.
 
 ::
 
+    <?php
     //...
     'aggregate_types' => [
         //...
@@ -145,6 +228,7 @@ The ``config/mediable.php`` file lets you specify a number of classes to be use
 
 ::
 
+    <?php
     /*
      * FQCN of the model to use for media
      *
diff --git a/docs/source/mediable.rst b/docs/source/mediable.rst
index 9540d67..ae809a8 100644
--- a/docs/source/mediable.rst
+++ b/docs/source/mediable.rst
@@ -72,7 +72,7 @@ You can retrieve media attached to a file by refering to the tag to which it was
     <?php
     $media = $post->getMedia('thumbnail');
 
-This returns a collection of all media assigned to that tag. In cases where you only need one `Media` entity, you can instead use `firstMedia()`.
+This returns a collection of all media assigned to that tag. In cases where you only need one ``Media`` entity, you can instead use ``firstMedia()``.
 
 ::
 
diff --git a/src/UrlGenerators/BaseUrlGenerator.php b/src/UrlGenerators/BaseUrlGenerator.php
index 2a2bb7c..6555685 100644
--- a/src/UrlGenerators/BaseUrlGenerator.php
+++ b/src/UrlGenerators/BaseUrlGenerator.php
@@ -42,6 +42,14 @@ public function setMedia(Media $media)
         $this->media = $media;
     }
 
+    /**
+     * {@inheritdoc}
+     */
+    public function isPubliclyAccessible()
+    {
+        return $this->getDiskConfig('visibility', 'private') == 'public';
+    }
+
     /**
      * Get a config value for the current disk.
      * @param  string $key
diff --git a/src/UrlGenerators/LocalUrlGenerator.php b/src/UrlGenerators/LocalUrlGenerator.php
index 97253b8..4db35b0 100644
--- a/src/UrlGenerators/LocalUrlGenerator.php
+++ b/src/UrlGenerators/LocalUrlGenerator.php
@@ -34,7 +34,7 @@ public function __construct(Config $config, Url $url)
      */
     public function isPubliclyAccessible()
     {
-        return strpos($this->getAbsolutePath(), public_path()) === 0;
+        return  parent::isPubliclyAccessible() || $this->isInWebroot();
     }
 
     /**
@@ -47,7 +47,11 @@ public function getPublicPath()
         if (! $this->isPubliclyAccessible()) {
             throw MediaUrlException::mediaNotPubliclyAccessible($this->getAbsolutePath(), public_path());
         }
-        $path = str_replace(public_path(), '', $this->getAbsolutePath());
+        if($this->isInWebroot()){
+            $path = str_replace(public_path(), '', $this->getAbsolutePath());
+        }else{
+            $path = rtrim($this->getDiskConfig('prefix', 'storage'), '/') . '/' . $this->media->getDiskPath();
+        }
 
         return $this->cleanDirectorySeparators($path);
     }
@@ -82,4 +86,9 @@ protected function cleanDirectorySeparators($path)
 
         return $path;
     }
+
+    private function isInWebroot()
+    {
+        return strpos($this->getAbsolutePath(), public_path()) === 0;
+    }
 }
diff --git a/src/UrlGenerators/S3UrlGenerator.php b/src/UrlGenerators/S3UrlGenerator.php
index 336ae47..6cb180e 100644
--- a/src/UrlGenerators/S3UrlGenerator.php
+++ b/src/UrlGenerators/S3UrlGenerator.php
@@ -38,16 +38,6 @@ public function getAbsolutePath()
         return $this->getUrl();
     }
 
-    /**
-     * {@inheritdoc}
-     */
-    public function isPubliclyAccessible()
-    {
-        //file permissions are set on the buckets themselves
-        //use config value if possible
-        return $this->getDiskConfig('visibility', 'public') == 'public';
-    }
-
     /**
      * {@inheritdoc}
      */
diff --git a/src/UrlGenerators/UrlGeneratorInterface.php b/src/UrlGenerators/UrlGeneratorInterface.php
index fc8c0f6..d8a2ac1 100644
--- a/src/UrlGenerators/UrlGeneratorInterface.php
+++ b/src/UrlGenerators/UrlGeneratorInterface.php
@@ -28,6 +28,8 @@ public function getAbsolutePath();
 
     /**
      * Check if the file is publicly accessible.
+     *
+     * Disks configs should indicate this with the visibility key
      * @return bool
      */
     public function isPubliclyAccessible();
diff --git a/tests/TestCase.php b/tests/TestCase.php
index 0f149e6..1bd9027 100644
--- a/tests/TestCase.php
+++ b/tests/TestCase.php
@@ -54,7 +54,12 @@ protected function getEnvironmentSetUp($app)
             'uploads' => [
                 'driver' => 'local',
                 'root' => public_path('uploads'),
-                'visibility' => 'public'
+            ],
+            'public_storage' => [
+                'driver' => 'local',
+                'root' => storage_path('public'),
+                'visibility' => 'public',
+                'prefix' => 'prefix'
             ],
             's3' => [
                 'driver' => 's3',
@@ -62,7 +67,8 @@ protected function getEnvironmentSetUp($app)
                 'secret' => env('S3_SECRET'),
                 'region' => env('S3_REGION'),
                 'bucket' => env('S3_BUCKET'),
-                'version' => 'latest'
+                'version' => 'latest',
+                'visibility' => 'public'
             ]
         ]);
 
diff --git a/tests/integration/UrlGenerators/LocalUrlGeneratorTest.php b/tests/integration/UrlGenerators/LocalUrlGeneratorTest.php
index c2d40ab..eedee29 100644
--- a/tests/integration/UrlGenerators/LocalUrlGeneratorTest.php
+++ b/tests/integration/UrlGenerators/LocalUrlGeneratorTest.php
@@ -27,6 +27,13 @@ public function test_it_throws_exception_for_non_public_disk()
         $generator->getPublicPath();
     }
 
+    public function test_it_accepts_public_visiblity()
+    {
+        $generator = $this->setupGenerator('public_storage');
+        $this->assertEquals('http://localhost/prefix/foo/bar.jpg', $generator->getUrl());
+
+    }
+
     protected function setupGenerator($disk = 'uploads')
     {
         $media = factory(Media::class)->make([

From 95dbb1d71010dbef86eeac80ebfd14b184e4fdc0 Mon Sep 17 00:00:00 2001
From: Sean Fraser <sean@plankdesign.com>
Date: Fri, 30 Sep 2016 11:25:21 -0400
Subject: [PATCH 3/7] fixed styles

---
 src/UrlGenerators/LocalUrlGenerator.php                   | 4 ++--
 tests/integration/UrlGenerators/LocalUrlGeneratorTest.php | 1 -
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/UrlGenerators/LocalUrlGenerator.php b/src/UrlGenerators/LocalUrlGenerator.php
index 4db35b0..53d1d8f 100644
--- a/src/UrlGenerators/LocalUrlGenerator.php
+++ b/src/UrlGenerators/LocalUrlGenerator.php
@@ -47,9 +47,9 @@ public function getPublicPath()
         if (! $this->isPubliclyAccessible()) {
             throw MediaUrlException::mediaNotPubliclyAccessible($this->getAbsolutePath(), public_path());
         }
-        if($this->isInWebroot()){
+        if ($this->isInWebroot()) {
             $path = str_replace(public_path(), '', $this->getAbsolutePath());
-        }else{
+        } else {
             $path = rtrim($this->getDiskConfig('prefix', 'storage'), '/') . '/' . $this->media->getDiskPath();
         }
 
diff --git a/tests/integration/UrlGenerators/LocalUrlGeneratorTest.php b/tests/integration/UrlGenerators/LocalUrlGeneratorTest.php
index eedee29..98f0a9b 100644
--- a/tests/integration/UrlGenerators/LocalUrlGeneratorTest.php
+++ b/tests/integration/UrlGenerators/LocalUrlGeneratorTest.php
@@ -31,7 +31,6 @@ public function test_it_accepts_public_visiblity()
     {
         $generator = $this->setupGenerator('public_storage');
         $this->assertEquals('http://localhost/prefix/foo/bar.jpg', $generator->getUrl());
-
     }
 
     protected function setupGenerator($disk = 'uploads')

From 2eff8901a5162d7245f96207fc21655e062776eb Mon Sep 17 00:00:00 2001
From: Sean Fraser <frasmage@gmail.com>
Date: Fri, 30 Sep 2016 11:26:17 -0400
Subject: [PATCH 4/7] Applied fixes from StyleCI (#37)

---
 src/UrlGenerators/LocalUrlGenerator.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/UrlGenerators/LocalUrlGenerator.php b/src/UrlGenerators/LocalUrlGenerator.php
index 53d1d8f..1d36954 100644
--- a/src/UrlGenerators/LocalUrlGenerator.php
+++ b/src/UrlGenerators/LocalUrlGenerator.php
@@ -50,7 +50,7 @@ public function getPublicPath()
         if ($this->isInWebroot()) {
             $path = str_replace(public_path(), '', $this->getAbsolutePath());
         } else {
-            $path = rtrim($this->getDiskConfig('prefix', 'storage'), '/') . '/' . $this->media->getDiskPath();
+            $path = rtrim($this->getDiskConfig('prefix', 'storage'), '/').'/'.$this->media->getDiskPath();
         }
 
         return $this->cleanDirectorySeparators($path);

From b1c286ff849a24e899b018302d117a3f029148fa Mon Sep 17 00:00:00 2001
From: Geidel Guerra <geidelguerra@gmail.com>
Date: Wed, 5 Oct 2016 15:02:19 -0400
Subject: [PATCH 5/7] Fix typo in MediaUploader

---
 src/MediaUploader.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MediaUploader.php b/src/MediaUploader.php
index 9cd5967..89290c9 100644
--- a/src/MediaUploader.php
+++ b/src/MediaUploader.php
@@ -609,7 +609,7 @@ private function handleDuplicate(Media $model)
     {
         switch ($this->config['on_duplicate']) {
             case static::ON_DUPLICATE_ERROR:
-                throw MediaUploadException::fileExists($model->getDiskpath);
+                throw MediaUploadException::fileExists($model->getDiskPath());
                 break;
             case static::ON_DUPLICATE_REPLACE:
                 $this->deleteExistingMedia($model);

From 82c714cb7a2da9d5250a82477dc2b9a2f0ca4850 Mon Sep 17 00:00:00 2001
From: Geidel Guerra <geidelguerra@gmail.com>
Date: Fri, 7 Oct 2016 17:06:29 -0400
Subject: [PATCH 6/7] Fix Media::scopeForPathOnDisk not working when directory
 name is empty. (#39)

---
 src/Media.php                   |  2 +-
 tests/integration/MediaTest.php | 12 ++++++++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/src/Media.php b/src/Media.php
index f17e8fb..ee73698 100644
--- a/src/Media.php
+++ b/src/Media.php
@@ -116,7 +116,7 @@ public function scopeWhereBasename(Builder $q, $basename)
     public function scopeForPathOnDisk(Builder $q, $disk, $path)
     {
         $q->where('disk', $disk)
-            ->where('directory', pathinfo($path, PATHINFO_DIRNAME))
+            ->where('directory', File::cleanDirname($path))
             ->where('filename', pathinfo($path, PATHINFO_FILENAME))
             ->where('extension', pathinfo($path, PATHINFO_EXTENSION));
     }
diff --git a/tests/integration/MediaTest.php b/tests/integration/MediaTest.php
index 69b97af..f517131 100644
--- a/tests/integration/MediaTest.php
+++ b/tests/integration/MediaTest.php
@@ -82,6 +82,18 @@ public function test_it_can_be_queried_by_path_on_disk()
         $this->assertEquals(4, Media::forPathOnDisk('tmp', 'foo/bar/baz/bat.jpg')->first()->id);
     }
 
+    public function test_it_can_be_queried_by_path_on_disk_when_directory_is_empty()
+    {
+        factory(Media::class)->create([
+            'id' => 4,
+            'disk' => 'tmp',
+            'directory' => '',
+            'filename' => 'bat',
+            'extension' => 'jpg'
+        ]);
+        $this->assertEquals(4, Media::forPathOnDisk('tmp', 'bat.jpg')->first()->id);
+    }
+
     public function test_it_can_view_human_readable_file_size()
     {
         $media = factory(Media::class)->make(['size' => 0]);

From f4c533cb40a6b01d1c82eced5fcfc6f1c1940606 Mon Sep 17 00:00:00 2001
From: Sean Fraser <frasmage@gmail.com>
Date: Tue, 18 Oct 2016 10:11:07 -0400
Subject: [PATCH 7/7] Applied fixes from StyleCI (#42)

---
 .../2016_06_27_000001_create_mediable_test_tables.php       | 6 +++---
 tests/integration/UrlGenerators/UrlGeneratorFactoryTest.php | 1 -
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/migrations/2016_06_27_000001_create_mediable_test_tables.php b/migrations/2016_06_27_000001_create_mediable_test_tables.php
index b1a7271..c181c12 100644
--- a/migrations/2016_06_27_000001_create_mediable_test_tables.php
+++ b/migrations/2016_06_27_000001_create_mediable_test_tables.php
@@ -16,13 +16,13 @@ class CreateMediableTestTables extends Migration
      */
     public function up()
     {
-        Schema::create('sample_mediables', function(Blueprint $table){
+        Schema::create('sample_mediables', function (Blueprint $table) {
             $table->increments('id');
             $table->timestamps();
             $table->softDeletes();
         });
 
-        Schema::table('media', function(Blueprint $table){
+        Schema::table('media', function (Blueprint $table) {
             $table->softDeletes();
         });
     }
@@ -34,7 +34,7 @@ public function up()
      */
     public function down()
     {
-        Schema::table('media', function(Blueprint $table){
+        Schema::table('media', function (Blueprint $table) {
             $table->dropColumn('deleted_at');
         });
         Schema::drop('sample_mediables');
diff --git a/tests/integration/UrlGenerators/UrlGeneratorFactoryTest.php b/tests/integration/UrlGenerators/UrlGeneratorFactoryTest.php
index d232fc9..67769fd 100644
--- a/tests/integration/UrlGenerators/UrlGeneratorFactoryTest.php
+++ b/tests/integration/UrlGenerators/UrlGeneratorFactoryTest.php
@@ -7,7 +7,6 @@
 
 class UrlGeneratorFactoryTest extends TestCase
 {
-
     public function test_it_sets_generator_for_driver()
     {
         $factory = new UrlGeneratorFactory;