ShopifyShopify入门


备注

本节概述了shopify的内容,以及开发人员可能想要使用它的原因。

它还应该提及shopify中的任何大型主题,并链接到相关主题。由于shopify的文档是新的,您可能需要创建这些相关主题的初始版本。


没有Shopify的版本

出于安全考虑,Shopify不会发布版本号也不会更改日志。为了跟上Shopify的变化,最好检查的地方是:

安装或设置

有关设置或安装shopify的详细说明。

本地主题设置

有几种方法可以设置Shopify主题的本地副本:

  • Node.js(gulp / grunt)
  • 红宝石
  • 主题应用程序(仅限Mac)

可能还有其他一些方法,但我发现红宝石方式最容易使用。

要在Shopify主题文件上本地工作,您需要做一些事情:


Ruby安装程序

首先是安装Ruby安装程序,使用最新版本。

安装过程很简单,但它会要求您将Ruby添加到Windows环境全局路径中,您应该单击该复选框并将其添加到那里 ,这样您就不必手动执行此操作。


开发,套件

您应该选择与您添加的Ruby安装程序一起使用的DevKit的正确版本。

安装过程也很简单。

  1. 例如,您在C:\ DevKit中解压缩该文件
  2. 你在该文件夹中cmd并写入ruby dk.rb init ,它应该在filder中创建一个config.yml
  3. 如果你打开config.yml 文件,你应该在底部看到 - C:/Ruby23-x64 (取决于你安装你的Ruby的位置以及版本是什么)如果它不在那里你必须手动添加它
  4. 之后在同一文件夹中运行以下ruby dk.rb install
  5. 如果一切正常,您应该能够运行以下命令 - gem install json --platform=ruby ,它将确认您的Ruby安装正在运行

这里也可以看到更详细的说明: https//github.com/oneclick/rubyinstaller/wiki/Development-Kit


SSL证书

您需要将cacert.pem文件添加到窗口全局变量中。

  1. 您必须下载以下文件: https ://curl.haxx.se/ca/cacert.pem(将其保存为.pem而不是.pem.txt)
  2. 您必须进入“环境变量”屏幕,然后在“系统变量”下单击“新建”
  3. 对于Variable name,输入SSL_CERT_FILE ,对于变量值,输入文件的路径,例如C:\ RailsInstaller \ cacert.pem

Shopify主题宝石

打开cmd并输入以下代码: gem install shopify_theme

这应该安装我们需要的Shopify主题宝石。


如果您通过上述所有步骤一次,您将不再执行这些步骤。

现在,您每次开始新的Shopify项目时都必须执行以下步骤:

  • 创建一个私人应用程序(来自Shopify商店)
  • 使用私有应用程序信息创建配置文件

创建一个私人应用程序

您必须登录Shopify商店管理面板并转到应用程序屏幕 - >私人应用程序:

https://YOUR-STORE-NAME.myshopify.com/admin/apps/private

然后单击“ 创建私人应用 ”按钮。

它会问你一个标题。 (输入你喜欢的)

重要的是将所有权限更改为读取和写入

更改权限并保存应用程序后,它会将您重定向到一个页面,您将从该页面获取此应用程序的API密钥和密码。 (您需要我们将在下面创建的配置文件)


创建配置文件

转到您喜欢主题文件和cmd里面的本地文件夹。

编写以下命令:

theme configure API-KEY PASSWORD DOMAIN ID

哪里:

  • API密钥 - 取自我们创建的私有应用程序
  • 密码 - 取自我们创建的私人应用程序
  • 域名 - 这是您的域名YOUR-STORE-NAME.myshopify.com ,在它之前没有https://
  • ID - 这是主题ID,如果你打算使用实时主题,你可以跳过这个,但如果你正在克隆它们,那么你必须在这里输入主题ID

一旦你运行上面的代码,它应该创建一个名为config.yml的文件,其中将提供所有提供的信息。

现在你应该在config.yml所在的文件夹中cmd(如果你关闭了控制台)并编写了以下代码: theme download 应该开始逐个下载文件。

完成下载过程后,您将编写theme watch ,每次修改下载的文件时,它都会在1-2秒后更新Shopify存储中的文件。如果添加文件也是如此,但删除文件时则不然。

有关Gem的更多详细信息,请访问: https//github.com/Shopify/shopify_theme

使用Theme Kit购买本地开发

Shopify主题也可以在本地开发。请按照以下步骤设置本地开发环境:

  • 安装Shopify主题套件
  • 获取API访问权限
  • 使用新主题或使用主题工具包配置现有主题

上述步骤的说明如下:


安装Shopify主题套件


自动安装

如果您使用的是Mac或Linux,则可以使用以下安装脚本自动下载并安装Theme Kit。

curl -s https://raw.githubusercontent.com/Shopify/themekit/master/scripts/install | sudo python
 

家酿

如果安装了自制程序,则可以通过运行以下命令来安装Theme Kit。

brew tap shopify/shopify
brew install themekit
 

Windows安装


自动Powershell安装

以管理员身份在Powershell中运行以下命令。

(New-Object System.Net.WebClient).DownloadString("https://raw.githubusercontent.com/Shopify/themekit/master/scripts/install.ps1") | powershell -command -
 

手册

  • 在C:\ Program Files \中创建一个名为Theme Kit的文件夹
  • 下载themekit(下面)并将提取的程序复制到C:\ Program Files \ Theme Kit中
  • 导航到控制面板>系统和安全>系统。另一种方法是右键单击“我的电脑”并选择属性项
  • 查找名为Environment Variables的按钮或链接
  • 在第二个面板中查找名为Path的项目,然后双击它。这应该打开一个窗口,其中包含一个充满内容的文本字段。
  • 将光标一直移动到最后并添加以下内容:; C:\ Program Files \ Theme Kit \
  • 单击确定,直到所有窗口都消失。
  • 要验证是否已安装Theme Kit,请打开cmd.exe并键入theme。

手动安装

下载最新版本的可执行文件

OS 建筑链接
苹果系统 64位 下载
视窗 64位 下载
视窗 32位 下载
Linux的 64位 下载
Linux的 32位 下载

获取API访问权限


您需要设置API密钥以添加到我们的配置中,并在您的商店和主题工具包之间创建连接。 API密钥允许主题工具包与您的商店进行对话和访问,以及其主题文件。

为此,请登录Shopify商店,并创建一个私人应用程序。在Shopify管理员中,转到应用并点击查看私人应用。从那里,单击生成API凭据以创建您的私人应用程序。确保将主题模板和主题资源的权限设置为具有读写权限以生成相应的API凭据,然后单击“保存”。

在此处输入图像描述

填写顶部的信息,并将主题模板和主题资产的权限设置为读写访问权限。按保存,您将看到下一个屏幕。在其中,您将看到您的访问凭据。请记下密码。你以后会需要它。

在此处输入图像描述


使用新主题。

如果您从头开始并希望快速入门,请运行以下命令:

theme bootstrap --password=[your-password] --store=[your-store.myshopify.com]
 

这将从Timber模板为您的在线商店创建一个新主题。然后它将从Shopify下载所有这些资产并自动为您创建config.yml文件。


配置现有主题。

要连接现有主题,您需要主题的ID号。获取主题ID号的最简单方法是转到主题编辑器,单击编辑HTML / CSS并从URL复制主题ID号 - 它将在mystore.myshopify.com/admin/themes/之后的最后几位数字。 在此处输入图像描述

然后,一旦注意到主题ID,请运行以下命令:

# create configuration
theme configure --password=[your-password] --store=[you-store.myshopify.com] --themeid=[your-theme-id]
# download and setup project in the current directory
theme download