/*
 * **************************
 * Snippet: PrevJumpNext
 * By: Jeroen Bosch modded by OncleBen31
 * Date: May 2006
 * version: 0.3 (based on the PrevNext v0.9)
 * **************************
 *
 * Function:
 * Generates buttons to navigate between document of a same directory. 
 * Very handy on top or bottom of each individual newspost/log item
 * Highly configurable. It can display :
 *  - 'Prev' and 'Next' button with or without document titles
 *  - 'first' and 'last' document.
 *  - 'Index' link to parent folder
 *  - a DropList to jump quickly to a document
 *
 * You can use a classic use of the snippet or use the paginate option
 * which allow you to use PlaceHolders to personnalise your navigation 
 * buttons :
 *  - [+PJN_first+] : the first document
 *  - [+PJN_prev+] : the previous document
 *  - [+PJN_jump+] : the droplist to jump to the selectionned document
 *  - [+PJN_index+] : the link to retern to the index page
 *  - [+PJN_next+] : the next document
 *  - [+PJN_last+] : the last document
 * 
 * There is many option which can allow you to sort the document, set 
 * the text to use with the element, etc ... :
 * - sortBy : Sort items by? 'menuindex' or 'id' or 'createdon', etc... (default createdon)
 * - sortHow : Sort items How? 'ASC' or 'DESC' (default ASC)
 * - displayTitle : how 'prev' and 'next' or display document titles (default true)
 * - displayFixed : Show 'first' and 'last' (default false)
 * - usePlaceHolder : Set at true to use PlaceHolder : [+PJN_first+] , [+PJN_prev+] , [+PJN_jump+] , [+PJN_index+] , [+PJN_next+] , [+PJN_index+]  (default false)
 * - useJump : Replace the Index link by the Jump dropList when NOT using the PlaceHolders (default false)
 * - indexDocumentID :Specifie the document to go using the link "index". (by default its is the parent ID)
 * - displayNoPrevNext : set to true to display a text when there is no Prev or no Next element (default false)
 * - noPrevNextText : Text to display if there is no Prev or no Next element :(default "-")
 * - indexText : Text to use with the link "index" (default "Index")
 * - jumpText : Text to use with the dropdown list (jump function) (default :"Please Select")
 * - firstText : Text to use with the link "First" (default "<< First")
 * - prevText : Text to use with the link "Prev" when $displayTitle is set to false (default "< Prev")
 * - nextText : Text to use with the link "Next" when $displayTitle is set to false (default "Next >")
 * - lastText : Text to use with the link "Last" (default "Last >>")
 *
 *
 * The output use <div> and <span> to allow you to CSS the buttons
 * 
 *
 * Enjoy and don't esitate to ask new features
 * Exemples :
 * 
 * [[PrevNext? sortBy=menuindex &sortHow=ASC &displayTitle=true]]
 * Or
 * [[PrevJumpNext_New? &sortBy=`pub_date` &usePlaceHolder=true &indexDocumentID=`84` &firstText=`Première` &lastText=`Dernière` &prevText=`Précédente` &nextText=`Suivante` &indexText=`Liste des News` &jumpText=`Accès rapide` &displayNoPrevNext=true &noPrevNextText=`C'est le bout`]]
 * with this place holder in the document [+PJN_first+] [+PJN_prev+] [+PJN_jump+] [+PJN_index+] [+PJN_next+] [+PJN_last+] 
 */