Introducing - EasyBookMarkerPro v. 4.1 EasyBookMarkerPro™ is designed to host user`s bookmarks for definite number of interested people.

For Web Masters

Incorporating EasyBookMarkerPro
in your existing WEB site

Themes

You can use the powerfull EasyBookmarkPro software template system to easilly incorporate EasyBookmarker into your existing WEB Site.

Create new directory, named /theme(Index) under your EasyBookmarker install tree. Place the images, used by your site inside it. Take a look at existing themes and learn how to construct your template index.php. Add your template definitions to theme_definisions.php, located under root of your EasyBookmarkerPro install tree.

Quiet Output

Include EasyBookmarkerPro main index.php file (located under root of your EasyBookmarkerPro install tree) from within existing PHP file on your WEB Site. Do not forget to set $QuietOutput variable in order to supress EasyBookmarker output. You can do it this way:

<?php
     //... Some code from your WEB Page ...
     $QuietOutput=TRUE;
     include_once "your_EasyBookmarker_path/index.php";
     //... Some code from your WEB Page ...
?>

Once included, EasyBookmarkerPro will provide you with some Variables and functions wich contains/generates EasyBookmarker structures.

Supplied Variables

$Easy - All EasyBookmarker control-flow data as Languages, version, MySQL connect variables, plus a lot more... To see what actualy $Easy consists of, do the following:
     1. Include EasyBookmark as shown above;
     2. Add the following lines on the bottom of your php script:

<?php
     $retve='';
     display_array($Easy);
     echo '$EASY:'.$retve;
?>

$_SESSION["MyioSoft"]["EasyBookMarker"] - EasyBookmarker runtime variables like, current theme and language sellection, authorized user plus a lot of more. To see what actualy $_SESSION["MyioSoft"]["EasyBookMarker"] consists of, do the following:
     1. Include EasyBookmark as shown above;
     2. Add the following lines on the bottom of your php script:

<?php
     $retve='';
     display_array($_SESSION["MyioSoft"]["EasyBookMarker"]);
     echo 'Runtime session:'.$retve;
?>

$Page - EasyBookmarks runtime control-flow variables like current Page Heading, Location, Page Digits, Theme, Language plus some more... To see what actualy $Page consists of, do the following:
     1. Include EasyBookmark as shown above;
     2. Add the following lines on the bottom of your php script:

<?php
     $retve='';
     display_array($Page);
     echo '$Page:'.$retve;
?>

$PageHTML - Current EasyBookmarker page HTML. To see what actualy $Page consists of, do the following:
     1. Include EasyBookmark as shown above;
     2. Add the following lines on the bottom of your php script:

<?php
     echo $PageHTML;
?>

Supplied functions

You may use the following functions to display EasyBookmarkPro menues and data:

function MainMenuOutput
(Link CSS Class,Menu orientation)

• Link CSS Class (null or CSS Class) - CSS class for your links generation, defined in your theme.css file. If null, no classes are used.
•  Menu orientation (null or string) - Set to "horizontal" for Horizontal menu creation and to "vertical" for Vertical menu creation.
• Use: <?php echo MainMenuOutput(); ?>

• Link CSS Class (null or CSS Class) - CSS class for your link generation, defined in your theme.css file. If null, no classes are used.
  
• Menu orientation (null or string) - Set to "horizontal" for Horizontal menu creation and to "vertical" for Vertical menu creation.
  
• Returns FALSE if user is not authorized nor master
  
• Use: <?php if (UsersMenuOutput()) echo UsersMenuOutput(); ?>
  

• Link CSS Class (null) - not used.
  
• Search box orientation (null or string) - Set to "horizontal" for Horizontal search box creation and to "vertical" for Vertical search box creation.
  
• Use: <?php echo SearchOutput(); ?>
  

• Link CSS Class (null or CSS Class) - CSS class for your links generation, defined in your theme.css file. If null, no classes are used.
  
• Menu orientation (null or string) - Set to "horizontal" for Horizontal menu creation and to "vertical" for Vertical menu creation.
  
• Use: <?php echo LanguageMenuOutput(); ?>
  

• Link CSS Class (null or CSS Class) - CSS class for your links generation, defined in your theme.css file. If null, no classes are used.
  
• Menu orientation (null or string) - Set to "horizontal" for Horizontal menu creation and to "vertical" for Vertical menu creation.
  
• Use: <?php echo ThemeMenuOutput(); ?>
  

• Link CSS Class (null or CSS Class) - CSS class for your links generation, defined in your theme.css file. If null, no classes are used.
  
• Menu orientation (null or string) - Set to "horizontal" for Horizontal menu creation and to "vertical" for Vertical menu creation.
  
• Use: <?php echo ActionsMenuOutput(); ?>
  

• Link CSS Class (null or CSS Class) - CSS class for your links generation, defined in your theme.css file. If null, no classes are used.
  
• Use: <?php echo UserInfoOutput(); ?>
  

• File (string) - your desired imgage file (ex. link.gif) - the function will search for link_theme_index.gif under /theme_index/ directory
  
• Alternate Text (null or string) - Alternate text for ALT image attribute (ex. "My Link") - optional
  
• Attributes (null or string) - Additional image attributes (ex. "align=right" or "hspace=10") - optional
  
• Use: <?php echo img("link.gif","My Link","align=right"); ?>
  
• Use: <?php echo img("|link.gif"); ?> - returns only File - for background attributes
  
  

• Link CSS Class (null or CSS Class) - CSS class for your links generation, defined in your theme.css file. If null, no classes are used.
  
• Page digits (null or Array) - First digit is Theme, second is Language, third is Page action, fourth is Category/Subcategory index or variable, others
  
• Use: <?php echo CreateLink(null,Array(0,0,'LoginHTML')).'Please Login'; ?> - Will display Login screen when clicked
  
• instead of LoginHTML you may use any of the following: "AddFolderHTML", "AddLinkHTML", "QuickAddHTML", "ExportHTML", "ImportHTML", "TrialHTML", "ThemesHTML", "Logout", "EditLink", "DeleteLink", "EditFolder", "DeleteFolder", "UserListHTML", "AddUserHTML", "EditUserHTML", "DeleteUserHTML", "SearchResultsHTML"
  
• For specific calling of these function see easybookmarker_library.php (located under root of your EasyBookmarker install tree)
  
• Use: <?php echo CreateLink(null,Array(0,0,0,CategoryID)).'Category name'; ?> - Will display CategoryID category and links under it
  
• Use: <?php echo CreateLink().'Home'; ?> - Will display Home (Root) category and links under it
  

Using multiple languages

The available languages, words and phrases are located in your languages.php under root of your EasyBookmarkerPro tree.

The Common format is : $Language["en"]["Phrase"]="Translation";

• Where "en" is the language - default English - could be any, ex. "ru" - Russion, "es" - Spanish, etc.
  
• Where "Phrase" must not to be changed - EasyBookMarkerPro uses this to translate - it is the default language phrase
  
• Where "Translation" is "Phrase" translated - you may put your own language translation in here
  

First language is the default one - our default is en = English US

You may use the Language Array to display text in currently user-selected language

• Use:
  <?php echo echo $Easy["MyioSoft"]["EasyBookMarker"] ["Languages"][$Page["Language"]]["Search"]; ?>
  will display word "Search" in any language, supported by EasyBookmarkerPro.
• Use:
  <?php echo echo $Easy["MyioSoft"]["EasyBookMarker"] ["Languages"][$Page["Language"]]["Open folder"]; ?>
  will display phrase "Open folder" in any language, supported by EasyBookmarkerPro.

If you translate EasyBookmarkerPro in other Languages insted of currently supported, please mail us your languages.php to include it to our new releases.