D'SKIN — 按护肤流程编排的无头店铺
将一家智利护肤品牌的网站整体从 WordPress 迁移到 Astro,后端保留无头 WooCommerce。2026 年又把整个店铺重新编排:不再按品类浏览,而是按护肤流程的四个步骤浏览。
访问网站 ↗- Astro
- TinaCMS
- React
- TypeScript
- WooCommerce API
- Supabase
- 全栈开发
- 2026年11月
- 2025 年 12 月迁移 · 2026 年 11 月改版
- D'SKIN
- 智利
- 从 WordPress 迁移到 Astro + TinaCMS,后端保留无头 WooCommerce
- 站内自有结账流程,2026 年 2 月起已在生产环境运行
- 店铺改版:按护肤流程的四个步骤重新编排
- 为市场团队提供可视化内容编辑
- 双语支持(西班牙语/英语)与完整 i18n
- 移动端 Lighthouse:性能 99、无障碍 100、SEO 100
2026 年改版:把店铺做成一套流程
迁移一年之后,问题已经不在技术层面。店铺按 WooCommerce 的品类排列,而那套品类本身是乱的:「Beauty」「Cream」「Serum」「Skin care」,还有七件产品躺在「Uncategorized」里。刚进店的客人并不知道精华是什么,她需要知道的是:它排第二。
于是店铺改为按流程的四个步骤编排——清洁、调理、保湿、眼部护理——每款产品归入所属步骤,并标明使用频率与适用肤质。
真正改变设计的,是去读订单。 把历史上 486 笔已付款订单按人归并(196 位客人),得到的是:
- 42.9% 的人是从保湿霜进来的,那是第 3 步;只有 6.1% 从第 1 步进来。
- 68.9% 的人首单只买一件。
- 在复购的人里,63.5% 是回购同一件,而不是沿流程往下走。
此前没人看过这组数字,而它恰恰推翻了那个看上去理所当然的设计。所以主视觉不是从第 1 步开场,而是从人们真正进来的地方开场;标题写的是「可以只从一件开始」;也因此有了那个先问「你架子上已经有哪一件」的版块,而不是把完整流程当成唯一路径摆出来。
改版里的三个决定
顺序只有一个来源,且不手写任何数据。 一个文件定义四个步骤以及每步放哪款产品。价格、图片与库存每次渲染都向 WooCommerce 取。缺货产品显示「已售罄 · 到货通知」且无法加入购物车——而这正是旧店铺允许发生的事。
一个 @media 都没有。 整次改版用的是容器查询、配合 clamp() 的 cqw 单位和 auto-fit 网格。每个版块在一栏里、在弹窗里、在整页宽度下表现一致,因为它量的是自己的容器,不是窗口。
品牌金色不作为文字色使用。 #d8c7a5 在浅色背景上的对比度只有 1.44:1:当文字读不清,当分隔线会消失。标签改用 #6f5733,在骨白底上达到 6.4:1,分隔线用中间色调。品牌色留在它有效的地方——背景与产品上——而不是对比度不允许的地方。
一个值得写下来的失误
版块的滚动入场原本写在 CSS 里,用的是 opacity: 0。一旦 IntersectionObserver 没能跑起来——在 768 与 390 的样机上就发生过——页面会整片空白:初始状态生效了,终态永远不来。现在隐藏状态改由 JavaScript 在挂载后设置,而且只对首屏以下的版块设置。没有 JavaScript,或开启 prefers-reduced-motion 时,页面从第一次绘制起就是完整的。
挑战
D’SKIN 是一家智利天然化妆品品牌,其现有的 WordPress + WooCommerce 网站已经显得过时。客户需要一个更快、更现代的网络形象,同时保持轻松管理内容的能力和电子商务功能。
主要目标是:
- 大幅提升页面速度和 Core Web Vitals
- 为营销团队提供可视化内容编辑体验
- 保留 WooCommerce 用于产品管理和订单
- 支持双语内容(西班牙语/英语)
- 现代高端的美学设计,体现品牌的天然护肤身份
解决方案
我设计了一个混合架构:Astro 作为前端,配合 TinaCMS 进行可视化内容编辑,同时保持 WordPress + WooCommerce 作为无头后端处理产品数据和订单。
┌─────────────────┐ ┌──────────────┐ ┌─────────────────┐
│ Astro 网站 │──▶│ TinaCMS │──▶│ 静态构建 │
│ (前端) │ │ (内容) │ │ (Hosting) │
└─────────────────┘ └──────────────┘ └─────────────────┘
│
▼
┌─────────────────┐
│ WordPress │
│ WooCommerce │
│ (产品) │
└─────────────────┘
实现的关键功能
双语支持 (ES/EN) — 完整的 i18n 实现,西班牙语为默认语言:
- 英文路由在
/en/*,完整翻译 - 按语言分离的内容集合(每种语言 26+ 篇博客文章)
- 本地化的 UI 元素、日期、货币格式和导航
- 按语言的 SEO 元标签
TinaCMS 可视化内容管理 — 分屏实时预览编辑,带可视指示器的可编辑区域:
- 主页英雄轮播(4 个可配置产品)
- 畅销产品区域与 WooCommerce 集成
- 关于页面及团队画廊
- 护理服务目录
- 博客文章富文本编辑
电子商务集成 — 实时的产品数据与结账衔接:
- 从 WooCommerce REST API 实时获取产品目录
- 客户端购物车抽屉,使用 localStorage 持久化
- 结账最初是把购物车交接给 WooCommerce(带签名会话);自 2026 年 2 月起,付款发生在网站自身,WooCommerce 作为商品目录与订单记录
- 库存状态和价格自动同步
- API 不可用时的降级机制
交互组件 — 面向内容与转化的交互模块:
- 购物车抽屉(桌面 380px 侧边栏,移动端全宽)
- 可配置产品的英雄轮播
- Google 评价轮播
- 动态 Instagram 信息流集成
- WhatsApp 悬浮按钮
- Lenis 平滑滚动
性能优化 — 以静态生成和按需水合为核心:
- 使用 Astro 的部分水合进行静态站点生成
- React 组件仅在需要时水合(
client:load、client:visible) - 图片优化并通过边缘 CDN 分发
成果
在生产环境用移动端 Lighthouse 实测,取三次运行的中位数:
- 性能 99、无障碍 100、SEO 100
- LCP 1.3 秒,CLS 0.001
- 最佳实践 77,唯一的扣分来自广告像素的第三方 Cookie:这是品牌的决定,不是站点的问题
市场团队无需技术支持即可更新文章、护理项目、产品页与页面内容;自 2026 年 2 月起,结账就发生在网站自身,WooCommerce 则作为商品目录与订单记录。
技术亮点
TinaCMS 可视化编辑 — 自定义 React 包装器通过 useTina() hook 实现实时预览:
// 可视化编辑包装器示例
export default function BestSellersWrapper({ query, variables, data, products }) {
const { data: tinaData } = useTina({ query, variables, data });
return (
<section data-tina-field={tinaField(bestSellers, 'title')}>
{/* 带可视指示器的可编辑内容 */}
</section>
);
}
WooCommerce API 集成 — 实时产品数据,优雅降级:
// 获取畅销产品
const products = await getBestSellers(3);
// 按 ID 获取特定产品
const products = await getProductsByIds([7183, 7176, 7868]);
// 格式化为智利价格格式
formatPrice(21990); // "$21.990"
购物车转移系统 — 自定义 WordPress 插件处理带 SSO 的多产品购物车转移:
- 签名令牌(有效期 5 分钟)使用共享密钥
- 在 WordPress 上自动创建用户会话
- 站内完成的结账体验
技术栈
| 技术 | 用途 |
|---|---|
| Astro 5.x | 带岛屿架构的静态站点生成器 |
| TinaCMS 3.x | Git 支持的可视化编辑 |
| React | 交互组件(购物车、画廊、轮播) |
| TypeScript | 类型安全开发 |
| Lenis | 高级平滑滚动 |
| 托管平台 | 自动部署托管 |
| WooCommerce REST API | 无头产品管理 |
这个项目展示了如何用无头架构现代化传统 WordPress 网站,结合静态站点性能的优势、可视化 CMS 的灵活性和 WooCommerce 在电子商务方面的稳健性。