Refactor table structure in admin documentation versions view

- Consolidate category and documentation sections under a single table. - Adjust layout for clarity and consistency.
Add breadcrumbs to admin documentation categories views
2026-07-25 02:09:15 +05:00 · 2026-07-25 01:25:49 +05:00 · 2026-07-25 01:25:31 +05:00 · 2026-07-25 01:25:18 +05:00 · 2026-07-25 01:23:09 +05:00 · 2026-07-25 01:22:26 +05:00
32 changed files with 373 additions and 21 deletions
@@ -11,6 +11,9 @@ use App\Services\Search\CreateSearchInstanceCommand;
 use App\Dto\Builder\DocumentationCategory as DocumentationCategoryBuilderDto;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Relations\HasOne;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Str;

 final readonly class DocumentationCategoryRepository
@@ -93,4 +96,52 @@ final readonly class DocumentationCategoryRepository
            ->pluck('title', 'id')
            ->toArray();
    }
+
+    public function getPathFromRoot(int $categoryId, ?ProjectLanguage $projectLanguage): Collection
+    {
+        $seconds = 3600;
+        return Cache::remember(self::class . $categoryId . '_' . $projectLanguage->id ?? 0, $seconds, function () use ($categoryId, $projectLanguage) {
+            $rows = DB::select(
+                <<<SQL
+                    WITH RECURSIVE chain AS (
+                        SELECT id, parent_id, 0 AS depth
+                        FROM documentation_categories
+                        WHERE id = ?
+
+                        UNION ALL
+
+                        SELECT dc.id, dc.parent_id, chain.depth + 1 AS depth
+                        FROM documentation_categories dc
+                        INNER JOIN chain ON chain.parent_id = dc.id
+                    )
+                    SELECT id, depth
+                    FROM chain
+                    ORDER BY depth DESC
+                SQL,
+                [$categoryId]
+            );
+
+            $idsInOrder = collect($rows)->pluck('id')->all();
+
+            $with = [
+                'content' => function (HasOne $hasOne) use ($projectLanguage) {
+                    /** @var ?ProjectLanguage $projectLanguage */
+                    $hasOne->when($projectLanguage, function (Builder $query, ProjectLanguage $projectLanguage) {
+                        $query->where('language_id', $projectLanguage->id);
+                    });
+                }
+            ];
+
+            $categories = DocumentationCategory::query()
+                ->whereIn('id', $idsInOrder)
+                ->with($with)
+                ->get()
+                ->keyBy('id');
+
+            return collect($idsInOrder)
+                ->map(fn (int $id) => $categories->get($id))
+                ->filter()
+                ->values();
+        });
+    }
 }
@@ -20,6 +20,7 @@ use App\ServiceResults\ServiceResultArray;
 use App\ServiceResults\ServiceResultError;
 use App\ServiceResults\ServiceResultSuccess;
 use App\ServiceResults\StoreUpdateResult;
+use App\Services\ClearCacheCommandHandler;
 use App\Services\DocumentationCategory\DocumentationCategoryCommandHandler;
 use App\Services\DocumentationCategoryContent\ModelSyncCommand;
 use App\Services\Service;
@@ -34,6 +35,7 @@ final class DocumentationCategoryService extends Service
        private readonly DocumentationCategoryRepository     $documentationCategoryRepository,
        private readonly DocumentationCategoryCommandHandler $categoryCommandHandler,
        private readonly ModelSyncCommand                    $contentSaveCommand,
+        private readonly ClearCacheCommandHandler            $clearCacheCommandHandler,
    ) { }

    public function index(int $projectId, int $versionId, DocumentationCategoryBuilderDto $documentationCategoryBuilderDto, QuerySettingsDto $querySettingsDto, User $user): ServiceResultError | ServiceResultArray
@@ -89,8 +91,10 @@ final class DocumentationCategoryService extends Service

        $defaultLanguage = $project->languages->where('is_default', 1)->first();
        $category = new DocumentationCategory();
+        $categoryPath = null;
        if ($parentId !== null) {
            $category->parent_id = $parentId;
+            $categoryPath = $this->documentationCategoryRepository->getPathFromRoot($parentId, $defaultLanguage);
        }

        return $this->result([
@@ -99,6 +103,7 @@ final class DocumentationCategoryService extends Service
            'category' => $category,
            'categories' => $this->documentationCategoryRepository->getForSelect($version, $defaultLanguage),
            'serviceTranslationEnable' => config('translation_service.enable', false),
+            'categoryPath' => $categoryPath,
        ]);
    }

