O Guia Definitivo do Yii 1.1

Nota: O path alias ext está disponível a partir da versão 1.0.8. Nas versões anteriores,
precisávamos utilizar application.extensions para nos referir ao diretório base das
extensões. Nos exemplos a seguir, vamos assumir que ext está definido, Caso você
utilize a versão 1.0.7, ou anterior, substitua o path alias por application.extensions.
Extensões diferentes tem requisitos diferentes para importação, configuração e utilização.
Abaixo, resumimos os tipos mais comuns de utilização de extensões, de acordo com as
categorias descritas na visão geral.
Extensões Zii
Antes de descrever a utilização de extensões de terceiros, gostariamos de apresentar a
biblioteca de extensões Zii. Trata-se de um conjunto de extensões criadas pelo time de
desenvolvedores do Yii e é incluída em todos os lançamentos do framework, a partir da
versão 1.1.0. Essa biblioteca está hospedada no Google Code, no projeto chamado zii.
Ao utilizar uma das extensões da Zii, você deve utilizar um path alias para fazer
referências às classes correspondentes, no formato zii.caminho.para.NomeDaClasse. O
alias zii é definido pelo framework e aponta para o diretório raiz da biblioteca Zii. Por
exemplo, para utilizar a extensão CGridView, devemos utilizar o seguinte código em uma
view:
$this->widget('zii.widgets.grid.CGridView', array(
));
'dataProvider'=>$dataProvider,
Componente de Aplicação
Para utilizar um componente de aplicação, primeiro precisamos alterar a configuração da
aplicação adicionando uma nova entrada na propriedade components, como no código
abaixo:
return array(
// 'preload'=>array('xyz',...),
'components'=>array(
'xyz'=>array(
'class'=>'ext.xyz.XyzClass',
'property1'=>'value1',
'property2'=>'value2',
),
// configurações de outros componentes
),
);
Dessa forma, podemos acessar o componente em qualquer lugar utilizando Yii::app()-
>xyz. O componente será criado somente quando for acessado pela primeira vez, a não
ser que ele tenha sido adicionado na propriedade preload.