|
1
|
Superfish module
|
|
2
|
|
|
3
|
About
|
|
4
|
-----
|
|
5
|
This module allows for integration of jQuery Superfish plug-in with Drupal CMS.
|
|
6
|
|
|
7
|
|
|
8
|
Requirement
|
|
9
|
-----------
|
|
10
|
- Superfish library.
|
|
11
|
Link: http://drupal.org/project/superfish
|
|
12
|
|
|
13
|
|
|
14
|
Installation instructions
|
|
15
|
-------------------------
|
|
16
|
1. Download and extract the Superfish library into the libraries directory (usually
|
|
17
|
"sites/all/libraries").
|
|
18
|
Link: https://github.com/mehrpadin/Superfish-for-Drupal/zipball/master
|
|
19
|
|
|
20
|
2. Download and extract the Superfish module into the modules directory (usually
|
|
21
|
"sites/all/modules").
|
|
22
|
Link: http://drupal.org/project/superfish
|
|
23
|
Drush users can use the command "drush superfish-plugin".
|
|
24
|
|
|
25
|
3. Go to "Administer" -> "Modules" and enable the module.
|
|
26
|
|
|
27
|
Note: Though no longer required, using Libraries API is still recommended.
|
|
28
|
Link: http://drupal.org/project/libraries
|
|
29
|
|
|
30
|
|
|
31
|
Upgrade instructions
|
|
32
|
--------------------
|
|
33
|
Did you change any part of the module or the library?
|
|
34
|
|
|
35
|
- If you did not change the module or the library; download the latest versions of the module and
|
|
36
|
the library and upload them (replacing the old files).
|
|
37
|
|
|
38
|
- If you did change the module or the library; use a visual comparison tool (such as Winmerge
|
|
39
|
or Kompare, so on) in order to compare your current copy with its original one (you can find it at
|
|
40
|
http://drupal.org/node/711944/release) find out what was changed and do the same to the version
|
|
41
|
you are upgrading to.
|
|
42
|
WARNING: This is for experts only!
|
|
43
|
|
|
44
|
- Please note that if you are upgrading from version 1.6 running update.php will cause error
|
|
45
|
messages to appear. To resolve this go to "Administer" -> "Structure" -> "Blocks", click the
|
|
46
|
"Configure" link for each Superfish block and click "Save block" button.
|
|
47
|
|
|
48
|
|
|
49
|
Configuring the module
|
|
50
|
----------------------
|
|
51
|
- For block-specific settings go to "Administer" -> "Structure" -> "Blocks" and click the
|
|
52
|
"Configure" link of the Superfish block.
|
|
53
|
|
|
54
|
- For module settings go to "Administer" -> "Configuration" -> "User Interface" -> "Superfish".
|
|
55
|
|
|
56
|
- Detailed configuration instructions can be found at http://drupal.org/node/1125896
|
|
57
|
|
|
58
|
|
|
59
|
How to style
|
|
60
|
------------
|
|
61
|
If you know CSS, even basics of it, designing won't be a big challenge.
|
|
62
|
|
|
63
|
Here are some tips and tricks:
|
|
64
|
|
|
65
|
A) Always use a DOM inspector utility (such as Firebug).
|
|
66
|
|
|
67
|
B) Set the "Menu delay" option to a very high number such as 99999999. This will give you enough
|
|
68
|
time to work with sub-menus.
|
|
69
|
|
|
70
|
C) If you are not using the built-in styles, set the "Style" option to "None".
|
|
71
|
|
|
72
|
D) Utilise the "Simple" style as reference; add the newly-created CSS file either to your theme CSS
|
|
73
|
or as a new CSS file under the styles directory in the Superfish library (probably
|
|
74
|
"sites/all/libraries/superfish/style"); putting it in the styles folder will automatically add it
|
|
75
|
to the styles list in the block configuration.
|
|
76
|
|
|
77
|
- More information can be found in the Superfish documentation at http://drupal.org/node/1125896
|
|
78
|
|
|
79
|
|
|
80
|
Support requests
|
|
81
|
----------------
|
|
82
|
You can request support here: http://drupal.org/project/issues/superfish
|
|
83
|
|
|
84
|
|
|
85
|
How to help?
|
|
86
|
------------
|
|
87
|
Glad you asked that :)
|
|
88
|
|
|
89
|
- Help find bugs!
|
|
90
|
- Suggest new features!
|
|
91
|
- Test the beta versions!
|
|
92
|
- Translate the UI into your language!
|
