From 6d9ffc808b32e64a90f698e6a1ce84ca7d48b53a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=9Cmit=20Tun=C3=A7?= <umitreva@gmail.com>
Date: Thu, 21 May 2026 21:54:12 +0300
Subject: [PATCH] feat: implement structured data support for blog and page
 components, enhancing SEO and user experience through JSON-LD integration

---
 .cursor/rules/structured-data.mdc             |  85 +++++++++
 app/Http/Controllers/BlogController.php       |  10 +
 app/Http/Controllers/PageController.php       |  17 +-
 app/Support/BlogStructuredData.php            | 149 +++++++++++++++
 app/Support/MusicProductionStructuredData.php | 174 ++++--------------
 app/Support/PageStructuredData.php            |  58 ++++++
 app/Support/StructuredData.php                | 149 +++++++++++++++
 lang/en/blog.php                              |   2 +
 lang/en/pages.php                             |   1 +
 lang/tr/blog.php                              |   2 +
 lang/tr/pages.php                             |   1 +
 resources/views/blog/show.blade.php           |  30 ---
 .../front/music-productions/index.blade.php   |   2 -
 .../front/music-productions/show.blade.php    |   2 -
 resources/views/layouts/site.blade.php        |   3 +
 15 files changed, 509 insertions(+), 176 deletions(-)
 create mode 100644 .cursor/rules/structured-data.mdc
 create mode 100644 app/Support/BlogStructuredData.php
 create mode 100644 app/Support/PageStructuredData.php
 create mode 100644 app/Support/StructuredData.php
