fix export, web_path was not set correctly
[phpfspot.git] / phpfspot.js
index 0cec6715e8ebf7b383407fbd1092136a17d46bbc..ebe124225f169a182530acda770bdccc46c22f72 100644 (file)
@@ -1,5 +1,36 @@
-function showImage(id, scrollup)
+/***************************************************************************
+ *
+ * phpfspot, presents your F-Spot photo collection in Web browsers.
+ *
+ * Copyright (c) by Andreas Unterkircher
+ *
+ *  This program is free software; 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
+ *  any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ *
+ ***************************************************************************/
+
+/**
+ * show photo
+ *
+ * this function will be called by client and fetches
+ * the single-photo view via AJAX from the server.
+ * Furthermore it will scrollup the browser to the top
+ * position so the image become visibile immediatley.
+ */
+function showPhoto(id, scrollup)
 {
+   /* is phpfspot skeleton really displayed? */
    if(!document.getElementById('content'))
       return;
 
@@ -10,7 +41,8 @@ function showImage(id, scrollup)
       content.innerHTML = "";
    }
 
-   HTML_AJAX.replace(content, encodeURI('rpc.php?action=showphoto&id=' + id));
+   /* fetch single-photo view from server */
+   HTML_AJAX.replace(content, encodeURI(web_path + '/rpc.php?action=showphoto&id=' + id));
 
    /* scroll the window up to the top */
    if(scrollup != undefined) {
@@ -21,8 +53,16 @@ function showImage(id, scrollup)
    delete(origHeight); origHeight = undefined;
    delete(origWidth); origWidth = undefined;
    delete(photo_details_pos); photo_details_pos = undefined;
-}
 
+} // showPhoto()
+
+/**
+ * scroll browser to the last shown photo
+ *
+ * this function will be called when user returns from single-photo
+ * to the photo index. It will scroll down the window (if possible)
+ * to the position of the last shown photo.
+ */
 function moveToThumb(thumb_id)
 {
    if(thumb_id == undefined)
@@ -34,6 +74,13 @@ function moveToThumb(thumb_id)
 
 } // moveToThumb()
 
+/**
+ * return position of object
+ *
+ * this function returns the position of an object.
+ * depending on the parameter 'direction' it will either
+ * return the X or Y position.
+ */
 function findPos(obj, direction) {
    var cur = 0;
    if (obj.offsetParent) {
@@ -45,14 +92,30 @@ function findPos(obj, direction) {
       } while (obj = obj.offsetParent);
    }
    return [cur];
-}
 
+} // findPos()
+
+/**
+ * opens the credits page
+ */
 function showCredits()
 {
    var credits = document.getElementById("content");
-   credits.innerHTML = HTML_AJAX.grab(encodeURI('rpc.php?action=showcredits'));
-}
-
+   credits.innerHTML = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=showcredits'));
+
+} // showCredits()
+
+/**
+ * tag-selection handling
+ *
+ * this function is getting called by client to either
+ * - add
+ ∗ - delete
+ * - modify tag-match condition
+ *
+ * It will then fetch the result from the server via AJAX
+ * and updates the tag-selection.
+ */
 function Tags(mode, id)
 {
    var objTemp = new Object();
@@ -73,7 +136,7 @@ function Tags(mode, id)
       objTemp['mode'] = id.value;
    }
 
-   var retr = HTML_AJAX.post('rpc.php', objTemp);
+   var retr = HTML_AJAX.post(web_path + '/rpc.php', objTemp);
    if(retr == "ok") {
       refreshAvailableTags();
       refreshSelectedTags();
@@ -85,25 +148,51 @@ function Tags(mode, id)
 
 } // Tags()
 
+/**
+ * update available-tags tag-cloud
+ *
+ * this function queries an actual version of the tag-cloud
+ * for the available (not-selected) tags from the server via
+ * AJAX.
+ */
 function refreshAvailableTags()
 {
    // update available tags
    var avail_tags = document.getElementById('available_tags');
-   avail_tags.innerHTML = "Loading...";
-   avail_tags.innerHTML = HTML_AJAX.grab(encodeURI('rpc.php?action=show_available_tags'));
-}
+   if(avail_tags != undefined) {
+      avail_tags.innerHTML = "Loading...";
+      avail_tags.innerHTML = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=show_available_tags'));
+   }
 
