Menu
Table of Contents

SEO - v1.0.0

Analysis Panel

The SEO Analysis Panel is a Livewire component that displays content analysis results and SEO recommendations.

Basic Usage

<livewire:seo-analysis-panel :model="$post" />

Features

  • Overall SEO score
  • Individual analyzer results
  • Pass/fail indicators
  • Actionable recommendations
  • Refresh capability

Properties

Property Type Required Description
model Model Yes Eloquent model with HasSeo trait
showScore bool No Show overall score
showDetails bool No Show detailed results
autoRefresh bool No Auto-refresh on model update

Examples

Standard Usage

<div class="card">
    <div class="card-header">
        <h3>SEO Analysis</h3>
    </div>
    <div class="card-body">
        <livewire:seo-analysis-panel :model="$post" />
    </div>
</div>

Compact View (Score Only)

<livewire:seo-analysis-panel
    :model="$post"
    :show-details="false"
/>

With Auto-Refresh

<livewire:seo-analysis-panel
    :model="$post"
    :auto-refresh="true"
/>

Score Display

The overall score is calculated from all enabled analyzers:

Score: 75/100

███████████░░░░ 75%

Score Ranges

Range Status Color
80-100 Excellent Green
60-79 Good Yellow
40-59 Needs Work Orange
0-39 Poor Red

Analyzer Results

Each analyzer displays:

  • Status - Pass, Warning, or Fail
  • Title - Analyzer name
  • Message - Explanation/recommendation
  • Details - Additional information (expandable)

Example Results

✓ Meta Title Length
  Title is 45 characters (recommended: 50-60)

⚠ Keyword Density
  Focus keyword density is 0.5% (recommended: 1-3%)

✗ Image Alt Text
  3 images missing alt text

Available Analyzers

Readability

Checks content readability using Flesch-Kincaid:

✓ Readability
  Grade level: 7.2 (target: ≤8)

Keyword Density

Checks focus keyword usage:

⚠ Keyword Density
  "laravel seo" appears 0.5% (recommended: 1-3%)

Focus Keyword

Checks keyword placement:

✓ Focus Keyword in Title
  Focus keyword found in title

✗ Focus Keyword in Description
  Focus keyword not found in meta description

Meta Length

Validates title and description length:

✓ Meta Title Length
  45 characters (50-60 recommended)

⚠ Meta Description Length
  180 characters (150-160 recommended)

Heading Structure

Analyzes H1-H6 usage:

✓ Heading Structure
  1 H1, 3 H2s, 5 H3s - Good hierarchy

Image Alt Text

Checks for missing alt attributes:

✗ Image Alt Text
  3 of 5 images missing alt text

Counts internal links:

⚠ Internal Links
  1 internal link (minimum 2 recommended)

Content Length

Checks word count:

✓ Content Length
  1,250 words (minimum 300)

Refresh Analysis

<livewire:seo-analysis-panel :model="$post">
    <x-slot:actions>
        <button wire:click="refresh">
            Re-analyze
        </button>
    </x-slot:actions>
</livewire:seo-analysis-panel>

Events

Event Payload Description
analysis-complete ['score' => int] After analysis runs

Customization

Publishing Views

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

Extending the Component

namespace App\Livewire;

use ArtisanPackUI\Seo\Livewire\SeoAnalysisPanel as BaseSeoAnalysisPanel;

class CustomSeoAnalysisPanel extends BaseSeoAnalysisPanel
{
    protected function getCustomAnalyzers(): array
    {
        return [
            'custom_check' => new CustomAnalyzer(),
        ];
    }
}

Custom Analyzer

namespace App\Seo\Analyzers;

use ArtisanPackUI\Seo\Contracts\AnalyzerInterface;

class CustomAnalyzer implements AnalyzerInterface
{
    public function analyze($model): array
    {
        // Your analysis logic
        return [
            'status' => 'pass', // pass, warning, fail
            'title' => 'Custom Check',
            'message' => 'Custom check passed.',
            'score' => 100,
        ];
    }
}

Integration with Editor

The analysis panel is often used alongside the SEO Meta Editor:

<div class="grid grid-cols-3 gap-6">
    <div class="col-span-2">
        <livewire:seo-meta-editor :model="$post" />
    </div>

    <div>
        <livewire:seo-analysis-panel
            :model="$post"
            :auto-refresh="true"
        />
    </div>
</div>

Caching

Analysis results are cached for performance:

// In config/seo.php
'analysis' => [
    'cache' => true,
    'cache_ttl' => 86400, // 24 hours
],

Force refresh clears the cache:

$this->dispatch('refresh-analysis');

Queue Support

For large content, analysis can run in the background:

// In config/seo.php
'analysis' => [
    'queue' => true,
],

When queued, the panel shows a loading state until complete.

Next Steps