跳到主要内容

ArtinTech Solution

Leafwise Shopify theme homepage next to a clean Theme Check result

大多数定制 Shopify 主题都从复制 Dawn 开始。它免费、快速,并由 Shopify 维护。但 Leafwise 是我们在自家商店出售的苗圃和植物店主题,这条路对我们走不通。

下面介绍我们如何从零编写 Shopify 主题:为什么没有基于 Dawn、主题如何组织,以及在得到干净的 Theme Check 结果之前遇到的工具问题。

关于本文:Leafwise 是我们自己的产品,所有内容都来自真实项目。代码示例经过缩短,并非虚构。

Leafwise Shopify theme homepage next to a clean Theme Check result
Leafwise 与一次干净的 Theme Check 结果。(示意图。)

为什么不基于 Dawn?

Dawn 的许可证允许在其基础上开发,但由 Dawn 派生的主题只能通过 Shopify 主题商店分发。我们想用自己的价格和许可证直接出售 Leafwise,这意味着完全不能使用 Dawn 的代码:区块结构、JavaScript 和 CSS 都不行。

从空文件夹开始也有好处。每个区块都因为植物店需要而存在,没有任何服装店遗留下来的东西。

一段话说清架构

Leafwise 是一个简洁的 Online Store 2.0 主题:JSON 模板、页眉组和页脚组,以及到处可用区块的分区。七套配色放在一个配色组里,一个 snippet 把每套配色转换成带自定义属性的 CSS 类,任何分区只需一个设置就能切换配色。没有框架,也没有构建步骤。交互部分是四个延迟加载文件里的小型自定义元素。

  • side-drawer 和 cart-drawer:菜单、搜索和购物车
  • product-form、variant-picker、media-gallery 和 sticky-atc:商品页
  • facets-area:无需刷新的筛选;predictive-search:搜索建议
  • plant-quiz 和 filter-tabs:首页

购物车:一次请求,更新所有分区

加入购物车时,侧边购物车、页眉数量和手机导航必须同时更新。Section Rendering API 在同一次请求里完成:我们请 Shopify 渲染需要的分区,然后替换它们的 HTML。

formData.append('sections', 'cart-drawer,cart-count');
formData.append('sections_url', window.location.pathname);
const res = await fetch('/cart/add.js', { method: 'POST', body: formData });
const data = await res.json();
// data.sections['cart-drawer'] is fresh HTML for the drawer

每个显示购物车数据的元素都带有 data-cart-section 属性,所以新增显示购物车的位置只需要加这个属性,不必写新的 JavaScript。

Theme Check 显示“0 files inspected”

在 Windows 上,shopify theme check 无论在哪个文件夹运行都没有报错,却显示检查了零个文件。什么都没检查的“干净”结果比报错更糟。于是我们改为直接通过 Node 包调用同一个检查器:

const { themeCheckRun } = require('@shopify/theme-check-node');
const { offenses, theme } = await themeCheckRun(root, undefined, console.error);
console.log('Files inspected:', theme.length);

它找到一个错误和四个警告,其中包括一个过长的分区名称。修复后:90 个文件,0 个错误,0 个警告。

可能被 Shopify 拒绝的压缩包

PowerShell 的 Compress-Archive 生成的压缩包路径使用反斜杠,即 sections\header.liquid 而不是 sections/header.liquid。一些解压工具和上传检查不接受这种路径。我们改用 .NET 的 ZipArchive,并自己用正斜杠写入每个路径。

$rel = $file.FullName.Substring($src.Length + 1).Replace('\', '/')
[IO.Compression.ZipFileExtensions]::CreateEntryFromFile($zip, $file.FullName, $rel)

下次还会这样做的事

  • 不用框架:四个小脚本文件比任何打包文件加载更快,也更易读
  • 购物车相关的一切都用 Section Rendering API
  • 在 CI 中通过 Node 包运行 Theme Check,没有检查到文件时让构建失败
  • 尽早在真实的开发店铺中测试。Theme Check 通过了,店铺仍发现了八个问题,这是我们下一篇文章的主题

Leafwise 在 Charming Theme 出售。如果你需要为自己的店铺从零开发 Shopify 主题,请查看我们的 Shopify 主题开发服务。

常见问题

可以在主题商店之外出售基于 Dawn 的主题吗?

Dawn 的许可证只允许派生主题通过 Shopify 主题商店分发。想在其他地方出售,就要编写自己的代码。

从零编写比修改 Dawn 多花多少时间?

前期更久,因为购物车、筛选和款式逻辑都要自己写。好处是每一行代码都属于你,也没有用不上的代码。

现代 Shopify 主题需要构建步骤吗?

不需要。带自定义属性的普通 CSS 加上小型自定义元素,足以满足 Leafwise 的全部需求。

Share this article

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注