+} // refreshAvailableTags()
+
+/**
+ * update selected-tags list
+ *
+ * this function queries an actual version of the tag-list
+ * for the selected tags from the server via AJAX.
+ */
 function refreshSelectedTags()
 {
    // update selected tags
    var selected_tags = document.getElementById("selected_tags");
-   selected_tags.innerHTML = "Loading...";
-   selected_tags.innerHTML = HTML_AJAX.grab(encodeURI('rpc.php?action=show_selected_tags'));
-}
+   if(selected_tags != undefined) {
+      selected_tags.innerHTML = "Loading...";
+      selected_tags.innerHTML = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=show_selected_tags'));
+   }
+
+} // refreshSelectedTags()
 
+/**
+ * show photo index
+ *
+ * this function will fetch the photo-index view from
+ * the server via AJAX. It's also used to browse through
+ * the photo-index pages
+ */
 function showPhotoIndex(begin_with, last_photo)
 {
-   var url = "rpc.php?action=show_photo_index";
+   var url = web_path + "/rpc.php?action=show_photo_index";
    if(begin_with != undefined)
       url = url + '&begin_with=' + begin_with;
    if(last_photo != undefined)
@@ -113,26 +202,45 @@ function showPhotoIndex(begin_with, last_photo)
 
 } // showPhotoIndex()
 
-// if photo index is currently shown, refresh it
+/**
+ * update photo index
+ *
+ * this function will be called, to request a refresh of the
+ * photo index. this, for example, can be caused, when changing
+ * the tag-selection.
+ */
 function refreshPhotoIndex()
 {
+   /* only invoke showPhotoIndex(), if photo-index is really shown */
    if(document.getElementById("index") != undefined || startup == 1) {
       showPhotoIndex();
       startup = 0;
    }
-}
 
+} // refreshPhotoIndex()
+
+/**
+ * blur cursor focus
+ *
+ * this function removes the focus-rectangle which may appear
+ * when click on a link. Not always beautiful.
+ */
 function click(object)
 {
    if(object.blur)
       object.blur();
 
-}
-
-// set the radio button with the given value as being checked
-// do nothing if there are no radio buttons
-// if the given value does not exist, all the radio buttons
-// are reset to unchecked
+} // click()
+
+/**
+ * change current radio-button setting
+ *
+ * This function will check the radio-button with the given value.
+ * If no radio-button is currently displayed, this function will do
+ * nothing.
+ * If the given value does not exist, the existing radio buttons will
+ * be reseted.
+ */
 function setCheckedValue(condition, value) {
 
    var count = condition.length;
@@ -146,8 +254,15 @@ function setCheckedValue(condition, value) {
          condition[i].checked = true;
       }
    }
-}
 
