[2.x] Dynamic blogging related page generation

packages/framework/resources/views/components/article-excerpt.blade.php

@@ -9,6 +9,10 @@
          <meta itemprop="image" content="{{ $post->image }}">
     @endif
 
+    @isset($post->image)
+        <meta itemprop="image" content="{{ $post->image }}">
+    @endisset
+
     <header>
         <a href="{{ $post->getRoute() }}" class="block w-fit">
             <h2 itemprop="headline" class="text-2xl font-bold text-gray-700 hover:text-gray-900 dark:text-gray-200 dark:hover:text-white transition-colors duration-75">
@@ -25,18 +29,18 @@
         @endisset
         @isset($post->author)
         <span itemprop="author" itemscope itemtype="https://schema.org/Person">
-            <span class="opacity-75">by</span>
+            <span class="opacity-75">{{ isset($post->date) ? 'by' : 'By'}}</span>
             <span itemprop="name">
-                {{ $post->author->name ?? $post->author->username }}
+                {{ $post->author->name }}
             </span>
         </span>
         @endisset
     </footer>
 
-    @if($post->data('description') !== null)
+    @isset($post->description)
         <section role="doc-abstract" aria-label="Excerpt">
             <p itemprop="description" class="leading-relaxed my-1">
-                {{ $post->data('description') }}
+                {{ $post->description }}
             </p>
         </section>
     @endisset

packages/framework/resources/views/components/post/author.blade.php

@@ -1,4 +1,4 @@
-by author
+{{ isset($page->date) ? 'by' : 'By'}} author
 <address itemprop="author" itemscope itemtype="https://schema.org/Person" aria-label="The post author" style="display: inline;">
     @if($page->author->website)
         <a href="{{ $page->author->website }}" rel="author" itemprop="url" aria-label="The author's website">

packages/framework/resources/views/pages/author.blade.php

@@ -0,0 +1,37 @@
+@props([/** @var \Hyde\Framework\Features\Blogging\Models\PostAuthor */ 'author'])
+@use('Hyde\Framework\Features\Blogging\DynamicPages\PostAuthorPage')
+@use('Hyde\Framework\Features\Blogging\DynamicPages\PostAuthorsPage')
+@extends('hyde::layouts.app')
+@section('content')
+
+    <main id="content" class="mx-auto max-w-7xl py-16 px-8" itemscope itemtype="https://schema.org/ProfilePage">
+        <div class="flex flex-col items-center" itemprop="mainEntity" itemscope itemtype="https://schema.org/Person">
+            @if($author->avatar)
+                <img src="{{ asset($author->avatar) }}" alt="{{ $author->name }}" class="w-32 h-32 rounded-full mb-4" itemprop="image">
+            @endif
+            <h1 class="text-3xl font-bold mb-2 text-gray-900 dark:text-white" itemprop="name">{{ $author->name }}</h1>
+            @if($author->bio)
+                <p class="text-gray-600 dark:text-gray-300 mb-4" itemprop="description">{{ $author->bio }}</p>
+            @endif
+            @if($author->website)
+                <a href="{{ $author->website }}" class="text-blue-600 dark:text-blue-400 hover:underline mb-4" itemprop="url">Website</a>
+            @endif
+            @if($author->socials)
+                <div class="flex space-x-4 mb-6">
+                    @foreach($author->socials as $platform => $handle)
+                        <a href="https://{{ $platform }}.com/{{ $handle }}" class="text-gray-600 dark:text-gray-300 hover:text-gray-800 dark:hover:text-white" itemprop="sameAs">
+                            {{ ucfirst($platform) }}
+                        </a>
+                    @endforeach
+                </div>
+            @endif
+        </div>
+
+        <div class="mt-12">
+            <h2 class="text-2xl font-semibold mb-4 text-gray-900 dark:text-white">Posts by {{ $author->name }}</h2>
+            <ul class="space-y-4">
+                @include('hyde::components.blog-post-feed', ['posts' => $author->getPosts()])
+            </ul>
+        </div>
+    </main>
+@endsection

packages/framework/resources/views/pages/authors.blade.php

