文档结构  
翻译进度:已翻译     翻译赏金:0 元 (?)    ¥ 我要打赏

在这篇文章中,我将分享使用Magento 2 创建全新主题的一点知识与经验。这款CMS相较于Magento的第一个版本有许多优点。大多数操作都能在客户端实现。一些优势如下所示:

  • 对HTML5和CSS3的全面支持;
  • 内置的LESS预处理器;
  • 用RequireJS的异步模块上传 (无需手动添加代码)
  • 使用jQuery/jQuery UI 代替Prototype library;
  • 使用 MagentoUI library (它包括所有必要的组件,用来展现简单灵活的用户界面)。
第 1 段(可获 1.29 积分)

至于新主题的开发,Magento 2为其脚本和代码定义了新的模块结构。目前所有的静态CSS、js和图像文件存储在特定的网站主题文件夹中。皮肤文件夹已经从Magento的根目录删除。视图文件夹被引入用来存放布局和文件,这为了某个特定的模块提供了MVC访问。

主题目录的创建

Magento 2主题存储在目录 <M2根目录>/app/design/frontend catalogu下面。首先,你应该创建供应商文件夹(在Magento 1是这种叫法),然后为你自己的主题创建一个新文件夹。

第 2 段(可获 1.66 积分)

举个例子: 主题目录为<M2 root directory>/app/design/frontend/Singree/walkbeyond.  此例中,Singree是供应商,walkbeyond是主题代码。在代码部分,你可以使用任意字母和数字的组合。

上述目录创建后, 你需要声明主题,在后台激活它。

申明和注册

为了让Magento 2 ‘看到’新创建的主题,你需要创建以下文件: <Magento 2 root directory>/app/design/frontend/<vendor>/<theme codename>/theme.xml,代码包含如下:

<theme xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Config/etc/theme.xsd">
<title>walkbeyond</title>
<parent>Magento/blank</parent>
<media>
<preview_image>media/walkbeyond.jpg</preview_image>
</media>
</theme>
第 3 段(可获 1.09 积分)

在<title>标签中包含了主题名称;父主题在<parent>标签里。(所有未找到的,静态文件和布局文件将从父主题获取。) 在本例中,你可以看到<parent>中显示的是blank,作为一个基本的主题,它没有父主题。然而,继承层次的数量在Magento 2是没有限制的,这比Magento 1要有用的多。

在<preview_image> 标签中,你可以选择并设置主题预览。它将显示在管理部分。为了在系统中注册主题,你需要在根目录下创建 registration.php文件,如下所示:

第 4 段(可获 1.49 积分)
<?php
\Magento\Framework\Component\ComponentRegistrar::register(
    \Magento\Framework\Component\ComponentRegistrar::THEME,
    'frontend/Singree/walkbeyond',
    __DIR__
);

创建composer.json文件不是必要的,但是你可以将其作为composer包用来分享主题。示例如下:

{
    "name": "Singree/walkbeyond",
    "description": "N/A",
    "require": {
        "php": "~5.5.0|~5.6.0|~7.0.0",
        "Singree/walkbeyond”: "100.0.*",
        "magento/framework": "100.0.*"
    },
    "type": "magento2-theme",
    "version": "100.0.1",
    "license": [
        "OSL-3.0",
        "AFL-3.0"
    ],
    "autoload": {
        "files": [
            "registration.php"
        ]
    }
}
第 5 段(可获 0.3 积分)

静态文件的目录创建

为了储存样式、javascript代码、图像以及字体,你应当在主题的根目录下创建web文件夹。需要如下的结构:

app/design/frontend/Singree/walkbeyond/
├── web/
│ ├── css/
│ │ ├── source/
│ ├── fonts/
│ ├── images/
│ ├── js/

所有这些文件夹不都是至关重要的。在images文件夹存储了所有的静态文件。你还可以将 logo.svg(默认名)加入此文件夹,重新定义主题logo。

基于空白父主题的特性,你可以在css/source文件夹中创建 _theme.less文件重新定义MagentoUI的基本变量。然后,在<magento-root>/lib/web/css/source/lib/variables/文件夹里

 

第 6 段(可获 1.96 积分)

图像配置

你创建的主题必须包括view.xml文件(如果没有在父主题中声明),它存储了产品图像所有有必要信息,如产品图像,宽度、高度、背景色、透明度等等。你可以使用元素的ID属性、类型进行赋值。下面将演示是如何做到的:

<images module="Magento_Catalog">
...
<images/>

例如,使用上述过程,你可以很轻松的更改您的目录图表中的图像大小(如下所示)。

<?xml version="1.0"?>
<view xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Config/etc/view.xsd">
    <media>
        <images module="Magento_Catalog">
            <image id="category_page_grid" type="small_image">
                <width>200</width>
                <height>200</height>
            </image>
</media>
</view>
第 7 段(可获 0.99 积分)

在这个主题中,Category_page_grid ID是唯一的。Small_image类型对应于管理员这边的Small Image Role。可以用作图像类型值的有:image, small_image, swatch_image, swatch_thumb以及thumbnail。

