Markup Tags

原文地址

Markup tag (标记) 是一段包含对某个对象的引用的代码,这个对象可以是变量,URL,图片或者 block。Markup tag 可以嵌入到 pages,blocks,email templates,newsletters 等 HTML 片段中。

Markup tag 被包含在{{}}中,注意他是闭合的。而且他可以由 widget tool 生成,可以直接卸载 HTML 内容里。举例来说,你可以使用 markup tag 来表示店铺的 URL,而不是把完整的路径硬编进 page 中。看下面的例子:

Custom Variable

变量的 markup tag 可以用来(向 email 模板,blocks,newsletters,content pages 中)插入自定义的变量。

{{CustomVar code= "my_custom_variable"}}

Store URL

店铺 url markup tag 代表着网站的 base URL,他被当作完整 URL 的第一部分用,就是网站的域名。有两种:store direct_url指向 Base url,store url可以添加参数。

{{store url='apparel/shoes/womens'}}

假设你的 base url 是http://example.com,那么该 markup tag 代表的就是http://example.com/apparel/shoes/womens/

Media URL

动态的媒体 URL markup tag 代表存储在 CDN 上的媒体路径。(译者注:这句不太正确,媒体可以存储在本地,也可以在CDN,都可以使用 media url,他代表着媒体文件的相对位置)

{{media url='shoe-sale.jpg'}}

假设我都是默认配置,媒体文件存储在本地,那么上面的 markup tag 代表的文件是<root>/pub/media/shoe-sale.jpg

Block ID

Block ID markup tag 是最容易使用的一种,可以用来在 CMS page 中插入一个 block,甚至可以在 block 中内嵌一个 block。你可以用它为不同的促销或者语言而修改 block 。他是通过 id 引用的。

{{block id='block-id'}}

Template Tag

template tag 引用 phtml 模板文件。可以用它在 CMS page 或者 static block 中加载 block 。下面的例子展示了如何向 page 或者 block 中插入 Contact US 表单。

“Contact Us” Template Tag

{{block type="core/template" name="contactForm" template="contacts/form.phtml"}}

下面的例子展示的是如何按照 category ID 来显示产品列表

{{block type="catalog/product_list" category_id="22" template="catalog/product/list.phtml"}}

译者注:官方 User guide 还没有更正,Magento 2 中上面的写法不起作用,应该是下面的格式。注意原来是 type 现在是 class,译者就在这里白白浪费了一个小时,桑心~~

{{block class="Magento\Framework\View\Element\Template" name="contactFormwq" template="Magento_Contact::form.phtml"}}

Widget Code

Widget 可以用来展示产品列表,插入复杂的链接,比如基于产品ID的特定产品页。The code that is generated includes the block reference, location of the code module, and corresponding PHTML template. After the code is generated, you can copy and paste it from one place to another.

下面的代码可以用来展示新产品列表

“New Products Grid” Code

{{widget type="catalog/product_widget_new" display_type="new_products" products_count="10" template="catalog/product/widget/new/content/new_grid.phtml"}}

下面的代码可以用来展示一个链接到特定产品页(根据产品ID)的链接。
“Link to Product” Code

{{widget type="catalog/product_widget_link" anchor_text="My Product Link"  title="My Product Link" template="catalog/product/widget/link/link_block.phtml" id_path="product/31"}}

译者注:上面的写法在 Magento 2.1.2 中测试不起作用,译者用 Magento 自带的 Insert Widget 插入第一个例子的 Widget,生成的代码是这样的,各位可以参考下,看看变化。

{{widget type="Magento\Catalog\Block\Product\Widget\NewWidget" display_type="new_products" products_count="10" template="product/widget/new/content/new_grid.phtml"}}

发表评论

电子邮件地址不会被公开。 必填项已用*标注