566E PHP包仓库
首页 包列表 提交包 常见问题 关于

定制 bnomei/kirby-seo 二次开发

按需修改功能、优化性能、对接业务系统，提供一站式技术支持

邮箱：yvsm@zunyunkeji.com | QQ：316430983 | 微信：yvsm316

bnomei/kirby-seo

最新稳定版本：v5.1.0

Composer 安装命令：

composer require bnomei/kirby-seo

包简介

Minimal, AI-assisted SEO plugin for Kirby CMS

关键字：

# seo # kirby # ai # kirby-plugin # kirby-cms

README 文档

README

Kirby 5 PHP 8.2 Release Discord Buymecoffee

Minimal, mostly zero-config SEO plugin for Kirby CMS.

It gives you:

  • resolved <head> metadata via a snippet or page/site methods
  • automatic robots.txt and sitemap.xml routes
  • optional Panel SEO button with status and AI actions
  • optional SERP preview integration
  • optional AI title/description generation

Requirements

  • Kirby 5
  • PHP 8.2+

Installation

composer require bnomei/kirby-seo

If you also want the Panel SERP preview section:

composer require johannschopplich/kirby-serp-preview

Zero Config

For the public SEO output, the plugin is basically zero config.

Add the snippet to your page template:

<?php snippet('seo/head') ?>

The snippet renders the resolved head tags from the current page or site. See snippets/seo/head.php.

The plugin also registers public routes automatically:

  • robots.txt
  • sitemap.xml

See src/Kirby/SeoRoutes.php.

Methods

The plugin registers page and site methods like:

  • $page->seoHeadTags()
  • $page->seoPreviewTitle()
  • $page->seoPreviewDescription()
  • $page->seoCanonical()
  • $site->seoHeadTags()
  • $site->seoRobotsTxt()
  • $site->seoSitemapXml()

See src/Kirby/SeoMethodRegistry.php.

Optional Panel Button

The SEO view button is opt-in. Add seo to your blueprint buttons.

For pages:

buttons:
  - open
  - preview
  - -
  - settings
  - languages
  - status
  - seo

For the site blueprint:

buttons:
  - open
  - preview
  - languages
  - seo

See tests/site/blueprints/pages/default.yml and tests/site/blueprints/site.yml.

What the button does:

  • opens an SEO dropdown
  • shows current indexing and sitemap state
  • lets you run AI generation
  • lets you pause/resume AI auto-refresh
  • lets you hide/allow page indexing overrides

See src/Kirby/Panel/SeoPanelButtons.php and src/Kirby/Panel/SeoPanelActions.php.

The button also hints state:

  • green icon when indexing and sitemap are both OK
  • red button background when the resolved SEO state has a problem

Optional SERP Preview

If you install johannschopplich/kirby-serp-preview, you can reuse the provided section extensions.

For pages:

sections:
  serpPreview:
    extends: sections/seo/serp-preview/page

For the site:

sections:
  serpPreview:
    extends: sections/seo/serp-preview/site

See src/Kirby/SeoBlueprints.php.

Those sections preconfigure the preview to use the plugin’s SEO title and description fields, so you don’t need to wire the keys manually.

Blueprint Fields and Overrides

The plugin stores SEO values in normal Kirby content fields, which means you can show them in the Panel and override AI output with regular blueprint fields.

The core fields are:

  • seoTitle using Kirby's text field
  • seoDescription using Kirby's textarea field with buttons: false
  • seoCanonical using Kirby's url field
  • seoImage using Kirby's files field
  • seoIndex using Kirby's toggle field

seoTitle and seoDescription are the fields that AI writes to. If an editor changes either value in the Panel, that saved content becomes the resolved SEO output. If AI is still set to auto, other content changes can trigger a refresh and regenerate those values again, so use the SEO lock action if you want to keep a manual override. seoCanonical, seoImage, and seoIndex are regular manual overrides.

If you want to keep your existing content tab, add the SEO fields as a fields section next to it:

tabs:
  content:
    label: Content
    columns:
      main:
        width: 2/3
        fields:
          text:
            type: textarea
      sidebar:
        width: 1/3
        sections:
          serpPreview:
            extends: sections/seo/serp-preview/page
          seoFields:
            type: fields
            fields:
              seoTitle:
                type: text
                label: SEO title
              seoDescription:
                type: textarea
                label: SEO description
                buttons: false
                maxlength: 320
              seoCanonical:
                type: url
                label: Canonical URL
              seoImage:
                type: files
                label: SEO image
                max: 1
                multiple: false
                uploads: false
                query: page.images
              seoIndex:
                type: toggle
                label: Search indexing
                text:
                  - Blocked
                  - Allowed