当产品保存时,所有图像都缓存起来。当你改变图像大小时,你可以执行命令 <magento install dir>/bin/magento catalog:images:resize生成图像。最终我们将得到以下结构:

后台主题激活

当主题已经在文件系统创建好后,你可以在设置中激活它。要这么做的话,你只需遵循Content > Design > Themes的路径,检查主题是否在列表中。

第 8 段(可获 1.69 积分)

然后,进入CONTENT > Design > Configuration,点击编辑一个选择的网站或者电子商务平台。选择我们的主题(应用主题),然后点击保存。

为了防止缓存作用,当主题被应用时请刷新页面。要刷新缓存,到System > Cache Management,更新所有无效的缓存类型。

最终,我们得到可靠的magento/blank主题,带有不同的logo以及调整过大小的图像。

使用LESS编辑主题风格

当你创建主题后,你可以修改下风格以改变网站的页面视觉。要改变风格,你可以使用Magento 2中两个LESS预处理类型中的一个:

第 9 段(可获 1.5 积分)
  • 服务端预编译LESS;
  • 使用less.js的客户端预编译LESS

客户端编译经常使用在开发模式中,因为所有改动和编译都可以立刻可视化:每次当你在看样式文件的时候,浏览器开始编译这些文件。与此同时,当服务端在编译的时候,你需要手动删除pub/static和 var/view_preprocessed文件夹。然而你可以使用Grunt task runner优化流程,它可以跟踪有关文件的每一动作,‘清除’所选文件夹,自动编译较少的文件。

第 10 段(可获 1.18 积分)

要改变编译类型,需要进入控制面板: Stores > Configuration > Advanced > Developer > Front-end development workflow > Workflow.

我们的例子相当简单,我们将使用服务端编译 (默认设置的).

在网站in _theme.less file设置背景颜色和字体:

@page__background-color: #484848;
@text__color: #fff;
@font-family__base: 'Arial', sans-serif;

在你删除 /pub/static/frontend/Singree/walkbeyond/en_US和var/view_preprocessed目录下的内容后,你会发现你网站的视觉效果已经变化了。

第 11 段(可获 1 积分)

使用Magento 2 布局主题

Magento 2使您能够扩展和重写这个或那个主题布局。你不需要从父主题复制页面相关的或通用的布局,只需要参考主题文件夹中的选定布局,如下所示:

Magento 2能让你对主题进行扩展和覆盖。

<theme_dir>
 |__/<Namespace>_<Module>
   |__/layout
     |--<layout1>.xml
     |--<layout2>.xml

举个例子,要扩展存储在 <сatalog_module_dir>/view/frontend/layout/catalog_category_view.xml Catalog模块的lcatalog_category_view布局,你需要创建以下route文件:

第 12 段(可获 1.14 积分)
<theme_dir>/Magento_Catalog/layout/catalog_category_view.xml.

要从布局中删除任意部分(比如,类别描述),你可以按下面的代码进行操作:

<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"        xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <body>
        <referenceBlock name="category.description" remove="true"/>
    </body>
</page>

然而,布局扩展不能用于任何定制化任务。如果你需要定制很多东西,最好重写布局。也就是说创建并使用一个新文件要比使用父主题(你的主要布局)的文件要容易的多。在你最好重写布局的时候,本文提供了一些定制化例子。
第 13 段(可获 0.93 积分)
  1. 请求一个方法,“支配”父布局的另一个方法;
  2. 需更改方法的参数数目;
  3. 使用remove属性取消对block/container操作的delete命令;
  4. 为blocks/containers添加XML属性;
  5. 需删除参数块;
  6. 用 ‘blank’ layout handle重写布局文件来删除layout handles
  7. 需修改layout handles的激活.

在模块主题文件夹,创建override/base文件夹来覆盖基本布局,如下所示:

<theme_dir>
  |__/<Namespace_Module>
    |__/layout
      |__/override
         |__/base
           |--<layout1>.xml
           |--<layout2>.xml
第 14 段(可获 1.06 积分)

以下这些文件可以覆盖布局:

  • <module_dir>/view/frontend/layout/<layout1>.xml
  • <module_dir>/view/frontend/layout/<layout2>.xml

此外,你可以通过在模块的主题文件夹中创建重写/主题文件夹来覆盖父主题的布局:

<theme_dir>
  |__/<Namespace_Module>
    |__/layout
      |__/override
         |__/theme
            |__/<Parent_Vendor>
               |__/<parent_theme>
                  |--<layout1>.xml
                  |--<layout2>.xml

以下路径的这些文件可以覆盖布局:

第 15 段(可获 0.75 积分)
  • <parent_theme_dir>/<Namespace>_<Module>/layout/<layout1>.xml
  • <parent_theme_dir>/<Namespace>_<Module>/layout/<layout1>.xml

主题模板

