Laravel Sabhero Wrapper Laravel Package

Getting Started

• Install via Composer: composer require fuelviews/laravel-sabhero-wrapper
• Publish config and migrations: php artisan vendor:publish --provider="Fuelviews\SabheroWrapper\SabheroWrapperServiceProvider"
• Run migrations: php artisan migrate
• First use case: create a page with a feature image using the provided model or facade. Start by reviewing config/sabhero.php and the Sabhero facade to understand available methods.

Implementation Patterns

• Resolve the Sabhero service via dependency injection or use the Sabhero facade for page management.
• Extend the provided Page model to add custom attributes or relationships; use the repository pattern for complex queries.
• Render pages in Blade using the package’s helpers or components, referencing page_feature_image for the image URL.
• Publish and customize views when you need to tailor the front-end output.
• Common workflow: seed pages with feature images using the package’s media handling, cache rendered pages for performance, and use model events to hook into page creation/update.

Gotchas and Tips

• Breaking change in v2.1.0: feature_image was renamed to page_feature_image across code and database schema. Update any custom migrations, model attributes, queries, API resources, and views that reference the old column. Re-run migrations after updating.
• Check published config and migration files for stale references; republish or manually adjust them.
• Debug column name issues by inspecting the schema (php artisan db:table pages) and enabling Laravel’s query log.
• Extension points: override the Page model via config, publish and modify migrations, or use model events to inject custom logic.
• Tip: leverage the package’s built-in image handling to avoid manual upload logic; ensure php artisan storage:link is run if storing images locally.