capell-app / blog
Premium editorial publishing for Capell: articles, archive and tag pages, related article widgets, multilingual output, and optional growth bridges.
Requires
- php: ^8.4
- capell-app/admin: ^1.0
- capell-app/content-sections: ^1.0
- capell-app/core: ^1.0.21
- capell-app/discovery-foundation: ^1.0
- capell-app/frontend: ^1.0.25
- capell-app/html-cache: ^1.0
- capell-app/layout-builder: ^1.0
- capell-app/tags: ^1.0
Requires (Dev)
None
Suggests
- capell-app/comments: Adds comment threads to published articles.
- capell-app/insights: Adds article traffic reporting and insights widgets.
- capell-app/navigation: Adds Blog pages to configured site navigation menus.
- capell-app/publishing-studio: Adds articles to editorial workspaces and calendars.
- capell-app/site-discovery: Adds article URLs to sitemap outputs.
- capell-app/url-manager: Adds redirect support for changed article URLs.
Provides
None
Conflicts
None
Replaces
None
- 4.x-dev
- 3.x-dev
- dev-main / 1.x-dev
- v1.0.41
- v1.0.40
- v1.0.39
- v1.0.38
- v1.0.37
- v1.0.36
- v1.0.35
- v1.0.34
- v1.0.33
- v1.0.32
- v1.0.31
- v1.0.30
- v1.0.29
- v1.0.28
- v1.0.27
- v1.0.26
- v1.0.25
- v1.0.24
- v1.0.23
- v1.0.22
- v1.0.21
- v1.0.20
- v1.0.19
- v1.0.18
- v1.0.17
- v1.0.16
- v1.0.15
- v1.0.13
- v1.0.11
- v1.0.10
- v1.0.9
- v1.0.8
- v1.0.7
- v1.0.6
- v1.0.5
- v1.0.4
- v1.0.3
- v1.0.2
- v1.0.1
- v1.0.0-beta.2
- v1.0.0-beta.1
- dev-release-backup/v0.0.9-main
- dev-release-backup/v0.0.8-main
This package is auto-updated.
Last update: 2026-09-17 07:51:23 UTC
README
What This Extension Adds
Blog is an Available, Schema-owning Capell package in the Capell Publishing Pro product group. It ships as capell-app/blog and extends these surfaces: admin, frontend, console.
Blog adds premium article publishing, archive pages, tag pages, article widgets, optional discovery and analytics bridges, and frontend Livewire page components to Capell.
After install, admins get package-owned management surfaces and public users may see package-owned frontend output or routes.
Status details:
- Status: Available
- Tier: premium
- Bundle: publishing-pro
- Composer package:
capell-app/blog - Namespace:
Capell\Blog - Theme key: not applicable
Why It Matters
For developers: The package gives developers package-owned service providers, Actions, Data objects, models, Filament classes, and Blade views instead of pushing this behaviour into core or application code.
For teams: Publish articles, archives, tag pages, and related-article widgets with multilingual, multi-site output and optional growth bridges.
Screens And Workflow
Screenshot contract: docs/screenshots.json.
- Articles admin index (admin, required).
- Create/edit article form (admin, required).
- Blog page frontend output (frontend, required).
- Archive page frontend output (frontend, required).
- Tag page frontend output (frontend, required).
Technical Shape
- Service providers:
Capell\Blog\Providers\ConsoleServiceProvider,Capell\Blog\Providers\BlogServiceProvider,Capell\Blog\Providers\AdminServiceProvider,Capell\Blog\Providers\FrontendServiceProvider. - Migrations:
packages/blog/database/migrations/2026_05_10_190842_01_create_articles_table.php. - Models:
Article. - Filament classes:
ArticleSelect,SettingsTab,TagsInput,ArticlePageConfigurator,ArticleWidgetConfigurator,RelatedWidgetConfigurator,ArticleResource,CreateArticle,EditArticle,ListArticles,ArticleForm,ArticlePagesTable,and 4 more. - Livewire components:
Archive,Blog,Tag. - Policies:
ArticlePolicy. - Listeners:
AddBlogPagesToNavigation,ArticleTranslationSavedListener. - Actions:
AssignExampleArticleImageAction,BuildArticleMetaDataAction,BuildBlogFeedXmlAction,BuildBlogResultsViewDataAction,BuildTagListingDataAction,ClearBlogContentCacheAction,ClearBlogTagCacheAction,CreateBlogHeroDemoContentAction,CreateBlogPagesAction,EnsureArticlePublishingDefaultsAction,EnsureBlogPublishingSurfaceAction,GenerateArchiveUrl,and 3 more. - Data objects:
ArchiveLinkData,ArchiveMonthData,ArticleMetaData,ArticleNeighborLinkData,ArticleWidgetRenderData,BlogPublishingSurfaceData,BlogResultItemData,BlogResultsViewData,BlogTagLinkData,BlogWidgetContentData,ArticleHealthData,LanguageCoverageData,and 6 more. - Command signatures:
capell:blog-demo,capell:blog-install,capell:blog-setup. - Console command classes:
CreateBlogPagesCommand,DemoCommand,FakerCommand,HeroDemoCommand,InstallCommand,SetupCommand. - Manifest contributions:
admin-resource: Capell\Blog\Manifest\BlogAdminResourcesContribution,configurator: Capell\Blog\Manifest\BlogConfiguratorsContribution,model: Capell\Blog\Manifest\BlogModelsContribution,page-type: Capell\Blog\Manifest\BlogPageTypesContribution,page-variation: Capell\Blog\Manifest\BlogPageTypesContribution,route: Capell\Blog\Manifest\BlogRoutesContribution. - Health checks:
Capell\Blog\Health\BlogHealthCheck. - Blade views:
packages/blog/resources/views/components/article-meta.blade.php,packages/blog/resources/views/components/asset-after-title.blade.php,packages/blog/resources/views/components/footer/pages.blade.php,packages/blog/resources/views/components/footer/tags.blade.php,packages/blog/resources/views/components/page/author.blade.php,packages/blog/resources/views/components/page/published-date.blade.php,packages/blog/resources/views/components/page/tags.blade.php,packages/blog/resources/views/components/tag.blade.php,packages/blog/resources/views/components/widget/page/archives.blade.php,packages/blog/resources/views/components/widget/page/article.blade.php,packages/blog/resources/views/components/widget/tag/tags.blade.php,packages/blog/resources/views/filament/widgets/article-health.blade.php,and 4 more. - Cache tags:
blog.
Data Model
- Models:
Article. - Migration files:
2026_05_10_190842_01_create_articles_table.php. - Migration impact: run host migrations through the package install flow before opening package surfaces.
- Deletion/retention behaviour: Docs gap unless the package has an explicit pruning command, retention setting, or tested cascade path.
Install Impact
- Admin navigation: adds package-owned Filament classes when registered.
- Permissions:
article.view,article.create,article.update,article.delete,article.restore,article.force_delete,tag.view,tag.create,tag.update,tag.delete,tag.restore,tag.force_delete. - Public routes: none detected in package route files.
- Database changes: package migrations are declared.
- Settings: no package settings declared.
- Queues or schedules: none detected in standard package paths.
- Cache tags:
blog. - Commands:
capell:blog-demo,capell:blog-install,capell:blog-setup.
Common Pitfalls
- Run migrations before opening package resources or public routes.
- Keep public Blade and cached HTML free of authoring markers, model IDs, permissions, signed editor URLs, and lazy database queries.
- Run package commands from the host app; in this repository use
vendor/bin/pestfor package tests. - Keep
composer.json,composer.local.json,capell.json, docs, screenshots, and tests aligned when the package surface changes.
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 |
| Admin screen or command fails on missing table | Package migrations have not run | Check the tables listed in Data Model |
Run host migrations and rerun the focused package test |
| Background work does not run | Queue worker or scheduled command is not active | Check package jobs, commands, and host scheduler configuration | Start the queue or scheduler, then run the focused command or package test |
| 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
- Install the package:
composer require capell-app/blog. - Run the required setup:
php artisan capell:blog-setup. - Open the related Capell admin surface and verify Blog appears.
Next Steps
- Package docs
- Overview
- Screenshot contract
- Marketplace assets
- Capell content language plan
- Capell documentation design system
- Capell and package ERD notes
- Related packages: Content Sections, Html Cache, Layout Builder, Navigation, Tags, Comments, Insights, Publishing Studio, Site Discovery, Url Manager.
- Focused tests:
vendor/bin/pest packages/blog/tests --configuration=phpunit.xml.