Theme Blog
Package docs status
Section titled “Package docs status”This page is generated from package source documentation in the Capell packages repository and the checked-in manifest. Source documentation is not distribution status. Before running a Composer command, verify that the exact package and compatible 1.x release are available through public Packagist or the authenticated marketplace account.
| Field | Value |
|---|---|
| Composer package | capell-app/theme-blog |
| Package slug | theme-blog |
| Product group | Capell Themes |
| Tier | premium |
| Bundle | themes |
| Runtime contexts | frontend |
| Capell version | ^1.0 |
| Catalogue role | extension |
| Release channel | Beta |
| Source repository | capell-app/packages |
| Source path | packages/theme-blog |
| Docs source | packages/theme-blog/docs |
| Manifest | capell.json |
What This Plugin Adds
Section titled “What This Plugin Adds”Theme Blog is an Available, No schema impact Capell theme in the Capell Themes product group. It ships as capell-app/theme-blog and extends these surfaces: frontend.
Theme Blog provides a reading-first Blade presentation with serif typography, publication page patterns, editorial sections, and a focused content measure.
Admins select Blog through theme management, preview it, and adjust shared theme settings. Public pages use its editorial presets and package-owned publication widgets.
Status details:
- Status: Available
- Tier: premium
- Bundle: themes
- Composer package:
capell-app/theme-blog - Namespace:
Capell\ThemeBlog - Theme key:
blog
Why It Matters
Section titled “Why It Matters”For developers: The provider extends the Foundation default theme and registers Blog definitions, presets, assets, and layout-widget renderables through shared registries.
For teams: Writers and publication teams get a consistent long-form reading layout while keeping text and images in normal Capell content records.
Screens And Workflow
Section titled “Screens And Workflow”Screenshot contract: docs/screenshots.json.
Desktop, tablet, and mobile variants remain defined in the screenshot contract; this list groups them by workflow.
- Blog Homepage (frontend, required evidence).
- Blog Directory (frontend, required evidence).
- Blog Detail Article (frontend, required evidence).
- Blog Contact (frontend, supplementary evidence).
- Blog Empty State (frontend, required evidence).
- Blog Page Not Found (frontend, required evidence).
- Blog Call To Action (frontend, required evidence).
Works With
Section titled “Works With”- Newsletter: optional integration backed by the interop evidence map.
Technical Shape
Section titled “Technical Shape”Service providers
Section titled “Service providers”Capell\ThemeBlog\BlogThemeServiceProviderCapell\ThemeBlog\Providers\ConsoleServiceProvider
Actions
Section titled “Actions”InstallBlogThemeDemoAction
Command signatures
Section titled “Command signatures”capell:theme-blog-demo
Console command classes
Section titled “Console command classes”DemoCommand
Manifest contributions
Section titled “Manifest contributions”admin-page: Capell\ThemeBlog\Manifest\ThemeManagementPageContribution
Health checks
Section titled “Health checks”Capell\ThemeBlog\Health\ThemeBlogHealthCheck
Blade views
Section titled “Blade views”packages/theme-blog/resources/views/page.blade.phppackages/theme-blog/resources/views/sections/author-profiles--bibliography.blade.phppackages/theme-blog/resources/views/sections/author-profiles.blade.phppackages/theme-blog/resources/views/sections/content-listing.blade.phppackages/theme-blog/resources/views/sections/contextual-glossary--compact.blade.phppackages/theme-blog/resources/views/sections/contextual-glossary.blade.phppackages/theme-blog/resources/views/sections/cta.blade.phppackages/theme-blog/resources/views/sections/editorial-statement.blade.phppackages/theme-blog/resources/views/sections/essay-index--marginalia.blade.phppackages/theme-blog/resources/views/sections/essay-index.blade.phppackages/theme-blog/resources/views/sections/features.blade.phppackages/theme-blog/resources/views/sections/footer.blade.phppackages/theme-blog/resources/views/sections/hero.blade.phppackages/theme-blog/resources/views/sections/issue-archive.blade.phppackages/theme-blog/resources/views/sections/issue-contents--numbered.blade.phppackages/theme-blog/resources/views/sections/issue-contents.blade.phppackages/theme-blog/resources/views/sections/navigation.blade.phppackages/theme-blog/resources/views/sections/proof.blade.phppackages/theme-blog/resources/views/sections/quote-context--medallion-left.blade.phppackages/theme-blog/resources/views/sections/quote-context.blade.phppackages/theme-blog/resources/views/sections/scroll-position-menu--left-rail.blade.phppackages/theme-blog/resources/views/sections/scroll-position-menu.blade.phppackages/theme-blog/resources/views/sections/serialized-chapters--compact.blade.phppackages/theme-blog/resources/views/sections/serialized-chapters.blade.phppackages/theme-blog/resources/views/sections/subscription-panel.blade.phppackages/theme-blog/resources/views/widget/section.blade.php
Cache tags
Section titled “Cache tags”theme-blog
Data Model
Section titled “Data Model”This theme has no schema impact. It relies on core Capell site, page, locale, and theme records instead of declaring package-owned tables.
Install Impact
Section titled “Install Impact”- Required packages:
capell-app/core,capell-app/theme-foundation,capell-app/frontend. - Admin navigation: declares
admin-page: ThemeManagementPageContribution; each Filament page or resource controls its own navigation visibility. - Admin/editor extensions: none declared.
- Permissions: no package permission declarations or Shield gates detected; host access rules still apply.
- Public routes: none declared.
- Database changes: no package migrations declared.
- Config: no package config files.
- Settings: no package settings declared.
- Queues or schedules: none declared.
- Cache tags:
theme-blog. - Commands:
capell:theme-blog-demo.
Common Pitfalls
Section titled “Common Pitfalls”- Keep required Capell packages on compatible v4 releases:
capell-app/core,capell-app/theme-foundation,capell-app/frontend. - Keep public Blade and cached HTML free of authoring markers, model IDs, permissions, signed editor URLs, and lazy database queries.
- Custom write integrations must preserve invalidation for
theme-blogcache tags.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Likely cause | Check | Fix |
|---|---|---|---|
| Package surface is missing after install | Provider or manifest is not loaded | Confirm capell.json, package composer.json, and provider registration | Reinstall the package, refresh Composer autoload, and clear host caches |
| Public output leaks unexpected state | Render data, cache variation, or authoring boundary has regressed | Check public Blade, cache tags, and public-output safety tests | Move data loading out of Blade and rerun the package public-output tests |
Quick Start
Section titled “Quick Start”- Install the package:
composer require capell-app/theme-blog. - See it working: run
php artisan capell:theme-blog-demo. - Open
/theme-blogand confirm the public output renders without admin state.