+} // setCheckedValue()
+
+/**
+ * Invoke a search
+ *
+ * This function will be invoked by starting
+ * any kind of search (tag-name, photo-name, date, ...).
+ */
 function startSearch()
 {
    from_year = document.getElementById('fromyear').value;
@@ -162,18 +277,26 @@ function startSearch()
    var objTemp = new Object();
    objTemp['action'] = 'search';
 
-   if(document.getElementsByName('searchfor_tag')[0].value != "") {
+   if(document.getElementsByName('searchfor_tag')[0] != undefined &&
+      document.getElementsByName('searchfor_tag')[0].value != "") {
       objTemp['for_tag'] = document.getElementsByName('searchfor_tag')[0].value;
    }
-   if(document.getElementsByName('searchfor_name')[0].value != "") {
+   if(document.getElementsByName('searchfor_name')[0] != undefined &&
+      document.getElementsByName('searchfor_name')[0].value != "") {
       objTemp['for_name'] = document.getElementsByName('searchfor_name')[0].value;
    }
-   if(document.getElementsByName('consider_date')[0].checked == true) {
+   if(document.getElementsByName('consider_date')[0] != undefined &&
+      document.getElementsByName('consider_date')[0].checked == true) {
       objTemp['from'] = from;
       objTemp['to'] = to;
    }
+   if(document.getElementsByName('consider_rate')[0] != undefined &&
+      document.getElementsByName('consider_rate')[0].checked == true) {
+      objTemp['rate_from'] = rate_search['from'];
+      objTemp['rate_to'] = rate_search['to'];
+   }
 
-   var retr = HTML_AJAX.post('rpc.php', objTemp);
+   var retr = HTML_AJAX.post(web_path + '/rpc.php', objTemp);
    if(retr == "ok") {
       refreshAvailableTags();
       refreshSelectedTags();
@@ -185,6 +308,12 @@ function startSearch()
 
 } // startSearch()
 
+/**
+ * enable/disable date search
+ *
+ * this function will either enable or disable the
+ * input fields for the date-search
+ */
 function datesearch()
 {
    var mode = true;
@@ -200,35 +329,82 @@ function datesearch()
    document.getElementById('tomonth').disabled = mode;
    document.getElementById('today').disabled = mode;
  
-}
-
-function setViewMode(mode)
+} // datesearch()
+
+/**
+ * set view mode
+ *
+ * called for photo-index export. will return the
+ * selected mode via AJAX from the server.
+ */
+function setViewMode(srv_webpath, mode)
 {
+   if(srv_webpath != undefined)
+      web_path = srv_webpath;
+   else
+      web_path = '';
+
    var exprt = document.getElementById('output');
    exprt.innerHTML = "Loading...";
-   exprt.innerHTML = HTML_AJAX.grab(encodeURI('rpc.php?action=get_export&mode=' + mode));
-}
+   exprt.innerHTML = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=get_export&mode=' + mode));
 
+} // setViewMode()
+
+/**
+ * reset all search-fields
+ */
 function clearSearch()
 {
-   document.getElementsByName('searchfor_tag')[0].value = '';
-   document.getElementsByName('searchfor_name')[0].value = '';
+   if(document.getElementsByName('searchfor_tag')[0] != undefined)
+      document.getElementsByName('searchfor_tag')[0].value = '';
+   if(document.getElementsByName('searchfor_name')[0] != undefined)
+      document.getElementsByName('searchfor_name')[0].value = '';
 
-   if(document.getElementsByName('consider_date')[0].checked == true) {
+   if(document.getElementsByName('consider_date')[0] != undefined &&
+      document.getElementsByName('consider_date')[0].checked == true) {
       document.getElementsByName('consider_date')[0].checked = false;
       datesearch();
-   }  
-}
+   }
+   if(document.getElementsByName('consider_rate')[0] != undefined &&
+      document.getElementsByName('consider_rate')[0].checked == true) {
+      document.getElementsByName('consider_rate')[0].checked = false;
+   }
+
+} // clearSearch()
 
+/**
+ * if the client is planless, ask the server what to do
+ * next.
+ */
 function AskServerWhatToDo()
 {
-   return HTML_AJAX.grab(encodeURI('rpc.php?action=what_to_do'));
-}
-
-function init_phpfspot(mode)
+   return HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=what_to_do'));
+
+} // AskServerWhatToDo()
+
+/**
+ * init phpfspot
+ *
+ * this function will be called when the browser opens phpfspot
+ * the first time. It will fetch the tag-lists and will then
+ * switch to the right view, which the browser got told from
+ * the server (maybe someone hit the refresh button...).
+ *
+ * as parameter the server can set the correct webpath.
+ * espacialley when using user-friendly url's, the browser
+ * does not know the correct URLs to address images, stylesheets,
+ * ... then.
+ */
+function init_phpfspot(srv_webpath)
 {
+   if(srv_webpath != undefined)
+      web_path = srv_webpath;
+   else
+      web_path = '';
+
    /* always load list of available tags */
-   refreshAvailableTags();
+   //this should not be more necessary since 4.5.08
+   //refreshAvailableTags();
 
    /* ask the server what we are currently displaying */
    whattodo = AskServerWhatToDo();
@@ -242,12 +418,16 @@ function init_phpfspot(mode)
    }
    if(whattodo == 'show_photo') {
       if(photo = getPhotoToShow()) {
-         showImage(photo);
+         showPhoto(photo);
          refreshSelectedTags();
       }
    }
