rt/share/html/Search/Simple.html

   1 %# BEGIN BPS TAGGED BLOCK {{{
   2 %#
   3 %# COPYRIGHT:
   4 %#
   5 %# This software is Copyright (c) 1996-2014 Best Practical Solutions, LLC
   6 %#                                          <sales@bestpractical.com>
   7 %#
   8 %# (Except where explicitly superseded by other copyright notices)
   9 %#
  10 %#
  11 %# LICENSE:
  12 %#
  13 %# This work is made available to you under the terms of Version 2 of
  14 %# the GNU General Public License. A copy of that license should have
  15 %# been provided with this software, but in any event can be snarfed
  16 %# from www.gnu.org.
  17 %#
  18 %# This work is distributed in the hope that it will be useful, but
  19 %# WITHOUT ANY WARRANTY; without even the implied warranty of
  20 %# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  21 %# General Public License for more details.
  22 %#
  23 %# You should have received a copy of the GNU General Public License
  24 %# along with this program; if not, write to the Free Software
  25 %# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  26 %# 02110-1301 or visit their web page on the internet at
  27 %# http://www.gnu.org/licenses/old-licenses/gpl-2.0.html.
  28 %#
  29 %#
  30 %# CONTRIBUTION SUBMISSION POLICY:
  31 %#
  32 %# (The following paragraph is not intended to limit the rights granted
  33 %# to you to modify and distribute this software under the terms of
  34 %# the GNU General Public License and is only of importance to you if
  35 %# you choose to contribute your changes and enhancements to the
  36 %# community by submitting them to Best Practical Solutions, LLC.)
  37 %#
  38 %# By intentionally submitting any modifications, corrections or
  39 %# derivatives to this work, or any other work intended for use with
  40 %# Request Tracker, to Best Practical Solutions, LLC, you confirm that
  41 %# you are the copyright holder for those contributions and you grant
  42 %# Best Practical Solutions,  LLC a nonexclusive, worldwide, irrevocable,
  43 %# royalty-free, perpetual, license to use, copy, create derivative
  44 %# works based on those contributions, and sublicense and distribute
  45 %# those contributions and any derivatives thereof.
  46 %#
  47 %# END BPS TAGGED BLOCK }}}
  48 <& /Elements/Header, Title => $title &>
  49 <& /Elements/Tabs
  50 &>
  51
  52 % $m->callback( %ARGS, CallbackName => 'PreForm' );
  53
  54 <div id="SimpleSearchForm">
  55 <form action="Simple.html" method="get">
  56
  57 <div align="center">
  58 <input name="q" size="60" /><input type="submit" class="button" value="<&|/l&>Search</&>" />
  59 </div>
  60
  61 % my @strong = qw(<strong> </strong>);
  62
  63 <p><&|/l_unsafe, @strong &>Search for tickets by entering [_1]id[_2] numbers, subject words [_1]"in quotes"[_2], [_1]queues[_2] by name, Owners by [_1]username[_2], Requestors by [_1]email address[_2], and ticket [_1]statuses[_2].  Searching for [_1]@domainname.com[_2] will return tickets with requestors from that domain.</&></p>
  64
  65 <p><&|/l&>Any word not recognized by RT is searched for in ticket subjects.</&></p>
  66
  67 % my $config = RT->Config->Get('FullTextSearch') || {};
  68 % my $fulltext_keyword = 'fulltext:';
  69 % if ( $config->{'Enable'} ) {
  70 % if ( $config->{'Indexed'} ) {
  71 <p><&|/l, $fulltext_keyword &>You can search for any word in full ticket history by typing <b>[_1]<i>word</i></b>.</&></p>
  72 % } else {
  73 <p><&|/l, $fulltext_keyword &>Searching the full text of every ticket can take a long time, but if you need to do it, you can search for any word in full ticket history by typing <b>[_1]<i>word</i></b>.</&></p>
  74 % }
  75 % }
  76
  77 <p><&|/l_unsafe, map { "<strong>$_</strong>" } qw(initial active inactive any) &>Entering [_1], [_2], [_3], or [_4] limits results to tickets with one of the respective types of statuses.  Any individual status name limits results to just the statuses named.</&>
  78
  79 % if (RT->Config->Get('OnlySearchActiveTicketsInSimpleSearch', $session{'CurrentUser'})) {
  80 % my $status_str  = join ', ', map { loc($_) } RT::Queue->ActiveStatusArray;
  81 <&|/l, $status_str &>Unless you specify a specific status, only tickets with active statuses ([_1]) are searched.</&>
  82 % }
  83 </p>
  84
  85 <p><&|/l_unsafe, map { "<strong>$_</strong>" } 'queue:"Example Queue"', 'owner:email@example.com' &>Start the search term with the name of a supported field followed by a colon, as in [_1] and [_2], to explicitly specify the search type.</&></p>
  86
  87 <p><&|/l_unsafe, '<strong>cf.Name:value</strong>' &>CFs may be searched using a similar syntax as above with [_1].</&></p>
  88
  89 % my $link_start  = '<a href="' . RT->Config->Get('WebPath') . '/Search/Build.html">';
  90 % my $link_end    = '</a>';
  91 <p><&|/l_unsafe, $link_start, $link_end &>For the full power of RT's searches, please visit the [_1]search builder interface[_2].</&></p>
  92
  93 </form>
  94
  95 % $m->callback( %ARGS, CallbackName => 'PostForm' );
  96
  97 </div>
  98
  99 <%INIT>
 100 my $title = loc("Search for tickets");
 101 use RT::Search::Googleish;
 102
 103 if ($q) {
 104     my $tickets = RT::Tickets->new( $session{'CurrentUser'} );
 105     $m->callback( %ARGS, query => \$q, CallbackName => 'ModifyQuery' );
 106
 107     if ($q =~ /^#?(\d+)$/) {
 108         RT::Interface::Web::Redirect(RT->Config->Get('WebURL')."Ticket/Display.html?id=".$1);
 109     }
 110
 111     my %args = (
 112         Argument   => $q,
 113         TicketsObj => $tickets,
 114     );
 115
 116     $m->callback( %ARGS, CallbackName => 'SearchArgs', args => \%args);
 117
 118     my $search = RT::Search::Googleish->new(%args);
 119
 120     $m->comp( "Results.html", Query => $search->QueryToSQL() );
 121     $m->comp( "/Elements/Footer" );
 122     $m->abort();
 123 }
 124 </%INIT>
 125
 126 <%ARGS>
 127 $q => undef
 128 </%ARGS>
 129