Current File : //home/forge/api-takeaseat.eco-n-tech.co.uk/vendor/laravel/nova/src/Fields/BelongsTo.php
<?php
namespace Laravel\Nova\Fields;
use Illuminate\Database\Eloquent\Relations\Relation;
use Illuminate\Http\Request;
use Illuminate\Support\Str;
use Laravel\Nova\Contracts\QueryBuilder;
use Laravel\Nova\Contracts\RelatableField;
use Laravel\Nova\Http\Requests\NovaRequest;
use Laravel\Nova\Http\Requests\ResourceIndexRequest;
use Laravel\Nova\Rules\Relatable;
use Laravel\Nova\TrashedStatus;
use Laravel\Nova\Util;
class BelongsTo extends Field implements RelatableField
{
use AssociatableRelation,
DeterminesIfCreateRelationCanBeShown,
FormatsRelatableDisplayValues,
ResolvesReverseRelation,
Searchable;
/**
* The field's component.
*
* @var string
*/
public $component = 'belongs-to-field';
/**
* The class name of the related resource.
*
* @var string
*/
public $resourceClass;
/**
* The URI key of the related resource.
*
* @var string
*/
public $resourceName;
/**
* The name of the Eloquent "belongs to" relationship.
*
* @var string
*/
public $belongsToRelationship;
/**
* The key of the related Eloquent model.
*
* @var string
*/
public $belongsToId;
/**
* The column that should be displayed for the field.
*
* @var \Closure
*/
public $display;
/**
* Indicates if the related resource can be viewed.
*
* @var bool
*/
public $viewable = true;
/**
* The callback that should be run when the field is filled.
*
* @var \Closure
*/
public $filledCallback;
/**
* The attribute that is the inverse of this relationship.
*
* @var string
*/
public $inverse;
/**
* The displayable singular label of the relation.
*
* @var string
*/
public $singularLabel;
/**
* Indicates whether the field should display the "With Trashed" option.
*
* @var bool
*/
public $displaysWithTrashed = true;
/**
* Create a new field.
*
* @param string $name
* @param string|null $attribute
* @param string|null $resource
* @return void
*/
public function __construct($name, $attribute = null, $resource = null)
{
parent::__construct($name, $attribute);
$resource = $resource ?? ResourceRelationshipGuesser::guessResource($name);
$this->resourceClass = $resource;
$this->resourceName = $resource::uriKey();
$this->belongsToRelationship = $this->attribute;
$this->singularLabel = $name;
}
/**
* Determine if the field should be displayed for the given request.
*
* @param \Illuminate\Http\Request $request
* @return bool
*/
public function authorize(Request $request)
{
return $this->isNotRedundant($request) && call_user_func(
[$this->resourceClass, 'authorizedToViewAny'], $request
) && parent::authorize($request);
}
/**
* Determine if the field is not redundant.
*
* Ex: Is this a "user" belongs to field in a blog post list being shown on the "user" detail page.
*
* @param \Illuminate\Http\Request $request
* @return bool
*/
public function isNotRedundant(Request $request)
{
return ! $request instanceof ResourceIndexRequest || ! $this->isReverseRelation($request);
}
/**
* Resolve the field's value.
*
* @param mixed $resource
* @param string|null $attribute
* @return void
*/
public function resolve($resource, $attribute = null)
{
$value = null;
if ($resource->relationLoaded($this->attribute)) {
$value = $resource->getRelation($this->attribute);
}
if (! $value) {
$value = $resource->{$this->attribute}()->withoutGlobalScopes()->getResults();
}
if ($value) {
$resource = new $this->resourceClass($value);
$this->belongsToId = Util::safeInt($value->getKey());
$this->value = $this->formatDisplayValue($resource);
$this->viewable = $this->viewable
&& $resource->authorizedToView(request());
}
}
/**
* Define the callback that should be used to resolve the field's value.
*
* @param callable $displayCallback
* @return $this
*/
public function displayUsing(callable $displayCallback)
{
return $this->display($displayCallback);
}
/**
* Get the validation rules for this field.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @return array
*/
public function getRules(NovaRequest $request)
{
$query = $this->buildAssociatableQuery(
$request, $request->{$this->attribute.'_trashed'} === 'true'
)->toBase();
return array_merge_recursive(parent::getRules($request), [
$this->attribute => array_filter([
$this->nullable ? 'nullable' : 'required',
new Relatable($request, $query),
]),
]);
}
/**
* Hydrate the given attribute on the model based on the incoming request.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @param object $model
* @return void
*/
public function fill(NovaRequest $request, $model)
{
$foreignKey = $this->getRelationForeignKeyName($model->{$this->attribute}());
parent::fillInto($request, $model, $foreignKey);
if ($model->isDirty($foreignKey)) {
$model->unsetRelation($this->attribute);
}
if ($this->filledCallback) {
call_user_func($this->filledCallback, $request, $model);
}
}
/**
* Hydrate the given attribute on the model based on the incoming request.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @param string $requestAttribute
* @param object $model
* @param string $attribute
* @return mixed
*/
protected function fillAttributeFromRequest(NovaRequest $request, $requestAttribute, $model, $attribute)
{
if ($request->exists($requestAttribute)) {
$value = $request[$requestAttribute];
$relation = Relation::noConstraints(function () use ($model) {
return $model->{$this->attribute}();
});
if ($this->isNullValue($value)) {
$relation->dissociate();
} else {
$relation->associate($relation->getQuery()->withoutGlobalScopes()->find($value));
}
}
}
/**
* Build an associatable query for the field.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @param bool $withTrashed
* @return \Laravel\Nova\Contracts\QueryBuilder
*/
public function buildAssociatableQuery(NovaRequest $request, $withTrashed = false)
{
$model = forward_static_call(
[$resourceClass = $this->resourceClass, 'newModel']
);
$query = app()->make(QueryBuilder::class, [$resourceClass]);
$request->first === 'true'
? $query->whereKey($model->newQueryWithoutScopes(), $request->current)
: $query->search(
$request, $model->newQuery(), $request->search,
[], [], TrashedStatus::fromBoolean($withTrashed)
);
return $query->tap(function ($query) use ($request, $model) {
forward_static_call($this->associatableQueryCallable($request, $model), $request, $query, $this);
});
}
/**
* Get the associatable query method name.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @param \Illuminate\Database\Eloquent\Model $model
* @return array
*/
protected function associatableQueryCallable(NovaRequest $request, $model)
{
return ($method = $this->associatableQueryMethod($request, $model))
? [$request->resource(), $method]
: [$this->resourceClass, 'relatableQuery'];
}
/**
* Get the associatable query method name.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @param \Illuminate\Database\Eloquent\Model $model
* @return string
*/
protected function associatableQueryMethod(NovaRequest $request, $model)
{
$method = 'relatable'.Str::plural(class_basename($model));
if (method_exists($request->resource(), $method)) {
return $method;
}
}
/**
* Format the given associatable resource.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @param mixed $resource
* @return array
*/
public function formatAssociatableResource(NovaRequest $request, $resource)
{
return array_filter([
'avatar' => $resource->resolveAvatarUrl($request),
'display' => $this->formatDisplayValue($resource),
'subtitle' => $resource->subtitle(),
'value' => Util::safeInt($resource->getKey()),
]);
}
/**
* Specify if the related resource can be viewed.
*
* @param bool $value
* @return $this
*/
public function viewable($value = true)
{
$this->viewable = $value;
return $this;
}
/**
* Specify a callback that should be run when the field is filled.
*
* @param \Closure $callback
* @return $this
*/
public function filled($callback)
{
$this->filledCallback = $callback;
return $this;
}
/**
* Set the attribute name of the inverse of the relationship.
*
* @param string $inverse
* @return $this
*/
public function inverse($inverse)
{
$this->inverse = $inverse;
return $this;
}
/**
* Set the displayable singular label of the resource.
*
* @return $this
*/
public function singularLabel($singularLabel)
{
$this->singularLabel = $singularLabel;
return $this;
}
/**
* hides the "With Trashed" option.
*
* @return $this
*/
public function withoutTrashed()
{
$this->displaysWithTrashed = false;
return $this;
}
/**
* Prepare the field for JSON serialization.
*
* @return array
*/
public function jsonSerialize()
{
return array_merge([
'belongsToId' => $this->belongsToId,
'belongsToRelationship' => $this->belongsToRelationship,
'debounce' => $this->debounce,
'displaysWithTrashed' => $this->displaysWithTrashed,
'label' => forward_static_call([$this->resourceClass, 'label']),
'resourceName' => $this->resourceName,
'reverse' => $this->isReverseRelation(app(NovaRequest::class)),
'searchable' => $this->searchable,
'withSubtitles' => $this->withSubtitles,
'showCreateRelationButton' => $this->createRelationShouldBeShown(app(NovaRequest::class)),
'singularLabel' => $this->singularLabel,
'viewable' => $this->viewable,
], parent::jsonSerialize());
}
}
Mini Shell