+
 } // init_phpfspot()
 
+/**
+ * change background-color on mouse-over
+ */
 function setBackGrdColor(item, color)
 {
    if(color == 'mouseover')
@@ -256,20 +436,35 @@ function setBackGrdColor(item, color)
       item.style.backgroundColor='#eeeeee';
    if(color == 'mouseclick')
       item.style.backgroundColor='#93A8CA';
-}
 
+} // setBackGrdColor()
+
+/**
+ * ask server, which photo needs to be shown
+ *
+ * when user press the refresh-button in a single-photo
+ * view or maybe enters the link via an external URL, the
+ * client does not know, what photo will be shown (dimensions...).
+ * But the server can tell this the browser.
+ */
 function getPhotoToShow()
 {
-   // update selected tags
-   var photo_to_show = HTML_AJAX.grab(encodeURI('rpc.php?action=get_photo_to_show'));
+   var photo_to_show = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=get_photo_to_show'));
 
    // if no image needs to be shown, return false from here
    if(photo_to_show == "")
       return false;
    
    return photo_to_show;
-}
 
+} // getPhotoToShow()
+
+/**
+ * a fake-zoom for photo
+ *
+ * a quick to let the browser do some zooming on
+ * photos.
+ */
 function zoom(mod)
 {
    var photo;
@@ -318,6 +513,12 @@ function zoom(mod)
 
 } // zoom()
 
+/**
+ * hides the photo details layin
+ *
+ * if the photo is getting zoomed quiet large, this will
+ * auto-hide (and also restore) the photo-details-box.
+ */
 function hidePhotoDetails(mode)
 {
    var photo_details;
@@ -329,11 +530,14 @@ function hidePhotoDetails(mode)
       }
       else {
          photo_details.style.visibility = 'visible';
-         photo_details.style.display = 'inline';
+         photo_details.style.display = '';
       }
    }
 } // hidePhotoDetails()
 
+/**
+ * show calendar
+ */
 function showCalendar(date_box, click_obj)
 {
    var calendar = document.getElementById('calendar');
@@ -355,14 +559,18 @@ function showCalendar(date_box, click_obj)
    if(calendar.style.visibility == "" || calendar.style.visibility == 'hidden') {
       calendar.style.visibility = 'visible';
       calendar.innerHTML = "Loading...";
-      calendar.innerHTML = HTML_AJAX.grab(encodeURI('rpc.php?action=get_calendar_matrix&year=' + year + '&month=' + month));
+      calendar.innerHTML = HTML_AJAX.grab(encodeURI(web_path +'/rpc.php?action=get_calendar_matrix&year=' + year + '&month=' + month));
       calendar_shown = 1;
    }
    else {
       hideCalendar();
    }
-}
 
+} // showCalendar()
+
+/**
+ * hide calendar
+ */
 function hideCalendar()
 {
    var calendar = document.getElementById('calendar');
@@ -370,32 +578,47 @@ function hideCalendar()
       calendar.style.visibility = 'hidden';
       calendar_shown = 0;
    }
-}
+} // hideCalendar()
 
+/**
+ * switch month in calendar
+ */
 function setMonth(year, month, day)
 {
    var calendar = document.getElementById('calendar');
    calendar.innerHTML = "Loading...";
-   calendar.innerHTML = HTML_AJAX.grab(encodeURI('rpc.php?action=get_calendar_matrix&year='+ year +'&month='+ month +'&day='+ day));
+   calendar.innerHTML = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=get_calendar_matrix&year='+ year +'&month='+ month +'&day='+ day));
 }
 
+/**
+ * get the user-selected date from the calendar and
+ * put it into the date-search boxes
+ */
 function setCalendarDate(year, month, day)
 {
    document.getElementById(calendar_mode+'year').value = year;
    document.getElementById(calendar_mode+'month').value = month;
    document.getElementById(calendar_mode+'day').value = day;
    hideCalendar();
-}
 
+} // setCalendarDate()
+
+/**
+ * reset phpfspot complelely and move to the begining
+ */
 function resetAll()
 {
-   HTML_AJAX.grab(encodeURI('rpc.php?action=reset'));
+   HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=reset'));
    clearSearch();
    refreshAvailableTags();
    refreshSelectedTags();
    refreshPhotoIndex();
-}
 
