README.txt in Superfish 7

Superfish module

About
-----
This module allows for integration of jQuery Superfish plug-in with Drupal CMS.


Requirements
-----------
- Superfish library 1.x
  https://github.com/mehrpadin/Superfish-for-Drupal/archive/1.x.zip
- JQuery 1.6.1 or higher, if you are going to use the jQuery Easing plugin.
  https://www.drupal.org/project/jquery_update


Installation instructions
-------------------------
1. Download and extract the Superfish library into the libraries directory
   (usually "sites/all/libraries").
   Link: https://github.com/mehrpadin/Superfish-for-Drupal/zipball/1.x.zip

2. Download and extract the Superfish module into the modules directory (usually
   "sites/all/modules").
   Link: http://drupal.org/project/superfish
   Drush users can use the command "drush superfish-plugin".

3. Go to "Administer" -> "Modules" and enable the module.

Note: Though no longer required, using Libraries API is still recommended.
      Link: http://drupal.org/project/libraries


Upgrade instructions
--------------------
Did you change any part of the module or the library?

- If you did not change the module or the library; download the latest versions
  of the module and the library and upload them (replacing the old files).

- If you did change the module or the library; use a visual comparison tool
  (such as Winmerge or Kompare, so on) in order to compare your current copy
  with its original one (http://drupal.org/node/711944/release) find out what
  was changed and do the same to the version you are upgrading to.
  WARNING: This is for experts only!

- Please note that if you are upgrading from version 1.6 running update.php will
  cause error messages to appear. To resolve this go to
  "Administer" -> "Structure" -> "Blocks", click the "Configure" link for each
  Superfish block and click "Save block" button.


Configuring the module
----------------------
- For block-specific settings go to "Administer" -> "Structure" -> "Blocks" and
  click the "Configure" link of the Superfish block.

- For module settings go to
  "Administer" -> "Configuration" -> "User Interface" -> "Superfish".

- Detailed instructions can be found at http://drupal.org/node/1125896


How to style
------------
If you know CSS, even basics of it, designing won't be a big challenge.

Here are some tips and tricks:

A) Always use a DOM inspector utility (such as Firebug).

B) Set the "Menu delay" option to a very high number such as 99999999.
   This will give you enough time to work with sub-menus.

C) If you are not using the built-in styles, set the "Style" option to "None".

D) Utilise the "Simple" style as reference; add the newly-created CSS file
   either to your theme CSS or as a new CSS file under the styles directory in
   the Superfish library (probably "sites/all/libraries/superfish/style");
   putting it in the styles folder will automatically add it to the styles list
   in the block configuration.

- More information in Superfish documentation at http://drupal.org/node/1125896


Support requests
----------------
You can request support here: http://drupal.org/project/issues/superfish


How to help?
------------
Glad you asked that :)

- Help find bugs!
- Suggest new features!
- Test the beta versions!
- Translate the UI into your language!