Morn SEO Meta Kit

轻量级 SEO 元信息与社交卡片插件。为 WordPress 输出规范化的标题、描述、Open Graph、Twitter Card、canonical、hreflang 与 JSON-LD 结构化数据，并附带精简 XML 站点地图与 robots.txt 增强。

零外部资源、零远程请求、零第三方依赖。所有功能均在本地完成。

• 版本：1.0.0
• 需要 WordPress：6.0+
• 需要 PHP：7.4+
• 测试至：WordPress 6.6
• 许可证：MIT

特性

• 标题模板：可视化模板变量，支持页面层级（%page%）拼接面包屑式标题。
• 描述生成：优先使用自定义描述，其次摘要，最后自动截取正文；UTF-8 安全的字符级截断，不产生乱码。
• 社交卡片：Open Graph 全套标签（含图片尺寸与替代文本）+ Twitter Card，文章特色图优先作为分享图。
• canonical：自动剥离分页参数与 utm/gclid/fbclid 等跟踪参数，保证 URL 唯一性。
• hreflang：开箱输出自引用 hreflang，可通过过滤器追加多语言版本。
• JSON-LD：Organization / WebSite / BreadcrumbList / Article / Author Person，以 @graph 统一输出，搜索引擎友好。
• 文章级 SEO 框：自定义标题、描述、焦点关键词、noindex、站点地图排除，附原生 JS 实时评分（标题长度、描述长度、关键词分布）。
• 精简站点地图：/sitemap-seo.xml，输出 lastmod、changefreq、priority，自动排除密码保护、noindex、手动排除的内容。
• robots.txt 增强：追加可配置 Disallow 规则与 Sitemap 行，遵守 WordPress 公开性设置。
• 性能友好：站点地图 XML 缓存 6 小时，文章变更时自动失效；JS 使用 defer 且不依赖 jQuery。

安装

1. 将 morn-seo-meta-kit 目录上传到 wp-content/plugins/。
2. 在后台「插件」中启用「Morn SEO Meta Kit」。
3. 启用后会自动注册 /sitemap-seo.xml 重写规则（激活钩子中已自动刷新）。
4. 进入后台菜单「SEO 元信息」进行配置。

若使用 nginx 且重写规则未生效，手动加入：

location ~ ^/sitemap-seo\.xml$ {
    rewrite ^/sitemap-seo\.xml$ /index.php?morn_seo_sitemap=1 last;
}

配置说明

后台路径：SEO 元信息 → SEO 元信息工具（顶层菜单，manage_options 权限）。

标题与描述

标题模板变量

社交卡片

分享图优先级：文章特色图 > 自定义 URL > 媒体库默认图。

多语言 hreflang

若站点已安装多语言插件，通过 morn_seo_meta_kit_hreflang 过滤器追加其他语言版本。

JSON-LD 结构化数据

站点地图与 robots.txt

站点地图访问地址：https://你的域名/sitemap-seo.xml

changefreq 计算规则（按最后修改时间距今天数）

首页固定为 changefreq=daily、priority=1.0；普通页面为 priority=0.6；站点首页页面为 priority=1.0。

文章编辑页 SEO 框

出现在文章与页面编辑页右侧「SEO 元信息」面板：

• 自定义标题：留空则使用站点标题模板。最多 200 字符。
• 自定义描述：留空则自动取摘要或正文。最多 320 字符。
• 焦点关键词：多个关键词用英文逗号分隔。
• 实时评分：标题建议 10~60 字符，描述建议 50~155 字符，关键词应出现在标题中。
• 此页面设为 noindex：单篇不索引，同时从站点地图中排除。
• 从站点地图中排除此内容：仅影响站点地图，不影响索引。

Hook 列表

动作（do_action）

本插件不定义新的 do_action。它挂接在以下核心动作上：

过滤器（apply_filters）

使用示例

追加自定义 JSON-LD 节点：

