multiMenu 1.7 - when multiMenu goes sitemap

Date 2005/3/31 7:26:37 | Topic: Modules

The wolFactory and Arma sa is proud to announce the release of multiMenu 1.7.

This new version of the very usefull navigation module includes new enhancement and functionalities.

1) No more url limitations with the dynamic sublinks. 2) A new index page allowing to display menus content, and which could be used as a customisable sitemap. 3) 8 customisables menus. 4) Totally revised blocks, links and navigation administration. 5) Possibility to manage an horizontal menu bar into a theme with multiMenu. 6) Possibility to use two new tags {module} an {theme} to manage current module and theme image customisation. Included: a complet guide to learn everything about multiMenu ! Note that this new version is not compatible with previous version due to database entry (pid). A conversion script will be released as soon as possible (hopefully !). Happy multiMenu-xoopsing!

How to use multiMenu ?

multiMenu is a multifunction links menu manager. It has been designed to easily display links and menus on a Xoops site. For webmasters, links can be added either from the administration side, or directly from a link in the index pages of the module. This 1.7 version now includes a sitemap interface, which will allow the webmaster to design his own navigation.

The main objective of this module is to allow webmasters who are not used with website or module management to easily display custom menus. Other benefits include plenty of features that allow the webmaster to personalise the use of the module. This includes very flexible block menu allowing many disply type options, as we will see later in this short guide.

With respect to the design and creation of this module, credits and thanks go to several well-known xoopers:
Hervé, Marcan and Solo for their help and collaboration on this project.


Preferences (or module general settings)

Before using this multiMenu module, we suggest to have a careful look at the admin settings. This is where you will define the functional and personal settings of your module. Those settings have a direct impact on the index pages (but not on block settings).

~Display Main page:
You may activate or not the Sitemap option here. If you desactivate it, you may eventuellay keep using it as a fake module to display whatever block you want, or use is as a secondary homepage. Keep in mind this would only deactivate the main index page, not the sub-index sitemap pages.

~Introduction text:
Put here the text you want to see above the main index page. This text accept Xoops and HTML codes.

~Display banner: You have the possibility to display or not a banner or the module name above all the module pages. If you want to change the banner, change the '/module/multiMenu/images/logo.gif' file.

~Display multiMenu page (from 1 to 4): Choose the multiMenu content you want to display in the index pages.

~Menu Title (from 1 to 4):
Define the index and admin multiMenu page titles. Pay attention, this won't affect the related blocks title!

~Display Nav Bar:
A navigation bar with the activated index page would display above each and every page. If you don't want this function, you can desactivate it here.

~Default image width:
Fix the standard maximum size value a picture would display on the index pages. It would only resize pictures which are bigger than this value (thus, no stretching effect).

~Display icons:
Activating this function would display icons in front of each and every links. There are actually 4 types of links :
  • Absolute main links
  • Absolute sub links
  • Relative main links
  • Relative sub links

~Menu to display in theme:
This option allow you to display one of your multiMenu directly in your theme. All you need to do is to insert that code in your current theme *:

<{include file="../modules/multiMenu/theme/multimenu.php"}>

* Note: Only 'main links' are displayed in theme!


Admin Index

There are 2 differentparts here: A dynamic module navigation bar and the current edited multiMenu.

Module navigation bar consisting of-
  • multiMenu main Index Page
  • Preferences
  • Help
  • Admin links
  • multiMenu (ranging from 1 to 4)

Note: there is a color code which indicate if the current multiMenu is displayed or not in the index page.

You can navigate through the whole module and it’s option thanks to this nav bar. Keep in mind that on each and every page generated by Edito, as admin of the module, you will be able to directly access the edit, delete or administration function.

multiMenu index page

Display each and every multiMenu links.
On the main page, you can get some valuable informations regarding your custom links :
  • Picture: display a reduced version of the used picture.
  • Title
  • Link
  • Status: Green for online, red for offline.
  • Type
  • Functions: main admin functions, edit, delete, move up and down.
