教程栏目

joomla中文网出品的官方教程

 为了方便的在页面中展示模块,Joomla核心提供了一个 “Content - load Modules”插件,这个插件提供了三种方法在页面中展示模块。分别是loadposition, loadmodule 和 loadmoduleid

理论依据


当“内容 - 加载模块”插件开启的时候,我们可以方便的将模块放置到任何的地方,比如文章中。这种插件提供3中方法来记载模块,其语法是:

  • {Xloadposition position,[style]}     {Xloadposition 模块位置的名称,[风格]}  
  • {lXoadmodule mod_type,the title,[style]}   {Xloadmodule 模块的类型,模块的标题,[风格]}
  • {Xloadmoduleid moduleId}   {Xloadmoduleid 模块的ID} 

其中style是可选的。请将{X替换为{

loadposition

通过模块的位置来加载模块。如果你希望显示模块为“zmaxtab” 的模块,我们可以使用 {Xloadposition zmaxtab}.  这样的语法来显示模块。这个语法支持style参数,如  {Xloadposition zmaxtab  ,xhtml}.

loadmodule

通过模块的类型和标题来加载模块。如果你希望显示标题未 “用户登录” 模块,那么首先你需要这个用户登录模块的类型为mod_login .他的标题未 “用户登录”。所以我们可以使用 {Xloadmodule mod_login 用户登录}.  这样的语法来显示模块。这个语法支持style参数,如  {Xloadmodule mod_login 用户登录 ,xhtml}.

loadmoduleid

通过模块的ID来加载模块,如果你希望显示ID为200的模块,那么使用{Xloadmoduleid 200}. 这个方法不支持Style参数。

如何使用?


对于普通的用户,一般会在文章或者自定义HTML模块中来使用。

在文章或者自定义HTML模块中,那么直接使用上面3个语法中的一个。直接复制到文章中,让后将其中的参数进行实际替换即可。如采用loadpostion方法,直接复制{Xloadposition position}到文中,然后将后面的参数postion替换为具体需要使用的位置(user1)。 最后在文章中为{Xloadposition user1}.保存后,插件会自动将这个地方的内容替换为对应模块的输出。刷新前台页面即可看到效果

值得注意的是,如果你在自定HTML模块中使用上面的语法来加载模块,那么你必须确保自定义HTML模块的参数允许执行内容插件设置为是。如图:

 

默认情况下,系统自动的编辑器中是自带有插入模块的功能按钮,直接使用插入模块按钮来插入模块。其最终也是将上面的代码插入到编辑器中。

对于开发者

如果你希望使用PHP代码来输出模块,其使用语法和上面类似。代码如下:

<?php echo   JHTML::_('content.prepare', '{loadmoduleid 模块的ID}');  ?>

模块不显示的原因


使用此种方法显示模块,也通用遵循模块的菜单分配和模块的访问级别。当指定的模块没有出现的使用请参考如下的方法排查

  • 1,检查显示模块的字符串是否原样输出。如果是原样输出,那么说明你的加载模块插件可能没有启用,或者你写的加载模块的代码出现了语法错误,检查是否打错了字
  • 2,如果输出模块代码没有在前台显示,但模块就是没有出现。那么检查模块的菜单指派(是否指派在当前的页面上了),或者检查模块的访问权限是否给到了当前用户

 

作者: 樱木花道

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

作者网站:ZMAX程序人

评论 (0)

  • 最新在前
  • 最佳在前

第1章 Joomla入门教程

第3章 C计划

第5章 E计划

第6章 H计划

第7章 G计划

第9章 运行环境

第11章 主从与集群

第12章 模块开发

第13章 插件开发

第14章 j2.x组件开发教程

第15章 页面定制教程

第16章 页面构造器

第17章 joomla升级

第18章 其他系统迁移

第19章 流量翻倍计划

第20章 wordpress主题开发教程