PcPhpDataColumn ¶

1. Requirements
2. Usage
3. Resources

General ¶

While developing a table using CGridView, I needed to run a code snippet for each row (and for each data object being handled/rendered in that row). I couldn't use CDataColumn since the PHP code CDataColumn expect is simple and would need to be run when prefixed by 'return...'. The PcPhpDataColumn class provided by this extension is an 'extension' (OO term) of CDataColumn and overwrites its evaluateExpression() method to allow running of more complex code snippets. Note: if you wish, you can also achieve running more complex code using anonymous functions (in PHP v5.3+) or some custom model methods, instead of using this extension.

Requirements ¶

• Not much. Tested with Yii v1.1.10.

Usage ¶

• Unpack this extension. Put the single result file - PcPhpDataColumn.php - and put it under /protected/components/
• This class is to be used exactly as CDataColumn is to be used. Please see the documentation here for more information on this and specifically this resource for information on how exactly the code snippet should be run, what variables exists in its context when its run, etc. Example usage in a view file:

$this->widget('zii.widgets.grid.CGridView', array(
  'id' => 'my-id',
	'dataProvider' => $model->search(),
	'filter' => $model,
	'columns' => array(
    // other columns...
    array(
  	  'class' => 'PcPhpDataColumn',
  		'name' => 'table_column_name',
	  	'header' => 'Column header text',
  		'value' => '$a = Yii::app()->someComp->someCalc($data); $b = new SomeClass($a); return $b->getSomeData();',
	  ),
  ),
));

• IMPORTANT: make sure that your code "return"s a value. This value is the value that will be considered as the value of the table cell.

Resources ¶

• GitHub project page
• CDataColumn documentation. Please refer to this resource for complete information on CDataColumn (which this extension extends).