你现在的位置:首页 > PHP网站建设知识库 > Joomla > 正文

Joomla!表单XML文件编写参考手册

有关joomla!表单XML的使用方法和功能描述,请参考这篇文章:

<?xml version="1.0" encoding="utf-8"?>  
<form>  
 <name>Showcase Form</name>  
 <params>  
  <param name="catid" type="list" size="20" default="0" label="Category ID" description="Category ID">  
   <option value="0">Public</option>  
   <option value="1">Registered</option>  
   <option value="2">Special</option>  
  </param>  
  <param name="title" type="text" size="20" default="" label="title" description="title" />  
 </params>  
</form>  
 

我们看到每个param item都包含以下几项:

name - field 名称
type - field类型, text, a list box, etc
label - form中显示的标签
description - tooltip 显示的文字
default - 默认值

在一个params section可以书写多个 param


<params>  
  <param ... />  
  <param ... />  
</params>  
 
你可以在params处指定addpath,这个目录下放置自定义的element文件。(关于element的自定义我们另外说明)


<params addpath="/components/com_contact/elements">  
  <param ... />  
 
Joomla! core中目前已经提供的element 类型包括以下几种:

文章分类选择列表


<param name="catid" type="category" default="0" label="Category" description="An article category" />  
 
添加一个section 属性,你也可以选择其他组件的分类数据,比如下面的代码选择 weblinks的分类。


<param name="catid" type="category" section="com_weblinks" default="0" label="Category" description="A weblinks category" />  
 
可视化编辑器:选择一个可视化编辑器


<param name="editor" type="editors" default="" label="User Editor" description="WYSYWYG Editor for this User" />  
 
文件列表:


<param name="file_name" type="imagelist" directory="/images/stories" filter="" hide_default="1" default="" label="Menu Image" description="PARAMMENUIMAGE" />  
 
各参数定义如下:

directory - 文件列表的目录
filter - 过滤器,这是一个正则表达式
exclude - 排除文件,一个正则表达式
stripext - set to 1 to strip the file extension in the list
hide_none - set to 1 to hide the ‘Do not use’ list option
hide_default - set to 1 to hide the ‘Use Default’ list option

 


Helpsites


<param name="helpsite" type="helpsites" default="" label="Help Site" description="Help site for this User" />  
 
Imagelist


<param name="menu_image" type="imagelist" directory="/images/stories" hide_default="1" default="" label="Menu Image" description="PARAMMENUIMAGE" />  
 
hide_default - set to 1 to hide an automatic Use Default entry in the list


语言选择


<param name="language" type="languages" client="site" default="" label="Front-end Language" description="paramLanguage" />  
 
List


<param name="link_titles" type="list" default="" label="Linked Titles" description="Make the Item titles linkable">  
 <option value="">Use Global</option>  
 <option value="0">No</option>  
 <option value="1">Yes</option>  
</param>  
 
Menu
Menu Item


<param name="menu_item" type="menuitem" label="Menu Item" />Radio  
<param name="cache" type="radio" default="0" label="Enable Cache" description="PARAMENABLECACHE">  
 <option value="0">No</option>  
 <option value="1">Yes</option>  
</param>  
 
Section


<param name="sectionid" type="section" default="0" label="Edit posts" description="Set the section to retrieve posts from" />  
 
Spacer


<param name="@spacer" type="spacer" default="" label="" description="" />  
 
Text


<param name="moduleclass_sfx" type="text" default="" label="Module Class Suffix" description="PARAMMODULECLASSSUFFIX" />  
 
Textarea


<param name="description_text" type="textarea" default="" label="Description Text" rows="5" cols="30" description="PARAMDESCTEXT"/>  
 
rows - the number of rows for the 
cols - the number of columns for the textarea

我们最常使用的是 Text,Textarea,List,radio,hidden等