========================================================
PhpMenu Cookbook/Addon Recipe/Module for PmWiki 2.2.4+
========================================================
/**
 * README
 * @author V.Krishn (vkrishn@insteps.net), Copyright 2005-2023
 * @note This file is part of Cookbook recipe "PhpMenu" for PmWiki;
 * You can redistribute it and/or modify it under the terms of the
 * GNU General Public License as published by the  Free Software
 * Foundation; either version 2 of the License, or (at your option)
 * any later version. @see pmwiki.php for full details.
 * @package phplm
 */

/* ********************************************************************
** NOTE: CAUTION
**  Use of this recipe lets you insert arbitrary JavaScript Code.
**
**  DO NOT dissable the security code in "phpmenu.php".
**  Make appropriate settings with the default password = menupass
**       in phpmenu.php
**  Read the main documentation on Passwords.
* ********************************************************************/


======================================================
HOW TO USE/INSTALL PhpMenu v.2.2.x in PmWiki v.2.2.4+
======================================================
1. Place the phpmenu folder under cookbook/

2. Make an entry in your config.php file

       include_once("cookbook/phplm/phplm.php");

       See samples in local folder.

       Make appropriate changes in your phplm.php file.
       Read main documentations on setting up passwords in PmWiki.

       NOTE: Alternatively you can include the above settings
       in your farmconfig.php file. (see files in local folder).

3. Defult wiki menu page is "Content.Phplm".
   For SITE the default Wiki menu page is "{Site}.Phplm".
   For GROUP the default Wiki menu page is "{Group}.Phplm".
   For PAGE the default Wiki menu page is "{Group}.{Page}Phplm".

   3.1 Create these pages on requirement.
   3.2 For syntax of menu wiki pages
        READ: menusyntax.txt (IMPORTANT).

4. If no menu is build the defaultmenu.txt is activated.

5. Directive syntax:

(:phplmDraw uniqueID orient theme menupage type=2|3|4|5|6|7 :)

  5.1. uniqueID - unique id for the menu (a single word - alpha-numeric) 
  5.2. orient - horizontal/vertical/tree
  5.3. theme -
     * default, galaxy, gtk2, keramik (for dropdown)
     * default, galeon, gmc, kde, nautilus, mozilla (for tree)
      (Themes can easily be created)
  5.4. menupage -
     * layermenu PageTypes (page,group,site,default)
     * layermenu from pagelist function (page-list,group-list,site-list),
     * here page,group,site has same meaning as PageTypes
     * Multiple pagelist can be combined to produce a single menu/tree. 
  5.5. type - 2|3|4|5|6|7
     * Presently this option is for treemenus, to select tree-layout type.

  5.6. common:
    (:phplmAllHeaderFooter:)
        (Not required if orients on page is only "tree")
        This needs to be inserted once on wiki pages after phplmDraw directive.
        If there are multiple phplmDraw directive, insert after all phplmDraw directives. 

----------------
eg 1.
(:phplmDraw idGroupHeader horizontal keramik default:)
----------------
eg 2.
(:phplmDraw id4 vertical gtk2 site :)
----------------
common:
(:phplmAllHeaderFooter:)
----------------




