113 lines
4.6 KiB
Markdown
113 lines
4.6 KiB
Markdown
# SEO Audit System v1 Summary
|
|
|
|
## Changed Areas
|
|
|
|
- Added shared SEO support under `app/Support/Seo/`
|
|
- Added shared Blade SEO renderer in `resources/views/partials/seo/head.blade.php`
|
|
- Added shared Inertia SEO renderer in `resources/js/components/seo/SeoHead.jsx`
|
|
- Updated layout integration in `resources/views/layouts/nova.blade.php` and `resources/views/layouts/_legacy.blade.php`
|
|
- Wired major public controllers and views across homepage, artworks, browse/discover, categories, tags, profiles, collections, leaderboard, blog, stories, news, Nova Cards, community/gallery pages, and static/footer pages
|
|
- Added and updated feature tests for key public SEO surfaces
|
|
|
|
## SEO Architecture Introduced
|
|
|
|
### Core files
|
|
|
|
- `config/seo.php`
|
|
- `app/Support/Seo/SeoData.php`
|
|
- `app/Support/Seo/BreadcrumbTrail.php`
|
|
- `app/Support/Seo/SeoDataBuilder.php`
|
|
- `app/Support/Seo/SeoFactory.php`
|
|
- `resources/views/partials/seo/head.blade.php`
|
|
- `resources/js/components/seo/SeoHead.jsx`
|
|
|
|
### Contract
|
|
|
|
- Controllers and pages can pass a normalized `seo` payload explicitly
|
|
- Blade layouts can also normalize legacy `page_*` and `meta.*` data through `SeoFactory::fromViewData()`
|
|
- `useUnifiedSeo` is the opt-in switch for the shared renderer
|
|
- JSON-LD, Open Graph, Twitter tags, canonical tags, robots, breadcrumbs, and optional keywords are emitted from one place
|
|
|
|
## Supported Page Types
|
|
|
|
Explicitly covered or normalized through the shared system:
|
|
|
|
- Homepage
|
|
- Artwork detail pages
|
|
- Explore / browse / discover pages
|
|
- Category pages
|
|
- Tag pages
|
|
- Creator / profile pages
|
|
- Collection listing and collection detail pages
|
|
- Leaderboard pages
|
|
- Blog pages
|
|
- Stories pages
|
|
- News pages
|
|
- Public Nova Cards pages
|
|
- FAQ, rules, privacy, terms, about/help/contact/legal, staff, RSS feeds, and other public static/footer pages
|
|
- Community / gallery-style public pages such as latest uploads, featured artworks, member photos, downloads today, comments latest, and monthly commentators
|
|
|
|
## Title / Description / Canonical / OG Strategy
|
|
|
|
- Title and description generation is page-type-aware where the app has a dedicated resolver
|
|
- Legacy pages still normalize cleanly through fallback mapping of `page_title`, `page_meta_description`, `page_canonical`, `page_robots`, and `meta.*`
|
|
- Canonicals are generated with Laravel route and URL helpers rather than hardcoded hosts
|
|
- Open Graph and Twitter tags are standardized through the shared renderer
|
|
- Fallback OG images resolve from page data first, then from configured defaults
|
|
- Search and low-value pages can be marked noindex through the same DTO/builder contract
|
|
|
|
## Structured Data Added
|
|
|
|
JSON-LD is emitted centrally and currently supports the main public shapes used by the site:
|
|
|
|
- `WebSite`
|
|
- `BreadcrumbList`
|
|
- `CollectionPage`
|
|
- `ProfilePage`
|
|
- `FAQPage`
|
|
- `ImageObject`
|
|
- `CreativeWork`
|
|
- `Article`
|
|
|
|
Schema is added only where it matches visible page content.
|
|
|
|
## Indexing / Robots Decisions
|
|
|
|
- Public canonical pages default to `index,follow`
|
|
- Search and similar low-value surfaces can be marked noindex through the shared builder
|
|
- Private/internal pages remain outside the shared public SEO rollout
|
|
- The system is structured to align with future sitemap generation through canonical/indexable page types
|
|
|
|
## Breadcrumb / Internal Linking Fixes
|
|
|
|
- Added `BreadcrumbTrail` normalization
|
|
- Removed duplicate `Home > Home` style breadcrumb issues
|
|
- Ensured breadcrumb JSON-LD is emitted once through the shared renderer when breadcrumbs exist
|
|
|
|
## Tests Added / Updated
|
|
|
|
Key coverage includes:
|
|
|
|
- `tests/Feature/HomePageTest.php`
|
|
- `tests/Feature/FooterPagesTest.php`
|
|
- `tests/Feature/Collections/CollectionsV5FeatureTest.php`
|
|
- `tests/Feature/LeaderboardPageTest.php`
|
|
- `tests/Feature/RoutingUnificationTest.php`
|
|
- `tests/Feature/Stories/CreatorStoryWorkflowTest.php`
|
|
- `tests/Feature/NovaCards/NovaCardPublicPagesTest.php`
|
|
- `tests/Feature/ArtworkJsonLdTest.php`
|
|
- `tests/Feature/TagPageTest.php`
|
|
- `tests/Feature/BrowseApiTest.php`
|
|
|
|
These tests cover canonical tags, JSON-LD, OG output, no-duplicate-head regressions, and core public page availability.
|
|
|
|
## Follow-up Recommendations
|
|
|
|
### SEO v2
|
|
|
|
- Add a formal sitemap generator built directly from the canonical/indexable page-type contract
|
|
- Expand explicit page-type resolver methods for the remaining lower-value legacy pages that still rely on fallback normalization
|
|
- Add broader page-family assertions for static pages, news/tag/category pages, and community gallery pages
|
|
- Add snapshot-style tests for the shared head output if head regressions become frequent
|
|
- Consider central reporting for pages with fallback-only metadata so future migrations are easier to track
|