PHP Classes

File: readme.txt

Recommend this page to a friend!
  Classes of Patrick Brosset   multiXPandMenu   readme.txt   Download  
File: readme.txt
Role: Documentation
Content type: text/plain
Description: READ ME FIRST
Class: multiXPandMenu
Generate dynamically expansible hierarchical menus
Author: By
Last change: Please read this README file as it will help you start with using the class. Latest modification: how to use the saveState facility and the reuseCode facility
Date: 19 years ago
Size: 3,663 bytes


Class file image Download
+-----------------------------+ | xPandMenu MULTI-LEVEL class | +-----------------------------+ | Patrick Brosset | | | +-----------------------------+ | 02/2005 | +-----------------------------+ General ------- The xPandMenu PHP class can help you create complex menus for your webpages. Items organised in the menu are displayed in a TreeView structure which resembles the MS Windows OS's directory explorer. The usage principle is simple: You first create a root object which will be the `base` of your menu. You then append `child` nodes to this root and `child` nodes to these nodes as well. The menu can have as many sub-levels as needed. Example ------- This example shows how you can organise your items on your website using this PHP class. + Home page + About me + my CV + contact details + email + phone + Photos + Travels + Parties + my birthday + ski trip + Friends + News + PHP Classes + XpandMenu class available on Benefits -------- + Each item in your list that contains sub-items can be collapsed / expanded by clicking on it. + Each item in your list can be given a 2-states image that will be displayed next to the item and be swapped wheter the node is open or closed + The entire menu-look can be highly changed through CSS + The HTML code generated for the menu is only made of <UL></UL> lists + The state of the menu can be saved from page to page + The generated code may be saved once and for all for future use Requirements ------------ The menu's collapse/expand facility is done with Javascript. The client must have javascript turned-on to use the menu. The class was developed using PHP v 4.0.1 Hoe to use the class? --------------------- Please have a look through these 4 example files as they currently represent the only documentation available. I'll try to document the class itself soon. > example_simple.php Simple and basic example on how to use the main functions of the class You should be able to get started with this, although it is recommended to have a look at the other examples as well in order to use more interesting features > example_complex.php Still simple example on how to build a menu, but the menu is a lot more complex this time and includes several sub-levels > example_SaveState.php This example builds the same menu as the previous example file but lets you save the state of your menu: When a user goes to another page which also displays the menu, you might want to display the menu as it was when the user left the previous page, that is, with expanded or collapsed nodes as they were. In this example, you learn how to simply call 2 Javascript functions that will save the state of the menu inside a cookie and then restore it from that same cookie. Warming: the user must allow cookies on his browser to ba able to use this feature. > example_reuseHTML.php In this example you also build the same complex tree but you are taught how to save the generated code in a file! Why? In some cases, your menu might not need to be dynimically generated every time, for instance if the menu is used to display links to your website's pages, these links might never change at all. The example helps you build a page that will: - generate the menu if it had not been generated before - save the generated code inside a file - and restore the menu from that file if it is found