+} // resetAll()
+
+/**
+ * find objects with their class-name
+ */
 function WSR_getElementsByClassName(oElm, strTagName, oClassNames){
    var arrElements = (strTagName == "*" && oElm.all)? oElm.all : oElm.getElementsByTagName(strTagName);
    var arrReturnElements = new Array();
@@ -424,67 +647,104 @@ function WSR_getElementsByClassName(oElm, strTagName, oClassNames){
       }
    }
    return (arrReturnElements)
-}
-
 
-function preloadPhotos(lbImg) {
+} // WSR_getElementsByClassName()
 
-   var d=document;
-   if(d.images)
-      if(!d.photos)
-         d.photos=new Array();
+/**
+ * javascript based photo preloading
+ */
+function preloadPhotos(image_url) {
 
-   var i, j=d.photos.length;
+   var i;
+   var timeout = 1000;
+   var waiting = 100;
+   var counting;
 
    lbImg=WSR_getElementsByClassName(document,"img","thumb");
    for(i=0;i<lbImg.length;i++){
-      d.photos[j]=new Image;
-      d.photos[j].src=lbImg[i].src;
-      j++;
+      lbImg[i].src=image_url[i];
+      // to not bomb the server with requests, give the page some time
+      // to load the images one by one. if a image exceeds the timeout,
+      // the next image will be loaded.
+      if(lbImg[i].complete != undefined && lbImg[i].complete != true) {
+         counting = 0;
+         while(lbImg[i].complete != true && counting < timeout) {
+            window.setTimeout("noop()", waiting);
+            counting+=waiting;
+         }
+      }
    }
-}
 
-function startSlideShow()
+} // preloadPhotos()
+
+/* a function that does nothing */
+function noop() {}
+
+/**
+ * start slideshow
+ */
+function startSlideShow(srv_webpath)
 {
+   if(srv_webpath != undefined)
+      web_path = srv_webpath;
+   else
+      web_path = '';
+
    if(!sliding) {
-      HTML_AJAX.grab(encodeURI('rpc.php?action=reset_slideshow'));
+      HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=reset_slideshow'));
       nextSlide();
       sliding = setInterval("nextSlide()", sliding_time*1000);
-      document.getElementById('stop_ico').src = "resources/32_stop.png";
+      document.getElementById('stop_ico').src = web_path + "/resources/32_stop.png";
    }
    else {
       clearInterval(sliding);
       sliding = 0;
-      document.getElementById('stop_ico').src = "resources/32_play.png";
+      document.getElementById('stop_ico').src = web_path + "/resources/32_play.png";
    }
-}
 
+} // startSlideShow()
+
+/**
+ * switch to next slide
+ */
 function nextSlide()
 {
-   var next_img = HTML_AJAX.grab(encodeURI('rpc.php?action=get_next_slideshow_img'));
+   var next_img = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=get_next_slideshow_img'));
    document.getElementById('slide_img').src = next_img;
-}
 
+} // nextSlide()
+
+/**
+ * switch to previous slide
+ */
 function prevSlide()
 {
-   var prev_img = HTML_AJAX.grab(encodeURI('rpc.php?action=get_prev_slideshow_img'));
+   var prev_img = HTML_AJAX.grab(encodeURI(web_path + '/rpc.php?action=get_prev_slideshow_img'));
    document.getElementById('slide_img').src = prev_img;
-}
 
+} // prevSlide()
+
+/**
+ * interrupt slide show
+ */
 function pauseSlideShow()
 {
    if(!sliding_paused) {
       sliding_paused = 1;
       clearInterval(sliding);
-      document.getElementById('pause_ico').src = "resources/32_play.png";
+      document.getElementById('pause_ico').src = web_path + "/resources/32_play.png";
    }
    else {
       sliding_paused = 0;
       sliding = setInterval("nextSlide()", sliding_time*1000);
-      document.getElementById('pause_ico').src = "resources/32_pause.png";
+      document.getElementById('pause_ico').src = web_path + "/resources/32_pause.png";
    }
-} 
 
