引言（Introduction）
我开发 Imaseo网站“lihui自研主题”的初衷，是为了建立一个轻量、高效且可控的多语言网站框架。在实践 WordPress 网站建设和跨境 SEO 项目时，我发现很多现有主题功能虽然丰富，但在实际操作和维护中往往不够灵活，加载速度和模板管理也存在限制（部分国外主题在国内访问时可能受限，因此这个主题的静态资源和功能都设计为兼顾国内外加载，且达到消耗最小的资源去承载）。
这个主题的设计理念源于我的需求：
- 超轻量/高效：只保留核心功能，让网站运行更流畅，同时方便调试和优化。
- 多语言友好：中文和英文模板分离，可以快速管理不同语言的页面和首页。
- 开发可控：清晰的目录结构和模板规则，让我可以快速扩展功能或二次开发。
- SEO 实用：内置模板和功能设计考虑了搜索引擎优化，让内容可以更好地展示。
1. 项目概述（Overview）
- 主题名称：lihui(李辉自研主题)
- 版本：1.2
- 作者：李辉
- 主题定位：SEO 优化、多语言支持（中文/英文）、自定义首页和页面模板
- 核心功能：
- 多语言模板文件夹管理（zh/en）
- 自定义首页 front-page.php
- 页面模板按 slug 自动匹配
- 自动下载远程图片
- 飞书表单通知
- 自定义菜单和小工具区域
2. 目录结构（File Structure）
lihui/ # 项目根目录 / 主题根目录
│
├── assets/ # 静态资源
│ ├── css/ # 样式文件
│ │ ├── about-us.css
│ │ ├── list.css
│ │ ├── main.css
│ │ └── single.css
│ └── js/ # JavaScript 文件
│ └── main.js
│
├── template-parts/ # WordPress 可重用模板部件
│ ├── form_liuzi.php # 表单组件（留言/联系/报价）已对接飞书云文档
│ └── doubao_api.php # 豆包API相关功能（新增）
│
├── templates/ # 页面模板目录（多语言）
│ ├── zh/ # 中文模板（新增）
│ │ └── tools/ # 中文工具模板（新增）
│ │ ├── tool-baidu-tongji-api-dashboard-forme.php #百度统计报表1
│ │ ├── tool-baidu-tongji-api-dashboard.php #百度统计报表2
│ │ └── tool-keyword-generator.php #SEO下拉词工具
│ └── en/ # 英文模板
│ ├── front-page.php # 英文首页
│ ├── header-en.php # 英文头部（未调用）
│ ├── footer-en.php # 英文页脚（未调用）
│ ├── page-about-us-en.php
│ ├── page-content-seo-en.php
│ ├── page-google-seo-en.php
│ ├── page-multilingual-seo-en.php
│ ├── page-seo-link-building-en.php
│ ├── page-technology-seo-en.php
│ └── single-en.php # 英文单篇文章页
│
├── footer.php # 默认中文/通用页脚
├── footer-en.php # 英文页脚（可与 templates/en/footer-en.php 相同）
├── front-page.php # 中文首页
├── header.php # 默认中文头部
├── header-en.php # 英文头部
├── index.php # fallback 模板
├── single.php # 默认单篇文章页
├── page-about-us.php # 关于我们（中文）
├── page-content-seo.php # 内容 SEO（中文）
├── page-google-seo.php # Google SEO（中文）
├── page-multilingual-seo.php # 多语言 SEO（中文）
├── page-seo-link-building.php# 外链建设（中文）
├── page-technology-seo.php # 技术 SEO（中文）
├── functions.php # 主题功能文件
├── style.css # 主题主样式文件（含主题注释）
└── screenshot.png # 主题后台截图3. 模板调用规则（Template Rules）
- 首页
- 中文首页：front-page.php
- 英文首页：templates/en/front-page.php
- 普通页面
- 中文：page-{slug}.php
- 英文：templates/en/page-{slug}-en.php
- 头部/页脚
- 中文：header.php / footer.php
- 英文：header-en.php / footer-en.php 或放在 templates/en/ 目录
- 可以在模板里通过 include __DIR__ 或封装函数加载
- 单篇文章页
- 中文：single.php
- 英文：templates/en/single-en.php
- 模板加载机制
- 通过 template_include 钩子根据 Polylang 当前语言切换模板
- 英文模板放 templates/en/
- 中文模板在主题根目录
4. 主题功能（functions.php）
- imaseo_setup() → 注册主题功能：
- title-tag
- custom-logo
- 菜单位置（主导航菜单）
- imaseo_widgets_init() → 注册小工具区域（底部小工具）
- imaseo_enqueue_scripts() → 加载 CSS/JS
- imaseo_multilang_template() → 多语言模板切换（支持首页和普通页面）
- 自动下载远程图片 → 保存文章时自动将远程图片下载到本地
- 飞书表单通知处理 → 前端表单提交后发送数据到飞书多维表格
5. 多语言管理
- 英文模板统一放在 /templates/en/
- 页面 slug 自动匹配对应模板
- 首页和普通页面都支持多语言模板
- header/footer 可通过封装函数动态加载：
<?php
function imaseo_get_header() {
$lang = function_exists('pll_current_language') ? pll_current_language() : 'zh';
$header_file = get_template_directory() . "/header-$lang.php";
if (file_exists($header_file)) {
include $header_file;
} else {
get_header();
}
}
function imaseo_get_footer() {
$lang = function_exists('pll_current_language') ? pll_current_language() : 'zh';
$footer_file = get_template_directory() . "/footer-$lang.php";
if (file_exists($footer_file)) {
include $footer_file;
} else {
get_footer();
}
}
?>模板里直接调用：
<?php imaseo_get_header(); ?>
<!-- 页面内容 -->
<?php imaseo_get_footer(); ?>6. 使用示例
英文首页模板调用 header/footer：
<?php
// front-page.php (templates/en/front-page.php)
include __DIR__ . '/header-en.php';
?>
<!-- 英文首页内容 -->
<?php
include __DIR__ . '/footer-en.php';
?>普通页面模板（page-ceshi.php）调用 header/footer 同理。
7. FAQ / 常见问题
- 英文模板不加载 → 确认文件命名和路径
- 首页模板失效 → 钩子需要判断 is_front_page()
- get_header(‘en’) 不生效 → 文件需放在根目录或使用 include
- 页面 slug 冲突 → WordPress 自动生成 -2
- 缓存问题 → 清理缓存插件和浏览器缓存
8. 更新日志（Changelog）
- v1.0 → 初始版本
- v1.1 → 多语言模板支持优化
- v1.2 → 英文首页 front-page 修复
- v1.3 → SEO下拉词工具上线；新增豆包API总结全文功能；百度统计API在线可视化多维度统计视图saas工具-测试版已上线【2026.2.4】
✅ 总结
- 中文模板在根目录，英文模板放 templates/en/
- 首页和普通页面都可自动识别模板
- header/footer 可通过封装函数自动加载语言版本
- 多语言模板管理清晰、维护简单