@@ -0,0 +1,41 @@
+@props([/** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Blogging\Models\PostAuthor> */ 'authors'])
+@use('Illuminate\Support\Str')
+@extends('hyde::layouts.app')
+@section('content')
+    @php
+        // If any author has an avatar, we'll use avatars for all authors, so the layout looks consistent.
+        $usesAvatars = $authors->contains(fn ($author) => $author->avatar);
+        // The avatar fallback can be changed here (and it also works if a set avatar can't be loaded).
+        $avatarFallback = Asset::hasMediaFile('avatar.png') ? Asset::mediaLink('avatar.png') : 'https://cdn.jsdelivr.net/gh/hydephp/cdn-static@master/avatar.png';
+    @endphp
+
+    <main id="content" class="mx-auto max-w-7xl py-16 px-8">
+        <header class="mb-8">
+            <h1 class="text-center text-3xl font-bold">Our Authors</h1>
+        </header>
+
+        <section class="flex flex-wrap justify-center gap-8">
+            @foreach($authors as $author)
+                <article class="bg-white dark:bg-gray-800 p-6 rounded-lg shadow-md w-full md:w-1/2 lg:w-1/3" itemscope itemtype="https://schema.org/Person">
+                    <header class="flex flex-col items-center">
+                        @if($usesAvatars)
+                            <img src="{{ asset($author->avatar ?? $avatarFallback) }}" alt="{{ $author->name }}" class="w-24 h-24 rounded-full mb-4" itemprop="image" onerror="this.onerror=null; this.src='{{ $avatarFallback }}'">
+                        @endif
+                        <h2 class="text-xl font-semibold mb-2 text-gray-900 dark:text-white" itemprop="name">{{ $author->name }}</h2>
+                    </header>
+                    @if($author->bio)
+                        <p class="text-gray-600 dark:text-gray-300 mb-4 text-center" itemprop="description">{{ Str::limit($author->bio, 100) }}</p>
+                    @endif
+                    <nav>
+                        <a href="{{ route(\Hyde\Framework\Features\Blogging\BlogPostAuthorPages::authorBaseRouteKey()."/$author->username") }}" class="text-blue-600 dark:text-blue-400 hover:underline" itemprop="url">View Profile</a>
+                    </nav>
+                    <footer class="mt-4">
+                        <p class="text-sm text-gray-500 dark:text-gray-400">
+                            {{ $author->getPosts()->count() }} {{ Str::plural('post', $author->getPosts()->count()) }}
+                        </p>
+                    </footer>
+                </article>
+            @endforeach
+        </section>
+    </main>
+@endsection

packages/framework/src/Foundation/HydeCoreExtension.php

@@ -12,6 +12,7 @@
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Foundation\Concerns\HydeExtension;
 use Hyde\Facades\Features;
+use Hyde\Framework\Features\Blogging\BlogPostAuthorPages;
 use Hyde\Framework\Features\Documentation\DocumentationSearchPage;
 use Hyde\Framework\Features\Documentation\DocumentationSearchIndex;
 
@@ -41,5 +42,11 @@ public function discoverPages(PageCollection $collection): void
                 $collection->addPage(new DocumentationSearchPage());
             }
         }
+
+        if (BlogPostAuthorPages::canGenerateAuthorPages()) {
+            foreach (BlogPostAuthorPages::generateAuthorPages() as $page) {
+                $collection->addPage($page);
+            }
+        }
     }
 }

packages/framework/src/Framework/Features/Blogging/BlogPostAuthorPages.php

@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Blogging;
+
+use Hyde\Hyde;
+use Hyde\Enums\Feature;
+use Hyde\Pages\MarkdownPost;
+use Hyde\Framework\Features\Blogging\Models\PostAuthor;
+use Hyde\Framework\Features\Blogging\DynamicPages\PostAuthorPage;
+use Hyde\Framework\Features\Blogging\DynamicPages\PostAuthorsPage;
+
+/**
+ * General helper class for the dynamic blog post author pages feature.
+ *
+ * @internal Initial class to help with dynamic blogging related pages, like author pages, tag pages, etc.
+ *
+ * @experimental The code here will later be moved to a more appropriate place.
+ */
+class BlogPostAuthorPages
+{
+    public static function canGenerateAuthorPages(): bool
+    {
+        // Todo: Also check that this feature is enabled
+
+        return Hyde::hasFeature(Feature::MarkdownPosts)
+            && MarkdownPost::all()->isNotEmpty()
+            && Hyde::authors()->filter(fn (PostAuthor $author): bool => $author->getPosts()->isNotEmpty())->isNotEmpty();
+    }
+
+    /** @return array<\Hyde\Framework\Features\Blogging\DynamicPages\PostAuthorPage> */
+    public static function generateAuthorPages(): array
+    {
+        // Todo: This does not find authors that have no author config, we should add those to the underlying collection!
+
+        $authors = Hyde::authors()
+            // This filtering is opinionated, and we can configure it, but for now it only includes authors with posts
+            // Todo: Unless the "guest" author has been modified, we should filter that too
+            ->filter(fn (PostAuthor $author): bool => $author->getPosts()->isNotEmpty());
+
+        return $authors
+            ->map(fn (PostAuthor $author): PostAuthorPage => new PostAuthorPage($author))
+            ->prepend(new PostAuthorsPage($authors))
+            ->all();
+    }
+
+    public static function authorBaseRouteKey(): string
+    {
+        // Todo: Allow customizing this
+        // Todo: Set author base key in the page class
+
+        return 'authors';
+    }
+
+    /**
+     * Set the base directory for the author pages. Defaults to 'authors'.
+     *
+     * @experimental
+     *
+     * @codeCoverageIgnore
+     */
+    public static function setAuthorBaseRouteKey(string $key): void
+    {
+        PostAuthorsPage::$sourceDirectory = $key;
+        PostAuthorsPage::$outputDirectory = $key;
+        PostAuthorPage::$sourceDirectory = $key;
+        PostAuthorPage::$outputDirectory = $key;
+    }
+}

