raoul2000 / exbreadcrumbs

Extended breadcrumbs widget for the Yii Framework

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

EXBreadcrumbs

This extension is a wrapper for the XBreadcrumb JQuery plugin. It is compatible with the core CBreadcrumbs widget, so no change is needed if you want to turn your old breadcrumbs into super cool extended ones.

Check out the demo !

##Requirements

tested with Yii 1.1.3 (but I see no reason why it would not work for previous Yii versions)

##Installation

  1. Download and unzip the archive into your protected/extension folder
  2. ...there is nothing else to do !

##Usage

To turn your default breadcrumbs into super cool extended breadcrumbs, just replace the reference to 'zii.widgets.CBreadcrumbs' by 'application.extensions.exbreadcrumbs.ExBreadcrumbs', which should be located in your main layout (protected/views/layout/main.php).

[php]
<?php 
	$this->widget('application.extensions.exbreadcrumbs.EXBreadcrumbs', array(
		'links'=>$this->breadcrumbs,
	)); 
?>

But (hopefully) there's more :

  • add a dropdown menu to all (or some) breadcrumbs
  • make your breadcrumbs 'collapsible'
  • define your own custom style

Below is an example where the crumb1 has a dropdown menu containing 2 links. The link associated with crumb2 is defined as a classical Yii url array and at last, the yii crumb url is a simple string.

[php]
$this->widget('application.extensions.exbreadcrumbs.EXBreadcrumbs', array(
    'links'=>array(
        'crumb1' => array('controller/route1','param1'=>'value1',
            'menu'=>array(
                'menu1'=> array('controller/routeMenu1','paramM1' => 'valueM1'),
                'menu2'=> array('controller/routeMenu2','paramM2' => 'valueM2'),
            )
        ),    
        'crumb2' => array('controller/route2','param2'=>'value2'),
        'yii' => 'http://www.yiiframework.com/',
        'end'
    ),
));

##Changes

version 1.0.0.1

  • change Client script registration to be compatible with previous Yii version (trejder)

version 1.0.0.0

  • initial release

##Resources

About

Extended breadcrumbs widget for the Yii Framework


Languages

Language:PHP 67.7%Language:JavaScript 32.3%