JA T3 框架V2.0开发指南-6

JA T3 框架V2.0开发指南

——模板管理

新版本里，模板管理改良了：通过内置编辑和上传功能，模板定制更为容易，通过AJAX 的运用，模板定制更为快速。管理面板分为五个部分：

?全局（Global Panel）：系统设置和模板全局设置；

?配置（Profiles Panel）：模板设计的设置和预置；

?布局（Layouts Panel）：模板布局的管理；

?主题（Themes Panel）：模板颜色主题的管理；

?升级与帮助（Help & Update Panel）：版本信息及帮助文档源。

每个面板都内置了快速指南，每个设置都提供了操作提示和使用向导，所以，模板管理面板一定会成为你最好的朋友！

一、全局面板

1、总览

该面板控制系统和模板的全局行为，以及压缩设置。所有项目最小化时，如下图：

2、语言与页面分配

这个功能允许用户为指定页面与内容组件去覆盖配置，默认情况下，所有页面和内容组件都使用默认配置，但你可以创建无限的配置覆盖。

若想要为一个或多个页面及内容组件改变模板设置，请参看这个快速指南：

第一步：点击“点击添加”，打开“语言与页面分配”选项；

第二步：在左侧下拉列表中选中一个或多个菜单项与组件（按ctrl键可以多选），并点击选定（select）按钮确认；

第三步：选定要用于这些页面的配置文件；

第四步：点击“保存”按钮。

注意：

当使用SEF功能时，某些原因会导致配置覆盖的设置失效，因为在joomla网站中，有些链接指向特定的内部页面，但这些链接并不是总能得到Itemid值；不过，其他的SEF组件，比如sh404SEF可以解决这个问题，因为该组件可以确保所有这些没有Itemid 值的链接得到一个相应的Itemid值（Itemid=5），这样，有了Itemid，框架就可以加载正确的配置了。

3、系统设置

这个选项管理模板的缓存特性，如下图：

启用开发模式：启用该模式，将完全禁用所有缓存，这样在页面刷新时，你可以即时看到自己定制的效果。对于有巨大通信量需要缓存的成品网站，建议禁用这个模式。

缓存模式：模板缓存，能降低网站生成前台HTML的PHP访问请求量。

缓存排除：为特定的组件或位置禁用缓存。例如：

?position=user1,user2 ——指定的位置禁用缓存；

?component=com_virtuemart,com_fireboard——指定的组件禁用缓存。

开发这个特性是为了避免AJAX内容的脚本冲突。

4、压缩设置

1）优化CSS：优化网站使用的所有CSS。选项：

?No——不使用CSS压缩。

?Linked files——使用@import功能导入所有CSS文件到一个单一的CSS文件中，减少浏览器的请求。这可以修复ie相关的最大30个CSS文件的限制。

?Join & Minify——组合最小化与合并优化。最小化是去掉空白空间与无用字符（注释之类），不改变代码功能；合并是将最小化以后的文件内容并入一个单一文件，下面选项，可以设置这个文件的存储目录。

?Join & Minify & Compress——使用joomla的gzip压缩脚本压缩Join & Minify产生的CSS文件。

2）优化JS：优化网站使用的所有JS。选项：

?No——不使用JS压缩。

?Join——只合并所有JS文件到一个单一的JS文件中，下面选项，可以设置这个文

件的存储目录。

?Join & Minify——组合最小化与合并优化。最小化是去掉空白空间与无用字符（注释之类），不改变代码功能；合并是将最小化以后的文件内容并入一个单一文件，在下面，可以设置这个文件的存储目录。

?Join & Minify & Compress——使用joomla的gzip压缩脚本压缩Join & Minify产生的JS文件。

3）优化文件夹：优化后的CSS/JS文件的存储位置，默认是网站根目录下的t3-assets 文件夹。

注意——该文件夹必须可写。

4）优化排除：加入不想被优化的JS/CSS文件名（不含路径），每个文件一行。例如：template-rtl.css

mega.js

二、配置面板

1、总览

该面板管理配置：创建、克隆、编辑、删除（自定义）配置。你可以为每种配置定义所有的模板设置项：logo、字号、菜单系统、颜色主题、文字方向等等。这些设置分配在几个选项卡中，下面就会讲到。

2、配置类型

配置分为两种类型：

默认配置——不能被删除，因为它是框架核心的一部分，但可以定制或重置。

用户创建的配置——加载用户布局、主题及其他自定义设置。

3、编辑配置

所有用户创建的配置（默认配置的克隆或者自建配置）都覆盖默认配置的设置，要编辑配置，可以参考这个快速指南：

第一步：选择自建的配置或配置克隆；

第二步：点击复选框激活任意项的定制功能，改变参数值或选项；注意，有设置项改变时，选项卡会自动检测到，以方便设置；

第三步：点击“保存”按钮保存设置。

?注意：设置项未被选中则不能更改，也不会覆盖默认值。

4、全局设置

全局设置中可以自定义：

Logo：图片或文字；

字号：设置字号，可以从六种字号中选择：10px到15px；

模板宽度：自动、宽屏、窄屏、指定宽度；指定宽度定义值低于100（不含100），则视为百分比，高于（含100）视为像素值；

