Download the PHP package dive-be/nova-linkable-field without Composer
On this page you can find all versions of the php package dive-be/nova-linkable-field. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package nova-linkable-field
Nova Linkable Field
This package allows you to provide a field that can optionally link to a different model as an alternative to a manual attribute value.
What problem does this package solve?
Sometimes, you want users of the back-end to be able to either derive a value from a different model, or manually fill in the value.
If you have a model that might link to another model from which it derives an attribute, but also want to provide a fallback value (in case it isn't linked), that can get messy quick in the back-end. In that case you'll end up with two fields in the resource, and the user needs to understand that the fallback value is only used if the resource isn't linked to another model. Not exactly obvious.
With this package, you can provide a single field where the user can explicitly choose, leaving zero room for confusion: get the value for an attribute from a particular model, or fill it in manually. (Check out the use case below.)
Use Case
For example: you have a MenuItem model in your application.
Maybe you want this MenuItem to link to a particular model (a Page model, perhaps?), which has its own URL. You can do that, or provide a manual URL alternative (if you do not want to link a model).
This makes it very obvious to users in Nova that the field in question is either linked or a fixed, manual value.
Requirements
laravel/framework: ^9.0laravel/nova: ^3.0
Installation
You can install the package via Composer:
You can publish the migrations and configuration file with:
Usage
Terminology
- A model can be linked to one or more models.
- The attached model is called the target, and the originator is the linked model.
- If no target is specified, the fallback value ("manual value") is used.
Setting up the resource
You must publish and run the included migrations:
php artisan vendor:publish --provider="Dive\Nova\Linkable\FieldServiceProvider"
php artisan migrateIn the resource, you can choose which field you would like to use a linkable field.
You can call the withLinkable method multiple times if you want to have multiple link options.
Setting up the model
First, let's start off with the link class, which is the originator. It needs the InteractsWithLinks trait.
So, if you have a homogenous collection that contains solely models of the same type, you can load this information. Here's how you can do this:
If you attempt to load linked relationships on a non-homogenous collection or on models that do not support linkable values, you'll get an exception explaining what went wrong.
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
- Nico Verbruggen
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