diff --git a/.cursor/rules/structured-data.mdc b/.cursor/rules/structured-data.mdc
new file mode 100644
index 0000000..1fb8978
--- /dev/null
+++ b/.cursor/rules/structured-data.mdc
@@ -0,0 +1,85 @@
+---
+description: Google yapılandırılmış veri (JSON-LD) standartları
+globs: app/Support/*StructuredData*.php, app/Http/Controllers/**/*.php, resources/views/**/*.blade.php
+---
+# Yapılandırılmış Veri (Structured Data) Kuralları
+
+Google [Yapılandırılmış Veri Genel Yönergeleri](https://developers.google.com/search/docs/appearance/structured-data/sd-policies?hl=tr) ve [Giriş](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data?hl=tr) dokümanlarına uy.
+
+## Temel İlkeler
+
+1. **JSON-LD kullan** — Google'ın önerdiği format; `<head>` içinde `<script type="application/ld+json">` ile sunulur.
+2. **Sayfa içeriğiyle eşleş** — İşaretlenen veri kullanıcının gördüğü içerikle birebir uyumlu olmalı; görünmeyen veya yanlış bilgi ekleme.
+3. **Eksiksiz ve doğru özellikler** — Zorunlu alanları doldur; eksik/hatalı önerilen alanları doldurmaya çalışmak yerine az ama doğru veri tercih et.
+4. **schema.org sözlüğü** — `@context: https://schema.org` kullan; Google Arama özellikleri için [Search Central özellik rehberlerini](https://developers.google.com/search/docs/appearance/structured-data/search-gallery?hl=tr) referans al.
+
+## Proje Mimarisi
+
+```
+app/Support/
+├── StructuredData.php              # Ortak yardımcılar (WebSite, Organization, WebPage, BreadcrumbList)
+├── PageStructuredData.php          # CMS sayfaları
+├── BlogStructuredData.php          # Blog listesi ve detay
+└── MusicProductionStructuredData.php
+```
+
+### Controller → View akışı
+
+```php
+// Controller
+'structuredData' => BlogStructuredData::forShow($post, url()->current()),
+
+// Layout (layouts/site.blade.php) otomatik render eder:
+@if(!empty($structuredData))
+    <x-seo.json-ld :data="$structuredData" />
+@endif
+```
+
+**Asla** Blade içinde ham JSON string interpolasyonu kullanma — `json_encode` ile `<x-seo.json-ld>` bileşenini kullan.
+
+## Sayfa Türü → Schema Eşlemesi
+
+| Sayfa türü | Schema türleri | Sınıf |
+|---|---|---|
+| Ana sayfa / CMS sayfaları | WebSite, Organization, WebPage, BreadcrumbList | `PageStructuredData` |
+| Blog listesi | CollectionPage, ItemList, BlogPosting (özet) | `BlogStructuredData::forIndex` |
+| Blog detay | BlogPosting, WebPage, BreadcrumbList | `BlogStructuredData::forShow` |
+| Müzik prodüksiyonları | CollectionPage / MusicAlbum, ItemList | `MusicProductionStructuredData` |
+| Ürün/hizmet sayfaları | WebPage, Product veya Service | Henüz eklenmedi |
+| Kariyer / staj | WebPage | Henüz eklenmedi |
+| İletişim | WebPage, Organization (contactPoint) | Henüz eklenmedi |
+
+## @graph Deseni
+
+Birden fazla entity için `@graph` kullan; `@id` ile cross-reference yap:
+
+```php
+return self::wrap([
+    self::websiteNode(),
+    self::organizationNode(),
+    self::webPageNode($pageUrl, $name, $description),
+    self::breadcrumbNode($pageUrl, $items),
+    // sayfa-özel entity (BlogPosting, MusicAlbum, vb.)
+]);
+```
+
+## Yeni Sayfa Eklerken
+
+1. `app/Support/` altında `*StructuredData.php` sınıfı oluştur veya mevcut sınıfı genişlet.
+2. `StructuredData` base sınıfındaki ortak node'ları kullan (DRY).
+3. Controller'da `structuredData` key'ini view'a geçir.
+4. Görünür içerikle eşleştiğini doğrula (başlık, açıklama, görsel, tarih).
+5. [Zengin Sonuçlar Testi](https://search.google.com/test/rich-results) ile doğrula.
+
+## Yasaklar
+
+- ❌ Boş veya içeriksiz sayfalara yalnızca schema eklemek
+- ❌ Blade'de `"headline": "{{ $title }}"` gibi kaçışsız JSON
+- ❌ `@push('scripts')` ile body sonuna JSON-LD koymak (head'de olmalı)
+- ❌ data-vocabulary.org işaretlemesi
+- ❌ Kullanıcıya görünmeyen rating/review verisi uydurmak
+
+## Doğrulama
+
+- Geliştirme: [Zengin Sonuçlar Testi](https://search.google.com/test/rich-results)
+- Prod: Search Console → Zengin sonuçlar raporları
diff --git a/app/Http/Controllers/BlogController.php b/app/Http/Controllers/BlogController.php
index d3eb264..58480a9 100644
--- a/app/Http/Controllers/BlogController.php
+++ b/app/Http/Controllers/BlogController.php
@@ -9,6 +9,7 @@ use App\Models\HeaderTemplate;
 use App\Models\FooterTemplate;
 use App\Services\TemplateService;
 use App\Models\Page;
+use App\Support\BlogStructuredData;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Validator;
 
@@ -115,6 +116,8 @@ class BlogController extends Controller
 			]);
 		}
 
+		$pageUrl = url()->current();
+
 		return view('blog.index', [
 			'settings' => $settings,
 			'posts' => $posts,
@@ -125,6 +128,9 @@ class BlogController extends Controller
 				'title' => __('blog.meta-index-title'),
 				'description' => __('blog.meta-index-description'),
 			],
+			'structuredData' => $posts instanceof \Illuminate\Contracts\Pagination\LengthAwarePaginator
+				? BlogStructuredData::forIndex($posts, $pageUrl)
+				: null,
 		]);
 	}
 
@@ -215,6 +221,8 @@ class BlogController extends Controller
 			);
 		}
 
+		$pageUrl = route('blog.show', $post->slug);
+
 		return view('blog.show', [
 			'settings' => $settings,
 			'post' => $post,
@@ -226,7 +234,9 @@ class BlogController extends Controller
 				'title' => method_exists($post, 'translate') ? ($post->translate('meta_title') ?: $post->translate('title')) : ($post->meta_title ?? $post->title),
 				'description' => method_exists($post, 'translate') ? ($post->translate('meta_description') ?: $post->translate('excerpt')) : ($post->meta_description ?? $post->excerpt),
 				'image' => $post->featured_image ? asset('storage/' . $post->featured_image) : null,
+				'og_type' => 'article',
 			],
+			'structuredData' => BlogStructuredData::forShow($post, $pageUrl),
 		]);
 	}
 
diff --git a/app/Http/Controllers/PageController.php b/app/Http/Controllers/PageController.php
index 841519b..7cb7374 100644
--- a/app/Http/Controllers/PageController.php
+++ b/app/Http/Controllers/PageController.php
@@ -7,6 +7,7 @@ use App\Models\Setting;
 use App\Models\HeaderTemplate;
 use App\Models\FooterTemplate;
 use App\Services\TemplateService;