add_filter( 'morn_seo_meta_kit_schema_graph', function ( $graph, $context ) {
    $graph[] = array(
        '@type' => 'WebPage',
        '@id'   => home_url( '/#webpage' ),
        'url'   => home_url( '/' ),
        'name'  => get_bloginfo( 'name' ),
    );

    return $graph;
}, 10, 2 );

为多语言站点追加 hreflang：

add_filter( 'morn_seo_meta_kit_hreflang', function ( $alternates, $context ) {
    if ( is_singular() ) {
        $alternates[] = array(
            'lang' => 'en',
            'url'  => 'https://example.com/en/' . get_post_field( 'post_name', get_queried_object_id() ),
        );
    }

    return $alternates;
}, 10, 2 );

FAQ

Q：标题不生效，或出现两个 <title>？ A：本插件在 wp_head 优先级 1 移除核心的 _wp_render_title_tag、wp_robots 与 rel_canonical，避免重复输出。若仍有重复，说明其它 SEO 插件也在输出，请关闭它们的 title 功能。

Q：站点地图 404？ A：确认「启用精简站点地图」已开启，然后到「设置 → 固定链接」点一次「保存」以刷新重写规则。nginx 用户还需添加上文给出的 rewrite 配置。

Q：为什么我的自定义标题没显示？ A：确认文章编辑页的「自定义标题」不为空。本插件对首页与文章页完全接管标题输出；分类、标签等归档页保留 WordPress 核心行为，通过 %title% 变量控制格式。

Q：站点地图里为什么少了某些文章？ A：以下内容会被自动排除：密码保护文章、草稿/待发布、设置了 noindex 的文章、勾选了「从站点地图中排除」的文章。

Q：og_image_custom 填了没生效？ A：文章设置了特色图片时，特色图片优先级高于自定义 URL。取消文章特色图片后才会使用自定义 URL。

Q：会和其他 SEO 插件冲突吗？ A：会。本插件与 Yoast、Rank Math 等插件功能重叠，同时启用会导致 title/description/OG 重复输出。建议只启用其一。

Q：站点设为「不公开索引」后站点地图会怎样？ A：返回 HTTP 403 并提示站点不可公开索引，同时前端输出 noindex, nofollow。

目录说明

morn-seo-meta-kit/
├── morn-seo-meta-kit.php      # 主文件：插件头、启动、激活/停用钩子
├── uninstall.php              # 卸载清理（仅清理本插件自有数据）
├── README.md
├── LICENSE                    # MIT
├── CHANGELOG.md
├── .gitignore
├── .gitattributes
├── assets/
│   ├── css/admin.css          # 后台样式（评分条、字数计数器、媒体选择器）
│   └── js/
│       ├── admin.js           # 媒体库选择（基于 wp.media）
│       └── seo-score.js       # 编辑页实时评分（原生 JS）
└── includes/
    ├── functions.php          # 设置读取、模板渲染、上下文构建、UTF-8 安全截断
    ├── class-admin.php        # Settings API 设置页、字段渲染、sanitize、资源加载
    ├── class-metabox.php      # 文章级 SEO 元框与保存
    ├── class-schema.php       # JSON-LD 结构化数据
    ├── class-sitemap.php      # /sitemap-seo.xml 生成与缓存
    ├── class-cleanup.php      # robots.txt 增强与缓存失效
    └── class-frontend.php     # 前台 head 标签输出

存储的选项

文章元字段

_morn_seo_title、_morn_seo_description、_morn_seo_keywords、_morn_seo_noindex、_morn_seo_exclude_sitemap

卸载说明

在后台「插件」中点击「删除」并确认卸载时，uninstall.php 会执行以下清理：

• 删除选项 morn_seo_meta_kit_settings
• 删除选项 morn_seo_meta_kit_settings_sitemap_version
• 删除所有 _transient_morn_seo_meta_kit_sitemap_xml* 缓存
• 删除 5 个文章元字段（见上表）
• 移除 /sitemap-seo.xml 对应的重写规则

不会删除：任何文章、页面、附件、用户、评论或其他插件的数据。

License

MIT License Copyright (c) 2026 MornRain

详见 LICENSE。