WordPress 主题开发：Sage 11 + Acorn 5 实战

这篇分享我们搭建 wp.lvmaai.com 主题的过程。

## 为什么选 Sage 11

Sage 是 Roots 团队开发的一款现代化 WordPress 主题脚手架。与传统的 _s (Underscores) 相比，它有几个核心优势：

– **现代前端工具链**：Vite + Tailwind + PostCSS
– **Laravel Blade 模板**：摆脱传统 PHP 模板的啰嗦
– **Composer 依赖管理**：更专业

## 安装步骤

“`bash
composer create-project roots/sage your-theme-name
cd your-theme-name
npm install
npm run dev
“`

## 项目结构

“`
your-theme/
├── app/ # PHP 业务代码
│ ├── Providers/
│ ├── Settings/
│ └── View/
├── resources/ # 前端资源
│ ├── views/ # Blade 模板
│ ├── css/
│ └── js/
└── public/
└── build/ # Vite 编译产物
“`

## 我们的踩坑

最大的坑是 Acorn 5 还没装 Laravel Auth facade：

– 不能用 `@auth` / `@guest`
– 要用 `is_user_logged_in()` 替代

另一个坑是 Vite 8 的 manifest 格式变了：

“`php
// vendor patch: 兼容新的 object 格式
if (is_array($value)) {
$value = (object) $value;
}
“`