我们已经详细介绍了您可以使用的一些方法 THEME_DIR/custom/ 目录来复制自定义粒子和主题文件,但对于那些想要进行额外步骤,并实际定制Gantry主题所有方面的有经验的Web开发人员,我们正在为您提供详细的指导。
本特定指南提供的信息可帮助您创建与Gantry的核心,主题等相关文件的定制版本。此资源仅适用于高级用户,可能会破坏功能。如果功能破坏,你应该删除你的内容THEME_DIR/custom/ 目录返回到开箱即用的默认值。
创建自定义文件时,应始终将这些文件保存在您的 custom目录文件中。如果您放置覆盖的文件或编辑此目录路径之外的现有文件,那么在更新Gantry的主题或Gantry框架时,可能会失去这些自定义设置。
在这个文档的其他部分 THEME_DIR指的是主要主题目录。在使用Hydrogen模板的Joomla中,真正的目录路径是/templates/g5_hydrogen/ 与用户的 custom 目录路径是 /templates/g5_hydrogen/custom。
Gantry目录结构
Gantry安装6个扩展。我们已经详细说明了这些扩展,其中包括用于扩展的自定义文件覆盖示例,您可能会在下面自定义文件看到。
为了简单起见,我们在下面的小节中包含了一个快速参考表。
扩展 | 已安装的目录路径 | 自定义目录路径 |
---|---|---|
Gantry 5框架(库) | /libraries/gantry5 |
(见下面的注释) |
/media/gantry5/assets |
TEMPLATE_DIR/custom |
|
Gantry 5 Nucleus Engine(File) | /media/gantry5/engines/nucleus |
TEMPLATE_DIR/custom/engine |
Gantry 5主题(组件) | /administrator/components/com_gantry5 |
TEMPLATE_DIR/custom/admin |
/components/com_gantry5 |
TEMPLATE_DIR/custom/admin |
在PHP中找到PHP类 /libraries/gantry5 也可以被覆盖,但是因为它们需要自动加载,所以这需要一些额外的手动干预,涉及为类添加加载器。
Gantry 5 (封装)
这个包括所有其他核心扩展的安装程序/卸载程序。它是您将安装和卸载的一个包,所有其他包都锁定在这个包中。这个包中没有文件,我们建议定制,因为它对Gantry的操作非常重要,并且不会通过定制提供真正的好处。
Gantry 5 框架(库)
这个扩展包含框架的代码。这段代码安装到/libraries/gantry5并始终可用于每个Joomla扩展。公用资产文件安装到/media/gantry5/assets。所有资产都可以被覆盖/templates/TEMPLATE_DIR/custom
示例文件 | 示例自定义文件 |
---|---|
/media/gantry5/assets/css/font-awesome.min.css |
/templates/TEMPLATE_DIR/custom/css/font-awesome.min.css |
Gantry 5 核心(文件)
Nucleus Engine是由Gantry管理器和所有商业RocketTheme模板在内部使用的呈现引擎。它安装到/media/gantry5/engines/nucleus 所有这些文件都可以在中定制 /templates/TEMPLATE_DIR/custom/engine
示例文件 |
---|
/media/gantry5/engines/nucleus/templates/page.html.twig |
示例自定义文件 |
---|
/templates/TEMPLATE_DIR/custom/engine/templates/page.html.twig |
Gantry 5主题(组件)
这是Joomla管理后台中的Gantry主题管理器。它也用于自定义页面查看的前端。它被安装到两者/administrator/components/com_gantry5 和 /components/com_gantry5。Gantry 特定的管理文件可以被覆盖/templates/TEMPLATE_DIR/custom/admin。
示例文件 |
---|
/administrator/components/com_gantry5/templates/pages/about/about.html.twig |
示例自定义文件 |
---|
/templates/TEMPLATE_DIR/custom/admin/templates/pages/about/about.html.twig |
快捷icon - Gantry 5(插件)
这个简单的插件从Joomla管理控制面板(登录页面)添加一个快捷图标到Gantry主题管理器。
系统 - Gantry 5(插件)
这个插件Bootstraps Gantry5框架并挂钩到一些事件中以提高可用性。它需要始终启用Gantry5模板的功能。
Gantry主题文件
所有模板都位于 /templates夹。不要更改或添加任何文件到模板本身,因为这些更改将在下次模板更新期间被清除。如果你想自定义任何模板文件,你可以这样做templates/TEMPLATE_DIR/custom/文件夹中。
以下是源文件和自定义重复文件的位置示例:
示例文件 | 示例自定义文件 |
---|---|
/templates/TEMPLATE_DIR/images/ipad.png |
/templates/TEMPLATE_DIR/custom/images/ipad.png |
这不仅仅适用于定制现有的文件,还可以添加新的文件,比如粒子(Particle)文件。我们在之前的指南中详细介绍了这个过程,并创建了一个新的粒子(Particle)。您还可以定制公共资产、呈现引擎,甚至是管理员的部分。