lib/plugin/TitleSearch.php

   1 <?php // -*-php-*-
   2 rcs_id('$Id: TitleSearch.php,v 1.29 2007-01-02 13:23:30 rurban Exp $');
   3 /**
   4  Copyright 1999,2000,2001,2002,2004,2005 $ThePhpWikiProgrammingTeam
   5
   6  This file is part of PhpWiki.
   7
   8  PhpWiki is free software; you can redistribute it and/or modify
   9  it under the terms of the GNU General Public License as published by
  10  the Free Software Foundation; either version 2 of the License, or
  11  (at your option) any later version.
  12
  13  PhpWiki is distributed in the hope that it will be useful,
  14  but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  GNU General Public License for more details.
  17
  18  You should have received a copy of the GNU General Public License
  19  along with PhpWiki; if not, write to the Free Software
  20  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  */
  22
  23 require_once('lib/TextSearchQuery.php');
  24 require_once('lib/PageList.php');
  25
  26 /**
  27  * Display results of pagename search.
  28  * Provides no own input box, just <?plugin-form TitleSearch ?> is enough.
  29  * Fancier Inputforms can be made using WikiForm Rich, to support regex and case_exact args.
  30  *
  31  * If only one pages is found and auto_redirect is true, this page is displayed immediatly,
  32  * otherwise the found pagelist is displayed.
  33  * The workhorse TextSearchQuery converts the query string from google-style words
  34  * to the required DB backend expression.
  35  *   (word and word) OR word, -word, "two words"
  36  * regex=auto tries to detect simple glob-style wildcards and expressions,
  37  * like xx*, *xx, ^xx, xx$, ^word$.
  38  */
  39 class WikiPlugin_TitleSearch
  40 extends WikiPlugin
  41 {
  42     function getName () {
  43         return _("TitleSearch");
  44     }
  45
  46     function getDescription () {
  47         return _("Search the titles of all pages in this wiki.");
  48     }
  49
  50     function getVersion() {
  51         return preg_replace("/[Revision: $]/", '',
  52                             "\$Revision: 1.29 $");
  53     }
  54
  55     function getDefaultArguments() {
  56         return array_merge
  57             (
  58              PageList::supportedArgs(), // paging and more.
  59              array('s'             => false,
  60                    'auto_redirect' => false,
  61                    'noheader'      => false,
  62                    'exclude'       => false,
  63                    'info'          => false,
  64                    'case_exact'    => false,
  65                    'regex'         => 'auto',
  66                    'format'        => false,
  67                    ));
  68     }
  69     // info arg allows multiple columns
  70     // info=mtime,hits,summary,version,author,locked,minor
  71     // exclude arg allows multiple pagenames exclude=Php*,RecentChanges
  72
  73     function run($dbi, $argstr, &$request, $basepage) {
  74         $args = $this->getArgs($argstr, $request);
  75         if (empty($args['s']))
  76             return '';
  77
  78         $query = new TextSearchQuery($args['s'], $args['case_exact'], $args['regex']);
  79         $pages = $dbi->titleSearch($query,$args['sortby'],$args['limit'],$args['exclude']);
  80
  81         $pagelist = new PageList($args['info'], $args['exclude'], $args);
  82         while ($page = $pages->next()) {
  83             $pagelist->addPage($page);
  84             $last_name = $page->getName();
  85         }
  86         // this hack will go away
  87         if ($args['format'] == 'livesearch') {
  88             $request->discardOutput();
  89             $request->buffer_output(false);
  90             echo '<div class="LSRes">';
  91             echo $pagelist->asXml();
  92             echo '</div>';
  93             if (empty($WikiTheme->DUMP_MODE)) {
  94                 unset($GLOBALS['ErrorManager']->_postponed_errors);
  95                 $request->finish();
  96             }
  97         }
  98         // Provide an unknown WikiWord link to allow for page creation
  99         // when a search returns no results
 100         if (!$args['noheader']) {
 101             $s = $args['s'];
 102             if (!$pagelist->getTotal() and !$query->_regex)
 103                 $s = WikiLink($args['s'], 'auto');
 104             $pagelist->setCaption(fmt("Title search results for '%s'", $s));
 105         }
 106
 107         if ($args['auto_redirect'] && ($pagelist->getTotal() == 1)) {
 108             return HTML($request->redirect(WikiURL($last_name, false, 'absurl'), false),
 109                         $pagelist);
 110         }
 111
 112         return $pagelist;
 113     }
 114 };
 115
 116 // $Log: not supported by cvs2svn $
 117 // Revision 1.28  2005/09/10 21:33:08  rurban
 118 // support enhanced API
 119 //
 120 // Revision 1.27  2005/02/03 05:09:57  rurban
 121 // livesearch.js support
 122 //
 123 // Revision 1.26  2004/11/27 14:39:05  rurban
 124 // simpified regex search architecture:
 125 //   no db specific node methods anymore,
 126 //   new sql() method for each node
 127 //   parallel to regexp() (which returns pcre)
 128 //   regex types bitmasked (op's not yet)
 129 // new regex=sql
 130 // clarified WikiDB::quote() backend methods:
 131 //   ->quote() adds surrounsing quotes
 132 //   ->qstr() (new method) assumes strings and adds no quotes! (in contrast to ADODB)
 133 //   pear and adodb have now unified quote methods for all generic queries.
 134 //
 135 // Revision 1.25  2004/11/26 18:39:02  rurban
 136 // new regex search parser and SQL backends (90% complete, glob and pcre backends missing)
 137 //
 138 // Revision 1.24  2004/11/25 08:30:58  rurban
 139 // dont extract args
 140 //
 141 // Revision 1.23  2004/11/23 15:17:19  rurban
 142 // better support for case_exact search (not caseexact for consistency),
 143 // plugin args simplification:
 144 //   handle and explode exclude and pages argument in WikiPlugin::getArgs
 145 //     and exclude in advance (at the sql level if possible)
 146 //   handle sortby and limit from request override in WikiPlugin::getArgs
 147 // ListSubpages: renamed pages to maxpages
 148 //
 149 // Revision 1.22  2004/11/23 13:35:49  rurban
 150 // add case_exact search
 151 //
 152 // Revision 1.21  2004/02/17 12:11:36  rurban
 153 // added missing 4th basepage arg at plugin->run() to almost all plugins. This caused no harm so far, because it was silently dropped on normal usage. However on plugin internal ->run invocations it failed. (InterWikiSearch, IncludeSiteMap, ...)
 154 //
 155 // Revision 1.20  2003/11/02 20:42:35  carstenklapp
 156 // Allow for easy page creation when search returns no matches.
 157 // Based on cuthbertcat's patch, SF#655090 2002-12-17.
 158 //
 159 // Revision 1.19  2003/03/07 02:50:16  dairiki
 160 // Fixes for new javascript redirect.
 161 //
 162 // Revision 1.18  2003/02/21 04:16:51  dairiki
 163 // Don't NORETURN from redirect.
 164 //
 165 // Revision 1.17  2003/01/18 22:08:01  carstenklapp
 166 // Code cleanup:
 167 // Reformatting & tabs to spaces;
 168 // Added copyleft, getVersion, getDescription, rcs_id.
 169 //
 170
 171 // Local Variables:
 172 // mode: php
 173 // tab-width: 8
 174 // c-basic-offset: 4
 175 // c-hanging-comment-ender-p: nil
 176 // indent-tabs-mode: nil
 177 // End:
 178 ?>