Allow Entity classname in BreadcrumbBuilder

Author: dvlpp

docs/guide/link-to.md

@@ -70,11 +70,10 @@ In more complex cases you can also handle the full breadcrumb, by using the `wit
 
 ```php
 LinkToShowPage::make(PlayerEntity::class, 1)
-    ->withBreadcrumb(function (BreadcrumbBuilder $builder) {
-        return $builder
-            ->appendEntityList('team')
-            ->appendShowPage('team', 6);
-    })
+    ->withBreadcrumb(fn (BreadcrumbBuilder $builder) => $builder
+        ->appendEntityList(TeamEntity::class)
+        ->appendShowPage(TeamEntity::class, 6)
+    )
     ->renderAsUrl(),
 ```
 

docs/guide/testing-with-sharp.md

@@ -77,11 +77,11 @@ it('allow the user to display a leaf form', function () {
         ->loginAsSharpUser()
         ->withSharpBreadcrumb(function (BreadcrumbBuilder $builder) {
             return $builder
-                ->appendEntityList('trees')
-                ->appendShowPage('trees', 6)
-                ->appendShowPage('leaves', 16);
+                ->appendEntityList(TreeEntity::class)
+                ->appendShowPage(TreeEntity::class, 6)
+                ->appendShowPage(LeafEntity::class, 16);
         })
-        ->getSharpForm('leaves', 16)
+        ->getSharpForm(LeafEntity::class, 16)
         ->assertOk();
 });
 ```

src/Utils/Links/BreadcrumbBuilder.php

@@ -4,6 +4,7 @@
 
 use Code16\Sharp\Exceptions\SharpInvalidBreadcrumbItemException;
 use Code16\Sharp\Http\Context\Util\BreadcrumbItem;
+use Code16\Sharp\Utils\Entities\SharpEntityManager;
 use Illuminate\Support\Traits\Conditionable;
 
 class BreadcrumbBuilder
@@ -12,34 +13,37 @@ class BreadcrumbBuilder
 
     protected array $breadcrumbParts = [];
 
-    public function appendEntityList(string $entityKey): self
+    public function appendEntityList(string $entityClassNameOrKey): self
     {
         if (! empty($this->breadcrumbParts)) {
             throw new SharpInvalidBreadcrumbItemException('Entity list must be the first breadcrumb item');
         }
 
+        $entityKey = $this->resolveEntityKey($entityClassNameOrKey);
         $this->breadcrumbParts[] = new BreadcrumbItem('s-list', $entityKey);
 
         return $this;
     }
 
-    public function appendSingleShowPage(string $entityKey): self
+    public function appendSingleShowPage(string $entityClassNameOrKey): self
     {
         if (! empty($this->breadcrumbParts)) {
             throw new SharpInvalidBreadcrumbItemException('Single show page must be the first breadcrumb item');
         }
 
+        $entityKey = $this->resolveEntityKey($entityClassNameOrKey);
         $this->breadcrumbParts[] = new BreadcrumbItem('s-show', $entityKey);
 
         return $this;
     }
 
-    public function appendShowPage(string $entityKey, string $instanceId): self
+    public function appendShowPage(string $entityClassNameOrKey, string $instanceId): self
     {
         if (empty($this->breadcrumbParts)) {
             throw new SharpInvalidBreadcrumbItemException('Show page can not be the first breadcrumb item');
         }
 
+        $entityKey = $this->resolveEntityKey($entityClassNameOrKey);
         $this->breadcrumbParts[] = (new BreadcrumbItem('s-show', $entityKey))->setInstance($instanceId);
 
         return $this;
@@ -51,4 +55,11 @@ public function generateUri(): string
             ->map(fn (BreadcrumbItem $item) => $item->toUri())
             ->implode('/');
     }
+
+    private function resolveEntityKey(string $entityClassNameOrKey): string
+    {
+        return class_exists($entityClassNameOrKey)
+            ? app(SharpEntityManager::class)->entityKeyFor($entityClassNameOrKey)
+            : $entityClassNameOrKey;
+    }
 }

tests/Unit/Utils/SharpLinkToTest.php

@@ -61,7 +61,7 @@
     );
 });
 
-it('allows to generate a link to a show page passing an SharpEntity class', function () {
+it('allows to generate a link to a show page passing a SharpEntity class', function () {
     app(SharpConfigBuilder::class)
         ->addEntity('person', PersonEntity::class);
 
@@ -84,6 +84,22 @@
     );
 });
 
+it('allows to generate an url to a show page with a specific breadcrumb passing a SharpEntity class', function () {
+    app(SharpConfigBuilder::class)
+        ->addEntity('person', PersonEntity::class);
+
+    $this->assertEquals(
+        'http://localhost/sharp/s-list/person/s-show/person/3/s-show/person/4',
+        LinkToShowPage::make(PersonEntity::class, 4)
+            ->withBreadcrumb(function (BreadcrumbBuilder $builder) {
+                return $builder
+                    ->appendEntityList(PersonEntity::class)
+                    ->appendShowPage(PersonEntity::class, 3);
+            })
+            ->renderAsUrl(),
+    );
+});
+
 it('allows to generate an url to a form with a specific breadcrumb', function () {
     $this->assertEquals(
         'http://localhost/sharp/s-list/base-entity/s-show/base-entity/3/s-show/my-entity/4/s-form/my-entity/4',