+use App\Support\PageStructuredData;
 use Illuminate\Http\Request;
 use Illuminate\Support\Collection;
 
@@ -32,10 +33,13 @@ class PageController extends Controller
 
         // Hiç sayfa yoksa fallback
         if (!$page) {
+            $meta = $this->getMeta(null, $settings);
+
             return view('templates.home', [
                 'page' => null,
                 'settings' => $settings,
-                'meta' => $this->getMeta(null, $settings),
+                'meta' => $meta,
+                'structuredData' => PageStructuredData::forPage(null, url('/'), $meta['title'] ?? null, $meta['description'] ?? null),
             ]);
         }
 
@@ -136,6 +140,9 @@ class PageController extends Controller
             $renderedFooter = $this->renderFooter($page, $settings);
         }
 
+        $meta = $this->getMeta($page, $settings);
+        $pageUrl = url()->current();
+
         return view($view, [
             'page' => $page,
             'settings' => $settings,
@@ -143,7 +150,13 @@ class PageController extends Controller
             'templatedSections' => $page ? ($page->templated_sections ?? collect([])) : collect([]),
             'renderedHeader' => $renderedHeader,
             'renderedFooter' => $renderedFooter,
-            'meta' => $this->getMeta($page, $settings),
+            'meta' => $meta,
+            'structuredData' => PageStructuredData::forPage(
+                $page,
+                $pageUrl,
+                $meta['title'] ?? null,
+                $meta['description'] ?? null,
+            ),
         ]);
     }
 
