Annotation of loncom/interface/lonsearchcat.pm, revision 1.223

1.98      harris41    1: # The LearningOnline Network with CAPA
1.108     harris41    2: # Search Catalog
                      3: #
1.223   ! matthew     4: # $Id: lonsearchcat.pm,v 1.222 2004/05/05 14:14:10 matthew Exp $
1.108     harris41    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.
1.98      harris41   14: #
1.108     harris41   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/
1.1       www        27: #
1.121     matthew    28: ###############################################################################
                     29: ###############################################################################
                     30: 
                     31: =pod 
                     32: 
                     33: =head1 NAME
                     34: 
1.140     matthew    35: lonsearchcat - LONCAPA Search Interface
1.121     matthew    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.
1.104     harris41   44: 
1.121     matthew    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 
1.205     www        51: search (on a server basis) is displayed to the user in a separate window.
1.121     matthew    52: 
                     53: =head1 Internals
                     54: 
                     55: =over 4
                     56: 
                     57: =cut
                     58: 
                     59: ###############################################################################
1.98      harris41   60: ###############################################################################
1.121     matthew    61: 
1.1       www        62: package Apache::lonsearchcat;
                     63: 
                     64: use strict;
1.167     www        65: use Apache::Constants qw(:common :http);
1.6       harris41   66: use Apache::lonnet();
                     67: use Apache::File();
1.7       harris41   68: use CGI qw(:standard);
1.41      harris41   69: use Text::Query;
1.101     harris41   70: use GDBM_File;
1.112     harris41   71: use Apache::loncommon();
1.144     matthew    72: use Apache::lonmysql();
1.200     www        73: use Apache::lonmeta;
                     74: use Apache::lonhtmlcommon;
1.186     www        75: use Apache::lonlocal;
1.204     matthew    76: use LONCAPA::lonmetadata();
1.212     matthew    77: use HTML::Entities();
1.1       www        78: 
1.121     matthew    79: ######################################################################
                     80: ######################################################################
1.196     matthew    81: ##
                     82: ## Global variables
                     83: ##
1.121     matthew    84: ######################################################################
                     85: ######################################################################
1.196     matthew    86: my %groupsearch_db;  # Database hash used to save values for the 
                     87:                      # groupsearch RAT interface.
                     88: my %persistent_db;   # gdbm hash which holds data which is supposed to
                     89:                      # persist across calls to lonsearchcat.pm
1.121     matthew    90: 
1.200     www        91: # The different view modes and associated functions
                     92: 
                     93: my %Views = ("detailed" => \&detailed_citation_view,
                     94: 	     "summary"  => \&summary_view,
                     95: 	     "fielded"  => \&fielded_format_view,
                     96: 	     "xml"      => \&xml_sgml_view,
                     97: 	     "compact"  => \&compact_view);
1.101     harris41   98: 
1.121     matthew    99: ######################################################################
                    100: ######################################################################
1.98      harris41  101: sub handler {
                    102:     my $r = shift;
1.197     www       103: #    &set_defaults();
1.196     matthew   104:     #
                    105:     # set form defaults
1.145     matthew   106:     #
1.196     matthew   107:     my $hidden_fields;# Hold all the hidden fields used to keep track
                    108:                       # of the search system state
                    109:     my $importbutton; # button to take the selected results and go to group 
                    110:                       # sorting
                    111:     my $diropendb;    # The full path to the (temporary) search database file.
                    112:                       # This is set and used in &handler() and is also used in 
                    113:                       # &output_results().
                    114:     my $bodytag;  # LON-CAPA standard body tag, gotten from 
                    115:                   # &Apache::lonnet::bodytag. 
                    116:                   # No title, no table, just a <body> tag.
1.157     www       117: 
                    118:     my $loaderror=&Apache::lonnet::overloaderror($r);
                    119:     if ($loaderror) { return $loaderror; }
1.221     matthew   120:     #
1.145     matthew   121:     my $closebutton;  # button that closes the search window 
                    122:                       # This button is different for the RAT compared to
                    123:                       # normal invocation.
                    124:     #
1.186     www       125:     &Apache::loncommon::content_type($r,'text/html');
1.98      harris41  126:     $r->send_http_header;
                    127:     return OK if $r->header_only;
1.156     matthew   128:     ##
                    129:     ## Prevent caching of the search interface window.  Hopefully this means
                    130:     ## we will get the launch=1 passed in a little more.
                    131:     &Apache::loncommon::no_cache($r);
1.145     matthew   132:     ## 
                    133:     ## Pick up form fields passed in the links.
                    134:     ##
                    135:     &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
1.146     matthew   136:              ['catalogmode','launch','acts','mode','form','element','pause',
1.158     matthew   137:               'phase','persistent_db_id','table','start','show',
1.191     albertel  138:               'cleargroupsort','titleelement']);
1.146     matthew   139:     ##
                    140:     ## The following is a trick - we wait a few seconds if asked to so
                    141:     ##     the daemon running the search can get ahead of the daemon
                    142:     ##     printing the results.  We only need (theoretically) to do
                    143:     ##     this once, so the pause indicator is deleted
                    144:     ##
                    145:     if (exists($ENV{'form.pause'})) {
1.181     matthew   146:         sleep(1);
1.146     matthew   147:         delete($ENV{'form.pause'});
                    148:     }
1.143     matthew   149:     ##
                    150:     ## Initialize global variables
                    151:     ##
1.121     matthew   152:     my $domain  = $r->dir_config('lonDefDomain');
1.213     matthew   153:     $diropendb= "/home/httpd/perl/tmp/".
                    154:         "$ENV{'user.domain'}_$ENV{'user.name'}_searchcat.db";
1.145     matthew   155:     #
                    156:     # set the name of the persistent database
1.146     matthew   157:     #          $ENV{'form.persistent_db_id'} can only have digits in it.
1.145     matthew   158:     if (! exists($ENV{'form.persistent_db_id'}) ||
1.147     matthew   159:         ($ENV{'form.persistent_db_id'} =~ /\D/) ||
                    160:         ($ENV{'form.launch'} eq '1')) {
1.145     matthew   161:         $ENV{'form.persistent_db_id'} = time;
                    162:     }
1.155     matthew   163:     $bodytag=&Apache::loncommon::bodytag(undef,undef,undef,1);
1.146     matthew   164:     my $persistent_db_file = "/home/httpd/perl/tmp/".
1.145     matthew   165:         &Apache::lonnet::escape($domain).
                    166:             '_'.&Apache::lonnet::escape($ENV{'user.name'}).
                    167:                 '_'.$ENV{'form.persistent_db_id'}.'_persistent_search.db';
1.146     matthew   168:     ##
1.209     matthew   169:     &Apache::lonhtmlcommon::clear_breadcrumbs();
                    170:     if (exists($ENV{'request.course.id'}) && $ENV{'request.course.id'} ne '') {
                    171:         &Apache::lonhtmlcommon::add_breadcrumb
                    172:              ({href=>'/adm/searchcat?'.
                    173:                    'catalogmode='.$ENV{'form.catalogmode'}.
                    174:                    '&launch='.$ENV{'form.launch'}.
                    175:                    '&mode='.$ENV{'form.mode'},
                    176:               text=>"Course and Catalog Search",
                    177:               bug=>'Searching',});
                    178:     } else {
                    179:         &Apache::lonhtmlcommon::add_breadcrumb
                    180:              ({href=>'/adm/searchcat?'.
                    181:                    'catalogmode='.$ENV{'form.catalogmode'}.
                    182:                    '&launch='.$ENV{'form.launch'}.
                    183:                    '&mode='.$ENV{'form.mode'},
                    184:               text=>"Catalog Search",
                    185:               bug=>'Searching',});
                    186:     }
                    187:     #
1.221     matthew   188:     if ($ENV{'form.phase'} !~ m/(basic|adv|course)_search/) {
                    189:         if (! &get_persistent_form_data($persistent_db_file)) {
                    190:             if ($ENV{'form.phase'} =~ /(run_search|results)/) {
                    191:                 &Apache::lonnet::logthis('lonsearchcat:'.
                    192:                                          'Unable to recover data from '.
                    193:                                          $persistent_db_file);
                    194:                 $r->print(<<END);
1.150     matthew   195: <html>
                    196: <head><title>LON-CAPA Search Error</title></head>
1.155     matthew   197: $bodytag
1.150     matthew   198: We were unable to retrieve data describing your search.  This is a serious
                    199: error and has been logged.  Please alert your LON-CAPA administrator.
                    200: </body>
                    201: </html>
                    202: END
1.221     matthew   203:                 return OK;
                    204:             }
1.150     matthew   205:         }
1.221     matthew   206:     } else {
                    207:         &clean_up_environment();
1.147     matthew   208:     }
1.124     matthew   209:     ##
1.143     matthew   210:     ## Clear out old values from groupsearch database
1.124     matthew   211:     ##
1.146     matthew   212:     untie %groupsearch_db if (tied(%groupsearch_db));
1.158     matthew   213:     if (($ENV{'form.cleargroupsort'} eq '1') || 
                    214:         (($ENV{'form.launch'} eq '1') && 
                    215:          ($ENV{'form.catalogmode'} eq 'groupsearch'))) {
1.148     matthew   216: 	if (tie(%groupsearch_db,'GDBM_File',$diropendb,&GDBM_WRCREAT(),0640)) {
1.101     harris41  217: 	    &start_fresh_session();
1.142     matthew   218: 	    untie %groupsearch_db;
1.158     matthew   219:             delete($ENV{'form.cleargroupsort'});
1.122     matthew   220: 	} else {
1.155     matthew   221:             # This is a stupid error to give to the user.  
                    222:             # It really tells them nothing.
                    223: 	    $r->print('<html><head></head>'.$bodytag.
                    224:                       'Unable to tie hash to db file</body></html>');
1.101     harris41  225: 	    return OK;
                    226: 	}
                    227:     }
1.124     matthew   228:     ##
1.150     matthew   229:     ## Configure hidden fields
1.124     matthew   230:     ##
1.145     matthew   231:     $hidden_fields = '<input type="hidden" name="persistent_db_id" value="'.
1.150     matthew   232:         $ENV{'form.persistent_db_id'}.'" />'."\n";
                    233:     if (exists($ENV{'form.catalogmode'})) {
1.223   ! matthew   234:         $hidden_fields .= &hidden_field('catalogmode');
1.150     matthew   235:     }
                    236:     if (exists($ENV{'form.form'})) {
1.223   ! matthew   237:         $hidden_fields .= &hidden_field('form');
1.150     matthew   238:     }
                    239:     if (exists($ENV{'form.element'})) {
1.223   ! matthew   240:         $hidden_fields .= &hidden_field('element');
1.150     matthew   241:     }
1.191     albertel  242:     if (exists($ENV{'form.titleelement'})) {
1.223   ! matthew   243:         $hidden_fields .= &hidden_field('titleelement');
1.191     albertel  244:     }
1.150     matthew   245:     if (exists($ENV{'form.mode'})) {
1.223   ! matthew   246:         $hidden_fields .= &hidden_field('mode');
1.150     matthew   247:     }
                    248:     ##
                    249:     ## Configure dynamic components of interface
1.146     matthew   250:     ##
1.98      harris41  251:     if ($ENV{'form.catalogmode'} eq 'interactive') {
1.150     matthew   252:         $closebutton="<input type='button' name='close' value='CLOSE' ";
                    253:         if ($ENV{'form.phase'} =~ /(results|run_search)/) {
                    254: 	    $closebutton .="onClick='parent.close()'";
                    255:         } else {
                    256:             $closebutton .="onClick='self.close()'";
                    257:         }
                    258:         $closebutton .=">\n";
1.124     matthew   259:     } elsif ($ENV{'form.catalogmode'} eq 'groupsearch') {
1.150     matthew   260:         $closebutton="<input type='button' name='close' value='CLOSE' ";
                    261:         if ($ENV{'form.phase'} =~ /(results|run_search)/) {
                    262: 	    $closebutton .="onClick='parent.close()'";
                    263:         } else {
                    264:             $closebutton .="onClick='self.close()'";
                    265:         }
                    266:         $closebutton .= ">";
1.98      harris41  267:         $importbutton=<<END;
                    268: <input type='button' name='import' value='IMPORT'
                    269: onClick='javascript:select_group()'>
                    270: END
1.146     matthew   271:     } else {
                    272:         $closebutton = '';
                    273:         $importbutton = '';
1.98      harris41  274:     }
1.124     matthew   275:     ##
1.146     matthew   276:     ## Sanity checks on form elements
1.124     matthew   277:     ##
1.146     matthew   278:     if (!defined($ENV{'form.viewselect'})) {
1.150     matthew   279:         if (($ENV{'form.catalogmode'} eq 'groupsearch') ||
                    280:             ($ENV{'form.catalogmode'} eq 'interactive')) {
                    281:             $ENV{'form.viewselect'} ="Compact View";
                    282:         } else {
                    283:             $ENV{'form.viewselect'} ="Detailed Citation View";
                    284:         }
1.146     matthew   285:     }
1.149     matthew   286:     $ENV{'form.phase'} = 'disp_basic' if (! exists($ENV{'form.phase'}));
1.151     matthew   287:     $ENV{'form.show'} = 20 if (! exists($ENV{'form.show'}));
1.209     matthew   288:     #
1.219     matthew   289:     $ENV{'form.searchmode'} = 'basic' if (! exists($ENV{'form.searchmode'}));
1.209     matthew   290:     if ($ENV{'form.phase'} eq 'adv_search' ||
                    291:         $ENV{'form.phase'} eq 'disp_adv') {
                    292:         $ENV{'form.searchmode'} = 'advanced';
                    293:     } elsif ($ENV{'form.phase'} eq 'course_search') {
                    294:         $ENV{'form.searchmode'} = 'course_search';
                    295:     }
                    296:     #
                    297:     if ($ENV{'form.searchmode'} eq 'advanced') {
                    298:         &Apache::lonhtmlcommon::add_breadcrumb
                    299:             ({href=>'/adm/searchcat?phase=disp_adv&'.
                    300:                   'catalogmode='.$ENV{'form.catalogmode'}.
                    301:                   '&launch='.$ENV{'form.launch'}.
                    302:                   '&mode='.$ENV{'form.mode'},
                    303:                   text=>"Advanced Search",
                    304:                   bug=>'Searching',});
                    305:     } elsif ($ENV{'form.searchmode'} eq 'course search') {
                    306:         &Apache::lonhtmlcommon::add_breadcrumb
                    307:             ({href=>'/adm/searchcat?phase=disp_adv&'.
                    308:                   'catalogmode='.$ENV{'form.catalogmode'}.
                    309:                   '&launch='.$ENV{'form.launch'}.
                    310:                   '&mode='.$ENV{'form.mode'},
                    311:                   text=>"Course Search",
                    312:                   bug=>'Searching',});
                    313:     }
1.146     matthew   314:     ##
                    315:     ## Switch on the phase
                    316:     ##
                    317:     if ($ENV{'form.phase'} eq 'disp_basic') {
1.196     matthew   318:         &print_basic_search_form($r,$closebutton,$hidden_fields);
1.146     matthew   319:     } elsif ($ENV{'form.phase'} eq 'disp_adv') {
1.196     matthew   320:         &print_advanced_search_form($r,$closebutton,$hidden_fields);
1.146     matthew   321:     } elsif ($ENV{'form.phase'} eq 'results') {
1.196     matthew   322:         &display_results($r,$importbutton,$closebutton,$diropendb);
1.151     matthew   323:     } elsif ($ENV{'form.phase'} =~ /^(sort|run_search)$/) {
1.146     matthew   324:         my ($query,$customquery,$customshow,$libraries,$pretty_string) =
                    325:             &get_persistent_data($persistent_db_file,
                    326:                  ['query','customquery','customshow',
                    327:                   'libraries','pretty_string']);
1.151     matthew   328:         if ($ENV{'form.phase'} eq 'sort') {
                    329:             &print_sort_form($r,$pretty_string);
                    330:         } elsif ($ENV{'form.phase'} eq 'run_search') {
                    331:             &run_search($r,$query,$customquery,$customshow,
                    332:                         $libraries,$pretty_string);
                    333:         }
1.167     www       334:     } elsif ($ENV{'form.phase'} eq 'course_search') {
                    335:         &course_search($r);
1.146     matthew   336:     } elsif(($ENV{'form.phase'} eq 'basic_search') ||
                    337:             ($ENV{'form.phase'} eq 'adv_search')) {
                    338:         # Set up table
                    339:         if (! defined(&create_results_table())) {
1.198     www       340: 	    my $errorstring=&Apache::lonmysql::get_error();
1.211     matthew   341:             &Apache::lonnet::logthis('lonsearchcat.pm: Unable to create '.
                    342:                                      'needed table.  lonmysql error:'.
                    343:                                      $errorstring);
1.147     matthew   344:             $r->print(<<END);
                    345: <html><head><title>Search Error</title></head>
1.155     matthew   346: $bodytag
1.147     matthew   347: Unable to create table in which to store search results.  
                    348: The search has been aborted.
                    349: </body>
                    350: </html>
                    351: END
                    352:             return OK;
1.146     matthew   353:         }
1.147     matthew   354:         delete($ENV{'form.launch'});
1.146     matthew   355:         if (! &make_form_data_persistent($r,$persistent_db_file)) {
1.147     matthew   356:             $r->print(<<END);
                    357: <html><head><title>Search Error</title></head>
1.155     matthew   358: $bodytag
1.147     matthew   359: Unable to properly store search information.  The search has been aborted.
                    360: </body>
                    361: </html>
                    362: END
                    363:             return OK;
1.146     matthew   364:         }
1.145     matthew   365:         #
1.139     matthew   366:         # We are running a search
1.134     matthew   367:         my ($query,$customquery,$customshow,$libraries) = 
                    368:             (undef,undef,undef,undef);
1.143     matthew   369:         my $pretty_string;
1.146     matthew   370:         if ($ENV{'form.phase'} eq 'basic_search') {
1.180     matthew   371:             ($query,$pretty_string,$libraries) = 
1.196     matthew   372:                 &parse_basic_search($r,$closebutton,$hidden_fields);
1.146     matthew   373:         } else {                      # Advanced search
1.143     matthew   374:             ($query,$customquery,$customshow,$libraries,$pretty_string) 
1.196     matthew   375:                 = &parse_advanced_search($r,$closebutton,$hidden_fields);
1.134     matthew   376:             return OK if (! defined($query));
                    377:         }
1.152     matthew   378:         &make_persistent({ query => $query,
1.146     matthew   379:                            customquery => $customquery,
                    380:                            customshow => $customshow,
                    381:                            libraries => $libraries,
                    382:                            pretty_string => $pretty_string },
                    383:                          $persistent_db_file);
1.145     matthew   384:         ##
1.146     matthew   385:         ## Print out the frames interface
1.145     matthew   386:         ##
1.146     matthew   387:         &print_frames_interface($r);
1.124     matthew   388:     }
                    389:     return OK;
                    390: } 
