It supports default filter values and remember scenarios also. For example if you want to show only eg: Active Products, you can setup the default filter using this extension. Or if you have the same modal on different views, you can set different scenarios to remember state separated from each other. See the optional params under Advanced Functionalities and Scenarios section.
Requirements
Yii 1.1
Donate
Resources
Report a bug
Developer
Forum
Clear Filters Gridview extension
Usage
Step 1
To use this extension, just copy this file to your components/ directory, add 'import' => 'application.components.ERememberFiltersBehavior', [...] to your config/main.php and paste the following code to your behaviors() method of your model
public function behaviors() { return array( 'ERememberFiltersBehavior' => array( 'class' => 'application.components.ERememberFiltersBehavior', 'defaults'=>array(), /* optional line */ 'defaultStickOnClear'=>false /* optional line */ ), ); }
Step 2
Your actionAdmin() must not use unsetAttributes() as this was moved to the extension.
With this extension the actionAdmin instead of the classic
public function actionAdmin() { $model=new Company('search'); $model->unsetAttributes(); // clear any default values if(isset($_GET['Company'])) $model->attributes=$_GET['Company']; $this->render('admin',array( 'model'=>$model, )); }
can be as simple as:
public function actionAdmin() { $model=new Company('search'); $this->render('admin',array( 'model'=>$model, )); }
Advanced Functionalities:
(if you use these functionalities please Donate)
-
'defaults' is a key value pair array, that will hold the defaults for your filters. For example when you initially want to display
active products, you set toarray('status'=>'1'). You can of course put multiple default values in the array. -
'defaultStickOnClear'=>true can be used, if you want the default values to be put back when the user clears the filters The default set is
falseso if the user clears the filters, also the defaults are cleared out, the user will get an absolutely clean filter form. Whentrue, if the form is cleared, he will get a form with defaults values.
Scenarios
(if you use these functionalities please Donate)
You can use scenarios to remember the filters on multiple states of the same model. This is helpful when you use the same model on different views and you want to remember the state separated from each other. Known limitations: the views must be in different actions (not on the same view)
To set a scenario add the setRememberScenario call after the instantiation Sample code:
public function actionAdmin() { $model=new Company('search'); $model->setRememberScenario('scene1'); $this->render('admin',array( 'model'=>$model, )); }
This extension has also a pair Clear Filters Gridview
Change Log
June 3, 2011
- Added support for 'scenarios'. You can now tell your model to use remember scenario when the same model is used on multiple views.
March 7, 2011
- Added support for 'defaults' and 'defaultStickOnClear'. You can now tell your model to set default filters for your form using this extension, and optionally stick or absolutely clear them on clearFilters.
January 31, 2011
- Initial release.
remember, filters, cgridview, gridview, store, reload, controller, model, behavior, interface, widget, stick, scenario