diff --git a/app/Support/BlogStructuredData.php b/app/Support/BlogStructuredData.php
new file mode 100644
index 0000000..2f7e381
--- /dev/null
+++ b/app/Support/BlogStructuredData.php
@@ -0,0 +1,149 @@
+<?php
+
+namespace App\Support;
+
+use App\Models\Blog;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
+use Illuminate\Support\Str;
+
+class BlogStructuredData extends StructuredData
+{
+    public static function forIndex(LengthAwarePaginator $posts, string $pageUrl): array
+    {
+        $pageName = __('blog.meta-index-title');
+        $pageDescription = __('blog.meta-index-description');
+
+        $itemListElements = [];
+        $offset = ($posts->currentPage() - 1) * $posts->perPage();
+
+        foreach ($posts as $index => $post) {
+            $itemListElements[] = self::listItem(
+                $offset + $index + 1,
+                self::postSummarySchema($post),
+            );
+        }
+
+        return self::wrap([
+            self::websiteNode(),
+            self::organizationNode(),
+            self::webPageNode($pageUrl, $pageName, $pageDescription, [
+                '@type' => 'CollectionPage',
+                'mainEntity' => ['@id' => $pageUrl . '#itemlist'],
+            ]),
+            self::breadcrumbNode($pageUrl, [
+                ['name' => __('blog.breadcrumb_home'), 'item' => self::siteUrl()],
+                ['name' => $pageName, 'item' => $pageUrl],
+            ]),
+            [
+                '@type' => 'ItemList',
+                '@id' => $pageUrl . '#itemlist',
+                'name' => $pageName,
+                'numberOfItems' => $posts->total(),
+                'itemListElement' => $itemListElements,
+            ],
+        ]);
+    }
+
+    public static function forShow(Blog $post, string $pageUrl): array
+    {
+        $title = $post->translate('title');
+        $description = Str::limit(strip_tags((string) $post->translate('excerpt')), 160);
+        $imageUrl = $post->featured_image_url ?: self::defaultImageUrl();
+        $publishedAt = $post->published_at ?? $post->created_at;
+
+        $blogPosting = [
+            '@type' => 'BlogPosting',
+            '@id' => $pageUrl . '#article',
+            'mainEntityOfPage' => ['@id' => $pageUrl . '#webpage'],
+            'headline' => $title,
+            'description' => $description,
+            'image' => [$imageUrl],
+            'inLanguage' => app()->getLocale(),
+            'author' => [
+                '@type' => 'Person',
+                'name' => $post->author->name ?? __('blog.default_author'),
+            ],
+            'publisher' => self::publisherNode(),
+            'datePublished' => $publishedAt->toIso8601String(),
+            'dateModified' => $post->updated_at->toIso8601String(),
+            'url' => $pageUrl,
+        ];
+
+        $content = strip_tags((string) $post->translate('content'));
+        if ($content !== '') {
+            $blogPosting['articleBody'] = Str::limit($content, 5000);
+        }
+
+        return self::wrap([
+            self::websiteNode(),
+            self::organizationNode(),
+            self::webPageNode($pageUrl, $title, $description, [
+                'mainEntity' => ['@id' => $pageUrl . '#article'],
+                'dateModified' => $post->updated_at->toIso8601String(),
+            ]),
+            self::breadcrumbNode($pageUrl, [
+                ['name' => __('blog.breadcrumb_home'), 'item' => self::siteUrl()],
+                ['name' => __('blog.meta-index-title'), 'item' => route('blog.index')],
+                ['name' => $title, 'item' => $pageUrl],
+            ]),
+            $blogPosting,
+        ]);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected static function postSummarySchema(Blog $post): array
+    {
+        $schema = [
+            '@type' => 'BlogPosting',
+            'headline' => $post->translate('title'),
+            'url' => route('blog.show', $post->slug),
+        ];
+
+        if ($post->featured_image_url) {
+            $schema['image'] = [$post->featured_image_url];
+        }
+
+        $publishedAt = $post->published_at ?? $post->created_at;
+        if ($publishedAt) {
+            $schema['datePublished'] = $publishedAt->toIso8601String();
+        }
+
+        return $schema;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected static function publisherNode(): array
+    {
+        $publisher = [
+            '@type' => 'Organization',
+            '@id' => self::siteUrl() . '#organization',
+            'name' => self::siteName(),
+        ];
+
+        $logo = setting('site_logo');
+        if ($logo) {
+            $logoUrl = str_starts_with($logo, 'http') ? $logo : asset('storage/' . ltrim($logo, '/'));
+            $publisher['logo'] = [
+                '@type' => 'ImageObject',
+                'url' => $logoUrl,
+            ];
+        }
+
+        return $publisher;
+    }
+
+    protected static function defaultImageUrl(): string
+    {
+        $defaultImage = setting('default_meta_image');
+
+        if ($defaultImage) {
+            return str_starts_with($defaultImage, 'http') ? $defaultImage : asset($defaultImage);
+        }
+
+        return asset('assets/img/logo.png');
+    }
+}
diff --git a/app/Support/MusicProductionStructuredData.php b/app/Support/MusicProductionStructuredData.php
index 47ffed7..a933d9b 100644
--- a/app/Support/MusicProductionStructuredData.php
+++ b/app/Support/MusicProductionStructuredData.php
@@ -6,12 +6,10 @@ use App\Models\MusicProduction;
 use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 use Illuminate\Support\Str;
 
-class MusicProductionStructuredData
+class MusicProductionStructuredData extends StructuredData
 {
     public static function forIndex(LengthAwarePaginator $productions, string $pageUrl): array
     {
-        $siteName = setting('site_name', config('app.name'));
-        $siteUrl = url('/');
         $pageName = __('music_productions.meta-index-title');
         $pageDescription = __('music_productions.meta-index-description');
 
@@ -19,45 +17,23 @@ class MusicProductionStructuredData
         $offset = ($productions->currentPage() - 1) * $productions->perPage();
 
         foreach ($productions as $index => $production) {
-            $itemListElements[] = [
-                '@type' => 'ListItem',
-                'position' => $offset + $index + 1,
-                'item' => self::productionSchema($production),
-            ];
+            $itemListElements[] = self::listItem(
+                $offset + $index + 1,
+                self::productionSchema($production),
+            );
         }
 
-        $graph = [
-            self::websiteNode($siteUrl, $siteName),
-            self::organizationNode($siteUrl, $siteName),
-            [
+        return self::wrap([
+            self::websiteNode(route('music-productions.index') . '?q={search_term_string}'),
+            self::organizationNode(),
+            self::webPageNode($pageUrl, $pageName, $pageDescription, [
                 '@type' => 'CollectionPage',
-                '@id' => $pageUrl . '#webpage',
-                'url' => $pageUrl,
-                'name' => $pageName,
-                'description' => $pageDescription,
-                'inLanguage' => app()->getLocale(),
-                'isPartOf' => ['@id' => $siteUrl . '#website'],
-                'breadcrumb' => ['@id' => $pageUrl . '#breadcrumb'],
                 'mainEntity' => ['@id' => $pageUrl . '#itemlist'],
-            ],
-            [
-                '@type' => 'BreadcrumbList',
-                '@id' => $pageUrl . '#breadcrumb',
-                'itemListElement' => [
-                    [
-                        '@type' => 'ListItem',
-                        'position' => 1,
-                        'name' => __('music_productions.breadcrumb_home'),
-                        'item' => $siteUrl,
-                    ],
-                    [
-                        '@type' => 'ListItem',
-                        'position' => 2,
-                        'name' => __('music_productions.nav-music-productions'),
-                        'item' => route('music-productions.index'),
-                    ],
-                ],
-            ],
+            ]),
+            self::breadcrumbNode($pageUrl, [
+                ['name' => __('music_productions.breadcrumb_home'), 'item' => self::siteUrl()],
+                ['name' => __('music_productions.nav-music-productions'), 'item' => route('music-productions.index')],
+            ]),
             [
                 '@type' => 'ItemList',
                 '@id' => $pageUrl . '#itemlist',
@@ -65,72 +41,36 @@ class MusicProductionStructuredData
                 'numberOfItems' => $productions->total(),
                 'itemListElement' => $itemListElements,
             ],
-        ];
-
-        return [
-            '@context' => 'https://schema.org',
-            '@graph' => $graph,
-        ];
+        ]);
     }
 
     public static function forShow(MusicProduction $production, string $pageUrl): array
     {
-        $siteName = setting('site_name', config('app.name'));
-        $siteUrl = url('/');
         $title = $production->translate('title');
         $description = Str::limit(strip_tags((string) $production->translate('content')), 160);
 
-        $graph = [
-            self::websiteNode($siteUrl, $siteName),
-            self::organizationNode($siteUrl, $siteName),
-            [
-                '@type' => 'BreadcrumbList',
-                '@id' => $pageUrl . '#breadcrumb',
-                'itemListElement' => [
-                    [
-                        '@type' => 'ListItem',
-                        'position' => 1,
-                        'name' => __('music_productions.breadcrumb_home'),
-                        'item' => $siteUrl,
-                    ],
-                    [
-                        '@type' => 'ListItem',
-                        'position' => 2,
-                        'name' => __('music_productions.nav-music-productions'),
-                        'item' => route('music-productions.index'),
-                    ],
-                    [
-                        '@type' => 'ListItem',
-                        'position' => 3,
-                        'name' => $title,
-                        'item' => $pageUrl,
-                    ],
-                ],
-            ],
-            array_merge(
-                [
-                    '@type' => 'WebPage',
-                    '@id' => $pageUrl . '#webpage',
-                    'url' => $pageUrl,
-                    'name' => $title,
-                    'description' => $description,
-                    'inLanguage' => app()->getLocale(),
-                    'isPartOf' => ['@id' => $siteUrl . '#website'],
-                    'breadcrumb' => ['@id' => $pageUrl . '#breadcrumb'],
-                    'mainEntity' => ['@id' => $pageUrl . '#production'],
-                ],
-                $production->updated_at ? ['dateModified' => $production->updated_at->toIso8601String()] : [],
-            ),
+        $webPageExtra = [
+            'mainEntity' => ['@id' => $pageUrl . '#production'],
+        ];
+
+        if ($production->updated_at) {
+            $webPageExtra['dateModified'] = $production->updated_at->toIso8601String();
+        }
+
+        return self::wrap([
+            self::websiteNode(route('music-productions.index') . '?q={search_term_string}'),
+            self::organizationNode(),
+            self::webPageNode($pageUrl, $title, $description, $webPageExtra),
+            self::breadcrumbNode($pageUrl, [
+                ['name' => __('music_productions.breadcrumb_home'), 'item' => self::siteUrl()],
+                ['name' => __('music_productions.nav-music-productions'), 'item' => route('music-productions.index')],
+                ['name' => $title, 'item' => $pageUrl],
+            ]),
             array_merge(
                 ['@id' => $pageUrl . '#production'],
                 self::productionSchema($production),
             ),
-        ];
-
-        return [
-            '@context' => 'https://schema.org',
-            '@graph' => $graph,
-        ];
+        ]);
     }
 
     /**
@@ -145,7 +85,7 @@ class MusicProductionStructuredData
         ];
 
         if ($production->cover_image_url) {
-            $schema['image'] = $production->cover_image_url;
+            $schema['image'] = [$production->cover_image_url];
         }
 
         $content = strip_tags((string) $production->translate('content'));
@@ -176,50 +116,4 @@ class MusicProductionStructuredData
 
         return $schema;
     }
-
-    /**
-     * @return array<string, mixed>
-     */
-    protected static function websiteNode(string $siteUrl, string $siteName): array
-    {
-        return [
-            '@type' => 'WebSite',
-            '@id' => $siteUrl . '#website',
-            'url' => $siteUrl,
-            'name' => $siteName,
-            'publisher' => ['@id' => $siteUrl . '#organization'],
-            'potentialAction' => [
-                '@type' => 'SearchAction',
-                'target' => [
-                    '@type' => 'EntryPoint',
-                    'urlTemplate' => route('music-productions.index') . '?q={search_term_string}',
-                ],
-                'query-input' => 'required name=search_term_string',
-            ],
-        ];
-    }
-
-    /**
-     * @return array<string, mixed>
-     */
-    protected static function organizationNode(string $siteUrl, string $siteName): array
-    {
-        $node = [
-            '@type' => 'Organization',
-            '@id' => $siteUrl . '#organization',
-            'name' => $siteName,
-            'url' => $siteUrl,
-        ];
-
-        $logo = setting('site_logo');
-        if ($logo) {
-            $logoUrl = str_starts_with($logo, 'http') ? $logo : asset('storage/' . ltrim($logo, '/'));
-            $node['logo'] = [
-                '@type' => 'ImageObject',
-                'url' => $logoUrl,
-            ];
-        }
-
-        return $node;
-    }
 }
diff --git a/app/Support/PageStructuredData.php b/app/Support/PageStructuredData.php
new file mode 100644
index 0000000..4711a48
--- /dev/null
+++ b/app/Support/PageStructuredData.php
@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Support;
+
+use App\Models\Page;
+
+class PageStructuredData extends StructuredData
+{
+    public static function forPage(?Page $page, string $pageUrl, ?string $name = null, ?string $description = null): array
+    {
+        $pageName = $name ?: ($page
+            ? (method_exists($page, 'translate')
+                ? ($page->translate('meta_title') ?: $page->translate('title'))
+                : ($page->meta_title ?? $page->title ?? self::siteName()))
+            : self::siteName());
+
+        $pageDescription = $description ?: ($page
+            ? (method_exists($page, 'translate')
+                ? ($page->translate('meta_description') ?: ($page->excerpt ?? null))
+                : ($page->meta_description ?? $page->excerpt ?? null))
+            : setting('seo_meta_description'));
+
+        $webPageExtra = [];
+
+        if ($page?->updated_at) {
+            $webPageExtra['dateModified'] = $page->updated_at->toIso8601String();
+        }
+
+        if ($page?->is_homepage) {
+            $webPageExtra['@type'] = 'WebPage';
+        }
+
+        $graph = [
+            self::websiteNode(),
+            self::organizationNode(),
+            self::webPageNode($pageUrl, $pageName, $pageDescription, $webPageExtra),
+            self::breadcrumbNode($pageUrl, self::breadcrumbItems($page, $pageUrl, $pageName)),
+        ];
+
+        return self::wrap($graph);
+    }
+
+    /**
+     * @return array<int, array{name: string, item: string}>
+     */
+    protected static function breadcrumbItems(?Page $page, string $pageUrl, string $pageName): array
+    {
+        $items = [
+            ['name' => __('pages.breadcrumb_home'), 'item' => self::siteUrl()],
+        ];
+
+        if ($page && !$page->is_homepage) {
+            $items[] = ['name' => $pageName, 'item' => $pageUrl];
+        }
+
+        return $items;
+    }
+}
diff --git a/app/Support/StructuredData.php b/app/Support/StructuredData.php
new file mode 100644
index 0000000..3656938
--- /dev/null
+++ b/app/Support/StructuredData.php
@@ -0,0 +1,149 @@
+<?php
+
+namespace App\Support;
+
+abstract class StructuredData
+{
+    /**
+     * @param  array<int, array<string, mixed>>  $graph
+     * @return array<string, mixed>
+     */
+    protected static function wrap(array $graph): array
+    {
+        return [
+            '@context' => 'https://schema.org',
+            '@graph' => array_values($graph),
+        ];
+    }
+
+    protected static function siteUrl(): string
+    {
+        return url('/');
+    }
+
+    protected static function siteName(): string
+    {
+        return (string) setting('site_name', config('app.name'));
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected static function websiteNode(?string $searchUrlTemplate = null): array
+    {
+        $siteUrl = static::siteUrl();
+        $siteName = static::siteName();
+
+        $node = [
+            '@type' => 'WebSite',
+            '@id' => $siteUrl . '#website',
+            'url' => $siteUrl,
+            'name' => $siteName,
+            'inLanguage' => app()->getLocale(),
+            'publisher' => ['@id' => $siteUrl . '#organization'],
+        ];
+
+        if ($searchUrlTemplate) {
+            $node['potentialAction'] = [
+                '@type' => 'SearchAction',
+                'target' => [
+                    '@type' => 'EntryPoint',
+                    'urlTemplate' => $searchUrlTemplate,
+                ],
+                'query-input' => 'required name=search_term_string',
+            ];
+        }
+
+        return $node;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected static function organizationNode(): array
+    {
+        $siteUrl = static::siteUrl();
+        $siteName = static::siteName();
+
+        $node = [
+            '@type' => 'Organization',
+            '@id' => $siteUrl . '#organization',
+            'name' => $siteName,
+            'url' => $siteUrl,
+        ];
+
+        $logo = setting('site_logo');
+        if ($logo) {
+            $logoUrl = str_starts_with($logo, 'http') ? $logo : asset('storage/' . ltrim($logo, '/'));
+            $node['logo'] = [
+                '@type' => 'ImageObject',
+                'url' => $logoUrl,
+            ];
+        }
+
+        return $node;
+    }
+
+    /**
+     * @param  array<int, array{name: string, item: string}>  $items
+     * @return array<string, mixed>
+     */
+    protected static function breadcrumbNode(string $pageUrl, array $items): array
+    {
+        $elements = [];
+
+        foreach ($items as $index => $item) {
+            $elements[] = [
+                '@type' => 'ListItem',
+                'position' => $index + 1,
+                'name' => $item['name'],
+                'item' => $item['item'],
+            ];
+        }
+
+        return [
+            '@type' => 'BreadcrumbList',
+            '@id' => $pageUrl . '#breadcrumb',
+            'itemListElement' => $elements,
+        ];
+    }
+
+    /**
+     * @param  array<string, mixed>  $extra
+     * @return array<string, mixed>
+     */
+    protected static function webPageNode(
+        string $pageUrl,
+        string $name,
+        ?string $description = null,
+        array $extra = [],
+    ): array {
+        $node = array_merge([
+            '@type' => 'WebPage',
+            '@id' => $pageUrl . '#webpage',
+            'url' => $pageUrl,
+            'name' => $name,
+            'inLanguage' => app()->getLocale(),
+            'isPartOf' => ['@id' => static::siteUrl() . '#website'],
+            'breadcrumb' => ['@id' => $pageUrl . '#breadcrumb'],
+        ], $extra);
+
+        if ($description) {
+            $node['description'] = $description;
+        }
+
+        return $node;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected static function listItem(int $position, array $item): array
+    {
+        return [
+            '@type' => 'ListItem',
+            'position' => $position,
+            'item' => $item,
+        ];
+    }
+}
diff --git a/lang/en/blog.php b/lang/en/blog.php
index 1716975..2b01912 100644
--- a/lang/en/blog.php
+++ b/lang/en/blog.php
@@ -5,6 +5,8 @@ return [
 	'nav-blog' => 'Blog',
 	'meta-index-title' => 'Blog',
 	'meta-index-description' => 'Latest posts',
+	'breadcrumb_home' => 'Home',
+	'default_author' => 'Trunçgil Technology Editor',
 	'empty' => 'No posts yet.',
 
 	// Module labels
diff --git a/lang/en/pages.php b/lang/en/pages.php
index 2067810..682f926 100644
--- a/lang/en/pages.php
+++ b/lang/en/pages.php
@@ -6,6 +6,7 @@ return [
 	'nav-about' => 'About',
 	'nav-services' => 'Services',
 	'nav-contact' => 'Contact',
+	'breadcrumb_home' => 'Home',
 
 	// Module labels
     'title' => 'Pages',
diff --git a/lang/tr/blog.php b/lang/tr/blog.php
index b2fd04b..ede6dc8 100644
--- a/lang/tr/blog.php
+++ b/lang/tr/blog.php
@@ -5,6 +5,8 @@ return [
 	'nav-blog' => 'Blog',
 	'meta-index-title' => 'Blog',
 	'meta-index-description' => 'Güncel paylaşımlarımız',
+	'breadcrumb_home' => 'Ana Sayfa',
+	'default_author' => 'Trunçgil Teknoloji Editörü',
 	'empty' => 'Şu anda blog yazısı bulunmuyor.',
 
 	// Module labels
diff --git a/lang/tr/pages.php b/lang/tr/pages.php
index 7394452..80f5cc2 100644
--- a/lang/tr/pages.php
+++ b/lang/tr/pages.php
@@ -6,6 +6,7 @@ return [
 	'nav-about' => 'Hakkımızda',
 	'nav-services' => 'Hizmetler',
 	'nav-contact' => 'İletişim',
+	'breadcrumb_home' => 'Ana Sayfa',
 
 	// Module labels
     'title' => 'Sayfalar',
diff --git a/resources/views/blog/show.blade.php b/resources/views/blog/show.blade.php
index bae1f2e..d59a950 100644
--- a/resources/views/blog/show.blade.php
+++ b/resources/views/blog/show.blade.php
@@ -405,34 +405,4 @@
   </div>
   <!-- /.container -->
 </section>
-
-@push('scripts')
-<script type="application/ld+json">
-{
-  "@@context": "https://schema.org",
-  "@type": "BlogPosting",
-  "mainEntityOfPage": {
-    "@type": "WebPage",
-    "@id": "{{ route('blog.show', $post->slug) }}"
-  },
-  "headline": "{{ method_exists($post, 'translate') ? $post->translate('title') : $post->title }}",
-  "description": "{{ method_exists($post, 'translate') ? $post->translate('excerpt') : ($post->excerpt ?? '') }}",
-  "image": "{{ $post->featured_image_url ? $post->featured_image_url : asset('assets/img/logo.png') }}",  
-  "author": {
-    "@type": "Person",
-    "name": "{{ $post->author->name ?? 'Trunçgil Teknoloji Editörü' }}"
-  },  
-  "publisher": {
-    "@type": "Organization",
-    "name": "{{ setting('site_name', 'Trunçgil Teknoloji') }}",
-    "logo": {
-      "@type": "ImageObject",
-      "url": "{{ asset('storage/' . setting('site_logo')) }}"
-    }
-  },
-  "datePublished": "{{ $post->published_at ? $post->published_at->toIso8601String() : $post->created_at->toIso8601String() }}",
-  "dateModified": "{{ $post->updated_at->toIso8601String() }}"
-}
-</script>
-@endpush
 @endsection
diff --git a/resources/views/front/music-productions/index.blade.php b/resources/views/front/music-productions/index.blade.php
index acf1fab..02406a3 100644
--- a/resources/views/front/music-productions/index.blade.php
+++ b/resources/views/front/music-productions/index.blade.php
@@ -1,7 +1,5 @@
 @extends('layouts.site')
 
-<x-seo.json-ld :data="$structuredData ?? null" />
-
 @section('content')
 {{-- demo28.html: hero + itemgrid --}}
 <section class="wrapper bg-gradient-blend">
diff --git a/resources/views/front/music-productions/show.blade.php b/resources/views/front/music-productions/show.blade.php
index 96f015d..9676057 100644
--- a/resources/views/front/music-productions/show.blade.php
+++ b/resources/views/front/music-productions/show.blade.php
@@ -1,7 +1,5 @@
 @extends('layouts.site')
 
-<x-seo.json-ld :data="$structuredData ?? null" />
-
 @section('content')
 <section class="wrapper !bg-[#edf2fc]">
   <div class="container pt-10 pb-36 xl:pt-[4.5rem] lg:pt-[4.5rem] md:pt-[4.5rem] xl:pb-60 lg:pb-60 md:pb-60 !text-center">
diff --git a/resources/views/layouts/site.blade.php b/resources/views/layouts/site.blade.php
index 3a584c1..0de0a51 100644
--- a/resources/views/layouts/site.blade.php
+++ b/resources/views/layouts/site.blade.php
@@ -51,6 +51,9 @@ $favicon_path = setting('site_favicon');
 		<meta name="twitter:image:alt" content="{{ $meta['image_alt'] ?? $seo_title }}">
 	@endif
 
+	@if(!empty($structuredData))
+		<x-seo.json-ld :data="$structuredData" />
+	@endif
 	@stack('structured-data')
 
 	<link rel="icon" href="{{ $favicon_path ? (str_starts_with($favicon_path, 'http') ? $favicon_path : asset($favicon_path)) : asset('assets/img/favicon.png') }}">