@@ -119,17 +124,20 @@ final class DocumentationCategoryService extends Service
            return $this->errFobidden(__('Access is denied'));
        }

+        $defaultLanguage = $project->languages->where('is_default', 1)->first();
        $withCategories = [];
+        $categoryPath = null;
        if ($category->parent_id) {
            $withCategories[] = $category->parent_id;
+            $categoryPath = $this->documentationCategoryRepository->getPathFromRoot($category->parent_id, $defaultLanguage);
        }
-        $defaultLanguage = $project->languages->where('is_default', 1)->first();
        return $this->result([
            'version'  => $version,
            'project'  => $project,
            'category' => $category,
            'categories' => $this->documentationCategoryRepository->getForSelect($version, $defaultLanguage, $category, $withCategories),
            'serviceTranslationEnable' => config('translation_service.enable', false),
+            'categoryPath' => $categoryPath,
        ]);
    }

@@ -165,6 +173,8 @@ final class DocumentationCategoryService extends Service
            if (\config('translation_service.enable', false)) {
                $this->translateContent($category, $data->getContents());
            }
+
+            $this->clearCacheCommandHandler->all();
        } catch (ServiceException $e) {
            return $e->getServiceResultError();
        } catch (\Throwable $e) {
@@ -219,6 +229,8 @@ final class DocumentationCategoryService extends Service
            if (\config('translation_service.enable', false)) {
                $this->translateContent($category, $data->getContents());
            }
+
+            $this->clearCacheCommandHandler->all();
        } catch (ServiceException $e) {
            return $e->getServiceResultError();
        } catch (ParentException $e) {
@@ -255,6 +267,8 @@ final class DocumentationCategoryService extends Service
            DB::transaction(function () use ($category) {
                $this->categoryCommandHandler->handleDestroy($category);
            });
+
+            $this->clearCacheCommandHandler->all();
        } catch (\Throwable $e) {
            report($e);
            return $this->errService(__('Server Error'));
@@ -87,18 +87,21 @@ final class DocumentationService extends Service
            return $this->errFobidden(__('Access is denied'));
        }

+        $defaultLanguage = $project->languages->where('is_default', 1)->first();
        $documentation = new Documentation();
+        $categoryPath = null;
        if ($categoryId !== null) {
            $documentation->category_id = $categoryId;
+            $categoryPath = $this->documentationCategoryRepository->getPathFromRoot($categoryId, $defaultLanguage);
        }

-        $defaultLanguage = $project->languages->where('is_default', 1)->first();
        return $this->result([
            'version' => $version,
            'project' => $project,
            'documentation' => $documentation,
            'categories' => $this->documentationCategoryRepository->getForSelect($version, $defaultLanguage),
            'serviceTranslationEnable' => config('translation_service.enable', false),
+            'categoryPath' => $categoryPath,
        ]);
    }

@@ -119,17 +122,20 @@ final class DocumentationService extends Service
            return $this->errFobidden(__('Access is denied'));
        }

+        $defaultLanguage = $project->languages->where('is_default', 1)->first();
        $withCategories = [];
+        $categoryPath = null;
        if ($documentation->category_id) {
            $withCategories[] = $documentation->category_id;
+            $categoryPath = $this->documentationCategoryRepository->getPathFromRoot($documentation->category_id, $defaultLanguage);
        }
-        $defaultLanguage = $project->languages->where('is_default', 1)->first();
        return $this->result([
            'version' => $version,
            'project' => $project,
            'documentation' => $documentation,
            'categories' => $this->documentationCategoryRepository->getForSelect($version, $defaultLanguage, null, $withCategories),
            'serviceTranslationEnable' => config('translation_service.enable', false),
+            'categoryPath' => $categoryPath,
        ]);
    }

@@ -80,7 +80,10 @@ final class DocumentationVersionService extends Service
            return $this->errFobidden(__('Access is denied'));
        }

+        $defaultLanguage = $project->languages()->where('is_default', 1)->first();
+
        $category = null;
