source: trunk/picture.php @ 1825

Last change on this file since 1825 was 1825, checked in by plg, 17 years ago

Code refactoring.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 21.3 KB
Line 
1<?php
2// +-----------------------------------------------------------------------+
3// | PhpWebGallery - a PHP based picture gallery                           |
4// | Copyright (C) 2002-2003 Pierrick LE GALL - pierrick@phpwebgallery.net |
5// | Copyright (C) 2003-2007 PhpWebGallery Team - http://phpwebgallery.net |
6// +-----------------------------------------------------------------------+
7// | branch        : BSF (Best So Far)
8// | file          : $Id: picture.php 1825 2007-02-15 21:20:52Z plg $
9// | last update   : $Date: 2007-02-15 21:20:52 +0000 (Thu, 15 Feb 2007) $
10// | last modifier : $Author: plg $
11// | revision      : $Revision: 1825 $
12// +-----------------------------------------------------------------------+
13// | This program is free software; you can redistribute it and/or modify  |
14// | it under the terms of the GNU General Public License as published by  |
15// | the Free Software Foundation                                          |
16// |                                                                       |
17// | This program is distributed in the hope that it will be useful, but   |
18// | WITHOUT ANY WARRANTY; without even the implied warranty of            |
19// | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU      |
20// | General Public License for more details.                              |
21// |                                                                       |
22// | You should have received a copy of the GNU General Public License     |
23// | along with this program; if not, write to the Free Software           |
24// | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, |
25// | USA.                                                                  |
26// +-----------------------------------------------------------------------+
27
28define('PHPWG_ROOT_PATH','./');
29include_once(PHPWG_ROOT_PATH.'include/common.inc.php');
30include(PHPWG_ROOT_PATH.'include/section_init.inc.php');
31include_once(PHPWG_ROOT_PATH.'include/functions_picture.inc.php');
32
33// Check Access and exit when user status is not ok
34check_status(ACCESS_GUEST);
35
36// access authorization check
37if (isset($page['category']))
38{
39  check_restrictions($page['category']);
40}
41
42// if this image_id doesn't correspond to this category, an error message is
43// displayed, and execution is stopped
44if (!in_array($page['image_id'], $page['items']))
45{
46  page_not_found(
47    'The requested image does not belong to this image set',
48    duplicate_index_url()
49    );
50}
51
52// add default event handler for rendering element content
53add_event_handler(
54  'render_element_content',
55  'default_picture_content',
56  EVENT_HANDLER_PRIORITY_NEUTRAL,
57  2
58  );
59trigger_action('loc_begin_picture');
60
61// this is the default handler that generates the display for the element
62function default_picture_content($content, $element_info)
63{
64  if ( !empty($content) )
65  {// someone hooked us - so we skip;
66    return $content;
67  }
68  if (!isset($element_info['image_url']))
69  { // nothing to do
70    return $content;
71  }
72
73  global $user, $page;
74
75  $my_template = new Template(
76    PHPWG_ROOT_PATH.'template/'.$user['template'],
77    $user['theme']
78    );
79  $my_template->set_filenames(
80    array('default_content'=>'picture_content.tpl')
81    );
82
83  if ( !isset($page['slideshow']) and isset($element_info['high_url']) )
84  {
85    $uuid = uniqid(rand());
86    $my_template->assign_block_vars(
87      'high',
88      array(
89        'U_HIGH' => $element_info['high_url'],
90        'UUID'   => $uuid,
91        )
92      );
93  }
94  $my_template->assign_vars( array(
95      'SRC_IMG' => $element_info['image_url'],
96      'ALT_IMG' => $element_info['file'],
97      'WIDTH_IMG' => @$element_info['scaled_width'],
98      'HEIGHT_IMG' => @$element_info['scaled_height'],
99      )
100    );
101  return $my_template->parse( 'default_content', true);
102}
103
104// +-----------------------------------------------------------------------+
105// |                            initialization                             |
106// +-----------------------------------------------------------------------+
107
108$page['rank_of'] = array_flip($page['items']);
109
110// caching first_rank, last_rank, current_rank in the displayed
111// section. This should also help in readability.
112$page['first_rank']   = 0;
113$page['last_rank']    = count($page['items']) - 1;
114$page['current_rank'] = $page['rank_of'][ $page['image_id'] ];
115
116// caching current item : readability purpose
117$page['current_item'] = $page['image_id'];
118
119if ($page['current_rank'] != $page['first_rank'])
120{
121  // caching first & previous item : readability purpose
122  $page['previous_item'] = $page['items'][ $page['current_rank'] - 1 ];
123  $page['first_item'] = $page['items'][ $page['first_rank'] ];
124}
125
126if ($page['current_rank'] != $page['last_rank'])
127{
128  // caching next & last item : readability purpose
129  $page['next_item'] = $page['items'][ $page['current_rank'] + 1 ];
130  $page['last_item'] = $page['items'][ $page['last_rank'] ];
131}
132
133$url_up = duplicate_index_url(
134  array(
135    'start' =>
136      floor($page['current_rank'] / $user['nb_image_page'])
137      * $user['nb_image_page']
138    ),
139  array(
140    'start',
141    )
142  );
143
144$url_self = duplicate_picture_url();
145
146// +-----------------------------------------------------------------------+
147// |                                actions                                |
148// +-----------------------------------------------------------------------+
149
150/**
151 * Actions are favorite adding, user comment deletion, setting the picture
152 * as representative of the current category...
153 *
154 * Actions finish by a redirection
155 */
156
157if (isset($_GET['action']))
158{
159  switch ($_GET['action'])
160  {
161    case 'add_to_favorites' :
162    {
163      $query = '
164INSERT INTO '.FAVORITES_TABLE.'
165  (image_id,user_id)
166  VALUES
167  ('.$page['image_id'].','.$user['id'].')
168;';
169      pwg_query($query);
170
171      redirect($url_self);
172
173      break;
174    }
175    case 'remove_from_favorites' :
176    {
177      $query = '
178DELETE FROM '.FAVORITES_TABLE.'
179  WHERE user_id = '.$user['id'].'
180    AND image_id = '.$page['image_id'].'
181;';
182      pwg_query($query);
183
184      if ('favorites' == $page['section'])
185      {
186        redirect($url_up);
187      }
188      else
189      {
190        redirect($url_self);
191      }
192
193      break;
194    }
195    case 'set_as_representative' :
196    {
197      if (is_admin() and !is_adviser() and isset($page['category']))
198      {
199        $query = '
200UPDATE '.CATEGORIES_TABLE.'
201  SET representative_picture_id = '.$page['image_id'].'
202  WHERE id = '.$page['category'].'
203;';
204        pwg_query($query);
205      }
206
207      redirect($url_self);
208
209      break;
210    }
211    case 'toggle_metadata' :
212    {
213      break;
214    }
215    case 'add_to_caddie' :
216    {
217      fill_caddie(array($page['image_id']));
218      redirect($url_self);
219      break;
220    }
221    case 'rate' :
222    {
223      include_once(PHPWG_ROOT_PATH.'include/functions_rate.inc.php');
224      rate_picture(
225        $page['image_id'],
226        isset($_POST['rate']) ? $_POST['rate'] : $_GET['rate']
227        );
228      redirect($url_self);
229    }
230    case 'delete_comment' :
231    {
232      if (isset($_GET['comment_to_delete'])
233          and is_numeric($_GET['comment_to_delete'])
234          and is_admin() and !is_adviser() )
235      {
236        $query = '
237DELETE FROM '.COMMENTS_TABLE.'
238  WHERE id = '.$_GET['comment_to_delete'].'
239;';
240        pwg_query( $query );
241      }
242
243      redirect($url_self);
244    }
245  }
246}
247
248// incrementation of the number of hits, we do this only if no action
249$query = '
250UPDATE
251  '.IMAGES_TABLE.'
252  SET hit = hit+1
253  WHERE id = '.$page['image_id'].'
254;';
255pwg_query($query);
256
257//---------------------------------------------------------- related categories
258$query = '
259SELECT category_id,uppercats,commentable,global_rank
260  FROM '.IMAGE_CATEGORY_TABLE.'
261    INNER JOIN '.CATEGORIES_TABLE.' ON category_id = id
262  WHERE image_id = '.$page['image_id'].'
263'.get_sql_condition_FandF
264  (
265    array
266      (
267        'forbidden_categories' => 'category_id',
268        'visible_categories' => 'category_id'
269      ),
270    'AND'
271  ).'
272;';
273$result = pwg_query($query);
274$related_categories = array();
275while ($row = mysql_fetch_array($result))
276{
277  array_push($related_categories, $row);
278}
279usort($related_categories, 'global_rank_compare');
280//-------------------------first, prev, current, next & last picture management
281$picture = array();
282
283$ids = array($page['image_id']);
284if (isset($page['previous_item']))
285{
286  array_push($ids, $page['previous_item']);
287  array_push($ids, $page['first_item']);
288}
289if (isset($page['next_item']))
290{
291  array_push($ids, $page['next_item']);
292  array_push($ids, $page['last_item']);
293}
294
295$query = '
296SELECT *
297  FROM '.IMAGES_TABLE.'
298  WHERE id IN ('.implode(',', $ids).')
299;';
300
301$result = pwg_query($query);
302
303while ($row = mysql_fetch_assoc($result))
304{
305  if (isset($page['previous_item']) and $row['id'] == $page['previous_item'])
306  {
307    $i = 'previous';
308  }
309  else if (isset($page['next_item']) and $row['id'] == $page['next_item'])
310  {
311    $i = 'next';
312  }
313  else if (isset($page['first_item']) and $row['id'] == $page['first_item'])
314  {
315    $i = 'first';
316  }
317  else if (isset($page['last_item']) and $row['id'] == $page['last_item'])
318  {
319    $i = 'last';
320  }
321  else
322  {
323    $i = 'current';
324  }
325
326  $picture[$i] = $row;
327
328  $picture[$i]['is_picture'] = false;
329  if (in_array(get_extension($row['file']), $conf['picture_ext']))
330  {
331    $picture[$i]['is_picture'] = true;
332  }
333
334  // ------ build element_path and element_url
335  $picture[$i]['element_path'] = get_element_path($picture[$i]);
336  $picture[$i]['element_url'] = get_element_url($picture[$i]);
337
338  // ------ build image_path and image_url
339  if ($i=='current' or $i=='next')
340  {
341    $picture[$i]['image_path'] = get_image_path( $picture[$i] );
342    $picture[$i]['image_url'] = get_image_url( $picture[$i] );
343  }
344
345  if ($i=='current')
346  {
347    if ( $picture[$i]['is_picture'] )
348    {
349      if ( $user['enabled_high']=='true' )
350      {
351        $hi_url=get_high_url($picture[$i]);
352        if ( !empty($hi_url) )
353        {
354          $picture[$i]['high_url'] = $hi_url;
355          $picture[$i]['download_url'] = get_download_url('h',$picture[$i]);
356        }
357      }
358    }
359    else
360    { // not a pic - need download link
361      $picture[$i]['download_url'] = get_download_url('e',$picture[$i]);
362    }
363  }
364
365  $picture[$i]['thumbnail'] = get_thumbnail_url($row);
366
367  if ( !empty( $row['name'] ) )
368  {
369    $picture[$i]['name'] = $row['name'];
370  }
371  else
372  {
373    $file_wo_ext = get_filename_wo_extension($row['file']);
374    $picture[$i]['name'] = str_replace('_', ' ', $file_wo_ext);
375  }
376
377  $picture[$i]['url'] = duplicate_picture_url(
378    array(
379      'image_id' => $row['id'],
380      'image_file' => $row['file'],
381      ),
382    array(
383      'start',
384      )
385    );
386
387  if ('previous'==$i and $page['previous_item']==$page['first_item'])
388  {
389    $picture['first'] = $picture[$i];
390  }
391  if ('next'==$i and $page['next_item']==$page['last_item'])
392  {
393    $picture['last'] = $picture[$i];
394  }
395}
396
397// calculation of width and height for the current picture
398if (empty($picture['current']['width']))
399{
400  $taille_image = @getimagesize($picture['current']['image_path']);
401  if ($taille_image!==false)
402  {
403    $picture['current']['width'] = $taille_image[0];
404    $picture['current']['height']= $taille_image[1];
405  }
406}
407
408if (!empty($picture['current']['width']))
409{
410  list(
411    $picture['current']['scaled_width'],
412    $picture['current']['scaled_height']
413    ) = get_picture_size(
414      $picture['current']['width'],
415      $picture['current']['height'],
416      @$user['maxwidth'],
417      @$user['maxheight']
418    );
419}
420
421$url_admin =
422  get_root_url().'admin.php?page=picture_modify'
423  .'&amp;cat_id='.(isset($page['category']) ? $page['category'] : '')
424  .'&amp;image_id='.$page['image_id']
425;
426
427$url_slide = add_url_params(
428  $picture['current']['url'],
429  array( 'slideshow'=>$conf['slideshow_period'] )
430  );
431
432
433$template->set_filename('picture', 'picture.tpl');
434if ( isset( $_GET['slideshow'] ) )
435{
436  $page['meta_robots']=array('noindex'=>1, 'nofollow'=>1);
437  $page['slideshow'] = true;
438  if ( $conf['light_slideshow'] )
439  {
440    $template->set_filename('picture', 'slideshow.tpl');
441  }
442  if ( isset($page['next_item']) )
443  {
444    // $redirect_msg, $refresh, $url_link and $title are required for creating
445    // an automated refresh page in header.tpl
446    $refresh= $_GET['slideshow'];
447    $url_link = add_url_params(
448        $picture['next']['url'],
449        array('slideshow'=>$refresh)
450      );
451    $redirect_msg = nl2br(l10n('redirect_msg'));
452  }
453}
454
455$title =  $picture['current']['name'];
456$title_nb = ($page['current_rank'] + 1).'/'.count($page['items']);
457
458// metadata
459$url_metadata = duplicate_picture_url();
460
461// do we have a plugin that can show metadata for something else than images?
462$metadata_showable = trigger_event(
463  'get_element_metadata_available',
464  (
465    ($conf['show_exif'] or $conf['show_iptc'])
466    and isset($picture['current']['image_path'])
467    ),
468  $picture['current']['path']
469  );
470
471if ($metadata_showable)
472{
473  if ( !isset($_GET['metadata']) )
474  {
475    $url_metadata = add_url_params( $url_metadata, array('metadata'=>null) );
476  }
477  else
478  {
479    $page['meta_robots']=array('noindex'=>1, 'nofollow'=>1);
480  }
481}
482
483$page['body_id'] = 'thePicturePage';
484
485// maybe someone wants a special display (call it before page_header so that
486// they can add stylesheets)
487$element_content = trigger_event(
488  'render_element_content',
489  '',
490  $picture['current']
491  );
492
493if (isset($picture['next']['image_url'])
494    and isset($picture['next']['is_picture']))
495{
496  $template->assign_block_vars(
497    'prefetch',
498    array (
499      'URL' => $picture['next']['image_url']
500      )
501    );
502}
503
504//------------------------------------------------------- navigation management
505foreach (array('first','previous','next','last') as $which_image)
506{
507  if (isset($picture[$which_image]))
508  {
509    $template->assign_block_vars(
510      $which_image,
511      array(
512        'TITLE_IMG' => $picture[$which_image]['name'],
513        'IMG' => $picture[$which_image]['thumbnail'],
514        'U_IMG' => $picture[$which_image]['url'],
515        )
516      );
517  }
518  else
519  {
520    $template->assign_block_vars(
521      $which_image.'_unactive',
522      array()
523      );
524  }
525}
526
527$template->assign_vars(
528  array(
529    'SECTION_TITLE' => $page['title'],
530    'PICTURE_TITLE' => $picture['current']['name'],
531    'PHOTO' => $title_nb,
532    'TITLE' => $picture['current']['name'],
533    'ELEMENT_CONTENT' => $element_content,
534
535    'LEVEL_SEPARATOR' => $conf['level_separator'],
536
537    'U_HOME' => make_index_url(),
538    'U_UP' => $url_up,
539    'U_METADATA' => $url_metadata,
540    'U_ADMIN' => $url_admin,
541    'U_SLIDESHOW'=> $url_slide,
542    'U_ADD_COMMENT' => $url_self,
543    )
544  );
545
546if ($conf['show_picture_name_on_title'])
547{
548  $template->assign_block_vars('title', array());
549}
550
551//------------------------------------------------------- upper menu management
552
553// download link
554if ( isset($picture['current']['download_url']) )
555{
556  $template->assign_block_vars(
557    'download',
558    array(
559      'U_DOWNLOAD' => $picture['current']['download_url']
560      )
561    );
562}
563
564// button to set the current picture as representative
565if (is_admin() and isset($page['category']))
566{
567  $template->assign_block_vars(
568    'representative',
569    array(
570      'URL' => add_url_params($url_self,
571                  array('action'=>'set_as_representative')
572               )
573      )
574    );
575}
576
577// caddie button
578if (is_admin())
579{
580  $template->assign_block_vars(
581    'caddie',
582    array(
583      'URL' => add_url_params($url_self,
584                  array('action'=>'add_to_caddie')
585               )
586      )
587    );
588}
589
590// favorite manipulation
591if (!$user['is_the_guest'])
592{
593  // verify if the picture is already in the favorite of the user
594  $query = '
595SELECT COUNT(*) AS nb_fav
596  FROM '.FAVORITES_TABLE.'
597  WHERE image_id = '.$page['image_id'].'
598    AND user_id = '.$user['id'].'
599;';
600  $result = pwg_query($query);
601  $row = mysql_fetch_array($result);
602
603  if ($row['nb_fav'] == 0)
604  {
605    $template->assign_block_vars(
606      'favorite',
607      array(
608        'FAVORITE_IMG'  =>
609          get_root_url().get_themeconf('icon_dir').'/favorite.png',
610        'FAVORITE_HINT' => $lang['add_favorites_hint'],
611        'FAVORITE_ALT'  => $lang['add_favorites_alt'],
612        'U_FAVORITE'    => add_url_params(
613          $url_self,
614          array('action'=>'add_to_favorites')
615          ),
616        )
617      );
618  }
619  else
620  {
621    $template->assign_block_vars(
622      'favorite',
623      array(
624        'FAVORITE_IMG'  =>
625          get_root_url().get_themeconf('icon_dir').'/del_favorite.png',
626        'FAVORITE_HINT' => $lang['del_favorites_hint'],
627        'FAVORITE_ALT'  => $lang['del_favorites_alt'],
628        'U_FAVORITE'    => add_url_params(
629          $url_self,
630          array('action'=>'remove_from_favorites')
631          ),
632        )
633      );
634  }
635}
636//------------------------------------ admin link for information modifications
637if ( is_admin() )
638{
639  $template->assign_block_vars('admin', array());
640}
641
642//--------------------------------------------------------- picture information
643$header_infos = array();        //for html header use
644// legend
645if (isset($picture['current']['comment'])
646    and !empty($picture['current']['comment']))
647{
648  $template->assign_block_vars(
649    'legend',
650    array(
651      'COMMENT_IMG' => nl2br($picture['current']['comment'])
652      ));
653  $header_infos['COMMENT'] = strip_tags($picture['current']['comment']);
654}
655
656$infos = array();
657
658// author
659if (!empty($picture['current']['author']))
660{
661  $infos['INFO_AUTHOR'] =
662// FIXME because of search engine partial rewrite, giving the author
663// name threw GET is not supported anymore. This feature should come
664// back later, with a better design
665//     '<a href="'.
666//       PHPWG_ROOT_PATH.'category.php?cat=search'.
667//       '&amp;search=author:'.$picture['current']['author']
668//       .'">'.$picture['current']['author'].'</a>';
669    $picture['current']['author'];
670  $header_infos['INFO_AUTHOR'] = $picture['current']['author'];
671}
672else
673{
674  $infos['INFO_AUTHOR'] = l10n('N/A');
675}
676
677// creation date
678if (!empty($picture['current']['date_creation']))
679{
680  $val = format_date($picture['current']['date_creation']);
681  $url = make_index_url(
682    array(
683      'chronology_field'=>'created',
684      'chronology_style'=>'monthly',
685      'chronology_view'=>'list',
686      'chronology_date' => explode('-', $picture['current']['date_creation'])
687      )
688    );
689  $infos['INFO_CREATION_DATE'] =
690    '<a href="'.$url.'" rel="nofollow">'.$val.'</a>';
691}
692else
693{
694  $infos['INFO_CREATION_DATE'] = l10n('N/A');
695}
696
697// date of availability
698$val = format_date($picture['current']['date_available'], 'mysql_datetime');
699$url = make_index_url(
700  array(
701    'chronology_field'=>'posted',
702    'chronology_style'=>'monthly',
703    'chronology_view'=>'list',
704    'chronology_date' => explode(
705      '-',
706      substr($picture['current']['date_available'], 0, 10)
707      )
708    )
709  );
710$infos['INFO_POSTED_DATE'] = '<a href="'.$url.'" rel="nofollow">'.$val.'</a>';
711
712// size in pixels
713if ($picture['current']['is_picture'] and isset($picture['current']['width']) )
714{
715  if ($picture['current']['scaled_width'] !== $picture['current']['width'] )
716  {
717    $infos['INFO_DIMENSIONS'] =
718      '<a href="'.$picture['current']['image_url'].'" title="'.
719      l10n('Original dimensions').'">'.
720      $picture['current']['width'].'*'.$picture['current']['height'].'</a>';
721  }
722  else
723  {
724    $infos['INFO_DIMENSIONS'] =
725      $picture['current']['width'].'*'.$picture['current']['height'];
726  }
727}
728else
729{
730  $infos['INFO_DIMENSIONS'] = l10n('N/A');
731}
732
733// filesize
734if (!empty($picture['current']['filesize']))
735{
736  $infos['INFO_FILESIZE'] =
737    sprintf(l10n('%d Kb'), $picture['current']['filesize']);
738}
739else
740{
741  $infos['INFO_FILESIZE'] = l10n('N/A');
742}
743
744// number of visits
745$infos['INFO_VISITS'] = $picture['current']['hit'];
746
747// file
748$infos['INFO_FILE'] = $picture['current']['file'];
749
750// tags
751$query = '
752SELECT id, name, url_name
753  FROM '.IMAGE_TAG_TABLE.'
754    INNER JOIN '.TAGS_TABLE.' ON tag_id = id
755  WHERE image_id = '.$page['image_id'].'
756;';
757$result = pwg_query($query);
758
759if (mysql_num_rows($result) > 0)
760{
761  $tags = array();
762  $tag_names = array();
763
764  while ($row = mysql_fetch_array($result))
765  {
766    array_push(
767      $tags,
768      '<a href="'
769      .make_index_url(
770        array(
771          'tags' => array(
772            array(
773              'id' => $row['id'],
774              'url_name' => $row['url_name'],
775              ),
776            )
777          )
778        )
779      .'">'.$row['name'].'</a>'
780      );
781    array_push( $tag_names, $row['name'] );
782  }
783
784  $infos['INFO_TAGS'] = implode(', ', $tags);
785  $header_infos['INFO_TAGS'] = implode(', ', $tag_names);
786}
787else
788{
789  $infos['INFO_TAGS'] = l10n('N/A');
790}
791
792$template->assign_vars($infos);
793
794// related categories
795foreach ($related_categories as $category)
796{
797  $template->assign_block_vars(
798    'category',
799    array(
800      'LINE' => count($related_categories) > 3
801        ? get_cat_display_name_cache($category['uppercats'])
802        : get_cat_display_name_from_id($category['category_id'])
803      )
804    );
805}
806
807//slideshow end
808if (isset($_GET['slideshow']))
809{
810  if (!is_numeric($_GET['slideshow']))
811  {
812    $_GET['slideshow'] = $conf['slideshow_period'];
813  }
814
815  $template->assign_block_vars(
816    'stop_slideshow',
817    array(
818      'U_SLIDESHOW' => $picture['current']['url'],
819      )
820    );
821}
822
823// +-----------------------------------------------------------------------+
824// |                               sub pages                               |
825// +-----------------------------------------------------------------------+
826
827include(PHPWG_ROOT_PATH.'include/picture_rate.inc.php');
828include(PHPWG_ROOT_PATH.'include/picture_comment.inc.php');
829if ($metadata_showable and isset($_GET['metadata']))
830{
831  include(PHPWG_ROOT_PATH.'include/picture_metadata.inc.php');
832}
833//------------------------------------------------------------ log informations
834pwg_log($picture['current']['id']);
835
836include(PHPWG_ROOT_PATH.'include/page_header.php');
837trigger_action('loc_end_picture');
838$template->parse('picture');
839include(PHPWG_ROOT_PATH.'include/page_tail.php');
840?>
Note: See TracBrowser for help on using the repository browser.