35. 后台模块开发(2)

1.修改 Grid 表中行的 URL

如果你想要详细定义 Grid 表中行的 URL, 比如，当用户点击 Grid 表中的任意一行，它将跳转到指定的页面，可以添加如下方法到 Grid.php 文件中

public function getRowUrl($row)
{
return $this->getUrl('*/*/edit', array('id' => $row->getData('web_id')));
}
URL 就是你 controller 中的 editAction 方法，它将行的 web_id 号作为参数进行传递

2 . 列_下拉框 – Drop Down Column Type

假设，你想要在 Grid 表中添加一个下拉框，比如你想要添加如下图片中显示的:

$this->addColumn('dropdown1',array(
'header'=>Mage::helper('employee')->__('Description'),
'align'=>'left',
'index'=>'status',
'type'=>'options',
'width'=>'20px',
'options'=>array('0'=>'disable','1'=>'enable'),
)

);

3.批量操作 – Mass Actions

批量操作功能十分有用，并且使用频率也非常高， 下图所展示的就是批量操作

// 批量操作
protected function _prepareMassaction()
{
$this->setMassactionIdField('employee_id'); //设置 form id
$a = $this->getMassactionBlock();
$a->setFormFieldName('employee123'); // 设置 post 表单 接收时，也用这个字段

$this->getMassactionBlock()->addItem('delete', array(
'label'    =>   Mage::helper('employee')->__('Delete'),
'url'      =>   $this->getUrl('*/*/massDelete'),  //给 URL 指定了一个方法
'confirm'  =>    Mage::helper('employee')->__('Are you sure?'), //这个就是在提交前的 confirm 提示框效果，做再次确认
));

$statuses = Mage::getSingleton('employee/status')->getOptionArray();

//array_unshift($statuses, array('label'=>'', 'value'=>''));
$this->getMassactionBlock()->addItem('status', array(
'label' => Mage::helper('employee')->__('Change status'),
'url'   => $this->getUrl('*/*/massStatus', array('_current'=>true)),
'additional' => array(
'visibility'    =>  array(
'name'   =>  'status',
'type'   =>  'select',
'class'  =>  'required-entry',
'label'  =>  Mage::helper('employee')->__('Status'),
'values' =>  $statuses
)
)
));
return $this;
}

控制器中：
public function massDeleteAction() {
$ids = $this->getRequest()->getParam('employee123');
if(!is_array($ids)) {
Mage::getSingleton('adminhtml/session')->addError(Mage::helper('adminhtml')->__('Please select item(s)'));
} else {
try {
foreach ($ids as $id) {
$employee = Mage::getModel('employee/web')->load($id);
$employee->delete();
}
Mage::getSingleton('adminhtml/session')->addSuccess(
Mage::helper('adminhtml')->__(
'Total of %d record(s) were successfully deleted', count($ids)
)
);
} catch (Exception $e) {
Mage::getSingleton('adminhtml/session')->addError($e->getMessage());
}
}
$this->_redirect('*/*/index');
}

4.如果想你在 Grid 表中添加 导入/导出 选项，如下图所展示:



我们只需要将这两行代码添加至 _prepareColumns() 方法中

// 增加导入导出功能
$this->addExportType('*/*/exportCsv', Mage::helper('employee')->__('CSV'));
$this->addExportType('*/*/exportXml', Mage::helper('employee')->__('XML'));

同样你需要在 controller 中为此添加对应的方法

public function exportCsvAction()
{
$fileName = 'employee.csv';
$grid  = $this->getLayout()->createBlock('employee/adminhtml_employee_grid');
$this->_prepareDownloadResponse($fileName, $grid->getCsvFile());
}

public function exportXmlAction()
{
$fileName = 'employee.xml';
$grid  = $this->getLayout()->createBlock('employee/adminhtml_employee_grid');
$this->_prepareDownloadResponse($fileName, $grid->getXml());
}

5.Grid 表 ==> 列中的搜索和过滤 – Custom Search/Filter For a Column

Grid 表中有那么单独一列，你希望搜索功能以不同的方式工作。例如它的 collection 是多表联查的集合，对于列的索引，你希望搜索功能工作起来不同或完全不工作

你需要在 Grid.php 中重写这个 protected 方法 _addColumnFilterToCollection($column):

自定义过滤逻辑：

protected function _addColumnFilterToCollection($column)
{
if ($this->getCollection()) {
if ($column->getId() == 'websites') {
$this->getCollection()->joinField('websites',
'catalog/product_website',
'website_id',
'product_id=entity_id',
null,
'left');
}
}
return parent::_addColumnFilterToCollection($column);
}

6.基于 Ajax 的 Grid

在你 Grid 中， 如果你希望 搜索/分页 和其他一些操作都是基于 Ajax 工作，那么你就要在你的 Grid.php 文件中的 __construct() 方法中添加:

$this->setSaveParametersInSession(true);
$this->setUseAjax(true);

并同时添加另外一个方法:

public function getGridUrl()
{
return $this->getUrl('*/*/grid', array('_current'=>true));
}

这个 URL 将会被称作 Ajax 请求，为了获得 Grid 的内容，你需要在 EmployeeContrller.php 文件中添加:

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

7.在 Grid 中添加不同的按钮

在默认的 Grid 表中，你只有一个 “Add” 按钮，就像我们所演示的 “Add Employee”，如果你需要添加多个按钮时，如下图:

真的要做到，那么我们需要修改 Excellence/Employee/Block/Adminhtml/Employee.php 文件中的 __construct() 方法:

public function __construct()
{
$this->_controller = 'adminhtml_employee';
$this->_blockGroup = 'employee';
$this->_headerText = Mage::helper('employee')->__('Employee Manager');
$this->_addButtonLabel = Mage::helper('employee')->__('Add Employee');

$this->_addButton('button1', array(
'label'     => Mage::helper('employee')->__('Button Label1'),
'onclick'   => 'setLocation(\'' . $this->getUrl('*/*/button1') .'\')',
'class'     => 'add',
));
$this->_addButton('button2', array(
'label'     => Mage::helper('employee')->__('Button Label2'),
'onclick'   => 'setLocation(\'' . $this->getUrl('*/*/button2') .'\')',
'class'     => 'remove',
));

parent::__construct();
}

8.改变默认分页的 Size

你需要在 Grid.php 文件中重写 _preparePage() 这个方法，

protected function _preparePage()
{
$this->getCollection()->setPageSize(
$this->getParam($this->getVarNameLimit(), $this->_defaultLimit)
);
$this->getCollection()->setCurPage(
$this->getParam($this->getVarNamePage(), $this->_defaultPage)
);
}

现在你可以根据你自己的需要设置 $this->_defaultLimit 和 $this->_defaultPage

9.为 Grid 表中的行添加不同的选项

如图所示:

$this->addColumn('action',
array(
'header'   =>   Mage::helper('employee')->__('Action'),
'type'     =>   'action',
'getter'   =>   'getWebId',
'actions'  =>   array(
array(
'caption' =>  Mage::helper('employee')->__('Edit'),
'url'     =>  $this->getUrl("*/*/edit"),
'field'   =>  'id'
),
array(
'caption' =>  Mage::helper('employee')->__('Delete'),
'url'     =>  $this->getUrl("*/*/delete"),
'field'   =>  'id'
)
),
'filter'      =>  false,
'sortable'    =>  false
)
);

http://www.sunzhenghua.com/magento-admin-module-development-part2-grid-forms-tabs-addbutton