For the site blueprint, keep the same field definitions and switch the preview section and image query to sections/seo/serp-preview/site and site.images.

Kirby's textarea field includes built-in format buttons by default, so buttons: false keeps the SEO description plain. If you also want other metadata in the same area, Kirby's tags field is available for keyword-style input, while the SEO indexing override should stay a toggle.

If you prefer the ready-made SEO tab instead of wiring the fields manually, extend seo/page or seo/site in your blueprint. The plugin also keeps tabs/seo/page and tabs/seo/site available for compatibility.

AI

AI generation is optional.

Default provider behavior:

  • provider: openai
  • model: gpt-5-mini
  • alternatives: anthropic, gemini

See src/Kirby/Ai/SeoAiService.php.

Environment Variables

By default the plugin already looks for these environment variables in closures:

  • OPENAI_API_KEY
  • ANTHROPIC_API_KEY
  • GEMINI_API_KEY

See index.php.

If your hosting injects those into PHP, you usually don’t need extra config.

Using bnomei/kirby3-dotenv

If you load secrets from .env files with bnomei/kirby3-dotenv, use the same callback pattern as in that plugin’s README: resolve secrets inside closures so they are evaluated after plugins are loaded.

Example:

<?php

return [
    'bnomei.seo.ai.provider' => 'openai',
    'bnomei.seo.ai.providers.openai' => function () {
        return [
            'apiKey' => env('OPENAI_API_KEY'),
            'model' => 'gpt-5-mini',
            'timeout' => 30,
        ];
    },
];

You can do the same for Anthropic or Gemini:

<?php

return [
    'bnomei.seo.ai.provider' => 'anthropic',
    'bnomei.seo.ai.providers.anthropic' => function () {
        return [
            'apiKey' => env('ANTHROPIC_API_KEY'),
            'model' => 'claude-sonnet-4-5',
        ];
    },
];

Custom Connectors

If you do not want one of the built-in OpenAI, Anthropic, or Gemini providers, there are two extension points:

  • bnomei.seo.ai.generate for a full custom implementation that returns the final SEO title and description
  • bnomei.seo.ai.transport for replacing only the HTTP transport under the built-in adapters

Example:

<?php

use Bnomei\Seo\Core\Ai\SeoAiHttpRequest;
use Bnomei\Seo\Core\Ai\SeoAiHttpResponse;

return [
    'bnomei.seo.ai.generate' => function ($request, $model, string $languageCode, $kirby) {
        unset($model, $languageCode, $kirby);

        // Call your own inference API here and normalize the response.
        return [
            'title' => 'Custom title',
            'description' => 'Custom description',
        ];
    },
    'bnomei.seo.ai.transport' => function (SeoAiHttpRequest $request) {
        unset($request);

        return new SeoAiHttpResponse(
            statusCode: 200,
            body: ['output_text' => '{"title":"Custom title","description":"Custom description"}'],
        );
    },
];

If you want a fourth named provider, add a new adapter class under src/Kirby/Ai and extend SeoAiService::adapter() accordingly. The built-in selector only maps openai, anthropic, and gemini.

AI Source

The AI input is not the raw text field by default.

The default source pipeline:

  • renders the page HTML
  • prefers <main> and otherwise falls back to <body>
  • strips images and other non-markdown-ish nodes
  • converts the remaining HTML to markdown

For site-wide generation it uses the rendered home page. See src/Kirby/Ai/SeoAiSnapshotFactory.php, src/Kirby/Ai/SeoAiSourceExtractor.php, and src/Kirby/Ai/SeoAiHtmlToMarkdownConverter.php.

If you want to override that, return any string from bnomei.seo.ai.source:

<?php

return [
    'bnomei.seo.ai.source' => function ($model, string $languageCode) {
        return (string) $model->content($languageCode)->get('text')->value();
    },
];

That gives you full control over what the LLM sees.

统计信息

  • 总下载量： 6
  • 月度下载量： 0
  • 日度下载量： 0
  • 收藏数： 3
  • 点击次数： 2
  • 依赖项目数： 0
  • 推荐数： 0

GitHub 信息

  • Stars： 3
  • Watchers： 0
  • Forks： 0
  • 开发语言： PHP
访问仓库

其他信息

  • 授权协议： MIT
  • 更新时间： 2026-04-07

承接程序开发

PHP开发

VUE

Vue开发

前端开发

小程序开发

公众号开发

系统定制

数据库设计

云部署

网站建设

安全加固