OpenGuides::Search - Search form generation and processing for OpenGuides.
Does search stuff for OpenGuides. Distributed and installed as part of the OpenGuides project, not intended for independent installation. This documentation is probably only useful to OpenGuides developers.
use CGI; use OpenGuides::Config; use OpenGuides::Search; my $config = OpenGuides::Config->new( file => "wiki.conf" ); my $search = OpenGuides::Search->new( config => $config ); my %vars = CGI::Vars(); $search->run( vars => \%vars );
my $config = OpenGuides::Config->new( file => "wiki.conf" ); my $search = OpenGuides::Search->new( config => $config );
my $wiki = $search->wiki;
An accessor; returns the underlying CGI::Wiki object.
my $config = $search->config;
An accessor; returns the underlying OpenGuides::Config object.
my %vars = CGI::Vars(); $search->run( vars => \%vars, return_output => 1, # defaults to 0 return_tt_vars => 1, # defaults to 0 );
The return_output parameter is optional. If supplied and true, the stuff that would normally be printed to STDOUT will be returned as a string instead.
return_output
The return_tt_vars parameter is also optional. If supplied and true, the template is not processed and the variables that would have been passed to it are returned as a hash. This parameter takes precedence over return_output.
return_tt_vars
These two parameters exist to make testing easier; you probably don't want to use them in production.
a single word will be matched as-is. For example, a search on
escalator
will return all pages containing the word "escalator".
A list of words with no punctuation will be ANDed, for example:
restaurant vegetarian
will return all pages containing both the word "restaurant" and the word "vegetarian".
A list of words separated by commas (and optional spaces) will be ORed, for example:
restaurant, cafe
will return all pages containing either the word "restaurant" or the word "cafe".
Enclose phrases in double quotes, for example:
"meat pie"
will return all pages that contain the exact phrase "meat pie" - not pages that only contain, for example, "apple pie and meat sausage".
To perform a distance search, you need to supply one of the following sets of criteria to specify the distance to search within, and the origin (centre) of the search:
Only works if you chose to use British National Grid in wiki.conf
Only works if you chose to use Irish National Grid in wiki.conf
Should always work, but has a habit of "finding" things a couple of metres away from themselves.
You can perform both pure distance searches and distance searches in combination with text searches.
Results will be put into some form of relevance ordering. These are the rules we have tests for so far (and hence the only rules that can be relied on):
A match on page title will score higher than a match on page category or locale.
A match on page category or locale will score higher than a match on page content.
Two matches in the title beats one match in the title and one in the content.
The OpenGuides Project (openguides-dev@openguides.org)
Copyright (C) 2003-2004 The OpenGuides Project. All Rights Reserved.
The OpenGuides distribution is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
OpenGuides
To install OpenGuides, copy and paste the appropriate command in to your terminal.
cpanm
cpanm OpenGuides
CPAN shell
perl -MCPAN -e shell install OpenGuides
For more information on module installation, please visit the detailed CPAN module installation guide.