Allow Cells to be auto-located within */Cells directories

[lonnieezell]

Currently, when calling a View Cell you must enter the fully qualified class name. This change uses the FileLocator Factories class to search for the class within */Cells directories, allowing a simpler naming in views and a more standardized location for them.

So now we could do:

<?= view_cell('Blog::recent', 'limit=5') ?>

instead of

<?= view_cell('App\Modules\Blog\Cells\Blog::recent', 'limit=5') ?>

and it could be found in app/Cells, App/Modules/Blog/Cells, or any other namespace's Cells folder.

[MGatner]

An alternative which would offer a slightly broader feature (maybe desirable?) would be to use Factories; this would allow View Cells to support the "modular unless overwritten by App" features characteristic of Models and Configs.

For example, if Shield published a LoginCell then a developer would only need to supply app/Cells/LoginCell.php that extended it in order to use the replacement.

Just a thought; I like the improved locator skills generally.

[lonnieezell]

I had considered using Factories for this, but was thinking more about the caching uses and thinking it wouldn't be worth it for this. So I could go either way on this. I'm not sure the memory usage would be worth it here. Although the "modular unless overwritten by App" aspect makes it tempting.

I'll go ahead and try this with factories.

[MGatner]

Looks good with Factories! I'm fine with either way, was just an idea.

Picked up a User Guide syntax warning:

Warning: undefined label: view-cells

[kenjis]

I suggested the fixes for the docs.
The implementation seems good!

[lonnieezell]

@kenjis thanks for the docs updates. I've merged those. So I think we've covered everything.

[MGatner]

🥳