packages/framework/src/Framework/Features/Blogging/DynamicPages/PostAuthorPage.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Blogging\DynamicPages;
+
+use Hyde\Pages\InMemoryPage;
+use Hyde\Framework\Features\Blogging\Models\PostAuthor;
+
+/**
+ * @experimental
+ *
+ * @see \Hyde\Framework\Features\Blogging\BlogPostAuthorPages Which generates these pages.
+ * @see \Hyde\Framework\Features\Blogging\DynamicPages\PostAuthorsPage For the index page of all authors.
+ */
+class PostAuthorPage extends InMemoryPage
+{
+    protected PostAuthor $author;
+
+    public static string $sourceDirectory = 'authors';
+    public static string $outputDirectory = 'authors';
+    public static string $layout = 'hyde::pages.author';
+
+    public function __construct(PostAuthor $author)
+    {
+        parent::__construct($author->username, [
+            'author' => $author,
+            'title' => $author->name,
+            'navigation' => [
+                'visible' => PostAuthorsPage::$showInNavigation,
+            ],
+        ]);
+    }
+
+    public function getBladeView(): string
+    {
+        return static::$layout;
+    }
+}

packages/framework/src/Framework/Features/Blogging/DynamicPages/PostAuthorsPage.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Blogging\DynamicPages;
+
+use Hyde\Pages\InMemoryPage;
+use Illuminate\Support\Collection;
+
+/**
+ * @experimental
+ *
+ * @see \Hyde\Framework\Features\Blogging\BlogPostAuthorPages Which generates these pages.
+ * @see \Hyde\Framework\Features\Blogging\DynamicPages\PostAuthorPage For the individual author pages.
+ */
+class PostAuthorsPage extends InMemoryPage
+{
+    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Blogging\Models\PostAuthor> */
+    protected Collection $authors;
+
+    public static string $sourceDirectory = 'authors';
+    public static string $outputDirectory = 'authors';
+    public static string $layout = 'hyde::pages.authors';
+    public static bool $showInNavigation = false;
+
+    public function __construct(Collection $authors)
+    {
+        parent::__construct('index', [
+            'authors' => $authors,
+            'title' => 'Authors',
+            'navigation' => [
+                'visible' => static::$showInNavigation,
+            ],
+        ]);
+
+        $this->authors = $authors;
+    }
+
+    public function getBladeView(): string
+    {
+        return static::$layout;
+    }
+}

packages/framework/src/Support/Models/Route.php

@@ -39,12 +39,24 @@ public function __toString(): string
 
     /**
      * Generate a link to the route destination, relative to the current route, and supports pretty URLs.
+     *
+     * This is the recommended method to use when generating links to other pages in your site.
      */
     public function getLink(): string
     {
         return Hyde::relativeLink($this->page->getLink());
     }
 
+    /**
+     * Get the canonical URL for the route, if a site URL is set, falling back to a relative link.
+     *
+     * While this can decrease portability, it can be useful for SEO purposes when used correctly.
+     */
+    public function getUrl(): string
+    {
+        return $this->page->getCanonicalUrl() ?? $this->getLink();
+    }
+
     public function getPage(): HydePage
     {
         return $this->page;