# added readme for existing media

# added configuration to enable existing media feature

readme.md

@@ -10,6 +10,7 @@ images and order them by drag and drop.
 * [Generic file management](#generic-file-management)  
 * [Single image upload](#single-image-upload)  
 * [Multiple image upload](#multiple-image-upload)  
+* [Selecting existing media](#selecting-existing-media)  
 * [Names of uploaded images](#names-of-uploaded-images)  
 * [Image cropping](#image-cropping)
 * [Custom properties](#custom-properties)
@@ -28,6 +29,10 @@ images and order them by drag and drop.
 composer require ebess/advanced-nova-media-library
 ```
 
+```bash
+artisan vendor:publish --tag=nova-media-library
+```
+
 ## Model media configuration
 
 Let's assume you configured your model to use the media library like following:
@@ -103,6 +108,32 @@ public function fields(Request $request)
 }
 ```
 
+## Selecting existing media
+
+![Selecting existing media](https://raw.githubusercontent.com/ebess/advanced-nova-media-library/master/docs/existing-media.png)
+![Selecting existing media 2](https://raw.githubusercontent.com/ebess/advanced-nova-media-library/master/docs/existing-media-2.png)
+
+If you upload the same media files to multiple models and you do not want to select it from the file system
+all over again, use this feature. Selecting an already existing media will **copy it**.
+
+**Attention**: This feature will expose an endpoint to every user of your application to search existing media. 
+If your media upload / custom properties on the media models are confidential, **do not enable this feature!** 
+
+* Publish the config files if you did not yet
+```bash
+artisan vendor:publish --tag=nova-media-library
+```
+* Enable this feature in config file *config/nova-media-library*
+```php
+return [
+    'enable-existing-media' => true,
+];
+```
+* Enable the selection of existing media field
+```php
+Images::make('Image')->enableExistingMedia(),
+```
+
 ## Names of uploaded images
 
 The default filename of the new uploaded file is the original filename. You can change this with the help of the function `setFileName`, which takes a callback function as the only param. This callback function has three params: `$originalFilename` (the original filename like `Fotolia 4711.jpg`), `$extension` (file extension like `jpg`), `$model` (the current model). Here are just 2 examples of what you can do:

src/AdvancedNovaMediaLibraryServiceProvider.php

@@ -11,6 +11,10 @@ class AdvancedNovaMediaLibraryServiceProvider extends ServiceProvider
 {
     public function boot()
     {
+        $this->publishes([
+            __DIR__ . '/config/nova-media-library.php' => config_path('nova-media-library.php'),
+        ], 'nova-media-library');
+
         $this->app->booted(function () {
             $this->routes();
         });

src/Fields/HandlesExistingMediaTrait.php

@@ -16,7 +16,7 @@ trait HandlesExistingMediaTrait
 {
     public function enableExistingMedia(): self
     {
-        return $this->withMeta(['existingMedia' => true]);
+        return $this->withMeta(['existingMedia' => (bool) config('nova-media-library.enable-existing-media')]);
     }
 
     private function addExistingMedia(NovaRequest $request, $data, HasMedia $model, string $collection, Collection $medias): Collection

src/Http/Controllers/MediaController.php

@@ -4,11 +4,16 @@
 
 use Ebess\AdvancedNovaMediaLibrary\Http\Requests\MediaRequest;
 use Ebess\AdvancedNovaMediaLibrary\Http\Resources\MediaResource;
+use Exception;
 
 class MediaController extends Controller
 {
     public function index(MediaRequest $request)
     {
+        if (!config('nova-media-library.enable-existing-media')) {
+            throw new Exception('You need to enable the `existing media` feature via config.');
+        }
+
         $mediaClass = config('medialibrary.media_model');
         $mediaClassIsSearchable = method_exists($mediaClass, 'search');
 

src/config/nova-media-library.php

@@ -0,0 +1,5 @@
+<?php
+
+return [
+    'enable-existing-media' => false,
+];