sfBreadcrumbsPlugin - 1.0.4
You are currently browsing
the website for symfony 1
This plugin provides the ability to create Breadcrumbs(AKA: Navigation Path) in any template.
|Ahmed El.Hussaini||lead||moc.liamtoh <<ta>> iniassuhle.m.demha|
Copyright (c) 2004-2006 Fabien Potencier
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Added support to symfony 1.1
This plugin adds the ability to create Breadcrumbs(AKA: Navigation Path) in any template.
To install sfHelperExample:
symfony plugin-install local|global symfony/sfBreadcrumbsPlugin
Step One: Create a file named breadcrumbs.you and place it in your_app/config directory and follow the next examples. Suppose you're working on a website where the main navigation menu consists of the following items: * Home * Categories * Show All * Add New * Products * Show All * Add New And as you might have guessed, Home, Categories, and Products are just virtual sections in the website grouping some actions together, for example, the Show All and Add New actions for categories or products. Since all these actions are probably placed in the same module it's hard to display the Breadcrumbs to the user based on just the action and module names, and this is where this plugin comes in handy. Consider the following breadcrumbs.yml example, and don't be intimidated, I'll explain each node in the file.
In the below example, mymodule is a name of a module available in an application for example called myapp. mymodule consists of several actions:
As you can see, some of these actions are related to a certain entity(ex: Category), and I want to group categoriesAction, showCategories, and addNewCategory in a menu(i.e. section) called Categories. All I've to do is write the following in breadcrumbs.yml under tags.
all: mymodule: name: My Module sections: categories: name: Categories actions: categories: name: Categories newCategory: name: New Category showCategories: name: Show Available Categories products: name: Products actions: products: name: Product newProduct: name: New Product showProducts: name: Show Available Products
In the above example, mymodule is the actual name of the module, My Module, is the name displayed in the Breadcrumbs presented to the user. The same goes for section, and action.
Step Two: Next, create if a file name config_handlers.yml and place it in your_app/config directory and paste the following in that file
config/breadcrumbs.yml: class: sfBreadcrumbsConfigHandler
Step Three: place the following code in your_app/config/config.php file
include_once( sfConfigCache::getInstance()->checkConfig( sfConfig::get('sf_apps_dir_name').'/config/breadcrumbs.yml' ) );
Step Four: Finally in order to display the breadcrumbs text in the website, open for example the layout.php located in the templates folder under your application, and add the following anywhhere, enjoy.
<?php echo sfBreadcrumbs::getInstance()->getBreadcrumbText() ?>
For the full copyright and license information, please view the LICENSE file that was distributed with this source code.