隐藏主区块：设置显示或隐藏主内容区块；

文字方向：左到右或右到左；

T3 logo：有五个选项：

?不显示——隐藏T3 logo；

?亮色logo——显示默认T3 logo；

?暗色logo——显示暗色T3 logo；

?亮色小logo——默认颜色显示小型T3 logo；

?暗色小logo——暗色显示小型T3 logo。

注意：T3 V1.6版以后，文字方向选项已经移除，全局设置面板相应改变（如下图）。文字方向将随语言方向而改变。

5、Google字体API设置

框架引入了一种字体替换方案：Google WebFonts。这里可以设置：

?全局：指定一种特定字体应用于前台全局。

?Logo：logo字体（logo项选择文字时）。

?标语：文字logo下的标语行的字体。

?模块标题：用于网站中所有模块的标题。

?页面标题：菜单项页面标题的字体。

?内容标题：文章或项目标题的字体。

对于以上每种元素，都可以加入自定义的CSS样式，每行一个样式定义，例如：

font-size:18px;

font-weight:bold;

注意：要激活/编辑Google字体API，键入字体组合（Font Family），相应的字体变化（Font variant）和字体子集（Font Subset）会显示于下拉列表。

6、菜单设置

该设置用于配置网站的主导航菜单：

?要加载的菜单（默认是主菜单）；

?菜单系统：Split Menu, CSS Menu, Mega Menu, Dropline Menu；

?菜单渲染的开始点与结束点；

?如果选择了Mega Menu项，还可以自定义动画设置：

●动画类型：无、滑动、渐变、滑动与渐变；

●动画持续时间：以毫秒计数的动画时间；

●隐藏延迟时间：以毫秒计数的菜单隐藏延迟时间。

7、用户工具

该选项设置允许前台用户使用的工具，每种布局都可以显示或隐藏任意用户工具：?字体工具开关

?屏宽工具开关

?配置工具开关（配置多于两个时生效）

?布局工具开关（布局多于两个时生效）

?菜单工具开关

?文字方向工具开关

●注意：T3 V1.6及更高版本，文字方向工具开关已移除，新图示如下：

8、主题设置

主题设置允许你覆盖默认主题的样式。操作步骤如下：

第一步：点击编辑图标打开主题选项框；

第二步：选中一个或多个用于覆盖默认主题的主题；

第三步：点击“应用”按钮；

第四步：点击或拖动主题以设置喜欢的顺序：左数第一个主题将覆盖所有右边的主题，最后一个主题是默认主题，该主题位置锁定，不能拖动。

第五步：点击模板设置面板上方的“保存”按钮保存新的主题设置。

9、布局设置

布局设置中，可以为每种配置，每种用户设备类型设置默认布局。包括：

?桌面电脑的默认布局

?手持设备的默认布局

?iPhone的默认布局

●注意：T3 V1.6及更高版本，提供了更多的支持选项，单独的安卓布局，新设置面

板如下：

三、布局面板

1、总览

在这个面板里，可以管理模板使用的布局。

2、布局类型

如上所示，有两种布局类型：

默认布局——模块开发者提供，并可以作为用户创建自己布局的样板。默认布局不能删除，它是模板核心的一部分。

用户创建的布局——最终用户建立的布局，以应用其期望的样式。

3、编辑布局

框架自带了内置的编辑器，以便更容易的定制布局。要编辑布局，这里有快速指南：

第一步：在面板中点击目标布局的编辑链接，打开如下所示的布局编辑器；

第二步：用上述编辑器自定义布局，详见开发指南布局篇；

第三步：点击编辑器的“保存”按钮保存布局。

四、主题面板

1、总览

开发这个面板是为了减少多主题管理的工作量。在这里，可以创建自己的颜色主题，打包它们，并把它们上传到模板后台中主题文件夹的正确位置，就像安装一个模板扩展。

有两种主题类型：

默认主题——由模板提供，不可删除，它是模板核心文件的一部分。

用户创建的主题——有关自定义主题的详细介绍，请参见FAQs。

2、上传主题

基于默认核心主题，你可以创建自己的主题，并上传到网站后台的正确位置。例如，你要设计一个名为green的主题，可以参考这个快速指南：

第一步：完成创建该主题；

第二步：把主题打包为zip文件；

第三步：点击“选择文件”定位对应文件；

第四步：点击“上传并安装”按钮。

新上传的主题将出现在面板的主题列表里。

五、升级与帮助面板

该面板支持：

查看当前版本信息。

用JA扩展管理器作版本检查和升级。（ms这个功能没在这里，需要另装一个独立组件）

这个面板也提供一些帮助文档源。

最后，奉上几个相关链接：

框架综述：https://www.360docs.net/doc/f417855216.html,/wiki/JA_T3_Framework_2/Overview 开发指南：https://www.360docs.net/doc/f417855216.html,/wiki/JA_T3_Framework_2/Guides

常见问题：https://www.360docs.net/doc/f417855216.html,/wiki/JA_T3_Framework_2/FAQs

导航系统：https://www.360docs.net/doc/f417855216.html,/wiki/JA_T3_Framework_2/Navigation