PHPackages artisanpack-ui/seo - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. artisanpack-ui/seo ActiveLibrary[Utility & Helpers](/categories/utility) artisanpack-ui/seo ================== SEO utilities and meta tag management for Laravel applications 1.1.1(3w ago)072[1 issues](https://github.com/ArtisanPack-UI/seo/issues)MITPHPPHP ^8.2CI passing Since Jan 18Pushed 3w agoCompare [ Source](https://github.com/ArtisanPack-UI/seo)[ Packagist](https://packagist.org/packages/artisanpack-ui/seo)[ RSS](/packages/artisanpack-ui-seo/feed)WikiDiscussions main Synced today READMEChangelog (4)Dependencies (33)Versions (7)Used By (0) ArtisanPack UI SEO ================== [](#artisanpack-ui-seo) ArtisanPack UI SEO is a comprehensive SEO management package for Laravel applications. Built on Livewire 3, it provides complete control over meta tags, Open Graph, Twitter Cards, Schema.org markup, XML sitemaps, URL redirects, robots.txt generation, and SEO content analysis. Quick Start ----------- [](#quick-start) ### Installation [](#installation) ``` # Install the package composer require artisanpack-ui/seo # Run migrations php artisan migrate # Publish configuration (optional) php artisan vendor:publish --tag=seo-config ``` ### Basic Usage [](#basic-usage) ``` // Add the HasSeo trait to your model use ArtisanPackUI\Seo\Traits\HasSeo; class Post extends Model { use HasSeo; } ``` ``` ``` Key Features ------------ [](#key-features) - **Meta Tag Management**: Title, description, robots directives, and canonical URLs with automatic fallbacks - **Social Media Tags**: Open Graph for Facebook/LinkedIn and Twitter Cards with image support - **Schema.org Markup**: 14 built-in JSON-LD schema types for rich search results - **Multi-Language Support**: Hreflang tags for international SEO - **URL Redirects**: Exact, regex, and wildcard redirects with hit tracking - **XML Sitemaps**: Standard, image, video, and news sitemaps with automatic indexing - **Dynamic Robots.txt**: Configurable rules with bot-specific directives - **SEO Analysis**: 8 built-in analyzers for content quality scoring - **Performance Caching**: Comprehensive caching for meta tags, sitemaps, and redirects - **Admin Components**: Livewire components for visual SEO management Components ---------- [](#components) ### Blade Components [](#blade-components) ComponentPurpose``All-in-one SEO output (meta, OG, Twitter, schema)``Basic meta tags only``Open Graph tags for social sharing``Twitter Card meta tags``Schema.org JSON-LD markup``Hreflang link tags for multi-language### Livewire Components [](#livewire-components) ComponentPurpose``Full SEO editing interface with tabs``URL redirect management``SEO overview and statistics``Content analysis results``Multi-language URL editor``Search result preview``Social share preview### Schema Types [](#schema-types) Article, BlogPosting, Product, Organization, Person, LocalBusiness, Event, Recipe, FAQPage, HowTo, BreadcrumbList, WebSite, WebPage, VideoObject Documentation ------------- [](#documentation) Comprehensive documentation is available at [docs.artisanpackui.dev](https://docs.artisanpackui.dev): - **[Getting Started](https://docs.artisanpackui.dev/seo/getting-started)** - Quick start guide - **[Installation](https://docs.artisanpackui.dev/seo/installation)** - Detailed setup instructions - **[Configuration](https://docs.artisanpackui.dev/seo/installation/configuration)** - All configuration options - **[Meta Tags](https://docs.artisanpackui.dev/seo/usage/meta-tags)** - Meta tag management - **[Social Media](https://docs.artisanpackui.dev/seo/usage/social-media)** - Open Graph and Twitter Cards - **[Schema.org](https://docs.artisanpackui.dev/seo/usage/schema)** - Structured data markup - **[Components](https://docs.artisanpackui.dev/seo/components)** - Blade and Livewire components - **[API Reference](https://docs.artisanpackui.dev/seo/api)** - Models, services, and events Configuration ------------- [](#configuration) Publish the configuration file: ``` php artisan vendor:publish --tag=seo-config ``` ### Key Configuration Options [](#key-configuration-options) ``` // config/seo.php return [ // Site defaults 'site' => [ 'name' => env('APP_NAME'), 'separator' => ' | ', ], // Default meta values 'defaults' => [ 'title' => null, 'description' => null, 'image' => null, 'robots' => 'index, follow', ], // Feature toggles 'redirects' => ['enabled' => true], 'sitemap' => ['enabled' => true], 'robots' => ['enabled' => true], 'analysis' => ['enabled' => true], // Caching 'cache' => [ 'enabled' => true, 'driver' => null, // Uses default cache driver 'ttl' => 3600, ], // Routes 'routes' => [ 'sitemap' => true, 'robots' => true, ], ]; ``` ### Environment Variables [](#environment-variables) VariableDescriptionDefault`SEO_SITE_NAME`Site name for titles`APP_NAME``SEO_TITLE_SEPARATOR`Separator between title and site name`|``SEO_DEFAULT_ROBOTS`Default robots directive`index, follow``SEO_CACHE_ENABLED`Enable SEO caching`true``SEO_CACHE_TTL`Cache TTL in seconds`3600``SEO_REDIRECTS_ENABLED`Enable redirect handling`true``SEO_SITEMAP_ENABLED`Enable sitemap generation`true``SEO_ANALYSIS_ENABLED`Enable SEO analysis`true`Artisan Commands ---------------- [](#artisan-commands) ``` # Generate XML sitemap php artisan seo:generate-sitemap # Submit sitemap to search engines php artisan seo:submit-sitemap # Clear SEO cache php artisan seo:clear-cache ``` Requirements ------------ [](#requirements) - PHP 8.2 or higher - Laravel 10, 11, 12, or 13 - Livewire 3.6+ Dependencies ------------ [](#dependencies) This package integrates with the ArtisanPack UI ecosystem: - [artisanpack-ui/core](https://github.com/ArtisanPack-UI/core) - Core utilities - [artisanpack-ui/livewire-ui-components](https://github.com/ArtisanPack-UI/livewire-ui-components) - UI components - [artisanpack-ui/hooks](https://github.com/ArtisanPack-UI/hooks) - WordPress-style hooks for extensibility Events ------ [](#events) The package dispatches events for key actions: ``` use ArtisanPackUI\Seo\Events\SeoMetaCreated; use ArtisanPackUI\Seo\Events\SeoMetaUpdated; use ArtisanPackUI\Seo\Events\SitemapGenerated; use ArtisanPackUI\Seo\Events\RedirectHit; // Listen for SEO meta changes Event::listen(SeoMetaUpdated::class, function ($event) { // $event->seoMeta contains the updated meta // $event->model contains the associated model }); // Listen for redirect hits Event::listen(RedirectHit::class, function ($event) { // $event->redirect contains the redirect record // $event->request contains the HTTP request }); ``` Helper Functions ---------------- [](#helper-functions) ``` // Get the SEO service $seo = seo(); // Get SEO meta for a model $meta = seoMeta($post); // Format a page title with site name $title = seoTitle('My Page'); // "My Page | Site Name" // Truncate description to SEO length $desc = seoDescription($longText); // Truncated to 160 chars // Check if a feature is enabled if (seoIsEnabled('sitemap')) { // Generate sitemap } // Get configuration value $separator = seoConfig('site.separator'); ``` Extensibility ------------- [](#extensibility) ### Custom Schema Types [](#custom-schema-types) ``` use ArtisanPackUI\Seo\Contracts\SchemaBuilderInterface; class CustomSchemaBuilder implements SchemaBuilderInterface { public function build($model, array $data = []): array { return [ '@context' => 'https://schema.org', '@type' => 'CustomType', // ... custom properties ]; } } // Register via service provider $this->app->bind('seo.schema.custom', CustomSchemaBuilder::class); ``` ### Custom Analyzers [](#custom-analyzers) ``` use ArtisanPackUI\Seo\Contracts\AnalyzerInterface; class CustomAnalyzer implements AnalyzerInterface { public function analyze($model): array { return [ 'score' => 85, 'status' => 'good', 'message' => 'Content passes custom analysis.', 'suggestions' => [], ]; } } ``` ### Filter Hooks [](#filter-hooks) ``` use function addFilter; // Modify meta tags before output addFilter('seo.meta_tags', function (array $tags, $model) { $tags['custom-meta'] = 'Custom value'; return $tags; }); // Add custom sitemap entries addFilter('seo.sitemap_entries', function (Collection $entries) { $entries->push(new CustomSitemapEntry()); return $entries; }); ``` Middleware ---------- [](#middleware) Add the redirect middleware to handle URL redirects: ``` // In bootstrap/app.php ->withMiddleware(function (Middleware $middleware) { $middleware->web(append: [ \ArtisanPackUI\Seo\Http\Middleware\HandleRedirects::class, ]); }) ``` Contributing ------------ [](#contributing) Contributions are welcome! To contribute: 1. Fork the repository 2. Create your feature branch (`git checkout -b feature/amazing-feature`) 3. Commit your changes (`git commit -m 'Add some amazing feature'`) 4. Push to the branch (`git push origin feature/amazing-feature`) 5. Open a Merge Request Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting merge requests. License ------- [](#license) ArtisanPack UI SEO is open-sourced software licensed under the [MIT license](LICENSE). ### Health Score 44 ↑ FairBetter than 90% of packages Maintenance95 Actively maintained with recent releases Popularity12 Limited adoption so far Community6 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~68 days Total 3 Last Release 24d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/ba2a2c40c9a93470595cd10701d2291434f3a7db61862d9700a9e69e31608c6c?d=identicon)[JacobMartellaWebDesign](/maintainers/JacobMartellaWebDesign) --- Top Contributors [![ViewFromTheBox](https://avatars.githubusercontent.com/u/8247489?v=4)](https://github.com/ViewFromTheBox "ViewFromTheBox (48 commits)") --- Tags laravellaravel-packagemeta-tagsopengraphphpschema-markupseositemap ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/artisanpack-ui-seo/health.svg) ``` [![Health](https://phpackages.com/badges/artisanpack-ui-seo/health.svg)](https://phpackages.com/packages/artisanpack-ui-seo) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed Laravel Page Speed 2.5k1.7M11](/packages/renatomarinho-laravel-page-speed)[illuminate/pagination The Illuminate Pagination package. 12234.1M1.0k](/packages/illuminate-pagination)[illuminate/pipeline The Illuminate Pipeline package. 9349.2M282](/packages/illuminate-pipeline)[illuminate/redis The Illuminate Redis package. 8314.6M375](/packages/illuminate-redis)[illuminate/cookie The Illuminate Cookie package. 244.6M136](/packages/illuminate-cookie) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)