1 |
85ad3d82
|
Assos Assos
|
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! |