3 * Generate an OpenSearch description file.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
23 // This endpoint is supposed to be independent of request cookies and other
24 // details of the session. Enforce this constraint with respect to session use.
25 define( 'MW_NO_SESSION', 1 );
27 require_once __DIR__
. '/includes/WebStart.php';
29 if ( $wgRequest->getVal( 'ctype' ) == 'application/xml' ) {
30 // Makes testing tweaks about a billion times easier
31 $ctype = 'application/xml';
33 $ctype = 'application/opensearchdescription+xml';
36 $response = $wgRequest->response();
37 $response->header( "Content-type: $ctype" );
39 // Set an Expires header so that CDN can cache it for a short time
40 // Short enough so that the sysadmin barely notices when $wgSitename is changed
41 $expiryTime = 600; # 10 minutes
42 $response->header( 'Expires: ' . gmdate( 'D, d M Y H:i:s', time() +
$expiryTime ) . ' GMT' );
43 $response->header( 'Cache-control: max-age=600' );
45 print '<?xml version="1.0"?>';
46 print Xml
::openElement( 'OpenSearchDescription',
48 'xmlns' => 'http://a9.com/-/spec/opensearch/1.1/',
49 'xmlns:moz' => 'http://www.mozilla.org/2006/browser/search/' ] );
51 /* The spec says the ShortName must be no longer than 16 characters,
52 * but 16 is *realllly* short. In practice, browsers don't appear to care
53 * when we give them a longer string, so we're no longer attempting to trim.
55 * Note: ShortName and the <link title=""> need to match; they are used as
56 * a key for identifying if the search engine has been added already, *and*
57 * as the display name presented to the end-user.
59 * Behavior seems about the same between Firefox and IE 7/8 here.
60 * 'Description' doesn't appear to be used by either.
62 $fullName = wfMessage( 'opensearch-desc' )->inContentLanguage()->text();
63 print Xml
::element( 'ShortName', null, $fullName );
64 print Xml
::element( 'Description', null, $fullName );
66 // By default we'll use the site favicon.
67 // Double-check if IE supports this properly?
68 print Xml
::element( 'Image',
72 'type' => 'image/x-icon' ],
73 wfExpandUrl( $wgFavicon, PROTO_CURRENT
) );
77 // General search template. Given an input term, this should bring up
78 // search results or a specific found page.
79 // At least Firefox and IE 7 support this.
80 $searchPage = SpecialPage
::getTitleFor( 'Search' );
82 'type' => 'text/html',
84 'template' => $searchPage->getCanonicalURL( 'search={searchTerms}' ) ];
86 foreach ( $wgOpenSearchTemplates as $type => $template ) {
88 $template = ApiOpenSearch
::getOpenSearchTemplate( $type );
95 'template' => $template,
100 // Allow hooks to override the suggestion URL settings in a more
101 // general way than overriding the whole search engine...
102 Hooks
::run( 'OpenSearchUrls', [ &$urls ] );
104 foreach ( $urls as $attribs ) {
105 print Xml
::element( 'Url', $attribs );
108 // And for good measure, add a link to the straight search form.
109 // This is a custom format extension for Firefox, which otherwise
110 // sends you to the domain root if you hit "enter" with an empty
112 print Xml
::element( 'moz:SearchForm', null,
113 $searchPage->getCanonicalURL() );
115 print '</OpenSearchDescription>';