issue90, display also photos which are not tagged
[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       if($from != 0)
1448          $_SESSION['from_date'] = strtotime($from);
1449       else
1450          unset($_SESSION['from_date']);
1451       if($to != 0)
1452          $_SESSION['to_date'] = strtotime($to);
1453       else
1454          unset($_SESSION['to_date']);
1455
1456       if($searchfor != "") {
1457          /* new search, reset the current selected tags */
1458          $_SESSION['selected_tags'] = Array();
1459          foreach($this->avail_tags as $tag) {
1460             if(preg_match('/'. $searchfor .'/i', $this->tags[$tag]))
1461                array_push($_SESSION['selected_tags'], $tag);
1462          }
1463       }
1464
1465    } // startSearch()
1466
1467    /**
1468     * updates sort order in session variable
1469     *
1470     * this function is invoked by RPC and will sort the requested
1471     * sort order in the session variable.
1472     */
1473    public function updateSortOrder($order)
1474    {
1475       if(isset($this->sort_orders[$order])) {
1476          $_SESSION['sort_order'] = $order;
1477          return "ok";
1478       }
1479
1480       return "unkown error";
1481
1482    } // updateSortOrder()
1483
1484    /**
1485     * rotate image
1486     *
1487     * this function rotates the image according the
1488     * specified angel.
1489     */
1490    private function rotateImage($img, $degrees)
1491    {
1492       if(function_exists("imagerotate")) {
1493          $img = imagerotate($img, $degrees, 0);
1494       } else {
1495          function imagerotate($src_img, $angle)
1496          {
1497             $src_x = imagesx($src_img);
1498             $src_y = imagesy($src_img);
1499             if ($angle == 180) {
1500                $dest_x = $src_x;
1501                $dest_y = $src_y;
1502             }
1503             elseif ($src_x <= $src_y) {
1504                $dest_x = $src_y;
1505                $dest_y = $src_x;
1506             }
1507             elseif ($src_x >= $src_y) {
1508                $dest_x = $src_y;
1509                $dest_y = $src_x;
1510             }
1511                
1512             $rotate=imagecreatetruecolor($dest_x,$dest_y);
1513             imagealphablending($rotate, false);
1514                
1515             switch ($angle) {
1516             
1517                case 90:
1518                   for ($y = 0; $y < ($src_y); $y++) {
1519                      for ($x = 0; $x < ($src_x); $x++) {
1520                         $color = imagecolorat($src_img, $x, $y);
1521                         imagesetpixel($rotate, $dest_x - $y - 1, $x, $color);
1522                      }
1523                   }
1524                   break;
1525
1526                case 270:
1527                   for ($y = 0; $y < ($src_y); $y++) {
1528                      for ($x = 0; $x < ($src_x); $x++) {
1529                         $color = imagecolorat($src_img, $x, $y);
1530                         imagesetpixel($rotate, $y, $dest_y - $x - 1, $color);
1531                      }
1532                   }
1533                   break;
1534
1535                case 180:
1536                   for ($y = 0; $y < ($src_y); $y++) {
1537                      for ($x = 0; $x < ($src_x); $x++) {
1538                         $color = imagecolorat($src_img, $x, $y);
1539                         imagesetpixel($rotate, $dest_x - $x - 1, $dest_y - $y - 1, $color);
1540                      }
1541                   }
1542                   break;
1543
1544                default:
1545                   $rotate = $src_img;
1546                   break;
1547             };
1548
1549             return $rotate;
1550
1551          }
1552
1553          $img = imagerotate($img, $degrees);
1554
1555       }
1556
1557       return $img;
1558
1559    } // rotateImage()
1560
1561    /**
1562     * return all assigned tags for the specified photo
1563     */
1564    private function get_photo_tags($idx)
1565    {
1566       $result = $this->db->db_query("
1567          SELECT t.id, t.name
1568          FROM tags t
1569          INNER JOIN photo_tags pt
1570             ON t.id=pt.tag_id
1571          WHERE pt.photo_id='". $idx ."'
1572       ");
1573
1574       $tags = Array();
1575
1576       while($row = $this->db->db_fetch_object($result))
1577          $tags[$row['id']] = $row['name'];
1578
1579       return $tags;
1580
1581    } // get_photo_tags()
1582
1583    /**
1584     * create on-the-fly images with text within
1585     */
1586    public function showTextImage($txt, $color=000000, $space=4, $font=4, $w=300)
1587    {
1588       if (strlen($color) != 6) 
1589          $color = 000000;
1590
1591       $int = hexdec($color);
1592       $h = imagefontheight($font);
1593       $fw = imagefontwidth($font);
1594       $txt = explode("\n", wordwrap($txt, ($w / $fw), "\n"));
1595       $lines = count($txt);
1596       $im = imagecreate($w, (($h * $lines) + ($lines * $space)));
1597       $bg = imagecolorallocate($im, 255, 255, 255);
1598       $color = imagecolorallocate($im, 0xFF & ($int >> 0x10), 0xFF & ($int >> 0x8), 0xFF & $int);
1599       $y = 0;
1600
1601       foreach ($txt as $text) {
1602          $x = (($w - ($fw * strlen($text))) / 2);
1603          imagestring($im, $font, $x, $y, $text, $color);
1604          $y += ($h + $space);
1605       }
1606
1607       Header("Content-type: image/png");
1608       ImagePng($im);
1609
1610    } // showTextImage()
1611
1612    /**
1613     * check if all requirements are met
1614     */
1615    private function checkRequirements()
1616    {
1617       if(!function_exists("imagecreatefromjpeg")) {
1618          print "PHP GD library extension is missing<br />\n";
1619          $missing = true;
1620       }
1621
1622       if($this->cfg->db_access == "native" && !function_exists("sqlite3_open")) {
1623          print "PHP SQLite3 library extension is missing<br />\n";
1624          $missing = true;
1625       }
1626
1627       /* Check for HTML_AJAX PEAR package, lent from Horde project */
1628       ini_set('track_errors', 1);
1629       @include_once 'HTML/AJAX/Server.php';
1630       if(isset($php_errormsg) && preg_match('/Failed opening.*for inclusion/i', $php_errormsg)) {
1631          print "PEAR HTML_AJAX package is missing<br />\n";
1632          $missing = true;
1633       }
1634       @include_once 'Calendar/Calendar.php';
1635       if(isset($php_errormsg) && preg_match('/Failed opening.*for inclusion/i', $php_errormsg)) {
1636          print "PEAR Calendar package is missing<br />\n";
1637          $missing = true;
1638       }
1639       @include_once 'Console/Getopt.php';
1640       if(isset($php_errormsg) && preg_match('/Failed opening.*for inclusion/i', $php_errormsg)) {
1641          print "PEAR Console_Getopt package is missing<br />\n";
1642          $missing = true;
1643       }
1644       ini_restore('track_errors');
1645
1646       if(isset($missing))
1647          return false;
1648
1649       return true;
1650
1651    } // checkRequirements()
1652
1653    private function _debug($text)
1654    {
1655       if($this->fromcmd) {
1656          print $text;
1657       }
1658
1659    } // _debug()
1660
1661    /**
1662     * check if specified MIME type is supported
1663     */
1664    public function checkifImageSupported($mime)
1665    {
1666       if(in_array($mime, Array("image/jpeg")))
1667          return true;
1668
1669       return false;
1670
1671    } // checkifImageSupported()
1672
1673    public function _error($text)
1674    {
1675       switch($this->cfg->logging) {
1676          case 'display':
1677             print "<img src=\"resources/green_info.png\" alt=\"warning\" />\n";
1678             print $text;
1679             break;
1680          case 'errorlog':  
1681             error_log($text);
1682             break;
1683          case 'logfile':
1684             error_log($text, 3, $his->cfg->log_file);
1685             break;
1686       }
1687
1688    } // _error()
1689
1690    /**
1691     * output calendard input fields
1692     */
1693    private function get_calendar($mode)
1694    {
1695       $year = isset($_SESSION[$mode .'_date']) ? date("Y", $_SESSION[$mode .'_date']) : date("Y");
1696       $month = isset($_SESSION[$mode .'_date']) ? date("m", $_SESSION[$mode .'_date']) : date("m");
1697       $day = isset($_SESSION[$mode .'_date']) ? date("d", $_SESSION[$mode .'_date']) : date("d");
1698
1699       $output = "<input type=\"text\" size=\"3\" id=\"". $mode ."year\" value=\"". $year ."\"";
1700       if(!isset($_SESSION[$mode .'_date']))
1701          $output.= " disabled=\"disabled\"";
1702       $output.= " />\n";
1703       $output.= "<input type=\"text\" size=\"1\" id=\"". $mode ."month\" value=\"". $month ."\"";
1704       if(!isset($_SESSION[$mode .'_date']))
1705          $output.= " disabled=\"disabled\"";
1706       $output.= " />\n";
1707       $output.= "<input type=\"text\" size=\"1\" id=\"". $mode ."day\" value=\"". $day ."\"";
1708       if(!isset($_SESSION[$mode .'_date']))
1709          $output.= " disabled=\"disabled\"";
1710       $output.= " />\n";
1711
1712       return $output;
1713
1714    } // get_calendar()
1715
1716    /**
1717     * output calendar matrix
1718     */
1719    public function get_calendar_matrix($year = 0, $month = 0, $day = 0)
1720    {
1721       if (!isset($year)) $year = date('Y');
1722       if (!isset($month)) $month = date('m');
1723       if (!isset($day)) $day = date('d');
1724       $rows = 1;
1725       $cols = 1;
1726       $matrix = Array();
1727
1728       require_once CALENDAR_ROOT.'Month/Weekdays.php';
1729       require_once CALENDAR_ROOT.'Day.php';
1730
1731       // Build the month
1732       $month = new Calendar_Month_Weekdays($year,$month);
1733
1734       // Create links
1735       $prevStamp = $month->prevMonth(true);
1736       $prev = "javascript:setMonth(". date('Y',$prevStamp) .", ". date('n',$prevStamp) .", ". date('j',$prevStamp) .");";
1737       $nextStamp = $month->nextMonth(true);
1738       $next = "javascript:setMonth(". date('Y',$nextStamp) .", ". date('n',$nextStamp) .", ". date('j',$nextStamp) .");";
1739
1740       $selectedDays = array (
1741          new Calendar_Day($year,$month,$day),
1742          new Calendar_Day($year,12,25),
1743       );
1744
1745       // Build the days in the month
1746       $month->build($selectedDays);
1747
1748       $this->tmpl->assign('current_month', date('F Y',$month->getTimeStamp()));
1749       $this->tmpl->assign('prev_month', $prev);
1750       $this->tmpl->assign('next_month', $next);
1751
1752       while ( $day = $month->fetch() ) {
1753    
1754          if(!isset($matrix[$rows]))
1755             $matrix[$rows] = Array();
1756
1757          $string = "";
1758
1759          $dayStamp = $day->thisDay(true);
1760          $link = "javascript:setCalendarDate(". date('Y',$dayStamp) .", ". date('n',$dayStamp).", ". date('j',$dayStamp) .");";
1761
1762          // isFirst() to find start of week
1763          if ( $day->isFirst() )
1764             $string.= "<tr>\n";
1765
1766          if ( $day->isSelected() ) {
1767             $string.= "<td class=\"selected\">".$day->thisDay()."</td>\n";
1768          } else if ( $day->isEmpty() ) {
1769             $string.= "<td>&nbsp;</td>\n";
1770          } else {
1771             $string.= "<td><a class=\"calendar\" href=\"".$link."\">".$day->thisDay()."</a></td>\n";
1772          }
1773
1774          // isLast() to find end of week
1775          if ( $day->isLast() )
1776             $string.= "</tr>\n";
1777
1778          $matrix[$rows][$cols] = $string;
1779
1780          $cols++;
1781
1782          if($cols > 7) {
1783             $cols = 1;
1784             $rows++;
1785          }
1786       }
1787
1788       $this->tmpl->assign('matrix', $matrix);
1789       $this->tmpl->assign('rows', $rows);
1790       $this->tmpl->show("calendar.tpl");
1791
1792    } // get_calendar_matrix()
1793
1794    /**
1795     * output export page
1796     */
1797    public function getExport($mode)
1798    {
1799       $pictures = $this->getPhotoSelection();
1800       $current_tags = $this->getCurrentTags();  
1801
1802       foreach($pictures as $picture) {
1803
1804          $orig_url = $this->get_phpfspot_url() ."index.php?mode=showp&id=". $picture;
1805          if($current_tags != "") {
1806             $orig_url.= "&tags=". $current_tags;
1807          } 
1808          if(isset($_SESSION['from_date']) && isset($_SESSION['to_date'])) {
1809             $orig_url.= "&from_date=". $_SESSION['from_date'] ."&to_date=". $_SESSION['to_date'];
1810          }
1811
1812          $thumb_url = $this->get_phpfspot_url() ."phpfspot_img.php?idx=". $picture ."&width=". $this->cfg->thumb_width;
1813
1814          switch($mode) {
1815
1816             case 'HTML':
1817                // <a href="%pictureurl%"><img src="%thumbnailurl%" ></a>
1818                print htmlspecialchars("<a href=\"". $orig_url ."\"><img src=\"". $thumb_url ."\" /></a>") ."<br />\n";
1819                break;
1820                
1821             case 'MoinMoin':
1822                // "[%pictureurl% %thumbnailurl%]"
1823                print htmlspecialchars("[".$orig_url." ".$thumb_url."&fake=1.jpg]") ."<br />\n";
1824                break;
1825
1826             case 'MoinMoinList':
1827                // " * [%pictureurl% %thumbnailurl%]"
1828                print "&nbsp;" . htmlspecialchars("* [".$orig_url." ".$thumb_url."&fake=1.jpg]") ."<br />\n";
1829                break;
1830          }
1831
1832       }
1833
1834    } // getExport()
1835
1836    /**
1837     * output RSS feed
1838     */
1839    public function getRSSFeed()
1840    {
1841       Header("Content-type: text/xml; charset=utf-8");
1842       print "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n";
1843 ?>
1844 <rss version="2.0"
1845    xmlns:media="http://search.yahoo.com/mrss/"
1846    xmlns:dc="http://purl.org/dc/elements/1.1/"
1847  >
1848  <channel>
1849   <title>phpfspot</title>
1850   <description>phpfspot RSS feed</description>
1851   <link><?php print htmlspecialchars($this->get_phpfspot_url()); ?></link>
1852   <pubDate><?php print strftime("%a, %d %b %Y %T %z"); ?></pubDate>
1853   <generator>phpfspot</generator>
1854 <?php
1855
1856       $pictures = $this->getPhotoSelection();
1857       $current_tags = $this->getCurrentTags();  
1858
1859       foreach($pictures as $picture) {
1860
1861          $orig_url = $this->get_phpfspot_url() ."index.php?mode=showp&id=". $picture;
1862          if($current_tags != "") {
1863             $orig_url.= "&tags=". $current_tags;
1864          } 
1865          if(isset($_SESSION['from_date']) && isset($_SESSION['to_date'])) {
1866             $orig_url.= "&from_date=". $_SESSION['from_date'] ."&to_date=". $_SESSION['to_date'];
1867          }
1868
1869          $details = $this->get_photo_details($picture);
1870
1871          $thumb_url = $this->get_phpfspot_url() ."phpfspot_img.php?idx=". $picture ."&width=". $this->cfg->thumb_width;
1872          $thumb_html = htmlspecialchars("
1873 <a href=\"". $orig_url ."\"><img src=\"". $thumb_url ."\" /></a>
1874 <br>
1875 ". $details['description']);
1876
1877          $orig_path = $this->translate_path($this->parse_uri($details['uri'], 'fullpath'));
1878          $meta = $this->get_meta_informations($orig_path);
1879          $meta_date = isset($meta['FileDateTime']) ? $meta['FileDateTime'] : filemtime($orig_path);
1880
1881 ?>
1882   <item>
1883    <title><?php print htmlspecialchars($this->parse_uri($details['uri'], 'filename')); ?></title>
1884    <link><?php print htmlspecialchars($orig_url); ?></link>
1885    <guid><?php print htmlspecialchars($orig_url); ?></guid>
1886    <dc:date.Taken><?php print strftime("%Y-%m-%dT%H:%M:%S+00:00", $meta_date); ?></dc:date.Taken>
1887    <description>
1888     <?php print $thumb_html; ?> 
1889    </description>
1890    <pubDate><?php print strftime("%a, %d %b %Y %T %z", $meta_date); ?></pubDate>
1891   </item>
1892 <?php
1893
1894       }
1895 ?>
1896  </channel>
1897 </rss>
1898 <?php
1899
1900
1901    } // getExport()
1902
1903  
1904    /**
1905     * return all selected tags as one string
1906     */
1907    private function getCurrentTags()
1908    {
1909       $current_tags = "";
1910       if(isset($_SESSION['selected_tags']) && $_SESSION['selected_tags'] != "") {
1911          foreach($_SESSION['selected_tags'] as $tag)
1912             $current_tags.= $tag .",";
1913          $current_tags = substr($current_tags, 0, strlen($current_tags)-1);
1914       }
1915       return $current_tags;
1916
1917    } // getCurrentTags()
1918
1919    /**
1920     * return the current photo
1921     */
1922    public function getCurrentPhoto()
1923    {
1924       if(isset($_SESSION['current_photo'])) {
1925          print $_SESSION['current_photo'];
1926       }
1927    } // getCurrentPhoto()
1928
1929    /**
1930     * tells the client browser what to do
1931     *
1932     * this function is getting called via AJAX by the
1933     * client browsers. it will tell them what they have
1934     * to do next. This is necessary for directly jumping
1935     * into photo index or single photo view when the are
1936     * requested with specific URLs
1937     */
1938    public function whatToDo()
1939    {
1940       if(isset($_SESSION['current_photo']) && $_SESSION['start_action'] == 'showp') {
1941          return "show_photo";
1942       }
1943       elseif(isset($_SESSION['selected_tags']) && !empty($_SESSION['selected_tags'])) {
1944          return "showpi_tags";
1945       }
1946       elseif(isset($_SESSION['start_action']) && $_SESSION['start_action'] == 'showpi') {
1947          return "showpi";
1948       }
1949
1950       return "nothing special";
1951
1952    } // whatToDo()
1953
1954    /**
1955     * return the current process-user
1956     */
1957    private function getuid()
1958    {
1959       if($uid = posix_getuid()) {
1960          if($user = posix_getpwuid($uid)) {
1961             return $user['name'];
1962          }
1963       }
1964    
1965       return 'n/a';
1966    
1967    } // getuid()
1968
1969    /**
1970     * returns a select-dropdown box to select photo index sort parameters
1971     */
1972    public function smarty_sort_select_list($params, &$smarty)
1973    {
1974       $output = "";
1975
1976       foreach($this->sort_orders as $key => $value) {
1977          $output.= "<option value=\"". $key ."\"";
1978          if($key == $_SESSION['sort_order']) {
1979             $output.= " selected=\"selected\"";
1980          }
1981          $output.= ">". $value ."</option>";
1982       }
1983
1984       return $output;
1985
1986    } // smarty_sort_select_list()
1987
1988    /**
1989     * returns the currently selected sort order
1990     */ 
1991    private function get_sort_order()
1992    {
1993       switch($_SESSION['sort_order']) {
1994          case 'date_asc':
1995             return " ORDER BY p.time ASC";
1996             break;
1997          case 'date_desc':
1998             return " ORDER BY p.time DESC";
1999             break;
2000          case 'name_asc':
2001             if($this->dbver < 9) {
2002                return " ORDER BY p.name ASC";
2003             }
2004             else {
2005                return " ORDER BY basename(p.uri) ASC";
2006             }
2007             break;
2008          case 'name_desc':
2009             if($this->dbver < 9) {
2010                return " ORDER BY p.name DESC";
2011             }
2012             else {
2013                return " ORDER BY basename(p.uri) DESC";
2014             }
2015             break;
2016       }
2017
2018    } // get_sort_order()
2019
2020    /***
2021      * return the next to be shown slide show image
2022      *
2023      * this function returns the URL of the next image
2024      * in the slideshow sequence.
2025      */
2026    public function getNextSlideShowImage()
2027    {
2028       $all_photos = $this->getPhotoSelection();
2029
2030       if(!isset($_SESSION['slideshow_img']) || $_SESSION['slideshow_img'] == count($all_photos)-1) 
2031          $_SESSION['slideshow_img'] = 0;
2032       else
2033          $_SESSION['slideshow_img']++;
2034
2035       return $this->get_phpfspot_url() ."phpfspot_img.php?idx=". $all_photos[$_SESSION['slideshow_img']] ."&width=". $this->cfg->photo_width;
2036
2037    } // getNextSlideShowImage()
2038
2039    /***
2040      * return the previous to be shown slide show image
2041      *
2042      * this function returns the URL of the previous image
2043      * in the slideshow sequence.
2044      */
2045    public function getPrevSlideShowImage()
2046    {
2047       $all_photos = $this->getPhotoSelection();
2048
2049       if(!isset($_SESSION['slideshow_img']) || $_SESSION['slideshow_img'] == 0)
2050          $_SESSION['slideshow_img'] = 0;
2051       else
2052          $_SESSION['slideshow_img']--;
2053
2054       return $this->get_phpfspot_url() ."phpfspot_img.php?idx=". $all_photos[$_SESSION['slideshow_img']] ."&width=". $this->cfg->photo_width;
2055
2056    } // getPrevSlideShowImage()
2057
2058    public function resetSlideShow()
2059    {
2060       if(isset($_SESSION['slideshow_img']))
2061          unset($_SESSION['slideshow_img']);
2062    } // resetSlideShow()
2063    
2064    /***
2065      * get random photo
2066      *
2067      * this function will get all photos from the fspot
2068      * database and randomly return ONE entry
2069      *
2070      * saddly there is yet no sqlite3 function which returns
2071      * the bulk result in array, so we have to fill up our
2072      * own here.
2073      */ 
2074    public function get_random_photo()
2075    {
2076       $all = Array();
2077
2078       $result = $this->db->db_query("
2079          SELECT id
2080          FROM photos
2081       ");
2082       
2083       while($row = $this->db->db_fetch_object($result)) {
2084          array_push($all, $row['id']);
2085       }
2086
2087       return $all[array_rand($all)];
2088
2089    } // get_random_photo()
2090
2091    /**
2092     * validates provided date
2093     *
2094     * this function validates if the provided date
2095     * contains a valid date and will return true 
2096     * if it is.
2097     */
2098    public function isValidDate($date_str)
2099    {
2100       $timestamp = strtotime($date_str);
2101    
2102       if(is_numeric($timestamp))
2103          return true;
2104       
2105       return false;
2106
2107    } // isValidDate()
2108
2109    /**
2110     * timestamp to string conversion
2111     */
2112    private function ts2str($timestamp)
2113    {
2114       return strftime("%Y-%m-%d", $timestamp);
2115    } // ts2str()
2116
2117    private function extractTags($tags_str)
2118    {
2119       $not_validated = split(',', $_GET['tags']);
2120       $validated = array();
2121
2122       foreach($not_validated as $tag) {
2123          if(is_numeric($tag))
2124             array_push($validated, $tag);
2125       }
2126    
2127       return $validated;
2128    
2129    } // extractTags()
2130
2131    /**
2132     * returns the full path to a thumbnail
2133     */
2134    public function get_thumb_path($width, $photo)
2135    {
2136       $md5 = $this->getMD5($photo);
2137       $sub_path = substr($md5, 0, 2);
2138       return $this->cfg->thumb_path
2139          . "/"
2140          . $sub_path
2141          . "/"
2142          . $width
2143          . "_"
2144          . $md5;
2145
2146    } // get_thumb_path()
2147
2148    /**
2149     * returns server's virtual host name
2150     */
2151    private function get_server_name()
2152    {
2153       return $_SERVER['SERVER_NAME'];
2154    } // get_server_name()
2155
2156    /**
2157     * returns type of webprotocol which is
2158     * currently used
2159     */
2160    private function get_web_protocol()
2161    {
2162       if(!isset($_SERVER['HTTPS']))
2163          return "http";
2164       else
2165          return "https";
2166    } // get_web_protocol()
2167
2168    /**
2169     * return url to this phpfspot installation
2170     */
2171    private function get_phpfspot_url()
2172    {
2173       return $this->get_web_protocol() ."://". $this->get_server_name() . $this->cfg->web_path;
2174    } // get_phpfspot_url()
2175    
2176    /**
2177     * check file exists and is readable
2178     *
2179     * returns true, if everything is ok, otherwise false
2180     * if $silent is not set, this function will output and
2181     * error message
2182     */
2183    private function check_readable($file, $silent = null)
2184    {
2185       if(!file_exists($file)) {
2186          if(!isset($silent))
2187             print "File \"". $file ."\" does not exist.\n";
2188          return false;
2189       }
2190
2191       if(!is_readable($file)) {
2192          if(!isset($silent))
2193             print "File \"". $file ."\" is not reachable for user ". $this->getuid() ."\n";
2194          return false;
2195       }
2196
2197       return true;
2198
2199    } // check_readable()
2200
2201    /**
2202     * check if all needed indices are present
2203     *
2204     * this function checks, if some needed indices are already
2205     * present, or if not, create them on the fly. they are
2206     * necessary to speed up some queries like that one look for
2207     * all tags, when show_tags is specified in the configuration.
2208     */
2209    private function checkDbIndices()
2210    {
2211       $result = $this->db->db_exec("
2212          CREATE INDEX IF NOT EXISTS
2213             phototag
2214          ON
2215             photo_tags
2216                (photo_id, tag_id)
2217       ");
2218
2219    } // checkDbIndices()
2220
2221    /**
2222     * retrive F-Spot database version
2223     *
2224     * this function will return the F-Spot database version number
2225     * It is stored within the sqlite3 database in the table meta
2226     */
2227    public function getFspotDBVersion()
2228    {
2229       if($result = $this->db->db_fetchSingleRow("
2230          SELECT data as version
2231          FROM meta
2232          WHERE
2233             name LIKE 'F-Spot Database Version'
2234       "))
2235          return $result['version'];
2236
2237       return null;
2238
2239    } // getFspotDBVersion()
2240
2241    /**
2242     * parse the provided URI and will returned the
2243     * requested chunk
2244     */
2245    public function parse_uri($uri, $mode)
2246    {
2247       if(($components = parse_url($uri)) !== false) {
2248
2249          switch($mode) {
2250             case 'filename':
2251                return basename($components['path']);
2252                break;
2253             case 'dirname':
2254                return dirname($components['path']);
2255                break;
2256             case 'fullpath':
2257                return $components['path'];
2258                break;
2259          }
2260       }
2261
2262       return $uri;
2263
2264    } // parse_uri()
2265
2266 } // class PHPFSPOT
2267
2268 ?>