Mosets Tree开发笔记
简述：
主要元素有Category, listing, field
Category下有多个listing，listing下可以有多个field，field可以用于搜索与展示，而每个field都有字段类型。除了mtree内的核心字段外，可以加入自定义字段。字段类型类都继承一个公共类(mFieldType)，并实现所有字段功能，后台也可以添加新的mFieldType类来满足复杂的需求。也就是说，如果现有字段提供的功能没有满足需求，可以修改对应类型的mFields基类，或者添加新的mFieldType类。以自定义方式新建的类型是通过后台的Manage field types页来创建类实现，并且代码将存于数据库。
结构：
各页面的模板 components/com_mtree/templates/m2/
字段类型基类 administrator/components/com_mtree/mfields.class.php
字段类(mFields)的成员函数：
getSearchHTML 前台对应字段搜索功能的HTML输出
getInputHTML 后台对应字段录入的HTML输出
getOutput 前台对应字段HTML输出
getJSValidation javascript验证代码
自定义字段逻辑例子：
Name of the field type: texttype
class mFieldType_texttype extends mFieldType {
function getOutput($view=1) {
return $this->getValue();
}
function getInputHTML() {
$html .= sprintf('<input type="text" name="%s" value="%s" />', $this->getInputFieldName(1), $this->getValue());
return $html;
}
}
排序：
mtree.tools.php中的customFieldsSort函数，用于处理自定义字段排序
mFieldType类常用功能：
$this->getParam('showCounter',1); 取得参数
$this->getName(); 取得字段名
$this->arrayFieldElements 得到Elements的值，后台可以设置这个值
$this->getValue(); 取得管理员设置的值
$this->getInputFieldName(1) 取得表单字段名
模板：
page_前缀是主页面，sub_前缀是子页面。主页面包含若干个子页面
page_listing.tpl.php (listing detail 页)
sub_listingDetails.tpl.php (listing detail 子页)
sub_map.tpl.php
sub_reviews.tpl.php
sub_listingSummary.tpl.php (listing summary 子页)
模板调用:
global $savantConf;
$savant = new Savant2($savantConf);
$savant->assign('template_value', value);
$savant->display( 'page.tpl.php' );
-----------------所有模板可用通用----------------
附件图片链接:
$this->jconf['live_site'] . $this->mtconf['relative_path_to_listing_small_image'] . $image->filename
图片位置参数:
relative_path_to_listing_small_image
relative_path_to_listing_medium_image
relative_path_to_listing_original_image
-----------(sub_listingDetails.tpl.php) start :------------
前台取字段值：
$this->fields->getFieldById(字段ID)->getValue()
# display image
$this->fields->getFieldById(23)->getOutput(1)
# not display image
$field = $this->fields->getField();
if($field->fieldType == 'image')
{
$this->fields->next();
continue;
}
# filter field
if(in_array($field->getId(), array(cf_id))) {
$this->fields->next();
continue;
}
----------(sub_listingDetails.tpl.php) end;-----------------