Links are ranked in display order. This order can be changed clicking on the green arrows (up and down).

Click on 'New Link' to create a new entry.

New link

multiMenu is designed to easily create menu links. You just have to fill in the form to create a new link.
You can choose to display a picture with or without links, with different possible display options.

~Title: is the link title. You can use html code (to color your links for instance) or smilies. It is better not use the BBCodes.

~Link: is the url you want your link to point at. Leave it blank if you don't want a clickable link (for information purpose, for instance). The url can be absolute or relative. If set relative, multiMenu would automatically add the current website path, so that, wherever your block appears on your site, the url would be a correct link.

~Image: is the picture url of the current link. Same goes as for link regarding the relative or absolute url. If the picture is unavailable or fake, multiMenu would display a default picture (a red paw).
In this version, you have the possibility to use two different tages {module} {theme} , respectively displaying the module or theme used on the current page. Those option would allow you to display specific logos regarding the module or theme the user is navigating the website.

~Status: define wether you want that link to be dispalyed or not.

~Type: set the link type you want to apply to the current link. There are 5 different link type :
  • Category: display as a category link type.
  • Main link: standard main link type.
  • Permanent sublink: sublink type which would display permanently.
  • Dynamic sublink: sublink type which would display dynamically, regarding the parent mainlink. Note that to make the dynamic links to work, it is necessary to add '\ / ' (trailin slash) at the end of main links linking to a directory!
  • Note: would display like a standard comment text.

~Target: 4 different classical target type.

~Groups: selct which group can see or not the current link.

    multiMenu's blocks

    One of the most important features of multiMenu are his blocks. As stated above, you have for each menu a corresponding block (ranging from 1 to 4 + the admin one), plus 2 other custom menu blocks (A and B). For each and every available blocks, you can have a very wide range of applications, display and options.

    When editing a multiMenu block, use the “Setting” option, in 6 different catégories.

    1) Block Format

    You can display the multiMenu links under 11 different forms:
    - Standard Menu (Main Menu like)
    - Drop List
    - Select Box
    - Fixed Picture
    - Scrolling Picture (scrolling without pause)
    - Sliding Picture (scrolling with pause)
    - Unordered list (without numbers)
    - Ordered list (with numbers)
    - Unordered list
    - Scrolling List (scrolling without pause)
    - Sliding List (scrolling with pause at the end)

    ~Number of columns:
    Define the amount of columns you want your links to be displayed. This option is only available for Standard Menu and Fixed Picture option.

    2) Links

    ~Link type to display:
    Define which kind of links your want to display amongs all links category.
    ~Order by:
    In which order do you want to display your links: by weight (defined by admin order) or by ordered or reversed alphabetical order.

    3) Title

    ~Display Title:
    Do you want to display the links title. This option should be used only with links which have an illustration picture!
    ~Max. Lenght:
    How maximum long should be the title ? Define the maximum value here.

    4) Picture

    ~Display Picture:
    Do you want to display the links title.
    ~Max. Widht:
    Set the maximum picture width to keep a uniform look of your illustrations and menus. If the picture is smaller, it won't be resized to prevent any pixelisation effect.

    5) Scroll Settings

    Those options are only valuable if you select the Sliding Picture format. ~Block width and height:
    Define the block general size. Check picture width option to tweak the perfect sttings.
    Define the general scrolling speed of your pictures and links.

    6) Random Links

    ~Random links:
    multiMenu gives you the possibility to display a selection of random links. Define here wether you want it or not. Of course, this options should be used carefully if you are using several different link types (category, main links, sublinks and note) and work better with only one link type.
    ~Number of random link to display:
    This option define the number of random link to dispalay. Keep in mind that it would display X links after the first random picked links.

    Thanks for choosing multiMenu, as always, we are happy to receive any comments and feedback so that we may continually improve the quality and features of this module.

    - The authors.

    This article comes from XOOPS Web Application System

    The URL for this story is: