10 users Sign-in to change your status

jQuery superfish menu plugin. jQuery

• Repository
• Download package
• Browse source

The pmSuperfishMenuPlugin provides the functionality to create dynamic menus using Superfish (based on jQuery).

Developers

Name	Status	Email
Patricio Mac Adden	lead	ra.ude.plnu.ipsec.ollorrased <<ta>> neddacamp

License

Copyright (c) Patricio Mac Adden

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.

Releases for sf 1.4

Releases for sf 1.3

Join this plugin team

Other releases

Release 1.0.1 - 07/09/2010

pmSuperfishMenuPlugin

The pmSuperfishMenuPlugin provides the functionality to create dynamic menus using Superfish (based on jQuery).

Installation

• You can install the plugin using subversion:

  $ svn co http://svn.symfony-project.com/plugins/pmSuperfishMenuPlugin/trunk pmSuperfishMenuPlugin

  And adding the following to config/ProjectConfiguration.class.php:

  $this->enablePlugin("pmSuperfishMenuPlugin");

• Or using the plugin:install command:

  $ ./symfony pl:i pmSuperfishMenuPlugin

In both cases, you must clean your cache and publish-assets

$ ./symfony cc
$ ./symfony pl:p

Usage

First you must include stylesheets and javascripts. jQuery is required, so download it!

# in apps/backend/config/view.yml
default:
  # ...
  stylesheets:    [main.css, /pmSuperfishMenuPlugin/css/superfish.css]
 
  javascripts:    [jquery-1.4.2.min.js, /pmSuperfishMenuPlugin/js/hoverIntent.js, /pmSuperfishMenuPlugin/js/superfish.js]

There are two ways of using this plugin:

• Create the menu manually:

  <?php $root = new pmSuperfishMenu() ?>
  <?php $root->setRoot() ?>
   
  <?php $menu = new pmSuperfishMenu() ?>
  <?php $menu->setName("People") ?>
   
  <?php $menu_item = new pmSuperfishMenuItem() ?>
  <?php $menu_item->setName("People list")->setUrl("@person") ?>
  <?php $menu->addChild("person_list", $menu_item) ?>
   
  <?php $menu_item = new pmSuperfishMenuItem() ?>
  <?php $menu_item->setName("New person")->setUrl("@person_new")->setCredentials(array("admin")) ?>
  <?php $menu->addChild("person_new", $menu_item) ?>
   
  <?php $root->addChild("person_list", $menu) ?>
   
  <?php $menu = new pmSuperfishMenu() ?>
  <?php $menu->setName("Cities") ?>
   
  <?php $menu_item = new pmSuperfishMenuItem() ?>
  <?php $menu_item->setName("Cities list")->setUrl("@city") ?>
  <?php $menu->addChild("city_list", $menu_item) ?>
   
  <?php $menu_item = new pmSuperfishMenuItem() ?>
  <?php $menu_item->setName("Nueva ciudad")->setUrl("@city_new")->setCredentials(array("admin")) ?>
  <?php $menu->addChild("city_new", $menu_item) ?>
   
  <?php $root->addChild("city_menu", $menu) ?>
   
  <?php echo $root->render() ?>

• Load it from an yaml file:

  • In apps/backend/config/menu.yml (or elsewhere)

    root:
      people:
        name: People
        menu:
          list:
            name: People list
            url: @person
          new:
            name: New person
            url: @person_new
            credentials: [admin]
      city:
        name: Cities
        menu:
          list:
            name: Cities list
            url: @city
          new:
            name: New city
            url: @city_new
            credentials: [admin]

  • In apps/backend/templates/layout.php

    <?php pmSuperfishMenu::createFromYaml(sfConfig::get("sf_app_config_dir")."/menu.yml")->render() ?>

Features

• Fluent interface
• Dynamic creation: you can create the menu and add/remove menu items.
• Fully customizable: you can change the stylesheet and the superfish initialization code.

NOTES

jquery-1.2.6.min.js is bundled because web directory is just the superfish library. You can use a higher version of jquery without any problems.

Bugs / Features request

• Just php bugs or features, I don't mantain the Superfish library.