Helper Functions

$seo = seo();

// Use service methods
$meta = seo()->getMetaForModel($post);
$tags = seo()->generateMetaTags($post);

$meta = seoMeta($post);

// Access properties
$title = $meta->meta_title;
$description = $meta->meta_description;

// Get single value
$siteName = seoConfig('site.name');
$maxLength = seoConfig('defaults.title_max_length');

// With default
$value = seoConfig('custom.key', 'default');

if (seoIsEnabled('sitemap')) {
    // Generate sitemap
}

if (seoIsEnabled('redirects')) {
    // Handle redirects
}

if (seoIsEnabled('analysis')) {
    // Run analysis
}

// With default separator from config
$title = seoTitle('My Page');
// Result: "My Page | My Site"

// With custom separator
$title = seoTitle('My Page', ' - ');
// Result: "My Page - My Site"

// Without suffix
$title = seoTitle('My Page', '');
// Result: "My Page"

// Default 160 characters
$desc = seoDescription($longText);

// Custom length
$desc = seoDescription($longText, 150);

// With ellipsis
$desc = seoDescription($longText, 160, '...');

$redirectService = seoRedirect();

// Use service methods
$redirect = seoRedirect()->findMatch('/old-path');

$redirect = seoFindRedirect('/old-page');

if ($redirect) {
    $destination = $redirect->target;
    $statusCode = $redirect->status_code;
}

$redirect = seoCreateRedirect(
    source: '/old-page',
    target: '/new-page',
    type: 'exact',
    statusCode: 301
);

// With all options
$redirect = seoCreateRedirect(
    source: '/blog/*',
    target: '/articles/$1',
    type: 'wildcard',
    statusCode: 301,
    isActive: true,
    notes: 'Blog migration redirect'
);

// By ID
seoDeleteRedirect(123);

// By source path
seoDeleteRedirect('/old-page', byPath: true);

$stats = seoRedirectStatistics();

// Returns:
// [
//     'total' => 45,
//     'active' => 42,
//     'inactive' => 3,
//     'total_hits' => 12543,
//     'most_hit' => [...],
// ]

$sitemapService = seoSitemap();

// Generate sitemaps
seoSitemap()->generate();

// Generate all
seoGenerateSitemap();

// Generate specific type
seoGenerateSitemap('standard');
seoGenerateSitemap('images');
seoGenerateSitemap('videos');
seoGenerateSitemap('news');

// Submit to all configured engines
seoSubmitSitemap();

// Submit to specific engine
seoSubmitSitemap('google');
seoSubmitSitemap('bing');

$results = seoAnalyze($post);

// Returns:
// [
//     'score' => 75,
//     'readability' => ['status' => 'pass', ...],
//     'keyword_density' => ['status' => 'warning', ...],
//     ...
// ]

$score = seoScore($post);
// Returns: 0-100

$schema = seoSchema($post);

// Returns JSON-LD array
// [
//     '@context' => 'https://schema.org',
//     '@type' => 'Article',
//     ...
// ]

$json = seoSchemaJson($post);

// Returns JSON string ready for output

$canonical = seoCanonical($post);
// Returns: "https://example.com/posts/my-post"

$url = seoUrl($post);

// With options
$url = seoUrl($post, absolute: true);

$robots = seoRobots($post);
// Returns: "index, follow" or "noindex, nofollow"

$content = seoRobotsTxt();

$hreflang = seoHreflang($post);

// Returns:
// [
//     'en' => 'https://example.com/post',
//     'fr' => 'https://example.fr/article',
//     'x-default' => 'https://example.com/post',
// ]

// Clear for specific model
seoClearCache($post);

// Clear all SEO caches
seoClearCache();

class PostController extends Controller
{
    public function show(Post $post)
    {
        // Check if post should be visible
        if (!seoIsEnabled('noindex_preview') && !$post->shouldBeIndexed()) {
            abort(404);
        }

        return view('posts.show', [
            'post' => $post,
            'seoTitle' => seoTitle($post->title),
            'seoDescription' => seoDescription($post->content),
        ]);
    }
}

@php
    $pageTitle = seoTitle($post->title ?? 'Home');
    $pageDesc = seoDescription($post->content ?? seoConfig('site.description'));
@endphp

<title>{{ $pageTitle }}</title>
<meta name="description" content="{{ $pageDesc }}">

class GenerateSeoCommand extends Command
{
    public function handle()
    {
        if (seoIsEnabled('sitemap')) {
            seoGenerateSitemap();
            $this->info('Sitemap generated.');
        }

        if (seoIsEnabled('analysis')) {
            Post::each(function ($post) {
                seoAnalyze($post);
            });
            $this->info('Analysis complete.');
        }
    }
}