+        $categoryPath = null;
        if (!\is_null($categoryId)) {
            $category = $this->documentationCategoryRepository->getCategoryById($categoryId);
            if (\is_null($category) || $category->version_id !== $version->id) {
@@ -89,9 +92,9 @@ final class DocumentationVersionService extends Service
            if ($user->cannot('view', $category)) {
                return $this->errFobidden(__('Access is denied'));
            }
+            $categoryPath = $this->documentationCategoryRepository->getPathFromRoot($category->id, $defaultLanguage);
        }

-        $defaultLanguage = $project->languages()->where('is_default', 1)->first();
        $with = [
            'content' => function (HasOne $hasOne) use ($defaultLanguage) {
                /** @var ?ProjectLanguage $defaultLanguage */
@@ -120,6 +123,7 @@ final class DocumentationVersionService extends Service
            'project'  => $project,

            'category'       => $category,
+            'categoryPath'   => $categoryPath,
            'categories'     => $categories,
            'documentations' => $documents,
        ]);
@@ -6,6 +6,7 @@ Breadcrumbs::for('admin.home', function ($trail) {
    $trail->push(__('Home'), route('admin.home'), ['icon' => '<svg class="icon icon-xxs" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-6 0a1 1 0 001-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 001 1m-6 0h6"></path></svg>']);
 });

+// Roles
 Breadcrumbs::for('admin.roles.index', function ($trail) {
    $trail->parent('admin.home');

@@ -23,5 +24,239 @@ Breadcrumbs::for('admin.roles.edit', function ($trail, \App\Models\Role $role) {

    $trail->push(__('Edit'), route('admin.roles.edit', $role));
 });
+// End Roles

+// Users
+Breadcrumbs::for('admin.users.index', function ($trail) {
+    $trail->parent('admin.home');

+    $trail->push(__('admin-sections.Users'), route('admin.users.index'));
+});
+
+Breadcrumbs::for('admin.users.create', function ($trail) {
+    $trail->parent('admin.users.index');
+
+    $trail->push(__('Create'), route('admin.users.create'));
+});
+
+Breadcrumbs::for('admin.users.edit', function ($trail, \App\Models\User $user) {
+    $trail->parent('admin.users.index');
+
+    $trail->push(__('Edit'), route('admin.users.edit', $user));
+});
+// End Users
+
+Breadcrumbs::for('admin.feedbacks.index', function ($trail) {
+    $trail->parent('admin.home');
+
+    $trail->push(__('admin-sections.Feedback'), route('admin.feedbacks.index'));
+});
+
+// Projects
+Breadcrumbs::for('admin.projects.index', function ($trail) {
+    $trail->parent('admin.home');
+
+    $trail->push(__('admin-sections.Projects'), route('admin.projects.index'));
+});
+
+Breadcrumbs::for('admin.projects.create', function ($trail) {
+    $trail->parent('admin.projects.index');
+
+    $trail->push(__('Create'), route('admin.projects.create'));
+});
+
+Breadcrumbs::for('admin.projects.edit', function ($trail, \App\Models\Project $project) {
+    $trail->parent('admin.projects.index');
+
+    $trail->push(__('Edit'), route('admin.projects.edit', $project));
+});
+
+Breadcrumbs::for('admin.projects.show', function ($trail, \App\Models\Project $project) {
+    $trail->parent('admin.projects.index');
+
+    $trail->push($project->name, route('admin.projects.show', $project));
+});
+
+Breadcrumbs::for('admin.projects.feedbacks.index', function ($trail, \App\Models\Project $project) {
+    $trail->parent('admin.projects.show', $project);
+
+    $trail->push(__('admin-sections.Feedback'), route('admin.projects.feedbacks.index', $project));
+});
+// End Projects
+
+// Projects translations
+Breadcrumbs::for('admin.projects.translations.languages', function ($trail, \App\Models\Project $project) {
+    $trail->parent('admin.projects.show', $project);
+
+    $trail->push(__('admin-sections.Translations'), route('admin.projects.translations.languages', $project));
+});
+
+Breadcrumbs::for('admin.projects.translations.edit', function ($trail, \App\Models\Project $project, \App\Models\ProjectLanguage $language) {
+    $trail->parent('admin.projects.translations.languages', $project);
+
+    $trail->push($language->title, route('admin.projects.translations.edit', ['project' => $project->id, 'language' => $language->id]));
+});
+
+Breadcrumbs::for('admin.projects.service-translate.view', function ($trail, \App\Models\Project $project) {
+    $trail->parent('admin.projects.show', $project);
+
+    $trail->push(__('admin-sections.Setting up automatic translation'), route('admin.projects.service-translate.view', $project));
+});
+// End Projects translations
+
+// Projects links
+Breadcrumbs::for('admin.projects.links.index', function ($trail, \App\Models\Project $project) {
+    $trail->parent('admin.projects.show', $project);
+
+    $trail->push(__('admin-sections.Links project'), route('admin.projects.links.index', $project));
+});
+
+Breadcrumbs::for('admin.projects.links.create', function ($trail, \App\Models\Project $project) {
+    $trail->parent('admin.projects.links.index', $project);
+
+    $trail->push(__('Create'), route('admin.projects.links.create', $project));
+});
+
+Breadcrumbs::for('admin.projects.links.edit', function ($trail, \App\Models\Project $project, \App\Models\ProjectLink $link) {
+    $trail->parent('admin.projects.links.index', $project);
+
+    $trail->push(__('Edit'), route('admin.projects.links.edit', ['project' => $project->id, 'link' => $link->id]));
+});
+// End Projects links
+
+// Projects about
+Breadcrumbs::for('admin.projects.about.languages', function ($trail, \App\Models\Project $project) {
+    $trail->parent('admin.projects.show', $project);
+
+    $trail->push(__('admin-sections.About project'), route('admin.projects.about.languages', $project));
+});
+
+Breadcrumbs::for('admin.projects.about.edit', function ($trail, \App\Models\Project $project, \App\Models\ProjectLanguage $language) {
+    $trail->parent('admin.projects.about.languages', $project);
+
+    $trail->push($language->title, route('admin.projects.about.edit', ['project' => $project->id, 'language' => $language->id]));
+});
+// End Projects about
+
+// Projects documentation-versions
+Breadcrumbs::for('admin.projects.documentation-versions.index', function ($trail, \App\Models\Project $project) {
+    $trail->parent('admin.projects.show', $project);
+
+    $trail->push(__('admin-sections.Documentation version'), route('admin.projects.documentation-versions.index', $project));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.create', function ($trail, \App\Models\Project $project) {
+    $trail->parent('admin.projects.documentation-versions.index', $project);
+
+    $trail->push(__('Create'), route('admin.projects.documentation-versions.create', $project));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.edit', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version) {
+    $trail->parent('admin.projects.documentation-versions.index', $project);
+
+    $trail->push(__('Edit'), route('admin.projects.documentation-versions.edit', ['project' => $project->id, 'documentation_version' => $version->id]));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.show', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version) {
+    $trail->parent('admin.projects.documentation-versions.index', $project);
+
+    $trail->push($version->title, route('admin.projects.documentation-versions.show', ['project' => $project->id, 'documentation_version' => $version->id]));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.category-path', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version, \Illuminate\Support\Collection $categoryPath) {
+    $trail->parent('admin.projects.documentation-versions.show', $project, $version);
+
+    foreach ($categoryPath as $pathItem) {
+        $trail->push(
+            $pathItem->content->title,
+            route('admin.projects.documentation-versions.category.show', [
+                'project' => $project->id,
+                'version' => $version->id,
+                'category' => $pathItem->id,
+            ])
+        );
+    }
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.show.category', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version, \App\Models\DocumentationCategory $category, ?\Illuminate\Support\Collection $categoryPath) {
+    $path = $categoryPath ?? collect([$category]);
+
+    $trail->parent('admin.projects.documentation-versions.category-path', $project, $version, $path);
+});
+// End Projects documentation-versions
+
+// Projects documentation-versions documentations
+Breadcrumbs::for('admin.projects.documentation-versions.documentations.index', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version) {
+    $trail->parent('admin.projects.documentation-versions.show', $project, $version);
+
+    $trail->push(__('admin-sections.Documentation'), route('admin.projects.documentation-versions.documentations.index', ['project' => $project->id, 'version' => $version->id]));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.documentations.create', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version) {
+    $trail->parent('admin.projects.documentation-versions.documentations.index', $project, $version);
+
+    $trail->push(__('Create'), route('admin.projects.documentation-versions.documentations.create', ['project' => $project->id, 'version' => $version->id]));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.category-path.documentations', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version, \Illuminate\Support\Collection $categoryPath) {
+    $trail->parent('admin.projects.documentation-versions.category-path', $project, $version, $categoryPath);
+
+    $trail->push(__('admin-sections.Documentation'), route('admin.projects.documentation-versions.documentations.index', ['project' => $project->id, 'version' => $version->id]));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.category-path.documentations.create', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version, \Illuminate\Support\Collection $categoryPath) {
+    $trail->parent('admin.projects.documentation-versions.category-path.documentations', $project, $version, $categoryPath);
+
+    $trail->push(__('Create'), route('admin.projects.documentation-versions.documentations.create', ['project' => $project->id, 'version' => $version->id]));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.documentations.edit', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version, \App\Models\Documentation $documentation) {
+    $trail->parent('admin.projects.documentation-versions.documentations.index', $project, $version);
+
+    $trail->push(__('Edit'), route('admin.projects.documentation-versions.documentations.edit', ['project' => $project->id, 'version' => $version->id, 'documentation' => $documentation->id]));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.category-path.documentations.edit', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version, \App\Models\Documentation $documentation, \Illuminate\Support\Collection $categoryPath) {
+    $trail->parent('admin.projects.documentation-versions.category-path.documentations', $project, $version, $categoryPath);
+
+    $trail->push(__('Edit'), route('admin.projects.documentation-versions.documentations.edit', ['project' => $project->id, 'version' => $version->id, 'documentation' => $documentation->id]));
+});
+// End Projects documentation-versions documentations
+
+// Projects documentation-versions categories
+Breadcrumbs::for('admin.projects.documentation-versions.categories.index', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version) {
+    $trail->parent('admin.projects.documentation-versions.show', $project, $version);
+
+    $trail->push(__('admin-sections.Categories'), route('admin.projects.documentation-versions.categories.index', ['project' => $project->id, 'version' => $version->id]));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.categories.create', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version) {
+    $trail->parent('admin.projects.documentation-versions.categories.index', $project, $version);
+
+    $trail->push(__('Create'), route('admin.projects.documentation-versions.categories.create', ['project' => $project->id, 'version' => $version->id]));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.category-path.categories', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version, \Illuminate\Support\Collection $categoryPath) {
+    $trail->parent('admin.projects.documentation-versions.category-path', $project, $version, $categoryPath);
+
+    $trail->push(__('admin-sections.Categories'), route('admin.projects.documentation-versions.categories.index', ['project' => $project->id, 'version' => $version->id]));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.category-path.categories.create', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version, \Illuminate\Support\Collection $categoryPath) {
+    $trail->parent('admin.projects.documentation-versions.category-path.categories', $project, $version, $categoryPath);
+
+    $trail->push(__('Create'), route('admin.projects.documentation-versions.categories.create', ['project' => $project->id, 'version' => $version->id]));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.categories.edit', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version, \App\Models\DocumentationCategory $category) {
+    $trail->parent('admin.projects.documentation-versions.categories.index', $project, $version);
+
+    $trail->push(__('Edit'), route('admin.projects.documentation-versions.categories.edit', ['project' => $project->id, 'version' => $version->id, 'category' => $category->id]));
+});
+
+Breadcrumbs::for('admin.projects.documentation-versions.category-path.categories.edit', function ($trail, \App\Models\Project $project, \App\Models\DocumentationVersion $version, \App\Models\DocumentationCategory $category, \Illuminate\Support\Collection $categoryPath) {
+    $trail->parent('admin.projects.documentation-versions.category-path.categories', $project, $version, $categoryPath);
+
+    $trail->push(__('Edit'), route('admin.projects.documentation-versions.categories.edit', ['project' => $project->id, 'version' => $version->id, 'category' => $category->id]));
+});
+// End Projects documentation-versions categories
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Project') . ': ' . $project->name)
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.about.edit', $project, $language))
 <x-admin.layout>
    <div class="row">
        <div class="col-12 mb-4">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Project') . ': ' . $project->name)
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.about.languages', $project))
@php
    $contents = $project->contents;
@endphp
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Projects'))
@section('h1', __('admin-sections.Projects'))
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.create'))
 <x-admin.layout>
    @include('admin.projects._top')
    <div class="row">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Documentation version'))
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.create', $project))
 <x-admin.layout>
    @include('admin.projects.documentation-versions._top')
    <div class="row">
@@ -2,6 +2,11 @@
@section('h1')
    {{ __('admin-sections.Project') . ': ' . $project->name . ' (' . $version->title . ')' }}
@endsection
+@if(!empty($categoryPath))
+    @section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.category-path.categories.create', $project, $version, $categoryPath))
+@else
+    @section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.categories.create', $project, $version))
+@endif
 <x-admin.layout>
    @include('admin.projects.documentation-versions.documentation-categories._top')
    <div class="row">
@@ -2,6 +2,11 @@
@section('h1')
    {{ __('admin-sections.Project') . ': ' . $project->name . ' (' . $version->title . ')' }}
@endsection
+@if(!empty($categoryPath))
+    @section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.category-path.categories.edit', $project, $version, $category, $categoryPath))
+@else
+    @section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.categories.edit', $project, $version, $category))
+@endif
 <x-admin.layout>
    @include('admin.projects.documentation-versions.documentation-categories._top')
    <div class="row">
@@ -2,6 +2,7 @@
@section('h1')
    {{ __('admin-sections.Project') . ': ' . $project->name . ' (' . $version->title . ')' }}
@endsection
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.categories.index', $project, $version))
 <x-admin.layout>
    @include('admin.projects.documentation-versions.documentation-categories._top')
    <div class="card border-0 shadow mb-4">
@@ -2,6 +2,11 @@
@section('h1')
    {{ __('admin-sections.Project') . ': ' . $project->name . ' (' . $version->title . ')' }}
@endsection
+@if(!empty($categoryPath))
+    @section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.category-path.documentations.create', $project, $version, $categoryPath))
+@else
+    @section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.documentations.create', $project, $version))
+@endif
 <x-admin.layout>
    @include('admin.projects.documentation-versions.documentations._top')
    <div class="row">
@@ -2,6 +2,11 @@
@section('h1')
    {{ __('admin-sections.Project') . ': ' . $project->name . ' (' . $version->title . ')' }}
@endsection
+@if(!empty($categoryPath))
+    @section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.category-path.documentations.edit', $project, $version, $documentation, $categoryPath))
+@else
+    @section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.documentations.edit', $project, $version, $documentation))
+@endif
 <x-admin.layout>
    @include('admin.projects.documentation-versions.documentations._top')
    <div class="row">
@@ -2,6 +2,7 @@
@section('h1')
    {{ __('admin-sections.Project') . ': ' . $project->name . ' (' . $version->title . ')' }}
@endsection
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.documentations.index', $project, $version))
 <x-admin.layout>
    @include('admin.projects.documentation-versions.documentations._top')
    <div class="card border-0 shadow mb-4">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Documentation version'))
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.edit', $project, $version))
 <x-admin.layout>
    @include('admin.projects.documentation-versions._top')
    <div class="row">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Documentation version'))
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.index', $project))
 <x-admin.layout>
    @include('admin.projects.documentation-versions._top')
    <div class="card border-0 shadow mb-4">
@@ -41,7 +42,7 @@
                                @endif
                            </td>
                            <td>
-                                <a href="{{ route('admin.projects.documentation-versions.edit', ['project' => $project->id, 'documentation_version' => $version->id])  }}" class="btn btn-primary" data-bs-toggle="tooltip" data-bs-placement="top" title="{{ __('Edit') }}">
+                                <a href="{{ route('admin.projects.documentation-versions.edit', ['project' => $project->id, 'documentation_version' => $version->id]) }}" class="btn btn-primary" data-bs-toggle="tooltip" data-bs-placement="top" title="{{ __('Edit') }}">
                                    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="align-text-top" viewBox="0 0 16 16">
                                        <path d="M12.854.146a.5.5 0 0 0-.707 0L10.5 1.793 14.207 5.5l1.647-1.646a.5.5 0 0 0 0-.708l-3-3zm.646 6.061L9.793 2.5 3.293 9H3.5a.5.5 0 0 1 .5.5v.5h.5a.5.5 0 0 1 .5.5v.5h.5a.5.5 0 0 1 .5.5v.5h.5a.5.5 0 0 1 .5.5v.207l6.5-6.5zm-7.468 7.468A.5.5 0 0 1 6 13.5V13h-.5a.5.5 0 0 1-.5-.5V12h-.5a.5.5 0 0 1-.5-.5V11h-.5a.5.5 0 0 1-.5-.5V10h-.5a.499.499 0 0 1-.175-.032l-.179.178a.5.5 0 0 0-.11.168l-2 5a.5.5 0 0 0 .65.65l5-2a.5.5 0 0 0 .168-.11l.178-.178z"/>
                                    </svg>
@@ -1,5 +1,10 @@
@section('meta_title', __('admin-sections.Documentation version'))
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@if(!empty($category))
+    @section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.show.category', $project, $version, $category, $categoryPath ?? null))
+@else
+    @section('breadcrumbs', Breadcrumbs::render('admin.projects.documentation-versions.show', $project, $version))
+@endif
@php
    $categoryId = null;
    if (!empty($category) && $category->id) {
@@ -34,9 +39,7 @@
                <table class="table table-centered table-nowrap mb-0 rounded">
                    <thead class="thead-light">
                    <tr>
-                        <td><h5>{{ __('admin-sections.Categories') }}</h5></td>
-                    </tr>
-                    <tr>
+                        <th class="border-0">{{ __('validation.attributes.type') }}</th>
                        <th class="border-0">{{ __('validation.attributes.title') }}</th>
                        <th class="border-0">{{ __('validation.attributes.slug') }}</th>
                        <th class="border-0">{{ __('validation.attributes.is_public') }}</th>
@@ -46,6 +49,9 @@
                    <tbody>
                    @forelse($categories as $category)
                        <tr>
+                            <td>
+                                {{ __('admin-sections.Categories') }}
+                            </td>
                            <td>
                                @can('view', $category)
                                    <a href="{{ route('admin.projects.documentation-versions.category.show', ['project' => $project->id, 'version' => $version->id, 'category' => $category->id]) }}" class="text-decoration-none text-dark">
@@ -95,19 +101,11 @@
                            </td>
                        </tr>
                    @endforelse
-                    </tbody>
-                    <tbody>
-                    <tr>
-                        <td><h5>{{ __('admin-sections.Documentation') }}</h5></td>
-                    </tr>
-                    <tr class="thead-light">
-                        <th class="border-0">{{ __('validation.attributes.title') }}</th>
-                        <th class="border-0">{{ __('validation.attributes.slug') }}</th>
-                        <th class="border-0">{{ __('validation.attributes.is_public') }}</th>
-                        <th class="border-0 rounded-end" style="width: 150px"></th>
-                    </tr>
                    @forelse($documentations as $documentation)
                        <tr>
+                            <td>
+                                {{ __('admin-sections.Documentation') }}
+                            </td>
                            <td>
                                {{ $documentation->content?->title }}
                            </td>
@@ -1,11 +1,13 @@
@section('meta_title', __('admin-sections.Projects'))
@section('h1', __('admin-sections.Projects'))
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.edit', $project))
 <x-admin.layout>
    @include('admin.projects._top')
    <div class="row">
        <div class="col-12 mb-4">
            <div class="card border-0 shadow components-section">
                <div class="card-body">
+                    <h3 id="category" class="mb-4">{{ __('admin-sections.Project') . ': ' . $project->name }}</h3>
                    <form method="post" action="{{ route('admin.projects.update', $project) }}">
                        @method('PUT')
                        @include('admin.projects._from')
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Feedback'))
@section('h1', __('admin-sections.Feedback'))
+@section('breadcrumbs', Breadcrumbs::render('admin.feedbacks.index'))
 <x-admin.layout>
    <div class="card border-0 shadow mb-4">
        <div class="card-body">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Project') . ': ' . $project->name . ' - ' . __('admin-sections.Feedback'))
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.feedbacks.index', $project))
 <x-admin.layout>
    <div class="card border-0 shadow mb-4">
        <div class="card-body">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Projects'))
@section('h1', __('admin-sections.Projects'))
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.index'))
 <x-admin.layout>
    @include('admin.projects._top')
    <div class="card border-0 shadow mb-4">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Links project'))
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.links.create', $project))
 <x-admin.layout>
    @include('admin.projects.links._top')
    <div class="row">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Links project'))
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.links.edit', $project, $link))
 <x-admin.layout>
    @include('admin.projects.links._top')
    <div class="row">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Links project'))
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.links.index', $project))
 <x-admin.layout>
    @include('admin.projects.links._top')
    <div class="card border-0 shadow mb-4">
@@ -1,10 +1,12 @@
@section('meta_title', __('admin-sections.Setting up automatic translation') . '. ' . __('admin-sections.Project') . ': ' . $project->name)
-@section('h1', __('admin-sections.Setting up automatic translation') . '. ' . __('admin-sections.Project') . ': ' . $project->name)
+@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.service-translate.view', $project))
 <x-admin.layout>
    <div class="row">
        <div class="col-12 mb-4">
            <div class="card border-0 shadow components-section">
                <div class="card-body">
+                    <h3 id="category" class="mb-4">{{ __('admin-sections.Setting up automatic translation') }}</h3>
                    <form method="post" action="{{ route('admin.projects.service-translate.update', ['project' => $project->id]) }}">
                        @csrf
                        <div class="table-responsive">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Project') . ': ' . $project->name)
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.show', $project))
 <x-admin.layout>
    @include('admin.projects._top')
    <div class="card border-0 shadow mb-4">
@@ -1,11 +1,12 @@
@section('meta_title', __('admin-sections.Translations'))
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.translations.edit', $project, $language))
 <x-admin.layout>
    <div class="row">
        <div class="col-12 mb-4">
            <div class="card border-0 shadow components-section">
                <div class="card-body">
-                    <h3 id="category" class="mb-4">{{ __('admin-sections.Translations') }}</h3>
+                    <h3 id="category" class="mb-4">{{ __('admin-sections.Translations') . ': ' . $language->title }}</h3>
                    <div class="table-responsive">
                        <form method="post" action="{{ route('admin.projects.translations.update', ['project' => $project->id, 'language' => $language->id]) }}">
                            @if($serviceTranslationEnable)
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Translations'))
@section('h1', __('admin-sections.Project') . ': ' . $project->name)
+@section('breadcrumbs', Breadcrumbs::render('admin.projects.translations.languages', $project))
 <x-admin.layout>
    <div class="row">
        <div class="col-12 mb-4">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Users'))
@section('h1', __('admin-sections.Users'))
+@section('breadcrumbs', Breadcrumbs::render('admin.users.create'))
 <x-admin.layout>
    @include('admin.users._top')
    <div class="row">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Users'))
@section('h1', __('admin-sections.Users'))
+@section('breadcrumbs', Breadcrumbs::render('admin.users.edit', $user))
 <x-admin.layout>
    @include('admin.users._top')
    <div class="row">
@@ -1,5 +1,6 @@
@section('meta_title', __('admin-sections.Users'))
@section('h1', __('admin-sections.Users'))
+@section('breadcrumbs', Breadcrumbs::render('admin.users.index'))
 <x-admin.layout>
    @include('admin.users._top')
    <div class="card border-0 shadow mb-4">
Author	SHA1	Message	Date
kor-elf	7a1b9ecda1	Refactor table structure in admin documentation versions view - Consolidate category and documentation sections under a single table. - Adjust layout for clarity and consistency.	2026-07-25 02:09:15 +05:00
kor-elf	5f0958f42e	Add breadcrumbs to admin documentation categories views - Implement breadcrumbs for `index`, `create`, and `edit` views. - Add conditional logic for category paths in `create` and `edit` views.	2026-07-25 01:25:49 +05:00
kor-elf	db0dce27b4	Add breadcrumbs to admin project documentation views - Implement breadcrumbs for `index`, `create`, and `edit` views. - Add conditional logic to handle optional category paths in `create` and `edit` views.	2026-07-25 01:25:31 +05:00
kor-elf	754a67c5d0	Add breadcrumbs to admin project documentation versions views - Introduce breadcrumbs for `index`, `create`, `edit`, and `show` views. - Adjust breadcrumb logic to handle optional categories in `show` view.	2026-07-25 01:25:18 +05:00
kor-elf	ace4c69bd8	Add breadcrumbs to admin project service translate view - Introduce breadcrumbs for improved navigation on the service translate view. - Adjust heading structure and reorganize translation form layout.	2026-07-25 01:23:09 +05:00
kor-elf	42d8728b1b	Add breadcrumbs to admin project translations views - Add breadcrumbs to `languages` and `edit` views for improved navigation.	2026-07-25 01:22:26 +05:00
kor-elf	efab6d8eed	Add breadcrumbs to admin project links views	2026-07-25 01:22:13 +05:00
kor-elf	aa03855bb3	Add breadcrumbs to admin project feedbacks index view	2026-07-25 01:21:59 +05:00
kor-elf	7fd3a0d45c	Add breadcrumbs to admin project languages and edit views	2026-07-25 01:21:49 +05:00
kor-elf	506f403a00	Add breadcrumbs to admin project feedback view	2026-07-25 01:21:06 +05:00
kor-elf	b8efe490a7	Add breadcrumbs to admin projects views - Implement breadcrumbs for index, create, edit, and show views.	2026-07-25 01:20:54 +05:00
kor-elf	e11815b795	Add breadcrumbs to admin users views - Implement breadcrumbs for index, create, and edit views.	2026-07-25 01:20:08 +05:00
kor-elf	d925928ea9	Add cache clearing after key documentation category operations - Inject `ClearCacheCommandHandler` into `DocumentationCategoryService`. - Clear cache when creating, updating, or deleting a documentation category. - Extend responses to include `categoryPath` where applicable.	2026-07-25 01:19:09 +05:00
kor-elf	0d08276d44	Add category path resolution in DocumentationService - Resolve `categoryPath` using `getPathFromRoot` based on the project's default language. - Include the resolved `categoryPath` in the response.	2026-07-25 01:18:52 +05:00
kor-elf	54a2d84a00	Add category path resolution in DocumentationVersionService - Fetch category path using `getPathFromRoot` for the default project language. - Pass resolved `categoryPath` to the view.	2026-07-25 01:18:29 +05:00
kor-elf	a70e09bddc	Add recursive method to fetch category path in DocumentationCategoryRepository - Implement `getPathFromRoot` to retrieve the category path using recursive SQL query. - Cache results for improved performance.	2026-07-25 01:17:55 +05:00
kor-elf	6e8b708749	Add breadcrumbs for admin users, feedbacks, projects, and related views - Extend admin breadcrumbs configuration with paths for users, feedbacks, projects, translations, links, about, documentation versions, documentations, and categories.	2026-07-25 01:02:25 +05:00