Upgrade to 4.0.10.
[usit-rt.git] / share / html / Search / Simple.html
CommitLineData
84fb5b46
MKG
1%# BEGIN BPS TAGGED BLOCK {{{
2%#
3%# COPYRIGHT:
4%#
403d7b0b 5%# This software is Copyright (c) 1996-2013 Best Practical Solutions, LLC
84fb5b46
MKG
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].</&></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>
100my $title = loc("Search for tickets");
101use RT::Search::Googleish;
102
103if ($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