WB 2.08.x

show_menu2, version 4.7

supplying different parameters to the show_menu2 function call. For example, 

to show only menu items from the top level of the menu you use:

COMMON QUESTIONS

================

Q:  I'm not a programmer. Do you have simpler documentation? 

A:  Nup. This is it. Go hard. Gambarre.

Q:  How do I create a drop-down menu?

A:  This is unrelated to show_menu2. You need to change the template CSS code 

    to display the menu as a drop-down. Try the "allcss2" template from the WB

    addon repository. http://addons.websitebaker.org/pages/templates.php

Q:  Why does the menu disappear after I do a search on my multilingual WB site?

A:  You're missing some required lines in your template.

    1.  Log into WB administration, and go to Settings -> Show advanced settings 

        -> Search Settings -> Header Code and add the following input field 

        after the <form> open tag: 

        <input type="hidden" name="referrer" value="[REFERRER_ID]" />

    2.  In the index.php of your template, add the following input field 

        immediately following the search <form> open tag.

        <input type="hidden" name="referrer" value="<?php echo defined('REFERRER_ID')?REFERRER_ID:PAGE_ID;?>" />

Q:  Multilingual? That sounds cool. How do I do that?

A:  http://help.websitebaker.org/pages/en/advanced-docu.php

Q:  SM2 is generating a warning every time the page is accessed:

    "show_menu2 error: $aOptions is invalid. No flags from group 1 supplied!"

A:  You are passing the wrong values to the function. Have a closer look at the 

    parameters that you are passing. See the PARAMETERS section below for the 

    correct flag values to pass for the $aOptions parameter.

        $aOptions       = SM2_TRIM,

Ensure that you use each parameter correctly. Use the following rules:

    $aMenu will be 0 for most people.

    $aStart must be either a page ID or a value starting with "SM2_".

    $aMaxLevel must be only values that start with "SM2_".

    $aOptions must be only values that start with "SM2_" (unless you are 

    in a very small minority of users).

    All other parameters are the HTML tag templates that will be 

    output for menus and menu items.

Note that every parameter from $aItemOpen can be supplied as false to get 

the default value.

$aOptions  

    both TRIM and PRETTY you should use, (SM2_TRIM | SM2_PRETTY).

    This parameter also has an extended mode where an associative array of 

    options is supplied. See the EXTENDED OPTIONS section for details. 

    Most users will NOT need to use this.

EXTENDED OPTIONS

================

The $aOptions parameter is a dual mode parameter. For most users, only the

SM2_* flags will be sufficient. However, to access the extra options, it 

must be supplied as an associative array. Note that the SM2_* flags are

still required and must be supplied as 'flags'.

    'flags'     **REQUIRED** These are the flags described in PARAMETERS

                above for the $aOptions parameter. 

    'notrim'    Specify a number of levels relative to the menu level of 

                $aStart that will always be displayed. This will cause the

                SM2_TRIM flag to be ignored for these levels.

To supply one of these options in addition to the flags, the option array 

should be created and passed as the $aOptions parameter:

    $options = array('flags' => (SM2_TRIM|...), 'notrim' => 1);

    show_menu2(0, SM2_ROOT, SM2_CURR+1, $options);