a14c4f6efdaa0f1341e2a18b33df2cddc8745004
[phpfspot.git] / phpfspot.class.php
1 <?php
2
3 /***************************************************************************
4  *
5  * Copyright (c) by Andreas Unterkircher, unki@netshadow.at
6  * All rights reserved
7  *
8  *  This program is free software; you can redistribute it and/or modify
9  *  it under the terms of the GNU General Public License as published by
10  *  the Free Software Foundation; either version 2 of the License, or
11  *  any later version.
12  *
13  *  This program is distributed in the hope that it will be useful,
14  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
15  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  *  GNU General Public License for more details.
17  *
18  *  You should have received a copy of the GNU General Public License
19  *  along with this program; if not, write to the Free Software
20  *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21  *
22  ***************************************************************************/
23
24 require_once "phpfspot_cfg.php";
25 require_once "phpfspot_db.php";
26
27 class PHPFSPOT {
28
29    var $cfg;
30    var $db;
31    var $cfg_db;
32    var $tmpl;
33    var $tags;
34    var $avail_tags;
35    private $dbver;
36
37    /**
38     * class constructor
39     *
40     * this function will be called on class construct
41     * and will check requirements, loads configuration,
42     * open databases and start the user session
43     */
44    public function __construct()
45    {
46       $this->cfg = new PHPFSPOT_CFG;
47
48       /* set application name and version information */
49       $this->cfg->product = "phpfspot";
50       $this->cfg->version = "1.2";
51
52       $this->sort_orders= array(
53          'date_asc' => 'Date &uarr;',
54          'date_desc' => 'Date &darr;',
55          'name_asc' => 'Name &uarr;',
56          'name_desc' => 'Name &darr;'
57       );
58
59       /* Check necessary requirements */
60       if(!$this->checkRequirements()) {
61          exit(1);
62       }
63
64       $this->db  = new PHPFSPOT_DB($this, $this->cfg->fspot_db);
65       if(!is_writeable($this->cfg->fspot_db)) {
66          print $this->cfg->fspot_db ." is not writeable for user ". $this->getuid() ."\n";
67          exit(1);
68       }
69
70       $this->dbver = $this->getFspotDBVersion();
71
72       if(!is_writeable(dirname($this->cfg->phpfspot_db))) {
73          print dirname($this->cfg->phpfspot_db) .": directory is not writeable for user ". $this->getuid() ."\n";
74          exit(1);
75       }
76
77       if(!is_writeable($this->cfg->base_path ."/templates_c")) {
78          print $this->cfg->base_path ."/templates_c: directory is not writeable for user ". $this->getuid() ."\n";
79          exit(1);
80       }
81
82       $this->cfg_db = new PHPFSPOT_DB($this, $this->cfg->phpfspot_db);
83       if(!is_writeable($this->cfg->phpfspot_db)) {
84          print $this->cfg->phpfspot_db ." is not writeable for user ". $this->getuid() ."\n";
85          exit(1);
86       }
87
88       $this->check_config_table();
89
90       /* include Smarty template engine */
91       if(!$this->check_readable($this->cfg->smarty_path .'/libs/Smarty.class.php')) {
92          exit(1);
93       }
94       require $this->cfg->smarty_path .'/libs/Smarty.class.php';
95       /* overload Smarty class if our own template handler */
96       require_once "phpfspot_tmpl.php";
97       $this->tmpl = new PHPFSPOT_TMPL($this);
98
99       /* check if all necessary indices exist */
100       $this->checkDbIndices();
101
102       /* if session is not yet started, do it now */
103       if(session_id() == "")
104          session_start();
105
106       if(!isset($_SESSION['tag_condition']))
107          $_SESSION['tag_condition'] = 'or';
108
109       if(!isset($_SESSION['sort_order']))
110          $_SESSION['sort_order'] = 'date_asc';
111
112       if(!isset($_SESSION['searchfor']))
113          $_SESSION['searchfor'] = '';
114
115       // if begin_with is still set but rows_per_page is now 0, unset it
116       if(isset($_SESSION['begin_with']) && $this->cfg->rows_per_page == 0)
117          unset($_SESSION['begin_with']);
118
119    } // __construct()
120
121    public function __destruct()
122    {
123
124    } // __destruct()
125
126    /**
127     * show - generate html output
128     *
129     * this function can be called after the constructor has
130     * prepared everyhing. it will load the index.tpl smarty
131     * template. if necessary it will registere pre-selects
132     * (photo index, photo, tag search, date search) into
133     * users session.
134     */
135    public function show()
136    {
137       $this->tmpl->assign('searchfor', $_SESSION['searchfor']);
138       $this->tmpl->assign('page_title', $this->cfg->page_title);
139       $this->tmpl->assign('current_condition', $_SESSION['tag_condition']);
140       $this->tmpl->assign('template_path', 'themes/'. $this->cfg->theme_name);
141
142       if(isset($_GET['mode'])) {
143
144          $_SESSION['start_action'] = $_GET['mode'];
145
146          switch($_GET['mode']) {
147             case 'showpi':
148                if(isset($_GET['tags'])) {
149                   $_SESSION['selected_tags'] = $this->extractTags($_GET['tags']);
150                }
151                if(isset($_GET['from_date']) && $this->isValidDate($_GET['from_date'])) {
152                   $_SESSION['from_date'] = strtotime($_GET['from_date'] ." 00:00:00");
153                }
154                if(isset($_GET['to_date']) && $this->isValidDate($_GET['to_date'])) {
155                   $_SESSION['to_date'] = strtotime($_GET['to_date'] ." 23:59:59");
156                }
157                break;
158             case 'showp':
159                if(isset($_GET['tags'])) {
160                   $_SESSION['selected_tags'] = $this->extractTags($_GET['tags']);
161                   $_SESSION['start_action'] = 'showp';
162                }
163                if(isset($_GET['id']) && is_numeric($_GET['id'])) {
164                   $_SESSION['current_photo'] = $_GET['id'];
165                   $_SESSION['start_action'] = 'showp';
166                }
167                if(isset($_GET['from_date']) && $this->isValidDate($_GET['from_date'])) {
168                   $_SESSION['from_date'] = strtotime($_GET['from_date']);
169                }
170                if(isset($_GET['to_date']) && $this->isValidDate($_GET['to_date'])) {
171                   $_SESSION['to_date'] = strtotime($_GET['to_date']);
172                }
173                break;
174             case 'export':
175                $this->tmpl->show("export.tpl");
176                return;
177                break;
178             case 'slideshow':
179                $this->tmpl->show("slideshow.tpl");
180                return;
181                break;
182             case 'rss':
183                if(isset($_GET['tags'])) {
184                   $_SESSION['selected_tags'] = $this->extractTags($_GET['tags']);
185                }
186                if(isset($_GET['from_date']) && $this->isValidDate($_GET['from_date'])) {
187                   $_SESSION['from_date'] = strtotime($_GET['from_date'] ." 00:00:00");
188                }
189                if(isset($_GET['to_date']) && $this->isValidDate($_GET['to_date'])) {
190                   $_SESSION['to_date'] = strtotime($_GET['to_date'] ." 23:59:59");
191                }
192                $this->getRSSFeed();
193                return;
194                break;
195          }
196       }
197
198       if(isset($_SESSION['from_date']) && isset($_SESSION['to_date']))
199          $this->tmpl->assign('date_search_enabled', true);
200
201       $this->tmpl->register_function("sort_select_list", array(&$this, "smarty_sort_select_list"), false);
202       $this->tmpl->assign('from_date', $this->get_calendar('from'));
203       $this->tmpl->assign('to_date', $this->get_calendar('to'));
204       $this->tmpl->assign('content_page', 'welcome.tpl');
205       $this->tmpl->show("index.tpl");
206
207    } // show()
208
209    /**
210     * get_tags - grab all tags of f-spot's database
211     *
212     * this function will get all available tags from
213     * the f-spot database and store them within two
214     * arrays within this class for later usage. in
215     * fact, if the user requests (hide_tags) it will
216     * opt-out some of them.
217     *
218     * this function is getting called once by show()
219     */
220    private function get_tags()
221    {
222       $this->avail_tags = Array();
223       $count = 0;
224    
225       if(isset($this->cfg->show_tags) && !empty($this->cfg->show_tags)) {
226          $query_str="
227             SELECT
228                DISTINCT t1.id as id, t1.name as name
229             FROM  
230                photo_tags pt1
231             INNER JOIN photo_tags
232                pt2 ON pt1.photo_id=pt2.photo_id
233             INNER JOIN tags t1
234                ON t1.id=pt1.tag_id
235             INNER JOIN tags t2
236                ON t2.id=pt2.tag_id
237             WHERE
238                t2.name IN  ('".implode("','",$this->cfg->show_tags)."')
239             ORDER BY
240                t1.sort_priority ASC";
241
242          $result = $this->db->db_query($query_str);
243       }
244       else
245       {
246          $result = $this->db->db_query("
247             SELECT id,name
248             FROM tags
249             ORDER BY sort_priority ASC
250          ");
251       }
252       
253       while($row = $this->db->db_fetch_object($result)) {
254
255          $tag_id = $row['id'];
256          $tag_name = $row['name'];
257
258          /* if the user has specified to ignore this tag in phpfspot's
259             configuration, ignore it here so it does not get added to
260             the tag list.
261          */
262          if(in_array($row['name'], $this->cfg->hide_tags))
263             continue;
264
265          /* if you include the following if-clause and the user has specified
266             to only show certain tags which are specified in phpfspot's
267             configuration, ignore all others so they will not be added to the
268             tag list.
269          if(isset($this->cfg->show_tags) && !empty($this->cfg->show_tags) &&
270             !in_array($row['name'], $this->cfg->show_tags))
271             continue;
272          */
273
274          $this->tags[$tag_id] = $tag_name; 
275          $this->avail_tags[$count] = $tag_id;
276          $count++;
277
278       }
279
280    } // get_tags()
281
282    /** 
283     * extract all photo details
284     * 
285     * retrieve all available details from f-spot's
286     * database and return them as object
287     */
288    public function get_photo_details($idx)
289    {
290       if($this->dbver < 9) {
291          $query_str = "
292             SELECT p.id, p.name, p.time, p.directory_path, p.description
293             FROM photos p
294          ";
295       }
296       else {
297          $query_str = "
298             SELECT p.id, p.uri, p.time, p.description
299             FROM photos p
300          ";
301       }
302
303       /* if show_tags is set, only return details for photos which
304          are specified to be shown
305       */
306       if(isset($this->cfg->show_tags) && !empty($this->cfg->show_tags)) {
307          $query_str.= "
308             INNER JOIN photo_tags pt
309                ON p.id=pt.photo_id
310             INNER JOIN tags t
311                ON pt.tag_id=t.id
312             WHERE p.id='". $idx ."'
313             AND t.name IN ('".implode("','",$this->cfg->show_tags)."')";
314       }
315       else {
316          $query_str.= "
317             WHERE p.id='". $idx ."'
318          ";
319       }
320
321       if($result = $this->db->db_query($query_str)) {
322
323          $row = $this->db->db_fetch_object($result);
324
325          if($this->dbver < 9) {
326             $row['uri'] = "file://". $row['directory_path'] ."/". $row['name'];
327          }
328
329          return $row;
330
331       }
332    
333       return null;
334
335    } // get_photo_details
336
337    /**
338     * returns aligned photo names 
339     *
340     * this function returns aligned (length) names for
341     * an specific photo. If the length of the name exceeds
342     * $limit the name will be shrinked (...)
343     */
344    public function getPhotoName($idx, $limit = 0)
345    {
346       if($details = $this->get_photo_details($idx)) {
347          if($long_name = $this->parse_uri($details['uri'], 'filename')) {
348             $name = $this->shrink_text($long_name, $limit);
349             return $name;
350          }
351       }
352
353       return null;
354
355    } // getPhotoName()
356
357    /**
358     * shrink text according provided limit
359     *
360     * If the length of the name exceeds $limit the
361     * text will be shortend and some content in between
362     * will be replaced with "..." 
363     */
364    private function shrink_text($text, $limit)
365    {
366       if($limit != 0 && strlen($text) > $limit) {
367          $text = substr($text, 0, $limit-5) ."...". substr($text, -($limit-5));
368       }
369
370       return $text;
371
372    } // shrink_text();
373
374    /**
375     * translate f-spoth photo path
376     * 
377     * as the full-qualified path recorded in the f-spot database
378     * is usally not the same as on the webserver, this function
379     * will replace the path with that one specified in the cfg
380     */
381    public function translate_path($path, $width = 0)
382    {  
383       return str_replace($this->cfg->path_replace_from, $this->cfg->path_replace_to, $path);
384
385    } // translate_path
386
387    /**
388     * control HTML ouput for a single photo
389     *
390     * this function provides all the necessary information
391     * for the single photo template.
392     */
393    public function showPhoto($photo)
394    {
395       /* get all photos from the current photo selection */
396       $all_photos = $this->getPhotoSelection();
397       $count = count($all_photos);
398
399       for($i = 0; $i < $count; $i++) {
400          
401          // $get_next will be set, when the photo which has to
402          // be displayed has been found - this means that the
403          // next available is in fact the NEXT image (for the
404          // navigation icons) 
405          if(isset($get_next)) {
406             $next_img = $all_photos[$i];
407             break;
408          }
409
410          /* the next photo is our NEXT photo */
411          if($all_photos[$i] == $photo) {
412             $get_next = 1;
413          }
414          else {
415             $previous_img = $all_photos[$i];
416          }
417
418          if($photo == $all_photos[$i]) {
419                $current = $i;
420          }
421       }
422
423       $details = $this->get_photo_details($photo);
424
425       if(!$details) {
426          print "error";
427          return;
428       }
429
430       $orig_path = $this->translate_path($this->parse_uri($details['uri'], 'fullpath'));
431       $thumb_path = $this->get_thumb_path($this->cfg->photo_width, $photo);
432
433       if(!file_exists($orig_path)) {
434          $this->_error("Photo ". $orig_path ." does not exist!<br />\n");
435          return;
436       }
437
438       if(!is_readable($orig_path)) {
439          $this->_error("Photo ". $orig_path ." is not readable for user ". $this->getuid() ."<br />\n");
440          return;
441       }
442
443       /* If the thumbnail doesn't exist yet, try to create it */
444       if(!file_exists($thumb_path)) {
445          $this->gen_thumb($photo, true);
446          $thumb_path = $this->get_thumb_path($this->cfg->photo_width, $photo);
447       }
448
449       /* get f-spot database meta information */
450       $meta = $this->get_meta_informations($orig_path);
451
452       /* If EXIF data are available, use them */
453       if(isset($meta['ExifImageWidth'])) {
454          $meta_res = $meta['ExifImageWidth'] ."x". $meta['ExifImageLength'];
455       } else {
456          $info = getimagesize($orig_path);
457          $meta_res = $info[0] ."x". $info[1]; 
458       }
459
460       $meta_date = isset($meta['FileDateTime']) ? strftime("%a %x %X", $meta['FileDateTime']) : "n/a";
461       $meta_make = isset($meta['Make']) ? $meta['Make'] ." / ". $meta['Model'] : "n/a";
462       $meta_size = isset($meta['FileSize']) ? round($meta['FileSize']/1024, 1) ."kbyte" : "n/a";
463
464       $extern_link = "index.php?mode=showp&id=". $photo;
465       $current_tags = $this->getCurrentTags();
466       if($current_tags != "") {
467          $extern_link.= "&tags=". $current_tags;
468       }
469       if(isset($_SESSION['from_date']) && isset($_SESSION['to_date'])) {
470          $extern_link.= "&from_date=". $this->ts2str($_SESSION['from_date']) ."&to_date=". $this->ts2str($_SESSION['to_date']);
471       }
472
473       $this->tmpl->assign('extern_link', $extern_link);
474
475       if(file_exists($thumb_path)) {
476
477          $info = getimagesize($thumb_path);
478
479          $this->tmpl->assign('description', $details['description']);
480          $this->tmpl->assign('image_name', $this->parse_uri($details['uri'], 'filename'));
481
482          $this->tmpl->assign('width', $info[0]);
483          $this->tmpl->assign('height', $info[1]);
484          $this->tmpl->assign('ExifMadeOn', $meta_date);
485          $this->tmpl->assign('ExifMadeWith', $meta_make);
486          $this->tmpl->assign('ExifOrigResolution', $meta_res);
487          $this->tmpl->assign('ExifFileSize', $meta_size);
488     
489          $this->tmpl->assign('image_url', 'phpfspot_img.php?idx='. $photo ."&amp;width=". $this->cfg->photo_width);
490          $this->tmpl->assign('image_url_full', 'phpfspot_img.php?idx='. $photo);
491
492          $this->tmpl->assign('tags', $this->get_photo_tags($photo));
493          $this->tmpl->assign('current', $current);
494       }
495       else {
496          $this->_error("Can't open file ". $thumb_path ."\n");
497          return;
498       }
499
500       if($previous_img) {
501          $this->tmpl->assign('previous_url', "javascript:showImage(". $previous_img .");");
502          $this->tmpl->assign('prev_img', $previous_img);
503       }
504
505       if($next_img) {
506          $this->tmpl->assign('next_url', "javascript:showImage(". $next_img .");");
507          $this->tmpl->assign('next_img', $next_img);
508       }
509       $this->tmpl->assign('mini_width', $this->cfg->mini_width);
510       $this->tmpl->assign('photo_number', $i);
511       $this->tmpl->assign('photo_count', count($all_photos));
512
513       $this->tmpl->show("single_photo.tpl");
514
515    } // showPhoto()
516
517    /**
518     * all available tags and tag cloud
519     *
520     * this function outputs all available tags (time ordered)
521     * and in addition output them as tag cloud (tags which have
522     * many photos will appears more then others)
523     */
524    public function getAvailableTags()
525    {
526       /* retrive tags from database */
527       $this->get_tags();
528
529       $output = "";
530
531       $result = $this->db->db_query("
532          SELECT tag_id as id, count(tag_id) as quantity
533          FROM photo_tags
534          INNER JOIN tags t
535             ON t.id = tag_id
536          GROUP BY tag_id
537          ORDER BY t.name ASC
538       ");
539
540       $tags = Array();
541
542       while($row = $this->db->db_fetch_object($result)) {
543          $tags[$row['id']] = $row['quantity'];
544       }
545
546       // change these font sizes if you will
547       $max_size = 125; // max font size in %
548       $min_size = 75; // min font size in %
549
550       // get the largest and smallest array values
551       $max_qty = max(array_values($tags));
552       $min_qty = min(array_values($tags));
553
554       // find the range of values
555       $spread = $max_qty - $min_qty;
556       if (0 == $spread) { // we don't want to divide by zero
557          $spread = 1;
558       }
559
560       // determine the font-size increment
561       // this is the increase per tag quantity (times used)
562       $step = ($max_size - $min_size)/($spread);
563
564       // loop through our tag array
565       foreach ($tags as $key => $value) {
566
567          if(isset($_SESSION['selected_tags']) && in_array($key, $_SESSION['selected_tags']))
568             continue;
569
570          // calculate CSS font-size
571          // find the $value in excess of $min_qty
572          // multiply by the font-size increment ($size)
573          // and add the $min_size set above
574          $size = $min_size + (($value - $min_qty) * $step);
575           // uncomment if you want sizes in whole %:
576          $size = ceil($size);
577
578          if(isset($this->tags[$key])) {
579             $output.= "<a href=\"javascript:Tags('add', ". $key .");\" class=\"tag\" style=\"font-size: ". $size ."%;\">". $this->tags[$key] ."</a>, ";
580          }
581
582       }
583
584       $output = substr($output, 0, strlen($output)-2);
585       print $output;
586
587    } // getAvailableTags()
588
589    /**
590     * output all selected tags
591     *
592     * this function output all tags which have been selected
593     * by the user. the selected tags are stored in the 
594     * session-variable $_SESSION['selected_tags']
595     */
596    public function getSelectedTags()
597    {
598       /* retrive tags from database */
599       $this->get_tags();
600
601       $output = "";
602
603       foreach($this->avail_tags as $tag)
604       {
605          // return all selected tags
606          if(isset($_SESSION['selected_tags']) && in_array($tag, $_SESSION['selected_tags'])) {
607             $output.= "<a href=\"javascript:Tags('del', ". $tag .");\" class=\"tag\">". $this->tags[$tag] ."</a>, ";
608          }
609       }
610
611       if($output != "") {
612          $output = substr($output, 0, strlen($output)-2);
613          return $output;
614       }
615       else {
616          return "no tags selected";
617       }
618
619    } // getSelectedTags()
620
621    /**
622     * add tag to users session variable
623     *
624     * this function will add the specified to users current
625     * tag selection. if a date search has been made before
626     * it will be now cleared
627     */
628    public function addTag($tag)
629    {
630       if(!isset($_SESSION['selected_tags']))
631          $_SESSION['selected_tags'] = Array();
632
633       if(isset($_SESSION['searchfor']))
634          unset($_SESSION['searchfor']);
635
636       if(!in_array($tag, $_SESSION['selected_tags']))
637          array_push($_SESSION['selected_tags'], $tag);
638    
639    } // addTag()
640
641    /**
642     * remove tag to users session variable
643     *
644     * this function removes the specified tag from
645     * users current tag selection
646     */
647    public function delTag($tag)
648    {
649       if(isset($_SESSION['searchfor']))
650          unset($_SESSION['searchfor']);
651
652       if(isset($_SESSION['selected_tags'])) {
653          $key = array_search($tag, $_SESSION['selected_tags']);
654          unset($_SESSION['selected_tags'][$key]);
655          sort($_SESSION['selected_tags']);
656       }
657
658    } // delTag()
659
660    /**
661     * reset tag selection
662     *
663     * if there is any tag selection, it will be
664     * deleted now
665     */
666    public function resetTags()
667    {
668       if(isset($_SESSION['selected_tags']))
669          unset($_SESSION['selected_tags']);
670
671    } // resetTags()
672
673    /**
674     * reset single photo
675     *
676     * if a specific photo was requested (external link)
677     * unset the session variable now
678     */
679    public function resetPhotoView()
680    {
681       if(isset($_SESSION['current_photo']))
682          unset($_SESSION['current_photo']);
683
684    } // resetPhotoView();
685
686    /**
687     * reset tag search
688     *
689     * if any tag search has taken place, reset
690     * it now
691     */
692    public function resetTagSearch()
693    {
694       if(isset($_SESSION['searchfor']))
695          unset($_SESSION['searchfor']);
696
697    } // resetTagSearch()
698
699     /**
700     * reset date search
701     *
702     * if any date search has taken place, reset
703     * it now
704     */
705    public function resetDateSearch()
706    {
707       if(isset($_SESSION['from_date']))
708          unset($_SESSION['from_date']);
709       if(isset($_SESSION['to_date']))
710          unset($_SESSION['to_date']);
711
712    } // resetDateSearch();
713
714    /**
715     * return all photo according selection
716     *
717     * this function returns all photos based on
718     * the tag-selection, tag- or date-search.
719     * the tag-search also has to take care of AND
720     * and OR conjunctions
721     */
722    public function getPhotoSelection()
723    {  
724       $matched_photos = Array();
725
726       if(isset($_SESSION['from_date']) && isset($_SESSION['to_date'])) {
727          $from_date = $_SESSION['from_date'];
728          $to_date = $_SESSION['to_date'];
729          $additional_where_cond = "
730                p.time>='". $from_date ."'
731             AND
732                p.time<='". $to_date ."'
733          ";
734       } 
735
736       if(isset($_SESSION['sort_order'])) {
737          $order_str = $this->get_sort_order();
738       }
739
740       /* return a search result */
741       if(isset($_SESSION['searchfor']) && $_SESSION['searchfor'] != '') {
742          $query_str = "
743             SELECT DISTINCT pt1.photo_id
744                FROM photo_tags pt1
745             INNER JOIN photo_tags pt2
746                ON pt1.photo_id=pt2.photo_id
747             INNER JOIN tags t1
748                ON pt1.tag_id=t1.id
749             INNER JOIN photos p
750                ON pt1.photo_id=p.id
751             INNER JOIN tags t2
752                ON pt2.tag_id=t2.id
753             WHERE t1.name LIKE '%". $_SESSION['searchfor'] ."%' ";
754
755          if(isset($additional_where_cond))
756             $query_str.= "AND ". $additional_where_cond ." ";
757
758          if(isset($this->cfg->show_tags) && !empty($this->cfg->show_tags)) {
759             $query_str.= "AND t2.name IN ('".implode("','",$this->cfg->show_tags)."')";
760          }
761          
762          if(isset($order_str))
763             $query_str.= $order_str;
764
765          $result = $this->db->db_query($query_str);
766          while($row = $this->db->db_fetch_object($result)) {
767             array_push($matched_photos, $row['photo_id']);
768          }
769          return $matched_photos;
770       }
771
772       /* return according the selected tags */
773       if(isset($_SESSION['selected_tags']) && !empty($_SESSION['selected_tags'])) {
774          $selected = "";
775          foreach($_SESSION['selected_tags'] as $tag)
776             $selected.= $tag .",";
777          $selected = substr($selected, 0, strlen($selected)-1);
778
779          /* photo has to match at least on of the selected tags */
780          if($_SESSION['tag_condition'] == 'or') {
781             $query_str = "
782                SELECT DISTINCT pt1.photo_id
783                   FROM photo_tags pt1
784                INNER JOIN photo_tags pt2
785                   ON pt1.photo_id=pt2.photo_id
786                INNER JOIN tags t
787                   ON pt2.tag_id=t.id
788                INNER JOIN photos p
789                   ON pt1.photo_id=p.id
790                WHERE pt1.tag_id IN (". $selected .")
791             ";
792             if(isset($additional_where_cond)) 
793                $query_str.= "AND ". $additional_where_cond ." ";
794
795             if(isset($this->cfg->show_tags) && !empty($this->cfg->show_tags)) {
796                $query_str.= "AND t.name IN ('".implode("','",$this->cfg->show_tags)."')";
797             }
798
799             if(isset($order_str))
800                $query_str.= $order_str;
801          }
802          /* photo has to match all selected tags */
803          elseif($_SESSION['tag_condition'] == 'and') {
804
805             if(count($_SESSION['selected_tags']) >= 32) {
806                print "A SQLite limit of 32 tables within a JOIN SELECT avoids to<br />\n";
807                print "evaluate your tag selection. Please remove some tags from your selection.\n";
808                return Array();
809             } 
810
811             /* Join together a table looking like
812
813                pt1.photo_id pt1.tag_id pt2.photo_id pt2.tag_id ...
814
815                so the query can quickly return all images matching the
816                selected tags in an AND condition
817
818             */
819
820             $query_str = "
821                SELECT DISTINCT pt1.photo_id
822                   FROM photo_tags pt1
823             ";
824
825             if(isset($this->cfg->show_tags) && !empty($this->cfg->show_tags)) {
826                $query_str.= "
827                   INNER JOIN tags t
828                      ON pt1.tag_id=t.id
829                ";
830             }
831
832             for($i = 0; $i < count($_SESSION['selected_tags']); $i++) {
833                $query_str.= "
834                   INNER JOIN photo_tags pt". ($i+2) ."
835                      ON pt1.photo_id=pt". ($i+2) .".photo_id
836                ";
837             }
838             $query_str.= "
839                INNER JOIN photos p
840                   ON pt1.photo_id=p.id
841             ";
842             $query_str.= "WHERE pt2.tag_id=". $_SESSION['selected_tags'][0]." ";
843             for($i = 1; $i < count($_SESSION['selected_tags']); $i++) {
844                $query_str.= "
845                   AND pt". ($i+2) .".tag_id=". $_SESSION['selected_tags'][$i] ."
846                "; 
847             }
848             if(isset($additional_where_cond)) 
849                $query_str.= "AND ". $additional_where_cond;
850
851             if(isset($this->cfg->show_tags) && !empty($this->cfg->show_tags)) {
852                $query_str.= "AND t.name IN ('".implode("','",$this->cfg->show_tags). "')";
853             }
854
855             if(isset($order_str))
856                $query_str.= $order_str;
857
858          }
859
860          $result = $this->db->db_query($query_str);
861          while($row = $this->db->db_fetch_object($result)) {
862             array_push($matched_photos, $row['photo_id']);
863          }
864          return $matched_photos;
865       }
866
867       /* return all available photos */
868       $query_str = "
869          SELECT p.id
870          FROM photos p
871          LEFT JOIN photo_tags pt
872             ON p.id=pt.photo_id
873          LEFT JOIN tags t
874             ON pt.tag_id=t.id
875       ";
876
877       if(isset($additional_where_cond)) 
878          $query_str.= "WHERE ". $additional_where_cond ." ";
879
880       if(isset($this->cfg->show_tags) && !empty($this->cfg->show_tags)) {
881          $query_str.= "AND t.name IN ('".implode("','",$this->cfg->show_tags). "')";
882       }
883  
884       if(isset($order_str))
885          $query_str.= $order_str;
886
887       $result = $this->db->db_query($query_str);
888       while($row = $this->db->db_fetch_object($result)) {
889          array_push($matched_photos, $row['id']);
890       }
891       return $matched_photos;
892
893    } // getPhotoSelection()
894
895     /**
896     * control HTML ouput for photo index
897     *
898     * this function provides all the necessary information
899     * for the photo index template.
900     */
901    public function showPhotoIndex()
902    {
903       $photos = $this->getPhotoSelection();
904
905       $count = count($photos);
906
907       if(isset($_SESSION['begin_with']) && $_SESSION['begin_with'] != "")
908          $anchor = $_SESSION['begin_with'];
909
910       if(!isset($this->cfg->rows_per_page) || $this->cfg->rows_per_page == 0) {
911
912          $begin_with = 0;
913          $end_with = $count;
914
915       }
916       elseif($this->cfg->rows_per_page > 0) {
917
918          if(!isset($_SESSION['begin_with']) || $_SESSION['begin_with'] == 0) {
919             $begin_with = 0;
920          }
921          else {
922
923             $begin_with = $_SESSION['begin_with'];
924
925             // verify $begin_with - perhaps the thumbs-per-rows or
926             // rows-per-page variables have changed or the jump back
927             // from a photo wasn't exact - so calculate the real new
928             // starting point
929             $multiplicator = $this->cfg->rows_per_page * $this->cfg->thumbs_per_row;
930             for($i = 0; $i <= $count; $i+=$multiplicator) {
931                if($begin_with >= $i && $begin_with < $i+$multiplicator) {
932                   $begin_with = $i;
933                   break;
934                }
935             }
936          }
937
938          $end_with = $begin_with + ($this->cfg->rows_per_page * $this->cfg->thumbs_per_row);
939       }
940
941    
942       $rows = 0;
943       $cols = 0;
944       $images[$rows] = Array();
945       $img_height[$rows] = Array();
946       $img_width[$rows] = Array();
947       $img_id[$rows] = Array();
948       $img_name[$rows] = Array();
949       $img_title = Array();
950
951       for($i = $begin_with; $i < $end_with; $i++) {
952
953          if(isset($photos[$i])) {
954
955             $images[$rows][$cols] = $photos[$i];
956             $img_id[$rows][$cols] = $i;
957             $img_name[$rows][$cols] = htmlspecialchars($this->getPhotoName($photos[$i], 15));
958             $img_title[$rows][$cols] = "Click to view photo ". htmlspecialchars($this->getPhotoName($photos[$i], 0));
959
960             $thumb_path = $this->get_thumb_path($this->cfg->thumb_width, $photos[$i]);
961
962             if(file_exists($thumb_path)) {
963                $info = getimagesize($thumb_path); 
964                $img_width[$rows][$cols] = $info[0];
965                $img_height[$rows][$cols] = $info[1];
966             }
967
968             if($cols == $this->cfg->thumbs_per_row-1) {
969                $cols = 0;
970                $rows++;
971                $images[$rows] = Array();
972                $img_width[$rows] = Array();
973                $img_height[$rows] = Array();
974             }
975             else {
976                $cols++;
977             }
978          } 
979       }
980
981       // +1 for for smarty's selection iteration
982       $rows++;
983
984       if(isset($_SESSION['searchfor']) && $_SESSION['searchfor'] != '')
985          $this->tmpl->assign('searchfor', $_SESSION['searchfor']);
986
987       if(isset($_SESSION['from_date']) && isset($_SESSION['to_date'])) {
988          $this->tmpl->assign('from_date', $this->ts2str($_SESSION['from_date']));
989          $this->tmpl->assign('to_date', $this->ts2str($_SESSION['to_date']));
990       }
991
992       if(isset($_SESSION['selected_tags']) && !empty($_SESSION['selected_tags'])) {
993          $this->tmpl->assign('tag_result', 1);
994       }
995
996       /* do we have to display the page selector ? */
997       if($this->cfg->rows_per_page != 0) {
998
999          $page_select = "";
1000       
1001          /* calculate the page switchers */
1002          $previous_start = $begin_with - ($this->cfg->rows_per_page * $this->cfg->thumbs_per_row);
1003          $next_start = $begin_with + ($this->cfg->rows_per_page * $this->cfg->thumbs_per_row);
1004
1005          if($begin_with != 0) 
1006             $this->tmpl->assign("previous_url", "javascript:showPhotoIndex(". $previous_start .");"); 
1007          if($end_with < $count)
1008             $this->tmpl->assign("next_url", "javascript:showPhotoIndex(". $next_start .");"); 
1009
1010          $photo_per_page  = $this->cfg->rows_per_page * $this->cfg->thumbs_per_row;
1011          $last_page = ceil($count / $photo_per_page);
1012
1013          /* get the current selected page */
1014          if($begin_with == 0) {
1015             $current_page = 1;
1016          } else {
1017             $current_page = 0;
1018             for($i = $begin_with; $i >= 0; $i-=$photo_per_page) {
1019                $current_page++;
1020             }
1021          } 
1022
1023          $dotdot_made = 0;
1024
1025          for($i = 1; $i <= $last_page; $i++) {
1026
1027             if($current_page == $i)
1028                $style = "style=\"font-size: 125%; text-decoration: underline;\"";
1029             elseif($current_page-1 == $i || $current_page+1 == $i)
1030                $style = "style=\"font-size: 105%;\"";
1031             elseif(($current_page-5 >= $i) && ($i != 1) ||
1032                ($current_page+5 <= $i) && ($i != $last_page))
1033                $style = "style=\"font-size: 75%;\"";
1034             else
1035                $style = "";
1036
1037             $select = "<a href=\"javascript:showPhotoIndex(". (($i*$photo_per_page)-$photo_per_page) .");\"";
1038                if($style != "")
1039                   $select.= $style;
1040             $select.= ">". $i ."</a>&nbsp;";
1041
1042             // until 9 pages we show the selector from 1-9
1043             if($last_page <= 9) {
1044                $page_select.= $select;
1045                continue;
1046             } else {
1047                if($i == 1 /* first page */ || 
1048                   $i == $last_page /* last page */ ||
1049                   $i == $current_page /* current page */ ||
1050                   $i == ceil($last_page * 0.25) /* first quater */ ||
1051                   $i == ceil($last_page * 0.5) /* half */ ||
1052                   $i == ceil($last_page * 0.75) /* third quater */ ||
1053                   (in_array($i, array(1,2,3,4,5,6)) && $current_page <= 4) /* the first 6 */ ||
1054                   (in_array($i, array($last_page, $last_page-1, $last_page-2, $last_page-3, $last_page-4, $last_page-5)) && $current_page >= $last_page-4) /* the last 6 */ ||
1055                   $i == $current_page-3 || $i == $current_page-2 || $i == $current_page-1 /* three before */ ||
1056                   $i == $current_page+3 || $i == $current_page+2 || $i == $current_page+1 /* three after */) {
1057
1058                   $page_select.= $select;
1059                   $dotdot_made = 0;
1060                   continue;
1061
1062                }
1063             }
1064
1065             if(!$dotdot_made) {
1066                $page_select.= ".........&nbsp;";
1067                $dotdot_made = 1;
1068             }
1069          }
1070
1071          /* only show the page selector if we have more then one page */
1072          if($last_page > 1)
1073             $this->tmpl->assign('page_selector', $page_select);
1074       }
1075
1076       
1077       $current_tags = $this->getCurrentTags();
1078       $extern_link = "index.php?mode=showpi";
1079       $rss_link = "index.php?mode=rss";
1080       if($current_tags != "") {
1081          $extern_link.= "&tags=". $current_tags;
1082          $rss_link.= "&tags=". $current_tags;
1083       }
1084       if(isset($_SESSION['from_date']) && isset($_SESSION['to_date'])) {
1085          $extern_link.= "&from_date=". $this->ts2str($_SESSION['from_date']) ."&to_date=". $this->ts2str($_SESSION['to_date']);
1086          $rss_link.= "&from_date=". $this->ts2str($_SESSION['from_date']) ."&to_date=". $this->ts2str($_SESSION['to_date']);
1087       }
1088
1089       $export_link = "index.php?mode=export";
1090       $slideshow_link = "index.php?mode=slideshow";
1091
1092       $this->tmpl->assign('extern_link', $extern_link);
1093       $this->tmpl->assign('slideshow_link', $slideshow_link);
1094       $this->tmpl->assign('export_link', $export_link);
1095       $this->tmpl->assign('rss_link', $rss_link);
1096       $this->tmpl->assign('count', $count);
1097       $this->tmpl->assign('width', $this->cfg->thumb_width);
1098       $this->tmpl->assign('thumb_container_width', $this->cfg->thumb_width+20);
1099       $this->tmpl->assign('thumb_container_height', $this->cfg->thumb_height);
1100       $this->tmpl->assign('images', $images);
1101       $this->tmpl->assign('img_width', $img_width);
1102       $this->tmpl->assign('img_height', $img_height);
1103       $this->tmpl->assign('img_id', $img_id);
1104       $this->tmpl->assign('img_name', $img_name);
1105       $this->tmpl->assign('img_title', $img_title);
1106       $this->tmpl->assign('rows', $rows);
1107       $this->tmpl->assign('columns', $this->cfg->thumbs_per_row);
1108
1109       $this->tmpl->show("photo_index.tpl");
1110
1111       if(isset($anchor))
1112          print "<script language=\"JavaScript\">self.location.hash = '#image". $anchor ."';</script>\n";
1113
1114    } // showPhotoIndex()
1115
1116    /**
1117     * show credit template
1118     */
1119    public function showCredits()
1120    {
1121       $this->tmpl->assign('version', $this->cfg->version);
1122       $this->tmpl->assign('product', $this->cfg->product);
1123       $this->tmpl->assign('db_version', $this->dbver);
1124       $this->tmpl->show("credits.tpl");
1125
1126    } // showCredits()
1127
1128    /**
1129     * create_thumbnails for the requested width
1130     *
1131     * this function creates image thumbnails of $orig_image
1132     * stored as $thumb_image. It will check if the image is
1133     * in a supported format, if necessary rotate the image
1134     * (based on EXIF orientation meta headers) and re-sizing.
1135     */
1136    public function create_thumbnail($orig_image, $thumb_image, $width)
1137    {  
1138       if(!file_exists($orig_image)) {
1139          return false;
1140       }
1141
1142       $details = getimagesize($orig_image);
1143       
1144       /* check if original photo is a support image type */
1145       if(!$this->checkifImageSupported($details['mime']))
1146          return false;
1147
1148       $meta = $this->get_meta_informations($orig_image);
1149
1150       $rotate = 0;
1151       $flip = false;
1152
1153       switch($meta['Orientation']) {
1154
1155          case 1: /* top, left */
1156             $rotate = 0; $flip = false; break;
1157          case 2: /* top, right */
1158             $rotate = 0; $flip = true; break;
1159          case 3: /* bottom, left */
1160             $rotate = 180; $flip = false; break;
1161          case 4: /* bottom, right */
1162             $rotate = 180; $flip = true; break;
1163          case 5: /* left side, top */
1164             $rotate = 90; $flip = true; break;
1165          case 6: /* right side, top */
1166             $rotate = 90; $flip = false; break;
1167          case 7: /* left side, bottom */
1168             $rotate = 270; $flip = true; break;
1169          case 8: /* right side, bottom */
1170             $rotate = 270; $flip = false; break;
1171       }
1172
1173       $src_img = @imagecreatefromjpeg($orig_image);
1174
1175       if(!$src_img) {
1176          print "Can't load image from ". $orig_image ."\n";
1177          return false;
1178       }
1179
1180       /* grabs the height and width */
1181       $cur_width = imagesx($src_img);
1182       $cur_height = imagesy($src_img);
1183
1184       // If requested width is more then the actual image width,
1185       // do not generate a thumbnail, instead safe the original
1186       // as thumbnail but with lower quality. But if the image
1187       // is to heigh too, then we still have to resize it.
1188       if($width >= $cur_width && $cur_height < $this->cfg->thumb_height) {
1189          $result = imagejpeg($src_img, $thumb_image, 75);
1190          imagedestroy($src_img);
1191          return true;
1192       }
1193
1194       // If the image will be rotate because EXIF orientation said so
1195       // 'virtually rotate' the image for further calculations
1196       if($rotate == 90 || $rotate == 270) {
1197          $tmp = $cur_width;
1198          $cur_width = $cur_height;
1199          $cur_height = $tmp;
1200       }
1201
1202       /* calculates aspect ratio */
1203       $aspect_ratio = $cur_height / $cur_width;
1204
1205       /* sets new size */
1206       if($aspect_ratio < 1) {
1207          $new_w = $width;
1208          $new_h = abs($new_w * $aspect_ratio);
1209       } else {
1210          /* 'virtually' rotate the image and calculate it's ratio */
1211          $tmp_w = $cur_height;
1212          $tmp_h = $cur_width;
1213          /* now get the ratio from the 'rotated' image */
1214          $tmp_ratio = $tmp_h/$tmp_w;
1215          /* now calculate the new dimensions */
1216          $tmp_w = $width;
1217          $tmp_h = abs($tmp_w * $tmp_ratio);
1218
1219          // now that we know, how high they photo should be, if it
1220          // gets rotated, use this high to scale the image
1221          $new_h = $tmp_h;
1222          $new_w = abs($new_h / $aspect_ratio);
1223
1224          // If the image will be rotate because EXIF orientation said so
1225          // now 'virtually rotate' back the image for the image manipulation
1226          if($rotate == 90 || $rotate == 270) {
1227             $tmp = $new_w;
1228             $new_w = $new_h;
1229             $new_h = $tmp;
1230          }
1231       }
1232
1233       /* creates new image of that size */
1234       $dst_img = imagecreatetruecolor($new_w, $new_h);
1235
1236       imagefill($dst_img, 0, 0, ImageColorAllocate($dst_img, 255, 255, 255));
1237
1238       /* copies resized portion of original image into new image */
1239       imagecopyresampled($dst_img, $src_img, 0, 0, 0, 0, $new_w, $new_h, imagesx($src_img), imagesy($src_img));
1240
1241       /* needs the image to be flipped horizontal? */
1242       if($flip) {
1243          print "(FLIP)";
1244          $image = $dst_img;
1245          for($x = 0; $x < $new_w; $x++) {
1246             imagecopy($dst_img, $image, $x, 0, $w - $x - 1, 0, 1, $h);
1247          }
1248       }
1249
1250       if($rotate) {
1251          $this->_debug("(ROTATE)");
1252          $dst_img = $this->rotateImage($dst_img, $rotate);
1253       }
1254
1255       /* write down new generated file */
1256       $result = imagejpeg($dst_img, $thumb_image, 75);
1257
1258       /* free your mind */
1259       imagedestroy($dst_img);
1260       imagedestroy($src_img);
1261
1262       if($result === false) {
1263          print "Can't write thumbnail ". $thumb_image ."\n";
1264          return false;
1265       }
1266
1267       return true;
1268
1269    } // create_thumbnail()
1270
1271    /**
1272     * return all exif meta data from the file
1273     */
1274    public function get_meta_informations($file)
1275    {
1276       return exif_read_data($file);
1277
1278    } // get_meta_informations()
1279
1280    /**
1281     * create phpfspot own sqlite database
1282     *
1283     * this function creates phpfspots own sqlite database
1284     * if it does not exist yet. this own is used to store
1285     * some necessary informations (md5 sum's, ...).
1286     */
1287    public function check_config_table()
1288    {
1289       // if the config table doesn't exist yet, create it
1290       if(!$this->cfg_db->db_check_table_exists("images")) {
1291          $this->cfg_db->db_exec("
1292             CREATE TABLE images (
1293                img_idx int primary key,
1294                img_md5 varchar(32)
1295             )
1296             ");
1297       }
1298
1299    } // check_config_table
1300
1301    /**
1302     * Generates a thumbnail from photo idx
1303     *
1304     * This function will generate JPEG thumbnails from provided F-Spot photo
1305     * indizes.
1306     *
1307     * 1. Check if all thumbnail generations (width) are already in place and
1308     *    readable
1309     * 2. Check if the md5sum of the original file has changed
1310     * 3. Generate the thumbnails if needed
1311     */
1312    public function gen_thumb($idx = 0, $force = 0, $overwrite = false)
1313    {
1314       $error = 0;
1315
1316       $resolutions = Array(
1317          $this->cfg->thumb_width,
1318          $this->cfg->photo_width,
1319          $this->cfg->mini_width,
1320       );
1321
1322       /* get details from F-Spot's database */
1323       $details = $this->get_photo_details($idx);
1324
1325       /* calculate file MD5 sum */
1326       $full_path = $this->translate_path($this->parse_uri($details['uri'], 'fullpath'));
1327
1328       if(!file_exists($full_path)) {
1329          $this->_error("File ". $full_path ." does not exist\n");
1330          return;
1331       }
1332
1333       if(!is_readable($full_path)) {
1334          $this->_error("File ". $full_path ." is not readable for ". $this->getuid() ."\n");
1335          return;
1336       }
1337
1338       $file_md5 = md5_file($full_path);
1339
1340       $this->_debug("Image [". $idx ."] ". $this->shrink_text($this->parse_uri($details['uri'], 'filename'), 20) ." Thumbnails:");
1341
1342       $changes = false;
1343
1344       foreach($resolutions as $resolution) {
1345    
1346          $generate_it = false;
1347
1348          $thumb_sub_path = substr($file_md5, 0, 2);
1349          $thumb_path = $this->cfg->thumb_path ."/". $thumb_sub_path ."/". $resolution ."_". $file_md5;
1350
1351          if(!file_exists(dirname($thumb_path))) {
1352             mkdir(dirname($thumb_path), 0755);
1353          }
1354
1355          /* if the thumbnail file doesn't exist, create it */
1356          if(!file_exists($thumb_path)) {
1357             $generate_it = true;
1358          }
1359          /* if the file hasn't changed there is no need to regen the thumb */
1360          elseif($file_md5 != $this->getMD5($idx) || $force) {
1361             $generate_it = true;
1362          }
1363
1364          if($generate_it || $overwrite) {
1365
1366             $this->_debug(" ". $resolution ."px");
1367             if(!$this->create_thumbnail($full_path, $thumb_path, $resolution))
1368                $error = 1;
1369
1370             $changes = true;
1371          }
1372       }
1373
1374       if(!$changes) {
1375          $this->_debug(" already exist");
1376       }
1377
1378       /* set the new/changed MD5 sum for the current photo */
1379       if(!$error) {
1380          $this->setMD5($idx, $file_md5);
1381       }
1382
1383       $this->_debug("\n");
1384
1385    } // gen_thumb()
1386
1387    /**
1388     * returns stored md5 sum for a specific photo
1389     *
1390     * this function queries the phpfspot database for a
1391     * stored MD5 checksum of the specified photo
1392     */
1393    public function getMD5($idx)
1394    {
1395       $result = $this->cfg_db->db_query("
1396          SELECT img_md5 
1397          FROM images
1398          WHERE img_idx='". $idx ."'
1399       ");
1400
1401       if(!$result)
1402          return 0;
1403
1404       $img = $this->cfg_db->db_fetch_object($result);
1405       return $img['img_md5'];
1406       
1407    } // getMD5()
1408
1409    /**
1410     * set MD5 sum for the specific photo
1411     */
1412    private function setMD5($idx, $md5)
1413    {
1414       $result = $this->cfg_db->db_exec("
1415          REPLACE INTO images (img_idx, img_md5)
1416          VALUES ('". $idx ."', '". $md5 ."')
1417       ");
1418
1419    } // setMD5()
1420
1421    /**
1422     * store current tag condition
1423     *
1424     * this function stores the current tag condition
1425     * (AND or OR) in the users session variables
1426     */
1427    public function setTagCondition($mode)
1428    {
1429       $_SESSION['tag_condition'] = $mode;
1430
1431    } // setTagCondition()
1432
1433    /** 
1434     * invoke tag & date search 
1435     *
1436     * this function will return all matching tags and store
1437     * them in the session variable selected_tags. furthermore
1438     * it also handles the date search.
1439     * getPhotoSelection() will then only return the matching
1440     * photos.
1441     */
1442    public function startSearch($searchfor, $from = 0, $to = 0)
1443    {
1444       $this->get_tags();
1445
1446       $_SESSION['searchfor'] = $searchfor;
1447
1448       if($from != 0)
1449          $_SESSION['from_date'] = strtotime($from ." 00:00:00");
1450       else
1451          unset($_SESSION['from_date']);
1452
1453       if($to != 0)
1454          $_SESSION['to_date'] = strtotime($to ." 23:59:59");
1455       else
1456          unset($_SESSION['to_date']);
1457
1458       if($searchfor != "") {
1459          /* new search, reset the current selected tags */
1460          $_SESSION['selected_tags'] = Array();
1461          foreach($this->avail_tags as $tag) {
1462             if(preg_match('/'. $searchfor .'/i', $this->tags[$tag]))
1463                array_push($_SESSION['selected_tags'], $tag);
1464          }
1465       }
1466
1467    } // startSearch()
1468
1469    /**
1470     * updates sort order in session variable
1471     *
1472     * this function is invoked by RPC and will sort the requested
1473     * sort order in the session variable.
1474     */
1475    public function updateSortOrder($order)
1476    {
1477       if(isset($this->sort_orders[$order])) {
1478          $_SESSION['sort_order'] = $order;
1479          return "ok";
1480       }
1481
1482       return "unkown error";
1483
1484    } // updateSortOrder()
1485
1486    /**
1487     * rotate image
1488     *
1489     * this function rotates the image according the
1490     * specified angel.
1491     */
1492    private function rotateImage($img, $degrees)
1493    {
1494       if(function_exists("imagerotate")) {
1495          $img = imagerotate($img, $degrees, 0);
1496       } else {
1497          function imagerotate($src_img, $angle)
1498          {
1499             $src_x = imagesx($src_img);
1500             $src_y = imagesy($src_img);
1501             if ($angle == 180) {
1502                $dest_x = $src_x;
1503                $dest_y = $src_y;
1504             }
1505             elseif ($src_x <= $src_y) {
1506                $dest_x = $src_y;
1507                $dest_y = $src_x;
1508             }
1509             elseif ($src_x >= $src_y) {
1510                $dest_x = $src_y;
1511                $dest_y = $src_x;
1512             }
1513                
1514             $rotate=imagecreatetruecolor($dest_x,$dest_y);
1515             imagealphablending($rotate, false);
1516                
1517             switch ($angle) {
1518             
1519                case 90:
1520                   for ($y = 0; $y < ($src_y); $y++) {
1521                      for ($x = 0; $x < ($src_x); $x++) {
1522                         $color = imagecolorat($src_img, $x, $y);
1523                         imagesetpixel($rotate, $dest_x - $y - 1, $x, $color);
1524                      }
1525                   }
1526                   break;
1527
1528                case 270:
1529                   for ($y = 0; $y < ($src_y); $y++) {
1530                      for ($x = 0; $x < ($src_x); $x++) {
1531                         $color = imagecolorat($src_img, $x, $y);
1532                         imagesetpixel($rotate, $y, $dest_y - $x - 1, $color);
1533                      }
1534                   }
1535                   break;
1536
1537                case 180:
1538                   for ($y = 0; $y < ($src_y); $y++) {
1539                      for ($x = 0; $x < ($src_x); $x++) {
1540                         $color = imagecolorat($src_img, $x, $y);
1541                         imagesetpixel($rotate, $dest_x - $x - 1, $dest_y - $y - 1, $color);
1542                      }
1543                   }
1544                   break;
1545
1546                default:
1547                   $rotate = $src_img;
1548                   break;
1549             };
1550
1551             return $rotate;
1552
1553          }
1554
1555          $img = imagerotate($img, $degrees);
1556
1557       }
1558
1559       return $img;
1560
1561    } // rotateImage()
1562
1563    /**
1564     * return all assigned tags for the specified photo
1565     */
1566    private function get_photo_tags($idx)
1567    {
1568       $result = $this->db->db_query("
1569          SELECT t.id, t.name
1570          FROM tags t
1571          INNER JOIN photo_tags pt
1572             ON t.id=pt.tag_id
1573          WHERE pt.photo_id='". $idx ."'
1574       ");
1575
1576       $tags = Array();
1577
1578       while($row = $this->db->db_fetch_object($result))
1579          $tags[$row['id']] = $row['name'];
1580
1581       return $tags;
1582
1583    } // get_photo_tags()
1584
1585    /**
1586     * create on-the-fly images with text within
1587     */
1588    public function showTextImage($txt, $color=000000, $space=4, $font=4, $w=300)
1589    {
1590       if (strlen($color) != 6) 
1591          $color = 000000;
1592
1593       $int = hexdec($color);
1594       $h = imagefontheight($font);
1595       $fw = imagefontwidth($font);
1596       $txt = explode("\n", wordwrap($txt, ($w / $fw), "\n"));
1597       $lines = count($txt);
1598       $im = imagecreate($w, (($h * $lines) + ($lines * $space)));
1599       $bg = imagecolorallocate($im, 255, 255, 255);
1600       $color = imagecolorallocate($im, 0xFF & ($int >> 0x10), 0xFF & ($int >> 0x8), 0xFF & $int);
1601       $y = 0;
1602
1603       foreach ($txt as $text) {
1604          $x = (($w - ($fw * strlen($text))) / 2);
1605          imagestring($im, $font, $x, $y, $text, $color);
1606          $y += ($h + $space);
1607       }
1608
1609       Header("Content-type: image/png");
1610       ImagePng($im);
1611
1612    } // showTextImage()
1613
1614    /**
1615     * check if all requirements are met
1616     */
1617    private function checkRequirements()
1618    {
1619       if(!function_exists("imagecreatefromjpeg")) {
1620          print "PHP GD library extension is missing<br />\n";
1621          $missing = true;
1622       }
1623
1624       if($this->cfg->db_access == "native" && !function_exists("sqlite3_open")) {
1625          print "PHP SQLite3 library extension is missing<br />\n";
1626          $missing = true;
1627       }
1628
1629       /* Check for HTML_AJAX PEAR package, lent from Horde project */
1630       ini_set('track_errors', 1);
1631       @include_once 'HTML/AJAX/Server.php';
1632       if(isset($php_errormsg) && preg_match('/Failed opening.*for inclusion/i', $php_errormsg)) {
1633          print "PEAR HTML_AJAX package is missing<br />\n";
1634          $missing = true;
1635       }
1636       @include_once 'Calendar/Calendar.php';
1637       if(isset($php_errormsg) && preg_match('/Failed opening.*for inclusion/i', $php_errormsg)) {
1638          print "PEAR Calendar package is missing<br />\n";
1639          $missing = true;
1640       }
1641       @include_once 'Console/Getopt.php';
1642       if(isset($php_errormsg) && preg_match('/Failed opening.*for inclusion/i', $php_errormsg)) {
1643          print "PEAR Console_Getopt package is missing<br />\n";
1644          $missing = true;
1645       }
1646       ini_restore('track_errors');
1647
1648       if(isset($missing))
1649          return false;
1650
1651       return true;
1652
1653    } // checkRequirements()
1654
1655    private function _debug($text)
1656    {
1657       if($this->fromcmd) {
1658          print $text;
1659       }
1660
1661    } // _debug()
1662
1663    /**
1664     * check if specified MIME type is supported
1665     */
1666    public function checkifImageSupported($mime)
1667    {
1668       if(in_array($mime, Array("image/jpeg")))
1669          return true;
1670
1671       return false;
1672
1673    } // checkifImageSupported()
1674
1675    public function _error($text)
1676    {
1677       switch($this->cfg->logging) {
1678          case 'display':
1679             print "<img src=\"resources/green_info.png\" alt=\"warning\" />\n";
1680             print $text;
1681             break;
1682          case 'errorlog':  
1683             error_log($text);
1684             break;
1685          case 'logfile':
1686             error_log($text, 3, $his->cfg->log_file);
1687             break;
1688       }
1689
1690    } // _error()
1691
1692    /**
1693     * output calendard input fields
1694     */
1695    private function get_calendar($mode)
1696    {
1697       $year = isset($_SESSION[$mode .'_date']) ? date("Y", $_SESSION[$mode .'_date']) : date("Y");
1698       $month = isset($_SESSION[$mode .'_date']) ? date("m", $_SESSION[$mode .'_date']) : date("m");
1699       $day = isset($_SESSION[$mode .'_date']) ? date("d", $_SESSION[$mode .'_date']) : date("d");
1700
1701       $output = "<input type=\"text\" size=\"3\" id=\"". $mode ."year\" value=\"". $year ."\"";
1702       if(!isset($_SESSION[$mode .'_date']))
1703          $output.= " disabled=\"disabled\"";
1704       $output.= " />\n";
1705       $output.= "<input type=\"text\" size=\"1\" id=\"". $mode ."month\" value=\"". $month ."\"";
1706       if(!isset($_SESSION[$mode .'_date']))
1707          $output.= " disabled=\"disabled\"";
1708       $output.= " />\n";
1709       $output.= "<input type=\"text\" size=\"1\" id=\"". $mode ."day\" value=\"". $day ."\"";
1710       if(!isset($_SESSION[$mode .'_date']))
1711          $output.= " disabled=\"disabled\"";
1712       $output.= " />\n";
1713
1714       return $output;
1715
1716    } // get_calendar()
1717
1718    /**
1719     * output calendar matrix
1720     */
1721    public function get_calendar_matrix($year = 0, $month = 0, $day = 0)
1722    {
1723       if (!isset($year)) $year = date('Y');
1724       if (!isset($month)) $month = date('m');
1725       if (!isset($day)) $day = date('d');
1726       $rows = 1;
1727       $cols = 1;
1728       $matrix = Array();
1729
1730       require_once CALENDAR_ROOT.'Month/Weekdays.php';
1731       require_once CALENDAR_ROOT.'Day.php';
1732
1733       // Build the month
1734       $month = new Calendar_Month_Weekdays($year,$month);
1735
1736       // Create links
1737       $prevStamp = $month->prevMonth(true);
1738       $prev = "javascript:setMonth(". date('Y',$prevStamp) .", ". date('n',$prevStamp) .", ". date('j',$prevStamp) .");";
1739       $nextStamp = $month->nextMonth(true);
1740       $next = "javascript:setMonth(". date('Y',$nextStamp) .", ". date('n',$nextStamp) .", ". date('j',$nextStamp) .");";
1741
1742       $selectedDays = array (
1743          new Calendar_Day($year,$month,$day),
1744          new Calendar_Day($year,12,25),
1745       );
1746
1747       // Build the days in the month
1748       $month->build($selectedDays);
1749
1750       $this->tmpl->assign('current_month', date('F Y',$month->getTimeStamp()));
1751       $this->tmpl->assign('prev_month', $prev);
1752       $this->tmpl->assign('next_month', $next);
1753
1754       while ( $day = $month->fetch() ) {
1755    
1756          if(!isset($matrix[$rows]))
1757             $matrix[$rows] = Array();
1758
1759          $string = "";
1760
1761          $dayStamp = $day->thisDay(true);
1762          $link = "javascript:setCalendarDate(". date('Y',$dayStamp) .", ". date('n',$dayStamp).", ". date('j',$dayStamp) .");";
1763
1764          // isFirst() to find start of week
1765          if ( $day->isFirst() )
1766             $string.= "<tr>\n";
1767
1768          if ( $day->isSelected() ) {
1769             $string.= "<td class=\"selected\">".$day->thisDay()."</td>\n";
1770          } else if ( $day->isEmpty() ) {
1771             $string.= "<td>&nbsp;</td>\n";
1772          } else {
1773             $string.= "<td><a class=\"calendar\" href=\"".$link."\">".$day->thisDay()."</a></td>\n";
1774          }
1775
1776          // isLast() to find end of week
1777          if ( $day->isLast() )
1778             $string.= "</tr>\n";
1779
1780          $matrix[$rows][$cols] = $string;
1781
1782          $cols++;
1783
1784          if($cols > 7) {
1785             $cols = 1;
1786             $rows++;
1787          }
1788       }
1789
1790       $this->tmpl->assign('matrix', $matrix);
1791       $this->tmpl->assign('rows', $rows);
1792       $this->tmpl->show("calendar.tpl");
1793
1794    } // get_calendar_matrix()
1795
1796    /**
1797     * output export page
1798     */
1799    public function getExport($mode)
1800    {
1801       $pictures = $this->getPhotoSelection();
1802       $current_tags = $this->getCurrentTags();  
1803
1804       foreach($pictures as $picture) {
1805
1806          $orig_url = $this->get_phpfspot_url() ."index.php?mode=showp&id=". $picture;
1807          if($current_tags != "") {
1808             $orig_url.= "&tags=". $current_tags;
1809          } 
1810          if(isset($_SESSION['from_date']) && isset($_SESSION['to_date'])) {
1811             $orig_url.= "&from_date=". $_SESSION['from_date'] ."&to_date=". $_SESSION['to_date'];
1812          }
1813
1814          $thumb_url = $this->get_phpfspot_url() ."phpfspot_img.php?idx=". $picture ."&width=". $this->cfg->thumb_width;
1815
1816          switch($mode) {
1817
1818             case 'HTML':
1819                // <a href="%pictureurl%"><img src="%thumbnailurl%" ></a>
1820                print htmlspecialchars("<a href=\"". $orig_url ."\"><img src=\"". $thumb_url ."\" /></a>") ."<br />\n";
1821                break;
1822                
1823             case 'MoinMoin':
1824                // "[%pictureurl% %thumbnailurl%]"
1825                print htmlspecialchars("[".$orig_url." ".$thumb_url."&fake=1.jpg]") ."<br />\n";
1826                break;
1827
1828             case 'MoinMoinList':
1829                // " * [%pictureurl% %thumbnailurl%]"
1830                print "&nbsp;" . htmlspecialchars("* [".$orig_url." ".$thumb_url."&fake=1.jpg]") ."<br />\n";
1831                break;
1832          }
1833
1834       }
1835
1836    } // getExport()
1837
1838    /**
1839     * output RSS feed
1840     */
1841    public function getRSSFeed()
1842    {
1843       Header("Content-type: text/xml; charset=utf-8");
1844       print "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n";
1845 ?>
1846 <rss version="2.0"
1847    xmlns:media="http://search.yahoo.com/mrss/"
1848    xmlns:dc="http://purl.org/dc/elements/1.1/"
1849  >
1850  <channel>
1851   <title>phpfspot</title>
1852   <description>phpfspot RSS feed</description>
1853   <link><?php print htmlspecialchars($this->get_phpfspot_url()); ?></link>
1854   <pubDate><?php print strftime("%a, %d %b %Y %T %z"); ?></pubDate>
1855   <generator>phpfspot</generator>
1856 <?php
1857
1858       $pictures = $this->getPhotoSelection();
1859       $current_tags = $this->getCurrentTags();  
1860
1861       foreach($pictures as $picture) {
1862
1863          $orig_url = $this->get_phpfspot_url() ."index.php?mode=showp&id=". $picture;
1864          if($current_tags != "") {
1865             $orig_url.= "&tags=". $current_tags;
1866          } 
1867          if(isset($_SESSION['from_date']) && isset($_SESSION['to_date'])) {
1868             $orig_url.= "&from_date=". $_SESSION['from_date'] ."&to_date=". $_SESSION['to_date'];
1869          }
1870
1871          $details = $this->get_photo_details($picture);
1872
1873          $thumb_url = $this->get_phpfspot_url() ."phpfspot_img.php?idx=". $picture ."&width=". $this->cfg->thumb_width;
1874          $thumb_html = htmlspecialchars("
1875 <a href=\"". $orig_url ."\"><img src=\"". $thumb_url ."\" /></a>
1876 <br>
1877 ". $details['description']);
1878
1879          $orig_path = $this->translate_path($this->parse_uri($details['uri'], 'fullpath'));
1880          $meta = $this->get_meta_informations($orig_path);
1881          $meta_date = isset($meta['FileDateTime']) ? $meta['FileDateTime'] : filemtime($orig_path);
1882
1883 ?>
1884   <item>
1885    <title><?php print htmlspecialchars($this->parse_uri($details['uri'], 'filename')); ?></title>
1886    <link><?php print htmlspecialchars($orig_url); ?></link>
1887    <guid><?php print htmlspecialchars($orig_url); ?></guid>
1888    <dc:date.Taken><?php print strftime("%Y-%m-%dT%H:%M:%S+00:00", $meta_date); ?></dc:date.Taken>
1889    <description>
1890     <?php print $thumb_html; ?> 
1891    </description>
1892    <pubDate><?php print strftime("%a, %d %b %Y %T %z", $meta_date); ?></pubDate>
1893   </item>
1894 <?php
1895
1896       }
1897 ?>
1898  </channel>
1899 </rss>
1900 <?php
1901
1902
1903    } // getExport()
1904
1905  
1906    /**
1907     * return all selected tags as one string
1908     */
1909    private function getCurrentTags()
1910    {
1911       $current_tags = "";
1912       if(isset($_SESSION['selected_tags']) && $_SESSION['selected_tags'] != "") {
1913          foreach($_SESSION['selected_tags'] as $tag)
1914             $current_tags.= $tag .",";
1915          $current_tags = substr($current_tags, 0, strlen($current_tags)-1);
1916       }
1917       return $current_tags;
1918
1919    } // getCurrentTags()
1920
1921    /**
1922     * return the current photo
1923     */
1924    public function getCurrentPhoto()
1925    {
1926       if(isset($_SESSION['current_photo'])) {
1927          print $_SESSION['current_photo'];
1928       }
1929    } // getCurrentPhoto()
1930
1931    /**
1932     * tells the client browser what to do
1933     *
1934     * this function is getting called via AJAX by the
1935     * client browsers. it will tell them what they have
1936     * to do next. This is necessary for directly jumping
1937     * into photo index or single photo view when the are
1938     * requested with specific URLs
1939     */
1940    public function whatToDo()
1941    {
1942       if(isset($_SESSION['current_photo']) && $_SESSION['start_action'] == 'showp') {
1943          return "show_photo";
1944       }
1945       elseif(isset($_SESSION['selected_tags']) && !empty($_SESSION['selected_tags'])) {
1946          return "showpi_tags";
1947       }
1948       elseif(isset($_SESSION['start_action']) && $_SESSION['start_action'] == 'showpi') {
1949          return "showpi";
1950       }
1951
1952       return "nothing special";
1953
1954    } // whatToDo()
1955
1956    /**
1957     * return the current process-user
1958     */
1959    private function getuid()
1960    {
1961       if($uid = posix_getuid()) {
1962          if($user = posix_getpwuid($uid)) {
1963             return $user['name'];
1964          }
1965       }
1966    
1967       return 'n/a';
1968    
1969    } // getuid()
1970
1971    /**
1972     * returns a select-dropdown box to select photo index sort parameters
1973     */
1974    public function smarty_sort_select_list($params, &$smarty)
1975    {
1976       $output = "";
1977
1978       foreach($this->sort_orders as $key => $value) {
1979          $output.= "<option value=\"". $key ."\"";
1980          if($key == $_SESSION['sort_order']) {
1981             $output.= " selected=\"selected\"";
1982          }
1983          $output.= ">". $value ."</option>";
1984       }
1985
1986       return $output;
1987
1988    } // smarty_sort_select_list()
1989
1990    /**
1991     * returns the currently selected sort order
1992     */ 
1993    private function get_sort_order()
1994    {
1995       switch($_SESSION['sort_order']) {
1996          case 'date_asc':
1997             return " ORDER BY p.time ASC";
1998             break;
1999          case 'date_desc':
2000             return " ORDER BY p.time DESC";
2001             break;
2002          case 'name_asc':
2003             if($this->dbver < 9) {
2004                return " ORDER BY p.name ASC";
2005             }
2006             else {
2007                return " ORDER BY basename(p.uri) ASC";
2008             }
2009             break;
2010          case 'name_desc':
2011             if($this->dbver < 9) {
2012                return " ORDER BY p.name DESC";
2013             }
2014             else {
2015                return " ORDER BY basename(p.uri) DESC";
2016             }
2017             break;
2018       }
2019
2020    } // get_sort_order()
2021
2022    /***
2023      * return the next to be shown slide show image
2024      *
2025      * this function returns the URL of the next image
2026      * in the slideshow sequence.
2027      */
2028    public function getNextSlideShowImage()
2029    {
2030       $all_photos = $this->getPhotoSelection();
2031
2032       if(!isset($_SESSION['slideshow_img']) || $_SESSION['slideshow_img'] == count($all_photos)-1) 
2033          $_SESSION['slideshow_img'] = 0;
2034       else
2035          $_SESSION['slideshow_img']++;
2036
2037       return $this->get_phpfspot_url() ."phpfspot_img.php?idx=". $all_photos[$_SESSION['slideshow_img']] ."&width=". $this->cfg->photo_width;
2038
2039    } // getNextSlideShowImage()
2040
2041    /***
2042      * return the previous to be shown slide show image
2043      *
2044      * this function returns the URL of the previous image
2045      * in the slideshow sequence.
2046      */
2047    public function getPrevSlideShowImage()
2048    {
2049       $all_photos = $this->getPhotoSelection();
2050
2051       if(!isset($_SESSION['slideshow_img']) || $_SESSION['slideshow_img'] == 0)
2052          $_SESSION['slideshow_img'] = 0;
2053       else
2054          $_SESSION['slideshow_img']--;
2055
2056       return $this->get_phpfspot_url() ."phpfspot_img.php?idx=". $all_photos[$_SESSION['slideshow_img']] ."&width=". $this->cfg->photo_width;
2057
2058    } // getPrevSlideShowImage()
2059
2060    public function resetSlideShow()
2061    {
2062       if(isset($_SESSION['slideshow_img']))
2063          unset($_SESSION['slideshow_img']);
2064    } // resetSlideShow()
2065    
2066    /***
2067      * get random photo
2068      *
2069      * this function will get all photos from the fspot
2070      * database and randomly return ONE entry
2071      *
2072      * saddly there is yet no sqlite3 function which returns
2073      * the bulk result in array, so we have to fill up our
2074      * own here.
2075      */ 
2076    public function get_random_photo()
2077    {
2078       $all = Array();
2079
2080       $result = $this->db->db_query("
2081          SELECT id
2082          FROM photos
2083       ");
2084       
2085       while($row = $this->db->db_fetch_object($result)) {
2086          array_push($all, $row['id']);
2087       }
2088
2089       return $all[array_rand($all)];
2090
2091    } // get_random_photo()
2092
2093    /**
2094     * validates provided date
2095     *
2096     * this function validates if the provided date
2097     * contains a valid date and will return true 
2098     * if it is.
2099     */
2100    public function isValidDate($date_str)
2101    {
2102       $timestamp = strtotime($date_str);
2103    
2104       if(is_numeric($timestamp))
2105          return true;
2106       
2107       return false;
2108
2109    } // isValidDate()
2110
2111    /**
2112     * timestamp to string conversion
2113     */
2114    private function ts2str($timestamp)
2115    {
2116       return strftime("%Y-%m-%d", $timestamp);
2117    } // ts2str()
2118
2119    private function extractTags($tags_str)
2120    {
2121       $not_validated = split(',', $_GET['tags']);
2122       $validated = array();
2123
2124       foreach($not_validated as $tag) {
2125          if(is_numeric($tag))
2126             array_push($validated, $tag);
2127       }
2128    
2129       return $validated;
2130    
2131    } // extractTags()
2132
2133    /**
2134     * returns the full path to a thumbnail
2135     */
2136    public function get_thumb_path($width, $photo)
2137    {
2138       $md5 = $this->getMD5($photo);
2139       $sub_path = substr($md5, 0, 2);
2140       return $this->cfg->thumb_path
2141          . "/"
2142          . $sub_path
2143          . "/"
2144          . $width
2145          . "_"
2146          . $md5;
2147
2148    } // get_thumb_path()
2149
2150    /**
2151     * returns server's virtual host name
2152     */
2153    private function get_server_name()
2154    {
2155       return $_SERVER['SERVER_NAME'];
2156    } // get_server_name()
2157
2158    /**
2159     * returns type of webprotocol which is
2160     * currently used
2161     */
2162    private function get_web_protocol()
2163    {
2164       if(!isset($_SERVER['HTTPS']))
2165          return "http";
2166       else
2167          return "https";
2168    } // get_web_protocol()
2169
2170    /**
2171     * return url to this phpfspot installation
2172     */
2173    private function get_phpfspot_url()
2174    {
2175       return $this->get_web_protocol() ."://". $this->get_server_name() . $this->cfg->web_path;
2176    } // get_phpfspot_url()
2177    
2178    /**
2179     * check file exists and is readable
2180     *
2181     * returns true, if everything is ok, otherwise false
2182     * if $silent is not set, this function will output and
2183     * error message
2184     */
2185    private function check_readable($file, $silent = null)
2186    {
2187       if(!file_exists($file)) {
2188          if(!isset($silent))
2189             print "File \"". $file ."\" does not exist.\n";
2190          return false;
2191       }
2192
2193       if(!is_readable($file)) {
2194          if(!isset($silent))
2195             print "File \"". $file ."\" is not reachable for user ". $this->getuid() ."\n";
2196          return false;
2197       }
2198
2199       return true;
2200
2201    } // check_readable()
2202
2203    /**
2204     * check if all needed indices are present
2205     *
2206     * this function checks, if some needed indices are already
2207     * present, or if not, create them on the fly. they are
2208     * necessary to speed up some queries like that one look for
2209     * all tags, when show_tags is specified in the configuration.
2210     */
2211    private function checkDbIndices()
2212    {
2213       $result = $this->db->db_exec("
2214          CREATE INDEX IF NOT EXISTS
2215             phototag
2216          ON
2217             photo_tags
2218                (photo_id, tag_id)
2219       ");
2220
2221    } // checkDbIndices()
2222
2223    /**
2224     * retrive F-Spot database version
2225     *
2226     * this function will return the F-Spot database version number
2227     * It is stored within the sqlite3 database in the table meta
2228     */
2229    public function getFspotDBVersion()
2230    {
2231       if($result = $this->db->db_fetchSingleRow("
2232          SELECT data as version
2233          FROM meta
2234          WHERE
2235             name LIKE 'F-Spot Database Version'
2236       "))
2237          return $result['version'];
2238
2239       return null;
2240
2241    } // getFspotDBVersion()
2242
2243    /**
2244     * parse the provided URI and will returned the
2245     * requested chunk
2246     */
2247    public function parse_uri($uri, $mode)
2248    {
2249       if(($components = parse_url($uri)) !== false) {
2250
2251          switch($mode) {
2252             case 'filename':
2253                return basename($components['path']);
2254                break;
2255             case 'dirname':
2256                return dirname($components['path']);
2257                break;
2258             case 'fullpath':
2259                return $components['path'];
2260                break;
2261          }
2262       }
2263
2264       return $uri;
2265
2266    } // parse_uri()
2267
2268 } // class PHPFSPOT
2269
2270 ?>