+} // pauseSlideShow()
+
+/**
+ * start auto-browse
+ */
 function startAutoBrowse()
 {
    if(!autobrowse) {
@@ -494,27 +754,33 @@ function startAutoBrowse()
    else {
       clearInterval(autobrowse);
       autobrowse = 0;
-      document.getElementById('autobrowse_ico').src = "resources/32_play.png";
+      document.getElementById('autobrowse_ico').src = web_path + "/resources/32_play.png";
    }
 
 } // startAutoBrowser()
 
+/**
+ * auto-browsing
+ */
 function autoBrowse()
 {
    if(document.getElementById('next_link')) {
       var next_link = document.getElementById('next_link').href;
       window.location.href = next_link;
-      document.getElementById('autobrowse_ico').src = "resources/32_pause.png";
+      document.getElementById('autobrowse_ico').src = web_path + "/resources/32_pause.png";
    }
    /* we have reached the last photo */
    else {
       if(ab_ico = document.getElementById('autobrowse_ico'))
-         ab_ico.src = "resources/32_play.png";
+         ab_ico.src = web_path + "/resources/32_play.png";
       clearInterval(autobrowse);
    }
 
 } // autoBrowse()
 
+/**
+ * initiate slider to modify slide-switching-speed
+ */
 function initSlider()
 {
    var sliderEl = document.getElementById ? document.getElementById("slider-1") : null;
@@ -536,14 +802,18 @@ function initSlider()
       s.recalculate();
    };
 
-}
+} // initSlider()
 
+/**
+ * if the sort-order (photo-name, date, ...) has been
+ * changed, update the photo-index view.
+ */
 function update_sort_order(obj)
 {  
    var objTemp = new Object();
    objTemp['value'] = obj.options[obj.selectedIndex].value;
 
-   var retr = HTML_AJAX.post('rpc.php?action=update_sort_order', objTemp);
+   var retr = HTML_AJAX.post(web_path + '/rpc.php?action=update_sort_order', objTemp);
 
    if(retr == "ok") {
       showPhotoIndex();
@@ -554,7 +824,67 @@ function update_sort_order(obj)
 
 } // update_sort_order()
 
+/**
+ * show rate stars
+ *
+ * this function will show the requested amount of
+ * rate-stars.
+ *
+ * @param string mode
+ * @param int level
+ */
+function show_rate(mode, level)
+{
+   var i;
+
+   for(i = 1; i <= 5; i++) {
+      if(i <= level) {
+         document.getElementById('rate_' + mode + '_' + i).src = web_path + '/resources/star.png';
+      }
+      else {
+         document.getElementById('rate_' + mode + '_' + i).src = web_path + '/resources/empty_rate.png';
+      }
+   }
+
+} // show_rate()
+
+/**
+ * set rate stars
+ *
+ *
+ * this function will set the requested rate-stars-amount into a global
+ * variable (which will then later be used on form-submit) and will also
+ * update the display.
+ *
+ * @param string mode
+ * @param int level
+ */
+function set_rate(mode, level)
+{
+   rate_search[mode] = level;
+   show_rate(mode, level);
+
+} // set_rate()
+
+/**
+ * reset rate stars
+ *
+ * this function will reset the rate-star to their initial value.
+ *
+ * @param string mode
+ */
+function reset_rate(mode)
+{
+   if(rate_search[mode] == undefined)
+      rate_search[mode] = 0;
+
+   show_rate(mode, rate_search[mode]);
+
+} // reset_rate()
 
+/**
+ * handle key events
+ */
 function keyDown(e) {
    var evt = (e) ? e:(window.event) ? window.event:null;
 
@@ -595,13 +925,20 @@ if(document.layers) {
    document.captureEvents(Event.KEYDOWN);
 }
 
+// will be reseted by first viewing photo-index
 var startup = 1;
+// calendar specific
 var calendar_shown = 0;
 var calendar_mode = '';
+// auto-browsing & sliding
 var autobrowse = 0;
 var sliding = 0;
 var sliding_paused = 0;
 var sliding_time = 3;
+// zooming
 var origHeight;
 var origWidth;
+// position of the last shown photo in photo-index
 var photo_details_pos;
+var web_path;
+var rate_search = new Array();