Documentation of the FileManager Field

[gsusanj]

Hi there, first I would like to thank you for providing this package, specifically in such refined state. Unfortunately it seems the documentation is a bit lacking here, as I can see there are quite a few configuration options for FileManager field but they are not really documented anywhere (or are they?).
I would like to customize the folder, where files are stored within the disk for each resource separately (based on id and field in my case), is there a method to set this somewhere?

[Rezrazi]

Hi, thanks for the feedback

Could you give a bit more details about what's missing in the documentation ? We'll gladly add/update the documentation for it to be more clear

I'm not sure what you mean by customizing the folder

[gsusanj]

Well for one, the InteractsWithFilesystem Interface/Trait seems to have a lot of options available, what are the parameters for these callbacks, etc.

My use case is, that I have several FileManager fields within a single resource, and all of them should only interact with files stored in specific place based on the resource id (for example /storage/private/{id}/). I would like to limit, where the files can be uploaded and selected from by the id.

[Rezrazi]

The interface provides many utility methods, some are documented here https://oneduo.github.io/nova-file-manager/access-control.html

These methods can allow granular control over permissions to perform certain actions within the file browser.
You can take a look at these methods, and for any other internal method I'd invite you to dig around if you want to know how they work, they're not necessarily meant to be used externally :)

For your other use case, you can take a look at https://oneduo.github.io/nova-file-manager/access-control.html#on-demand-filesystem which will allow you to programmatically defined a disk to be served within your fields

[gsusanj]

Ahhh I missed this section completely, thank you!

One other issue I have right now is, that the field simply does not seems to work when displaying a Resource. Creating one is not an issue.

The error I get is:

[2022-09-29 13:18:42] local.ERROR: Call to a member function map() on string {"userId":1,"exception":"[object] (Error(code: 0): Call to a member function map() on string at C:\\Git\\zip\\lingu\\vendor\\oneduo\\nova-file-manager\\src\\FileManager.php:130)
[stacktrace]
#0 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Fields\\Field.php(333): Oneduo\\NovaFileManager\\FileManager->resolveAttribute(Object(App\\Models\\Contractors\\Contractor), 'certificates')
#1 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Fields\\Field.php(283): Laravel\\Nova\\Fields\\Field->resolve(Object(App\\Models\\Contractors\\Contractor), 'certificates')
#2 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Fields\\FieldCollection.php(99): Laravel\\Nova\\Fields\\Field->resolveForDisplay(Object(App\\Models\\Contractors\\Contractor))
#3 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Collections\\Traits\\EnumeratesValues.php(262): Laravel\\Nova\\Fields\\FieldCollection->Laravel\\Nova\\Fields\\{closure}(Object(Oneduo\\NovaFileManager\\FileManager), 14)
#4 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Fields\\FieldCollection.php(101): Illuminate\\Support\\Collection->each(Object(Closure))
#5 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\ResolvesFields.php(56): Laravel\\Nova\\Fields\\FieldCollection->resolveForDisplay(Object(App\\Models\\Contractors\\Contractor))
#6 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\ResolvesFields.php(221): Laravel\\Nova\\Resource->detailFields(Object(Laravel\\Nova\\Http\\Requests\\ResourceDetailRequest))
#7 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Resource.php(489): Laravel\\Nova\\Resource->detailFieldsWithinPanels(Object(Laravel\\Nova\\Http\\Requests\\ResourceDetailRequest), Object(App\\Nova\\Contractors\\Contractor))
#8 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Http\\Resources\\DetailViewResource.php(25): Laravel\\Nova\\Resource->serializeForDetail(Object(Laravel\\Nova\\Http\\Requests\\ResourceDetailRequest), Object(App\\Nova\\Contractors\\Contractor))
#9 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Http\\Resources\\Resource.php(41): Laravel\\Nova\\Http\\Resources\\DetailViewResource->toArray(Object(Laravel\\Nova\\Http\\Requests\\ResourceDetailRequest))
#10 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Http\\Controllers\\ResourceShowController.php(19): Laravel\\Nova\\Http\\Resources\\Resource->toResponse(Object(Laravel\\Nova\\Http\\Requests\\ResourceDetailRequest))
#11 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Routing\\Controller.php(54): Laravel\\Nova\\Http\\Controllers\\ResourceShowController->__invoke(Object(Laravel\\Nova\\Http\\Requests\\ResourceDetailRequest), 'contractors', '3')
#12 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Routing\\ControllerDispatcher.php(45): Illuminate\\Routing\\Controller->callAction('__invoke', Array)
#13 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Routing\\Route.php(261): Illuminate\\Routing\\ControllerDispatcher->dispatch(Object(Illuminate\\Routing\\Route), Object(Laravel\\Nova\\Http\\Controllers\\ResourceShowController), '__invoke')
#14 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Routing\\Route.php(204): Illuminate\\Routing\\Route->runController()
#15 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Routing\\Router.php(725): Illuminate\\Routing\\Route->run()
#16 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(141): Illuminate\\Routing\\Router->Illuminate\\Routing\\{closure}(Object(Illuminate\\Http\\Request))
#17 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Http\\Middleware\\Authorize.php(18): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#18 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Laravel\\Nova\\Http\\Middleware\\Authorize->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#19 C:\\Git\\zip\\lingu\\vendor\\vyuldashev\\nova-permission\\src\\ForgetCachedPermissions.php(23): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#20 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Vyuldashev\\NovaPermission\\ForgetCachedPermissions->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#21 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Http\\Middleware\\BootTools.php(20): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#22 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Laravel\\Nova\\Http\\Middleware\\BootTools->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#23 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Http\\Middleware\\DispatchServingNovaEvent.php(24): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#24 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Laravel\\Nova\\Http\\Middleware\\DispatchServingNovaEvent->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#25 C:\\Git\\zip\\lingu\\vendor\\inertiajs\\inertia-laravel\\src\\Middleware.php(92): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#26 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Inertia\\Middleware->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#27 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Routing\\Middleware\\SubstituteBindings.php(50): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#28 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Illuminate\\Routing\\Middleware\\SubstituteBindings->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#29 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Auth\\Middleware\\Authenticate.php(44): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#30 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Http\\Middleware\\Authenticate.php(31): Illuminate\\Auth\\Middleware\\Authenticate->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#31 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Laravel\\Nova\\Http\\Middleware\\Authenticate->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#32 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Foundation\\Http\\Middleware\\VerifyCsrfToken.php(78): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#33 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Illuminate\\Foundation\\Http\\Middleware\\VerifyCsrfToken->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#34 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\View\\Middleware\\ShareErrorsFromSession.php(49): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#35 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Illuminate\\View\\Middleware\\ShareErrorsFromSession->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#36 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Session\\Middleware\\StartSession.php(121): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#37 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Session\\Middleware\\StartSession.php(64): Illuminate\\Session\\Middleware\\StartSession->handleStatefulRequest(Object(Illuminate\\Http\\Request), Object(Illuminate\\Session\\Store), Object(Closure))
#38 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Illuminate\\Session\\Middleware\\StartSession->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#39 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Cookie\\Middleware\\AddQueuedCookiesToResponse.php(37): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#40 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Illuminate\\Cookie\\Middleware\\AddQueuedCookiesToResponse->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#41 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Cookie\\Middleware\\EncryptCookies.php(67): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#42 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Illuminate\\Cookie\\Middleware\\EncryptCookies->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#43 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(116): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#44 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Routing\\Router.php(726): Illuminate\\Pipeline\\Pipeline->then(Object(Closure))
#45 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Routing\\Router.php(703): Illuminate\\Routing\\Router->runRouteWithinStack(Object(Illuminate\\Routing\\Route), Object(Illuminate\\Http\\Request))
#46 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Routing\\Router.php(667): Illuminate\\Routing\\Router->runRoute(Object(Illuminate\\Http\\Request), Object(Illuminate\\Routing\\Route))
#47 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Routing\\Router.php(656): Illuminate\\Routing\\Router->dispatchToRoute(Object(Illuminate\\Http\\Request))
#48 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Foundation\\Http\\Kernel.php(189): Illuminate\\Routing\\Router->dispatch(Object(Illuminate\\Http\\Request))
#49 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(141): Illuminate\\Foundation\\Http\\Kernel->Illuminate\\Foundation\\Http\\{closure}(Object(Illuminate\\Http\\Request))
#50 C:\\Git\\zip\\lingu\\vendor\\livewire\\livewire\\src\\DisableBrowserCache.php(19): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#51 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Livewire\\DisableBrowserCache->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#52 C:\\Git\\zip\\lingu\\vendor\\laravel\\nova\\src\\Http\\Middleware\\ServeNova.php(23): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#53 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Laravel\\Nova\\Http\\Middleware\\ServeNova->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#54 C:\\Git\\zip\\lingu\\vendor\\barryvdh\\laravel-debugbar\\src\\Middleware\\InjectDebugbar.php(66): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#55 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Barryvdh\\Debugbar\\Middleware\\InjectDebugbar->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#56 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Foundation\\Http\\Middleware\\TransformsRequest.php(21): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#57 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Foundation\\Http\\Middleware\\ConvertEmptyStringsToNull.php(31): Illuminate\\Foundation\\Http\\Middleware\\TransformsRequest->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#58 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Illuminate\\Foundation\\Http\\Middleware\\ConvertEmptyStringsToNull->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#59 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Foundation\\Http\\Middleware\\TransformsRequest.php(21): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#60 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Foundation\\Http\\Middleware\\TrimStrings.php(40): Illuminate\\Foundation\\Http\\Middleware\\TransformsRequest->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#61 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Illuminate\\Foundation\\Http\\Middleware\\TrimStrings->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#62 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Foundation\\Http\\Middleware\\ValidatePostSize.php(27): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#63 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Illuminate\\Foundation\\Http\\Middleware\\ValidatePostSize->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#64 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Foundation\\Http\\Middleware\\PreventRequestsDuringMaintenance.php(86): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#65 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Illuminate\\Foundation\\Http\\Middleware\\PreventRequestsDuringMaintenance->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#66 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Http\\Middleware\\HandleCors.php(49): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#67 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Illuminate\\Http\\Middleware\\HandleCors->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#68 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Http\\Middleware\\TrustProxies.php(39): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#69 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(180): Illuminate\\Http\\Middleware\\TrustProxies->handle(Object(Illuminate\\Http\\Request), Object(Closure))
#70 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Pipeline\\Pipeline.php(116): Illuminate\\Pipeline\\Pipeline->Illuminate\\Pipeline\\{closure}(Object(Illuminate\\Http\\Request))
#71 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Foundation\\Http\\Kernel.php(164): Illuminate\\Pipeline\\Pipeline->then(Object(Closure))
#72 C:\\Git\\zip\\lingu\\vendor\\laravel\\framework\\src\\Illuminate\\Foundation\\Http\\Kernel.php(133): Illuminate\\Foundation\\Http\\Kernel->sendRequestThroughRouter(Object(Illuminate\\Http\\Request))
#73 C:\\Git\\zip\\lingu\\public\\index.php(52): Illuminate\\Foundation\\Http\\Kernel->handle(Object(Illuminate\\Http\\Request))
#74 {main}
"} 

In Database, I use Text field and when creating a resource its filled with [] (which I guess should be correct?). PS I want to use mutliple here as well.

In the resource, the config is:
FileManager::make( __( 'contractors.files.certificates' ), 'certificates' )->hideFromIndex()->multiple(),

[Rezrazi]

You are required to use a custom cast https://oneduo.github.io/nova-file-manager/installation.html#casting-your-model-attributes

[gsusanj]

I see, I guess this should not really go under the installation but usage section, specifically in the Field, because its directly related to it?

[gsusanj]

PS. Now it works, thank you

[Rezrazi]

It is placed in the installation and setup section due to its importance as it is one of the first sections one should read in a package documentation 😄