设计顾客点餐的页面。

主题使用您自己的 CSS、图片和字体,装扮店铺在 Telegram 和二维码上的点餐页面。从我们的入门主题开始,针对页面的部件编写样式,店主在管理后台中添加即可。

主题包
night-market.zip
  theme.json     the manifest
  theme.css      the styles, one file
  bg.webp        pictures and fonts,
  stall.woff2    listed in theme.json

工作方式

  1. 下载入门主题一个 .zip,内含 theme.json 和 theme.css,已通过所有检查。解压后,修改其中的 id 和 name。
  2. 编写您的 CSS为页面的部件设置样式,并设定它的令牌。针对页面现有的样子编写规则;您无需改动它的标记。
  3. 重新压缩将文件压缩成 .zip,或压缩包含它们的文件夹。图片和字体与 theme.css 放在一起,并列在 theme.json 中。
  4. 店主添加店主在管理后台中添加 .zip:门店,选择门店,自取点单,您的主题,然后为小程序、二维码页面或两者选择它。

主题只是 CSS。菜单、价格、购物篮和付款都由页面自身负责,因此主题不会导致订单出错。

主题包

一个 .zip,最大 5 MB。theme.json 和 theme.css 位于顶层,或位于顶层的同一个文件夹中。其他每个文件都必须列在 theme.json 的 files 中。

  • 图片:png、jpg 或 webp。字体:woff2。不支持 SVG,因为它可能包含脚本。
  • 文件名为纯小写字母,内部不能有文件夹:bg.webp、stall.woff2。
  • 最多 30 个文件,每个 1 MB。theme.css 最大 150 KB,theme.json 最大 16 KB。
  • 您的电脑自动添加的内容(__MACOSX、.DS_Store)会被忽略。其他未列出的文件会被拒绝。

theme.json

记录主题的作者、适用的模式、文件,以及店主无需修改您的 CSS 即可更改的设置。

theme.json
{
  "contract": 1,
  "id": "night-market",
  "name": "Night Market",
  "version": "1.0.0",
  "author": { "name": "Sok Dara", "url": "https://example.com" },
  "description": "Kraft paper by day, dark roast by night.",
  "modes": ["light", "dark"],
  "files": ["bg.webp", "stall.woff2"],
  "settings": [
    { "type": "color", "id": "stall", "label": "Stall color", "light": "#B4532A", "dark": "#E08A5F" },
    { "type": "switch", "id": "paper", "label": "Paper texture", "on": true }
  ]
}
contract主题所依据的规范。目前为:1。
id2 到 40 个小写字母、数字和连字符。使用相同的 id 再次添加,会替换该店铺中的主题:即新版本。
name店主在管理后台中看到的名称,最多 40 个字母。
version三个数字,如 1.0.0。
authorname,如果愿意,可加上 url。
description关于主题的一句话,最多 280 个字母。
modeslight、dark 或两者。只适用于一种模式的主题始终以该模式显示,页面会隐藏模式切换。
filesCSS 引用的每一张图片和字体。
settings最多 12 项。color 带有 light 和 dark 两个值,读取为 var(--setting-<id>);switch 开启时设置 html[data-setting-<id>]。

页面为主题提供的内容

无论哪种外观、哪个主题,页面的标记都相同。以下属性设置在 <html> 上:

data-theme-pkg您主题的 id。检查器会将您的每条规则限定在该 id 之下。
data-themelight 或 dark:顾客的选择、手机的设置,或 Telegram 的设置。
data-tg页面位于 Telegram 内。--tg-top 是 Telegram 按钮所占的空间。
data-scrolled菜单已滚动到页眉下方。
langen、fr、km 或 zh。高棉语和中文需要带有其字符的字体:对它们保留 var(--sans) 或 var(--km)。

令牌

由您设置,写在 :root 或 html 上,以及 [data-theme="dark"] 中:

--bg--bg-deep--panel--line--line-soft--ink--ink-soft--muted--look-backdrop--look-hero--look-hero-r--look-r--look-r-sm--look-bw--look-shadow--look-shadow-color--look-tile--look-img--look-head--look-blur--look-chip-r--look-badge-r

由您读取,但不设置:锁定的颜色,以及店铺自己的强调色,为每种模式调整为可读。

--primary--danger--ok--warn--info--acc-*--tg-*--acc-solid--acc-ink--acc-tint--acc-line

