Welcome to Kodok Marton's homepage

Professional work from professionals!

  • Increase font size
  • Default font size
  • Decrease font size
Home Programming Web Programming Clear filters gridview Yii extension

Clear filters gridview Yii extension

This extensions helps you to clear remembered filter values on GridViews. Adds an additional image in top right of the grid.

The EButtonColumnWithClearFilters extension adds up some functionality to the default possibilites of CButtonColumn implementation when you use extensions to remember filter values. This extension helps you to clear the remembered filter values.

Check out Remember Filters Gridview extension also.

An image will be placed in the top column(on same line of AJAX filters). When clicked the filters will be cleared, the content will be refreshed with all items available.

Requirements

Yii 1.1

Donate

Click here to donate

Resources

Report a bug
Developer
Forum
Remember Filters Gridview extension

Usage

Step 1

To use this extension, copy this file to your components/ directory, add 'import' => 'application.components.EButtonColumnWithClearFilters', [...] to your config/main.php and use this column on each widget's Column array you would like to inherit the new possibilities:

array(
'class'=>'EButtonColumnWithClearFilters',
//'clearVisible'=>true,
//'onClick_BeforeClear'=>'alert('this js fragment executes before clear');',
//'onClick_AfterClear'=>'alert('this js fragment executes after clear');',
//'clearHtmlOptions'=>array('class'=>'custom-clear'),
//'imageUrl'=>'/path/to/custom/image/delete.png',
//'url'=>'Yii::app()->controller->createUrl(Yii::app()->controller->action->ID,array("clearFilters"=>1))',
//'label'=>'My Custom Label',
),

All posible customizations have been enumerated above, you shall comment out those that you won't override. The minial setup is just the class type for the Columns.

clearVisible: a PHP expression for determining whether the button is visible

onClick_BeforeClear: If you want to execute certain JS code before the filters are cleared out, use this property to pass your custom code. You are allowed to use 'return false;' only, when you want to stop the clear to happen. This will stop all further JS code, and HTTP request to be executed. You are not allowed to use 'return true;' it will break the components usage.

onClick_AfterClear: If you want to execute certain JS code after clear, but before the AJAX call use this property to pass your custom code. You are allowed to use 'return false' only, when you want to stop the AJAX call to happen. This will stop the form to be reloaded. If you want to clear the form by classic GET request, and not by ajax you shall 'return true;' here.

clearHtmlOptions: Associative array of html elements to be passed for the button Default is: array('class'=>'clear','id'=>'cbcwr_clear','style'=>'text-align:center;display:block;');

imageUrl: image URL of the button. If not set or false, a text link is used Default is: $this->grid->baseScriptUrl.'/delete.png'

url: a PHP expression for generating the URL of the button Default is: 'Yii::app()->controller->createUrl(Yii::app()->controller->action->ID,array("clearFilters"=>1))'

label: Label tag to be used on the button when no URL is given Default is: Clear Filters

Step 2

You need to add to your controller the following code.

if (intval(Yii::app()->request->getParam('clearFilters'))==1) {
EButtonColumnWithClearFilters::clearFilters($this,$model);//where $this is the controller
}

If you don't need the clear filters button capabilities you can also pass a clearFilters parameter with a 1(one) value to the controller, for this you can use a link or a button.

This extension has also a pair Remember Filters Gridview

Change Log

January 31, 2011

Initial release.

Tags:     yii      framework      extensions      php      clear      filters      cgridview      gridview      reset      empty      controller      model      behavior      interface      widget