官方系列教材 - C计划

实战Joomla模板开发教程

组件输出相信看到现在的朋友应该不陌生了。今天我们谈到的组件输出页面和组件输出是有直接关系的。所谓的组件输出页面,就是这个页面只有组件的输出没有任何的模块。为什么会出现这种页面呢?以及这种页面有什么作用?我们作为模板开发者是否可以自定义它呢?在这一节将为你一一说明

1,本节目标


了解组件输出页面的用法,以及如何自定义组件输出页面

2,组件输出页面


组件输出页面最常见的一个用法就是打印界面或者pdf导出页面。下面以打印功能来举例说明

2.1 joomla的文章默认是支持打印功能的。如图:

2.2 点击打印,可以进入到打印内容界面。如图:

在这个页面中我们只看到了文章的信息,顶部的菜单,周边的模块都没有显示。对于用户来说,打印文章的内容这正是它需要的。这就是组件输出页面的一个重要的应用。

3,自定义组件输出页面


当系统检测到当前需要使用组件输出页面的时候,会自动寻找当前模板下的component.php文件。如果在当前模板下没有找到component.php文件,那么系统就会加载templates/system/component.php文件。因此,我们现在需要做的就是在模板下面新建一个component.php文件。然后在component.php文件中写入我们需要的页面。典型的代码如下:

<!DOCTYPE html>
<html>
	<head>
		<jdoc:include type="head" />
	</head>
	<body class="contentpane">
		<jdoc:include type="component" />
	</body>
</html>

上面的代码只定义了一个组件输出位置,非常的简单。

 4,v0.0.21版本


 4.1 代码

在本次版本中,我们为模板设计了组件输出页面。当我们在模板的根目录下新建一个component.php文件后,这个component.php文件会替换系统默认的组件输出页面。以此达到定制组件输出页面的目标。

4.2 前台效果

再次刷新点击打印,可以看到定制后的页面。如图:

相比默认版本,我们减少了一些边距以及加上了一个边框。

4.3 v0.0.23版本

关于v0.0.23版本的代码,可以在此下载[下载文件:]tpl_plancv0.0.23_2019-01-22_for_j3x.zip

5,说明


  • 在本版本中我们增加了component.php文件,在打包安装包的时候不要忘记在templateDetail.xml文件中增加 

作者: 樱木花道

Joomla程序员,从J1.5到J4.x始终都在做Joomla相关开发定制工作,有超过10年行业经验,国内Joomla扩展开发商ZMAX团队的核心成员

作者网站:ZMAX程序人

评论 (0)

  • 最新在前
  • 最佳在前

第3章 Joomla模板机制

第13章 让模板支持多语言

第16章 结束语