1.98      harris41  391: 
1.221     matthew   392: #
                    393: # The mechanism used to store values away and retrieve them does not
                    394: # handle the case of missing environment variables being significant.
                    395: #
                    396: # This routine sets non existant checkbox form elements to ''.
                    397: #
                    398: sub clean_up_environment {
                    399:     if ($ENV{'form.phase'} eq 'basic_search') {
                    400:         if (! exists($ENV{'form.related'})) {
                    401:             $ENV{'form.related'} = '';
                    402:         }
                    403:         if (! exists($ENV{'form.domains'})) {
                    404:             $ENV{'form.domains'} = '';
                    405:         }
                    406:     } elsif ($ENV{'form.phase'} eq 'adv_search') {
                    407:         foreach my $field ('title','keywords','notes',
                    408:                            'abstract','standards','mime') {
                    409:             if (! exists($ENV{'form.'.$field.'_related'})) {
                    410:                 $ENV{'form.'.$field.'_related'} = '';
                    411:             }
                    412:         }
                    413:     } elsif ($ENV{'form.phase'} eq 'course_search') {
                    414:         if (! exists($ENV{'form.crsrelated'})) {
                    415:             $ENV{'form.crsrelated'} = '';
                    416:         }
                    417:     }
                    418: }
                    419: 
1.223   ! matthew   420: sub hidden_field {
        !           421:     my ($name,$value) = @_;
        !           422:     if (! defined($value)) {
        !           423:         $value = $ENV{'form.'.$name};
        !           424:     }
        !           425:     return '<input type="hidden" name="'.$name.'" value="'.$value.'" />'.$/;
        !           426: }
        !           427: 
1.124     matthew   428: ######################################################################
                    429: ######################################################################
