Files
parsaaghayi-backend/app/Http/Controllers/Api/Website/AboutMeController.php
DevOps 7ee8440a65
Deploy Backend / deploy (push) Waiting to run
Expose About Me translations and project categories for the admin panel
About-me writes could only set the image: title and description live in the
JSON translations column and were unreachable from the API, so the homepage
bio could never be edited. Accept title_fa/title_en/description_fa/
description_en on both About Me form requests and write them through
setTranslation() for each locale.

Adds a read-only GET /api/website/project-categories endpoint backed by the
existing (previously unreachable) ProjectCategory model, so project forms can
offer a category picker.
2026-10-01 19:24:00 +00:00

153 lines
4.9 KiB
PHP

<?php
namespace App\Http\Controllers\Api\Website;
use App\Http\Controllers\Controller;
use App\Http\Requests\Website\StoreAboutMeRequest;
use App\Http\Requests\Website\UpdateAboutMeRequest;
use App\Models\Website\AboutMe;
/**
* @OA\Tag(name="About Me", description="About Me section endpoints")
*/
class AboutMeController extends Controller
{
/**
* @OA\Get(
* path="/website/about-me",
* tags={"About Me"},
* summary="Get the first About Me entry with skills",
* @OA\Response(response=200, description="OK", @OA\JsonContent(ref="#/components/schemas/AboutMe"))
* )
*/
public function index()
{
$aboutMe = AboutMe::with('skills')->first();
return response()->json($aboutMe);
}
/**
* @OA\Get(
* path="/website/about-me/{id}",
* tags={"About Me"},
* summary="Get a specific About Me entry",
* @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer")),
* @OA\Response(response=200, description="OK")
* )
*/
public function show($id)
{
$aboutMe = AboutMe::with('skills')->findOrFail($id);
return response()->json($aboutMe);
}
/**
* @OA\Post(
* path="/website/about-me",
* tags={"About Me"},
* summary="Create an About Me entry",
* @OA\RequestBody(@OA\MediaType(mediaType="application/json")),
* @OA\Response(response=201, description="Created")
* )
*/
public function store(StoreAboutMeRequest $request)
{
$aboutMe = AboutMe::create(['image' => $request->input('image')]);
$this->applyTranslations($aboutMe, $request);
return response()->json($aboutMe, 201);
}
/**
* @OA\Put(
* path="/website/about-me/{id}",
* tags={"About Me"},
* summary="Update an About Me entry",
* @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer")),
* @OA\RequestBody(@OA\MediaType(mediaType="application/json")),
* @OA\Response(response=200, description="OK")
* )
*/
public function update(UpdateAboutMeRequest $request, $id)
{
$aboutMe = AboutMe::findOrFail($id);
if ($request->has('image')) {
$aboutMe->image = $request->input('image');
}
$this->applyTranslations($aboutMe, $request);
$aboutMe->save();
return response()->json($aboutMe);
}
private function applyTranslations(AboutMe $aboutMe, $request): void
{
foreach (['fa', 'en'] as $locale) {
foreach (['title', 'description'] as $key) {
$field = $key.'_'.$locale;
if ($request->has($field)) {
$aboutMe->setTranslation($key, $locale, $request->input($field));
}
}
}
}
/**
* @OA\Delete(
* path="/website/about-me/{id}",
* tags={"About Me"},
* summary="Delete an About Me entry",
* @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer")),
* @OA\Response(response=204, description="No Content")
* )
*/
public function destroy($id)
{
AboutMe::destroy($id);
return response()->json(null, 204);
}
/**
* @OA\Get(
* path="/website/about-me/{id}/translation/{locale}",
* tags={"About Me"},
* summary="Get localized About Me with skills",
* @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer")),
* @OA\Parameter(name="locale", in="path", required=true, @OA\Schema(type="string", enum={"fa","en"})),
* @OA\Response(response=200, description="OK", @OA\JsonContent(ref="#/components/schemas/AboutMe")),
* @OA\Response(response=404, description="Translation not found")
* )
*/
public function getTranslation($id, $locale)
{
$aboutMe = AboutMe::with('skills')->findOrFail($id);
if (!$aboutMe->hasTranslation('title', $locale)) {
return response()->json(['message' => 'Translation not found', 'locale' => $locale], 404);
}
$skills = $aboutMe->skills->map(function ($skill) use ($locale) {
return [
'id' => $skill->id,
'title' => $skill->getTranslation('title', $locale),
'description' => $skill->getTranslation('description', $locale),
'image' => $skill->image,
'link' => $skill->link,
'percentage' => $skill->percentage,
];
});
$data = [
'id' => $aboutMe->id,
'title' => $aboutMe->getTranslation('title', $locale),
'description' => $aboutMe->getTranslation('description', $locale),
'image' => $aboutMe->image,
'skills' => $skills,
];
return response()->json($data);
}
}