主题命令

此章节列出了你可以与 SHOPLINE CLI 一起使用的的主题命令。主题命令使用的语法是 sl theme [command]。 要从命令行访问任何这些命令的帮助,请使用 sl [command] -h


init

初始化主题,将从 Github 拉取到本地计算机

sl theme init <THEME_NAME>

可选参数

参数是否必填描述
THEME_NAME你要为主题指定名称。克隆文件存储在具有此名称的文件夹中。
主题名称可以为以下形式:
+ demo-theme:将会在当前文件夹中新建文件夹存储新主题文件,主题名作为文件夹名。
+ 也可以是相对路径形式../shopline/demo-theme:将会根据输入的路径和当前运行路径,新建文件夹存储新主题文件,主题名为路径的 basename。
--path <PATH>你的主题目录工作路径。

list

列出当前登录店铺的所有主题,包括 ID、名称、状态等。

sl theme list

serve

将当前本地主题作为开发主题上传到你连接的店铺,并且进行实时预览开发。

sl theme serve

此命令还返回以下信息:

  • 本地预览链接:http://127.0.0.1:8282 此链接指向你的开发主题的链接。此 URL 可以热重新加载对本地文件的更改,或在文件更改时刷新整个页面,允许你使用店铺的数据实时预览更改。
  • SHOPLINE 后台中主题编辑器的链接
  • 你可以与其他开发人员共享的预览链接

如果你已经有当前环境的开发主题,那么此命令会将开发主题替换为你的本地主题。

提示:你无法使用 http://127.0.0.1:8282 预览结账页

注意:

可选参数

参数缩写描述
--port <PORT>指定主题预览的本地端口
默认值:8282
--live-reload <MODE>对主题进行更改时重新加载内容的级别。 接受以下值: - full-page
- 修改文件时刷新整个页面(默认) - off
- 停用实时刷新,任何文件的改动都将不刷新整个页面
--theme-editor-sync为主题 JSON 文件启用双向同步。启用此选项后,在 SHOPLINE 后台的模版编辑器中所做的更改将应用于模版的本地副本。
--only-o仅拉取指定的文件,可在单个命令中使用多次 --only
指定多个文件,支持以下格式:
+ 简单的文件名:templates/collection.temp.json
+ 通配符:config/*_secret.json
,*.jpg
--ignore-x跳过指定的文件拉取,可在单个命令中使用多次 --ignore
指定多个文件,支持以下格式:
+ 简单的文件名:templates/product.temp.json
+ 通配符:config/*_secret.json
,*.jpg
--path <PATH>你的主题目录工作路径。
--environment <ENV_NAME>-e <ENV_NAME>你想使用的环境配置。

pull

从店铺获取主题文件 如果未指定主题,则会提示你选择要从店铺中的主题列表中选择主题。 若当前目录非空时,CLI 将提供两个选项给开发者选择:

  • 覆盖同名文件(默认)
  • 清空当前目录后,拉取主题文件
sl theme pull

可选参数

参数缩写描述
--theme店铺主题 id(可以通过 list 命令获取)
--live-l拉取已发布主题
--development-d下载远程开发主题代码到本地。
--only-o仅拉取指定的文件,可在单个命令中使用多次 --only
指定多个文件,支持以下格式:
+ 简单的文件名:templates/collection.temp.json
+ 通配符:config/*_secret.json,*.jpg
--ignore-x跳过指定的文件拉取,可在单个命令中使用多次 --ignore
指定多个文件,支持以下格式:
+ 简单的文件名:templates/product.temp.json
+ 通配符:config/*_secret.json,*.jpg
--nodelete-n运行 pull 命令,不删除本地文件。
--path <PATH>你的主题目录路径。
--environment <ENV_NAME>-e <ENV_NAME>你想使用的环境。

push

将你的本地主题文件上传到店铺。

如果指定主题,则覆盖远程主题。如果未指定主题,则会提示你从店铺中的主题列表中选择要覆盖的主题。

sl theme push

此命令返回一下信息:

  • 你可以与他人共享的预览链接。
  • 店铺后台的主题编辑器链接。

可选参数

参数缩写描述
--theme店铺主题 id(可以通过 list 命令找到)
--development-d推送到开发主题。如果你没有开发主题,则会创建一个。
--only-o仅推送指定的文件,可在单个命令中使用多次 --only指定多个文件,支持以下格式:
+ 简单的文件名:templates/product.temp.json
+ 通配符:config/*_secret.json,*.jpg
--ignore-x跳过指定的文件推送,可在单个命令中使用多次 “--ignore”指定多个文件,支持以下格式:
+ 简单的文件名:templates/product.temp.json
+ 通配符:config/*_secret.json,*.jpg
--nodelete-n将你的本地文件推送到 SHOPLINE,而不删除远程文件。
--allow-live-a允许 SHOPLINE CLI 覆写已发布的主题。
--live-l推送到已发布主题。此选项无需--theme或--allow-live。
--unpublished-u将主题上传到主题库,作为一个新的未发布主题。 系统会提示你为主题提供一个名称。使用 --theme 参数将名称作为命令的一部分提供。
--path <PATH>你的主题目录工作路径。
--environment <ENV_NAME>-e <ENV_NAME>你想使用的环境。

package

将你的本地主题文件打包成可以上传到 SHOPLINE 店铺的 zip 文件。

zip 文件中仅包含与默认 SHOPLINE 主题目录结构匹配的文件夹。

ZIP 文件名使用theme_name-theme_version.zip根据 theme.schema.json 文件中使用的参数生成。

sl theme package

可选参数

参数描述
--path <PATH>你的主题目录工作路径。

这篇文章对你有帮助吗?