README

仅适用于 Statmic v3。自动为所有集合条目添加 SEO 标签，您可以在其中为每个条目微调 SEO。

{{ seotamic }}

生成完整的 SEO 设置

<title>My Page Title</title>
<meta name="description" content="SEO friendly description" />
<link rel="canonical" href="https://mysite.com/page" />
<meta property="og:url" content="https://mysite.com/page" />
<meta property="og:site_name" content="Site name" />
<meta property="og:title" content="My Page Title" />
<meta property="og:description" content="SEO friendly description" />
<meta property="og:locale" content="en_US" />
<meta property="og:image" content="https://mysite.com/img/og.jpg" />
...

版本 2 变更

版本 2 有重大变更。如果您从版本 1 升级，全局设置将不会迁移，您需要手动将旧文件复制到内容目录。

安装

使用 composer 包含此包

composer require cnj/seotamic

此包需要 Laravel 7+ 和 PHP 7.3+。它会自动注册。

SEO 选项卡将自动出现在所有集合条目上。

配置（可选）

您可以通过发布配置来覆盖默认选项

php artisan vendor:publish --provider="Cnj\Seotamic\ServiceProvider" --tag=config

这将把默认配置文件复制到 `config/seotamic.php`。

如果您需要更改默认资产容器，请确保在模板中也应用此更改。

使用方法

使用方法相对简单直接。您可以通过 CP 中的导航上的 Seotamic 链接访问全局设置。请确保遵循每个字段的说明。

在此之后，您可以通过编辑条目下的 SEO 设置来微调每个集合条目的输出。

Antlers

有几个 Antlers 标签可用，最简单的方法是在布局的头部包含一个“包罗万象”的基础标签

{{ seotamic }}

如果您需要更多控制，可以通过使用以下方式手动获取输出的一部分

{{ seotamic:title }}
{{ seotamic:description }}
{{ seotamic:canonical }}

这将返回字符串，因此您需要将它们包装在适当的标签中，例如

<title>{{ seotamic:title }}</title>

社交标签仍然会返回带有标签的一切

{{ seotamic:og }}
{{ seotamic:twitter }}

动态 OG 图片

在需要 OG 图片动态的项目中，目前您可以使用此 ViewModel 并将其注入到您的集合中，以便动态分配 OG 图片。

<?php

namespace App\ViewModels;

use Statamic\View\ViewModel;

class OgImage extends ViewModel
{
    public function data(): array
    {
        $image = $this->cascade->get('image');

        if ($image) {
            return [
                'seotamic_image' => $image
            ];
        }

        return [];
    }
}

在上面的例子中，我们假设您的集合中有一个 image 字段，您可以根据您的用例进行更改。然后在您的集合中，您只需注入 ViewModel。

title: Posts
inject:
  view_model: App\ViewModels\OgImage

鸣谢

此包由 CNJ Digital 构建。

许可证

本项目根据 MIT 许可证授权。