theme.css
:root {
  --bg: #FBF7F1;
  --panel: #FFFFFF;
  --look-r: 18px;
}
html[data-theme="dark"] {
  --bg: #16130F;
  --panel: #221D17;
}
.to-section h2 {
  color: var(--setting-stall);
  border-bottom: 2px solid var(--acc-line);
}
html[data-setting-paper] .to {
  background: url('bg.webp');
}

用 --acc-solid、--acc-ink、--acc-tint 和 --acc-line 表示店铺的品牌色。每家使用您主题的店铺都保留其自己的颜色。

部件和状态

主题可以设置样式的类名,按区域列出。您可以为其中的任何元素设置样式;以下是保持不变的名称。

区域类名
页面.to.to-menu.po-nobar.po-bar
页眉.to-head.to-logo.to-lang.look-mode.lang-menu.lang-menu-panel.lang-menu-name.lang-menu-chev.po-hours.po-hours-head.po-deals.po-member
分区.po-catbar.to-cats.po-layout.to-section.to-grid
菜品,列表.po-dish.po-dish-open.to-dish-img.to-dish-text.to-dish-desc.po-initial.po-deal-mark
菜品,网格.po-card.po-card-open.to-card-img.to-card-text.po-card-foot
按钮和价格.po-add.to-stepper.to-price.to-icon-btn
点餐.to-bar.to-sheet.to-sheet-head.to-field.to-opt.to-group.to-lines.to-sum

状态

.in 表示菜品在购物篮中;.reveal 随后 .seen 表示菜品或标题在滚动进入视野前后的状态(仅首屏以下,减少动态效果时从不);.no-photo 表示没有图片的菜品;.on 表示当前可见的分区标签;aria-pressed 用于列表和网格切换。

检查内容

每个主题包在添加时都会检查。拒绝时会列出每个问题及其所在行,以便一次性修正。

拒绝项原因
反斜杠转义它们可以拼写任何内容,包括 url(。
@import,以及 @media、@supports、@container、@keyframes、@font-face 之外的所有 at 规则不会从外部加载任何内容;也不会改变页面规则的顺序。
url() 指向主题包自身文件之外的任何地方外部链接可能会告诉另一个网站有人打开了该页面。
!important锁定的规则使用它,因此主题的任何内容都无法压过它们。
设置锁定的令牌点餐按钮、状态和错误保持其颜色;强调色仍为店铺自己的。
content 中的文字主题不能在页面上书写内容,例如伪造的价格。""、none 和计数器都可以。
expression(、javascript:、-moz-binding、behavior它们会运行或获取某些内容。
嵌套规则、无法解析的 CSS,或超过 150 KB每条规则都按其书写的方式限定范围。

通过检查的内容会限定在 html[data-theme-pkg="<id>"] 之下,其 @keyframes 改名为主题自己的名称,其 url() 指向文件提供的位置。

始终不变的内容

在您的 CSS 之后,页面会添加任何主题都无法压过的规则,因此每家店铺都能安全地点餐:

  • 主要点餐按钮保持其颜色,并始终是完整、可读的按钮。
  • 错误和拒绝保持其红色。
  • 价格始终可读。
  • 键盘焦点始终可见。
  • 在减少动态效果下,没有任何内容移动。

在店铺中试用

添加主题需要 Growth 或 Pro 套餐。在 您的主题 下添加 .zip,然后为小程序或二维码页面选择它。从管理后台打开页面,即可查看浅色和深色模式、列表和网格,以及高棉语和中文下的效果。

  • 使用相同的 id 再次添加会替换它,使用它的店铺会保留该主题:这就是您发布新版本的方式。
  • 移除主题后,每家店铺都会恢复为其页面外观。
  • 您的 CSS 按版本缓存,因此每次上传都有新的地址,顾客永远不会看到只加载了一半的内容。

下载入门主题

规范版本

本页的类名、状态和令牌属于规范 1。我们只增加内容,不改名。如果某次变更不得不破坏它,那就是规范 2,页面会持续为每个主题提供其所指定的规范,直到它被更新。

为店铺制作主题?

告诉我们您正在制作什么。我们会阅读每一条消息,回复来自打造 Bill&Go 的团队。

准备开始了吗? 创建您的店铺

已经在用? 登录

联系我们

只需一分钟。我们会在一个工作日内回复。

您有几家店?

我们只用这些信息来联系您。