Typecho Sitemap 插件使用教程
1. 项目的目录结构及介绍
Sitemap-For-Typecho/
├── Sitemap/
│ ├── Sitemap.php
│ ├── LICENSE
│ └── README.md
├── LICENSE
└── README.md
- Sitemap/: 插件的核心文件夹,包含了插件的主要代码文件。
- Sitemap.php: 插件的主文件,负责生成Sitemap并推送至百度资源平台。
- LICENSE: 插件的许可证文件,通常为MIT许可证。
- README.md: 插件的说明文件,包含插件的基本介绍和使用说明。
- LICENSE: 项目的许可证文件,通常为MIT许可证。
- README.md: 项目的说明文件,包含项目的基本介绍和使用说明。
2. 项目的启动文件介绍
插件的启动文件是 Sitemap/Sitemap.php
。这个文件包含了插件的主要逻辑,负责生成Sitemap文件并将其推送到百度资源平台。
主要功能
- 生成Sitemap: 包含首页、独立页面、分类、标签、文章的Sitemap。
- 推送百度资源平台: 支持普通收录推送,但不支持快速收录推送。
- 支持永久链接参数: 支持多种永久链接参数,如
[cid]
、[slug]
、[category]
等。
3. 项目的配置文件介绍
插件没有独立的配置文件,所有的配置都是通过插件的API接口进行设置。以下是一些主要的API接口说明:
API接口说明
- sitemap update: 更新Sitemap文件。
- push main: 推送核心文章。
- push all: 推送全部文章。
- push new: 推送最新文章。
- token: API token,用于身份验证。
更新记录
- 1.1.0: 修改推送规则。
- 1.2.0: 修改缓存机制,以前是存数据库,现在改为存储缓存文件。
- 1.2.1: 修改读取分类的错误。
- 1.3.0: 增加API刷新Sitemap功能,增加API推送文章功能。
- 1.3.1: 修复非默认后台入口
/admin/
的推送功能无法使用。 - 1.3.2: 修复PHP8环境下的报错。
- 1.3.3: 修复错误,永久链接使用按分类归档时Sitemap文章链接错误。
- 1.3.4: 修复错误,永久链接使用按分类归档时推送百度的文章链接错误。
- 1.5: 更新,支持文章链接中的全部参数。
- 1.5.1: 更新,支持分类永久链接的
[directory]
参数。 - 1.6: 修复各类自定义文章链接自动推送百度出现的链接错误。
- 1.7: 修复API推送最新文章的异常报错,新增API缓存头,避免CDN进行缓存。
- 1.8: 修复百度推送更新接口,更新百度推送的方法,增加自定义设置推送最新文章数量。
通过这些API接口,用户可以灵活地配置和管理Sitemap的生成和推送。