feat: Enhance SEO handling by adding root SEO context and update ContentHelper for ancestor web settings

Author: cklei-carly

src/Dtos/ContentDto.php

@@ -242,9 +242,21 @@ protected static function prepareDtoParameters(Model $record, array $propertyDat
 
         $dtoParameters = $record->toArray();
 
-        $dtoParameters['seo'] = collect($availableLanguages)->keys()->mapWithKeys(fn ($locale) => [
-            $locale => $record->webSetting?->toDto($locale),
-        ])->all();
+        $dtoParameters['seo'] = collect($availableLanguages)->keys()->mapWithKeys(function ($locale) use ($record) {
+            $seo = $record->webSetting?->toDto($locale);
+
+            if (
+                $seo instanceof SeoDto
+                && ($root = collect($record->ancestorsAndSelf)->where(fn ($item) => $item->getKey() !== $record->getKey())->last())
+                && ($rootSeo = $root->webSetting?->toDto($locale))
+            ) {
+                $seo->setRoot($rootSeo);
+            }
+
+            return [
+                $locale => $seo,
+            ];
+        })->all();
 
         $dtoParameters['urls'] = collect($availableLanguages)->mapWithKeys(fn (LanguageDto $lang) => [
             $lang->code => $record->getUrl($lang),

src/Dtos/SeoDto.php

@@ -211,6 +211,11 @@ class SeoDto extends BaseDto
      */
     public $noCache;
 
+    /**
+     * @var self|null
+     */
+    protected $root = null;
+
     public static function fromArray(array $parameters)
     {
         $mapper = [
@@ -256,6 +261,17 @@ public static function fromArray(array $parameters)
         return $dto;
     }
 
+    /**
+     * @param self|null $root
+     * @return self
+     */
+    public function setRoot($root)
+    {
+        $this->root = $root;
+
+        return $this;
+    }
+
     public function getHtml(): Htmlable
     {
         return new HtmlString($this->__toString());
@@ -266,7 +282,11 @@ public function __toString(): string
         $html = '';
 
         if ($this->title) {
-            $html .= "<title>{$this->title}</title>\n";
+            $title = $this->title;
+            if ($this->root) {
+                $title .= ' - ' . $this->root->title;
+            }
+            $html .= "<title>{$title}</title>\n";
         }
 
         if ($this->description) {
@@ -277,12 +297,18 @@ public function __toString(): string
             $html .= "<meta name=\"keywords\" content=\"{$this->keywords}\">\n";
         }
 
-        if ($this->ogTitle) {
-            $html .= "<meta property=\"og:title\" content=\"{$this->ogTitle}\">\n";
+        if ($this->ogTitle || $this->title) {
+            $ogTitle = $this->ogTitle ?: $this->title;
+            if ($this->root) {
+                $ogTitle .= ' - ' . $this->root->title;
+            }
+
+            $html .= "<meta property=\"og:title\" content=\"{$ogTitle}\">\n";
         }
 
-        if ($this->ogDescription) {
-            $html .= "<meta property=\"og:description\" content=\"{$this->ogDescription}\">\n";
+        if ($this->ogDescription || $this->description) {
+            $ogDescription = $this->ogDescription ?: $this->description;
+            $html .= "<meta property=\"og:description\" content=\"{$ogDescription}\">\n";
         }
 
         if ($this->ogImage && ($mediaAssetUrl = inspirecms_asset()->findByKeys($this->ogImage)->first()?->getUrl())) {

src/Helpers/ContentHelper.php

@@ -94,6 +94,7 @@ public static function getDtoRequiredRelations(): array
             'webSetting',
             'publishedVersions',
             'templates',
+            'ancestorsAndSelf.webSetting',
         ];
     }