Magento 2 主题不仅能让你覆盖布局模块还包括模板。要覆盖模块模板<module_dir>/view/frontend/templates/<path_to_templates>,在主题模块文件夹创建新的文件夹模板:<theme_dir>/<Namespace>_<Module>/templates/<path_to_templates>

让我们试着为一个cart文件(Singree/walkbeyond/Magento_Checkout/templates/cart/minicart.html)添加文本信息。文本信息需要与cart中产品的数量相关。 本文提供的例子如下所示:

第 16 段(可获 1.43 积分)
<div data-block="minicart" class="minicart-wrapper">
    <a class="action showcart" href="<?php /* @escapeNotVerified */ echo $block->getShoppingCartUrl(); ?>"
       data-bind="scope: 'minicart_content'">
        <span class="cart-title hidden-xs"><?php /* @escapeNotVerified */ echo __('Shopping cart'); ?>

主题本土化

主题本土化可以通过一系列的词汇来完成。在如下目录搜寻词汇::

  • <parent_theme_dir>/i18n/ (查看所有父主题)
  • <current_theme_dir>/i18n/

I18n文件夹可以存储在每个模块或者应用程序的全局文件夹内。在搜索栏中翻译会优先考虑主题文件夹中的词汇。

第 17 段(可获 0.8 积分)

要在主题文件夹中生成带有翻译的文件,你可以使用I18N工具。你也可以在Magento 2根目录下输入以下命令:

php bin/magento i18n:collect-phrases --output="app/design/frontend/Singree/walkbeyond/i18n/en_US.csv" app/design/frontend/Singree/walkbeyond

这些命令将所有字符串收集到一个词汇表中。文件如下所示:

app/design/frontend/OrangeCo/orange/i18n/en_US.csv

你可以用任何表格编辑器打开 (比如Excel) ,并在正确的列中为每个词语改变翻译值。在主题已经应用后,你可以看到翻译好的字符串。

第 18 段(可获 1.03 积分)

删除主题

如果你的主题是Composer包,你可以用以下命令将主题从root目录删除

php bin/magento theme:uninstall [-c|--clear-static-content] {theme path} ... {theme path}

{theme path}是到主题文件夹最近的路径,本例中{theme path}为frontend/Singree/walkbeyond。

--clear-static-content 删除不需要自动生成的静态文件 如css, js, images。
如果你的你主题不是Composer包,你必须执行以下操作删除主题。

  • 删除主题文件夹app/design/frontend/<Vendor>/;
  • 删除 var/view_preprocessed/ 目录下的内容;
  • 删除 pub/static/frontend 目录下的内容/;
  •  开启Magento 2数据库,找到theme表,删除主题名字的字符串;
  • 使用 php bin/magento cache:flush命令刷新并删除缓存.
第 19 段(可获 1.51 积分)

总结

本文中谈论了有关使用Magento 2创建主题的主要部分,描述了怎么创建目录和文件(主题、图像、预览)结构。此外本文还触及了怎样覆盖给定主题的样式、模板和布局的流程;提及了怎么样使用在线词汇翻译网站。

创建主题的文件夹列表如下所示:

  1. /<Vendor>_<Module> (非必须的; 对给定模块存储样式、模板和布局)
  2. /<Vendor>_<Module>/web/css/source (非必须的; 存储特定模块: .ccs以及.less文件)
  3. /<Vendor>_<Module>/layout (非必须的; 存储主要扩展包或父主题布局)
  4. /<Vendor>_<Module>/layout/override/base (非必须的;存储主主题的覆盖布局)
  5. /<Vendor>_<Module>/layout/override/<parent_theme> (非必须的; 为父主题存储覆盖布局)
  6. /<Vendor>_<Module>/templates (非必须的; 存储模板可以覆盖主模块模板或父模板)
  7. /etc/view.xml (如果主题没有声明是必须的; 存储图像配置信息)
  8. /i18n (非必须的; 存储翻译词汇.csv的文件)
  9. /media (非必须的; 存储预览)
  10. /web (非必须的; 可以从前端上传的静态文件)
  11. /web/css/source (非必须的; 存储Magento UI库的全局元素以及覆盖默认变量值 _theme.less文件)
  12. /web/fonts (非必须的; 储存主题字体)
  13. /web/images (非必须的;储存主题图像)
  14. /web/js (非必须的; 储存javascript文件)
  15. /composer.json (非必须的; 描述主题变量和元数据)
  16. /registration.php (必须的; 用来注册主题)
  17. /theme.xml (非必须的; 存储主题的基本数据和元数据; 使用它以防主题被声明为一个系统组件)
第 20 段(可获 3.69 积分)

在本文中,我已经描述了上述结构的大部分。同时提使用javacsript客户端库(比如require,js)工作的一些准则或者描述如何操作模块和容器也是有意义的。但这样的话文章篇幅就太长了,我希望我提供的上述信息已经足够了。 

谢谢阅读!

第 21 段(可获 0.79 积分)

文章评论

成都访客
为什么我按着你的做,在激活主题后,页面只有一个 mycart