README

A modern Laravel SEO management package with:

📊 Tailwind UI backend for managing SEO meta data
🌐 OpenGraph & Twitter Card support out of the box
⚡ Blade helpers for easy rendering in views

📖 Documentation: Complete Guide to Laravel SEO Solution

🚀 Requirements

PHP 8.0+
Laravel 9.x / 10.x / 11.x / 12.x
Database supported by Laravel (MySQL, PostgreSQL, SQLite, etc.)
Node & NPM (if you want to customize/publish Tailwind UI)

📦 Installation

Require the package:

composer require areia-lab/laravel-seo-solution

Publish config & migrate:

php artisan vendor:publish --tag=seo-config

php artisan vendor:publish --tag=seo-migrations

php artisan migrate

Publish views:

php artisan vendor:publish --tag=seo-views

⚙️ Configuration

The config file config/seo.php contains:

return [
    'route' => [
        'prefix' => env('SEO_PANEL_PREFIX', 'admin/seo'),
        'middleware' => ['web'],
    ],
    'disk' => env('SEO_DISK', 'public'),
    'defaults' => [
        'title_suffix' => '',
    ],
    'cache' => false,

    'panel' => [
        'title_prefix'  => 'Areia Lab SEO'
    ],
];

Change prefix or middleware as needed.
Run php artisan storage:link so uploaded OG/Twitter images are accessible.

🖥️ Admin Panel

Manage SEO meta records via:

/admin/seo

Features:

Types: global, page, model
Meta: title, description, keywords, author, robots, canonical
OpenGraph: title, description, type, image
Twitter: title, description, card, image

📝 Usage in Blade

Place directives inside your layout <head> section. Remove <title> (tag) or <title>{{ config('app.name', 'Laravel') }}</title> (this line) from your layout<head> section.

1. Global

@seoGlobal

or:

{!! app('seo')->global()->render() !!}

2. Page-specific

@seoAutoPage

@seoPage('contact') // Using Route Name. e.g. "->name('contact')"

# or

@seoPage('contact-us') // Using URL Slug. e.g. "/contact-us"

or:

{!! app('seo')->forPage('contact')->render() !!}

# or

{!! app('seo')->forPage('contact-us')->render() !!}

3. Model-based (e.g. Blog Post)

@php
$post = Post::first();
@endphp

@seoModel($post)

or:

@php
$post = Post::first();
@endphp

{!! app('seo')->forModel($post)->render() !!}

✅ All Together in Layout

<head>
  @seoGlobal

  @seoAutoPage // This blade derivative is recommaded
  # or
  @isset($pageKey)
    @seoPage($pageKey) // Pass Data from blade. If Data changed from pannel it may not work. you need to fix statically
  @endisset
  # or
  @seoPage(Route::currentRouteName()) // it may not work if Route name means "->name('something')" not define or not match
  # or
  @seoPage(request()->path()) // it may not work if Route Uri "Route::get('something')" not match

  @isset($post)
      @seoModel($post)
  @endisset
</head>

🔗 Examples

✅ Layout Example

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>@yield('title', 'My Website')</title>

  {{-- Inject SEO --}}
  @seoGlobal

  @seoAutoPage

  @isset($pageKey)
      @seoPage($pageKey)
  @endisset

  @isset($seoModel)
      @seoModel($seoModel)
  @endisset

</head>
<body>
  @yield('content')
</body>
</html>

✅ Page Example 1

['pageKey' => request()->path() ?? (Route::currentRouteName() ?? '/')]

# or

@extends('layouts.app')

@section('title', 'Contact Us')

@section('content')
  <h2>Contact Us</h2>
  <p>Feel free to reach out!</p>
@endsection

@push('head')
  @seoPage('contact')
@endpush

✅ Page Example 2

Inside Layout

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>@yield('title', 'My Website')</title>

  <!-- Render SEO meta from pushed content -->
  @stack('head')
</head>
<body>
  @yield('content')
</body>
</html>

@extends('layouts.app')

@section('title', 'Contact Us')

@section('content')
  <h2>Contact Us</h2>
  <p>Feel free to reach out!</p>
@endsection

@push('head')
  @seoPage('contact')
@endpush

# or

@push('head')
  @seoPage('/contact-us')
@endpush

✅ Model Example

First enable from config

'menu' => [
  'model'  => true, // Hide model management by default
]

# inside your all seo able model you need to add 'HasSeoMeta' Trait
# It require for getting only seo free model instance
# In your 'Blog, Service, Product, Post' model jus add

use AreiaLab\LaravelSeoSolution\Traits\HasSeoMeta;

use HasSeoMeta;

@extends('layouts.app')

@section('title', $post->title)

@section('content')
  <h2>{{ $post->title }}</h2>
  <p>{{ $post->body }}</p>
@endsection

@push('head')
  @seoModel($post)
@endpush

✅ For Production or Host inside (Cpanel, AWS or Other)

php artisan vendor:publish --tag=seo-views

npm install
npm run build

Go To <views\areia\seo\layouts\app.blade.php>

# remove this line from `<head>`
@vite(['resources/css/app.css', 'resources/js/app.js'])

# Add
<!-- Styles / Scripts -->
<link rel="stylesheet" href="{{ asset('build/assets/{Your Generated CSS File Name}.css') }}">
<script src="{{ asset('build/assets/{Your Generated JS File Name}.js') }}" defer></script>

🌱 Seeder

Seed default SEO meta:

php artisan db:seed --class="AreiaLab\LaravelSeoSolution\Database\Seeders\SeoMetaSeeder"

📖 License

MIT License – Use freely in personal & commercial projects.

areia-lab / laravel-seo-solution

Maintainers

Details