Current File : //home/forge/api-takeaseat.eco-n-tech.co.uk/vendor/laravel/nova/src/Resource.php
<?php
namespace Laravel\Nova;
use ArrayAccess;
use Illuminate\Contracts\Routing\UrlRoutable;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\ConditionallyLoadsAttributes;
use Illuminate\Http\Resources\DelegatesToResource;
use Illuminate\Support\Collection;
use Illuminate\Support\Str;
use JsonSerializable;
use Laravel\Nova\Fields\ID;
use Laravel\Nova\Http\Requests\NovaRequest;
use Laravel\Scout\Searchable;
abstract class Resource implements ArrayAccess, JsonSerializable, UrlRoutable
{
use Authorizable,
ConditionallyLoadsAttributes,
DelegatesToResource,
FillsFields,
PerformsValidation,
PerformsQueries,
ResolvesActions,
ResolvesFields,
ResolvesFilters,
ResolvesLenses,
ResolvesCards;
/**
* The default displayable pivot class name.
*
* @var string
*/
const DEFAULT_PIVOT_NAME = 'Pivot';
/**
* The visual style used for the table. Available options are 'tight' and 'default'.
*
* @var string
*/
public static $tableStyle = 'default';
/**
* Whether to show borders for each column on the X-axis.
*
* @var bool
*/
public static $showColumnBorders = false;
/**
* The underlying model resource instance.
*
* @var \Illuminate\Database\Eloquent\Model|null
*/
public $resource;
/**
* The logical group associated with the resource.
*
* @var string
*/
public static $group = 'Other';
/**
* The single value that should be used to represent the resource when being displayed.
*
* @var string
*/
public static $title = 'id';
/**
* The relationships that should be eager loaded when performing an index query.
*
* @var array
*/
public static $with = [];
/**
* The columns that should be searched.
*
* @var array
*/
public static $search = [];
/**
* Indicates if the resource should be displayed in the sidebar.
*
* @var bool
*/
public static $displayInNavigation = true;
/**
* Indicates if the resource should be globally searchable.
*
* @var bool
*/
public static $globallySearchable = true;
/**
* The number of results to display in the global search.
*
* @var int
*/
public static $globalSearchResults = 5;
/**
* The number of results to display when searching relatable resource without Scout.
*
* @var int|null
*/
public static $relatableSearchResults = null;
/**
* The number of results to display when searching the resource using Scout.
*
* @var int
*/
public static $scoutSearchResults = 200;
/**
* Where should the global search link to?
*
* @var string
*/
public static $globalSearchLink = 'detail';
/**
* Indicates if the resource should be searchable on the index view.
*
* @var bool
*/
public static $searchable = true;
/**
* The per-page options used the resource index.
*
* @var array
*/
public static $perPageOptions = [25, 50, 100];
/**
* The number of resources to show per page via relationships.
*
* @var int
*/
public static $perPageViaRelationship = 5;
/**
* The cached soft deleting statuses for various resources.
*
* @var array
*/
public static $softDeletes = [];
/**
* Indicates whether Nova should check for modifications between viewing and updating a resource.
*
* @var bool
*/
public static $trafficCop = true;
/**
* Indicates whether Nova should prevent the user from leaving an unsaved form, losing their data.
*
* @var bool
*/
public static $preventFormAbandonment = false;
/**
* The maximum value of the resource's primary key column.
*
* @var int
*/
public static $maxPrimaryKeySize = PHP_INT_MAX;
/**
* Indicates whether the resource should automatically poll for new resources.
*
* @var bool
*/
public static $polling = false;
/**
* The interval at which Nova should poll for new resources.
*
* @var int
*/
public static $pollingInterval = 15;
/**
* Indicates whether to show the polling toggle button inside Nova.
*
* @var bool
*/
public static $showPollingToggle = false;
/**
* The debounce amount to use when searching this resource.
*
* @var float
*/
public static $debounce = 0.5;
/**
* Create a new resource instance.
*
* @param \Illuminate\Database\Eloquent\Model|null $resource
* @return void
*/
public function __construct($resource)
{
$this->resource = $resource;
}
/**
* Get the fields displayed by the resource.
*
* @param \Illuminate\Http\Request $request
* @return array
*/
abstract public function fields(Request $request);
/**
* Get the underlying model instance for the resource.
*
* @return \Illuminate\Database\Eloquent\Model
*/
public function model()
{
return $this->resource;
}
/**
* Get the logical group associated with the resource.
*
* @return string
*/
public static function group()
{
return static::$group;
}
/**
* Determine if this resource is available for navigation.
*
* @param \Illuminate\Http\Request $request
* @return bool
*/
public static function availableForNavigation(Request $request)
{
return static::$displayInNavigation;
}
/**
* Determine if this resource uses soft deletes.
*
* @return bool
*/
public static function softDeletes()
{
if (isset(static::$softDeletes[static::$model])) {
return static::$softDeletes[static::$model];
}
return static::$softDeletes[static::$model] = in_array(
SoftDeletes::class, class_uses_recursive(static::newModel())
);
}
/**
* Determine if this resource is searchable.
*
* @return bool
*/
public static function searchable()
{
return (static::$searchable && ! empty(static::searchableColumns())) || (static::$searchable && static::usesScout());
}
/**
* Determine whether the global search links will take the user to the detail page.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
*
* @return string
*/
public function globalSearchLink(NovaRequest $request)
{
return static::$globalSearchLink;
}
/**
* Determine if this resource uses Laravel Scout.
*
* @return bool
*/
public static function usesScout()
{
return in_array(Searchable::class, class_uses_recursive(static::newModel()));
}
/**
* Get the searchable columns for the resource.
*
* @return array
*/
public static function searchableColumns()
{
return empty(static::$search)
? [static::newModel()->getKeyName()]
: static::$search;
}
/**
* Get the displayable label of the resource.
*
* @return string
*/
public static function label()
{
return Str::plural(Str::title(Str::snake(class_basename(get_called_class()), ' ')));
}
/**
* Get the displayable singular label of the resource.
*
* @return string
*/
public static function singularLabel()
{
return Str::singular(static::label());
}
/**
* Prepare search column value.
*
* @param string $column
* @param string $search
* @return string
*/
protected static function searchableKeyword($column, $search)
{
return '%'.$search.'%';
}
/**
* Get the value that should be displayed to represent the resource.
*
* @return string
*/
public function title()
{
return (string) data_get($this, static::$title);
}
/**
* Get the search result subtitle for the resource.
*
* @return string|null
*/
public function subtitle()
{
//
}
/**
* Get the text for the create resource button.
*
* @return string|null
*/
public static function createButtonLabel()
{
return __('Create :resource', ['resource' => static::singularLabel()]);
}
/**
* Get the text for the update resource button.
*
* @return string|null
*/
public static function updateButtonLabel()
{
return __('Update :resource', ['resource' => static::singularLabel()]);
}
/**
* Get a fresh instance of the model represented by the resource.
*
* @return mixed
*/
public static function newModel()
{
$model = static::$model;
return new $model;
}
/**
* Get the URI key for the resource.
*
* @return string
*/
public static function uriKey()
{
return Str::plural(Str::kebab(class_basename(get_called_class())));
}
/**
* Get meta information about this resource for client side comsumption.
*
* @param \Illuminate\Http\Request $request
* @return array
*/
public static function additionalInformation(Request $request)
{
return [];
}
/**
* The pagination per-page options configured for this resource.
*
* @return array
*/
public static function perPageOptions()
{
return static::$perPageOptions;
}
/**
* Indicates whether Nova should check for modifications between viewing and updating a resource.
*
* @param \Illuminate\Http\Request $request
* @return bool
*/
public static function trafficCop(Request $request)
{
return static::$trafficCop;
}
/**
* Indicates whether Nova should prevent the user from leaving an unsaved form, losing their data.
*
* @param \Illuminate\Http\Request $request
* @return bool
*/
public static function preventFormAbandonment(Request $request)
{
return static::$preventFormAbandonment;
}
/**
* Prepare the resource for JSON serialization.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @param \Illuminate\Support\Collection $fields
* @return array
*/
public function serializeForIndex(NovaRequest $request, $fields = null)
{
return array_merge($this->serializeWithId($fields ?: $this->indexFields($request)), [
'title' => static::title(),
'actions' => $this->availableActions($request),
'authorizedToView' => $this->authorizedToView($request),
'authorizedToCreate' => $this->authorizedToCreate($request),
'authorizedToUpdate' => $this->authorizedToUpdateForSerialization($request),
'authorizedToDelete' => $this->authorizedToDeleteForSerialization($request),
'authorizedToRestore' => static::softDeletes() && $this->authorizedToRestore($request),
'authorizedToForceDelete' => static::softDeletes() && $this->authorizedToForceDelete($request),
'softDeletes' => static::softDeletes(),
'softDeleted' => $this->isSoftDeleted(),
]);
}
/**
* Prepare the resource for JSON serialization.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @param \Laravel\Nova\Resource $resource
* @return array
*/
public function serializeForDetail(NovaRequest $request, Resource $resource)
{
return array_merge($this->serializeWithId($this->detailFieldsWithinPanels($request, $resource)), [
'title' => static::title(),
'authorizedToCreate' => $this->authorizedToCreate($request),
'authorizedToUpdate' => $this->authorizedToUpdate($request),
'authorizedToDelete' => $this->authorizedToDelete($request),
'authorizedToRestore' => static::softDeletes() && $this->authorizedToRestore($request),
'authorizedToForceDelete' => static::softDeletes() && $this->authorizedToForceDelete($request),
'softDeletes' => static::softDeletes(),
'softDeleted' => $this->isSoftDeleted(),
]);
}
/**
* Determine if the resource may be updated, factoring in attachments.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @return bool
*/
protected function authorizedToUpdateForSerialization(NovaRequest $request)
{
if ($request->viaManyToMany()) {
return $request->findParentResourceOrFail()->authorizedToAttach(
$request, $this->model()
);
}
return $this->authorizedToUpdate($request);
}
/**
* Determine if the resource may be deleted, factoring in detachments.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @return bool
*/
protected function authorizedToDeleteForSerialization(NovaRequest $request)
{
if ($request->viaManyToMany()) {
return $request->findParentResourceOrFail()->authorizedToDetach(
$request, $this->model(), $request->viaRelationship
);
}
return $this->authorizedToDelete($request);
}
/**
* Determine if the resource is soft deleted.
*
* @return bool
*/
public function isSoftDeleted()
{
return static::softDeletes() && $this->resource->trashed();
}
/**
* Prepare the resource for JSON serialization.
*
* @return array
*/
public function jsonSerialize()
{
return $this->serializeWithId($this->resolveFields(
resolve(NovaRequest::class)
));
}
/**
* Prepare the resource for JSON serialization using the given fields.
*
* @param \Illuminate\Support\Collection $fields
* @return array
*/
protected function serializeWithId(Collection $fields)
{
return [
'id' => $fields->whereInstanceOf(ID::class)->first() ?: ID::forModel($this->resource),
'fields' => $fields->all(),
];
}
/**
* Return the location to redirect the user after creation.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @param \Laravel\Nova\Resource $resource
* @return string
*/
public static function redirectAfterCreate(NovaRequest $request, $resource)
{
return '/resources/'.static::uriKey().'/'.$resource->getKey();
}
/**
* Return the location to redirect the user after update.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @param \Laravel\Nova\Resource $resource
* @return string
*/
public static function redirectAfterUpdate(NovaRequest $request, $resource)
{
return '/resources/'.static::uriKey().'/'.$resource->getKey();
}
/**
* Return the location to redirect the user after deletion.
*
* @param \Laravel\Nova\Http\Requests\NovaRequest $request
* @return string|null
*/
public static function redirectAfterDelete(NovaRequest $request)
{
return null;
}
/**
* Return the maximum primary key size for the Resource.
*
* @return int
*/
public static function maxPrimaryKeySize()
{
return static::$maxPrimaryKeySize;
}
/**
* Return a fresh resource instance.
*
* @return \Laravel\Nova\Resource
*/
protected static function newResource()
{
return new static(static::newModel());
}
/**
* Determine whether to show borders for each column on the X-axis.
*
* @return string
*/
public static function showColumnBorders()
{
return static::$showColumnBorders;
}
/**
* Get the visual style that should be used for the table.
*
* @return string
*/
public static function tableStyle()
{
return static::$tableStyle;
}
}
Mini Shell