NAME

       WWW::Search::Jobserve - backend for searching www.jobserve.com

SYNOPSIS

           use WWW::Search;
           my $oSearch = new WWW::Search('Jobserve');
           my $sQuery = WWW::Search::escape_query("(Fast Food Operative) and PERL");
           $oSearch->native_query($sQuery, { job_category => 'it' });
           while (my $oResult = $oSearch->next_result())
             {
               print $oResult->url, "\n";
               print $oResult->title, "\n";
               print $oResult->description, "\n";
             }

DESCRIPTION

       This class is a Jobserve specialisation of WWW::Search.  It handles making, retrieving and interpreting
       Jobserve searches http://www.jobserve.com.

       This class exports no public interface; all interaction should be done through WWW::Search objects.

NOTES

       This class can be used to query both the UK and Australian Jobserve sites, see below.

       The search will terminate unless "job_category" is set in the native_query options.

       The results are ordered Best Match first
          (unless 'job_order' => 'DateTime' is specified).

OPTIONS

       Parameters Available:

       job_category job_type job_lookahead job_order jobserve_site

       Job Category
           Job Categories must be specified by setting "job_category" in the native_query options:

             $oSearch->native_query($sQuery, { job_category => 'it' });

           The  value  of  this  is  simply  the prefix you see jobserve insert into the url once you've clicked
           beyond the front page. E.g.

             http://www.it.jobserve.com            { job_category => 'it' }
             http://www.engineering.jobserve.com   { job_category => 'engineering' }

           etc.

       Job Type
           Job Types are (Any|Contract|Permanent).  To specifically search for one contract type, set 'job_type'
           => (*|C|P) to the query options:

             $oSearch->native_query($sQuery, { job_type => 'C',  job_category => 'it' } );

           The search defaults to "All"

       Days Ahead
           Choices of how many days to look ahead are (5|4|3|2|1|0).  To specifically search for x working  days
           ahead, set 'job_lookahead' => (5|4|3|2|1|0) to the query options:

             $oSearch->native_query($sQuery, { job_lookahead => '2', job_category => 'it' } );

           The search defaults to 5

       Result Order
           Choices  of  how  to  order  results  are  (Best  Match|Latest  Job).  To alter the result order, set
           'job_order' => (Rank|DateTime) to the query options:

             $oSearch->native_query($sQuery, { job_order => 'DateTime', job_category => 'it' } );

           The search defaults to "Best Match".

       Different Jobserve Sites
           There are currently two Jobserve  websites  supported  by  this  module  namely  United  Kingdom  and
           Australia.
             The  search  will default to the UK site unless the parameter, 'jobserve_site' => (uk|au) is set in
           the query options:

             $oSearch->native_query($sQuery, { jobserve_site => 'au', job_category => 'it' } );

           The search defaults to "uk"

       Invocation
           Invoke all parameters like so:

               $oSearch->native_query($sQuery, { job_category  => 'it',
                                                 job_type      => 'C',
                                                 job_lookahead => '2',
                                                 job_order     => 'DateTime',
                                                 jobserve_site => 'au', } );

SEE ALSO

       To make new back-ends, see WWW::Search.

BUGS

       Doubt it. Please tell me if you find any! Better still have a go at fixing them.

AUTHOR

       "WWW::Search::Jobserve" was written by Andy Pritchard (pilchkinstein@hotmail.com).

       "WWW::Search::Jobserve" is maintained by Andy Pritchard

LEGALESE

       THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY  EXPRESS  OR  IMPLIED  WARRANTIES,  INCLUDING,  WITHOUT
       LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

VERSION HISTORY

   1.02
       Altered parse_tree for cases where another href link is inserted before the job title and link

   1.01
       Altered POD and added a README

   1.00
       Released to the public.

perl v5.30.3                                       2020-09-10                         WWW::Search::Jobserve(3pm)