MAGENTO 后台模块开发五

在这一章节中，我们将会了解关于 Magento 后台表单更多延续的操作
在之前的一些章节里，我们仅仅只是了解了下后台表单的基础操作， 所以在这次旅程中我们将熟悉更多关于后台表单的操作

为表单 容器/视窗 添加按钮

在表单里，我们可以根据自己的需求添加多个按钮， 如下图所示，我在表单里额外添加了4个按钮

首先我们修改下上次建立过的 Excellence_Employee_Block_Adminhtml_Employee_Edit.php， 代码如下:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52

class Excellence_Employee_Block_Adminhtml_Employee_Edit extends Mage_Adminhtml_Block_Widget_Form_Container {      public function __construct ( )      {          parent :: __construct ( ) ;            $this -> _objectId = 'id' ;          $this -> _blockGroup = 'employee' ;          $this -> _controller = 'adminhtml_employee' ;            $this -> _updateButton ( 'save' , 'label' , Mage:: helper ( 'employee' ) -> __ ( 'Save' ) ) ;          $this -> _updateButton ( 'delete' , 'label' , Mage:: helper ( 'employee' ) -> __ ( 'Delete' ) ) ; // $this->removeButton('reset');          $this -> _addButton ( 'saveandcontinue' , array ( 'label'      = > Mage:: helper ( 'adminhtml' ) -> __ ( 'Save And Continue Edit' ) , 'onclick'    = > 'saveAndContinueEdit()' , 'class'      = > 'save' , ) , - 100 ) ;            $this -> _addButton ( 'button1' , array ( 'label'      = > Mage:: helper ( 'adminhtml' ) -> __ ( 'Button1' ) , 'onclick'    = > 'setLocation(\'' . $this -> getUrl ( '*/*/button1Click' ) . '\')' , 'class'      = > 'back' ,          ) , - 1 , 5 ) ;                   $this -> _addButton ( 'button2' , array ( 'label'      = > Mage:: helper ( 'adminhtml' ) -> __ ( 'Button2' ) , 'onclick'    = > 'setLocation(\'' . $this -> getUrl ( '*/*/button2Click' ) . '\')' , 'class'      = > 'save' ,          ) , - 1 , 3 ) ;                   $this -> _addButton ( 'button3' , array ( 'label'      = > Mage:: helper ( 'adminhtml' ) -> __ ( 'Button3' ) , 'onclick'    = > 'setLocation(\'' . $this -> getUrl ( '*/*/button3Click' ) . '\')' , 'class'      = > 'delete' ,          ) , - 1 , 1 ) ;                   $this -> _addButton ( 'button4' , array ( 'label'      = > Mage:: helper ( 'adminhtml' ) -> __ ( 'Button4' ) , 'onclick'    = > 'setLocation(\'' . $this -> getUrl ( '*/*/button4Click' ) . '\')' , 'class'      = > 'delete' ,          ) , - 1 , 4 , 'footer' ) ;      }        public function getHeaderText ( )      {          return Mage:: helper ( 'employee' ) -> __ ( 'My Form Container' ) ;      }   }

上面代码中我们使用到的方法是 $this->addButton， 让我们现在来详细看下各个参数的作用

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

参数 1    "button id" //每个按钮都有自己唯一的 id   参数 2    "button parameter array" //这个数组里面你可以为该按钮定义 label, onclick, class， //class 有三个不同的值 （delete、 save 和 back），这可以根据你的按钮实际用途来选择，你也可以留空，即: 默认按钮   参数 3    "level" //这个通常用来和其他按钮“组合”在一起，直接和后面一个参数 sort_order 联系在一起   参数 4    "sort_order" //这个参数来决定在同一个组(level) 里的按钮显示的先后顺序   参数 5    "aera" //它含有两个值（'header' 和 'footer'）， 默认的值为 header， 如果你想按钮显示在底部，那么你需要在这个参数里写上'footer'

添加多个表单选项卡和基于 Ajax 的选项卡

添加多个选项卡，那么我们就要修改下之前我们所建立的 Tabs.php 文件了

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41

class Excellence_Employee_Block_Adminhtml_Employee_Edit_Tabs extends Mage_Adminhtml_Block_Widget_Tabs {        public function __construct ( )      {          parent :: __construct ( ) ;          $this -> setId ( 'employee_tabs' ) ;          $this -> setDestElementId ( 'edit_form' ) ;          $this -> setTitle ( Mage:: helper ( 'employee' ) -> __ ( 'Employee Information' ) ) ;      }      protected function _beforeToHtml ( )      {            $this -> addTab ( 'form_section' , array (            'label'      = >      Mage:: helper ( 'employee' ) -> __ ( 'Employee Information' ) ,            'title'      = >      Mage:: helper ( 'employee' ) -> __ ( 'Employee Information' ) ,            'content'    = >      $this -> getLayout ( )                                  -> createBlock ( 'employee/adminhtml_employee_edit_tab_form' )                                  -> toHtml ( ) , )          ) ;            $this -> addTab ( 'form_section2' , array (            'label'      = >      Mage:: helper ( 'employee' ) -> __ ( 'Employee Information2' ) ,            'title'      = >      Mage:: helper ( 'employee' ) -> __ ( 'Employee Information2' ) ,            'content'    = >      $this -> getLayout ( )                                  -> createBlock ( 'employee/adminhtml_employee_edit_tab_form2' )                                  -> toHtml ( ) , )          ) ;            $this -> addTab ( 'form_section3' , array (    'label'      = >      Mage:: helper ( 'employee' ) -> __ ( 'Employee Information3' ) ,    'url'        = >      $this -> getUrl ( '*/*/form' , array ( '_current' = > true ) ) ,    'class'      = >      'ajax' , ) ) ;          return parent :: _beforeToHtml ( ) ;      } }

正如如上代码所示，添加一个正常的 html 选项卡所需要的操作是:

1 2 3 4 5 6 7

$this -> addTab ( 'form_section2' , array (    'label'      = >      Mage:: helper ( 'employee' ) -> __ ( 'Employee Information2' ) ,    'title'      = >      Mage:: helper ( 'employee' ) -> __ ( 'Employee Information2' ) ,    'content'    = >      $this -> getLayout ( ) -> createBlock ( 'employee/adminhtml_employee_edit_tab_form2' ) -> toHtml ( ) , ) ) ;

代码十分简单，我们只是定义了一下 label, title 和所对应的 content 内容
而一个基于 Ajax 的选项卡，那就有一点复杂了

1 2 3 4 5

$this -> addTab ( 'form_section3' , array (    'label'      = >      Mage:: helper ( 'employee' ) -> __ ( 'Employee Information3' ) ,    'url'        = >      $this -> getUrl ( '*/*/form' , array ( '_current' = > true ) ) ,    'class'      = >      'ajax' , ) ) ;

代码中我们定义了 ‘class’ 的值为 ‘ajax’，并且用 ajax url 去加载所对应的内容，在我们的后台控制器里， 这个 URL 会对应我们的 ajaxAction， 代码如下:

1 2 3 4 5 6 7 8 9

public function formAction ( ) { $this -> loadLayout ( ) ; $this -> getResponse ( ) -> setBody ( $this -> getLayout ( ) -> createBlock ( 'employee/adminhtml_employee_edit_tab_form3' ) -> toHtml ( )      ) ; }

通常，我们会用基于 Ajax 的选项卡 – 所对应的内容区域里面加载 Grid 表， 如何在选项卡所对应的内容区域里加载 Grid 表，请见后一章节

创建新的文本标签

在上一章节中，我们已经看到了在 Magento 表单中所有不同类型的 文本框 或 HTML 标签， 现在让我们看下如何来添加一个新的类型，首先添加如下代码至 Form.php 文件中的 _prepareForm() 方法当中:

1 2 3

$fieldset -> addType ( 'custom_field' ,                    'Excellence_Employee_Block_Adminhtml_Employee_Edit_Tab_Field_Custom' ) ;

在这里，我们调用了 addType() 方法， 并且定义了该标签的唯一 id 和 class 文件，下一步就是来为其添加标签

1 2 3 4 5 6 7

$fieldset -> addField ( 'custom_field' , 'custom_field' , array (            'label'        = >      Mage:: helper ( 'employee' ) -> __ ( 'Checkboxs' ) ,            'name'        = >      'Checkbox' ,            'custom1'      = >      'Custom1 Value' ,            'custom2'      = >      'Custom2 Value' ,            'value'        = >      'value1' ) ) ;

在 addField() 方法中我们使用了 custom_field 作为一个新的标签类型，我们也同时定义了两个变量 custom1 和 custom2， 这么做只是为了演示如何把变量传到 custom field 类中， 接下去我们需要创建 custom field 类了

PHP

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

class Excellence_Employee_Block_Adminhtml_Employee_Edit_Tab_Field_Custom extends Varien_Data_Form_Element_Abstract {      public function __construct ( $attributes = array ( ) )      {          parent :: __construct ( $attributes ) ;      }        public function getElementHtml ( )      {          $value      =    $this -> getValue ( ) ;          $custom1    =    $this -> getCustom1 ( ) ;          $custom2    =    $this -> getCustom2 ( ) ;          $html        =    '<p id="' . $this -> getHtmlId ( ) . '"' . $this -> serialize ( $this -> getHtmlAttributes ( ) ) . '>在这里我可以放自定义的 html 或 javascript</p>' ;          $html      . =    "<p>这里就可以接收我们刚传的变量了 </p>" ;          $html      . =    "<b>Custom1:</b> $custom1 <br/>" ;          $html      . =    "<b>Custom2:</b> $custom2 <br/>" ;          $html      . =    $this -> getAfterElementHtml ( ) ;          return $html ;      } }

这里值得注意的是，我们一定要继承 Varien_Data_Form_Element_Abstract 这个类，并且要重写 getElementHtml() 这个方法，那样你就可以写你自定义的 html 代码了

source: http://www.sunzhenghua.com/magento-admin-module-development-part5-grid-forms-tabs-ajax-advanced