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