1.196     matthew   430: ##
                    431: ##   Course Search
                    432: ##
                    433: ######################################################################
                    434: ######################################################################
                    435: {   # Scope the course search to avoid global variables
                    436: #
                    437: # Variables For course search
                    438: my %alreadyseen;
                    439: my %hash;
                    440: my $totalfound;
1.124     matthew   441: 
1.167     www       442: sub course_search {
                    443:     my $r=shift;
1.217     matthew   444:     my $bodytag=&Apache::loncommon::bodytag('Course Search');
1.167     www       445:     my $pretty_search_string = '<b>'.$ENV{'form.courseexp'}.'</b>';
                    446:     my $search_string = $ENV{'form.courseexp'};
                    447:     my @New_Words;
                    448:     if ($ENV{'form.crsrelated'}) {
                    449:         ($search_string,@New_Words) = &related_version($ENV{'form.courseexp'});
                    450:         if (@New_Words) {
1.200     www       451:             $pretty_search_string .= ' '.&mt("with related words").": <b>@New_Words</b>.";
1.167     www       452:         } else {
1.200     www       453:             $pretty_search_string .= ' '.&mt('with no related words').".";
1.167     www       454:         }
                    455:     }
                    456:     my $fulltext=$ENV{'form.crsfulltext'};
                    457:     my @allwords=($search_string,@New_Words);
1.169     www       458:     $totalfound=0;
1.167     www       459:     $r->print('<html><head><title>LON-CAPA Course Search</title></head>'.
1.203     www       460: 	      $bodytag.'<hr /><center><font size="+2" face="arial">'.$pretty_search_string.'</font></center><hr />');
1.167     www       461:     $r->rflush();
                    462: # ======================================================= Go through the course
1.196     matthew   463:     undef %alreadyseen;
                    464:     %alreadyseen=();
1.169     www       465:     my $c=$r->connection;
1.196     matthew   466:     if (tie(%hash,'GDBM_File',$ENV{'request.course.fn'}.".db",
                    467:             &GDBM_READER(),0640)) {
                    468:         foreach (keys %hash) {
                    469:             if ($c->aborted()) { last; }
                    470:             if (($_=~/^src\_(.+)$/) && (!$alreadyseen{$hash{$_}})) {
                    471:                 &checkonthis($r,$hash{$_},0,$hash{'title_'.$1},$fulltext,
                    472:                              @allwords);
                    473:             }
                    474:         }
                    475:         untie(%hash);
                    476:     }
1.169     www       477:     unless ($totalfound) {
1.187     www       478: 	$r->print('<p>'.&mt('No resources found').'.</p>');
1.169     www       479:     }
1.167     www       480: # =================================================== Done going through course
                    481:     $r->print('</body></html>');
                    482: }
                    483: 
                    484: # =============================== This pulls up a resource and its dependencies
                    485: 
                    486: sub checkonthis {
1.168     www       487:     my ($r,$url,$level,$title,$fulltext,@allwords)=@_;
1.167     www       488:     $alreadyseen{$url}=1;
                    489:     $r->rflush();
                    490:     my $result=&Apache::lonnet::metadata($url,'title').' '.
                    491:                &Apache::lonnet::metadata($url,'subject').' '.
                    492:                &Apache::lonnet::metadata($url,'abstract').' '.
                    493:                &Apache::lonnet::metadata($url,'keywords');
                    494:     if (($url) && ($fulltext)) {
1.168     www       495: 	$result.=&Apache::lonnet::ssi_body($url);
1.167     www       496:     }
                    497:     $result=~s/\s+/ /gs;
                    498:     my $applies=0;
                    499:     foreach (@allwords) {
                    500:         if ($_=~/\w/) {
                    501: 	   if ($result=~/$_/si) {
                    502: 	      $applies++;
                    503:            }
                    504:        }
                    505:     }
                    506: # Does this resource apply?
                    507:     if ($applies) {
                    508:        $r->print('<br />');
                    509:        for (my $i=0;$i<=$level*5;$i++) {
                    510:            $r->print('&nbsp;');
                    511:        }
                    512:        $r->print('<a href="'.$url.'" target="cat">'.
1.169     www       513: 		 ($title?$title:$url).'</a><br />');
                    514:        $totalfound++;
                    515:     } elsif ($fulltext) {
                    516:        $r->print(' .');
1.167     www       517:     }
1.169     www       518:     $r->rflush();
1.167     www       519: # Check also the dependencies of this one
                    520:     my $dependencies=
                    521:                 &Apache::lonnet::metadata($url,'dependencies');
                    522:     foreach (split(/\,/,$dependencies)) {
                    523:        if (($_=~/^\/res\//) && (!$alreadyseen{$_})) {
1.168     www       524:           &checkonthis($r,$_,$level+1,'',$fulltext,@allwords);
1.167     www       525:        }
                    526:     }
                    527: }
                    528: 
1.196     matthew   529: sub untiehash {
                    530:     if (tied(%hash)) {
                    531:         untie(%hash);
                    532:     }
                    533: }
                    534: 
                    535: } # End of course search scoping
                    536: 
1.207     matthew   537: sub search_html_header {
                    538:     my $Str = <<ENDHEADER;
                    539: <html>
                    540: <head>
                    541: <title>The LearningOnline Network with CAPA</title>
                    542: </head>
                    543: ENDHEADER
                    544:     return $Str;
                    545: }
                    546: 
1.167     www       547: ######################################################################
                    548: ######################################################################
                    549: 
1.124     matthew   550: =pod 
                    551: 
1.146     matthew   552: =item &print_basic_search_form() 
1.124     matthew   553: 
1.204     matthew   554: Prints the form for the basic search.  Sorry the name is so cryptic.
1.124     matthew   555: 
                    556: =cut
                    557: 
                    558: ######################################################################
                    559: ######################################################################
1.204     matthew   560: sub print_basic_search_form {
1.196     matthew   561:     my ($r,$closebutton,$hidden_fields) = @_;
1.203     www       562:     my $bodytag=&Apache::loncommon::bodytag('Search').
1.217     matthew   563:         &Apache::lonhtmlcommon::breadcrumbs(undef,'Searching','Searching',
1.209     matthew   564:                                             undef,undef,! $ENV{'form.launch'});
1.207     matthew   565:     my $scrout = &search_html_header().$bodytag;
                    566:     if (&Apache::lonnet::allowed('bre',$ENV{'request.role.domain'})) {
1.213     matthew   567:         # Define interface components
                    568:         my $userelatedwords=
                    569:             &mt('[_1] use related words',
                    570:                 &Apache::lonhtmlcommon::checkbox
1.221     matthew   571:                 ('related',$ENV{'form.related'},'related'));
1.213     matthew   572:         my $onlysearchdomain=
                    573:             &mt('[_1] only search domain [_2]',
1.221     matthew   574:                 &Apache::lonhtmlcommon::checkbox('domains',
                    575:                                                  $ENV{'form.domains'},
                    576:                                                  $r->dir_config('lonDefDomain')
                    577:                                                  ),
                    578:                 $r->dir_config('lonDefDomain')
                    579:                 );
1.213     matthew   580:         my $adv_search_link = 
                    581:             '<a href="/adm/searchcat?'.
                    582:             'phase=disp_adv&'.
                    583:             'catalogmode='.$ENV{'form.catalogmode'}.
                    584:             '&launch='.$ENV{'form.launch'}.
                    585:             '&mode='.$ENV{'form.mode'}.
                    586:             '">'.&mt('Advanced Search').'</a>';
                    587:         #
                    588:         $scrout.='<form name="loncapa_search" method="post" '.
                    589:             'action="/adm/searchcat">'.
                    590:             '<input type="hidden" name="phase" value="basic_search" />'.
                    591:             $hidden_fields;
                    592:         #
                    593:         $scrout .= '<center>'.$/;
                    594:         if ($ENV{'request.course.id'}) {
                    595:             $scrout .= '<h1>'.&mt('LON-CAPA Catalog Search').'</h1>';
                    596:         } else {
                    597:             # No need to tell them they are searching
                    598:             $scrout.= ('<br />'x2);
                    599:         }
                    600:         $scrout.='<table>'.
                    601:             '<tr><td align="center" valign="top">'.
1.208     matthew   602:             &Apache::lonhtmlcommon::textbox('basicexp',
1.213     matthew   603:                                             $ENV{'form.basicexp'},50).'<br />'.
                    604:             '<font size="-1">'.&searchhelp().'</font>'.'</td>'.
                    605:             '<td><font size="-1">'.
                    606:             '<nobr>'.('&nbsp;'x3).$adv_search_link.'</nobr>'.'<br />'.
                    607:             '<nobr>'.('&nbsp;'x1).$userelatedwords.'</nobr>'.'<br />'.
                    608:             '<nobr>'.('&nbsp;'x1).$onlysearchdomain.'</nobr>'.'<br />'.
                    609:             '</font></td>'.
                    610:             '</tr>'.$/;
                    611:         #
                    612: #        $scrout .= '<tr><td align="center">'.
                    613: #            '<font size="-1">'.
                    614: #            $userelatedwords.('&nbsp;'x3).
                    615: #            $onlysearchdomain.('&nbsp;'x2).$adv_search_link.
                    616: #            '</font>'.
                    617: #            '</td></tr>'.$/;
                    618:         $scrout .= '<tr><td align="center" colspan="2">'.
                    619:             '<font size="-1">'.
                    620:             '<input type="submit" name="basicsubmit" '.
                    621:             'value="'.&mt('Search').'" />'.
1.223   ! matthew   622:             ('&nbsp;'x2).$closebutton.('&nbsp;'x2).
        !           623:             &viewoptions().
1.213     matthew   624:             '</font>'.
                    625:             '</td></tr>'.$/;
                    626:         $scrout .= '</table>'.$/.'</center>'.'</form>';
1.180     matthew   627:     }
                    628:     if ($ENV{'request.course.id'}) {
1.213     matthew   629: 	my %lt=&Apache::lonlocal::texthash('srch' => 'Search',
1.187     www       630:                                            'header' => 'Course Search',
                    631: 	 'note' => 'Enter terms or phrases, then press "Search" below',
1.200     www       632: 	 'use' => 'use related words',
                    633: 	 'full' =>'fulltext search (time consuming)'
1.187     www       634: 					   );
1.180     matthew   635:         $scrout.=(<<ENDCOURSESEARCH);
1.213     matthew   636: <form name="loncapa_search" method="post" action="/adm/searchcat">
                    637: <center>
1.180     matthew   638: <hr />
1.187     www       639: <h1>$lt{'header'}</h1>    
1.167     www       640: <input type="hidden" name="phase" value="course_search" />
                    641: $hidden_fields
                    642: <p>
1.187     www       643: $lt{'note'}.
1.167     www       644: </p>
                    645: <p>
                    646: <table>
                    647: <tr><td>
                    648: ENDCOURSESEARCH
1.180     matthew   649:         $scrout.='&nbsp;'.
1.200     www       650:             &Apache::lonhtmlcommon::textbox('courseexp',
                    651:                                   $ENV{'form.courseexp'},40);
1.180     matthew   652:         my $crscheckbox = 
1.200     www       653:             &Apache::lonhtmlcommon::checkbox('crsfulltext',
                    654:                                    $ENV{'form.crsfulltext'});
1.180     matthew   655:         my $relcheckbox = 
1.200     www       656:             &Apache::lonhtmlcommon::checkbox('crsrelated',
                    657: 				   $ENV{'form.crsrelated'});
1.180     matthew   658:         $scrout.=(<<ENDENDCOURSE);
1.167     www       659: </td></tr>
1.200     www       660: <tr><td>$relcheckbox $lt{'use'}</td><td></td></tr>
                    661: <tr><td>$crscheckbox $lt{'full'}</td><td></td></tr>
1.167     www       662: </table><p>
1.187     www       663: &nbsp;<input type="submit" name="coursesubmit" value='$lt{'srch'}' />
1.167     www       664: </p>
1.213     matthew   665: </center>
                    666: </form>
1.167     www       667: ENDENDCOURSE
1.180     matthew   668:     }
1.167     www       669:     $scrout.=(<<ENDDOCUMENT);
1.124     matthew   670: </body>
                    671: </html>
                    672: ENDDOCUMENT
1.146     matthew   673:     $r->print($scrout);
                    674:     return;
1.124     matthew   675: }
                    676: ######################################################################
                    677: ######################################################################
                    678: 
                    679: =pod 
                    680: 
                    681: =item &advanced_search_form() 
                    682: 
1.204     matthew   683: Prints the advanced search form.
1.124     matthew   684: 
                    685: =cut
                    686: 
                    687: ######################################################################
                    688: ######################################################################
1.146     matthew   689: sub print_advanced_search_form{
1.196     matthew   690:     my ($r,$closebutton,$hidden_fields) = @_;
1.217     matthew   691:     my $bodytag=&Apache::loncommon::bodytag('Advanced Catalog Search').
                    692:         &Apache::lonhtmlcommon::breadcrumbs(undef,'Searching',
                    693:                                             'Searching',
                    694:                                             undef,undef,
                    695:                                             ! $ENV{'form.launch'});
                    696: 
1.200     www       697:     my %lt=&Apache::lonlocal::texthash('srch' => 'Search',
                    698: 				       'reset' => 'Reset',
                    699: 				       'help' => 'Help');
1.217     matthew   700:     my $advanced_buttons=<<"END";
1.200     www       701: <input type="submit" name="advancedsubmit" value='$lt{"srch"}' />
                    702: <input type="reset" name="reset" value='$lt{"reset"}' />
1.129     matthew   703: $closebutton
                    704: END
1.207     matthew   705:     my $scrout=&search_html_header();
                    706:     $scrout .= <<"ENDHEADER";
1.154     www       707: $bodytag
1.200     www       708: <form method="post" action="/adm/searchcat" name="advsearch">
1.217     matthew   709: <p>
1.129     matthew   710: $advanced_buttons
1.124     matthew   711: ENDHEADER
1.208     matthew   712:     $scrout.=('&nbsp;'x2).&viewoptions().'</p>'.$hidden_fields. 
                    713:         '<input type="hidden" name="phase" value="adv_search" />';
1.200     www       714:     my %fields=&Apache::lonmeta::fieldnames();
1.208     matthew   715:     #
1.217     matthew   716:     $scrout .= '<h3>'.&mt('Standard Metadata').'</h3>';
                    717:     $scrout .= "<table>\n";
                    718:     $scrout .= '<tr><td>&nbsp;</td><td colspan="2"><font size="-1">'.
                    719:         ('&nbsp;'x2).&searchhelp()."</font></td></tr>\n";
1.208     matthew   720:     my %related_word_search = 
1.217     matthew   721:         ('title'    => 1,
                    722:          'author'   => 0,
                    723:          'owner'    => 0,
                    724:          'authorspace'  => 0,
                    725:          'modifyinguser'=> 0,
                    726:          'keywords' => 1,
                    727:          'notes'    => 1,
                    728:          'abstract' => 1,
                    729:          'standards'=> 1,
                    730:          'mime'     => 1,
1.208     matthew   731:          );
1.209     matthew   732:     #
1.208     matthew   733:     foreach my $field ('title','author','owner','authorspace','modifyinguser',
                    734: 	     'keywords','notes','abstract','standards','mime') {
                    735: 	$scrout.='<tr><td align="right">'.&titlefield($fields{$field}).'</td><td>'.
                    736: 	    &Apache::lonmeta::prettyinput($field,
                    737:                                           $ENV{'form.'.$field},
                    738:                                           $field,
                    739:                                           'advsearch',
                    740: 					  $related_word_search{$field},
                    741:                                           '</td><td align="left">',
                    742:                                           $ENV{'form.'.$field.'_related'},
                    743:                                           50);
                    744:         if ($related_word_search{$field}) {
                    745:             $scrout .= 'related words';
                    746:         } else {
                    747:             $scrout .= '</td><td>&nbsp;';
                    748:         }
                    749:         $scrout .= '</td></tr>'.$/;
                    750:     }
                    751:     foreach my $field ('lowestgradelevel','highestgradelevel') {
                    752: 	$scrout.='<tr>'.
                    753:             '<td align="right">'.&titlefield($fields{$field}).'</td>'.
                    754:             '<td colspan="2">'.
                    755: 	    &Apache::lonmeta::prettyinput($field,
                    756:                                           $ENV{'form.'.$field},
                    757:                                           $field,
                    758:                                           'advsearch',
                    759: 					  0).
                    760:                                           '</td></tr>'.$/;
1.200     www       761:     }
1.208     matthew   762:     $scrout.='<tr><td align="right">'.
                    763: 	&titlefield(&mt('MIME Type Category')).'</td><td colspan="2">'. 
1.202     www       764: 	    &Apache::loncommon::filecategoryselect('category',
                    765: 						   $ENV{'form.category'}).
1.208     matthew   766: 	    '</td></tr>'.$/;
                    767:     $scrout.='<tr><td align="right" valign="top">'.
                    768: 	&titlefield(&mt('Domains')).'</td><td colspan="2">'. 
1.202     www       769: 	    &Apache::loncommon::domain_select('domains',
                    770: 						   $ENV{'form.domains'},1).
1.208     matthew   771: 	    '</td></tr>'.$/;
1.217     matthew   772:     #
                    773:     # Misc metadata
                    774:     $scrout.='<tr><td align="right" valign="top">'.
                    775: 	&titlefield(&mt('Copyright/Distribution')).'</td><td colspan="2">'.
                    776:         &Apache::lonmeta::selectbox('copyright',
                    777:                                     '',,
                    778:                                     \&Apache::loncommon::copyrightdescription,
                    779:                                     ( undef,
                    780:                                       &Apache::loncommon::copyrightids)
                    781:                                     ).'</td></tr>'.$/;
                    782:     $scrout.='<tr><td align="right" valign="top">'.
                    783: 	&titlefield(&mt('Language')).'</td><td colspan="2">'.
                    784:         &Apache::lonmeta::selectbox('language',
                    785:                                     'notset',,
                    786:                                     \&Apache::loncommon::languagedescription,
                    787:                                     ('any',&Apache::loncommon::languageids)
                    788:                                     ).'</td></tr>';
                    789:     $scrout .= "</table>\n";    
                    790:     #
                    791:     # Dynamic metadata
                    792:     $scrout .= '<h3>'.&mt('Problem Statistics').'</h3>';
                    793:     $scrout .= "<table>\n";
                    794:     $scrout .= '<tr><td>&nbsp;</td><td align="center">'.&mt('Minimum').'</td>'.
                    795:         '<td align="center">'.&mt('Maximum').'</td></tr>'."\n";
                    796:     foreach my $statistic 
1.222     matthew   797:         ({ name=>'count',
                    798:            description=>'Network-wide number of accesses (hits)',},
                    799:          { name=>'stdno',
                    800:            description=>
                    801:                'Total number of students who have worked on this problem',},
1.217     matthew   802:          { name => 'avetries',
1.222     matthew   803:            description=>'Average number of tries till solved',},
1.217     matthew   804:          { name => 'difficulty',
                    805:            description=>'Degree of difficulty',},
                    806:          { name => 'disc',
                    807:            description=>'Degree of discrimination'}) {
                    808:         $scrout .= '<tr><td align="right">'.
                    809:             &titlefield(&mt($statistic->{'description'})).
                    810:             '</td><td align="center">'.
                    811:             '<input type="text" name="'.$statistic->{'name'}.'_min" '.
                    812:             'value="" size="6" />'.
                    813:             '</td><td align="center">'.
                    814:             '<input type="text" name="'.$statistic->{'name'}.'_max" '.
                    815:             'value="" size="6" />'.
                    816:             '</td></tr>'.$/;
                    817:     }
                    818:     $scrout .= "</table>\n";
                    819:     $scrout .= '<h3>'.&mt('Evaluation Data').'</h3>';
                    820:     $scrout .= "<table>\n";
                    821:     $scrout .= '<tr><td>&nbsp;</td><td align="center">'.&mt('Minimum').'</td>'.
                    822:         '<td align="center">'.&mt('Maximum').'</td></tr>'."\n";
                    823:     foreach my $evaluation
                    824:         ( { name => 'clear',
                    825:             description => 'Material presented in clear way'},
                    826:           { name =>'depth',
                    827:             description => 'Material covered with sufficient depth'},
                    828:           { name => 'helpful',
                    829:             description => 'Material is helpful'},
                    830:           { name => 'correct',
                    831:             description => 'Material appears to be correct'},
                    832:           { name => 'technical',
                    833:             description => 'Resource is technically correct'}){
                    834:         $scrout .= '<tr><td align="right">'.
                    835:             &titlefield(&mt($evaluation->{'description'})).
                    836:             '</td><td align="center">'.
                    837:             '<input type="text" name="'.$evaluation->{'name'}.'_min" '.
                    838:             'value="" size="6" />'.
                    839:             '</td><td align="center">'.
                    840:             '<input type="text" name="'.$evaluation->{'name'}.'_max" '.
                    841:             'value="" size="6" />'.
                    842:             '</td></tr>'.$/;
                    843:     }
                    844:     $scrout .= "</table>\n";
1.216     matthew   845:     #
                    846:     # Creation/Modification date limits
1.217     matthew   847:     $scrout .= '<h3>'.&mt('Creation and Modification dates').'</h3>';
1.216     matthew   848:     $scrout .= "\n<table>\n";
                    849:     my $cafter = 
                    850:         &Apache::lonhtmlcommon::date_setter('advsearch',         # formname
                    851:                                             'creationdate1', # fieldname
                    852:                                             0,           # current value
                    853:                                             '',          # special 
                    854:                                             1,           # includeempty
                    855:                                             '',          # state
                    856:                                             1,           # no_hh_mm_ss
                    857:                                             );
                    858:     my $cbefore = 
                    859:         &Apache::lonhtmlcommon::date_setter('advsearch',         # formname
                    860:                                             'creationdate2', # fieldname
                    861:                                             0,           # current value
                    862:                                             '',          # special 
                    863:                                             1,           # includeempty
                    864:                                             '',          # state
                    865:                                             1,           # no_hh_mm_ss
                    866:                                             );
                    867:     $scrout .= &mt('<tr><td align="right">Created between</td>'.
                    868:                    '<td>[_1]</td></tr>'.
                    869:                    '<tr><td align="right">and </td>'.
                    870:                    '<td>[_2]</td></tr>',$cafter,$cbefore);
                    871:     my $lafter = 
                    872:         &Apache::lonhtmlcommon::date_setter('advsearch',
                    873:                                             'revisiondate1', 
                    874:                                             0,           # current value
                    875:                                             '',          # special 
                    876:                                             1,           # includeempty
                    877:                                             '',          # state
                    878:                                             1,           # no_hh_mm_ss
                    879:                                             );
                    880:     my $lbefore = 
                    881:         &Apache::lonhtmlcommon::date_setter('advsearch',
                    882:                                             'revisiondate2',
                    883:                                             0,           # current value
                    884:                                             '',          # special 
                    885:                                             1,           # includeempty
                    886:                                             '',          # state
                    887:                                             1,           # no_hh_mm_ss
                    888:                                             );
                    889:     $scrout .= &mt('<tr><td align="right">Last modified between </td>'.
                    890:                    '<td>[_1]</td></tr>'.
                    891:                    '<tr><td align="right">and</td>'.
                    892:                    '<td>[_2]</td></tr>',$lafter,$lbefore);
1.202     www       893:     $scrout.="</table>\n";
1.124     matthew   894:     $scrout.=<<ENDDOCUMENT;
1.129     matthew   895: $advanced_buttons
1.8       harris41  896: </form>
                    897: </body>
                    898: </html>
                    899: ENDDOCUMENT
1.146     matthew   900:     $r->print($scrout);
                    901:     return;
1.124     matthew   902: }
1.204     matthew   903: 
1.200     www       904: ######################################################################
                    905: ######################################################################
                    906: 
                    907: =pod 
                    908: 
1.204     matthew   909: =item &titlefield()
1.200     www       910: 
                    911: Inputs: title text
                    912: 
                    913: Outputs: titletext with font wrapper
                    914: 
                    915: =cut
                    916: 
                    917: ######################################################################
                    918: ######################################################################
                    919: sub titlefield {
                    920:     my $title=shift;
1.208     matthew   921:     return $title;
1.200     www       922: }
1.204     matthew   923: 
1.200     www       924: ######################################################################
                    925: ######################################################################
                    926: 
                    927: =pod 
                    928: 
1.204     matthew   929: =item viewoptiontext()
1.200     www       930: 
                    931: Inputs: codename for view option
                    932: 
                    933: Outputs: displayed text
                    934: 
                    935: =cut
                    936: 
                    937: ######################################################################
                    938: ######################################################################
                    939: sub viewoptiontext {
                    940:     my $code=shift;
1.204     matthew   941:     my %desc=&Apache::lonlocal::texthash
                    942:         ('detailed' => "Detailed Citation View",
                    943:          'xml' => 'XML/SGML',
                    944:          'compact' => 'Compact View',
                    945:          'fielded' => 'Fielded Format',
                    946:          'summary' => 'Summary View');
1.200     www       947:     return $desc{$code};
                    948: }
1.204     matthew   949: 
                    950: ######################################################################
1.200     www       951: ######################################################################
                    952: 
                    953: =pod 
                    954: 
1.204     matthew   955: =item viewoptions()
1.200     www       956: 
                    957: Inputs: none
                    958: 
                    959: Outputs: text for box with view options
                    960: 
                    961: =cut
                    962: 
                    963: ######################################################################
                    964: ######################################################################
                    965: sub viewoptions {
1.223   ! matthew   966:     my $scrout;
1.208     matthew   967:     if (! defined($ENV{'form.viewselect'})) { 
                    968:         $ENV{'form.viewselect'}='detailed'; 
                    969:     }
1.200     www       970:     $scrout.=&Apache::lonmeta::selectbox('viewselect',
                    971: 			$ENV{'form.viewselect'},
                    972: 			\&viewoptiontext,
                    973: 			sort(keys(%Views)));
1.208     matthew   974:     $scrout.= '&nbsp;&nbsp;';
1.214     matthew   975:     my $countselect = &Apache::lonmeta::selectbox('show',
                    976:                                                   $ENV{'form.show'},
                    977:                                                   undef,
                    978:                                                   (10,20,50,100,1000,10000));
                    979:     $scrout .= ('&nbsp;'x2).&mt('[_1] Records per Page',$countselect).
                    980:         '</nobr>'.$/;
1.200     www       981:     return $scrout;
1.201     www       982: }
                    983: 
                    984: ######################################################################
1.204     matthew   985: ######################################################################
1.201     www       986: 
                    987: =pod 
                    988: 
1.204     matthew   989: =item searchhelp()
1.201     www       990: 
                    991: Inputs: none
                    992: 
                    993: Outputs: return little blurb on how to enter searches
                    994: 
                    995: =cut
                    996: 
                    997: ######################################################################
                    998: ######################################################################
                    999: sub searchhelp {
                   1000:     return &mt('Enter terms or phrases separated by AND, OR, or NOT');
1.200     www      1001: }
1.8       harris41 1002: 
1.121     matthew  1003: ######################################################################
                   1004: ######################################################################
                   1005: 
                   1006: =pod 
                   1007: 
1.204     matthew  1008: =item &get_persistent_form_data()
1.145     matthew  1009: 
1.146     matthew  1010: Inputs: filename of database
                   1011: 
                   1012: Outputs: returns undef on database errors.
                   1013: 
                   1014: This function is the reverse of &make_persistent() for form data.
1.145     matthew  1015: Retrieve persistent data from %persistent_db.  Retrieved items will have their
1.146     matthew  1016: values unescaped.  If a form value already exists in $ENV, it will not be
                   1017: overwritten.  Form values that are array references may have values appended
                   1018: to them.
1.145     matthew  1019: 
                   1020: =cut
                   1021: 
                   1022: ######################################################################
                   1023: ######################################################################
1.146     matthew  1024: sub get_persistent_form_data {
                   1025:     my $filename = shift;
1.147     matthew  1026:     return 0 if (! -e $filename);
1.146     matthew  1027:     return undef if (! tie(%persistent_db,'GDBM_File',$filename,
1.148     matthew  1028:                            &GDBM_READER(),0640));
1.146     matthew  1029:     #
                   1030:     # These make sure we do not get array references printed out as 'values'.
1.161     matthew  1031:     my %arrays_allowed = ('form.domains'=>1);
1.146     matthew  1032:     #
                   1033:     # Loop through the keys, looking for 'form.'
                   1034:     foreach my $name (keys(%persistent_db)) {
                   1035:         next if ($name !~ /^form./);
1.182     matthew  1036:         # Kludgification begins!
                   1037:         if ($name eq 'form.domains' && 
                   1038:             $ENV{'form.searchmode'} eq 'basic' &&
                   1039:             $ENV{'form.phase'} ne 'disp_basic') {
                   1040:             next;
                   1041:         }
                   1042:         # End kludge (hopefully)
1.152     matthew  1043:         next if (exists($ENV{$name}));
1.146     matthew  1044:         my @values = map { 
                   1045:             &Apache::lonnet::unescape($_);
                   1046:         } split(',',$persistent_db{$name});
                   1047:         next if (@values <1);
1.152     matthew  1048:         if ($arrays_allowed{$name}) {
                   1049:             $ENV{$name} = [@values];
1.146     matthew  1050:         } else {
1.152     matthew  1051:             $ENV{$name} = $values[0] if ($values[0]);
1.146     matthew  1052:         }
                   1053:     }
                   1054:     untie (%persistent_db);
                   1055:     return 1;
                   1056: }
1.181     matthew  1057: 
1.146     matthew  1058: ######################################################################
                   1059: ######################################################################
                   1060: 
                   1061: =pod 
                   1062: 
1.204     matthew  1063: =item &get_persistent_data()
1.146     matthew  1064: 
                   1065: Inputs: filename of database, ref to array of values to recover.
                   1066: 
                   1067: Outputs: array of values.  Returns undef on error.
                   1068: 
                   1069: This function is the reverse of &make_persistent();
                   1070: Retrieve persistent data from %persistent_db.  Retrieved items will have their
                   1071: values unescaped.  If the item contains commas (before unescaping), the
                   1072: returned value will be an array pointer. 
                   1073: 
                   1074: =cut
                   1075: 
                   1076: ######################################################################
                   1077: ######################################################################
                   1078: sub get_persistent_data {
                   1079:     my $filename = shift;
                   1080:     my @Vars = @{shift()};
                   1081:     my @Values;   # Return array
                   1082:     return undef if (! -e $filename);
                   1083:     return undef if (! tie(%persistent_db,'GDBM_File',$filename,
1.148     matthew  1084:                            &GDBM_READER(),0640));
1.146     matthew  1085:     foreach my $name (@Vars) {
                   1086:         if (! exists($persistent_db{$name})) {
                   1087:             push @Values, undef;
                   1088:             next;
                   1089:         }
                   1090:         my @values = map { 
                   1091:             &Apache::lonnet::unescape($_);
                   1092:         } split(',',$persistent_db{$name});
1.152     matthew  1093:         if (@values <= 1) {
1.146     matthew  1094:             push @Values,$values[0];
1.145     matthew  1095:         } else {
1.146     matthew  1096:             push @Values,\@values;
1.145     matthew  1097:         }
                   1098:     }
1.146     matthew  1099:     untie (%persistent_db);
                   1100:     return @Values;
1.145     matthew  1101: }
                   1102: 
                   1103: ######################################################################
                   1104: ######################################################################
                   1105: 
                   1106: =pod 
                   1107: 
1.121     matthew  1108: =item &make_persistent() 
                   1109: 
1.146     matthew  1110: Inputs: Hash of values to save, filename of persistent database.
                   1111: 
                   1112: Store variables away to the %persistent_db.
1.145     matthew  1113: Values will be escaped.  Values that are array pointers will have their
1.205     www      1114: elements escaped and concatenated in a comma separated string.  
1.122     matthew  1115: 
1.121     matthew  1116: =cut
                   1117: 
                   1118: ######################################################################
                   1119: ######################################################################
1.98      harris41 1120: sub make_persistent {
1.133     matthew  1121:     my %save = %{shift()};
1.146     matthew  1122:     my $filename = shift;
                   1123:     return undef if (! tie(%persistent_db,'GDBM_File',
1.148     matthew  1124:                            $filename,&GDBM_WRCREAT(),0640));
1.146     matthew  1125:     foreach my $name (keys(%save)) {
1.145     matthew  1126:         my @values = (ref($save{$name}) ? @{$save{$name}} : ($save{$name}));
                   1127:         # We handle array references, but not recursively.
                   1128:         my $store = join(',', map { &Apache::lonnet::escape($_); } @values );
                   1129:         $persistent_db{$name} = $store;
1.109     harris41 1130:     }
1.146     matthew  1131:     untie(%persistent_db);
                   1132:     return 1;
                   1133: }
                   1134: 
                   1135: ######################################################################
                   1136: ######################################################################
                   1137: 
                   1138: =pod 
                   1139: 
                   1140: =item &make_form_data_persistent() 
                   1141: 
                   1142: Inputs: filename of persistent database.
                   1143: 
                   1144: Store most form variables away to the %persistent_db.
                   1145: Values will be escaped.  Values that are array pointers will have their
1.205     www      1146: elements escaped and concatenated in a comma separated string.  
1.146     matthew  1147: 
                   1148: =cut
                   1149: 
                   1150: ######################################################################
                   1151: ######################################################################
                   1152: sub make_form_data_persistent {
                   1153:     my $r = shift;
                   1154:     my $filename = shift;
                   1155:     my %save;
                   1156:     foreach (keys(%ENV)) {
1.150     matthew  1157:         next if (!/^form/ || /submit/);
1.146     matthew  1158:         $save{$_} = $ENV{$_};
                   1159:     }
1.152     matthew  1160:     return &make_persistent(\%save,$filename);
1.98      harris41 1161: }
                   1162: 
1.122     matthew  1163: ######################################################################
                   1164: ######################################################################
                   1165: 
                   1166: =pod 
                   1167: 
1.134     matthew  1168: =item &parse_advanced_search()
                   1169: 
                   1170: Parse advanced search form and return the following:
                   1171: 
                   1172: =over 4
                   1173: 
                   1174: =item $query Scalar containing an SQL query.
1.126     matthew  1175: 
1.134     matthew  1176: =item $customquery Scalar containing a custom query.
                   1177: 
                   1178: =item $customshow Scalar containing commands to show custom metadata.
                   1179: 
                   1180: =item $libraries_to_query Reference to array of domains to search.
                   1181: 
                   1182: =back
1.122     matthew  1183: 
                   1184: =cut
                   1185: 
                   1186: ######################################################################
                   1187: ######################################################################
1.134     matthew  1188: sub parse_advanced_search {
1.196     matthew  1189:     my ($r,$closebutton,$hidden_fields)=@_;
1.216     matthew  1190:     my @BasicFields = ('title','author','subject','keywords','url','version',
1.217     matthew  1191:                        'notes','abstract','extension','owner',
1.216     matthew  1192: #                       'custommetadata','customshow',
                   1193:                        'modifyinguser','standards','mime');
1.222     matthew  1194:     my @StatsFields = &statfields();
                   1195:     my @EvalFields = &evalfields();
1.32      harris41 1196:     my $fillflag=0;
1.143     matthew  1197:     my $pretty_search_string = "<br />\n";
1.64      harris41 1198:     # Clean up fields for safety
1.216     matthew  1199:     for my $field (@BasicFields,
                   1200:                    'creationdatestart_month','creationdatestart_day',
1.64      harris41 1201: 		   'creationdatestart_year','creationdateend_month',
                   1202: 		   'creationdateend_day','creationdateend_year',
                   1203: 		   'lastrevisiondatestart_month','lastrevisiondatestart_day',
                   1204: 		   'lastrevisiondatestart_year','lastrevisiondateend_month',
1.216     matthew  1205: 		   'lastrevisiondateend_day','lastrevisiondateend_year') {
                   1206: 	$ENV{'form.'.$field}=~s/[^\w\/\s\(\)\=\-\"\']//g;
1.220     matthew  1207:         $ENV{'form.'.$field}=~s/(not\s*$|^\s*(and|or)|)//gi;
1.64      harris41 1208:     }
1.117     matthew  1209:     foreach ('mode','form','element') {
                   1210: 	# is this required?  Hmmm.
1.216     matthew  1211: 	next if (! exists($ENV{'form.'.$_}));
                   1212: 	$ENV{'form.'.$_}=&Apache::lonnet::unescape($ENV{'form.'.$_});
                   1213: 	$ENV{'form.'.$_}=~s/[^\w\/\s\(\)\=\-\"\']//g;
1.117     matthew  1214:     }
1.131     matthew  1215:     # Preprocess the category form element.
1.161     matthew  1216:     $ENV{'form.category'} = 'any' if (! defined($ENV{'form.category'}) ||
                   1217:                                       ref($ENV{'form.category'}));
                   1218:     #
1.90      harris41 1219:     # Check to see if enough information was filled in
1.222     matthew  1220:     foreach my $field (@BasicFields) {
1.216     matthew  1221: 	if (&filled($ENV{'form.'.$field})) {
1.32      harris41 1222: 	    $fillflag++;
                   1223: 	}
                   1224:     }
1.222     matthew  1225:     foreach my $field (@StatsFields,@EvalFields) {
                   1226:         if (&filled($ENV{'form.'.$field.'_max'})) {
                   1227:             $fillflag++;
                   1228:         }
                   1229:         if (&filled($ENV{'form.'.$field.'_min'})) {
                   1230:             $fillflag++;
                   1231:         }
                   1232:     }
                   1233: 
1.216     matthew  1234:     for my $field ('lowestgradelevel','highestgradelevel') {
                   1235:         if ( $ENV{'form.'.$field} =~ /^\d+$/ &&
                   1236:              $ENV{'form.'.$field} > 0) {
                   1237:             $fillflag++;
                   1238:         }
                   1239:     }
1.212     matthew  1240:     if (! $fillflag) {
1.204     matthew  1241: 	&output_blank_field_error($r,$closebutton,
                   1242:                                   'phase=disp_adv',$hidden_fields);
1.134     matthew  1243: 	return ;
1.32      harris41 1244:     }
1.90      harris41 1245:     # Turn the form input into a SQL-based query
1.39      harris41 1246:     my $query='';
1.45      harris41 1247:     my @queries;
1.143     matthew  1248:     my $font = '<font color="#800000" face="helvetica">';
1.90      harris41 1249:     # Evaluate logical expression AND/OR/NOT phrase fields.
1.216     matthew  1250:     foreach my $field (@BasicFields) {
1.44      harris41 1251: 	if ($ENV{'form.'.$field}) {
1.142     matthew  1252:             my $searchphrase = $ENV{'form.'.$field};
1.143     matthew  1253:             $pretty_search_string .= $font."$field</font> contains <b>".
                   1254:                 $searchphrase."</b>";
1.142     matthew  1255:             if ($ENV{'form.'.$field.'_related'}) {
1.143     matthew  1256:                 my @New_Words;
                   1257:                 ($searchphrase,@New_Words) = &related_version($searchphrase);
                   1258:                 if (@New_Words) {
                   1259:                     $pretty_search_string .= " with related words: ".
                   1260:                         "<b>@New_Words</b>.";
                   1261:                 } else {
                   1262:                     $pretty_search_string .= " with no related words.";
                   1263:                 }
1.142     matthew  1264:             }
1.143     matthew  1265:             $pretty_search_string .= "<br />\n";
1.142     matthew  1266: 	    push @queries,&build_SQL_query($field,$searchphrase);
1.131     matthew  1267:         }
1.44      harris41 1268:     }
1.161     matthew  1269:     #
                   1270:     # Make the 'mime' from 'form.category' and 'form.extension'
                   1271:     #
                   1272:     my $searchphrase;
                   1273:     if (exists($ENV{'form.category'})    && 
                   1274:         $ENV{'form.category'} !~ /^\s*$/ &&
                   1275:         $ENV{'form.category'} ne 'any')     {
                   1276:         my @extensions = &Apache::loncommon::filecategorytypes
                   1277:                                                    ($ENV{'form.category'});
                   1278:         if (scalar(@extensions) > 0) {
                   1279:             $searchphrase = join(' OR ',@extensions);
                   1280:         }
                   1281:     }
                   1282:     if (defined($searchphrase)) {
                   1283:         push @queries,&build_SQL_query('mime',$searchphrase);
                   1284:         $pretty_search_string .=$font.'mime</font> contains <b>'.
                   1285:             $searchphrase.'</b><br />';
1.135     matthew  1286:     }
1.204     matthew  1287:     #
1.90      harris41 1288:     # Evaluate option lists
1.216     matthew  1289:     if ($ENV{'form.lowestgradelevel'}        &&
                   1290:         $ENV{'form.lowestgradelevel'} ne '0' &&
                   1291:         $ENV{'form.lowestgradelevel'} =~ /^\d+$/) {
                   1292: 	push(@queries,
                   1293:              '(lowestgradelevel>='.$ENV{'form.lowestgradelevel'}.')');
                   1294:         $pretty_search_string.="lowestgradelevel>=".
                   1295:             $ENV{'form.lowestgradelevel'}."<br />\n";
                   1296:     }
                   1297:     if ($ENV{'form.highestgradelevel'}        &&
                   1298:         $ENV{'form.highestgradelevel'} ne '0' &&
                   1299:         $ENV{'form.highestgradelevel'} =~ /^\d+$/) {
                   1300: 	push(@queries,
                   1301:              '(highestgradelevel<='.$ENV{'form.highestgradelevel'}.')');
                   1302:         $pretty_search_string.="highestgradelevel<=".
                   1303:             $ENV{'form.highestgradelevel'}."<br />\n";
                   1304:     }
1.58      harris41 1305:     if ($ENV{'form.language'} and $ENV{'form.language'} ne 'any') {
1.90      harris41 1306: 	push @queries,"(language like \"$ENV{'form.language'}\")";
1.143     matthew  1307:         $pretty_search_string.=$font."language</font>= ".
                   1308:             &Apache::loncommon::languagedescription($ENV{'form.language'}).
                   1309:                 "<br />\n";
1.58      harris41 1310:     }
                   1311:     if ($ENV{'form.copyright'} and $ENV{'form.copyright'} ne 'any') {
1.90      harris41 1312: 	push @queries,"(copyright like \"$ENV{'form.copyright'}\")";
1.143     matthew  1313:         $pretty_search_string.=$font."copyright</font> = ".
                   1314:             &Apache::loncommon::copyrightdescription($ENV{'form.copyright'}).
                   1315:                 "<br \>\n";
1.58      harris41 1316:     }
1.143     matthew  1317:     #
1.217     matthew  1318:     # Statistics
                   1319:     foreach my $field (@StatsFields,@EvalFields) {
                   1320:         my ($min,$max);
                   1321:         if (exists($ENV{'form.'.$field.'_min'}) && 
                   1322:             $ENV{'form.'.$field.'_min'} ne '') {
                   1323:             $min = $ENV{'form.'.$field.'_min'};
                   1324:         }
                   1325:         if (exists($ENV{'form.'.$field.'_max'}) &&
                   1326:             $ENV{'form.'.$field.'_max'} ne '') {
                   1327:             $max = $ENV{'form.'.$field.'_max'};
                   1328:         }
                   1329:         next if (! defined($max) && ! defined($min));
                   1330:         if (defined($min) && defined($max)) {
                   1331:             ($min,$max) = sort {$a <=>$b} ($min,$max);
                   1332:         }
                   1333:         if (defined($min) && $min =~ /^(\d+\.\d+|\d+|\.\d+)$/) {
                   1334:             push(@queries,'('.$field.'>'.$min.')');
                   1335:             $pretty_search_string.=$font.$field.'</font>&gt;'.$min.'<br />';
                   1336:         }
                   1337:         if (defined($max) && $max =~ /^(\d+\.\d+|\d+|\.\d+)$/) {
                   1338:             push(@queries,'('.$field.'<'.$max.')');
                   1339:             $pretty_search_string.=$font.$field.'</font>&lt;'.$max.'<br />';
                   1340:         }
                   1341:     }
                   1342:     #
1.90      harris41 1343:     # Evaluate date windows
1.216     matthew  1344:     my $cafter =
                   1345:         &Apache::lonhtmlcommon::get_date_from_form('creationdate1');
                   1346:     my $cbefore = 
                   1347:         &Apache::lonhtmlcommon::get_date_from_form('creationdate2');
                   1348:     if ($cafter > $cbefore) {
                   1349:         my $tmp = $cafter;
                   1350:         $cafter = $cbefore;
                   1351:         $cbefore = $tmp;
                   1352:     }
                   1353:     my $mafter = 
                   1354:         &Apache::lonhtmlcommon::get_date_from_form('revisiondate1');
                   1355:     my $mbefore =
                   1356:         &Apache::lonhtmlcommon::get_date_from_form('revisiondate2');
                   1357:     if ($mafter > $mbefore) {
                   1358:         my $tmp = $mafter;
                   1359:         $mafter = $mbefore;
                   1360:         $mbefore = $tmp;
                   1361:     }
                   1362:     my ($datequery,$error,$prettydate)=&build_date_queries($cafter,$cbefore,
                   1363:                                                            $mafter,$mbefore);
                   1364:     if (defined($error)) {
                   1365:         &output_date_error($r,$error,$closebutton,$hidden_fields);
                   1366:     } elsif (defined($datequery)) {
1.143     matthew  1367:         # Here is where you would set up pretty_search_string to output
                   1368:         # date query information.
1.216     matthew  1369:         $pretty_search_string .= '<br />'.$prettydate.'<br />';
1.60      harris41 1370: 	push @queries,$datequery;
                   1371:     }
1.204     matthew  1372:     #
1.90      harris41 1373:     # Process form information for custom metadata querying
1.134     matthew  1374:     my $customquery=undef;
1.204     matthew  1375:     ##
                   1376:     ## The custom metadata search was removed q long time ago mostly 
                   1377:     ## because I was unable to figureout exactly how it worked and could
                   1378:     ## not imagine people actually using it.  MH
                   1379:     ##
                   1380:     # if ($ENV{'form.custommetadata'}) {
                   1381:     #    $pretty_search_string .=$font."Custom Metadata Search</font>: <b>".
                   1382:     #    $ENV{'form.custommetadata'}."</b><br />\n";
                   1383:     #    $customquery=&build_custommetadata_query('custommetadata',
                   1384:     #                                             $ENV{'form.custommetadata'});
                   1385:     # }
1.134     matthew  1386:     my $customshow=undef;
1.204     matthew  1387:     # if ($ENV{'form.customshow'}) {
                   1388:     # $pretty_search_string .=$font."Custom Metadata Display</font>: <b>".
                   1389:     #                         $ENV{'form.customshow'}."</b><br />\n";
                   1390:     #    $customshow=$ENV{'form.customshow'};
                   1391:     #    $customshow=~s/[^\w\s]//g;
                   1392:     #    my @fields=split(/\s+/,$customshow);
                   1393:     #    $customshow=join(" ",@fields);
                   1394:     # }
                   1395:     ##
1.132     matthew  1396:     ## Deal with restrictions to given domains
                   1397:     ## 
1.180     matthew  1398:     my ($libraries_to_query,$pretty_domains_string) = 
                   1399:         &parse_domain_restrictions();
                   1400:     $pretty_search_string .= $pretty_domains_string."<br />\n";
                   1401:     #
                   1402:     if (@queries) {
1.216     matthew  1403: 	$query="select * from metadata where ".join(" AND ",@queries);
1.180     matthew  1404:     } elsif ($customquery) {
                   1405:         $query = '';
                   1406:     }
1.217     matthew  1407: #    &Apache::lonnet::logthis('query = '.$/.$query);
1.180     matthew  1408:     return ($query,$customquery,$customshow,$libraries_to_query,
                   1409:             $pretty_search_string);
                   1410: }
                   1411: 
                   1412: sub parse_domain_restrictions {
1.132     matthew  1413:     my $libraries_to_query = undef;
                   1414:     # $ENV{'form.domains'} can be either a scalar or an array reference.
                   1415:     # We need an array.
1.221     matthew  1416:     if (! exists($ENV{'form.domains'}) || $ENV{'form.domains'} eq '') {
1.180     matthew  1417:         return (undef,'');
                   1418:     }
                   1419:     my @allowed_domains;
                   1420:     if (ref($ENV{'form.domains'})) {
                   1421:         @allowed_domains =  @{$ENV{'form.domains'}};
                   1422:     } else {
                   1423:         @allowed_domains = ($ENV{'form.domains'});
                   1424:     }
1.204     matthew  1425:     #
1.132     matthew  1426:     my %domain_hash = ();
1.143     matthew  1427:     my $pretty_domains_string;
1.132     matthew  1428:     foreach (@allowed_domains) {
                   1429:         $domain_hash{$_}++;
                   1430:     }
1.143     matthew  1431:     if ($domain_hash{'any'}) {
1.152     matthew  1432:         $pretty_domains_string = "In all LON-CAPA domains.";
1.143     matthew  1433:     } else {
                   1434:         if (@allowed_domains > 1) {
1.152     matthew  1435:             $pretty_domains_string = "In LON-CAPA domains:";
1.143     matthew  1436:         } else {
1.152     matthew  1437:             $pretty_domains_string = "In LON-CAPA domain ";
1.143     matthew  1438:         }
                   1439:         foreach (sort @allowed_domains) {
1.152     matthew  1440:             $pretty_domains_string .= "<b>".$_."</b> ";
1.132     matthew  1441:         }
1.143     matthew  1442:         foreach (keys(%Apache::lonnet::libserv)) {
                   1443:             if (exists($domain_hash{$Apache::lonnet::hostdom{$_}})) {
                   1444:                 push @$libraries_to_query,$_;
                   1445:             }
1.132     matthew  1446:         }
                   1447:     }
1.180     matthew  1448:     return ($libraries_to_query,$pretty_domains_string);
1.18      harris41 1449: }
                   1450: 
1.122     matthew  1451: ######################################################################
                   1452: ######################################################################
                   1453: 
                   1454: =pod 
                   1455: 
1.134     matthew  1456: =item &parse_basic_search() 
1.122     matthew  1457: 
1.134     matthew  1458: Parse the basic search form and return a scalar containing an sql query.
1.126     matthew  1459: 
1.122     matthew  1460: =cut
                   1461: 
                   1462: ######################################################################
                   1463: ######################################################################
1.134     matthew  1464: sub parse_basic_search {
1.145     matthew  1465:     my ($r,$closebutton)=@_;
1.204     matthew  1466:     #
1.64      harris41 1467:     # Clean up fields for safety
                   1468:     for my $field ('basicexp') {
                   1469: 	$ENV{"form.$field"}=~s/[^\w\s\(\)\-]//g;
                   1470:     }
1.117     matthew  1471:     foreach ('mode','form','element') {
                   1472: 	# is this required?  Hmmm.
                   1473: 	next unless (exists($ENV{"form.$_"}));
                   1474: 	$ENV{"form.$_"}=&Apache::lonnet::unescape($ENV{"form.$_"});
                   1475: 	$ENV{"form.$_"}=~s/[^\w\/\s\(\)\=\-\"\']//g;
                   1476:     }
1.180     matthew  1477:     my ($libraries_to_query,$pretty_domains_string) = 
                   1478:         &parse_domain_restrictions();
1.204     matthew  1479:     #
                   1480:     # Check to see if enough of a query is filled in
1.220     matthew  1481:     my $search_string = $ENV{'form.basicexp'};
                   1482:     $search_string =~ s/(not\s*$|^\s*(and|or)|)//gi;
                   1483:     if (! &filled($search_string)) {
1.151     matthew  1484: 	&output_blank_field_error($r,$closebutton,'phase=disp_basic');
1.24      harris41 1485: 	return OK;
                   1486:     }
1.143     matthew  1487:     my $pretty_search_string = '<b>'.$ENV{'form.basicexp'}.'</b>';
1.141     matthew  1488:     if ($ENV{'form.related'}) {
1.143     matthew  1489:         my @New_Words;
                   1490:         ($search_string,@New_Words) = &related_version($ENV{'form.basicexp'});
                   1491:         if (@New_Words) {
                   1492:             $pretty_search_string .= " with related words: <b>@New_Words</b>.";
                   1493:         } else {
                   1494:             $pretty_search_string .= " with no related words.";
                   1495:         }
1.141     matthew  1496:     }
1.204     matthew  1497:     #
1.90      harris41 1498:     # Build SQL query string based on form page
1.39      harris41 1499:     my $query='';
1.178     matthew  1500:     my $concatarg=join(',',
1.124     matthew  1501: 		       ('title', 'author', 'subject', 'notes', 'abstract',
                   1502:                         'keywords'));
1.95      harris41 1503:     $concatarg='title' if $ENV{'form.titleonly'};
1.178     matthew  1504:     $query=&build_SQL_query('concat_ws(" ",'.$concatarg.')',$search_string);
1.180     matthew  1505:     if (defined($pretty_domains_string) && $pretty_domains_string ne '') {
                   1506:         $pretty_search_string .= ' '.$pretty_domains_string;
                   1507:     }
1.143     matthew  1508:     $pretty_search_string .= "<br />\n";
1.183     matthew  1509:     my $final_query = 'SELECT * FROM metadata WHERE '.$query;
1.204     matthew  1510:     # &Apache::lonnet::logthis($final_query);
1.183     matthew  1511:     return ($final_query,$pretty_search_string,
1.180     matthew  1512:             $libraries_to_query);
1.22      harris41 1513: }
                   1514: 
1.122     matthew  1515: ######################################################################
                   1516: ######################################################################
                   1517: 
                   1518: =pod 
                   1519: 
1.204     matthew  1520: =item &related_version()
1.142     matthew  1521: 
                   1522: Modifies an input string to include related words.  Words in the string
                   1523: are replaced with parenthesized lists of 'OR'd words.  For example
                   1524: "torque" is replaced with "(torque OR word1 OR word2 OR ...)".  
                   1525: 
                   1526: Note: Using this twice on a string is probably silly.
                   1527: 
                   1528: =cut
                   1529: 
                   1530: ######################################################################
                   1531: ######################################################################
                   1532: sub related_version {
                   1533:     my $search_string = shift;
                   1534:     my $result = $search_string;
1.143     matthew  1535:     my %New_Words = ();
1.142     matthew  1536:     while ($search_string =~ /(\w+)/cg) {
                   1537:         my $word = $1;
                   1538:         next if (lc($word) =~ /\b(or|and|not)\b/);
                   1539:         my @Words = &Apache::loncommon::get_related_words($word);
1.143     matthew  1540:         @Words = ($#Words>4? @Words[0..4] : @Words);
                   1541:         foreach (@Words) { $New_Words{$_}++;}
                   1542:         my $replacement = join " OR ", ($word,@Words);
1.142     matthew  1543:         $result =~ s/(\b)$word(\b)/$1($replacement)$2/g;
                   1544:     }
1.143     matthew  1545:     return $result,sort(keys(%New_Words));
1.142     matthew  1546: }
                   1547: 
                   1548: ######################################################################
                   1549: ######################################################################
                   1550: 
                   1551: =pod 
                   1552: 
1.122     matthew  1553: =item &build_SQL_query() 
                   1554: 
1.126     matthew  1555: Builds a SQL query string from a logical expression with AND/OR keywords
                   1556: using Text::Query and &recursive_SQL_query_builder()
                   1557: 
1.122     matthew  1558: =cut
                   1559: 
                   1560: ######################################################################
                   1561: ######################################################################
1.98      harris41 1562: sub build_SQL_query {
                   1563:     my ($field_name,$logic_statement)=@_;
                   1564:     my $q=new Text::Query('abc',
                   1565: 			  -parse => 'Text::Query::ParseAdvanced',
                   1566: 			  -build => 'Text::Query::Build');
                   1567:     $q->prepare($logic_statement);
                   1568:     my $matchexp=${$q}{'matchexp'}; chomp $matchexp;
                   1569:     my $sql_query=&recursive_SQL_query_build($field_name,$matchexp);
                   1570:     return $sql_query;
                   1571: }
                   1572: 
1.122     matthew  1573: ######################################################################
                   1574: ######################################################################
                   1575: 
                   1576: =pod 
                   1577: 
                   1578: =item &build_custommetadata_query() 
                   1579: 
1.126     matthew  1580: Constructs a custom metadata query using a rather heinous regular
                   1581: expression.
                   1582: 
1.122     matthew  1583: =cut
                   1584: 
                   1585: ######################################################################
                   1586: ######################################################################
1.98      harris41 1587: sub build_custommetadata_query {
                   1588:     my ($field_name,$logic_statement)=@_;
                   1589:     my $q=new Text::Query('abc',
                   1590: 			  -parse => 'Text::Query::ParseAdvanced',
                   1591: 			  -build => 'Text::Query::BuildAdvancedString');
                   1592:     $q->prepare($logic_statement);
                   1593:     my $matchexp=${$q}{'-parse'}{'-build'}{'matchstring'};
                   1594:     # quick fix to change literal into xml tag-matching
                   1595:     # will eventually have to write a separate builder module
1.122     matthew  1596:     # wordone=wordtwo becomes\<wordone\>[^\<] *wordtwo[^\<]*\<\/wordone\>
                   1597:     $matchexp =~ s/(\w+)\\=([\w\\\+]+)?# wordone=wordtwo is changed to 
                   1598:                  /\\<$1\\>?#           \<wordone\>
                   1599:                    \[\^\\<\]?#        [^\<]         
                   1600:                    \*$2\[\^\\<\]?#           *wordtwo[^\<]
                   1601:                    \*\\<\\\/$1\\>?#                        *\<\/wordone\>
                   1602:                    /g;
1.98      harris41 1603:     return $matchexp;
                   1604: }
                   1605: 
1.122     matthew  1606: ######################################################################
                   1607: ######################################################################
                   1608: 
                   1609: =pod 
                   1610: 
                   1611: =item &recursive_SQL_query_build() 
                   1612: 
1.126     matthew  1613: Recursively constructs an SQL query.  Takes as input $dkey and $pattern.
                   1614: 
1.122     matthew  1615: =cut
                   1616: 
                   1617: ######################################################################
                   1618: ######################################################################
1.98      harris41 1619: sub recursive_SQL_query_build {
                   1620:     my ($dkey,$pattern)=@_;
                   1621:     my @matches=($pattern=~/(\[[^\]|\[]*\])/g);
                   1622:     return $pattern unless @matches;
                   1623:     foreach my $match (@matches) {
1.173     matthew  1624:         $match=~/\[ (\w+)\s(.*) \]/;
                   1625:         my ($key,$value)=($1,$2);
                   1626:         my $replacement='';
                   1627:         if ($key eq 'literal') {
1.178     matthew  1628:             $replacement="($dkey LIKE \"\%$value\%\")";
                   1629:         } elsif (lc($key) eq 'not') {
                   1630:             $value=~s/LIKE/NOT LIKE/;
1.173     matthew  1631: #          $replacement="($dkey not like $value)";
                   1632:             $replacement="$value";
                   1633:         } elsif ($key eq 'and') {
                   1634:             $value=~/(.*[\"|\)]) ([|\(|\^].*)/;
                   1635:             $replacement="($1 AND $2)";
                   1636: 	} elsif ($key eq 'or') {
                   1637:             $value=~/(.*[\"|\)]) ([|\(|\^].*)/;
                   1638:             $replacement="($1 OR $2)";
1.98      harris41 1639: 	}
                   1640: 	substr($pattern,
1.173     matthew  1641:                index($pattern,$match),
                   1642:                length($match),
                   1643:                $replacement);
1.98      harris41 1644:     }
                   1645:     &recursive_SQL_query_build($dkey,$pattern);
                   1646: }
1.22      harris41 1647: 
1.122     matthew  1648: ######################################################################
                   1649: ######################################################################
                   1650: 
                   1651: =pod 
                   1652: 
                   1653: =item &build_date_queries() 
                   1654: 
1.126     matthew  1655: Builds a SQL logic query to check time/date entries.
                   1656: Also reports errors (check for /^Incorrect/).
                   1657: 
1.122     matthew  1658: =cut
                   1659: 
                   1660: ######################################################################
                   1661: ######################################################################
1.98      harris41 1662: sub build_date_queries {
1.216     matthew  1663:     my ($cafter,$cbefore,$mafter,$mbefore) = @_;
                   1664:     my ($result,$error,$pretty_string);
                   1665:     #
                   1666:     # Verify the input
                   1667:     if (! defined($cafter) && ! defined($cbefore) &&
                   1668:         ! defined($mafter) && ! defined($mbefore)) {
                   1669:         # This is an okay situation, so return undef for the error
                   1670:         return (undef,undef,undef);
                   1671:     }
                   1672:     if ((defined($cafter)  && ! defined($cbefore)) ||
                   1673:         (defined($cbefore) && ! defined($cafter))) {
                   1674:         # This is bad, so let them know
                   1675:         $error = &mt('Incorrect entry for the creation date.  '.
                   1676:                     'You must specify both the beginning and ending dates.');
                   1677:     }
                   1678:     if (! defined($error) && 
                   1679:         ((defined($mafter)  && ! defined($mbefore)) ||
                   1680:         (defined($mbefore) && ! defined($mafter)))) {
                   1681:         # This is also bad, so let them know
                   1682:         $error = &mt('Incorrect entry for the last revision date.  '.
                   1683:                      'You must specify both the beginning and ending dates.');
1.98      harris41 1684:     }
1.216     matthew  1685:     if (! defined($error)) {
                   1686:         #
                   1687:         # Build the queries
                   1688:         my @queries;
                   1689:         if (defined($cbefore) && defined($cafter)) {
                   1690:             my (undef,undef,undef,$caday,$camon,$cayear) = localtime($cafter);
                   1691:             my (undef,undef,undef,$cbday,$cbmon,$cbyear) = localtime($cbefore);
                   1692:             # Correct for year being relative to 1900
                   1693:             $cayear+=1900; $cbyear+=1900;
                   1694:             my $cquery=
                   1695:                 '(creationdate BETWEEN '.
                   1696:                 "'".$cayear.'-'.$camon.'-'.$caday."'".
                   1697:                 ' AND '.
                   1698:                 "'".$cbyear.'-'.$cbmon.'-'.$cbday." 23:59:59')";
                   1699:             $pretty_string .= '<br />' if (defined($pretty_string));
                   1700:             $pretty_string .= 
                   1701:                 &mt('created between [_1] and [_2]',
                   1702:                     &Apache::lonlocal::locallocaltime($cafter),
                   1703:                     &Apache::lonlocal::locallocaltime($cbefore+24*60*60-1));
                   1704:             push(@queries,$cquery);
                   1705:             $pretty_string =~ s/ 00:00:00//g;
                   1706:         }
                   1707:         if (defined($mbefore) && defined($mafter)) {
                   1708:             my (undef,undef,undef,$maday,$mamon,$mayear) = localtime($mafter);
                   1709:             my (undef,undef,undef,$mbday,$mbmon,$mbyear) = localtime($mbefore);
                   1710:             # Correct for year being relative to 1900
                   1711:             $mayear+=1900; $mbyear+=1900;
                   1712:             my $mquery=
                   1713:                 '(lastrevisiondate BETWEEN '.
                   1714:                 "'".$mayear.'-'.$mamon.'-'.$maday."'".
                   1715:                 ' AND '.
                   1716:                 "'".$mbyear.'-'.$mbmon.'-'.$mbday." 23:59:59')";
                   1717:             push(@queries,$mquery);
                   1718:             $pretty_string .= '<br />' if (defined($pretty_string));
                   1719:             $pretty_string .= 
                   1720:                 &mt('last revised between [_1] and [_2]',
                   1721:                     &Apache::lonlocal::locallocaltime($mafter),
                   1722:                     &Apache::lonlocal::locallocaltime($mbefore+24*60*60-1));
                   1723:             $pretty_string =~ s/ 00:00:00//g;
                   1724:         }
                   1725:         if (@queries) {
                   1726:             $result .= join(" AND ",@queries);
                   1727:         }
1.98      harris41 1728:     }
1.216     matthew  1729:     return ($result,$error,$pretty_string);
1.18      harris41 1730: }
1.6       harris41 1731: 
1.122     matthew  1732: ######################################################################
                   1733: ######################################################################
                   1734: 
1.144     matthew  1735: =pod
                   1736: 
                   1737: =item &copyright_check()
                   1738: 
1.204     matthew  1739: Inputs: $Metadata, a hash pointer of metadata for a resource.
                   1740: 
                   1741: Returns: 1 if the resource is available to the user making the query, 
                   1742:          0 otherwise.
                   1743: 
1.144     matthew  1744: =cut
                   1745: 
                   1746: ######################################################################
                   1747: ######################################################################
                   1748: sub copyright_check {
                   1749:     my $Metadata = shift;
                   1750:     # Check copyright tags and skip results the user cannot use
                   1751:     my (undef,undef,$resdom,$resname) = split('/',
                   1752:                                               $Metadata->{'url'});
                   1753:     # Check for priv
                   1754:     if (($Metadata->{'copyright'} eq 'priv') && 
                   1755:         (($ENV{'user.name'} ne $resname) &&
                   1756:          ($ENV{'user.domain'} ne $resdom))) {
                   1757:         return 0;
                   1758:     }
                   1759:     # Check for domain
                   1760:     if (($Metadata->{'copyright'} eq 'domain') &&
                   1761:         ($ENV{'user.domain'} ne $resdom)) {
                   1762:         return 0;
                   1763:     }
                   1764:     return 1;
                   1765: }
                   1766: 
1.151     matthew  1767: ######################################################################
                   1768: ######################################################################
                   1769: 
                   1770: =pod
                   1771: 
1.204     matthew  1772: =item &ensure_db_and_table()
1.151     matthew  1773: 
                   1774: Ensure we can get lonmysql to connect to the database and the table we
                   1775: need exists.
                   1776: 
                   1777: Inputs: $r, table id
                   1778: 
                   1779: Returns: undef on error, 1 if the table exists.
                   1780: 
                   1781: =cut
                   1782: 
                   1783: ######################################################################
                   1784: ######################################################################
                   1785: sub ensure_db_and_table {
                   1786:     my ($r,$table) = @_;
                   1787:     ##
                   1788:     ## Sanity check the table id.
                   1789:     ##
                   1790:     if (! defined($table) || $table eq '' || $table =~ /\D/ ) {
                   1791:         $r->print("Unable to retrieve search results.  ".
                   1792:                   "Unable to determine the table results were stored in.  ".
                   1793:                   "</body></html>");
                   1794:         return undef;
                   1795:     }
                   1796:     ##
                   1797:     ## Make sure we can connect and the table exists.
                   1798:     ##
                   1799:     my $connection_result = &Apache::lonmysql::connect_to_db();
                   1800:     if (!defined($connection_result)) {
                   1801:         $r->print("Unable to connect to the MySQL database where your results".
                   1802:                   " are stored. </body></html>");
                   1803:         &Apache::lonnet::logthis("lonsearchcat: unable to get lonmysql to".
                   1804:                                  " connect to database.");
                   1805:         &Apache::lonnet::logthis(&Apache::lonmysql::get_error());
                   1806:         return undef;
                   1807:     }
                   1808:     my $table_check = &Apache::lonmysql::check_table($table);
                   1809:     if (! defined($table_check)) {
                   1810:         $r->print("A MySQL error has occurred.</form></body></html>");
                   1811:         &Apache::lonnet::logthis("lonmysql was unable to determine the status".
                   1812:                                  " of table ".$table);
                   1813:         return undef;
                   1814:     } elsif (! $table_check) {
                   1815:         $r->print("The table of results could not be found.");
                   1816:         &Apache::lonnet::logthis("The user requested a table, ".$table.
                   1817:                                  ", that could not be found.");
                   1818:         return undef;
                   1819:     }
                   1820:     return 1;
                   1821: }
                   1822: 
                   1823: ######################################################################
                   1824: ######################################################################
                   1825: 
                   1826: =pod
                   1827: 
1.204     matthew  1828: =item &print_sort_form()
                   1829: 
                   1830: The sort feature is not implemented at this time.  This form just prints 
                   1831: a link to change the search query.
1.151     matthew  1832: 
                   1833: =cut
                   1834: 
                   1835: ######################################################################
                   1836: ######################################################################
                   1837: sub print_sort_form {
                   1838:     my ($r,$pretty_query_string) = @_;
1.196     matthew  1839:     my $bodytag=&Apache::loncommon::bodytag(undef,undef,undef,1);
1.151     matthew  1840:     ##
1.187     www      1841:     my %SortableFields=&Apache::lonlocal::texthash( 
                   1842:          id        => 'Default',
1.151     matthew  1843:          title     => 'Title',
                   1844:          author    => 'Author',
                   1845:          subject   => 'Subject',
                   1846:          url       => 'URL',
                   1847:          version   => 'Version Number',
                   1848:          mime      => 'Mime type',
                   1849:          lang      => 'Language',
                   1850:          owner     => 'Owner/Publisher',
                   1851:          copyright => 'Copyright',
                   1852:          hostname  => 'Host',
                   1853:          creationdate     => 'Creation Date',
1.187     www      1854:          lastrevisiondate => 'Revision Date'
1.151     matthew  1855:      );
                   1856:     ##
                   1857:     my $table = $ENV{'form.table'};
                   1858:     return if (! &ensure_db_and_table($r,$table));
                   1859:     ##
                   1860:     ## Get the number of results 
                   1861:     ##
                   1862:     my $total_results = &Apache::lonmysql::number_of_rows($table);
                   1863:     if (! defined($total_results)) {
                   1864:         $r->print("A MySQL error has occurred.</form></body></html>");
                   1865:         &Apache::lonnet::logthis("lonmysql was unable to determine the number".
                   1866:                                  " of rows in table ".$table);
                   1867:         &Apache::lonnet::logthis(&Apache::lonmysql::get_error());
                   1868:         return;
                   1869:     }
                   1870:     my $result;
                   1871:     $result.=<<END;
                   1872: <html>
                   1873: <head>
                   1874: <script>
                   1875:     function change_sort() {
                   1876:         var newloc = "/adm/searchcat?phase=results";
                   1877:         newloc += "&persistent_db_id=$ENV{'form.persistent_db_id'}";
                   1878:         newloc += "&sortby=";
                   1879:         newloc += document.forms.statusform.elements.sortby.value;
                   1880:         parent.resultsframe.location= newloc;
                   1881:     }
                   1882: </script>
                   1883: <title>Results</title>
                   1884: </head>
1.155     matthew  1885: $bodytag
1.151     matthew  1886: <form name="statusform" action="" method="post">
1.153     matthew  1887: <input type="hidden" name="Queue" value="" />
1.151     matthew  1888: END
                   1889: 
                   1890: #<h2>Sort Results</h2>
                   1891: #Sort by: <select size="1" name="sortby" onchange="javascript:change_sort();">
                   1892: #    $ENV{'form.sortby'} = 'id' if (! defined($ENV{'form.sortby'}));
                   1893: #    foreach (keys(%SortableFields)) {
                   1894: #        $result.="<option name=\"$_\"";
                   1895: #        if ($_ eq $ENV{'form.sortby'}) {
                   1896: #            $result.=" selected ";
                   1897: #        }
                   1898: #        $result.=" >$SortableFields{$_}</option>\n";
                   1899: #    }
                   1900: #    $result.="</select>\n";
                   1901:     my $revise = &revise_button();
                   1902:     $result.=<<END;
                   1903: <p>
                   1904: There are $total_results matches to your query. $revise
                   1905: </p><p>
                   1906: Search:$pretty_query_string
                   1907: </p>
                   1908: </form>
                   1909: </body>
                   1910: </html>
                   1911: END
                   1912:     $r->print($result);
                   1913:     return;
                   1914: }
                   1915: 
1.144     matthew  1916: #####################################################################
                   1917: #####################################################################
                   1918: 
                   1919: =pod
                   1920: 
                   1921: =item MySQL Table Description
                   1922: 
                   1923: MySQL table creation requires a precise description of the data to be
                   1924: stored.  The use of the correct types to hold data is vital to efficient
                   1925: storage and quick retrieval of records.  The columns must be described in
                   1926: the following format:
                   1927: 
                   1928: =cut
                   1929: 
1.170     matthew  1930: #####################################################################
                   1931: #####################################################################
1.204     matthew  1932: #
                   1933: # These should probably be scoped but I don't have time right now...
                   1934: #
                   1935: my @Datatypes;
                   1936: my @Fullindicies;
1.147     matthew  1937:     
1.144     matthew  1938: ######################################################################
                   1939: ######################################################################
                   1940: 
                   1941: =pod
                   1942: 
1.146     matthew  1943: =item &create_results_table()
                   1944: 
                   1945: Creates the table of search results by calling lonmysql.  Stores the
                   1946: table id in $ENV{'form.table'}
                   1947: 
                   1948: Inputs: none.
                   1949: 
                   1950: Returns: the identifier of the table on success, undef on error.
                   1951: 
                   1952: =cut
                   1953: 
                   1954: ######################################################################
                   1955: ######################################################################
1.204     matthew  1956: sub set_up_table_structure {
                   1957:     my ($datatypes,$fullindicies) = 
                   1958:         &LONCAPA::lonmetadata::describe_metadata_storage();
1.212     matthew  1959:     # Copy the table description before modifying it...
                   1960:     @Datatypes = @{$datatypes};
                   1961:     unshift(@Datatypes,{name => 'id',  
1.204     matthew  1962:         type => 'MEDIUMINT',
                   1963:         restrictions => 'UNSIGNED NOT NULL',
                   1964:         primary_key  => 'yes',
                   1965:         auto_inc     => 'yes' });
                   1966:     @Fullindicies = @{$fullindicies};
                   1967:     return;
                   1968: }
                   1969: 
1.146     matthew  1970: sub create_results_table {
1.204     matthew  1971:     &set_up_table_structure();
1.146     matthew  1972:     my $table = &Apache::lonmysql::create_table
1.170     matthew  1973:         ( { columns => \@Datatypes,
1.172     matthew  1974:             FULLTEXT => [{'columns' => \@Fullindicies},],
1.146     matthew  1975:         } );
                   1976:     if (defined($table)) {
                   1977:         $ENV{'form.table'} = $table;
                   1978:         return $table;
                   1979:     } 
                   1980:     return undef; # Error...
                   1981: }
1.148     matthew  1982: 
1.146     matthew  1983: ######################################################################
                   1984: ######################################################################
                   1985: 
                   1986: =pod
                   1987: 
1.150     matthew  1988: =item Search Status update functions
1.144     matthew  1989: 
1.150     matthew  1990: Each of the following functions changes the values of one of the
                   1991: input fields used to display the search status to the user.  The names
                   1992: should be explanatory.
1.144     matthew  1993: 
1.150     matthew  1994: Inputs: Apache request handler ($r), text to display.
1.148     matthew  1995: 
1.150     matthew  1996: Returns: Nothing.
1.148     matthew  1997: 
                   1998: =over 4
                   1999: 
                   2000: =item &update_count_status()
                   2001: 
1.150     matthew  2002: =item &update_status()
1.148     matthew  2003: 
1.150     matthew  2004: =item &update_seconds()
1.148     matthew  2005: 
                   2006: =back
                   2007: 
                   2008: =cut
                   2009: 
                   2010: ######################################################################
                   2011: ######################################################################
                   2012: sub update_count_status {
                   2013:     my ($r,$text) = @_;
                   2014:     $text =~ s/\'/\\\'/g;
                   2015:     $r->print
                   2016:         ("<script>document.statusform.count.value = ' $text'</script>\n");
                   2017:     $r->rflush();
                   2018: }
                   2019: 
1.150     matthew  2020: sub update_status {
1.148     matthew  2021:     my ($r,$text) = @_;
                   2022:     $text =~ s/\'/\\\'/g;
                   2023:     $r->print
1.150     matthew  2024:         ("<script>document.statusform.status.value = ' $text'</script>\n");
1.148     matthew  2025:     $r->rflush();
                   2026: }
                   2027: 
1.214     matthew  2028: {
                   2029:     my $max_time  = 40;  # seconds for the search to complete
                   2030:     my $start_time = 0;
                   2031:     my $last_time = 0;
                   2032: 
                   2033: sub reset_timing {
                   2034:     $start_time = 0;
                   2035:     $last_time = 0;
                   2036: }
                   2037: 
                   2038: sub time_left {
                   2039:     if ($start_time == 0) {
                   2040:         $start_time = time;
                   2041:     }
                   2042:     my $time_left = $max_time - (time - $start_time);
                   2043:     $time_left = 0 if ($time_left < 0);
                   2044:     return $time_left;
                   2045: }
                   2046: 
1.150     matthew  2047: sub update_seconds {
1.214     matthew  2048:     my ($r) = @_;
                   2049:     my $time = &time_left();
                   2050:     if (($last_time-$time) > 0) {
                   2051:         $r->print("<script>".
                   2052:                   "document.statusform.seconds.value = '$time'".
                   2053:                   "</script>\n");
                   2054:         $r->rflush();
                   2055:     }
                   2056:     $last_time = $time;
                   2057: }
                   2058: 
1.148     matthew  2059: }
                   2060: 
                   2061: ######################################################################
                   2062: ######################################################################
                   2063: 
                   2064: =pod
                   2065: 
1.204     matthew  2066: =item &revise_button()
1.151     matthew  2067: 
                   2068: Inputs: None
                   2069: 
                   2070: Returns: html string for a 'revise search' button.
                   2071: 
                   2072: =cut
                   2073: 
                   2074: ######################################################################
                   2075: ######################################################################
                   2076: sub revise_button {
                   2077:     my $revise_phase = 'disp_basic';
                   2078:     $revise_phase = 'disp_adv' if ($ENV{'form.searchmode'} eq 'advanced');
                   2079:     my $newloc = '/adm/searchcat'.
                   2080:         '?persistent_db_id='.$ENV{'form.persistent_db_id'}.
1.158     matthew  2081:             '&cleargroupsort=1'.
1.151     matthew  2082:             '&phase='.$revise_phase;
                   2083:     my $result = qq{<input type="button" value="Revise search" name="revise"} .
                   2084:         qq{ onClick="parent.location='$newloc';" /> };
                   2085:     return $result;
                   2086: }
                   2087: 
                   2088: ######################################################################
                   2089: ######################################################################
                   2090: 
                   2091: =pod
                   2092: 
1.204     matthew  2093: =item &run_search()
                   2094: 
                   2095: Executes a search query by sending it the the other servers and putting the
                   2096: results into MySQL.
1.144     matthew  2097: 
                   2098: =cut
                   2099: 
                   2100: ######################################################################
                   2101: ######################################################################
                   2102: sub run_search {
1.146     matthew  2103:     my ($r,$query,$customquery,$customshow,$serverlist,$pretty_string) = @_;
1.196     matthew  2104:     my $bodytag=&Apache::loncommon::bodytag(undef,undef,undef,1);
1.150     matthew  2105:     my $connection = $r->connection;
1.144     matthew  2106:     #
1.146     matthew  2107:     # Print run_search header
                   2108:     #
1.151     matthew  2109:     $r->print(<<END);
                   2110: <html>
                   2111: <head><title>Search Status</title></head>
1.155     matthew  2112: $bodytag
1.151     matthew  2113: <form name="statusform" action="" method="post">
                   2114: <input type="hidden" name="Queue" value="" />
                   2115: END
                   2116:     # Check to see if $pretty_string has more than one carriage return.
                   2117:     # Assume \n s are following <br /> s and truncate the value.
                   2118:     # (there is probably a better way)...
1.152     matthew  2119:     my @Lines = split /<br \/>/,$pretty_string;
                   2120:     if (@Lines > 2) {
                   2121:         $pretty_string = join '<br \>',(@Lines[0..2],'....<br />');
1.151     matthew  2122:     }
1.214     matthew  2123:     $r->print(&mt("Search: [_1]",$pretty_string));
1.146     matthew  2124:     $r->rflush();
                   2125:     #
1.145     matthew  2126:     # Determine the servers we need to contact.
1.144     matthew  2127:     my @Servers_to_contact;
                   2128:     if (defined($serverlist)) {
1.152     matthew  2129:         if (ref($serverlist) eq 'ARRAY') {
                   2130:             @Servers_to_contact = @$serverlist;
                   2131:         } else {
                   2132:             @Servers_to_contact = ($serverlist);
                   2133:         }
1.144     matthew  2134:     } else {
                   2135:         @Servers_to_contact = sort(keys(%Apache::lonnet::libserv));
                   2136:     }
                   2137:     my %Server_status;
1.214     matthew  2138:     #
                   2139:     # Check on the mysql table we will use to store results.
1.146     matthew  2140:     my $table =$ENV{'form.table'};
1.150     matthew  2141:     if (! defined($table) || $table eq '' || $table =~ /\D/ ) {
1.147     matthew  2142:         $r->print("Unable to determine table id to store search results in.".
1.148     matthew  2143:                   "The search has been aborted.</body></html>");
1.147     matthew  2144:         return;
                   2145:     }
                   2146:     my $table_status = &Apache::lonmysql::check_table($table);
                   2147:     if (! defined($table_status)) {
                   2148:         $r->print("Unable to determine status of table.</body></html>");
                   2149:         &Apache::lonnet::logthis("Bogus table id of $table for ".
                   2150:                                  "$ENV{'user.name'} @ $ENV{'user.domain'}");
                   2151:         &Apache::lonnet::logthis("lonmysql error = ".
1.144     matthew  2152:                                  &Apache::lonmysql::get_error());
1.147     matthew  2153:         return;
                   2154:     }
                   2155:     if (! $table_status) {
1.204     matthew  2156:         &Apache::lonnet::logthis("lonmysql error = ".
                   2157:                                  &Apache::lonmysql::get_error());
                   2158:         &Apache::lonnet::logthis("lonmysql debug = ".
                   2159:                                  &Apache::lonmysql::get_debug());
                   2160:         &Apache::lonnet::logthis('table status = "'.$table_status.'"');
1.147     matthew  2161:         $r->print("The table id,$table, we tried to use is invalid.".
1.148     matthew  2162:                   "The search has been aborted.</body></html>");
1.144     matthew  2163:         return;
                   2164:     }
1.145     matthew  2165:     ##
1.146     matthew  2166:     ## Prepare for the big loop.
1.144     matthew  2167:     my $hitcountsum;
                   2168:     my $server; 
                   2169:     my $status;
1.151     matthew  2170:     my $revise = &revise_button();
1.148     matthew  2171:     $r->print(<<END);
                   2172: <table>
1.151     matthew  2173: <tr><th>Status</th><th>Total Matches</th><th>Time Remaining</th><th></th></tr>
1.148     matthew  2174: <tr>
1.150     matthew  2175: <td><input type="text" name="status"  value="" size="30" /></td>
                   2176: <td><input type="text" name="count"   value="" size="10" /></td>
                   2177: <td><input type="text" name="seconds" value="" size="8" /></td>
1.151     matthew  2178: <td>$revise</td>
1.148     matthew  2179: </tr>
                   2180: </table>
                   2181: </form>
                   2182: END
                   2183:     $r->rflush();
1.214     matthew  2184:     &reset_timing();
                   2185:     &update_seconds($r);
                   2186:     &update_status($r,&mt('contacting [_1]',$Servers_to_contact[0]));
                   2187:     while (&time_left() &&
1.144     matthew  2188:            ((@Servers_to_contact) || keys(%Server_status))) {
1.214     matthew  2189:         &update_seconds($r);
                   2190:         #
                   2191:         # Send out a search request
1.144     matthew  2192:         if (@Servers_to_contact) {
                   2193:             # Contact one server
                   2194:             my $server = shift(@Servers_to_contact);
1.214     matthew  2195:             &update_status($r,&mt('contacting [_1]',$server));
1.144     matthew  2196:             my $reply=&Apache::lonnet::metadata_query($query,$customquery,
                   2197:                                                       $customshow,[$server]);
                   2198:             ($server) = keys(%$reply);
                   2199:             $Server_status{$server} = $reply->{$server};
                   2200:         } else {
1.150     matthew  2201:             # wait a sec. to give time for files to be written
                   2202:             # This sleep statement is here instead of outside the else 
                   2203:             # block because we do not want to pause if we have servers
                   2204:             # left to contact.  
1.183     matthew  2205:             if (scalar (keys(%Server_status))) {
                   2206:                 &update_status($r,
1.214     matthew  2207:                        &mt('waiting on [_1]',join(' ',keys(%Server_status))));
1.183     matthew  2208:             }
1.150     matthew  2209:             sleep(1)1.144     matthew  2210:         }
1.159     matthew  2211:         #
                   2212:         # Loop through the servers we have contacted but do not
                   2213:         # have results from yet, looking for results.
1.144     matthew  2214:         while (my ($server,$status) = each(%Server_status)) {
1.150     matthew  2215:             last if ($connection->aborted());
1.214     matthew  2216:             &update_seconds($r);
1.144     matthew  2217:             if ($status eq 'con_lost') {
                   2218:                 delete ($Server_status{$server});
                   2219:                 next;
                   2220:             }
                   2221:             $status=~/^([\.\w]+)$/; 
                   2222:        	    my $datafile=$r->dir_config('lonDaemons').'/tmp/'.$1;
                   2223:             if (-e $datafile && ! -e "$datafile.end") {
1.214     matthew  2224:                 &update_status($r,&mt('Receiving results from [_1]',$server));
1.144     matthew  2225:                 next;
                   2226:             }
1.150     matthew  2227:             last if ($connection->aborted());
1.144     matthew  2228:             if (-e "$datafile.end") {
1.214     matthew  2229:                 &update_status($r,&mt('Reading results from [_1]',$server));
1.144     matthew  2230:                 if (-z "$datafile") {
                   2231:                     delete($Server_status{$server});
                   2232:                     next;
                   2233:                 }
                   2234:                 my $fh;
                   2235:                 if (!($fh=Apache::File->new($datafile))) { 
1.146     matthew  2236:                     $r->print("Unable to open search results file for ".
1.145     matthew  2237:                                   "server $server.  Omitting from search");
1.150     matthew  2238:                     delete($Server_status{$server}); 
                   2239:                    next;
1.144     matthew  2240:                 }
                   2241:                 # Read in the whole file.
                   2242:                 while (my $result = <$fh>) {
1.150     matthew  2243:                     last if ($connection->aborted());
1.214     matthew  2244:                     #
                   2245:                     # Records are stored one per line
1.144     matthew  2246:                     chomp($result);
1.214     matthew  2247:                     next if (! $result);
                   2248:                     #
1.144     matthew  2249:                     # Parse the result.
                   2250:                     my %Fields = &parse_raw_result($result,$server);
                   2251:                     $Fields{'hostname'} = $server;
1.214     matthew  2252:                     #
                   2253:                     # Skip based on copyright
1.144     matthew  2254:                     next if (! &copyright_check(\%Fields));
1.214     matthew  2255:                     #
1.144     matthew  2256:                     # Store the result in the mysql database
                   2257:                     my $result = &Apache::lonmysql::store_row($table,\%Fields);
                   2258:                     if (! defined($result)) {
1.146     matthew  2259:                         $r->print(&Apache::lonmysql::get_error());
1.144     matthew  2260:                     }
1.214     matthew  2261:                     #
1.144     matthew  2262:                     $hitcountsum ++;
1.214     matthew  2263:                     &update_seconds($r);
1.150     matthew  2264:                     if ($hitcountsum % 50 == 0) {
                   2265:                         &update_count_status($r,$hitcountsum);
                   2266:                     }
1.214     matthew  2267:                 }
1.144     matthew  2268:                 $fh->close();
                   2269:                 # $server is only deleted if the results file has been 
                   2270:                 # found and (successfully) opened.  This may be a bad idea.
                   2271:                 delete($Server_status{$server});
                   2272:             }
1.150     matthew  2273:             last if ($connection->aborted());
1.148     matthew  2274:             &update_count_status($r,$hitcountsum);
1.144     matthew  2275:         }
1.150     matthew  2276:         last if ($connection->aborted());
1.214     matthew  2277:         &update_seconds($r);
1.144     matthew  2278:     }
1.214     matthew  2279:     &update_status($r,&mt('Search Complete [_1]',$server));
                   2280:     &update_seconds($r);
1.204     matthew  2281:     #
1.214     matthew  2282:     &Apache::lonmysql::disconnect_from_db(); # This is unneccessary
1.204     matthew  2283:     #
1.144     matthew  2284:     # We have run out of time or run out of servers to talk to and
1.214     matthew  2285:     # results to get, so let the client know the top frame needs to be
                   2286:     # loaded from /adm/searchcat
1.146     matthew  2287:     $r->print("</body></html>");
1.153     matthew  2288:     if ($ENV{'form.catalogmode'} ne 'groupsearch') {
                   2289:         $r->print("<script>".
                   2290:                       "window.location='/adm/searchcat?".
                   2291:                       "phase=sort&".
                   2292:                       "persistent_db_id=$ENV{'form.persistent_db_id'}';".
                   2293:                   "</script>");
                   2294:     }
1.144     matthew  2295:     return;
                   2296: }
                   2297: 
                   2298: ######################################################################
                   2299: ######################################################################
1.204     matthew  2300: 
1.144     matthew  2301: =pod
                   2302: 
1.204     matthew  2303: =item &prev_next_buttons()
                   2304: 
                   2305: Returns html for the previous and next buttons on the search results page.
1.144     matthew  2306: 
                   2307: =cut
                   2308: 
                   2309: ######################################################################
                   2310: ######################################################################
1.146     matthew  2311: sub prev_next_buttons {
1.145     matthew  2312:     my ($current_min,$show,$total,$parms) = @_;
                   2313:     return '' if ($show eq 'all'); # No links if you get them all at once.
1.214     matthew  2314:     #
1.223   ! matthew  2315:     # Create buttons
        !          2316:     my $buttons = '<input type="submit" name="prev" value="'.&mt('Prev').'" ';
        !          2317:     $buttons .= '/>';
        !          2318:     $buttons .= '&nbsp;'x3;
        !          2319:     $buttons .= '<input type="submit" name="reload" '.
        !          2320:         'value="'.&mt('Reload').'" />';
        !          2321:     $buttons .= '&nbsp;'x3;
        !          2322:     $buttons .= '<input type="submit" name="next" value="'.&mt('Next').'" ';
        !          2323:     $buttons .= '/>';
        !          2324:     return $buttons;
1.144     matthew  2325: }
1.204     matthew  2326: 
1.144     matthew  2327: ######################################################################
                   2328: ######################################################################
                   2329: 
                   2330: =pod
                   2331: 
1.204     matthew  2332: =item &display_results()
                   2333: 
                   2334: Prints the results out for selection and perusal.
1.144     matthew  2335: 
                   2336: =cut
                   2337: 
                   2338: ######################################################################
                   2339: ######################################################################
                   2340: sub display_results {
1.196     matthew  2341:     my ($r,$importbutton,$closebutton,$diropendb) = @_;
1.150     matthew  2342:     my $connection = $r->connection;
                   2343:     $r->print(&search_results_header($importbutton,$closebutton));
1.144     matthew  2344:     ##
                   2345:     ## Set viewing function
                   2346:     ##
                   2347:     my $viewfunction = $Views{$ENV{'form.viewselect'}};
                   2348:     if (!defined($viewfunction)) {
                   2349:         $r->print("Internal Error - Bad view selected.\n");
                   2350:         $r->rflush();
                   2351:         return;
                   2352:     }
                   2353:     ##
1.158     matthew  2354:     ## $checkbox_num is a count of the number of checkboxes output on the 
                   2355:     ## page this is used only during catalogmode=groupsearch.
                   2356:     my $checkbox_num = 0;
                   2357:     ##
1.144     matthew  2358:     ## Get the catalog controls setup
                   2359:     ##
1.146     matthew  2360:     my $action = "/adm/searchcat?phase=results";
                   2361:     ##
1.204     matthew  2362:     ## Deal with groupsearch by opening the groupsearch db file.
1.146     matthew  2363:     if ($ENV{'form.catalogmode'} eq 'groupsearch') {
                   2364:         if (! tie(%groupsearch_db,'GDBM_File',$diropendb,
1.148     matthew  2365:                   &GDBM_WRCREAT(),0640)) {
1.150     matthew  2366:             $r->print('Unable to store import results.</form></body></html>');
1.146     matthew  2367:             $r->rflush();
                   2368:             return;
                   2369:         } 
1.144     matthew  2370:     }
1.145     matthew  2371:     ##
                   2372:     ## Prepare the table for querying
1.144     matthew  2373:     my $table = $ENV{'form.table'};
1.151     matthew  2374:     return if (! &ensure_db_and_table($r,$table));
1.145     matthew  2375:     ##
                   2376:     ## Get the number of results 
                   2377:     my $total_results = &Apache::lonmysql::number_of_rows($table);
                   2378:     if (! defined($total_results)) {
1.150     matthew  2379:         $r->print("A MySQL error has occurred.</form></body></html>");
1.145     matthew  2380:         &Apache::lonnet::logthis("lonmysql was unable to determine the number".
                   2381:                                  " of rows in table ".$table);
                   2382:         &Apache::lonnet::logthis(&Apache::lonmysql::get_error());
                   2383:         return;
                   2384:     }
                   2385:     ##
                   2386:     ## Determine how many results we need to get
1.223   ! matthew  2387:     $ENV{'form.start'} = 1  if (! exists($ENV{'form.start'}));
        !          2388:     $ENV{'form.show'}  = 20 if (! exists($ENV{'form.show'}));
        !          2389:     if (exists($ENV{'form.prev'})) {
        !          2390:         $ENV{'form.start'} -= $ENV{'form.show'};
        !          2391:     } elsif (exists($ENV{'form.next'})) {
        !          2392:         $ENV{'form.start'} += $ENV{'form.show'};
        !          2393:     }
        !          2394:     $ENV{'form.start'} = 1 if ($ENV{'form.start'}<1);
        !          2395:     $ENV{'form.start'} = $total_results if ($ENV{'form.start'}>$total_results);
1.146     matthew  2396:     my $min = $ENV{'form.start'};
1.145     matthew  2397:     my $max;
                   2398:     if ($ENV{'form.show'} eq 'all') {
                   2399:         $max = $total_results ;
                   2400:     } else {
1.151     matthew  2401:         $max = $min + $ENV{'form.show'} - 1;
1.146     matthew  2402:         $max = $total_results if ($max > $total_results);
1.145     matthew  2403:     }
                   2404:     ##
1.223   ! matthew  2405:     ## Output form elements
        !          2406:     $r->print(&hidden_field('table').
        !          2407:               &hidden_field('phase').
        !          2408:               &hidden_field('persistent_db_id').
        !          2409:               &hidden_field('start')
        !          2410:               );
        !          2411:     ##
1.145     matthew  2412:     ## Output links (if necessary) for 'prev' and 'next' pages.
1.146     matthew  2413:     $r->print
1.223   ! matthew  2414:         ('<table width="100%"><tr><td width="50%" align="right">'.
        !          2415:          &prev_next_buttons($min,$ENV{'form.show'},$total_results).
        !          2416:          '</td><td align="right">'.
        !          2417:          &viewoptions().'</td></tr></table>'
1.146     matthew  2418:          );
1.150     matthew  2419:     if ($total_results == 0) {
1.214     matthew  2420:         $r->print('<meta HTTP-EQUIV="Refresh" CONTENT="2">'.
1.187     www      2421:                   '<h3>'.&mt('There are currently no results').'.</h3>'.
1.150     matthew  2422:                   "</form></body></html>");
                   2423:         return;
                   2424:     } else {
                   2425:         $r->print
                   2426:             ("<center>Results $min to $max out of $total_results</center>\n");
                   2427:     }
1.145     matthew  2428:     ##
                   2429:     ## Get results from MySQL table
                   2430:     my @Results = &Apache::lonmysql::get_rows($table,
1.151     matthew  2431:                                               'id>='.$min.' AND id<='.$max);
1.145     matthew  2432:     ##
                   2433:     ## Loop through the results and output them.
1.144     matthew  2434:     foreach my $row (@Results) {
1.150     matthew  2435:         if ($connection->aborted()) {
1.162     www      2436:             &cleanup();
1.150     matthew  2437:             return;
                   2438:         }
1.144     matthew  2439:         my %Fields = %{&parse_row(@$row)};
1.145     matthew  2440:         my $output="<p>\n";
1.210     matthew  2441:         if (! defined($Fields{'title'}) || $Fields{'title'} eq '') {
                   2442:             $Fields{'title'} = 'Untitled';
                   2443:         }
1.158     matthew  2444:         my $prefix=&catalogmode_output($Fields{'title'},$Fields{'url'},
                   2445:                                        $Fields{'id'},$checkbox_num++);
1.144     matthew  2446:         # Render the result into html
1.150     matthew  2447:         $output.= &$viewfunction($prefix,%Fields);
1.145     matthew  2448:         # Print them out as they come in.
1.144     matthew  2449:         $r->print($output);
                   2450:         $r->rflush();
                   2451:     }
                   2452:     if (@Results < 1) {
1.187     www      2453:         $r->print(&mt("There were no results matching your query"));
1.147     matthew  2454:     } else {
                   2455:         $r->print
1.148     matthew  2456:             ('<center>'.
1.147     matthew  2457:              &prev_next_buttons($min,$ENV{'form.show'},$total_results,
                   2458:                                 "table=".$ENV{'form.table'}.
                   2459:                                 "&phase=results".
                   2460:                                 "&persistent_db_id=".
                   2461:                                 $ENV{'form.persistent_db_id'})
1.148     matthew  2462:              ."</center>\n"
1.147     matthew  2463:              );
1.144     matthew  2464:     }
1.150     matthew  2465:     $r->print("</form></body></html>");
1.144     matthew  2466:     $r->rflush();
1.150     matthew  2467:     untie %groupsearch_db if (tied(%groupsearch_db));
1.144     matthew  2468:     return;
                   2469: }
                   2470: 
                   2471: ######################################################################
                   2472: ######################################################################
                   2473: 
                   2474: =pod
                   2475: 
1.158     matthew  2476: =item &catalogmode_output($title,$url,$fnum,$checkbox_num)
1.145     matthew  2477: 
                   2478: Returns html needed for the various catalog modes.  Gets inputs from
1.158     matthew  2479: $ENV{'form.catalogmode'}.  Stores data in %groupsearch_db.
1.145     matthew  2480: 
                   2481: =cut
                   2482: 
                   2483: ######################################################################
                   2484: ######################################################################
                   2485: sub catalogmode_output {
                   2486:     my $output = '';
1.158     matthew  2487:     my ($title,$url,$fnum,$checkbox_num) = @_;
1.145     matthew  2488:     if ($ENV{'form.catalogmode'} eq 'interactive') {
1.150     matthew  2489:         $title=~ s/\'/\\\'/g;
1.145     matthew  2490:         if ($ENV{'form.catalogmode'} eq 'interactive') {
                   2491:             $output.=<<END 
                   2492: <font size='-1'><INPUT TYPE="button" NAME="returnvalues" VALUE="SELECT"
                   2493: onClick="javascript:select_data('$title','$url')">
                   2494: </font>
                   2495: END
                   2496:         }
1.150     matthew  2497:     } elsif ($ENV{'form.catalogmode'} eq 'groupsearch') {
1.145     matthew  2498:         $groupsearch_db{"pre_${fnum}_link"}=$url;
                   2499:         $groupsearch_db{"pre_${fnum}_title"}=$title;
                   2500:         $output.=<<END;
                   2501: <font size='-1'>
                   2502: <input type="checkbox" name="returnvalues" value="SELECT"
1.158     matthew  2503: onClick="javascript:queue($checkbox_num,$fnum)" />
1.145     matthew  2504: </font>
                   2505: END
                   2506:     }
                   2507:     return $output;
                   2508: }
                   2509: ######################################################################
                   2510: ######################################################################
                   2511: 
                   2512: =pod
                   2513: 
1.204     matthew  2514: =item &parse_row()
1.144     matthew  2515: 
                   2516: Parse a row returned from the database.
                   2517: 
                   2518: =cut
                   2519: 
                   2520: ######################################################################
                   2521: ######################################################################
                   2522: sub parse_row {
                   2523:     my @Row = @_;
                   2524:     my %Fields;
1.204     matthew  2525:     if (! scalar(@Datatypes)) {
                   2526:         &set_up_table_structure();
                   2527:     }
1.144     matthew  2528:     for (my $i=0;$i<=$#Row;$i++) {
1.170     matthew  2529:         $Fields{$Datatypes[$i]->{'name'}}=&Apache::lonnet::unescape($Row[$i]);
1.144     matthew  2530:     }
                   2531:     $Fields{'language'} = 
1.198     www      2532:         &Apache::loncommon::languagedescription($Fields{'language'});
1.144     matthew  2533:     $Fields{'copyrighttag'} =
                   2534:         &Apache::loncommon::copyrightdescription($Fields{'copyright'});
                   2535:     $Fields{'mimetag'} =
                   2536:         &Apache::loncommon::filedescription($Fields{'mime'});
                   2537:     return \%Fields;
                   2538: }
1.126     matthew  2539: 
                   2540: ###########################################################
                   2541: ###########################################################
                   2542: 
                   2543: =pod
                   2544: 
                   2545: =item &parse_raw_result()
                   2546: 
                   2547: Takes a line from the file of results and parse it.  Returns a hash 
1.198     www      2548: with keys according to column labels
1.126     matthew  2549: 
                   2550: In addition, the following tags are set by calling the appropriate 
1.198     www      2551: lonnet function: 'language', 'copyrighttag', 'mimetag'.
1.126     matthew  2552: 
                   2553: The 'title' field is set to "Untitled" if the title field is blank.
                   2554: 
                   2555: 'abstract' and 'keywords' are truncated to 200 characters.
                   2556: 
                   2557: =cut
                   2558: 
                   2559: ###########################################################
                   2560: ###########################################################
                   2561: sub parse_raw_result {
                   2562:     my ($result,$hostname) = @_;
1.204     matthew  2563:     # conclude from self to others regarding fields
1.206     matthew  2564:     my %Fields=&LONCAPA::lonmetadata::metadata_col_to_hash
                   2565:         (map {
                   2566:             &Apache::lonnet::unescape($_);
                   2567:         } (split(/\,/,$result)) );
1.126     matthew  2568:     return %Fields;
                   2569: }
                   2570: 
                   2571: ###########################################################
                   2572: ###########################################################
                   2573: 
                   2574: =pod
                   2575: 
                   2576: =item &handle_custom_fields()
                   2577: 
                   2578: =cut
                   2579: 
                   2580: ###########################################################
                   2581: ###########################################################
                   2582: sub handle_custom_fields {
                   2583:     my @results = @{shift()};
                   2584:     my $customshow='';
                   2585:     my $extrashow='';
                   2586:     my @customfields;
                   2587:     if ($ENV{'form.customshow'}) {
                   2588:         $customshow=$ENV{'form.customshow'};
                   2589:         $customshow=~s/[^\w\s]//g;
                   2590:         my @fields=map {
                   2591:             "<font color=\"#008000\">$_:</font><!-- $_ -->";
                   2592:         } split(/\s+/,$customshow);
                   2593:         @customfields=split(/\s+/,$customshow);
                   2594:         if ($customshow) {
                   2595:             $extrashow="<ul><li>".join("</li><li>",@fields)."</li></ul>\n";
                   2596:         }
                   2597:     }
                   2598:     my $customdata='';
                   2599:     my %customhash;
                   2600:     foreach my $result (@results) {
                   2601:         if ($result=~/^(custom\=.*)$/) { # grab all custom metadata
                   2602:             my $tmp=$result;
                   2603:             $tmp=~s/^custom\=//;
                   2604:             my ($k,$v)=map {&Apache::lonnet::unescape($_);
                   2605:                         } split(/\,/,$tmp);
                   2606:             $customhash{$k}=$v;
                   2607:         }
                   2608:     }
                   2609:     return ($extrashow,\@customfields,\%customhash);
1.41      harris41 2610: }
                   2611: 
1.122     matthew  2612: ######################################################################
                   2613: ######################################################################
                   2614: 
1.125     matthew  2615: =pod
                   2616: 
1.204     matthew  2617: =item &search_results_header()
1.125     matthew  2618: 
1.130     matthew  2619: Output the proper html headers and javascript code to deal with different 
                   2620: calling modes.
                   2621: 
                   2622: Takes most inputs directly from %ENV, except $mode.  
                   2623: 
                   2624: =over 4
                   2625: 
                   2626: =item $mode is either (at this writing) 'Basic' or 'Advanced'
                   2627: 
                   2628: =back
1.126     matthew  2629: 
1.130     matthew  2630: The following environment variables are checked:
1.126     matthew  2631: 
                   2632: =over 4
                   2633: 
                   2634: =item 'form.catalogmode' 
                   2635: 
                   2636: Checked for 'interactive' and 'groupsearch'.
                   2637: 
                   2638: =item 'form.mode'
                   2639: 
                   2640: Checked for existance & 'edit' mode.
                   2641: 
                   2642: =item 'form.form'
                   2643: 
1.191     albertel 2644: Contains the name of the form that has the input fields to set
                   2645: 
1.126     matthew  2646: =item 'form.element'
                   2647: 
1.191     albertel 2648: the name of the input field to put the URL into
                   2649: 
                   2650: =item 'form.titleelement'
                   2651: 
                   2652: the name of the input field to put the title into
                   2653: 
1.126     matthew  2654: =back
                   2655: 
1.125     matthew  2656: =cut
                   2657: 
                   2658: ######################################################################
                   2659: ######################################################################
                   2660: sub search_results_header {
1.150     matthew  2661:     my ($importbutton,$closebutton) = @_;
1.196     matthew  2662:     my $bodytag=&Apache::loncommon::bodytag(undef,undef,undef,1);
1.125     matthew  2663:     my $result = '';
                   2664:     # output beginning of search page
                   2665:     # conditional output of script functions dependent on the mode in
                   2666:     # which the search was invoked
                   2667:     if ($ENV{'form.catalogmode'} eq 'interactive'){
                   2668: 	if (! exists($ENV{'form.mode'}) || $ENV{'form.mode'} ne 'edit') {
                   2669:             $result.=<<SCRIPT;
                   2670: <script type="text/javascript">
                   2671:     function select_data(title,url) {
                   2672: 	changeTitle(title);
                   2673: 	changeURL(url);
1.150     matthew  2674: 	parent.close();
1.125     matthew  2675:     }
                   2676:     function changeTitle(val) {
1.153     matthew  2677: 	if (parent.opener.inf.document.forms.resinfo.elements.t) {
                   2678: 	    parent.opener.inf.document.forms.resinfo.elements.t.value=val;
1.125     matthew  2679: 	}
                   2680:     }
                   2681:     function changeURL(val) {
1.153     matthew  2682: 	if (parent.opener.inf.document.forms.resinfo.elements.u) {
                   2683: 	    parent.opener.inf.document.forms.resinfo.elements.u.value=val;
1.125     matthew  2684: 	}
                   2685:     }
                   2686: </script>
                   2687: SCRIPT
                   2688:         } elsif ($ENV{'form.mode'} eq 'edit') {
                   2689:             my $form = $ENV{'form.form'};
                   2690:             my $element = $ENV{'form.element'};
1.191     albertel 2691:             my $titleelement = $ENV{'form.titleelement'};
                   2692: 	    my $changetitle;
                   2693: 	    if (!$titleelement) {
                   2694: 		$changetitle='function changeTitle(val) {}';
                   2695: 	    } else {
                   2696: 		    $changetitle=<<END;
                   2697: function changeTitle(val) {
                   2698:     if (parent.targetwin.document) {
                   2699:         parent.targetwin.document.forms["$form"].elements["$titleelement"].value=val;
                   2700:     } else {
                   2701: 	var url = 'forms[\"$form\"].elements[\"$titleelement\"].value';
                   2702:         alert("Unable to transfer data to "+url);
                   2703:     }
                   2704: }
                   2705: END
                   2706:             }
                   2707: 
1.125     matthew  2708:             $result.=<<SCRIPT;
                   2709: <script type="text/javascript">
                   2710: function select_data(title,url) {
                   2711:     changeURL(url);
1.191     albertel 2712:     changeTitle(title);
1.150     matthew  2713:     parent.close();
1.125     matthew  2714: }
1.191     albertel 2715: $changetitle
1.125     matthew  2716: function changeURL(val) {
1.150     matthew  2717:     if (parent.targetwin.document) {
                   2718:         parent.targetwin.document.forms["$form"].elements["$element"].value=val;
1.125     matthew  2719:     } else {
                   2720: 	var url = 'forms[\"$form\"].elements[\"$element\"].value';
                   2721:         alert("Unable to transfer data to "+url);
                   2722:     }
                   2723: }
                   2724: </script>
                   2725: SCRIPT
                   2726:         }
                   2727:     }
                   2728:     $result.=<<SCRIPT if $ENV{'form.catalogmode'} eq 'groupsearch';
                   2729: <script type="text/javascript">
1.158     matthew  2730:     function queue(checkbox_num,val) {
1.185     matthew  2731:         if (document.forms.results.returnvalues.length != "undefined" &&
                   2732:             typeof(document.forms.results.returnvalues.length) == "number") {
                   2733:             if (document.forms.results.returnvalues[checkbox_num].checked) {
                   2734:                 parent.statusframe.document.forms.statusform.elements.Queue.value +='1a'+val+'b';
                   2735:             } else {
                   2736:                 parent.statusframe.document.forms.statusform.elements.Queue.value +='0a'+val+'b';
                   2737:             }
1.150     matthew  2738:         } else {
1.185     matthew  2739:             if (document.forms.results.returnvalues.checked) {
                   2740:                 parent.statusframe.document.forms.statusform.elements.Queue.value +='1a'+val+'b';
                   2741:             } else {
                   2742:                 parent.statusframe.document.forms.statusform.elements.Queue.value +='0a'+val+'b';
                   2743:             }
1.150     matthew  2744:         }
1.125     matthew  2745:     }
                   2746:     function select_group() {
1.150     matthew  2747: 	parent.window.location=
1.125     matthew  2748:     "/adm/groupsort?mode=$ENV{'form.mode'}&catalogmode=groupsearch&acts="+
1.150     matthew  2749: 	    parent.statusframe.document.forms.statusform.elements.Queue.value;
1.125     matthew  2750:     }
                   2751: </script>
                   2752: SCRIPT
1.130     matthew  2753:     $result.=<<END;
                   2754: </head>
1.155     matthew  2755: $bodytag
1.223   ! matthew  2756: <form name="results" method="post" action="/adm/searchcat" >
1.150     matthew  2757: <input type="hidden" name="Queue" value="" />
                   2758: $importbutton
1.130     matthew  2759: END
1.125     matthew  2760:     return $result;
                   2761: }
                   2762: 
                   2763: ######################################################################
                   2764: ######################################################################
1.146     matthew  2765: sub search_status_header {
1.196     matthew  2766:     my $bodytag=&Apache::loncommon::bodytag(undef,undef,undef,1);
1.146     matthew  2767:     return <<ENDSTATUS;
                   2768: <html><head><title>Search Status</title></head>
1.155     matthew  2769: $bodytag
1.146     matthew  2770: <h3>Search Status</h3>
                   2771: Sending search request to LON-CAPA servers.<br />
                   2772: ENDSTATUS
                   2773: }
                   2774: 
1.150     matthew  2775: sub results_link {
                   2776:     my $basic_link   = "/adm/searchcat?"."&table=".$ENV{'form.table'}.
                   2777:         "&persistent_db_id=".$ENV{'form.persistent_db_id'};
                   2778:     my $results_link = $basic_link."&phase=results".
1.151     matthew  2779:         "&pause=1"."&start=1";
1.150     matthew  2780:     return $results_link;
                   2781: }
                   2782: 
1.146     matthew  2783: ######################################################################
                   2784: ######################################################################
                   2785: sub print_frames_interface {
                   2786:     my $r = shift;
                   2787:     my $basic_link = "/adm/searchcat?"."&table=".$ENV{'form.table'}.
                   2788:         "&persistent_db_id=".$ENV{'form.persistent_db_id'};
                   2789:     my $run_search_link = $basic_link."&phase=run_search";
1.150     matthew  2790:     my $results_link = &results_link();
1.146     matthew  2791:     my $result = <<"ENDFRAMES";
                   2792: <html>
                   2793: <head>
1.150     matthew  2794: <script>
                   2795: var targetwin = opener;
1.158     matthew  2796: var queue = '';
1.150     matthew  2797: </script>
1.146     matthew  2798: <title>LON-CAPA Digital Library Search Results</title>
                   2799: </head>
1.176     www      2800: <frameset rows="150,*">
1.146     matthew  2801:     <frame name="statusframe"  src="$run_search_link">
                   2802:     <frame name="resultsframe" src="$results_link">
                   2803: </frameset>
                   2804: </html>
                   2805: ENDFRAMES
                   2806: 
                   2807:     $r->print($result);
                   2808:     return;
                   2809: }
                   2810: 
                   2811: ######################################################################
                   2812: ######################################################################
1.125     matthew  2813: 
1.122     matthew  2814: =pod 
                   2815: 
                   2816: =item Metadata Viewing Functions
                   2817: 
                   2818: Output is a HTML-ified string.
1.204     matthew  2819: 
1.122     matthew  2820: Input arguments are title, author, subject, url, keywords, version,
                   2821: notes, short abstract, mime, language, creation date,
1.126     matthew  2822: last revision date, owner, copyright, hostname, and
1.122     matthew  2823: extra custom metadata to show.
                   2824: 
                   2825: =over 4
                   2826: 
                   2827: =item &detailed_citation_view() 
                   2828: 
                   2829: =cut
                   2830: 
                   2831: ######################################################################
                   2832: ######################################################################
1.50      harris41 2833: sub detailed_citation_view {
1.150     matthew  2834:     my ($prefix,%values) = @_;
1.218     matthew  2835:     my $result;
                   2836:     $result .= '<b>'.$prefix.
1.223   ! matthew  2837:         '<img src="'.&Apache::loncommon::icon($values{'url'}).' " />'.'&nbsp;'.
1.218     matthew  2838:         '<a href="http://'.$ENV{'HTTP_HOST'}.$values{'url'}.'" '.
                   2839:         'target="search_preview">'.$values{'title'}."</a></b>\n";
                   2840:     $result .= "<p>\n";
                   2841:     $result .= '<b>'.$values{'author'}.'</b>,'.
                   2842:         ' <i>'.$values{'owner'}.'</i><br />';
                   2843:     foreach my $field 
                   2844:         (
1.223   ! matthew  2845:          { name=>'url',
        !          2846:            translate => '<b>URL:</b>&nbsp;[_1]',
        !          2847:            special => 'url link',},
1.218     matthew  2848:          { name=>'subject',
                   2849:            translate => '<b>Subject:</b>&nbsp;[_1]',},
                   2850:          { name=>'keywords',
                   2851:            translate => '<b>Keywords:</b>&nbsp;[_1]',},
                   2852:          { name=>'notes',
                   2853:            translate => '<b>Notes:</b>&nbsp;[_1]',},
                   2854:          { name=>'mimetag',
                   2855:            translate => '<b>MIME Type:</b>&nbsp;[_1]',},
                   2856:          { name=>'standards',
                   2857:            translate => '<b>Standards:</b>[_1]',},
                   2858:          { name=>'copyrighttag',
                   2859:            translate => '<b>Copyright/Distribution:</b>&nbsp;[_1]',},
1.223   ! matthew  2860:          { name=>'count',
        !          2861:            translate => '<b>Access Count:</b>&nbsp;[_1]',},
1.218     matthew  2862:          { name=>'stdno',
                   2863:            translate => '<b>Number of Students:</b>&nbsp;[_1]',},
                   2864:          { name=>'avetries',
                   2865:            translate => '<b>Average Tries:</b>&nbsp;[_1]',},
                   2866:          { name=>'disc',
                   2867:            translate => '<b>Degree of Discrimination:</b>&nbsp;[_1]',},
                   2868:          { name=>'difficulty',
                   2869:            translate => '<b>Degree of Difficulty:</b>&nbsp;[_1]',},
                   2870:          { name=>'clear',
                   2871:            translate => '<b>Clear:</b>&nbsp;[_1]',},
                   2872:          { name=>'depth',
                   2873:            translate => '<b>Depth:</b>&nbsp;[_1]',},
                   2874:          { name=>'helpful',
                   2875:            translate => '<b>Helpful:</b>&nbsp;[_1]',},
                   2876:          { name=>'correct',
                   2877:            translate => '<b>Correcy:</b>&nbsp;[_1]',},
                   2878:          { name=>'technical',
                   2879:            translate => '<b>Technical:</b>&nbsp;[_1]',},
                   2880:          ) {
1.223   ! matthew  2881:         if (exists($values{$field->{'name'}}) &&
        !          2882:             $values{$field->{'name'}} ne '') {
        !          2883:             if ($field->{'special'} eq 'url link') {
        !          2884:                 $result.= 
        !          2885:                     &mt($field->{'translate'},
        !          2886:                         '<a href="'.$values{'url'}.'" '.
        !          2887:                             'target="search_preview">'.
        !          2888:                         $values{$field->{'name'}}.
        !          2889:                         '</a>');
        !          2890:             } else {
        !          2891:                 $result.= &mt($field->{'translate'},
        !          2892:                               $values{$field->{'name'}});
        !          2893:             }
        !          2894:             $result .= "<br />\n";
        !          2895:             }
        !          2896:     }
        !          2897:     $result .= "</p>";
        !          2898:     if (exists($values{'extrashow'}) && $values{'extrashow'} ne '') {
        !          2899:         $result .= '<p>'.$values{'extrashow'}.'</p>';
        !          2900:     }
        !          2901:     if (exists($values{'shortabstract'}) && $values{'shortabstract'} ne '') {
        !          2902:         $result .= '<p>'.$values{'shortabstract'}.'</p>';
1.218     matthew  2903:     }
                   2904:     $result .= '<hr align="left" width="200" noshade />'."\n";
1.50      harris41 2905:     return $result;
                   2906: }
                   2907: 
1.122     matthew  2908: ######################################################################
                   2909: ######################################################################
                   2910: 
1.222     matthew  2911: sub has_stat_data {
                   2912:     my ($values) = @_;
                   2913:     if ( (defined($values->{'count'})      && $values->{'count'}      ne '') ||
                   2914:          (defined($values->{'stdno'})      && $values->{'stdno'}      ne '') ||
                   2915:          (defined($values->{'disc'})       && $values->{'disc'}       ne '') ||
                   2916:          (defined($values->{'avetries'})   && $values->{'avetries'}   ne '') ||
                   2917:          (defined($values->{'difficulty'}) && $values->{'difficulty'} ne '')) {
                   2918:         return 1;
                   2919:     }
                   2920:     return 0;
                   2921: }
                   2922: 
                   2923: sub statfields {
                   2924:     return ('count','stdno','disc','avetries','difficulty');
                   2925: }
                   2926: 
                   2927: sub has_eval_data {
                   2928:     my ($values) = @_;
                   2929:     if ( (defined($values->{'clear'})     && $values->{'clear'}     ne '') ||
                   2930:          (defined($values->{'technical'}) && $values->{'technical'} ne '') ||
                   2931:          (defined($values->{'correct'})   && $values->{'correct'}   ne '') ||
                   2932:          (defined($values->{'helpful'})   && $values->{'helpful'}   ne '') ||
                   2933:          (defined($values->{'depth'})     && $values->{'depth'}     ne '')) {
                   2934:         return 1;
                   2935:     }
                   2936:     return 0;
                   2937: }
                   2938: 
                   2939: sub evalfields { 
                   2940:     return ('clear','technical','correct','helpful','depth');
                   2941: }
                   2942: 
                   2943: ######################################################################
                   2944: ######################################################################
                   2945: 
1.122     matthew  2946: =pod 
                   2947: 
                   2948: =item &summary_view() 
                   2949: 
                   2950: =cut
                   2951: ######################################################################
                   2952: ######################################################################
1.50      harris41 2953: sub summary_view {
1.150     matthew  2954:     my ($prefix,%values) = @_;
1.192     albertel 2955:     my $icon=&Apache::loncommon::icon($values{'url'});
1.50      harris41 2956:     my $result=<<END;
1.223   ! matthew  2957: $prefix<img src="$icon" />&nbsp;
        !          2958: <a href="http://$ENV{'HTTP_HOST'}$values{'url'}" 
1.126     matthew  2959:    target='search_preview'>$values{'author'}</a><br />
                   2960: $values{'title'}<br />
                   2961: $values{'owner'} -- $values{'lastrevisiondate'}<br />
                   2962: $values{'copyrighttag'}<br />
                   2963: $values{'extrashow'}
1.50      harris41 2964: </p>
1.150     matthew  2965: <hr align='left' width='200' noshade />
1.50      harris41 2966: END
                   2967:     return $result;
                   2968: }
                   2969: 
1.122     matthew  2970: ######################################################################
                   2971: ######################################################################
                   2972: 
                   2973: =pod 
                   2974: 
1.150     matthew  2975: =item &compact_view() 
                   2976: 
                   2977: =cut
                   2978: 
                   2979: ######################################################################
                   2980: ######################################################################
                   2981: sub compact_view {
                   2982:     my ($prefix,%values) = @_;
1.223   ! matthew  2983:     my $result = 
        !          2984:         $prefix.'<img src="'.&Apache::loncommon::icon($values{'url'}).
        !          2985:         '">&nbsp;<a href="'.$values{'url'}.'" target="search_preview">'.
        !          2986:         $values{'title'}.'</a>'.('&nbsp;'x2).
        !          2987:         '<b>'.$values{'author'}.'</b><br />';
1.150     matthew  2988:     return $result;
                   2989: }
                   2990: 
                   2991: 
                   2992: ######################################################################
                   2993: ######################################################################
                   2994: 
                   2995: =pod 
                   2996: 
1.122     matthew  2997: =item &fielded_format_view() 
                   2998: 
                   2999: =cut
                   3000: 
                   3001: ######################################################################
                   3002: ######################################################################
1.50      harris41 3003: sub fielded_format_view {
1.150     matthew  3004:     my ($prefix,%values) = @_;
1.192     albertel 3005:     my $icon=&Apache::loncommon::icon($values{'url'});
1.222     matthew  3006:     my %Translated = &Apache::lonmeta::fieldnames();
1.50      harris41 3007:     my $result=<<END;
1.192     albertel 3008: $prefix <img src="$icon" />
1.222     matthew  3009: <dl>
                   3010: <dt>URL:</dt>
                   3011:     <dd><a href="http://$ENV{'HTTP_HOST'}$values{'url'}" 
                   3012:          target='search_preview'>$values{'url'}</a></dd>
1.50      harris41 3013: END
1.222     matthew  3014:     foreach my $field ('title','author','subject','keywords','notes',
                   3015:                        'mimetag','language','creationdate','lastrevisiondate',
                   3016:                        'owner','copyrighttag','hostname','abstract') {
                   3017:         $result .= (' 'x4).'<dt>'.$Translated{$field}.'</dt>'."\n".
                   3018:             (' 'x8).'<dd>'.$values{$field}.'</dd>'."\n";
                   3019:     }
                   3020:     if (&has_stat_data(\%values)) {
                   3021:         foreach my $field (&statfields()) {
                   3022:             $result .= (' 'x4).'<dt>'.$Translated{$field}.'</dt>'."\n".
                   3023:                 (' 'x8).'<dd>'.$values{$field}.'</dd>'."\n";
                   3024:         }
                   3025:     }
                   3026:     if (&has_eval_data(\%values)) {
                   3027:         foreach my $field (&evalfields()) {
                   3028:             $result .= (' 'x4).'<dt>'.$Translated{$field}.'</dt>'."\n".
                   3029:                 (' 'x8).'<dd>'.$values{$field}.'</dd>'."\n";
                   3030:         }
                   3031:     }
                   3032:     $result .= "</dl>\n";
                   3033:     $result .= $values{'extrashow'};
                   3034:     $result .= '<hr align="left" width="200" noshade />'."\n";
1.50      harris41 3035:     return $result;
                   3036: }
                   3037: 
1.122     matthew  3038: ######################################################################
                   3039: ######################################################################
                   3040: 
                   3041: =pod 
                   3042: 
                   3043: =item &xml_sgml_view() 
                   3044: 
                   3045: =back 
                   3046: 
                   3047: =cut
                   3048: 
                   3049: ######################################################################
                   3050: ######################################################################
1.50      harris41 3051: sub xml_sgml_view {
1.150     matthew  3052:     my ($prefix,%values) = @_;
1.222     matthew  3053:     my $xml = '<LonCapaResource>'."\n";
                   3054:     # The usual suspects
                   3055:     foreach my $field ('url','title','author','subject','keywords','notes') {
                   3056:         $xml .= qq{<$field>$values{$field}</$field>}."\n";
                   3057:     }
                   3058:     #
                   3059:     $xml .= "<mimeInfo>\n";
                   3060:     foreach my $field ('mime','mimetag') {
                   3061:         $xml .= qq{<$field>$values{$field}</$field>}."\n";
                   3062:     }
                   3063:     $xml .= "</mimeInfo>\n";
                   3064:     #
                   3065:     $xml .= "<languageInfo>\n";
                   3066:     foreach my $field ('language','languagetag') {
                   3067:         $xml .= qq{<$field>$values{$field}</$field>}."\n";
                   3068:     }
                   3069:     $xml .= "</languageInfo>\n";
                   3070:     #
                   3071:     foreach my $field ('creationdate','lastrevisiondate','owner') {
                   3072:         $xml .= qq{<$field>$values{$field}</$field>}."\n";
                   3073:     }
                   3074:     #
                   3075:     $xml .= "<copyrightInfo>\n";
                   3076:     foreach my $field ('copyright','copyrighttag') {
                   3077:         $xml .= qq{<$field>$values{$field}</$field>}."\n";
                   3078:     }
                   3079:     $xml .= "</copyrightInfo>\n";
                   3080:     $xml .= qq{<repositoryLocation>$values{'hostname'}</repositoryLocation>}.
                   3081:         "\n";
                   3082:     $xml .= qq{<shortabstract>$values{'shortabstract'}</shortabstract>}."\n";
                   3083:     #
                   3084:     if (&has_stat_data(\%values)){
                   3085:         $xml .= "<problemstatistics>\n";
                   3086:         foreach my $field (&statfields()) {
                   3087:             $xml .= qq{<$field>$values{$field}</$field>}."\n";            
                   3088:         }
                   3089:         $xml .= "</problemstatistics>\n";
                   3090:     }
                   3091:     #
                   3092:     if (&has_eval_data(\%values)) {
                   3093:         $xml .= "<evaluation>\n";
                   3094:         foreach my $field (&evalfields) {
                   3095:             $xml .= qq{<$field>$values{$field}</$field>}."\n";            
                   3096:         }
                   3097:         $xml .= "</evaluation>\n";
                   3098:     }    
                   3099:     #
                   3100:     $xml .= "</LonCapaResource>\n";
1.212     matthew  3101:     $xml = &HTML::Entities::encode($xml,'<>&');
1.50      harris41 3102:     my $result=<<END;
1.150     matthew  3103: $prefix
1.56      harris41 3104: <pre>
1.212     matthew  3105: $xml
1.56      harris41 3106: </pre>
1.126     matthew  3107: $values{'extrashow'}
1.150     matthew  3108: <hr align='left' width='200' noshade />
1.50      harris41 3109: END
                   3110:     return $result;
1.60      harris41 3111: }
                   3112: 
1.122     matthew  3113: ######################################################################
                   3114: ######################################################################
                   3115: 
                   3116: =pod 
                   3117: 
                   3118: =item &filled() see if field is filled.
                   3119: 
                   3120: =cut
                   3121: 
                   3122: ######################################################################
                   3123: ######################################################################
1.98      harris41 3124: sub filled {
                   3125:     my ($field)=@_;
                   3126:     if ($field=~/\S/ && $field ne 'any') {
1.204     matthew  3127:         return 1;
                   3128:     } else {
                   3129:         return 0;
1.61      harris41 3130:     }
1.60      harris41 3131: }
                   3132: 
1.122     matthew  3133: ######################################################################
                   3134: ######################################################################
                   3135: 
                   3136: =pod 
                   3137: 
                   3138: =item &output_blank_field_error()
                   3139: 
1.151     matthew  3140: Output a complete page that indicates the user has not filled in enough
                   3141: information to do a search.
                   3142: 
                   3143: Inputs: $r (Apache request handle), $closebutton, $parms.
                   3144: 
                   3145: Returns: nothing
                   3146: 
                   3147: $parms is extra information to include in the 'Revise search request' link.
                   3148: 
1.122     matthew  3149: =cut
                   3150: 
                   3151: ######################################################################
                   3152: ######################################################################
1.98      harris41 3153: sub output_blank_field_error {
1.196     matthew  3154:     my ($r,$closebutton,$parms,$hidden_fields)=@_;
                   3155:     my $bodytag=&Apache::loncommon::bodytag(undef,undef,undef,1);
1.98      harris41 3156:     # make query information persistent to allow for subsequent revision
                   3157:     $r->print(<<BEGINNING);
                   3158: <html>
                   3159: <head>
                   3160: <title>The LearningOnline Network with CAPA</title>
                   3161: BEGINNING
                   3162:     $r->print(<<RESULTS);
                   3163: </head>
1.155     matthew  3164: $bodytag
1.98      harris41 3165: <img align='right' src='/adm/lonIcons/lonlogos.gif' />
                   3166: <h1>Search Catalog</h1>
                   3167: <form method="post" action="/adm/searchcat">
1.145     matthew  3168: $hidden_fields
1.151     matthew  3169: <a href="/adm/searchcat?$parms&persistent_db_id=$ENV{'form.persistent_db_id'}"
1.146     matthew  3170: >Revise search request</a>&nbsp;
1.98      harris41 3171: $closebutton
                   3172: <hr />
1.151     matthew  3173: <h3>Unactionable search query.</h3>
1.98      harris41 3174: <p>
1.151     matthew  3175: You did not fill in enough information for the search to be started.
                   3176: You need to fill in relevant fields on the search page in order 
                   3177: for a query to be processed.
1.98      harris41 3178: </p>
                   3179: </body>
                   3180: </html>
                   3181: RESULTS
                   3182: }
                   3183: 
1.122     matthew  3184: ######################################################################
                   3185: ######################################################################
                   3186: 
                   3187: =pod 
                   3188: 
                   3189: =item &output_date_error()
                   3190: 
                   3191: Output a full html page with an error message.
                   3192: 
1.145     matthew  3193: Inputs: 
                   3194: 
                   3195:     $r, the request pointer.
                   3196:     $message, the error message for the user.
                   3197:     $closebutton, the specialized close button needed for groupsearch.
                   3198: 
1.122     matthew  3199: =cut
                   3200: 
                   3201: ######################################################################
                   3202: ######################################################################
1.60      harris41 3203: sub output_date_error {
1.196     matthew  3204:     my ($r,$message,$closebutton,$hidden_fields)=@_;
1.60      harris41 3205:     # make query information persistent to allow for subsequent revision
1.196     matthew  3206:     my $bodytag=&Apache::loncommon::bodytag(undef,undef,undef,1);
1.122     matthew  3207:     $r->print(<<RESULTS);
1.60      harris41 3208: <html>
                   3209: <head>
                   3210: <title>The LearningOnline Network with CAPA</title>
                   3211: </head>
1.155     matthew  3212: $bodytag
1.98      harris41 3213: <img align='right' src='/adm/lonIcons/lonlogos.gif' />
1.60      harris41 3214: <h1>Search Catalog</h1>
                   3215: <form method="post" action="/adm/searchcat">
1.145     matthew  3216: $hidden_fields
1.60      harris41 3217: <input type='button' value='Revise search request'
1.98      harris41 3218: onClick='this.form.submit();' />
1.60      harris41 3219: $closebutton
1.98      harris41 3220: <hr />
1.151     matthew  3221: <h3>Error</h3>
1.60      harris41 3222: <p>
                   3223: $message
                   3224: </p>
                   3225: </body>
                   3226: </html>
                   3227: RESULTS
1.101     harris41 3228: }
                   3229: 
1.122     matthew  3230: ######################################################################
                   3231: ######################################################################
                   3232: 
                   3233: =pod 
                   3234: 
                   3235: =item &start_fresh_session()
                   3236: 
1.142     matthew  3237: Cleans the global %groupsearch_db by removing all fields which begin with
1.122     matthew  3238: 'pre_' or 'store'.
                   3239: 
                   3240: =cut
                   3241: 
                   3242: ######################################################################
                   3243: ######################################################################
1.101     harris41 3244: sub start_fresh_session {
1.142     matthew  3245:     delete $groupsearch_db{'mode_catalog'};
                   3246:     foreach (keys %groupsearch_db) {
1.101     harris41 3247:         if ($_ =~ /^pre_/) {
1.142     matthew  3248:             delete $groupsearch_db{$_};
1.101     harris41 3249:         }
                   3250:         if ($_ =~ /^store/) {
1.142     matthew  3251: 	    delete $groupsearch_db{$_};
1.101     harris41 3252: 	}
1.109     harris41 3253:     }
1.3       harris41 3254: }
1.1       www      3255: 
                   3256: 1;
1.162     www      3257: 
                   3258: sub cleanup {
1.163     www      3259:     if (tied(%groupsearch_db)) {
                   3260:         unless (untie(%groupsearch_db)) {
                   3261: 	  &Apache::lonnet::logthis('Failed cleanup searchcat: groupsearch_db');
                   3262:         }
                   3263:     }
1.167     www      3264:     &untiehash();
1.162     www      3265:     &Apache::lonmysql::disconnect_from_db();
                   3266: }
1.98      harris41 3267: 
1.1       www      3268: __END__
1.105     harris41 3269: 
1.121     matthew  3270: =pod
1.105     harris41 3271: 
1.121     matthew  3272: =back 
1.105     harris41 3273: 
                   3274: =cut

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