] * @since [v4.0] * @return \Illuminate\Http\Response */ public function index(Request $request) : array { $this->authorize('view', Category::class); $allowed_columns = [ 'id', 'name', 'category_type', 'category_type', 'use_default_eula', 'eula_text', 'require_acceptance', 'checkin_email', 'assets_count', 'accessories_count', 'consumables_count', 'components_count', 'licenses_count', 'image', ]; $categories = Category::select([ 'id', 'created_at', 'updated_at', 'name', 'category_type', 'use_default_eula', 'eula_text', 'require_acceptance', 'checkin_email', 'image' ])->withCount('accessories as accessories_count', 'consumables as consumables_count', 'components as components_count', 'licenses as licenses_count'); /* * This checks to see if we should override the Admin Setting to show archived assets in list. * We don't currently use it within the Snipe-IT GUI, but will be useful for API integrations where they * may actually need to fetch assets that are archived. * * @see \App\Models\Category::showableAssets() */ if ($request->input('archived')=='true') { $categories = $categories->withCount('assets as assets_count'); } else { $categories = $categories->withCount('showableAssets as assets_count'); } if ($request->filled('search')) { $categories = $categories->TextSearch($request->input('search')); } if ($request->filled('name')) { $categories->where('name', '=', $request->input('name')); } if ($request->filled('category_type')) { $categories->where('category_type', '=', $request->input('category_type')); } if ($request->filled('use_default_eula')) { $categories->where('use_default_eula', '=', $request->input('use_default_eula')); } if ($request->filled('require_acceptance')) { $categories->where('require_acceptance', '=', $request->input('require_acceptance')); } if ($request->filled('checkin_email')) { $categories->where('checkin_email', '=', $request->input('checkin_email')); } // Make sure the offset and limit are actually integers and do not exceed system limits $offset = ($request->input('offset') > $categories->count()) ? $categories->count() : app('api_offset_value'); $limit = app('api_limit_value'); $order = $request->input('order') === 'asc' ? 'asc' : 'desc'; $sort = in_array($request->input('sort'), $allowed_columns) ? $request->input('sort') : 'assets_count'; $categories->orderBy($sort, $order); $total = $categories->count(); $categories = $categories->skip($offset)->take($limit)->get(); return (new CategoriesTransformer)->transformCategories($categories, $total); } /** * Store a newly created resource in storage. * * @author [A. Gianotto] [] * @since [v4.0] * @param \App\Http\Requests\ImageUploadRequest $request * @return \Illuminate\Http\Response */ public function store(ImageUploadRequest $request) : JsonResponse { $this->authorize('create', Category::class); $category = new Category; $category->fill($request->all()); $category->category_type = strtolower($request->input('category_type')); $category = $request->handleImages($category); if ($category->save()) { return response()->json(Helper::formatStandardApiResponse('success', $category, trans('admin/categories/message.create.success'))); } return response()->json(Helper::formatStandardApiResponse('error', null, $category->getErrors())); } /** * Display the specified resource. * * @author [A. Gianotto] [] * @since [v4.0] * @param int $id */ public function show($id) : array { $this->authorize('view', Category::class); $category = Category::withCount('assets as assets_count', 'accessories as accessories_count', 'consumables as consumables_count', 'components as components_count', 'licenses as licenses_count')->findOrFail($id); return (new CategoriesTransformer)->transformCategory($category); } /** * Update the specified resource in storage. * * @author [A. Gianotto] [] * @since [v4.0] * @param \App\Http\Requests\ImageUploadRequest $request * @param int $id * @return \Illuminate\Http\Response */ public function update(ImageUploadRequest $request, $id) : JsonResponse { $this->authorize('update', Category::class); $category = Category::findOrFail($id); // Don't allow the user to change the category_type once it's been created if (($request->filled('category_type')) && ($category->category_type != $request->input('category_type'))) { return response()->json( Helper::formatStandardApiResponse('error', null, ['category_type' => trans('admin/categories/message.update.cannot_change_category_type')], 422) ); } $category->fill($request->all()); $category = $request->handleImages($category); if ($category->save()) { return response()->json(Helper::formatStandardApiResponse('success', $category, trans('admin/categories/message.update.success'))); } return response()->json(Helper::formatStandardApiResponse('error', null, $category->getErrors())); } /** * Remove the specified resource from storage. * * @author [A. Gianotto] [] * @since [v4.0] * @param int $id * @return \Illuminate\Http\Response */ public function destroy($id) : JsonResponse { $this->authorize('delete', Category::class); $category = Category::withCount('assets as assets_count', 'accessories as accessories_count', 'consumables as consumables_count', 'components as components_count', 'licenses as licenses_count')->findOrFail($id); if (! $category->isDeletable()) { return response()->json( Helper::formatStandardApiResponse('error', null, trans('admin/categories/message.assoc_items', ['asset_type'=>$category->category_type])) ); } $category->delete(); return response()->json(Helper::formatStandardApiResponse('success', null, trans('admin/categories/message.delete.success'))); } /** * Gets a paginated collection for the select2 menus * * @author [A. Gianotto] [] * @since [v4.0.16] * @see \App\Http\Transformers\SelectlistTransformer */ public function selectlist(Request $request, $category_type = 'asset') : array { $this->authorize('view.selectlists'); $categories = Category::select([ 'id', 'name', 'image', ]); if ($request->filled('search')) { $categories = $categories->where('name', 'LIKE', '%'.$request->get('search').'%'); } $categories = $categories->where('category_type', $category_type)->orderBy('name', 'ASC')->paginate(50); // Loop through and set some custom properties for the transformer to use. // This lets us have more flexibility in special cases like assets, where // they may not have a ->name value but we want to display something anyway foreach ($categories as $category) { $category->use_image = ($category->image) ? Storage::disk('public')->url('categories/'.$category->image, $category->image) : null; } return (new SelectlistTransformer)->transformSelectlist($categories); } }