File:  [LON-CAPA] / loncom / interface / lonsearchcat.pm
Revision 1.345: download - view: text, annotated - select for diffs
Fri Jun 12 21:11:07 2015 UTC (8 years, 11 months ago) by damieng
Branches: MAIN
CVS tags: HEAD
fixed some bugs in search UI, reduced sleeps for speed optimization in search and general network communication, reduced some timeouts

    1: # The LearningOnline Network with CAPA
    2: # Search Catalog
    3: #
    4: # $Id: lonsearchcat.pm,v 1.345 2015/06/12 21:11:07 damieng Exp $
    5: #
    6: # Copyright Michigan State University Board of Trustees
    7: #
    8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
    9: #
   10: # LON-CAPA is free software; you can redistribute it and/or modify
   11: # it under the terms of the GNU General Public License as published by
   12: # the Free Software Foundation; either version 2 of the License, or
   13: # (at your option) any later version.
   14: #
   15: # LON-CAPA is distributed in the hope that it will be useful,
   16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
   17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   18: # GNU General Public License for more details.
   19: #
   20: # You should have received a copy of the GNU General Public License
   21: # along with LON-CAPA; if not, write to the Free Software
   22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   23: #
   24: # /home/httpd/html/adm/gpl.txt
   25: #
   26: # http://www.lon-capa.org/
   27: #
   28: ###############################################################################
   29: ###############################################################################
   30: 
   31: =pod 
   32: 
   33: =head1 NAME
   34: 
   35: lonsearchcat - LONCAPA Search Interface
   36: 
   37: =head1 SYNOPSIS
   38: 
   39: Search interface to LON-CAPAs digital library
   40: 
   41: =head1 DESCRIPTION
   42: 
   43: This module enables searching for a distributed browseable catalog.
   44: 
   45: This is part of the LearningOnline Network with CAPA project
   46: described at http://www.lon-capa.org.
   47: 
   48: lonsearchcat presents the user with an interface to search the LON-CAPA
   49: digital library.  lonsearchcat also initiates the execution of a search
   50: by sending the search parameters to LON-CAPA servers.  The progress of 
   51: search (on a server basis) is displayed to the user in a separate window.
   52: 
   53: =head1 Internals
   54: 
   55: =cut
   56: 
   57: ###############################################################################
   58: ###############################################################################
   59: 
   60: package Apache::lonsearchcat;
   61: 
   62: use strict;
   63: use Apache::Constants qw(:common :http);
   64: use Apache::lonnet;
   65: use Apache::File();
   66: use CGI qw(:standard);
   67: use Text::Query;
   68: use GDBM_File;
   69: use Apache::loncommon();
   70: use Apache::lonmysql();
   71: use Apache::lonmeta;
   72: use Apache::lonhtmlcommon;
   73: use Apache::lonlocal;
   74: use LONCAPA::lonmetadata();
   75: use HTML::Entities();
   76: use Parse::RecDescent;
   77: use Apache::lonnavmaps;
   78: use Apache::lonindexer();
   79: use Apache::lonwishlist();
   80: use LONCAPA;
   81: use Time::HiRes qw(sleep);
   82: 
   83: ######################################################################
   84: ######################################################################
   85: ##
   86: ## Global variables
   87: ##
   88: ######################################################################
   89: ######################################################################
   90: my %groupsearch_db;  # Database hash used to save values for the 
   91:                      # groupsearch RAT interface.
   92: my %persistent_db;   # gdbm hash which holds data which is supposed to
   93:                      # persist across calls to lonsearchcat.pm
   94: 
   95: # The different view modes and associated functions
   96: 
   97: my %Views = ("detailed" => \&detailed_citation_view,
   98:              "detailedpreview" => \&detailed_citation_preview,
   99: 	     "summary"  => \&summary_view,
  100:              "summarypreview" => \&summary_preview,
  101: 	     "fielded"  => \&fielded_format_view,
  102: 	     "xml"      => \&xml_sgml_view,
  103: 	     "compact"  => \&compact_view);
  104: 
  105: ######################################################################
  106: ######################################################################
  107: sub handler {
  108:     my $r = shift;
  109: #    &set_defaults();
  110:     #
  111:     # set form defaults
  112:     #
  113:     my $hidden_fields;# Hold all the hidden fields used to keep track
  114:                       # of the search system state
  115:     my $importbutton; # button to take the selected results and go to group 
  116:                       # sorting
  117:     my $diropendb;    # The full path to the (temporary) search database file.
  118:                       # This is set and used in &handler() and is also used in 
  119:                       # &output_results().
  120: 
  121:     #
  122:     my $closebutton;  # button that closes the search window 
  123:                       # This button is different for the RAT compared to
  124:                       # normal invocation.
  125:     #
  126:     &Apache::loncommon::content_type($r,'text/html');
  127:     $r->send_http_header;
  128:     return OK if $r->header_only;
  129:     ##
  130:     ## Prevent caching of the search interface window.  Hopefully this means
  131:     ## we will get the launch=1 passed in a little more.
  132:     &Apache::loncommon::no_cache($r);
  133:     ## 
  134:     ## Pick up form fields passed in the links.
  135:     ##
  136:     &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
  137:              ['catalogmode','launch','acts','mode','form','element','pause',
  138:               'phase','persistent_db_id','table','start','show',
  139:               'cleargroupsort','titleelement','area','inhibitmenu']);
  140:     ##
  141:     ## The following is a trick - we wait a few seconds if asked to so
  142:     ##     the daemon running the search can get ahead of the daemon
  143:     ##     printing the results.  We only need (theoretically) to do
  144:     ##     this once, so the pause indicator is deleted
  145:     ##
  146:     if (exists($env{'form.pause'})) {
  147:         Time::HiRes::sleep(0.1);
  148:         delete($env{'form.pause'});
  149:     }
  150:     ##
  151:     ## Initialize global variables
  152:     ##
  153:     my $domain  = $r->dir_config('lonDefDomain');
  154:     my $temp_file_dir = LONCAPA::tempdir();
  155:     $diropendb= $temp_file_dir .
  156:         "$env{'user.domain'}_$env{'user.name'}_sel_res.db";
  157:     #
  158:     # set the name of the persistent database
  159:     #          $env{'form.persistent_db_id'} can only have digits in it.
  160:     if (! exists($env{'form.persistent_db_id'}) ||
  161:         ($env{'form.persistent_db_id'} =~ /\D/) ||
  162:         ($env{'form.launch'} eq '1')) {
  163:         $env{'form.persistent_db_id'} = time;
  164:     }
  165: 
  166:     my $persistent_db_file = $temp_file_dir .
  167:         &escape($domain).
  168:             '_'.&escape($env{'user.name'}).
  169:                 '_'.$env{'form.persistent_db_id'}.'_persistent_search.db';
  170:     ##
  171:     &Apache::lonhtmlcommon::clear_breadcrumbs();
  172: 
  173:     my @allowed_searches = ('portfolio');
  174:     if (&Apache::lonnet::allowed('bre',$env{'request.role.domain'}) eq 'F') {
  175:         push(@allowed_searches,'res');
  176:     } 
  177:     my $crumb_text = 'Portfolio Search';
  178:     if (@allowed_searches ==2) {
  179:        $crumb_text = 'Portfolio and Catalog Search'; 
  180:     }
  181:     &Apache::lonhtmlcommon::add_breadcrumb
  182:        ({href=>'/adm/searchcat?'.
  183: 	       &Apache::loncommon::inhibit_menu_check().
  184:                '&catalogmode='.$env{'form.catalogmode'}.
  185:                '&launch='.$env{'form.launch'}.
  186:                '&mode='.$env{'form.mode'},
  187:               text=>"$crumb_text",
  188:               target=>'_top',
  189:               bug=>'Searching',});
  190:     #
  191:     if ($env{'form.phase'} !~ m/(basic|adv|course)_search/) {
  192:         if (! &get_persistent_form_data($persistent_db_file)) {
  193:             if ($env{'form.phase'} =~ /(run_search|results)/) {
  194:                 &Apache::lonnet::logthis('lonsearchcat:'.
  195:                                          'Unable to recover data from '.
  196:                                          $persistent_db_file);
  197:                 my $msg =
  198:                     &mt('We were unable to retrieve data describing your search.').
  199:                     ' '.&mt('This is a serious error and has been logged.').
  200:                     '<br />'.
  201:                     &mt('Please alert your LON-CAPA administrator.');
  202:                 &Apache::loncommon::simple_error_page(
  203:                     $r,'Search Error',
  204:                     $msg,
  205:                     {'no_auto_mt_msg' => 1});
  206: 		return OK;
  207:             }
  208:         }
  209:     } else {
  210:         &clean_up_environment();
  211:     }
  212:     ##
  213:     ## Clear out old values from groupsearch database
  214:     ##
  215:     untie %groupsearch_db if (tied(%groupsearch_db));
  216:     if (($env{'form.cleargroupsort'} eq '1') || 
  217:         (($env{'form.launch'} eq '1') && 
  218:          ($env{'form.catalogmode'} eq 'import'))) {
  219: 	if (tie(%groupsearch_db,'GDBM_File',$diropendb,&GDBM_WRCREAT(),0640)) {
  220: 	    &start_fresh_session();
  221: 	    untie %groupsearch_db;
  222:             delete($env{'form.cleargroupsort'});
  223: 	} else {
  224:             # This is a stupid error to give to the user.  
  225:             # It really tells them nothing.
  226: 	    my $msg = 'Unable to tie hash to db file.';
  227: 	    &Apache::loncommon::simple_error_page($r,'Search Error',
  228: 						  $msg);
  229: 	    return OK;
  230: 	}
  231:     }
  232:     ##
  233:     ## Configure hidden fields
  234:     ##
  235:     $hidden_fields = '<input type="hidden" name="persistent_db_id" value="'.
  236:         $env{'form.persistent_db_id'}.'" />'."\n";
  237:     if (exists($env{'form.catalogmode'})) {
  238:         $hidden_fields .= &hidden_field('catalogmode');
  239:     }
  240:     if (exists($env{'form.form'})) {
  241:         $hidden_fields .= &hidden_field('form');
  242:     }
  243:     if (exists($env{'form.element'})) {
  244:         $hidden_fields .= &hidden_field('element');
  245:     }
  246:     if (exists($env{'form.titleelement'})) {
  247:         $hidden_fields .= &hidden_field('titleelement');
  248:     }
  249:     if (exists($env{'form.mode'})) {
  250:         $hidden_fields .= &hidden_field('mode');
  251:     }
  252:     if (exists($env{'form.area'})) {
  253:         $hidden_fields .= &hidden_field('area');
  254:     }
  255:     if (exists($env{'form.inhibitmenu'})) {
  256:         $hidden_fields .= &hidden_field('inhibitmenu');
  257:     }
  258:     ##
  259:     ## Configure dynamic components of interface
  260:     ##
  261:     if ($env{'form.catalogmode'} eq 'interactive') {
  262:         $closebutton="<input type='button' name='close' value='".&mt('Close')."' ";
  263:         if ($env{'form.phase'} =~ /(results|run_search)/) {
  264:             $closebutton .="onclick='parent.close()'";
  265:         } else {
  266:             $closebutton .="onclick='self.close()'";
  267:         }
  268:         $closebutton .=" />\n";
  269:     } elsif ($env{'form.catalogmode'} eq 'import') {
  270:         $closebutton="<input type='button' name='close' value='".&mt('Close')."' ";
  271:         if ($env{'form.phase'} =~ /(results|run_search)/) {
  272:             $closebutton .="onclick='parent.close()'";
  273:         } else {
  274:             $closebutton .="onclick='self.close()'";
  275:         }
  276:         $closebutton .= " />";
  277:         my $txt_import = &mt('IMPORT');
  278:         $importbutton=<<END;
  279: <input type='button' name='import' value='$txt_import'
  280: onclick='javascript:select_group()' />
  281: END
  282:     } else {
  283:         $closebutton = '';
  284:         $importbutton = '';
  285:     }
  286:     ##
  287:     ## Sanity checks on form elements
  288:     ##
  289:     if (!defined($env{'form.viewselect'})) {
  290: 	$env{'form.viewselect'} ="summary";
  291:     }
  292:     $env{'form.phase'} = 'disp_basic' if (! exists($env{'form.phase'}));
  293:     $env{'form.show'} = 20 if (! exists($env{'form.show'}));
  294:     #
  295:     $env{'form.searchmode'} = 'basic' if (! exists($env{'form.searchmode'}));
  296:     if ($env{'form.phase'} eq 'adv_search' ||
  297:         $env{'form.phase'} eq 'disp_adv') {
  298:         $env{'form.searchmode'} = 'advanced';
  299:     }
  300:     #
  301:     if ($env{'form.searchmode'} eq 'advanced') {
  302:         my $srchtype = 'Catalog';
  303:         if ($env{'form.area'} eq 'portfolio') {
  304:             $srchtype = 'Portfolio';
  305:         }
  306:         &Apache::lonhtmlcommon::add_breadcrumb
  307:             ({href=>'/adm/searchcat?'.&Apache::loncommon::inhibit_menu_check().
  308:                   '&amp;phase=disp_adv'.
  309:                   '&amp;catalogmode='.$env{'form.catalogmode'}.
  310:                   '&amp;launch='.$env{'form.launch'}.
  311:                   '&amp;mode='.$env{'form.mode'},
  312:                   text=>"Advanced $srchtype Search",
  313:                   bug=>'Searching',});
  314:     } 
  315:     ##
  316:     ## Switch on the phase
  317:     ##
  318:     if ($env{'form.phase'} eq 'disp_basic') {
  319:         &print_basic_search_form($r,$closebutton,$hidden_fields);
  320:     } elsif ($env{'form.phase'} eq 'disp_adv') {
  321:         &print_advanced_search_form($r,$closebutton,$hidden_fields);
  322:     } elsif ($env{'form.phase'} eq 'results') {
  323:         &display_results($r,$importbutton,$closebutton,$diropendb,
  324:                          $env{'form.area'});
  325:     } elsif ($env{'form.phase'} =~ /^(sort|run_search)$/) {
  326:         my ($query,$customquery,$customshow,$libraries,$pretty_string,$domainsref) =
  327:             &get_persistent_data($persistent_db_file,
  328:                  ['query','customquery','customshow',
  329:                   'libraries','pretty_string','domains']);
  330:         if ($env{'form.phase'} eq 'sort') {
  331:             &print_sort_form($r,$pretty_string);
  332:         } elsif ($env{'form.phase'} eq 'run_search') {
  333:             &run_search($r,$query,$customquery,$customshow,
  334:                         $libraries,$pretty_string,$env{'form.area'},$domainsref);
  335:         }
  336:     } elsif(($env{'form.phase'} eq 'basic_search') ||
  337:             ($env{'form.phase'} eq 'adv_search')) {
  338:         #
  339:         # We are running a search, try to parse it
  340:         my ($query,$customquery,$customshow,$libraries,$domains) = 
  341:             (undef,undef,undef,undef,undef);
  342:         my $pretty_string;
  343:         if ($env{'form.phase'} eq 'basic_search') {
  344:             ($query,$pretty_string,$libraries,$domains) = 
  345:                 &parse_basic_search($r,$closebutton,$hidden_fields);
  346:             return OK if (! defined($query));
  347:             &make_persistent({ basicexp => $env{'form.basicexp'}},
  348:                              $persistent_db_file);
  349:         } else {                      # Advanced search
  350:             ($query,$customquery,$customshow,$libraries,$pretty_string,$domains) 
  351:                 = &parse_advanced_search($r,$closebutton,$hidden_fields);
  352:             return OK if (! defined($query));
  353:         }
  354:         &make_persistent({ query => $query,
  355:                            customquery => $customquery,
  356:                            customshow => $customshow,
  357:                            libraries => $libraries,
  358:                            pretty_string => $pretty_string,
  359:                            domains => $domains },
  360:                          $persistent_db_file);
  361:         #
  362:         # Set up table
  363:         if (! defined(&create_results_table($env{'form.area'}))) {
  364: 	    my $errorstring=&Apache::lonmysql::get_error();
  365:             &Apache::lonnet::logthis('lonsearchcat.pm: Unable to create '.
  366:                                      'needed table.  lonmysql error:'.
  367:                                      $errorstring);
  368: 
  369: 	    my $msg = 
  370: 		'Unable to create table in which to save search results. '.
  371: 		'The search has been aborted.';
  372: 	    &Apache::loncommon::simple_error_page($r,'Search Error',
  373: 						  $msg);
  374: 	    return OK;
  375:         }
  376:         delete($env{'form.launch'});
  377:         if (! &make_form_data_persistent($r,$persistent_db_file)) {
  378: 	    my $msg=
  379: 		'Unable to properly save search information. '.
  380: 		'The search has been aborted.';
  381: 	    &Apache::loncommon::simple_error_page($r,'Search Error',
  382: 						  $msg);
  383: 	    return OK;
  384: 	}
  385:         ##
  386:         ## Print out the frames interface
  387:         ##
  388:         if (defined($query)) {
  389:             &print_frames_interface($r);
  390:         }
  391:     }
  392:     return OK;
  393: } 
  394: 
  395: #
  396: # The mechanism used to store values away and retrieve them does not
  397: # handle the case of missing environment variables being significant.
  398: #
  399: # This routine sets non existant checkbox form elements to ''.
  400: #
  401: sub clean_up_environment {
  402:     if ($env{'form.phase'} eq 'basic_search') {
  403:         if (! exists($env{'form.related'})) {
  404:             $env{'form.related'} = '';
  405:         }
  406:         if (! exists($env{'form.domains'})) {
  407:             $env{'form.domains'} = '';
  408:         }
  409:     } elsif ($env{'form.phase'} eq 'adv_search') {
  410:         foreach my $field ('title','keywords','notes',
  411:                            'abstract','standards','mime') {
  412:             if (! exists($env{'form.'.$field.'_related'})) {
  413:                 $env{'form.'.$field.'_related'} = '';
  414:             }
  415:         }
  416:     } elsif ($env{'form.phase'} eq 'course_search') {
  417:         if (! exists($env{'form.crsrelated'})) {
  418:             $env{'form.crsrelated'} = '';
  419:         }
  420:     }
  421: }
  422: 
  423: sub hidden_field {
  424:     my ($name,$value) = @_;
  425:     if (! defined($value)) {
  426:         $value = $env{'form.'.$name};
  427:     }
  428:     return '<input type="hidden" name="'.$name.'" value="'.$value.'" />'.$/;
  429: }
  430: 
  431: ######################################################################
  432: 
  433: =pod
  434: 
  435: =over 4
  436:  
  437: =item &print_basic_search_form() 
  438: 
  439: Prints the form for the basic search.  Sorry the name is so cryptic.
  440: 
  441: =cut
  442: 
  443: ######################################################################
  444: ######################################################################
  445: sub print_basic_search_form {
  446:     my ($r,$closebutton,$hidden_fields) = @_;
  447:     my $result = ($env{'form.catalogmode'} ne 'import');
  448:     my $bread_crumb =
  449:         &Apache::lonhtmlcommon::breadcrumbs('Searching','Search_Basic',
  450: 					    $env{'form.catalogmode'} ne 'import');
  451:     my $scrout = &Apache::loncommon::start_page('Content Library').$bread_crumb;
  452: # Search form for resource space 
  453:     if (&Apache::lonnet::allowed('bre',$env{'request.role.domain'}) eq 'F') {
  454:         $scrout .= &setup_basic_search($r,'res',$hidden_fields,$closebutton);
  455:         $scrout .= '<hr /><br />';
  456:     }
  457: # Search form for accessible portfolio files
  458:     $scrout.= &setup_basic_search($r,'portfolio',$hidden_fields,$closebutton);
  459:     $scrout .= &Apache::loncommon::end_page();
  460:     $r->print($scrout);
  461:     return;
  462: }
  463: 
  464: sub setup_basic_search {
  465:     my ($r,$area,$hidden_fields,$closebutton) = @_;
  466:     # Define interface components
  467:     my %lt = &Apache::lonlocal::texthash (
  468:                               res => 'LON-CAPA Catalog Search',
  469:                               portfolio => 'Portfolio Search',
  470:     );
  471:     my ($userelatedwords,$onlysearchdomain,$inclext,$adv_search_link,$scrout);
  472: 
  473:     $userelatedwords = '<label>'
  474:                       .&Apache::lonhtmlcommon::checkbox(
  475:                            'related',
  476:                            $env{'form.related'},
  477:                            'related')
  478:                       .' '
  479:                      .&mt('use related words')
  480:                      .'</label>';
  481: 
  482:     $onlysearchdomain = '<label>'
  483:                        .&Apache::lonhtmlcommon::checkbox(
  484:                            'domains',
  485:                            $env{'form.domains'},
  486:                            $r->dir_config('lonDefDomain'))
  487:                        .' '
  488:                        .&mt('only search domain [_1]'
  489:                                ,'<b>'.$r->dir_config('lonDefDomain').'</b>')
  490:                        .'</label>';
  491: 
  492:     $adv_search_link = '<a href="/adm/searchcat?'.
  493: 	               &Apache::loncommon::inhibit_menu_check().
  494: 		       '&amp;phase=disp_adv'.
  495:                        '&amp;catalogmode='.$env{'form.catalogmode'}.
  496:                        '&amp;launch='.$env{'form.launch'}.
  497:                        '&amp;mode='.$env{'form.mode'}.
  498:                        '&amp;area='.$area.
  499:                        '&amp;form='.$env{'form.form'}.
  500:                        '&amp;titleelement='.$env{'form.titleelement'}.
  501:                        '&amp;element='.$env{'form.element'}.
  502:                        '">'.&mt('Advanced Search').'</a>';
  503:     #
  504:     $scrout.='<form name="loncapa_search" method="post" '.
  505:              'action="/adm/searchcat">'.
  506:              '<input type="hidden" name="phase" value="basic_search" />'.
  507:              $hidden_fields;
  508:              if (!exists($env{'form.area'})) {
  509:                  $scrout .= '<input type="hidden" name="area" value="'.$area.'" />';
  510:              }
  511:     #
  512:     $scrout .= '<div align="center">'.$/;
  513: #    if ($env{'request.course.id'}) {
  514:         $scrout .= '<h1>'.$lt{$area}.'</h1>';
  515: #    } else {
  516:         # No need to tell them they are searching
  517: #        $scrout.= ('<br />'x2);
  518: #    }
  519:     $scrout.='<table>'.
  520:              '<tr><td align="center" valign="top">'.
  521:              &Apache::lonhtmlcommon::textbox('basicexp',
  522:                                              $env{'form.basicexp'},50).
  523:              '<br />'.
  524:             '<span class="LC_fontsize_small">'.&searchhelp().'</span>'.'</td>'.
  525:             '<td>'.
  526:             '<span class="LC_nobreak">'.('&nbsp;'x3).$adv_search_link.'</span>'.'<br />'.
  527:             '<span class="LC_nobreak">'.('&nbsp;'x1).$userelatedwords.'</span>'.'<br />'.
  528:             '<span class="LC_nobreak">'.('&nbsp;'x1).$onlysearchdomain.'</span>'.'<br />'.
  529:             '<span class="LC_nobreak">'.('&nbsp;'x1).$inclext.'</span>'.'<br />'.
  530:              '</td>'.
  531:             '</tr>'.
  532:             '</table>'.$/;
  533:     #
  534:     $scrout .= '<p>'
  535:               .&viewoptions()
  536:               .'</p>'
  537:               .'<p>'
  538:               .'<input type="submit" name="basicsubmit" '
  539:               .'value="'.&mt('Search').'" />'
  540:               .' '
  541:               .$closebutton
  542:               .'</p>';
  543:     #
  544:     $scrout .= '</div>'.'</form>';
  545:     return $scrout;
  546: } 
  547: 
  548: ######################################################################
  549: ######################################################################
  550: 
  551: =pod 
  552: 
  553: =item &advanced_search_form() 
  554: 
  555: Prints the advanced search form.
  556: 
  557: =cut
  558: 
  559: ######################################################################
  560: ######################################################################
  561: sub print_advanced_search_form{
  562:     my ($r,$closebutton,$hidden_fields) = @_;
  563:     my $bread_crumb = 
  564:         &Apache::lonhtmlcommon::breadcrumbs('Searching','Search_Advanced',
  565: 					    $env{'form.catalogmode'} ne 'import');
  566:     my %lt=&Apache::lonlocal::texthash('srch' => 'Search',
  567: 				       'reset' => 'Reset',
  568: 				       'help' => 'Help');
  569:     my $advanced_buttons=<<"END";
  570: <p>
  571: <input type="submit" name="advancedsubmit" value='$lt{"srch"}' />
  572: <input type="reset" name="reset" value='$lt{"reset"}' />
  573: $closebutton
  574: </p>
  575: END
  576:     my $srchtype = 'Catalog';
  577:     my $jscript;
  578:     if ($env{'form.area'} eq 'portfolio') {
  579:         $srchtype = 'Portfolio';
  580:         $jscript = '<script type="text/javascript">
  581: // <![CDATA[
  582: function additional_metadata() {
  583:     if (document.advsearch.newfield.checked) {
  584:         document.advsearch.phase.value = "disp_adv";
  585:         document.advsearch.numaddedfields.value = parseInt(document.advsearch.numaddedfields.value) +1;
  586:         document.advsearch.submit();
  587:     }
  588: }
  589: // ]]>
  590: </script>';
  591:     }
  592:     my $scrout= &Apache::loncommon::start_page("Advanced $srchtype Search",
  593:                                                $jscript);
  594:     $scrout .= $bread_crumb;
  595: 
  596:     $scrout .= '<form method="post" action="/adm/searchcat" name="advsearch">'
  597:               .$hidden_fields 
  598:               .'<input type="hidden" name="phase" value="adv_search" />';
  599: 
  600:     $scrout .= '<fieldset>'."\n"
  601:               .'<legend>'.&mt('Display Options').'</legend>'."\n"
  602:               .&viewoptions()
  603:               .'</fieldset>';
  604: 
  605:     $scrout .= $advanced_buttons;
  606: 
  607:     $scrout .= &Apache::lonhtmlcommon::start_pick_box();
  608: 
  609:     my %fields=&Apache::lonmeta::fieldnames();
  610: 
  611:     # Standard Metadata
  612:     $scrout .= &Apache::lonhtmlcommon::row_headline()
  613:               .'<h3>'.&mt("Standard $srchtype Metadata").'</h3>'
  614:               .&searchhelp()
  615:               .&Apache::lonhtmlcommon::row_closure();
  616:     my %related_word_search = 
  617:         ('title'    => 1,
  618:          'author'   => 0,
  619:          'owner'    => 0,
  620:          'authorspace'  => 0,
  621:          'modifyinguser'=> 0,
  622:          'keywords' => 1,
  623:          'notes'    => 1,
  624:          'abstract' => 1,
  625:          'standards'=> 1,
  626:          'mime'     => 1,
  627:          'subject'  => 1,
  628:          );
  629:     #
  630:     foreach my $field ('title','author','subject','owner','authorspace',
  631:                        'modifyinguser','keywords','notes','abstract',
  632:                        'standards','mime') {
  633:         $scrout .= &Apache::lonhtmlcommon::row_title(&titlefield($fields{$field}))
  634:                   .&Apache::lonmeta::prettyinput($field,
  635:                                           $env{'form.'.$field},
  636:                                           $field,
  637:                                           'advsearch',
  638:                                           $related_word_search{$field},
  639:                                           '',
  640:                                           $env{'form.'.$field.'_related'},
  641:                                           50);
  642:         if ($related_word_search{$field}) {
  643:             $scrout .= &mt('related words');
  644:         } else {
  645:             $scrout .= '';
  646:         }
  647:         $scrout .= &Apache::lonhtmlcommon::row_closure();
  648:     }
  649:     foreach my $field ('lowestgradelevel','highestgradelevel') {
  650:         $scrout .= &Apache::lonhtmlcommon::row_title(&titlefield($fields{$field}))
  651:                   .&Apache::lonmeta::prettyinput($field,
  652:                                           $env{'form.'.$field},
  653:                                           $field,
  654:                                           'advsearch',
  655:                                           0)
  656:                   .&Apache::lonhtmlcommon::row_closure();
  657:     }
  658: 
  659:     $scrout .= &Apache::lonhtmlcommon::row_title(&titlefield(&mt('MIME Type Category')))
  660:               .&Apache::loncommon::filecategoryselect('category',
  661:                    $env{'form.category'})
  662:               .&Apache::lonhtmlcommon::row_closure();
  663: 
  664:     $scrout .= &Apache::lonhtmlcommon::row_title(&titlefield(&mt('Domains')))
  665:               .&Apache::loncommon::domain_select('domains',
  666:                    $env{'form.domains'},1)
  667:               .&Apache::lonhtmlcommon::row_closure();
  668: 
  669:     # Misc metadata
  670:     if ($env{'form.area'} ne 'portfolio') {
  671:         $scrout .= &Apache::lonhtmlcommon::row_title(&titlefield(&mt('Copyright/Distribution')))
  672:                   .&Apache::lonmeta::selectbox('copyright',
  673:                                              $env{'form.copyright'},
  674:                                 \&Apache::loncommon::copyrightdescription,
  675:                                        ( undef,
  676:                                         &Apache::loncommon::copyrightids)
  677:                                 )
  678:                   .&Apache::lonhtmlcommon::row_closure();
  679:     }
  680: 
  681:     $scrout .= &Apache::lonhtmlcommon::row_title(&titlefield(&mt('Language')))
  682:               .&Apache::lonmeta::selectbox('language',
  683:                                     $env{'form.language'},
  684:                                     \&Apache::loncommon::languagedescription,
  685:                                     ('any',&Apache::loncommon::languageids)
  686:                                     )
  687:               .&Apache::lonhtmlcommon::row_closure();
  688:     
  689:     # Portfolio Metadata
  690:     if ($env{'form.area'} eq 'portfolio') {
  691:         # Added fields
  692:         my $curnumadd = $env{'form.numaddedfields'};
  693:         if ($curnumadd eq '') {
  694:             $curnumadd = 1;
  695:         }
  696:         $scrout .= &Apache::lonhtmlcommon::row_headline()
  697:                   .'<h3>'.&mt('Custom Metadata fields').'</h3>'
  698:                   .&Apache::lonhtmlcommon::row_closure()
  699:                   .&Apache::lonhtmlcommon::row_title('')
  700:                   .&mt('Field Name').' | '.&mt('Field Value(s)')
  701:                   .&Apache::lonhtmlcommon::row_closure();
  702: 
  703:         for (my $j=0; $j<$curnumadd; $j++) {
  704:             my $num = $j+1;
  705:             $scrout .= &Apache::lonhtmlcommon::row_title(&mt('Custom metadata [_1]',$num))
  706:                       .'<input type="text"'
  707:                       .' name="addedfield_'.$j.'" size="10"'
  708:                       .' value="'.$env{'form.addedfield_'.$j}.'" />'
  709:                       .' '
  710:                       .'<input type="text" '
  711:                       .'name="addedvalues_'.$j.'" size="15"'
  712:                       .' value="'.$env{'form.addedvalues_'.$j}.'" />'
  713:                       .&Apache::lonhtmlcommon::row_closure();
  714:         }
  715:         $scrout .= &Apache::lonhtmlcommon::row_title('')
  716:                   .'<label>'
  717:                   .'<input type="checkbox" name="newfield"'
  718:                   .' value="1" onclick="javascript:additional_metadata()" />'
  719:                   .&mt('Another custom field/value pair?').'</label>'
  720:                   .'<input type="hidden" name="numaddedfields"'
  721:                   .' value="'.$curnumadd.'" />'
  722:                   .&Apache::lonhtmlcommon::row_closure();
  723: } else {
  724:         #
  725:         # Dynamic metadata
  726:         $scrout .= &Apache::lonhtmlcommon::row_headline()
  727:                   .'<h3>'.&mt('Problem Statistics').'</h3>'
  728:                   .&Apache::lonhtmlcommon::row_closure();
  729:         $scrout .= &Apache::lonhtmlcommon::row_title('')
  730:                   .&mt('Minimum').' | '.&mt('Maximum')
  731:                   .&Apache::lonhtmlcommon::row_closure();
  732:         foreach my $statistic 
  733:             ({ name=>'count',
  734:                description=>'Network-wide number of accesses (hits)',},
  735:              { name=>'stdno',
  736:                description=>
  737:                'Statistics calculated for number of students',},
  738:              { name => 'avetries',
  739:                description=>'Average number of tries till solved',},
  740:              { name => 'difficulty',
  741:                description=>'Degree of difficulty',},
  742:              { name => 'disc',
  743:                description=>'Degree of discrimination'}) {
  744:               $scrout .= &Apache::lonhtmlcommon::row_title(&titlefield(&mt($statistic->{'description'})))
  745:                         .'<input type="text" name="'.$statistic->{'name'}
  746:                         .'_min" value="" size="6" />'
  747:                         .' '
  748:                         .'<input type="text" name="'.$statistic->{'name'}
  749:                         .'_max" value="" size="6" />'
  750:                         .&Apache::lonhtmlcommon::row_closure();
  751:         }
  752: 
  753:         $scrout .= &Apache::lonhtmlcommon::row_headline()
  754:                   .'<h3>'.&mt('Evaluation Data').'</h3>'
  755:                   .&Apache::lonhtmlcommon::row_closure();
  756:         $scrout .= &Apache::lonhtmlcommon::row_title('')
  757:                   .&mt('Minimum').' | '.&mt('Maximum')
  758:                   .&Apache::lonhtmlcommon::row_closure();
  759:         foreach my $evaluation
  760:             ( { name => 'clear',
  761:                 description => 'Material presented in clear way'},
  762:               { name =>'depth',
  763:                 description => 'Material covered with sufficient depth'},
  764:               { name => 'helpful',
  765:                 description => 'Material is helpful'},
  766:               { name => 'correct',
  767:                 description => 'Material appears to be correct'},
  768:               { name => 'technical',
  769:                 description => 'Resource is technically correct'}){
  770:             $scrout .= &Apache::lonhtmlcommon::row_title(&titlefield(&mt($evaluation->{'description'})))
  771:                       .'<input type="text" name="'
  772:                       .$evaluation->{'name'}.'_min" value="" size="6" />'
  773:                       .' '
  774:                       .'<input type="text" name="'
  775:                       .$evaluation->{'name'}.'_max" value="" size="6" />'
  776:                       .&Apache::lonhtmlcommon::row_closure();
  777:         }
  778:     }
  779:     #
  780:     # Creation/Modification date limits
  781:     $scrout .= &Apache::lonhtmlcommon::row_headline()
  782:               .'<h3>'.&mt('Creation and Modification dates').'</h3>'
  783:               .&Apache::lonhtmlcommon::row_closure();
  784:     $scrout .= &Apache::lonhtmlcommon::row_title('')
  785:               .&mt('Month[_1]Day[_2]Year','&nbsp;'x14,'&nbsp;'x6)
  786:               .&Apache::lonhtmlcommon::row_closure();
  787: 
  788:     my $cafter = 
  789:         &Apache::lonhtmlcommon::date_setter('advsearch',         # formname
  790:                                             'creationdate1', # fieldname
  791:                                             0,           # current value
  792:                                             '',          # special 
  793:                                             1,           # includeempty
  794:                                             '',          # state
  795:                                             1,           # no_hh_mm_ss
  796:                                             );
  797:     my $cbefore = 
  798:         &Apache::lonhtmlcommon::date_setter('advsearch',         # formname
  799:                                             'creationdate2', # fieldname
  800:                                             0,           # current value
  801:                                             '',          # special 
  802:                                             1,           # includeempty
  803:                                             '',          # state
  804:                                             1,           # no_hh_mm_ss
  805:                                             );
  806:     $scrout .= &Apache::lonhtmlcommon::row_title(&mt('Created between'))
  807:               .$cafter
  808:               .&Apache::lonhtmlcommon::row_closure(1)
  809:               .&Apache::lonhtmlcommon::row_title(&mt('and'))
  810:               .$cbefore
  811:               .&Apache::lonhtmlcommon::row_closure();
  812: 
  813:     my $lafter = 
  814:         &Apache::lonhtmlcommon::date_setter('advsearch',
  815:                                             'revisiondate1', 
  816:                                             0,           # current value
  817:                                             '',          # special 
  818:                                             1,           # includeempty
  819:                                             '',          # state
  820:                                             1,           # no_hh_mm_ss
  821:                                             );
  822:     my $lbefore = 
  823:         &Apache::lonhtmlcommon::date_setter('advsearch',
  824:                                             'revisiondate2',
  825:                                             0,           # current value
  826:                                             '',          # special 
  827:                                             1,           # includeempty
  828:                                             '',          # state
  829:                                             1,           # no_hh_mm_ss
  830:                                             );
  831:     $scrout .= &Apache::lonhtmlcommon::row_title(&mt('Last modified between'))
  832:               .$lafter
  833:               .&Apache::lonhtmlcommon::row_closure(1)
  834:               .&Apache::lonhtmlcommon::row_title(&mt('and'))
  835:               .$lbefore
  836:               .&Apache::lonhtmlcommon::row_closure(1); # Last row of total pick_box
  837: 
  838:     $scrout .= &Apache::lonhtmlcommon::end_pick_box();
  839: 
  840:     $scrout .= $advanced_buttons
  841:               .'</form>';
  842: 
  843:     $scrout .= &Apache::loncommon::end_page();
  844:     $r->print($scrout);
  845:     return;
  846: }
  847: 
  848: ######################################################################
  849: ######################################################################
  850: 
  851: =pod 
  852: 
  853: =item &titlefield()
  854: 
  855: Inputs: title text
  856: 
  857: Outputs: titletext with font wrapper
  858: 
  859: =cut
  860: 
  861: ######################################################################
  862: ######################################################################
  863: sub titlefield {
  864:     my $title=shift;
  865:     return $title;
  866: }
  867: 
  868: ######################################################################
  869: ######################################################################
  870: 
  871: =pod 
  872: 
  873: =item viewoptiontext()
  874: 
  875: Inputs: codename for view option
  876: 
  877: Outputs: displayed text
  878: 
  879: =cut
  880: 
  881: ######################################################################
  882: ######################################################################
  883: sub viewoptiontext {
  884:     my $code=shift;
  885:     my %desc=&Apache::lonlocal::texthash
  886:         ('detailed' => "Detailed Citation View",
  887:          'xml' => 'XML/SGML',
  888:          'compact' => 'Compact View',
  889:          'fielded' => 'Fielded Format',
  890:          'summary' => 'Summary View',
  891:          'summarypreview' => 'Summary Preview',
  892:          'detailedpreview' => 'Detailed Citation Preview');
  893:     return $desc{$code};
  894: }
  895: 
  896: ######################################################################
  897: ######################################################################
  898: 
  899: =pod 
  900: 
  901: =item viewoptions()
  902: 
  903: Inputs: none
  904: 
  905: Outputs: text for box with view options
  906: 
  907: =cut
  908: 
  909: ######################################################################
  910: ######################################################################
  911: sub viewoptions {
  912:     my $scrout;
  913:     if (! defined($env{'form.viewselect'})) { 
  914:         $env{'form.viewselect'}='detailed'; 
  915:     }
  916:     $scrout .= '<span class="LC_nobreak">'
  917:               .&mt('Type:').' '
  918:               .&Apache::lonmeta::selectbox('viewselect',
  919:                    $env{'form.viewselect'},
  920:                    \&viewoptiontext,
  921:                    sort(keys(%Views)))
  922:               .'</span>';
  923:     my $countselect = &Apache::lonmeta::selectbox('show',
  924:                                                   $env{'form.show'},
  925:                                                   undef,
  926:                                                   (10,20,50,100,1000,10000));
  927:     $scrout .= ' <span class="LC_nobreak">'
  928:               .&mt('Records per Page:').' '.$countselect
  929:               .'</span>'.$/;
  930:     return $scrout;
  931: }
  932: 
  933: ######################################################################
  934: ######################################################################
  935: 
  936: =pod 
  937: 
  938: =item searchhelp()
  939: 
  940: Inputs: none
  941: 
  942: Outputs: return little blurb on how to enter searches
  943: 
  944: =cut
  945: 
  946: ######################################################################
  947: ######################################################################
  948: sub searchhelp {
  949:     return &mt('Enter words and quoted phrases');
  950: }
  951: 
  952: ######################################################################
  953: ######################################################################
  954: 
  955: =pod 
  956: 
  957: =item &get_persistent_form_data()
  958: 
  959: Inputs: filename of database
  960: 
  961: Outputs: returns undef on database errors.
  962: 
  963: This function is the reverse of &make_persistent() for form data.
  964: Retrieve persistent data from %persistent_db.  Retrieved items will have their
  965: values unescaped.  If a form value already exists in $env, it will not be
  966: overwritten.  Form values that are array references may have values appended
  967: to them.
  968: 
  969: =cut
  970: 
  971: ######################################################################
  972: ######################################################################
  973: sub get_persistent_form_data {
  974:     my $filename = shift;
  975:     return 0 if (! -e $filename);
  976:     return undef if (! tie(%persistent_db,'GDBM_File',$filename,
  977:                            &GDBM_READER(),0640));
  978:     #
  979:     # These make sure we do not get array references printed out as 'values'.
  980:     my %arrays_allowed = ('form.domains'=>1);
  981:     #
  982:     # Loop through the keys, looking for 'form.'
  983:     foreach my $name (keys(%persistent_db)) {
  984:         next if ($name !~ /^form./);
  985:         # Kludgification begins!
  986:         if ($name eq 'form.domains' && 
  987:             $env{'form.searchmode'} eq 'basic' &&
  988:             $env{'form.phase'} ne 'disp_basic') {
  989:             next;
  990:         }
  991:         # End kludge (hopefully)
  992:         next if (exists($env{$name}));
  993:         my @values = map { 
  994:             &unescape($_);
  995:         } split(',',$persistent_db{$name});
  996:         next if (@values <1);
  997:         if ($arrays_allowed{$name}) {
  998:             $env{$name} = [@values];
  999:         } else {
 1000:             $env{$name} = $values[0] if ($values[0]);
 1001:         }
 1002:     }
 1003:     untie (%persistent_db);
 1004:     return 1;
 1005: }
 1006: 
 1007: ######################################################################
 1008: ######################################################################
 1009: 
 1010: =pod 
 1011: 
 1012: =item &get_persistent_data()
 1013: 
 1014: Inputs: filename of database, ref to array of values to recover.
 1015: 
 1016: Outputs: array of values.  Returns undef on error.
 1017: 
 1018: This function is the reverse of &make_persistent();
 1019: Retrieve persistent data from %persistent_db.  Retrieved items will have their
 1020: values unescaped.  If the item is 'domains; then the returned
 1021: value will be a hash pointer.  Otherwise, if the item contains
 1022: commas (before unescaping), the returned value will be an array pointer.
 1023: 
 1024: =cut
 1025: 
 1026: ######################################################################
 1027: ######################################################################
 1028: sub get_persistent_data {
 1029:     my $filename = shift;
 1030:     my @Vars = @{shift()};
 1031:     my @Values;   # Return array
 1032:     return undef if (! -e $filename);
 1033:     return undef if (! tie(%persistent_db,'GDBM_File',$filename,
 1034:                            &GDBM_READER(),0640));
 1035:     foreach my $name (@Vars) {
 1036:         if (! exists($persistent_db{$name})) {
 1037:             push @Values, undef;
 1038:             next;
 1039:         }
 1040:         if ($name eq 'domains') {
 1041:             my %valueshash;
 1042:             my @items= map { &unescape($_); } split(',',$persistent_db{$name});
 1043:             foreach my $item (@items) {
 1044:                 if ($item =~ /=/) {
 1045:                     my ($key,$val) = map { &unescape($_); } split(/=/,$item);
 1046:                     $valueshash{$key} = $val;
 1047:                 }
 1048:             }
 1049:             push(@Values,\%valueshash);
 1050:         } else {
 1051:             my @values = map { 
 1052:                 &unescape($_);
 1053:             } split(',',$persistent_db{$name});
 1054:             if (@values <= 1) {
 1055:                 push @Values,$values[0];
 1056:             } else {
 1057:                 push @Values,\@values;
 1058:             }
 1059:         }
 1060:     }
 1061:     untie (%persistent_db);
 1062:     return @Values;
 1063: }
 1064: 
 1065: ######################################################################
 1066: ######################################################################
 1067: 
 1068: =pod 
 1069: 
 1070: =item &make_persistent() 
 1071: 
 1072: Inputs: Hash of values to save, filename of persistent database.
 1073: 
 1074: Store variables away to the %persistent_db.
 1075: Values will be escaped.  Values that are array pointers will have their
 1076: elements escaped and concatenated in a comma separated string. Values 
 1077: that are hash pointers will have their keys and values escaped and 
 1078: concatenated in a comma separated string.
 1079: 
 1080: =cut
 1081: 
 1082: ######################################################################
 1083: ######################################################################
 1084: sub make_persistent {
 1085:     my %save = %{shift()};
 1086:     my $filename = shift;
 1087:     return undef if (! tie(%persistent_db,'GDBM_File',
 1088:                            $filename,&GDBM_WRCREAT(),0640));
 1089:     foreach my $name (keys(%save)) {
 1090:         my @values=();
 1091:         if (ref($save{$name}) eq 'ARRAY') {
 1092:             @values = @{$save{$name}};
 1093:         } elsif (ref($save{$name}) eq 'HASH') {
 1094:             foreach my $key (%{$save{$name}}) {
 1095:                 push(@values,&escape($key).'='.&escape($save{$name}{$key}));
 1096:             }
 1097:         } else {
 1098:             @values = $save{$name};
 1099:         }
 1100:         # We handle array and hash references, but not recursively.
 1101:         my $store = join(',', map { &escape($_); } @values );
 1102:         $persistent_db{$name} = $store;
 1103:     }
 1104:     untie(%persistent_db);
 1105:     return 1;
 1106: }
 1107: 
 1108: ######################################################################
 1109: ######################################################################
 1110: 
 1111: =pod 
 1112: 
 1113: =item &make_form_data_persistent() 
 1114: 
 1115: Inputs: filename of persistent database.
 1116: 
 1117: Store most form variables away to the %persistent_db.
 1118: Values will be escaped.  Values that are array pointers will have their
 1119: elements escaped and concatenated in a comma separated string.  
 1120: 
 1121: =cut
 1122: 
 1123: ######################################################################
 1124: ######################################################################
 1125: sub make_form_data_persistent {
 1126:     my $r = shift;
 1127:     my $filename = shift;
 1128:     my %save;
 1129:     foreach (keys(%env)) {
 1130:         next if (!/^form/ || /submit/);
 1131:         $save{$_} = $env{$_};
 1132:     }
 1133:     return &make_persistent(\%save,$filename);
 1134: }
 1135: 
 1136: ######################################################################
 1137: ######################################################################
 1138: 
 1139: =pod 
 1140: 
 1141: =item &parse_advanced_search()
 1142: 
 1143: Parse advanced search form and return the following:
 1144: 
 1145: =over 4
 1146: 
 1147: =item $query Scalar containing an SQL query.
 1148: 
 1149: =item $customquery Scalar containing a custom query.
 1150: 
 1151: =item $customshow Scalar containing commands to show custom metadata.
 1152: 
 1153: =item $libraries_to_query Reference to array of domains to search.
 1154: 
 1155: =back
 1156: 
 1157: =cut
 1158: 
 1159: ######################################################################
 1160: ######################################################################
 1161: sub parse_advanced_search {
 1162:     my ($r,$closebutton,$hidden_fields)=@_;
 1163:     my @BasicFields = ('title','author','subject','keywords','url','version',
 1164:                        'notes','abstract','extension','owner','authorspace',
 1165: #                       'custommetadata','customshow',
 1166:                        'modifyinguser','standards','mime');
 1167:     my @StatsFields = &statfields();
 1168:     my @EvalFields = &evalfields();
 1169:     my $fillflag=0;
 1170:     my $pretty_search_string = "";
 1171:     # Clean up fields for safety
 1172:     for my $field (@BasicFields,
 1173:                    'creationdatestart_month','creationdatestart_day',
 1174: 		   'creationdatestart_year','creationdateend_month',
 1175: 		   'creationdateend_day','creationdateend_year',
 1176: 		   'lastrevisiondatestart_month','lastrevisiondatestart_day',
 1177: 		   'lastrevisiondatestart_year','lastrevisiondateend_month',
 1178: 		   'lastrevisiondateend_day','lastrevisiondateend_year') {
 1179: 	$env{'form.'.$field}=~s/[^\w\/\s\(\)\=\-\"\'.\*]//g;
 1180:     }
 1181:     foreach ('mode','form','element') {
 1182: 	# is this required?  Hmmm.
 1183: 	next if (! exists($env{'form.'.$_}));
 1184: 	$env{'form.'.$_}=&unescape($env{'form.'.$_});
 1185: 	$env{'form.'.$_}=~s/[^\w\/\s\(\)\=\-\"\']//g;
 1186:     }
 1187:     # Preprocess the category form element.
 1188:     $env{'form.category'} = 'any' if (! defined($env{'form.category'}) ||
 1189:                                       ref($env{'form.category'}));
 1190:     #
 1191:     # Check to see if enough information was filled in
 1192:     foreach my $field (@BasicFields) {
 1193: 	if (&filled($env{'form.'.$field})) {
 1194: 	    $fillflag++;
 1195: 	}
 1196:     }
 1197:     foreach my $field (@StatsFields,@EvalFields) {
 1198:         if (&filled($env{'form.'.$field.'_max'})) {
 1199:             $fillflag++;
 1200:         }
 1201:         if (&filled($env{'form.'.$field.'_min'})) {
 1202:             $fillflag++;
 1203:         }
 1204:     }
 1205: 
 1206:     for my $field ('lowestgradelevel','highestgradelevel') {
 1207:         if ( $env{'form.'.$field} =~ /^\d+$/ &&
 1208:              $env{'form.'.$field} > 0) {
 1209:             $fillflag++;
 1210:         }
 1211:     }
 1212:     if ($env{'form.area'} eq 'portfolio') {
 1213:         # Added metadata fields
 1214:         for (my $i=0; $i<$env{'form.numaddedfields'} ; $i++) {
 1215:             my $field = $env{'form.addedfield_'.$i};
 1216:             $field =~ s/^\s*(\S*)\s*$/$1/;
 1217:             $field =~ s/\W/_/g;
 1218:             if ($field ne '') {
 1219:                 $fillflag++;
 1220:             }
 1221:         }
 1222:     }
 1223:     if (! $fillflag) {
 1224: 	&output_blank_field_error($r,$closebutton,
 1225:                                   'phase=disp_adv',$hidden_fields);
 1226: 	return ;
 1227:     }
 1228:     # Turn the form input into a SQL-based query
 1229:     my $query='';
 1230:     my @queries;
 1231:     my $font = '<font color="#800000" face="helvetica">';
 1232:     # Evaluate logical expression AND/OR/NOT phrase fields.
 1233:     foreach my $field (@BasicFields) {
 1234: 	next if (!defined($env{'form.'.$field}) || $env{'form.'.$field} eq '');
 1235:         my ($error,$SQLQuery) = 
 1236:             &process_phrase_input($env{'form.'.$field},
 1237:                                   $env{'form.'.$field.'_related'},$field);
 1238:         if (defined($error)) {
 1239:             &output_unparsed_phrase_error($r,$closebutton,'phase=disp_adv',
 1240:                                          $hidden_fields,$field);
 1241:             return;
 1242:         } else {
 1243:             $pretty_search_string .= 
 1244:                 $font.$field.'</font>: '.$env{'form.'.$field};
 1245:             if ($env{'form.'.$field.'_related'}) {
 1246:                 my @Words = 
 1247:                     &Apache::loncommon::get_related_words
 1248:                     ($env{'form.'.$field});
 1249:                 if (@Words) {
 1250:                     $pretty_search_string.= ' with related words: '.
 1251:                         join(', ',@Words[0..4]);
 1252:                 } else {
 1253:                     $pretty_search_string.= ' with related words.';
 1254:                 }
 1255:             }
 1256:             $pretty_search_string .= '<br />';
 1257:             push (@queries,$SQLQuery);
 1258:         }
 1259:     }
 1260:     #
 1261:     # Make the 'mime' from 'form.category' and 'form.extension'
 1262:     #
 1263:     my $searchphrase;
 1264:     if (exists($env{'form.category'})    && 
 1265:         $env{'form.category'} !~ /^\s*$/ &&
 1266:         $env{'form.category'} ne 'any')     {
 1267:         my @extensions = &Apache::loncommon::filecategorytypes
 1268:                                                    ($env{'form.category'});
 1269:         if (scalar(@extensions) > 0) {
 1270:             $searchphrase = join(' OR ',@extensions);
 1271:         }
 1272:     }
 1273:     if (defined($searchphrase)) {
 1274:         my ($error,$SQLsearch) = &process_phrase_input($searchphrase,0,'mime');
 1275:         push @queries,$SQLsearch;
 1276:         $pretty_search_string .=$font.'mime</font> contains <b>'.
 1277:             $searchphrase.'</b><br />';
 1278:     }
 1279:     #
 1280:     # Evaluate option lists
 1281:     if ($env{'form.lowestgradelevel'}        &&
 1282:         $env{'form.lowestgradelevel'} ne '0' &&
 1283:         $env{'form.lowestgradelevel'} =~ /^\d+$/) {
 1284: 	push(@queries,
 1285:              '(lowestgradelevel>='.$env{'form.lowestgradelevel'}.')');
 1286:         $pretty_search_string.="lowestgradelevel>=".
 1287:             $env{'form.lowestgradelevel'}."<br />\n";
 1288:     }
 1289:     if ($env{'form.highestgradelevel'}        &&
 1290:         $env{'form.highestgradelevel'} ne '0' &&
 1291:         $env{'form.highestgradelevel'} =~ /^\d+$/) {
 1292: 	push(@queries,
 1293:              '(highestgradelevel<='.$env{'form.highestgradelevel'}.')');
 1294:         $pretty_search_string.="highestgradelevel<=".
 1295:             $env{'form.highestgradelevel'}."<br />\n";
 1296:     }
 1297:     if ($env{'form.language'} and $env{'form.language'} ne 'any') {
 1298: 	push @queries,"(language like \"$env{'form.language'}\")";
 1299:         $pretty_search_string.=$font."language</font>= ".
 1300:             &Apache::loncommon::languagedescription($env{'form.language'}).
 1301:                 "<br />\n";
 1302:     }
 1303:     if ($env{'form.copyright'} and $env{'form.copyright'} ne 'any') {
 1304: 	push @queries,"(copyright like \"$env{'form.copyright'}\")";
 1305:         $pretty_search_string.=$font."copyright</font> = ".
 1306:             &Apache::loncommon::copyrightdescription($env{'form.copyright'}).
 1307:                 "<br />\n";
 1308:     }
 1309:     if ($env{'form.area'} eq 'portfolio') {
 1310:         #
 1311:         # Added metadata fields
 1312:         for (my $i=0; $i<$env{'form.numaddedfields'} ; $i++) {
 1313:             my $field = $env{'form.addedfield_'.$i};
 1314:             $field =~ s/^\s*(\S*)\s*$/$1/;
 1315:             $field =~ s/\W/_/g;
 1316:             $field =~ tr/A-Z/a-z/; 
 1317:             if ($field ne '') {
 1318:                 my $value = $env{'form.addedvalues_'.$i};
 1319:                 if ($value ne '') {
 1320:                     $value =~ s/'/''/g; #' stupid emacs
 1321:                     my ($error,$query) = 
 1322:                         &process_phrase_input($value,0,'pf.value');
 1323:                     if (!defined($error)) {
 1324:                         push(@queries,"pf.field = '$field' AND $query");
 1325:                         $pretty_search_string .=
 1326:                             $font.$field.'</font>: '.
 1327:                             $env{'form.addedvalues_'.$i}.'<br />';
 1328:                     }
 1329:                 } else {
 1330:                     push(@queries,"pf.field = '$field' AND pf.value IS NULL");
 1331:                 }
 1332:             }
 1333:         }
 1334:     } else {
 1335:         #
 1336:         # Statistics
 1337:         foreach my $field (@StatsFields,@EvalFields) {
 1338:             my ($min,$max);
 1339:             if (exists($env{'form.'.$field.'_min'}) && 
 1340:                 $env{'form.'.$field.'_min'} ne '') {
 1341:                 $min = $env{'form.'.$field.'_min'};
 1342:             }
 1343:             if (exists($env{'form.'.$field.'_max'}) &&
 1344:                 $env{'form.'.$field.'_max'} ne '') {
 1345:                 $max = $env{'form.'.$field.'_max'};
 1346:             }
 1347:             next if (! defined($max) && ! defined($min));
 1348:             if (defined($min) && defined($max)) {
 1349:                 ($min,$max) = sort {$a <=>$b} ($min,$max);
 1350:             }
 1351:             if (defined($min) && $min =~ /^(\d+\.\d+|\d+|\.\d+)$/) {
 1352:                 push(@queries,'('.$field.'>'.$min.')');
 1353:                 $pretty_search_string.=$font.$field.'</font>&gt;'.$min.'<br />';
 1354:             }
 1355:             if (defined($max) && $max =~ /^(\d+\.\d+|\d+|\.\d+)$/) {
 1356:                 push(@queries,'('.$field.'<'.$max.')');
 1357:                 $pretty_search_string.=$font.$field.'</font>&lt;'.$max.'<br />';
 1358:             }
 1359:         }
 1360:     }
 1361:     #
 1362:     # Evaluate date windows
 1363:     my $cafter =
 1364:         &Apache::lonhtmlcommon::get_date_from_form('creationdate1');
 1365:     my $cbefore = 
 1366:         &Apache::lonhtmlcommon::get_date_from_form('creationdate2');
 1367:     if ($cafter > $cbefore) {
 1368:         my $tmp = $cafter;
 1369:         $cafter = $cbefore;
 1370:         $cbefore = $tmp;
 1371:     }
 1372:     my $mafter = 
 1373:         &Apache::lonhtmlcommon::get_date_from_form('revisiondate1');
 1374:     my $mbefore =
 1375:         &Apache::lonhtmlcommon::get_date_from_form('revisiondate2');
 1376:     if ($mafter > $mbefore) {
 1377:         my $tmp = $mafter;
 1378:         $mafter = $mbefore;
 1379:         $mbefore = $tmp;
 1380:     }
 1381:     my ($datequery,$error,$prettydate)=&build_date_queries($cafter,$cbefore,
 1382:                                                            $mafter,$mbefore);
 1383:     if (defined($error)) {
 1384:         &output_date_error($r,$error,$closebutton,$hidden_fields);
 1385:     } elsif (defined($datequery)) {
 1386:         # Here is where you would set up pretty_search_string to output
 1387:         # date query information.
 1388:         $pretty_search_string .= '<br />'.$prettydate.'<br />';
 1389: 	push @queries,$datequery;
 1390:     }
 1391:     #
 1392:     # Process form information for custom metadata querying
 1393:     my $customquery=undef;
 1394:     ##
 1395:     ## The custom metadata search was removed q long time ago mostly 
 1396:     ## because I was unable to figureout exactly how it worked and could
 1397:     ## not imagine people actually using it.  MH
 1398:     ##
 1399:     # if ($env{'form.custommetadata'}) {
 1400:     #    $pretty_search_string .=$font."Custom Metadata Search</font>: <b>".
 1401:     #    $env{'form.custommetadata'}."</b><br />\n";
 1402:     #    $customquery=&build_custommetadata_query('custommetadata',
 1403:     #                                             $env{'form.custommetadata'});
 1404:     # }
 1405:     my $customshow=undef;
 1406:     # if ($env{'form.customshow'}) {
 1407:     # $pretty_search_string .=$font."Custom Metadata Display</font>: <b>".
 1408:     #                         $env{'form.customshow'}."</b><br />\n";
 1409:     #    $customshow=$env{'form.customshow'};
 1410:     #    $customshow=~s/[^\w\s]//g;
 1411:     #    my @fields=split(/\s+/,$customshow);
 1412:     #    $customshow=join(" ",@fields);
 1413:     # }
 1414:     ##
 1415:     ## Deal with restrictions to given domains
 1416:     ## 
 1417:     my ($libraries_to_query,$pretty_domains_string,$domains_to_query) = 
 1418:         &parse_domain_restrictions();
 1419:     if ($pretty_domains_string) {
 1420:        $pretty_search_string .= $pretty_domains_string."<br />\n";
 1421:     }
 1422:     #
 1423:     if (@queries) {
 1424:         if ($env{'form.area'} eq 'portfolio') {
 1425:             $query ="SELECT pm.*,pa.keynum,pa.scope FROM portfolio_metadata pm, portfolio_access pa, portfolio_addedfields pf WHERE (pm.url = pa.url AND pf.url = pm.url AND (pa.start < UTC_TIMESTAMP() AND (pa.end IS NULL OR pa.end > UTC_TIMESTAMP())) AND (".join(') AND (',@queries).'))';
 1426:         } else {
 1427: 	    $query="SELECT * FROM metadata WHERE (".join(") AND (",@queries).')';
 1428:         }
 1429:     } elsif ($customquery) {
 1430:         $query = '';
 1431:     }
 1432:     #&Apache::lonnet::logthis('advanced query = '.$/.$query);
 1433:     return ($query,$customquery,$customshow,$libraries_to_query,
 1434:             $pretty_search_string,$domains_to_query);
 1435: }
 1436: 
 1437: sub parse_domain_restrictions {
 1438:     my $libraries_to_query = undef;
 1439:     my $domains_to_query = undef;
 1440:     # $env{'form.domains'} can be either a scalar or an array reference.
 1441:     # We need an array.
 1442:     if (! exists($env{'form.domains'}) || $env{'form.domains'} eq '') {
 1443:         return (undef,'',undef);
 1444:     }
 1445:     my @allowed_domains = &Apache::loncommon::get_env_multiple('form.domains');
 1446:     #
 1447:     my %domain_hash = ();
 1448:     my $pretty_domains_string;
 1449:     foreach (@allowed_domains) {
 1450:         $domain_hash{$_}++;
 1451:     }
 1452:     if ($domain_hash{'any'}) {
 1453:         $pretty_domains_string = &mt("in all LON-CAPA domains.");
 1454:     } else {
 1455:         if (@allowed_domains > 1) {
 1456:             $pretty_domains_string = &mt("in LON-CAPA domains:");
 1457:         } else {
 1458:             $pretty_domains_string = &mt("in LON-CAPA domain ");
 1459:         }
 1460:         foreach (sort @allowed_domains) {
 1461:             $pretty_domains_string .= "<b>".$_."</b> ";
 1462:         }
 1463: 	my %library_servers = &Apache::lonnet::get_unique_servers(\@allowed_domains,
 1464: 						                  'library');
 1465:         my (%older_library_servers,%okdoms,%domains_for_id);
 1466:         map { $okdoms{$_} = 1; } @allowed_domains;
 1467:         foreach my $key (keys(%library_servers)) {
 1468:             if (&Apache::lonnet::get_server_loncaparev('',$key) =~ /^\'?(\d+)\.(\d+)/) {
 1469:                 my $major = $1;
 1470:                 my $minor = $2;
 1471:                 if (($major < 2) || (($major == 2) && ($minor < 11))) {
 1472:                     map { $older_library_servers{$_} = 1; }
 1473:                         &Apache::lonnet::machine_ids($library_servers{$key});
 1474:                 } else {
 1475:                     my %possdoms;
 1476:                     map { $possdoms{$_}=1 if ($okdoms{$_}); }
 1477:                         &Apache::lonnet::machine_domains($library_servers{$key});
 1478:                     $domains_for_id{$key} = join(',',sort(keys(%possdoms)));
 1479:                 }
 1480:             }
 1481:         }
 1482:         my %servers = (%library_servers,%older_library_servers);
 1483: 	$libraries_to_query = [keys(%servers)];
 1484:         $domains_to_query = \%domains_for_id;
 1485:     }
 1486:     return ($libraries_to_query,
 1487:             $pretty_domains_string,
 1488:             $domains_to_query);
 1489: }
 1490: 
 1491: ######################################################################
 1492: ######################################################################
 1493: 
 1494: =pod 
 1495: 
 1496: =item &parse_basic_search() 
 1497: 
 1498: Parse the basic search form and return a scalar containing an sql query.
 1499: 
 1500: =cut
 1501: 
 1502: ######################################################################
 1503: ######################################################################
 1504: sub parse_basic_search {
 1505:     my ($r,$closebutton)=@_;
 1506:     #
 1507:     # Clean up fields for safety
 1508:     for my $field ('basicexp') {
 1509: 	$env{"form.$field"}=~s/[^\w\s\'\"\!\(\)\-\*]//g;
 1510:     }
 1511:     foreach ('mode','form','element') {
 1512: 	# is this required?  Hmmm.
 1513: 	next unless (exists($env{"form.$_"}));
 1514: 	$env{"form.$_"}=&unescape($env{"form.$_"});
 1515: 	$env{"form.$_"}=~s/[^\w\/\s\(\)\=\-\"\']//g;
 1516:     }
 1517:     my ($libraries_to_query,$pretty_domains_string,$domains_to_query) = 
 1518:         &parse_domain_restrictions();
 1519:     #
 1520:     # Check to see if enough of a query is filled in
 1521:     my $search_string = $env{'form.basicexp'};
 1522:     if (! &filled($search_string)) {
 1523: 	&output_blank_field_error($r,$closebutton,'phase=disp_basic');
 1524: 	return OK;
 1525:     }
 1526:     my $pretty_search_string=$search_string;
 1527:     my @Queries;
 1528:     my @fields = ('title','author','subject','notes','abstract','keywords');
 1529:     my $searchfield;
 1530:     if ($env{'form.area'} eq 'portfolio') {
 1531:         $searchfield = 'concat_ws(" ",pm.'.join(',pm.',@fields).')';
 1532:     } else {
 1533:         $searchfield = 'concat_ws(" ",'.join(',',@fields).')';
 1534:     }
 1535:     my ($error,$SQLQuery) = &process_phrase_input($search_string,
 1536:                                                     $env{'form.related'},
 1537:                                                     $searchfield);
 1538:     if ($error) {
 1539:         &output_unparsed_phrase_error($r,$closebutton,'phase=disp_basic',
 1540:                                       '','basicexp');
 1541:         return;
 1542:     }
 1543:     push(@Queries,$SQLQuery);
 1544:     #foreach my $q (@Queries) {
 1545:     #    &Apache::lonnet::logthis('    '.$q);
 1546:     #}
 1547:     my $final_query;
 1548:     if ($env{'form.area'} eq 'portfolio') {
 1549:         $final_query = 'SELECT pm.*,pa.keynum,pa.scope FROM portfolio_metadata pm, portfolio_access pa  WHERE (pm.url = pa.url AND (pa.start < UTC_TIMESTAMP() AND (pa.end IS NULL OR pa.end > UTC_TIMESTAMP())) AND '.join(" AND ",@Queries).')';
 1550:     } else {
 1551:         $final_query = 'SELECT * FROM metadata WHERE '.join(" AND ",@Queries);
 1552:     }
 1553:     #
 1554:     if ($env{'form.related'}) {
 1555: 	$pretty_search_string.=' '.&mt('(including related words)');
 1556:     }
 1557:     if (defined($pretty_domains_string) && $pretty_domains_string ne '') {
 1558:         $pretty_search_string .= ' '.$pretty_domains_string;
 1559:     }
 1560:     $pretty_search_string .= "<br />\n";
 1561:     $pretty_search_string =~ s:^<br /> and ::;
 1562:     &Apache::lonnet::logthis('simple search final query = '.$/.$final_query);
 1563:     return ($final_query,$pretty_search_string,
 1564:             $libraries_to_query,$domains_to_query);
 1565: }
 1566: 
 1567: 
 1568: ###############################################################
 1569: ###############################################################
 1570: 
 1571: my @Phrases;
 1572: 
 1573: sub concat {
 1574:     my ($item) = @_;
 1575:     my $results = '';
 1576:     foreach (@$item) {
 1577:         if (ref($_) eq 'ARRAY') {
 1578:             $results .= join(' ',@$_);
 1579:         }
 1580:     }
 1581:     return $results;
 1582: }
 1583: 
 1584: sub process_phrase_input {
 1585:     my ($phrase,$related,$field)=@_;
 1586:     #&Apache::lonnet::logthis('phrase = :'.$phrase.':');
 1587:     my $grammar = <<'ENDGRAMMAR';
 1588:     searchphrase:
 1589:         expression /^\Z/ {
 1590:             # &Apache::lonsearchcat::print_item(\@item,0);
 1591:             [@item];
 1592:         }
 1593:     expression:
 1594:         phrase(s)   {
 1595:             [@item];
 1596:         }
 1597:     phrase:
 1598:         orword {
 1599:             [@item];
 1600:         }
 1601:       | andword {
 1602:             [@item];
 1603:         }
 1604:       | minusword {
 1605:             unshift(@::Phrases,$item[1]->[0]);
 1606:             unshift(@::Phrases,$item[1]->[1]);
 1607:             [@item];
 1608:         }
 1609:       | word {
 1610:             unshift(@::Phrases,$item[1]);
 1611:             [@item];
 1612:         } 
 1613:     #
 1614:     orword:
 1615:         word 'OR' phrase {
 1616:             unshift(@::Phrases,'OR');
 1617:             unshift(@::Phrases,$item[1]);
 1618:             [@item];
 1619:         }
 1620:         | word 'or' phrase {
 1621:             unshift(@::Phrases,'OR');
 1622:             unshift(@::Phrases,$item[1]);
 1623:             [@item];
 1624:         }    
 1625:         | minusword 'OR' phrase {
 1626:             unshift(@::Phrases,'OR');
 1627:             unshift(@::Phrases,$item[1]->[0]);
 1628:             unshift(@::Phrases,$item[1]->[1]);
 1629:             [@item];
 1630:         }
 1631:         | minusword 'or' phrase {
 1632:             unshift(@::Phrases,'OR');
 1633:             unshift(@::Phrases,$item[1]->[0]);
 1634:             unshift(@::Phrases,$item[1]->[1]);
 1635:             [@item];
 1636:         }    
 1637:     andword:
 1638:         word phrase {
 1639:             unshift(@::Phrases,'AND');
 1640:             unshift(@::Phrases,$item[1]);
 1641:             [@item];
 1642:         }
 1643:         | minusword phrase {
 1644:             unshift(@::Phrases,'AND');
 1645:             unshift(@::Phrases,$item[1]->[0]);
 1646:             unshift(@::Phrases,$item[1]->[1]);
 1647:             [@item];
 1648:         }
 1649:     #
 1650:     minusword:
 1651:         '-' word {
 1652:             [$item[2],'NOT'];
 1653:         }
 1654:     word:
 1655:         "'" term(s) "'" {
 1656:           &Apache::lonsearchcat::concat(\@item);
 1657:         }
 1658:       | '"' term(s) '"' {
 1659:           &Apache::lonsearchcat::concat(\@item);
 1660:         }
 1661:       | term {
 1662:             $item[1];
 1663:         }
 1664:     term:
 1665:         /[\w\Q:!@#$%^&*()+_=|{}<>,.;\\\/?\E\-]+/ {
 1666:             $item[1];
 1667:         }
 1668: ENDGRAMMAR
 1669:     #
 1670:     # The end result of parsing the phrase with the grammar is an array
 1671:     # @::Phrases.
 1672:     # $phrase = "gene splicing" or cat -> "gene splicing","OR","cat"
 1673:     # $phrase = "genetic engineering" -dna ->
 1674:     #                      "genetic engineering","AND","NOT","dna"
 1675:     # $phrase = cat or dog -poodle -> "cat","OR","dog","AND","NOT","poodle"
 1676:     undef(@::Phrases);
 1677:     my $p = new Parse::RecDescent($grammar);
 1678:     if (! defined($p->searchphrase($phrase))) {
 1679:         &Apache::lonnet::logthis('lonsearchcat:unable to process:'.$phrase);
 1680:         return 'Unable to process phrase '.$phrase;
 1681:     }
 1682:     #
 1683:     # Go through the phrases and make sense of them.  
 1684:     # Apply modifiers NOT OR and AND to the phrases.
 1685:     my @NewPhrases;
 1686:     while(@::Phrases) {
 1687:         my $phrase = shift(@::Phrases);
 1688:         # &Apache::lonnet::logthis('phrase = '.$phrase);
 1689:         my $phrasedata;
 1690:         if ($phrase =~ /^(NOT|OR|AND)$/) {
 1691:             if ($phrase eq 'OR') {
 1692:                 $phrasedata->{'or'}++;
 1693:                 if (! @::Phrases) { $phrasedata = undef; last; }
 1694:                 $phrase = shift(@::Phrases);
 1695:             } elsif ($phrase eq 'AND') {
 1696:                 $phrasedata->{'and'}++;
 1697:                 if (! @::Phrases) { $phrasedata = undef; last; }
 1698:                 $phrase = shift(@::Phrases);
 1699:             }
 1700:             if ($phrase eq 'NOT') {
 1701:                 $phrasedata->{'negate'}++;
 1702:                 if (! @::Phrases) { $phrasedata = undef; last; }
 1703:                 $phrase = shift(@::Phrases);
 1704:             }
 1705:         }
 1706:         $phrasedata->{'phrase'} = $phrase;
 1707:         if ($related) {
 1708:             my @NewWords;
 1709:             (undef,@NewWords) = &related_version($phrasedata->{'phrase'});
 1710:             $phrasedata->{'related_words'} = \@NewWords;
 1711:         }
 1712:         push(@NewPhrases,$phrasedata);
 1713:     }
 1714:     #
 1715:     # Actually build the sql query from the phrases
 1716:     my $SQLQuery;
 1717:     foreach my $phrase (@NewPhrases) {
 1718:         my $query;
 1719:         if ($phrase->{'negate'}) {
 1720:             $query .= $field.' NOT LIKE "%'.$phrase->{'phrase'}.'%"';
 1721:         } else {
 1722:             $query .= $field.' LIKE "%'.$phrase->{'phrase'}.'%"';
 1723:         }
 1724:         foreach my $related (@{$phrase->{'related_words'}}) {
 1725:             if ($phrase->{'negate'}) {
 1726:                 $query .= ' AND '.$field.' NOT LIKE "%'.$related.'%"';
 1727:             } else {
 1728:                 $query .= ' OR '.$field.' LIKE "%'.$related.'%"';
 1729:             }
 1730:         }
 1731:         if ($SQLQuery) {
 1732:             if ($phrase->{'or'}) {
 1733:                 $SQLQuery .= ' OR ('.$query.')';
 1734:             } else {
 1735:                 $SQLQuery .= ' AND ('.$query.')';
 1736:             }
 1737:         } else {
 1738:             $SQLQuery = '('.$query.')';
 1739:         }
 1740:     }
 1741:     #
 1742:     # &Apache::lonnet::logthis("SQLQuery = $SQLQuery");
 1743:     #
 1744:     return undef,$SQLQuery;
 1745: }
 1746: 
 1747: ######################################################################
 1748: ######################################################################
 1749: 
 1750: =pod 
 1751: 
 1752: =item &related_version()
 1753: 
 1754: Modifies an input string to include related words.  Words in the string
 1755: are replaced with parenthesized lists of 'OR'd words.  For example
 1756: "torque" is replaced with "(torque OR word1 OR word2 OR ...)".  
 1757: 
 1758: Note: Using this twice on a string is probably silly.
 1759: 
 1760: =cut
 1761: 
 1762: ######################################################################
 1763: ######################################################################
 1764: sub related_version {
 1765:     my ($word) = @_;
 1766:     return (undef) if (lc($word) =~ /\b(or|and|not)\b/);
 1767:     my @Words = &Apache::loncommon::get_related_words($word);
 1768:     # Only use 4 related words
 1769:     @Words = ($#Words>4? @Words[0..4] : @Words);
 1770:     my $result = join " OR ", ($word,@Words);
 1771:     return $result,sort(@Words);
 1772: }
 1773: 
 1774: 
 1775: ######################################################################
 1776: ######################################################################
 1777: 
 1778: =pod 
 1779: 
 1780: =item &build_custommetadata_query() 
 1781: 
 1782: Constructs a custom metadata query using a rather heinous regular
 1783: expression.
 1784: 
 1785: =cut
 1786: 
 1787: ######################################################################
 1788: ######################################################################
 1789: sub build_custommetadata_query {
 1790:     my ($field_name,$logic_statement)=@_;
 1791:     my $q=new Text::Query('abc',
 1792: 			  -parse => 'Text::Query::ParseAdvanced',
 1793: 			  -build => 'Text::Query::BuildAdvancedString');
 1794:     $q->prepare($logic_statement);
 1795:     my $matchexp=${$q}{'-parse'}{'-build'}{'matchstring'};
 1796:     # quick fix to change literal into xml tag-matching
 1797:     # will eventually have to write a separate builder module
 1798:     # wordone=wordtwo becomes\<wordone\>[^\<] *wordtwo[^\<]*\<\/wordone\>
 1799:     $matchexp =~ s/(\w+)\\=([\w\\\+]+)?# wordone=wordtwo is changed to 
 1800:                  /\\<$1\\>?#           \<wordone\>
 1801:                    \[\^\\<\]?#        [^\<]         
 1802:                    \*$2\[\^\\<\]?#           *wordtwo[^\<]
 1803:                    \*\\<\\\/$1\\>?#                        *\<\/wordone\>
 1804:                    /g;
 1805:     return $matchexp;
 1806: }
 1807: 
 1808: 
 1809: ######################################################################
 1810: ######################################################################
 1811: 
 1812: =pod 
 1813: 
 1814: =item &build_date_queries() 
 1815: 
 1816: Builds a SQL logic query to check time/date entries.
 1817: Also reports errors (check for /^Incorrect/).
 1818: 
 1819: =cut
 1820: 
 1821: ######################################################################
 1822: ######################################################################
 1823: sub build_date_queries {
 1824:     my ($cafter,$cbefore,$mafter,$mbefore) = @_;
 1825:     my ($result,$error,$pretty_string);
 1826:     #
 1827:     # Verify the input
 1828:     if (! defined($cafter) && ! defined($cbefore) &&
 1829:         ! defined($mafter) && ! defined($mbefore)) {
 1830:         # This is an okay situation, so return undef for the error
 1831:         return (undef,undef,undef);
 1832:     }
 1833:     if ((defined($cafter)  && ! defined($cbefore)) ||
 1834:         (defined($cbefore) && ! defined($cafter))) {
 1835:         # This is bad, so let them know
 1836:         $error = &mt('Incorrect entry for the creation date. '.
 1837:                     'You must specify both the beginning and ending dates.');
 1838:     }
 1839:     if (! defined($error) && 
 1840:         ((defined($mafter)  && ! defined($mbefore)) ||
 1841:         (defined($mbefore) && ! defined($mafter)))) {
 1842:         # This is also bad, so let them know
 1843:         $error = &mt('Incorrect entry for the last revision date. '.
 1844:                      'You must specify both the beginning and ending dates.');
 1845:     }
 1846:     if (! defined($error)) {
 1847:         #
 1848:         # Build the queries
 1849:         my @queries;
 1850:         if (defined($cbefore) && defined($cafter)) {
 1851:             my (undef,undef,undef,$caday,$camon,$cayear) = localtime($cafter);
 1852:             my (undef,undef,undef,$cbday,$cbmon,$cbyear) = localtime($cbefore);
 1853:             # Correct for year being relative to 1900
 1854:             $cayear+=1900; $cbyear+=1900;
 1855:             my $cquery=
 1856:                 '(creationdate BETWEEN '.
 1857:                 "'".$cayear.'-'.$camon.'-'.$caday."'".
 1858:                 ' AND '.
 1859:                 "'".$cbyear.'-'.$cbmon.'-'.$cbday." 23:59:59')";
 1860:             $pretty_string .= '<br />' if (defined($pretty_string));
 1861:             $pretty_string .= 
 1862:                 &mt('created between [_1] and [_2]',
 1863:                     &Apache::lonlocal::locallocaltime($cafter),
 1864:                     &Apache::lonlocal::locallocaltime($cbefore+24*60*60-1));
 1865:             push(@queries,$cquery);
 1866:             $pretty_string =~ s/ 00:00:00//g;
 1867:         }
 1868:         if (defined($mbefore) && defined($mafter)) {
 1869:             my (undef,undef,undef,$maday,$mamon,$mayear) = localtime($mafter);
 1870:             my (undef,undef,undef,$mbday,$mbmon,$mbyear) = localtime($mbefore);
 1871:             # Correct for year being relative to 1900
 1872:             $mayear+=1900; $mbyear+=1900;
 1873:             my $mquery=
 1874:                 '(lastrevisiondate BETWEEN '.
 1875:                 "'".$mayear.'-'.$mamon.'-'.$maday."'".
 1876:                 ' AND '.
 1877:                 "'".$mbyear.'-'.$mbmon.'-'.$mbday." 23:59:59')";
 1878:             push(@queries,$mquery);
 1879:             $pretty_string .= '<br />' if (defined($pretty_string));
 1880:             $pretty_string .= 
 1881:                 &mt('last revised between [_1] and [_2]',
 1882:                     &Apache::lonlocal::locallocaltime($mafter),
 1883:                     &Apache::lonlocal::locallocaltime($mbefore+24*60*60-1));
 1884:             $pretty_string =~ s/ 00:00:00//g;
 1885:         }
 1886:         if (@queries) {
 1887:             $result .= join(" AND ",@queries);
 1888:         }
 1889:     }
 1890:     return ($result,$error,$pretty_string);
 1891: }
 1892: 
 1893: ######################################################################
 1894: ######################################################################
 1895: 
 1896: =pod
 1897: 
 1898: =item &copyright_check()
 1899: 
 1900: Inputs: $Metadata, a hash pointer of metadata for a resource.
 1901: 
 1902: Returns: 1 if the resource is available to the user making the query, 
 1903:          0 otherwise.
 1904: 
 1905: =cut
 1906: 
 1907: ######################################################################
 1908: ######################################################################
 1909: sub copyright_check {
 1910:     my $Metadata = shift;
 1911:     # Check copyright tags and skip results the user cannot use
 1912:     my (undef,undef,$resdom,$resname) = split('/',
 1913:                                               $Metadata->{'url'});
 1914:     # Check for priv
 1915:     if (($Metadata->{'copyright'} eq 'priv') && 
 1916:         (($env{'user.name'} ne $resname) &&
 1917:          ($env{'user.domain'} ne $resdom))) {
 1918:         return 0;
 1919:     }
 1920:     # Check for domain
 1921:     if (($Metadata->{'copyright'} eq 'domain') &&
 1922:         ($env{'user.domain'} ne $resdom)) {
 1923:         return 0;
 1924:     }
 1925:     # Check for custom rights
 1926:     if ($Metadata->{'copyright'} eq 'custom') {
 1927:        return &Apache::lonnet::customaccess('bre',$Metadata->{'url'});
 1928:     }
 1929:     return 1;
 1930: }
 1931: 
 1932: ######################################################################
 1933: ######################################################################
 1934: 
 1935: =pod
 1936: 
 1937: =item &ensure_db_and_table()
 1938: 
 1939: Ensure we can get lonmysql to connect to the database and the table we
 1940: need exists.
 1941: 
 1942: Inputs: $r, table id
 1943: 
 1944: Returns: undef on error, 1 if the table exists.
 1945: 
 1946: =cut
 1947: 
 1948: ######################################################################
 1949: ######################################################################
 1950: sub ensure_db_and_table {
 1951:     my ($r,$table) = @_;
 1952:     ##
 1953:     ## Sanity check the table id.
 1954:     ##
 1955:     if (! defined($table) || $table eq '' || $table =~ /\D/ ) {
 1956:         $r->print(&Apache::loncommon::start_page('Error')
 1957:                  .'<p class="LC_error">'
 1958:                  .&mt('Unable to retrieve search results. '
 1959:                      .'Unable to determine the table results were saved in.')
 1960:                  .'</p>'
 1961:                  . '<p>'.&mt('Internal info:').'</p>'
 1962:                  .'<pre>'.$table.'</pre>'
 1963:                  .&Apache::loncommon::end_page()
 1964:         );
 1965:         return undef;
 1966:     }
 1967:     ##
 1968:     ## Make sure we can connect and the table exists.
 1969:     ##
 1970:     my $connection_result = &Apache::lonmysql::connect_to_db();
 1971:     if (!defined($connection_result)) {
 1972:         $r->print(
 1973:             '<p class="LC_error">'
 1974:            .&mt('Unable to connect to the MySQL database where your results are saved.')
 1975:            .'</p>'
 1976:            .&Apache::loncommon::end_page()
 1977:         );
 1978:         &Apache::lonnet::logthis("lonsearchcat: unable to get lonmysql to".
 1979:                                  " connect to database.");
 1980:         &Apache::lonnet::logthis(&Apache::lonmysql::get_error());
 1981:         return undef;
 1982:     }
 1983:     my $table_check = &Apache::lonmysql::check_table($table);
 1984:     if (! defined($table_check)) {
 1985:         $r->print(
 1986:             '<p class="LC_error">'
 1987:            .&mt('A MySQL error has occurred.')
 1988:            .'</p></form>'
 1989:            .&Apache::loncommon::end_page());
 1990:         &Apache::lonnet::logthis("lonmysql was unable to determine the status".
 1991:                                  " of table ".$table);
 1992:         return undef;
 1993:     } elsif (! $table_check) {
 1994:         $r->print(
 1995:             '<p class="LC_error">'
 1996:            .&mt('The table of results could not be found.')
 1997:            .'</p>'
 1998:         );
 1999:         &Apache::lonnet::logthis("The user requested a table, ".$table.
 2000:                                  ", that could not be found.");
 2001:         return undef;
 2002:     }
 2003:     return 1;
 2004: }
 2005: 
 2006: ######################################################################
 2007: ######################################################################
 2008: 
 2009: =pod
 2010: 
 2011: =item &print_sort_form()
 2012: 
 2013: The sort feature is not implemented at this time.  This form just prints 
 2014: a link to change the search query.
 2015: 
 2016: =cut
 2017: 
 2018: ######################################################################
 2019: ######################################################################
 2020: sub print_sort_form {
 2021:     my ($r,$pretty_query_string) = @_;
 2022: 
 2023:     ##
 2024:     my %SortableFields=&Apache::lonlocal::texthash( 
 2025:          id        => 'Default',
 2026:          title     => 'Title',
 2027:          author    => 'Author',
 2028:          subject   => 'Subject',
 2029:          url       => 'URL',
 2030:          version   => 'Version Number',
 2031:          mime      => 'Mime type',
 2032:          lang      => 'Language',
 2033:          owner     => 'Owner/Publisher',
 2034:          copyright => 'Copyright',
 2035:          hostname  => 'Host',
 2036:          creationdate     => 'Creation Date',
 2037:          lastrevisiondate => 'Revision Date'
 2038:      );
 2039:     ##
 2040:     my $table = $env{'form.table'};
 2041:     return if (! &ensure_db_and_table($r,$table));
 2042:     ##
 2043:     ## Get the number of results 
 2044:     ##
 2045:     my $total_results = &Apache::lonmysql::number_of_rows($table);
 2046:     if (! defined($total_results)) {
 2047:         $r->print("A MySQL error has occurred.</form>".
 2048: 		  &Apache::loncommon::end_page());
 2049:         &Apache::lonnet::logthis("lonmysql was unable to determine the number".
 2050:                                  " of rows in table ".$table);
 2051:         &Apache::lonnet::logthis(&Apache::lonmysql::get_error());
 2052:         return;
 2053:     }
 2054:     # update results
 2055:     my $newloc = '/adm/searchcat?phase=results&persistent_db_id='.
 2056:         $env{'form.persistent_db_id'};
 2057:     my $js =<<END;
 2058: <script type="text/javascript">
 2059:     var frame = parent.resultsframe;
 2060:     var frameDoc = frame.document;
 2061:     if (frameDoc.readyState  == 'complete')
 2062:         frame.location = "$newloc";
 2063: </script>
 2064: END
 2065: 
 2066:     my $start_page = &Apache::loncommon::start_page('Results',$js);
 2067:     my $breadcrumbs=
 2068:         &Apache::lonhtmlcommon::breadcrumbs('Searching','Searching',
 2069: 					    $env{'form.catalogmode'} ne 'import');
 2070: 
 2071:     my $result = <<END;
 2072: $start_page
 2073: $breadcrumbs
 2074: <form name="statusform" action="" method="post" target="_top">
 2075: <input type="hidden" name="catalogmode" value="import" />
 2076: <input type="hidden" name="acts" value="" />
 2077: END
 2078: 
 2079: #<h2>Sort Results</h2>
 2080: #Sort by: <select size="1" name="sortby" onchange="javascript:change_sort();">
 2081: #    $env{'form.sortby'} = 'id' if (! defined($env{'form.sortby'}));
 2082: #    foreach (keys(%SortableFields)) {
 2083: #        $result.="<option name=\"$_\"";
 2084: #        if ($_ eq $env{'form.sortby'}) {
 2085: #            $result.=" selected ";
 2086: #        }
 2087: #        $result.=" >$SortableFields{$_}</option>\n";
 2088: #    }
 2089: #    $result.="</select>\n";
 2090:     my $revise = &revise_button();
 2091:     $result.='<p>'
 2092:             .&mt('Total of [quant,_1,match,matches] to your query.',$total_results)
 2093:             .' '.$revise.'</p>'
 2094:             .'<p>'.&mt('Search: ').$pretty_query_string
 2095:             .'</p></form>';
 2096:     $r->print($result.&Apache::loncommon::end_page());
 2097:     return;
 2098: }
 2099: 
 2100: #####################################################################
 2101: #####################################################################
 2102: 
 2103: =pod
 2104: 
 2105: =item MySQL Table Description
 2106: 
 2107: MySQL table creation requires a precise description of the data to be
 2108: stored.  The use of the correct types to hold data is vital to efficient
 2109: storage and quick retrieval of records.  The columns must be described in
 2110: the following format:
 2111: 
 2112: =cut
 2113: 
 2114: #####################################################################
 2115: #####################################################################
 2116: #
 2117: # These should probably be scoped but I don't have time right now...
 2118: #
 2119: my @Datatypes;
 2120: my @Fullindicies;
 2121:     
 2122: ######################################################################
 2123: ######################################################################
 2124: 
 2125: =pod
 2126: 
 2127: =item &create_results_table()
 2128: 
 2129: Creates the table of search results by calling lonmysql.  Stores the
 2130: table id in $env{'form.table'}
 2131: 
 2132: Inputs: search area - either res or portfolio 
 2133: 
 2134: Returns: the identifier of the table on success, undef on error.
 2135: 
 2136: =cut
 2137: 
 2138: ######################################################################
 2139: ######################################################################
 2140: sub set_up_table_structure {
 2141:     my ($tabletype) = @_;
 2142:     my ($datatypes,$fullindicies) = 
 2143:         &LONCAPA::lonmetadata::describe_metadata_storage($tabletype);
 2144:     # Copy the table description before modifying it...
 2145:     @Datatypes = @{$datatypes};
 2146:     unshift(@Datatypes,{name => 'id',  
 2147:         type => 'MEDIUMINT',
 2148:         restrictions => 'UNSIGNED NOT NULL',
 2149:         primary_key  => 'yes',
 2150:         auto_inc     => 'yes' });
 2151:     @Fullindicies = @{$fullindicies};
 2152:     return;
 2153: }
 2154: 
 2155: sub create_results_table {
 2156:     my ($area) = @_;
 2157:     if ($area eq 'portfolio') {
 2158:         &set_up_table_structure('portfolio_search');
 2159:     } else {
 2160:         &set_up_table_structure('metadata');
 2161:     }
 2162:     my $table = &Apache::lonmysql::create_table
 2163:         ( { columns => \@Datatypes,
 2164:             FULLTEXT => [{'columns' => \@Fullindicies},],
 2165:         } );
 2166:     if (defined($table)) {
 2167:         $env{'form.table'} = $table;
 2168:         return $table;
 2169:     } 
 2170:     return undef; # Error...
 2171: }
 2172: 
 2173: ######################################################################
 2174: ######################################################################
 2175: 
 2176: =pod
 2177: 
 2178: =item Search Status update functions
 2179: 
 2180: Each of the following functions changes the values of one of the
 2181: input fields used to display the search status to the user.  The names
 2182: should be explanatory.
 2183: 
 2184: Inputs: Apache request handler ($r), text to display.
 2185: 
 2186: Returns: Nothing.
 2187: 
 2188: =over 4
 2189: 
 2190: =item &update_count_status()
 2191: 
 2192: =item &update_status()
 2193: 
 2194: =item &update_seconds()
 2195: 
 2196: =back
 2197: 
 2198: =cut
 2199: 
 2200: ######################################################################
 2201: ######################################################################
 2202: sub update_count_status {
 2203:     my ($r,$text) = @_;
 2204:     $text =~ s/\'/\\\'/g;
 2205:     $r->print(<<SCRIPT);
 2206: <script type="text/javascript">
 2207: // <![CDATA[
 2208: document.statusform.count.value = ' $text'
 2209: // ]]>
 2210: </script>
 2211: SCRIPT
 2212: 
 2213:     $r->rflush();
 2214: }
 2215: 
 2216: sub update_status {
 2217:     my ($r,$text) = @_;
 2218:     $text =~ s/\'/\\\'/g;
 2219:     $r->print(<<SCRIPT);
 2220: <script type="text/javascript">
 2221: // <![CDATA[
 2222: document.statusform.status.value = ' $text'
 2223: // ]]>
 2224: </script>
 2225: SCRIPT
 2226: 
 2227:     $r->rflush();
 2228: }
 2229: 
 2230: sub reload_result_frame {
 2231:     my ($r) = @_;
 2232:     my $newloc = '/adm/searchcat?phase=results&persistent_db_id='.
 2233:         $env{'form.persistent_db_id'};
 2234:     $r->print(<<SCRIPT);
 2235: <script type="text/javascript">
 2236:     var frame = parent.resultsframe;
 2237:     var frameDoc = frame.document;
 2238:     if (frameDoc.readyState  == 'complete')
 2239:         frame.location = "$newloc";
 2240: </script>
 2241: SCRIPT
 2242: 
 2243:     $r->rflush();
 2244: }
 2245: 
 2246: {
 2247:     my $max_time  = 60;  # seconds for the search to complete
 2248:     my $start_time = 0;
 2249:     my $last_time = 0;
 2250: 
 2251: sub reset_timing {
 2252:     $start_time = 0;
 2253:     $last_time = 0;
 2254: }
 2255: 
 2256: sub time_left {
 2257:     if ($start_time == 0) {
 2258:         $start_time = time;
 2259:     }
 2260:     my $time_left = $max_time - (time - $start_time);
 2261:     $time_left = 0 if ($time_left < 0);
 2262:     return $time_left;
 2263: }
 2264: 
 2265: sub update_seconds {
 2266:     my ($r) = @_;
 2267:     my $time = &time_left();
 2268:     if (($last_time-$time) > 0) {
 2269:         $r->print(<<SCRIPT);
 2270: <script type="text/javascript">
 2271: // <![CDATA[
 2272: document.statusform.seconds.value = '$time'
 2273: // ]]>
 2274: </script>
 2275: SCRIPT
 2276: 
 2277:         $r->rflush();
 2278:     }
 2279:     $last_time = $time;
 2280: }
 2281: 
 2282: }
 2283: 
 2284: ######################################################################
 2285: ######################################################################
 2286: 
 2287: =pod
 2288: 
 2289: =item &revise_button()
 2290: 
 2291: Inputs: None
 2292: 
 2293: Returns: html string for a 'revise search' button.
 2294: 
 2295: =cut
 2296: 
 2297: ######################################################################
 2298: ######################################################################
 2299: sub revise_button {
 2300:     my $revisetext = &mt('Revise search');
 2301:     my $revise_phase = 'disp_basic';
 2302:     $revise_phase = 'disp_adv' if ($env{'form.searchmode'} eq 'advanced');
 2303:     my $newloc = '/adm/searchcat'.
 2304:         '?persistent_db_id='.$env{'form.persistent_db_id'}.
 2305:             '&amp;cleargroupsort=1'.
 2306:             '&amp;phase='.$revise_phase;
 2307:     my $result = qq{<input type="button" value="$revisetext" name="revise"} .
 2308:         qq{ onclick="parent.location='$newloc';" /> };
 2309:     return $result;
 2310: }
 2311: 
 2312: ######################################################################
 2313: ######################################################################
 2314: 
 2315: =pod
 2316: 
 2317: =item &run_search()
 2318: 
 2319: Executes a search query by sending it the the other servers and putting the
 2320: results into MySQL.
 2321: 
 2322: =cut
 2323: 
 2324: ######################################################################
 2325: ######################################################################
 2326: sub run_search {
 2327:     my ($r,$query,$customquery,$customshow,$serverlist,
 2328:         $pretty_string,$area,$domainsref) = @_;
 2329:     my $tabletype = 'metadata';
 2330:     if ($area eq 'portfolio') {
 2331:         $tabletype = 'portfolio_search';
 2332:     }
 2333:     my $connection = $r->connection;
 2334:     #
 2335:     # Print run_search header
 2336:     #
 2337:     my $start_page = &Apache::loncommon::start_page('Search Status',undef);
 2338:     my $breadcrumbs =
 2339: 	&Apache::lonhtmlcommon::breadcrumbs('Searching','Searching',
 2340: 					    $env{'form.catalogmode'} ne 'import');
 2341:     $r->print(<<END);
 2342: $start_page
 2343: $breadcrumbs
 2344: END
 2345:     # Remove leading and trailing <br />
 2346:     $pretty_string =~ s:^\s*<br />::i;
 2347:     $pretty_string =~ s:(<br />)*\s*$::im;
 2348:     my @Lines = split("<br />",$pretty_string);
 2349:     # I keep getting blank items at the end of the list, hence the following:
 2350:     while ($Lines[-1] =~ /^\s*$/ && @Lines) {
 2351:         pop(@Lines);
 2352:     }
 2353:     if (@Lines > 2) {
 2354:         $pretty_string = join '<br />',(@Lines[0..2],'...<br />');
 2355:     }
 2356:     $r->print(&mt("Search: [_1]",$pretty_string));
 2357:     $r->rflush();
 2358:     #
 2359:     # Determine the servers we need to contact.
 2360:     my (@Servers_to_contact,%domains_by_server);
 2361:     if (defined($serverlist)) {
 2362:         if (ref($serverlist) eq 'ARRAY') {
 2363:             @Servers_to_contact = @$serverlist;
 2364:         } else {
 2365:             @Servers_to_contact = ($serverlist);
 2366:         }
 2367:         if (ref($domainsref) eq 'HASH') {
 2368:             foreach my $server (@Servers_to_contact) {
 2369:                 $domains_by_server{$server} = $domainsref->{$server};
 2370:             }
 2371:         }
 2372:     } else {
 2373: 	my %library_servers = &Apache::lonnet::unique_library();
 2374:         my (%all_library_servers, %older_library_servers);
 2375:         foreach my $key (keys(%library_servers)) {
 2376:             if (&Apache::lonnet::get_server_loncaparev('',$key) =~ /^\'?(\d+)\.(\d+)/) {
 2377:                 my $major = $1;
 2378:                 my $minor = $2;
 2379:                 if (($major < 2) || (($major == 2) && ($minor < 11))) {
 2380:                     map { $older_library_servers{$_} = 1; }
 2381:                         &Apache::lonnet::machine_ids($library_servers{$key});
 2382:                 }
 2383:             }
 2384:         }
 2385:         %all_library_servers = (%library_servers,%older_library_servers);
 2386:         @Servers_to_contact = sort(keys(%all_library_servers));
 2387:         foreach my $server (@Servers_to_contact) {
 2388:             my %possdoms;
 2389:             map { $possdoms{$_}=1;  } &Apache::lonnet::machine_domains($all_library_servers{$server});
 2390:             $domains_by_server{$server} =
 2391:                 join(',',sort(&Apache::lonnet::machine_domains($all_library_servers{$server})));
 2392:         }
 2393:     }
 2394:     my %Server_status;
 2395:     #
 2396:     # Check on the mysql table we will use to store results.
 2397:     my $table =$env{'form.table'};
 2398:     if (! defined($table) || $table eq '' || $table =~ /\D/ ) {
 2399:         $r->print("Unable to determine table id to save search results in.".
 2400:                   "The search has been aborted.".
 2401: 		  &Apache::loncommon::end_page());
 2402:         return;
 2403:     }
 2404:     my $table_status = &Apache::lonmysql::check_table($table);
 2405:     if (! defined($table_status)) {
 2406:         $r->print("Unable to determine status of table.".
 2407: 		  &Apache::loncommon::end_page());
 2408:         &Apache::lonnet::logthis("Bogus table id of $table for ".
 2409:                                  "$env{'user.name'} @ $env{'user.domain'}");
 2410:         &Apache::lonnet::logthis("lonmysql error = ".
 2411:                                  &Apache::lonmysql::get_error());
 2412:         return;
 2413:     }
 2414:     if (! $table_status) {
 2415:         &Apache::lonnet::logthis("lonmysql error = ".
 2416:                                  &Apache::lonmysql::get_error());
 2417:         &Apache::lonnet::logthis("lonmysql debug = ".
 2418:                                  &Apache::lonmysql::get_debug());
 2419:         &Apache::lonnet::logthis('table status = "'.$table_status.'"');
 2420:         $r->print("The table id,$table, we tried to use is invalid.".
 2421:                   "The search has been aborted.".
 2422: 		  &Apache::loncommon::end_page());
 2423:         return;
 2424:     }
 2425:     ##
 2426:     ## Prepare for the big loop.
 2427:     my $hitcountsum;
 2428:     my $oldhitcountsum;
 2429:     my %matches;
 2430:     my $server; 
 2431:     my $status;
 2432:     my $revise = &revise_button();
 2433:     $r->print('<form name="statusform" action="" method="post">'."\n".
 2434:               '<input type="hidden" name="acts" value="" />'."\n".
 2435:               '<table border="0"><tr><td>'."\n".
 2436:               &Apache::loncommon::start_data_table());
 2437:     $r->print(&Apache::loncommon::start_data_table_header_row()
 2438:              .'<th>'.&mt('Status').'</th>'
 2439:              .'<th>'.&mt('Total Matches').'</th>'
 2440:              .'<th>'.&mt('Time Remaining').'</th>'
 2441:              .&Apache::loncommon::end_data_table_header_row()
 2442:              .&Apache::loncommon::start_data_table_row()
 2443:              .'<td><input type="text" name="status"  value="" size="50" readonly="readonly" /></td>'
 2444:              .'<td><input type="text" name="count"   value="" size="10" readonly="readonly" /></td>'
 2445:              .'<td><input type="text" name="seconds" value="" size="8" readonly="readonly" /></td>'
 2446:              .&Apache::loncommon::end_data_table_row()
 2447:              .&Apache::loncommon::end_data_table()
 2448:              .'</td><td>&nbsp;</td><td>'.$revise.'</td></tr></table></form>');
 2449:     $r->rflush();
 2450:     &reset_timing();
 2451:     &update_seconds($r);
 2452:     &update_status($r,&mt('contacting [_1]',$Servers_to_contact[0]));
 2453:     while (&time_left() &&
 2454:            ((@Servers_to_contact) || keys(%Server_status))) {
 2455:         &update_seconds($r);
 2456:         #
 2457:         # Send out a search request
 2458:         if (@Servers_to_contact) {
 2459:             # Contact one server
 2460:             my $server = shift(@Servers_to_contact);
 2461:             &update_status($r,&mt('contacting [_1]',$server));
 2462:             my $reply=&Apache::lonnet::metadata_query($query,$customquery,
 2463:                                                       $customshow,[$server],\%domains_by_server);
 2464:             ($server) = keys(%$reply);
 2465:             $Server_status{$server} = $reply->{$server};
 2466:         } else {
 2467:             # wait a sec. to give time for files to be written
 2468:             # This sleep statement is here instead of outside the else 
 2469:             # block because we do not want to pause if we have servers
 2470:             # left to contact.  
 2471:             if (scalar (keys(%Server_status))) {
 2472:                 &update_status($r,
 2473:                        &mt('waiting on [_1]',join(' ',keys(%Server_status))));
 2474:             }
 2475:             Time::HiRes::sleep(0.1);
 2476:         }
 2477:         #
 2478:         # Loop through the servers we have contacted but do not
 2479:         # have results from yet, looking for results.
 2480:         foreach my $server (keys(%Server_status)) {
 2481:             last if ($connection->aborted());
 2482:             &update_seconds($r);
 2483:             my $status = $Server_status{$server};
 2484:             if ($status eq 'con_lost') {
 2485:                 delete ($Server_status{$server});
 2486:                 next;
 2487:             }
 2488:             $status=~s|/||g;
 2489: 
 2490: 
 2491: 
 2492:        	    my $datafile=LONCAPA::tempdir().$status;
 2493:             if (-e $datafile && ! -e "$datafile.end") {
 2494:                 &update_status($r,&mt('Receiving results from [_1]',$server));
 2495:                 next;
 2496:             }
 2497:             last if ($connection->aborted());
 2498:             if (-e "$datafile.end") {
 2499:                 &update_status($r,&mt('Reading results from [_1]',$server));
 2500:                 if (-z "$datafile") {
 2501:                     delete($Server_status{$server});
 2502:                     next;
 2503:                 }
 2504:                 my $fh;
 2505:                 if (!($fh=Apache::File->new($datafile))) { 
 2506:                     $r->print("Unable to open search results file for ".
 2507:                                   "server $server.  Omitting from search");
 2508:                     delete($Server_status{$server}); 
 2509:                    next;
 2510:                 }
 2511:                 # Read in the whole file.
 2512:                 while (my $result = <$fh>) {
 2513:                     last if ($connection->aborted());
 2514:                     #
 2515:                     # Records are stored one per line
 2516:                     chomp($result);
 2517:                     next if (! $result);
 2518:                     #
 2519:                     # Parse the result.
 2520:                     my %Fields = &parse_raw_result($result,$server,$tabletype);
 2521:                     $Fields{'hostname'} = $server;
 2522:                     #
 2523:                     # Skip based on copyright
 2524:                     next if (! &copyright_check(\%Fields));
 2525: 
 2526:                     if ($area eq 'portfolio') {
 2527:                         next if (defined($matches{$Fields{'url'}}));
 2528:                         # Skip if inaccessible
 2529:                         next if (!&Apache::lonnet::portfolio_access($Fields{'url'}));
 2530:                         $matches{$Fields{'url'}} = 1; 
 2531:                     }
 2532:                     #
 2533:                     # Store the result in the mysql database
 2534:                     my $result = &Apache::lonmysql::store_row($table,\%Fields);
 2535:                     if (! defined($result)) {
 2536:                         $r->print(&Apache::lonmysql::get_error());
 2537:                     }
 2538:                     #
 2539:                     $hitcountsum ++;
 2540:                     &update_seconds($r);
 2541:                     if ($hitcountsum % 50 == 0) {
 2542:                         &update_count_status($r,$hitcountsum);
 2543:                     }
 2544:                 }
 2545:                 $fh->close();
 2546:                 # $server is only deleted if the results file has been 
 2547:                 # found and (successfully) opened.  This may be a bad idea.
 2548:                 delete($Server_status{$server});
 2549:             }
 2550:             last if ($connection->aborted());
 2551:             if ($oldhitcountsum < $hitcountsum) {
 2552:                 &update_count_status($r,$hitcountsum);
 2553:                 if ($hitcountsum <= $env{'form.show'}) {
 2554:                     reload_result_frame($r);
 2555:                 }
 2556:                 $oldhitcountsum = $hitcountsum;
 2557:             }
 2558:         }
 2559:         last if ($connection->aborted());
 2560:         &update_seconds($r);
 2561:     }
 2562:     &update_status($r,&mt('Search Complete on Server [_1]',$server));
 2563:     &update_seconds($r);
 2564:     #
 2565:     &Apache::lonmysql::disconnect_from_db(); # This is unneccessary
 2566:     #
 2567:     # We have run out of time or run out of servers to talk to and
 2568:     # results to get, so let the client know the top frame needs to be
 2569:     # loaded from /adm/searchcat
 2570:     $r->print(&Apache::loncommon::end_page());
 2571: #    if ($env{'form.catalogmode'} ne 'import') {
 2572:          $r->print(<<SCRIPT);
 2573: <script>
 2574: window.location='/adm/searchcat?phase=sort&persistent_db_id=$env{'form.persistent_db_id'}';
 2575: </script>
 2576: SCRIPT
 2577: #    }
 2578:     return;
 2579: }
 2580: 
 2581: ######################################################################
 2582: ######################################################################
 2583: 
 2584: =pod
 2585: 
 2586: =item &prev_next_buttons()
 2587: 
 2588: Returns html for the previous and next buttons on the search results page.
 2589: 
 2590: =cut
 2591: 
 2592: ######################################################################
 2593: ######################################################################
 2594: sub prev_next_buttons {
 2595:     my ($current_min,$show,$total,$parms) = @_;
 2596:     return '' if ($show eq 'all'); # No links if you get them all at once.
 2597:     #
 2598:     # Create buttons
 2599:     return '<p class="LC_nobreak">'
 2600:           .'<input type="submit" name="prev" value="&lt;"'
 2601:           .' title="'.&mt('Previous').'" />'
 2602:           .' '
 2603:           .'<input type="submit" name="reload" value="'.&mt('Reload').'" />'
 2604:           .' '
 2605:           .'<input type="submit" name="next" value="&gt;"'
 2606:           .' title="'.&mt('Next').'" />'
 2607:           .'</p>';
 2608: }
 2609: 
 2610: ######################################################################
 2611: ######################################################################
 2612: 
 2613: =pod
 2614: 
 2615: =item &display_results()
 2616: 
 2617: Prints the results out for selection and perusal.
 2618: 
 2619: =cut
 2620: 
 2621: ######################################################################
 2622: ######################################################################
 2623: sub display_results {
 2624:     my ($r,$importbutton,$closebutton,$diropendb,$area) = @_;
 2625:     my $connection = $r->connection;
 2626:     $r->print(&search_results_header($importbutton,$closebutton));
 2627:     ##
 2628:     ## Set viewing function
 2629:     ##
 2630:     my $viewfunction = $Views{$env{'form.viewselect'}};
 2631:     if (!defined($viewfunction)) {
 2632:         $r->print('<p class="LC_error">'
 2633:                  .&mt('Internal Error - Bad view selected.')
 2634:                  .'</p>'."\n");
 2635:         $r->rflush();
 2636:         return;
 2637:     }
 2638:     ##
 2639:     ## $checkbox_num is a count of the number of checkboxes output on the 
 2640:     ## page this is used only during catalogmode=import.
 2641:     my $checkbox_num = 0;
 2642:     ##
 2643:     ## Get the catalog controls setup
 2644:     ##
 2645:     my $action = "/adm/searchcat?phase=results";
 2646:     ##
 2647:     ## Deal with import by opening the import db file.
 2648:     if ($env{'form.catalogmode'} eq 'import') {
 2649:         if (! tie(%groupsearch_db,'GDBM_File',$diropendb,
 2650:                   &GDBM_WRCREAT(),0640)) {
 2651:             # NOTE: this can happen when a previous request to searchcat?phase=results gets interrupted
 2652:             # (%groupsearch_db is not untied)
 2653:             $r->print('<p class="LC_error">'.
 2654:               &mt('Unable to save import results.').
 2655:               '</p>'.
 2656:               '</form>'.
 2657: 		      &Apache::loncommon::end_page());
 2658:             $r->rflush();
 2659:             return;
 2660:         } 
 2661:         # untie %groupsearch_db if the connection gets aborted before the end
 2662:         $r->register_cleanup(sub {
 2663:             untie %groupsearch_db if (tied(%groupsearch_db));
 2664:         });
 2665:     }
 2666:     ##
 2667:     ## Prepare the table for querying
 2668:     my $table = $env{'form.table'};
 2669:     return if (! &ensure_db_and_table($r,$table));
 2670:     ##
 2671:     ## Get the number of results 
 2672:     my $total_results = &Apache::lonmysql::number_of_rows($table);
 2673:     if (! defined($total_results)) {
 2674:         $r->print('<p class="LC_error">'.
 2675:           &mt('A MySQL error has occurred.').
 2676:           '</p>'.
 2677:           '</form>'.
 2678: 		  &Apache::loncommon::end_page());
 2679:         &Apache::lonnet::logthis("lonmysql was unable to determine the number".
 2680:                                  " of rows in table ".$table);
 2681:         &Apache::lonnet::logthis(&Apache::lonmysql::get_error());
 2682:         return;
 2683:     }
 2684:     ##
 2685:     ## Determine how many results we need to get
 2686:     $env{'form.start'} = 1  if (! exists($env{'form.start'}));
 2687:     $env{'form.show'}  = 20 if (! exists($env{'form.show'}));
 2688:     if (exists($env{'form.prev'})) {
 2689:         $env{'form.start'} -= $env{'form.show'};
 2690:     } elsif (exists($env{'form.next'})) {
 2691:         $env{'form.start'} += $env{'form.show'};
 2692:     }
 2693:     $env{'form.start'} = 1 if ($env{'form.start'}<1);
 2694:     $env{'form.start'} = $total_results if ($env{'form.start'}>$total_results);
 2695:     my $min = $env{'form.start'};
 2696:     my $max;
 2697:     if ($env{'form.show'} eq 'all') {
 2698:         $max = $total_results ;
 2699:     } else {
 2700:         $max = $min + $env{'form.show'} - 1;
 2701:         $max = $total_results if ($max > $total_results);
 2702:     }
 2703:     ##
 2704:     ## Output form elements
 2705:     $r->print(&hidden_field('table').
 2706:               &hidden_field('phase').
 2707:               &hidden_field('persistent_db_id').
 2708:               &hidden_field('start').
 2709:               &hidden_field('area')
 2710:               );
 2711:     #
 2712:     # Build sorting selector
 2713:     my @fields = 
 2714:         (
 2715:          {key=>'default' },
 2716:          {key=>'title' },
 2717:          {key =>'author' },
 2718:          {key =>'subject'},
 2719:          {key =>'url',desc=>'URL'},
 2720:          {key =>'keywords'},
 2721:          {key =>'language'},
 2722:          {key =>'creationdate'},
 2723:          {key =>'lastrevisiondate'},
 2724:          {key =>'owner'},
 2725:          {key =>'copyright'},
 2726:          {key =>'authorspace'},
 2727:          {key =>'lowestgradelevel'},
 2728:          {key =>'highestgradelevel'},
 2729:          {key =>'standards',desc=>'Standards'},
 2730:         );
 2731:     if ($area eq 'portfolio') {
 2732:         push(@fields,
 2733:        (
 2734:          {key => 'scope'},
 2735:          {key => 'keynum'},
 2736:        ));
 2737:     } else {
 2738:         push(@fields,
 2739:        (
 2740:          {key =>'count',desc=>'Number of accesses'},
 2741:          {key =>'stdno',desc=>'Students Attempting'},
 2742:          {key =>'avetries',desc=>'Average Number of Tries'},
 2743:          {key =>'difficulty',desc=>'Mean Degree of Difficulty'},
 2744:          {key =>'disc',desc=>'Mean Degree of Discrimination'},
 2745:          {key =>'clear',desc=>'Evaluation: Clear'},
 2746:          {key =>'technical',desc=>'Evaluation: Technically Correct'},
 2747:          {key =>'correct',desc=>'Evaluation: Material is Correct'},
 2748:          {key =>'helpful',desc=>'Evaluation: Material is Helpful'},
 2749:          {key =>'depth',desc=>'Evaluation: Material has Depth'},
 2750:        ));
 2751:     }
 2752:     my %fieldnames = &Apache::lonmeta::fieldnames();
 2753:     my @field_order;
 2754:     foreach my $field_data (@fields) {
 2755:         push(@field_order,$field_data->{'key'});
 2756:         if (! exists($field_data->{'desc'})) {
 2757:             $field_data->{'desc'}=$fieldnames{$field_data->{'key'}};
 2758:         } else {
 2759:             if (! defined($field_data->{'desc'})) {
 2760:                 $field_data->{'desc'} = ucfirst($field_data->{'key'});
 2761:             }
 2762:             $field_data->{'desc'} = &mt($field_data->{'desc'});
 2763:         }
 2764:     }
 2765:     my %sort_fields = map {$_->{'key'},$_->{'desc'}} @fields;
 2766:     $sort_fields{'select_form_order'} = \@field_order;
 2767:     $env{'form.sortorder'} = 'desc' if (! exists($env{'form.sortorder'}));
 2768:     if (! exists($env{'form.sortfield'})) {
 2769:         if ($area eq 'portfolio') {
 2770:             $env{'form.sortfield'} = 'owner';
 2771:         } else {
 2772:             $env{'form.sortfield'} = 'count';
 2773:         }
 2774:     }
 2775:     if (! exists($env{'form.sortorder'})) {
 2776: 	if ($env{'form.sortfield'}=~/^(count|stdno|disc|clear|technical|correct|helpful)$/) {
 2777: 	    $env{'form.sortorder'}='desc';
 2778: 	} else {
 2779: 	    $env{'form.sortorder'}='asc';
 2780: 	}
 2781:     }
 2782:     my $sortform = '<span class="LC_nobreak">'
 2783:                   .&mt('Sort by:').' '
 2784:                   .&Apache::loncommon::select_form($env{'form.sortfield'},
 2785:                                                       'sortfield',
 2786:                                                       \%sort_fields)
 2787:                   .' '
 2788:                   .&Apache::loncommon::select_form($env{'form.sortorder'},
 2789:                                                       'sortorder',
 2790:                                                       {asc =>&mt('Ascending'),
 2791:                                                        desc=>&mt('Descending')
 2792:                                                        })
 2793:                   .'</span>';
 2794:     ##
 2795:     ## Display links for 'prev' and 'next' pages (if necessary) and Display Options
 2796:     $r->print('<fieldset>'."\n"
 2797:              .'<legend>'.&mt('Display Options').'</legend>'."\n"
 2798:              .$sortform
 2799:              .' '
 2800:              .&viewoptions()
 2801:              .'</fieldset>'
 2802:              .&prev_next_buttons($min,$env{'form.show'},$total_results)
 2803:     );
 2804: 
 2805:     if ($total_results == 0) {
 2806:         $r->print('<p class="LC_info">'.&mt('There are currently no results.').'</p>'.
 2807:                   "</form>".
 2808: 		  &Apache::loncommon::end_page());
 2809:         return;
 2810:     } else {
 2811:         $r->print('<div>'.
 2812:                   mt('Results [_1] to [_2] out of [_3]',
 2813:                      $min,$max,$total_results).
 2814:                   "</div>\n");
 2815:     }
 2816:     ##
 2817:     ## Get results from MySQL table
 2818:     my $sort_command  = 'id>='.$min.' AND id<='.$max;
 2819:     my $order;
 2820:     if (exists($env{'form.sortorder'})) {
 2821:         if ($env{'form.sortorder'} eq 'asc') {
 2822:             $order = 'ASC';
 2823:         } elsif ($env{'form.sortorder'} eq 'desc') {
 2824:             $order = 'DESC';
 2825:         } else {
 2826:             $order = '';
 2827:         }
 2828:     } else {
 2829:         $order = '';
 2830:     }
 2831:     if ($env{'form.sortfield'} ne 'default' && 
 2832:         exists($sort_fields{$env{'form.sortfield'}})) {
 2833:         $sort_command = $env{'form.sortfield'}.' IS NOT NULL '.
 2834:             'ORDER BY '.$env{'form.sortfield'}.' '.$order.
 2835:             '  LIMIT '.($min-1).','.($max-$min+1);
 2836:     }
 2837:     my @Results = &Apache::lonmysql::get_rows($table,$sort_command);
 2838:     ##
 2839:     ## Loop through the results and output them.
 2840:     my $tabletype = 'metadata';
 2841:     if ($area eq 'portfolio') {
 2842:         $tabletype = 'portfolio_search';
 2843:     }
 2844:     $r->print(&Apache::loncommon::start_data_table());
 2845:     foreach my $row (@Results) {
 2846:         if ($connection->aborted()) {
 2847:             &cleanup();
 2848:             return;
 2849:         }
 2850:         my %Fields = %{&parse_row($tabletype,@$row)};
 2851:         my $output;
 2852:         if (! defined($Fields{'title'}) || $Fields{'title'} eq '') {
 2853:             $Fields{'title'} = 'Untitled';
 2854:         }
 2855:         my $prefix=&catalogmode_output($Fields{'title'},$Fields{'url'},
 2856:                                        $Fields{'id'},$checkbox_num++);
 2857:         # Render the result into html
 2858:         $output.= &$viewfunction($prefix,%Fields);
 2859:         # Print them out as they come in.
 2860:         $r->print(&Apache::loncommon::start_data_table_row()
 2861:                  .'<td>'
 2862:                  .$output
 2863:                  .'</td>'
 2864:                  .&Apache::loncommon::end_data_table_row()
 2865:         );
 2866:         $r->rflush();
 2867:     }
 2868:     $r->print(&Apache::loncommon::end_data_table());
 2869:     if (@Results < 1) {
 2870:         $r->print('<p class="LC_info">'
 2871:                  .&mt('There were no results matching your query.')
 2872:                  .'</p>');
 2873:     } else {
 2874:         $r->print(
 2875:             &prev_next_buttons($min,$env{'form.show'},$total_results,
 2876:                                 "table=".$env{'form.table'}.
 2877:                                 "&amp;phase=results".
 2878:                                 "&amp;persistent_db_id=".
 2879:                                 $env{'form.persistent_db_id'})
 2880:         );
 2881:     }
 2882:     $r->print("</form>".&Apache::loncommon::end_page());
 2883:     $r->rflush();
 2884:     untie %groupsearch_db if (tied(%groupsearch_db));
 2885:     return;
 2886: }
 2887: 
 2888: ######################################################################
 2889: ######################################################################
 2890: 
 2891: =pod
 2892: 
 2893: =item &catalogmode_output($title,$url,$fnum,$checkbox_num)
 2894: 
 2895: Returns html needed for the various catalog modes.  Gets inputs from
 2896: $env{'form.catalogmode'}.  Stores data in %groupsearch_db.
 2897: 
 2898: =cut
 2899: 
 2900: ######################################################################
 2901: ######################################################################
 2902: sub catalogmode_output {
 2903:     my $output = '';
 2904:     my ($title,$url,$fnum,$checkbox_num) = @_;
 2905:     if ($env{'form.catalogmode'} eq 'interactive') {
 2906:         $title=~ s/\'/\\\'/g;
 2907:         if ($env{'form.catalogmode'} eq 'interactive') {
 2908:             $output.=<<END 
 2909: <font size='-1'><input type="button" name="returnvalues" value="select"
 2910: onclick="javascript:select_data('$title','$url')" />
 2911: </font>
 2912: END
 2913:         }
 2914:     } elsif ($env{'form.catalogmode'} eq 'import') {
 2915:         $groupsearch_db{"pre_${fnum}_link"}=$url;
 2916:         $groupsearch_db{"pre_${fnum}_title"}=$title;
 2917:         $output.=<<END;
 2918: <font size='-1'>
 2919: <input type="checkbox" name="returnvalues" value="select"
 2920: onclick="javascript:queue($checkbox_num,$fnum)" />
 2921: </font>
 2922: END
 2923:     }
 2924:     return $output;
 2925: }
 2926: ######################################################################
 2927: ######################################################################
 2928: 
 2929: =pod
 2930: 
 2931: =item &parse_row()
 2932: 
 2933: Parse a row returned from the database.
 2934: 
 2935: =cut
 2936: 
 2937: ######################################################################
 2938: ######################################################################
 2939: sub parse_row {
 2940:     my ($tabletype,@Row) = @_;
 2941:     my %Fields;
 2942:     if (! scalar(@Datatypes)) {
 2943:         &set_up_table_structure($tabletype);
 2944:     }
 2945:     for (my $i=0;$i<=$#Row;$i++) {
 2946:         $Fields{$Datatypes[$i]->{'name'}}=&unescape($Row[$i]);
 2947:     }
 2948:     $Fields{'language'} = 
 2949:         &Apache::loncommon::languagedescription($Fields{'language'});
 2950:     $Fields{'copyrighttag'} =
 2951:         &Apache::loncommon::copyrightdescription($Fields{'copyright'});
 2952:     $Fields{'mimetag'} =
 2953:         &Apache::loncommon::filedescription($Fields{'mime'});
 2954:     return \%Fields;
 2955: }
 2956: 
 2957: ###########################################################
 2958: ###########################################################
 2959: 
 2960: =pod
 2961: 
 2962: =item &parse_raw_result()
 2963: 
 2964: Takes a line from the file of results and parse it.  Returns a hash 
 2965: with keys according to column labels
 2966: 
 2967: In addition, the following tags are set by calling the appropriate 
 2968: lonnet function: 'language', 'copyrighttag', 'mimetag'.
 2969: 
 2970: The 'title' field is set to "Untitled" if the title field is blank.
 2971: 
 2972: 'abstract' and 'keywords' are truncated to 200 characters.
 2973: 
 2974: =cut
 2975: 
 2976: ###########################################################
 2977: ###########################################################
 2978: sub parse_raw_result {
 2979:     my ($result,$hostname,$tabletype) = @_;
 2980:     # conclude from self to others regarding fields
 2981:     my %Fields=&LONCAPA::lonmetadata::metadata_col_to_hash
 2982:         ($tabletype,
 2983:          map {
 2984:             &unescape($_);
 2985:          } (split(/\,/,$result)) );
 2986:     return %Fields;
 2987: }
 2988: 
 2989: ###########################################################
 2990: ###########################################################
 2991: 
 2992: =pod
 2993: 
 2994: =item &handle_custom_fields()
 2995: 
 2996: =cut
 2997: 
 2998: ###########################################################
 2999: ###########################################################
 3000: sub handle_custom_fields {
 3001:     my @results = @{shift()};
 3002:     my $customshow='';
 3003:     my $extrashow='';
 3004:     my @customfields;
 3005:     if ($env{'form.customshow'}) {
 3006:         $customshow=$env{'form.customshow'};
 3007:         $customshow=~s/[^\w\s]//g;
 3008:         my @fields=map {
 3009:             "<font color=\"#008000\">$_:</font><!-- $_ -->";
 3010:         } split(/\s+/,$customshow);
 3011:         @customfields=split(/\s+/,$customshow);
 3012:         if ($customshow) {
 3013:             $extrashow="<ul><li>".join("</li><li>",@fields)."</li></ul>\n";
 3014:         }
 3015:     }
 3016:     my $customdata='';
 3017:     my %customhash;
 3018:     foreach my $result (@results) {
 3019:         if ($result=~/^(custom\=.*)$/) { # grab all custom metadata
 3020:             my $tmp=$result;
 3021:             $tmp=~s/^custom\=//;
 3022:             my ($k,$v)=map {&unescape($_);
 3023:                         } split(/\,/,$tmp);
 3024:             $customhash{$k}=$v;
 3025:         }
 3026:     }
 3027:     return ($extrashow,\@customfields,\%customhash);
 3028: }
 3029: 
 3030: ######################################################################
 3031: ######################################################################
 3032: 
 3033: =pod
 3034: 
 3035: =item &search_results_header()
 3036: 
 3037: Output the proper html headers and javascript code to deal with different 
 3038: calling modes.
 3039: 
 3040: Takes most inputs directly from %env, except $mode.  
 3041: 
 3042: =over 4
 3043: 
 3044: =item $mode is either (at this writing) 'Basic' or 'Advanced'
 3045: 
 3046: =back
 3047: 
 3048: The following environment variables are checked:
 3049: 
 3050: =over 4
 3051: 
 3052: =item 'form.catalogmode' 
 3053: 
 3054: Checked for 'interactive' and 'import'.
 3055: 
 3056: =item 'form.mode'
 3057: 
 3058: Checked for existance & 'edit' mode.
 3059: 
 3060: =item 'form.form'
 3061: 
 3062: Contains the name of the form that has the input fields to set
 3063: 
 3064: =item 'form.element'
 3065: 
 3066: the name of the input field to put the URL into
 3067: 
 3068: =item 'form.titleelement'
 3069: 
 3070: the name of the input field to put the title into
 3071: 
 3072: =back
 3073: 
 3074: =cut
 3075: 
 3076: ######################################################################
 3077: ######################################################################
 3078: sub search_results_header {
 3079:     my ($importbutton,$closebutton) = @_;
 3080: 
 3081:     my $js;
 3082:     # output beginning of search page
 3083:     # conditional output of script functions dependent on the mode in
 3084:     # which the search was invoked
 3085:     if ($env{'form.catalogmode'} eq 'interactive'){
 3086: 	if (! exists($env{'form.mode'}) || $env{'form.mode'} ne 'edit') {
 3087:             $js.=<<SCRIPT;
 3088: <script type="text/javascript">
 3089: // <![CDATA[
 3090:     function select_data(title,url) {
 3091: 	changeTitle(title);
 3092: 	changeURL(url);
 3093: 	parent.close();
 3094:     }
 3095:     function changeTitle(val) {
 3096: 	if (parent.opener.inf.document.forms.resinfo.elements.t) {
 3097: 	    parent.opener.inf.document.forms.resinfo.elements.t.value=val;
 3098: 	}
 3099:     }
 3100:     function changeURL(val) {
 3101: 	if (parent.opener.inf.document.forms.resinfo.elements.u) {
 3102: 	    parent.opener.inf.document.forms.resinfo.elements.u.value=val;
 3103: 	}
 3104:     }
 3105: // ]]>
 3106: </script>
 3107: SCRIPT
 3108:         } elsif ($env{'form.mode'} eq 'edit') {
 3109:             my $form = $env{'form.form'};
 3110:             my $element = $env{'form.element'};
 3111:             my $titleelement = $env{'form.titleelement'};
 3112: 	    my $changetitle;
 3113: 	    if (!$titleelement) {
 3114: 		$changetitle='function changeTitle(val) {}';
 3115: 	    } else {
 3116: 		    $changetitle=<<END;
 3117: function changeTitle(val) {
 3118:     if (parent.targetwin.document) {
 3119:         parent.targetwin.document.forms["$form"].elements["$titleelement"].value=val;
 3120:     } else {
 3121: 	var url = 'forms[\"$form\"].elements[\"$titleelement\"].value';
 3122:         alert("Unable to transfer data to "+url);
 3123:     }
 3124: }
 3125: END
 3126:             }
 3127: 
 3128:             $js.=<<SCRIPT;
 3129: <script type="text/javascript">
 3130: // <![CDATA[
 3131: function select_data(title,url) {
 3132:     changeURL(url);
 3133:     changeTitle(title);
 3134:     parent.close();
 3135: }
 3136: $changetitle
 3137: function changeURL(val) {
 3138:     if (parent.targetwin.document) {
 3139:         parent.targetwin.document.forms["$form"].elements["$element"].value=val;
 3140:     } else {
 3141: 	var url = 'forms[\"$form\"].elements[\"$element\"].value';
 3142:         alert("Unable to transfer data to "+url);
 3143:     }
 3144: }
 3145: // ]]>
 3146: </script>
 3147: SCRIPT
 3148:         }
 3149:     }
 3150:     my $inhibit_menu = "&".&Apache::loncommon::inhibit_menu_check();
 3151:     $js.=<<SCRIPT if $env{'form.catalogmode'} eq 'import';
 3152: <script type="text/javascript">
 3153: // <![CDATA[
 3154:     function queue(checkbox_num,val) {
 3155:         if (document.forms.results.returnvalues.length != "undefined" &&
 3156:             typeof(document.forms.results.returnvalues.length) == "number") {
 3157:             if (document.forms.results.returnvalues[checkbox_num].checked) {
 3158:                 parent.statusframe.document.forms.statusform.elements.acts.value +='1a'+val+'b';
 3159:             } else {
 3160:                 parent.statusframe.document.forms.statusform.elements.acts.value +='0a'+val+'b';
 3161:             }
 3162:         } else {
 3163:             if (document.forms.results.returnvalues.checked) {
 3164:                 parent.statusframe.document.forms.statusform.elements.acts.value +='1a'+val+'b';
 3165:             } else {
 3166:                 parent.statusframe.document.forms.statusform.elements.acts.value +='0a'+val+'b';
 3167:             }
 3168:         }
 3169:     }
 3170:     function select_group() {
 3171: 	parent.window.location=
 3172:     "/adm/groupsort?mode=$env{'form.mode'}&catalogmode=import$inhibit_menu&acts="+
 3173: 	    parent.statusframe.document.forms.statusform.elements.acts.value;
 3174:     }
 3175: // ]]>
 3176: </script>
 3177: SCRIPT
 3178: 
 3179:     my $start_page  = &Apache::loncommon::start_page(undef,$js,
 3180: 						     {'only_body' =>1,
 3181:                                                       'add_wishlist' =>1,
 3182:                                                       'add_modal' =>1});
 3183:     my $result=<<END;
 3184: $start_page
 3185: <form name="results" method="post" action="/adm/searchcat">
 3186: $importbutton
 3187: END
 3188:     return $result;
 3189: }
 3190: 
 3191: sub results_link {
 3192:     my $basic_link   = "/adm/searchcat?"."&amp;table=".$env{'form.table'}.
 3193:         "&amp;persistent_db_id=".$env{'form.persistent_db_id'};
 3194:     my $results_link = $basic_link."&amp;phase=results".
 3195:         "&amp;pause=1"."&amp;start=1";
 3196:     return $results_link;
 3197: }
 3198: 
 3199: ######################################################################
 3200: ######################################################################
 3201: sub print_frames_interface {
 3202:     my $r = shift;
 3203:     my $basic_link = "/adm/searchcat?"."&amp;table=".$env{'form.table'}.
 3204:         "&amp;persistent_db_id=".$env{'form.persistent_db_id'};
 3205:     my $run_search_link = $basic_link."&amp;phase=run_search";
 3206:     my $results_link = &results_link();
 3207:     my $js = <<JS;
 3208: <script type="text/javascript">
 3209: // <![CDATA[
 3210: var targetwin = opener;
 3211: var queue = '';
 3212: // ]]>
 3213: </script>
 3214: JS
 3215: 
 3216:     my $start_page =
 3217:         &Apache::loncommon::start_page('LON-CAPA Digital Library Search Results',
 3218: 				       $js,
 3219: 				       {'frameset'    => 1,
 3220: 					'add_entries' => {
 3221: 					    'rows' => "150,*",},});
 3222:     my $end_page =
 3223:         &Apache::loncommon::end_page({'frameset' => 1});
 3224: 
 3225:     my $result = <<"ENDFRAMES";
 3226: $start_page
 3227:     <frame name="statusframe"  src="$run_search_link">
 3228:     <frame name="resultsframe" src="$results_link">
 3229: $end_page
 3230: ENDFRAMES
 3231: 
 3232:     $r->print($result);
 3233:     return;
 3234: }
 3235: 
 3236: ######################################################################
 3237: ######################################################################
 3238: 
 3239: sub has_stat_data {
 3240:     my ($values) = @_;
 3241:     if ( (defined($values->{'count'})      && $values->{'count'}      ne '') ||
 3242:          (defined($values->{'stdno'})      && $values->{'stdno'}      ne '') ||
 3243:          (defined($values->{'disc'})       && $values->{'disc'}       ne '') ||
 3244:          (defined($values->{'avetries'})   && $values->{'avetries'}   ne '') ||
 3245:          (defined($values->{'difficulty'}) && $values->{'difficulty'} ne '')) {
 3246:         return 1;
 3247:     }
 3248:     return 0;
 3249: }
 3250: 
 3251: sub statfields {
 3252:     return ('count','stdno','disc','avetries','difficulty');
 3253: }
 3254: 
 3255: sub has_eval_data {
 3256:     my ($values) = @_;
 3257:     if ( (defined($values->{'clear'})     && $values->{'clear'}     ne '') ||
 3258:          (defined($values->{'technical'}) && $values->{'technical'} ne '') ||
 3259:          (defined($values->{'correct'})   && $values->{'correct'}   ne '') ||
 3260:          (defined($values->{'helpful'})   && $values->{'helpful'}   ne '') ||
 3261:          (defined($values->{'depth'})     && $values->{'depth'}     ne '')) {
 3262:         return 1;
 3263:     }
 3264:     return 0;
 3265: }
 3266: 
 3267: sub evalfields { 
 3268:     return ('clear','technical','correct','helpful','depth');
 3269: }
 3270: 
 3271: ######################################################################
 3272: ######################################################################
 3273: 
 3274: sub display_tools {
 3275:     my ($title, $jumpurl) = @_;
 3276:     my $result;
 3277:     # Metadata
 3278:     $result.=
 3279:         &Apache::loncommon::modal_link(
 3280:             $jumpurl.'.meta?inhibitmenu=yes',
 3281:             '<img class="LC_icon" src="/res/adm/pages/catalog.png" alt="Info" />',
 3282:             500,500,'_blank',undef,&mt('Metadata'));
 3283:     # Stored Links
 3284:     $result.=
 3285:         ' <a href="javascript:;"'.
 3286:         ' onclick="set_wishlistlink('."'$title','$jumpurl'".')" '.
 3287:         'title="'.&mt('Save a link for this resource in your personal Stored Links repository').'">'.
 3288:         '<img class="LC_icon" src="/res/adm/pages/wishlist.png" '.
 3289:         'alt="Stored Links" style="width:22px;"/></a>';
 3290:     return $result;
 3291: }
 3292: 
 3293: ######################################################################
 3294: ######################################################################
 3295: 
 3296: =pod 
 3297: 
 3298: =item Metadata Viewing Functions
 3299: 
 3300: Output is a HTML-ified string.
 3301: 
 3302: Input arguments are title, author, subject, url, keywords, version,
 3303: notes, short abstract, mime, language, creation date,
 3304: last revision date, owner, copyright, hostname, and
 3305: extra custom metadata to show.
 3306: 
 3307: =over 4
 3308: 
 3309: =item &detailed_citation_view() 
 3310: 
 3311: =cut
 3312: 
 3313: ######################################################################
 3314: ######################################################################
 3315: sub detailed_citation_view {
 3316:     my ($prefix,%values) = @_;
 3317:     my $result;
 3318:     my $jumpurl=$values{'url'};
 3319:     $jumpurl=~s|^/ext/|http://|;
 3320:     $result .=
 3321:         '<b>'.$prefix.
 3322:         '<img src="'.&Apache::loncommon::icon($values{'url'}).'" alt="" />'.'&nbsp;'.
 3323:         '<a href="'.$jumpurl.'?inhibitmenu=yes" '.
 3324:         'target="preview">'.$values{'title'}."</a></b>\n".
 3325:         &display_tools($values{'title'}, $jumpurl).
 3326:         "<p>\n".
 3327:         '<b>'.$values{'author'}.'</b>,'.
 3328:         ' <i>'.$values{'owner'}.'</i><br />';
 3329:     foreach my $field 
 3330:         (
 3331:          { name=>'url',
 3332:            translate => '<b>URL:</b>&nbsp;[_1]',
 3333:            special => 'url link',},
 3334:          { name=>'subject',
 3335:            translate => '<b>Subject:</b>&nbsp;[_1]',},
 3336:          { name=>'keywords',
 3337:            translate => '<b>Keywords:</b>&nbsp;[_1]',},
 3338:          { name=>'notes',
 3339:            translate => '<b>Notes:</b>&nbsp;[_1]',},
 3340:          { name=>'mimetag',
 3341:            translate => '<b>MIME Type:</b>&nbsp;[_1]',},
 3342:          { name=>'standards',
 3343:            translate => '<b>Standards:</b>[_1]',},
 3344:          { name=>'copyrighttag',
 3345:            translate => '<b>Copyright/Distribution:</b>&nbsp;[_1]',},
 3346:          { name=>'count',
 3347:            format => "%d",
 3348:            translate => '<b>Access Count:</b>&nbsp;[_1]',},
 3349:          { name=>'stdno',
 3350:            format => "%d",
 3351:            translate => '<b>Number of Students:</b>&nbsp;[_1]',},
 3352:          { name=>'avetries',
 3353:            format => "%.2f",
 3354:            translate => '<b>Average Tries:</b>&nbsp;[_1]',},
 3355:          { name=>'disc',
 3356:            format => "%.2f",
 3357:            translate => '<b>Degree of Discrimination:</b>&nbsp;[_1]',},
 3358:          { name=>'difficulty',
 3359:            format => "%.2f",
 3360:            translate => '<b>Degree of Difficulty:</b>&nbsp;[_1]',},
 3361:          { name=>'clear',
 3362:            format => "%.2f",
 3363:            translate => '<b>Clear:</b>&nbsp;[_1]',},
 3364:          { name=>'depth',
 3365:            format => "%.2f",
 3366:            translate => '<b>Depth:</b>&nbsp;[_1]',},
 3367:          { name=>'helpful',
 3368:            format => "%.2f",
 3369:            translate => '<b>Helpful:</b>&nbsp;[_1]',},
 3370:          { name=>'correct',
 3371:            format => "%.2f",
 3372:            translate => '<b>Correct:</b>&nbsp;[_1]',},
 3373:          { name=>'technical',
 3374:            format => "%.2f",
 3375:            translate => '<b>Technical:</b>&nbsp;[_1]',},
 3376:          { name=>'comefrom_list',
 3377:            type => 'list',
 3378:            translate => 'Resources that lead up to this resource in maps',},
 3379:          { name=>'goto_list',
 3380:            type => 'list',
 3381:            translate => 'Resources that follow this resource in maps',},
 3382:          { name=>'sequsage_list',
 3383:            type => 'list',
 3384:            translate => 'Resources using or importing resource',},
 3385:          ) {
 3386:         next if (! exists($values{$field->{'name'}}) ||
 3387:                  $values{$field->{'name'}} eq '');
 3388:         if (exists($field->{'type'}) && $field->{'type'} eq 'list') {
 3389:             $result .= '<b>'.&mt($field->{'translate'}).'</b>';
 3390:             foreach my $item (split(',',$values{$field->{'name'}})){
 3391:                 $item = &Apache::lonnet::clutter($item);
 3392:                 $result .= '<br />'.&display_url($item,1).'<br />';
 3393:             }
 3394:         } elsif (exists($field->{'format'}) && $field->{'format'} ne ''){
 3395:             $result.= &mt($field->{'translate'},
 3396:                           sprintf($field->{'format'},
 3397:                                   $values{$field->{'name'}}))."<br />\n";
 3398:         } else {
 3399:             if ($field->{'special'} eq 'url link') {
 3400:                 $result .= '<br />'.&display_url($jumpurl,1).'<br />';
 3401:             } else {
 3402:                 $result.= &mt($field->{'translate'},
 3403:                               $values{$field->{'name'}});
 3404:             }
 3405:             $result .= "<br />\n";
 3406:         }
 3407:     }
 3408:     $result .= "</p>";
 3409:     if (exists($values{'extrashow'}) && $values{'extrashow'} ne '') {
 3410:         $result .= '<p>'.$values{'extrashow'}.'</p>';
 3411:     }
 3412:     if (exists($values{'shortabstract'}) && $values{'shortabstract'} ne '') {
 3413:         $result .= '<p>'.$values{'shortabstract'}.'</p>';
 3414:     }
 3415:     return $result;
 3416: }
 3417: 
 3418: sub detailed_citation_preview {
 3419:     my ($prefix,%values)=@_;
 3420:     return &detailed_citation_view($prefix,%values).
 3421:            '</td><td>'.
 3422:            &Apache::lonindexer::showpreview($values{'url'});
 3423: }
 3424: 
 3425: 
 3426: ######################################################################
 3427: ######################################################################
 3428: 
 3429: =pod 
 3430: 
 3431: =item &summary_view() 
 3432: 
 3433: =cut
 3434: ######################################################################
 3435: ######################################################################
 3436: sub summary_view {
 3437:     my ($prefix,%values) = @_;
 3438:     my $icon=&Apache::loncommon::icon($values{'url'});
 3439:     my $result=qq{$prefix<img src="$icon" alt="" />};
 3440:     if (exists($env{'form.sortfield'}) && 
 3441:         $env{'form.sortfield'} !~ /^(default|
 3442:                                      author|
 3443:                                      url|
 3444:                                      title|
 3445:                                      owner|
 3446:                                      lastrevisiondate|
 3447:                                      copyright)$/x) {
 3448:         my $tmp = $values{$env{'form.sortfield'}};
 3449:         if (! defined($tmp)) { $tmp = 'undefined'; }
 3450:         $result .= '&nbsp;'.$tmp.'&nbsp;';
 3451:     }
 3452:     my $jumpurl=$values{'url'};
 3453:     $jumpurl=~s|^/ext/|http://|;
 3454:     my $link = '<br />'.&display_url($jumpurl,1).'<br />';
 3455:     $result .=
 3456:         '<a href="'.$jumpurl.'?inhibitmenu=yes"'.
 3457:         ' target="preview">'.$values{'title'}.'</a>'.
 3458:         &display_tools($values{'title'}, $jumpurl).<<END;
 3459: <br />
 3460: $link<br />
 3461: $values{'author'}, $values{'owner'} -- $values{'lastrevisiondate'}<br />
 3462: $values{'copyrighttag'}<br />
 3463: $values{'extrashow'}
 3464: END
 3465:     return $result;
 3466: }
 3467: 
 3468: sub summary_preview {
 3469:     my ($prefix,%values)=@_;
 3470:     return &summary_view($prefix,%values).
 3471:            '</td><td>'.
 3472:            &Apache::lonindexer::showpreview($values{'url'});
 3473: }
 3474: 
 3475: ######################################################################
 3476: ######################################################################
 3477: 
 3478: =pod 
 3479: 
 3480: =item &compact_view() 
 3481: 
 3482: =cut
 3483: 
 3484: ######################################################################
 3485: ######################################################################
 3486: sub compact_view {
 3487:     my ($prefix,%values) = @_;
 3488:     my $jumpurl=$values{'url'};
 3489:     $jumpurl=~s|^/ext/|http://|;
 3490: 
 3491:     my $link = &display_url($jumpurl,1);
 3492:     
 3493:     my $result = 
 3494:         $prefix.'<img src="'.&Apache::loncommon::icon($values{'url'}).'" alt="" />';
 3495:     if (exists($env{'form.sortfield'}) && 
 3496:         $env{'form.sortfield'} !~ /^(default|author|url|title)$/) {
 3497:         my $tmp = $values{$env{'form.sortfield'}};
 3498:         if (! defined($tmp)) { $tmp = 'undefined'; }
 3499:         $result .= '&nbsp;'.$tmp.'&nbsp;';
 3500:     }
 3501:     $jumpurl = &HTML::Entities::encode($jumpurl,'<>&"');
 3502:     $result.=' <span class="LC_nobreak">'.
 3503: 	'<a href="'.$jumpurl.'?inhibitmenu=yes" target="preview">'.
 3504:         &HTML::Entities::encode($values{'title'},'<>&"').'</a></span> '.
 3505:         &display_tools($values{'title'}, $jumpurl).
 3506: 	$link.' <b>'.$values{'author'}.'</b> ('.$values{'domain'}.')';
 3507:     return $result;
 3508: }
 3509: 
 3510: sub display_url {
 3511:     my ($url,$skiplast) = @_;
 3512:     my $link;
 3513:     if ($url=~m|^/ext/|) {
 3514: 	$url=~s|^/ext/|http://|;
 3515: 	$link='<span class="LC_filename">'.$url.'</span>';
 3516:     } elsif ($url=~m{^(http://|/uploaded/)}) {
 3517: 	$link='<span class="LC_filename">'.$url.'</span>';
 3518:     } else {
 3519:         $link=&Apache::lonhtmlcommon::crumbs(
 3520:                   $url,
 3521:                   'preview',
 3522:                   '',
 3523:                   (($env{'form.catalogmode'} eq 'import')?'parent.statusframe.document.forms.statusform':''),
 3524:                   $skiplast).' ';
 3525:     }
 3526:     return $link;
 3527: }
 3528: 
 3529: ######################################################################
 3530: ######################################################################
 3531: 
 3532: =pod 
 3533: 
 3534: =item &fielded_format_view() 
 3535: 
 3536: =cut
 3537: 
 3538: ######################################################################
 3539: ######################################################################
 3540: sub fielded_format_view {
 3541:     my ($prefix,%values) = @_;
 3542:     my $icon=&Apache::loncommon::icon($values{'url'});
 3543:     my %Translated = &Apache::lonmeta::fieldnames();
 3544:     my $jumpurl=$values{'url'};
 3545:     $jumpurl=~s|^/ext/|http://|;
 3546: 
 3547:     my $result=<<END;
 3548: $prefix <img src="$icon" alt="" />
 3549: <dl>
 3550: <dt>URL:</dt>
 3551:     <dd><a href="$jumpurl?inhibitmenu=yes" 
 3552:          target='preview'>$values{'url'}</a>
 3553: END
 3554:     $result .=
 3555:         &display_tools($values{'title'}, $jumpurl).'
 3556:     </dd>';
 3557:     foreach my $field ('title','author','domain','subject','keywords','notes',
 3558:                        'mimetag','language','creationdate','lastrevisiondate',
 3559:                        'owner','copyrighttag','hostname','abstract') {
 3560:         $result .= (' 'x4).'<dt>'.$Translated{$field}.'</dt>'."\n".
 3561:             (' 'x8).'<dd>'.$values{$field}.'</dd>'."\n";
 3562:     }
 3563:     if (&has_stat_data(\%values)) {
 3564:         foreach my $field (&statfields()) {
 3565:             $result .= (' 'x4).'<dt>'.$Translated{$field}.'</dt>'."\n".
 3566:                 (' 'x8).'<dd>'.$values{$field}.'</dd>'."\n";
 3567:         }
 3568:     }
 3569:     if (&has_eval_data(\%values)) {
 3570:         foreach my $field (&evalfields()) {
 3571:             $result .= (' 'x4).'<dt>'.$Translated{$field}.'</dt>'."\n".
 3572:                 (' 'x8).'<dd>'.$values{$field}.'</dd>'."\n";
 3573:         }
 3574:     }
 3575:     $result .= "</dl>\n";
 3576:     $result .= $values{'extrashow'};
 3577:     return $result;
 3578: }
 3579: 
 3580: ######################################################################
 3581: ######################################################################
 3582: 
 3583: =pod 
 3584: 
 3585: =item &xml_sgml_view() 
 3586: 
 3587: =back 
 3588: 
 3589: =cut
 3590: 
 3591: ######################################################################
 3592: ######################################################################
 3593: sub xml_sgml_view {
 3594:     my ($prefix,%values) = @_;
 3595:     my $xml = '<LonCapaResource>'."\n";
 3596:     # The usual suspects
 3597:     foreach my $field ('url','title','author','subject','keywords','notes','domain') {
 3598:         $xml .= qq{<$field>$values{$field}</$field>}."\n";
 3599:     }
 3600:     #
 3601:     $xml .= "<mimeInfo>\n";
 3602:     foreach my $field ('mime','mimetag') {
 3603:         $xml .= qq{<$field>$values{$field}</$field>}."\n";
 3604:     }
 3605:     $xml .= "</mimeInfo>\n";
 3606:     #
 3607:     $xml .= "<languageInfo>\n";
 3608:     foreach my $field ('language','languagetag') {
 3609:         $xml .= qq{<$field>$values{$field}</$field>}."\n";
 3610:     }
 3611:     $xml .= "</languageInfo>\n";
 3612:     #
 3613:     foreach my $field ('creationdate','lastrevisiondate','owner') {
 3614:         $xml .= qq{<$field>$values{$field}</$field>}."\n";
 3615:     }
 3616:     #
 3617:     $xml .= "<copyrightInfo>\n";
 3618:     foreach my $field ('copyright','copyrighttag') {
 3619:         $xml .= qq{<$field>$values{$field}</$field>}."\n";
 3620:     }
 3621:     $xml .= "</copyrightInfo>\n";
 3622:     $xml .= qq{<repositoryLocation>$values{'hostname'}</repositoryLocation>}.
 3623:         "\n";
 3624:     $xml .= qq{<shortabstract>$values{'shortabstract'}</shortabstract>}."\n";
 3625:     #
 3626:     if (&has_stat_data(\%values)){
 3627:         $xml .= "<problemstatistics>\n";
 3628:         foreach my $field (&statfields()) {
 3629:             $xml .= qq{<$field>$values{$field}</$field>}."\n";            
 3630:         }
 3631:         $xml .= "</problemstatistics>\n";
 3632:     }
 3633:     #
 3634:     if (&has_eval_data(\%values)) {
 3635:         $xml .= "<evaluation>\n";
 3636:         foreach my $field (&evalfields) {
 3637:             $xml .= qq{<$field>$values{$field}</$field>}."\n";            
 3638:         }
 3639:         $xml .= "</evaluation>\n";
 3640:     }    
 3641:     #
 3642:     $xml .= "</LonCapaResource>\n";
 3643:     $xml = &HTML::Entities::encode($xml,'<>&');
 3644:     my $result=<<END;
 3645: $prefix
 3646: <pre>
 3647: $xml
 3648: </pre>
 3649: $values{'extrashow'}
 3650: END
 3651:     return $result;
 3652: }
 3653: 
 3654: ######################################################################
 3655: ######################################################################
 3656: 
 3657: =pod 
 3658: 
 3659: =item &filled() see if field is filled.
 3660: 
 3661: =cut
 3662: 
 3663: ######################################################################
 3664: ######################################################################
 3665: sub filled {
 3666:     my ($field)=@_;
 3667:     if ($field=~/\S/ && $field ne 'any') {
 3668:         return 1;
 3669:     } else {
 3670:         return 0;
 3671:     }
 3672: }
 3673: 
 3674: ######################################################################
 3675: ######################################################################
 3676: 
 3677: =pod 
 3678: 
 3679: =item &output_unparsed_phrase_error()
 3680: 
 3681: =cut
 3682: 
 3683: ######################################################################
 3684: ######################################################################
 3685: sub output_unparsed_phrase_error {
 3686:     my ($r,$closebutton,$parms,$hidden_fields,$field)=@_;
 3687:     my $errorstring;
 3688:     if ($field eq 'basicexp') {
 3689:         $errorstring = &mt('Unable to understand the search phrase [_1]. Please modify your search.'
 3690:                            ,'<i>'.$env{'form.basicexp'}.'</i>');
 3691:     } else {
 3692:         $errorstring = &mt('Unable to understand the search phrase [_1]: [_2]'
 3693:                            ,'<i>'.$field.'</i>'
 3694:                            ,$env{'form.'.$field});
 3695:     }
 3696:     my $heading = &mt('Unparsed Field');
 3697:     my $revise  = &mt('Revise search request');
 3698:     # make query information persistent to allow for subsequent revision
 3699:     my $start_page = &Apache::loncommon::start_page('Search');
 3700:     my $end_page   = &Apache::loncommon::end_page();
 3701:     $r->print(<<ENDPAGE);
 3702: $start_page
 3703: <form method="post" action="/adm/searchcat">
 3704: $hidden_fields
 3705: $closebutton
 3706: <hr />
 3707: <h2>$heading</h2>
 3708: <p class="LC_warning">
 3709: $errorstring
 3710: </p>
 3711: <p>
 3712: <a href="/adm/searchcat?$parms&amp;persistent_db_id=$env{'form.persistent_db_id'}">$revise</a>
 3713: </p>
 3714: $end_page
 3715: ENDPAGE
 3716: }
 3717: 
 3718: ######################################################################
 3719: ######################################################################
 3720: 
 3721: =pod 
 3722: 
 3723: =item &output_blank_field_error()
 3724: 
 3725: Output a complete page that indicates the user has not filled in enough
 3726: information to do a search.
 3727: 
 3728: Inputs: $r (Apache request handle), $closebutton, $parms.
 3729: 
 3730: Returns: nothing
 3731: 
 3732: $parms is extra information to include in the 'Revise search request' link.
 3733: 
 3734: =cut
 3735: 
 3736: ######################################################################
 3737: ######################################################################
 3738: sub output_blank_field_error {
 3739:     my ($r,$closebutton,$parms,$hidden_fields)=@_;
 3740:     my $errormsg = &mt('You did not fill in enough information for the search to be started. You need to fill in relevant fields on the search page in order for a query to be processed.');
 3741:     my $revise = &mt('Revise Search Request');
 3742:     my $heading = &mt('Unactionable Search Query');
 3743:     my $start_page = &Apache::loncommon::start_page('Search');
 3744:     my $end_page   = &Apache::loncommon::end_page();
 3745:     if ($closebutton) {
 3746:         $closebutton = '<p>'.$closebutton.'</p><hr />';
 3747:     } else {
 3748:         &Apache::lonhtmlcommon::add_breadcrumb
 3749:             ({href=>'',
 3750:               text=>$heading,});
 3751:         $start_page .= &Apache::lonhtmlcommon::breadcrumbs();
 3752:     }
 3753: 
 3754:     $r->print(<<ENDPAGE);
 3755: $start_page
 3756: <form method="post" action="/adm/searchcat">
 3757: $hidden_fields
 3758: $closebutton
 3759: </form>
 3760: <h2>$heading</h2>
 3761: <p class="LC_warning">
 3762: $errormsg
 3763: </p>
 3764: <p>
 3765: <a href="/adm/searchcat?$parms&amp;persistent_db_id=$env{'form.persistent_db_id'}">$revise</a>
 3766: </p>
 3767: $end_page
 3768: ENDPAGE
 3769:     return;
 3770: }
 3771: 
 3772: ######################################################################
 3773: ######################################################################
 3774: 
 3775: =pod 
 3776: 
 3777: =item &output_date_error()
 3778: 
 3779: Output a full html page with an error message.
 3780: 
 3781: Inputs: 
 3782: 
 3783:     $r, the request pointer.
 3784:     $message, the error message for the user.
 3785:     $closebutton, the specialized close button needed for groupsearch.
 3786: 
 3787: =cut
 3788: 
 3789: ######################################################################
 3790: ######################################################################
 3791: sub output_date_error {
 3792:     my ($r,$message,$closebutton,$hidden_fields)=@_;
 3793:     # make query information persistent to allow for subsequent revision
 3794:     my $start_page = &Apache::loncommon::start_page('Search');
 3795:     my $end_page   = &Apache::loncommon::end_page();
 3796:     my $heading = &mt('Error');
 3797:     $r->print(<<RESULTS);
 3798: $start_page
 3799: <form method="post" action="/adm/searchcat">
 3800: $hidden_fields
 3801: <input type='button' value='Revise search request'
 3802: onclick='this.form.submit();' />
 3803: $closebutton
 3804: </form>
 3805: <hr />
 3806: <h3>$heading</h3>
 3807: <p class="LC_error">
 3808: $message
 3809: </p>
 3810: $end_page
 3811: RESULTS
 3812: }
 3813: 
 3814: ######################################################################
 3815: ######################################################################
 3816: 
 3817: =pod 
 3818: 
 3819: =item &start_fresh_session()
 3820: 
 3821: Cleans the global %groupsearch_db by removing all fields which begin with
 3822: 'pre_' or 'store'.
 3823: 
 3824: =cut
 3825: 
 3826: ######################################################################
 3827: ######################################################################
 3828: sub start_fresh_session {
 3829:     delete $groupsearch_db{'mode_catalog'};
 3830:     foreach (keys(%groupsearch_db)) {
 3831:         if ($_ =~ /^pre_/) {
 3832:             delete $groupsearch_db{$_};
 3833:         }
 3834:         if ($_ =~ /^store/) {
 3835: 	    delete $groupsearch_db{$_};
 3836: 	}
 3837:     }
 3838: }
 3839: 
 3840: 1;
 3841: 
 3842: sub cleanup {
 3843:     if (tied(%groupsearch_db)) {
 3844:         unless (untie(%groupsearch_db)) {
 3845: 	  &Apache::lonnet::logthis('Failed cleanup searchcat: groupsearch_db');
 3846:         }
 3847:     }
 3848:     &Apache::lonmysql::disconnect_from_db();
 3849:     return OK;
 3850: }
 3851: 
 3852: __END__
 3853: 
 3854: =pod
 3855: 
 3856: =back 
 3857: 
 3858: =cut

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>