elcodi-templates / store-template-bundle
Bamboo的店铺模板包
Requires
- php: >=5.4
- elcodi/bamboo-bundle: ~0.4.0
- symfony/http-kernel: ~2.6
Provides
- elcodi-templates/template: ~0.4.0
This package is not auto-updated.
Last update: 2024-09-14 17:31:51 UTC
README
你好!我是一个已弃用的包。我已经被移动到elcodi-plugins/StoreTemplateBundle。谢谢 :D
为 bamboo/elcodi 定制的模板
为了使模板完全兼容 Bamboo 引擎(elcodi 电子商务实现),我们创建了一个小标准。通过自定义此包,您可以创建 bamboo/elcodi 的主题。请在编辑任何内容之前仔细阅读此文档。
所有模板在实时模式下的要求
要使用这些模板在真实环境中,您需要安装和设置本地 Bamboo/elcodi
预览 twig 文件为 html 的要求
可以将 twig 文件编译为 html 以预览您的模板,而无需拥有所有真实环境。您需要做的只是按照以下步骤操作
- 安装 NodeJS
- 在模板的根目录中运行 "npm install"
- 安装 Ruby & Sass
- 运行 "Grunt" 以编译或 "Grunt Watch" 以在保存任何 .twig 或 .scss 文件时编译
文件夹
让我们看看这个包的所有文件夹以及里面有什么。
固定值
此文件夹包含模拟数据库和每个模板中可用的变量的 json 文件。这是一个只读文件夹,可能对您的信息有所帮助,但您不应更改任何内容。
资源
这是您的模板的主要文件夹。在此文件夹中,您将找到两个子文件夹:Public & Views。
Public
此目录用于托管模板所需的所有公共文件(图像、字体、javascript...)。此文件夹的结构由您决定,默认实现只是一个建议。
Views
在这里您可以找到所有必需的 .html.twig 文件,用于店铺模板。请参阅模板文件部分以获取更多信息。
SCSS
此默认模板从该文件夹获取 SCSS 代码并将其编译到 "Resources/Public/css/"。但这只是一个建议,使用 Sass 不是强制的,当然您可以将 CSS 直接放在公共文件夹中。
工作环境文件夹
在安装了节点模块、sass 和 grunt 之后,您将有一些文件夹。这些文件夹永远不会被提交,仅用于工作环境,如果需要,请记住在 git 忽略它们。
模板文件、上下文和钩子
twig 模板位于 "Resources/views"。在 Bamboo 中,我们使用 Twig 作为模板。因此,您可以扩展、包含和组织您的模板,如您所愿。所有文件都是按类型组织的,因为一些模板是必需的,而其他则完全由您决定,初始组织只是一个建议。
全局
以下上下文和钩子在所有 twig 文件中可用。
#### 全局上下文 所有 twig 文件都将有以下上下文可用
- current_user_session_id : 当前用户会话 id
- current_user_session_sha1 : 当前用户会话 id,应用了 sha1
- current_route_name : 当前路由名称
- store_tracker : 店铺跟踪值。每个店铺唯一。
#### 全局钩子 所有twig文件都将有以下上下文可用
- store.head_bottom : @todo 添加描述
- store.body_top : @todo 添加描述
- store.body_bottom : @todo 添加描述
布局
_checkout.html.twig
此布局用于结账过程页面,但不是必需的,因为最终会调用主布局文件并覆盖“内容”块。
_email.html.twig
用于邮件的布局。邮件内容可在竹子管理员中进行编辑,这只是一个容器。@todo 模板为空
_static.html.twig
此布局是必需的,由所有静态页面和博客页面调用。静态内容将在“内容”块中渲染。 上下文
- page : @todo 添加描述
_layout.html.twig
这是您模板的基本布局,是必需的,并且需要以{% extends '::_base.html.twig' %}开始,并包含以下块。
{% block head_style %}
此块在页面头部,目的是在这里包含所有需要在页面中定义的css或其他内容。
{% block body %}
此块从开始到结束都是body...因此,您需要在这里添加模板的html代码。此块内部定义的块完全由您决定。
{% block foot_script %}
此块在body块之后开始,在关闭body之前结束。因此,目的是在这里包含模板的所有脚本。
模块
这里的所有文件都包含在其他文件中,因此如果您从其他文件中编辑包含内容,您可以按需组织此文件夹。从我们的角度来看,这种组织是有意义的,但这只是我们的近似值。
页面
此文件夹中的所有文件都是必需的。这些都是从控制器调用的主要文件,因此如果您删除或重命名其中一个,模板将无法工作。
cart-view.html.twig
用户点击结账按钮时显示的页面。 上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
cart-checkout-fail.html.twig
在支付过程中发生失败后显示的页面。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
cart-view.html.twig
列出添加到购物车中的产品。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
category-view.html.twig
列出某一类别中的产品。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
home-view.html.twig
主页,列出标记为在主页显示的产品。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
order-list.html.twig
用户完成的订单的历史记录列表。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
order-view.html.twig
一个订单的详细信息。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
product-view-item.html.twig
一个产品的详细信息(无变体)。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- store.product_view_bottom:@todo 添加钩子描述
- product:@todo 添加钩子描述
product-view-variant.html.twig
一个产品(带有变体)的详细信息。默认情况下扩展product-view-item.html.twig并覆盖product_info_add_basket块。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- store.product_view_bottom:@todo 添加钩子描述
- product:@todo 添加钩子描述
static.html.twig
静态页面的布局。静态内容将在“内容”块中渲染。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
store-disable.html.twig
当店铺未配置为启用时显示的页面。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
store-under-construction.html.twig
当店铺标记为建设中时显示的页面。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
user-edit.html.twig
用户控制面板内用于编辑个人数据的页面。仅在用户登录时可用。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
user-home.html.twig
用户控制面板的主页。仅在用户登录时可用。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
user-login.html.twig
带有登录用户表单的页面。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
user-password-recover.html.twig
带有密码恢复表单的页面。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
user-register.html.twig
带有用户注册表单的页面。
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
address-edit.html.twig
当用户添加或编辑他的地址时显示的页面。此页面包括来自Geo包的LocationSelectors JS,以使城市选择器正常工作。
上下文
- 地址:正在编辑的地址,如果设置了id字段,则正在编辑地址;如果为空,则为新地址。查看地址对象文档 钩子
- 表单:添加地址的表单。查看“store_geo_form_type_address”文档
blog-posts-list.html.twig
博客分页。此页面列出所有可用的博客文章,包括简单的分页。文章数量为N
上下文
- blogPosts:要显示的blogPost元素数组
- currentPage:当前显示的页面
- numberOfPages:页数 钩子
- store.blog_posts_list_bottom -- blog_posts -- current_page -- number_of_pages
blog-posts-view.html.twig
博客文章页面。
上下文
- blogPosts:要显示的blogPost元素数组 钩子
- store.blog_posts_list_bottom -- blog_posts
子页面
此文件夹中所有文件都是必需的。子页面是通过使用render方法而不是include方法包含的模块。每个子页面都有一个url可以直接调用它们,但访问此页面没有意义,因为页面的部分很小。将子页面作为模块而不是模块的原因仅仅是出于性能和可持续性的考虑。
cart-nav.html.twig
此子页面是一个模块,用于预览购物车的内容
上下文 上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
category-nav.html.twig
此子页面是一个模块,用于显示所有类别和子类别
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
coupon-add.html.twig
此子页面是一个模块,用于向购物车添加优惠券的表单
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
currency-nav.html.twig
此子页面是一个模块,用于显示商店中启用的所有货币
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
user-nav.html.twig
此子页面是一个模块,用于显示用户的导航选项
上下文
- @todo 添加上下文:@todo 添加描述 钩子
- @todo 添加钩子:@todo 钩子描述
对象数据
这些都是您将在上下文中获得的详细对象。请检查模板上下文以查看它们何时可用。
地址
表单数据
这些都是您将在上下文中获得的详细表单对象。请检查模板上下文以查看它们何时可用。
store_geo_form_type_address
有问题吗?
如果您有任何问题,请随时在Gitter上提问或通过tech@elcodi.com给我们发邮件