CWIS Developer Documentation
Public Member Functions | Static Public Member Functions | Public Attributes | List of all members
SavedSearch Class Reference

Public Member Functions

 __construct ($SearchId, $SearchName=NULL, $UserId=NULL, $Frequency=NULL, $SearchParameters=NULL)
 Object constructor. More...
 
 SearchGroups ($NewSearchGroups=NULL)
 Get/set search parameters from legacy array. More...
 
 SearchParameters ($NewParams=NULL)
 Get/set search parameters. More...
 
 SearchName ($NewValue=DB_NOVALUE)
 Get/set name of search. More...
 
 Id ()
 Get ID of search. More...
 
 UserId ($NewValue=DB_NOVALUE)
 Get/set user ID. More...
 
 Frequency ($NewValue=DB_NOVALUE)
 Get/set search frequency. More...
 
 UpdateDateLastRun ()
 Update date this search was last run. More...
 
 DateLastRun ($NewValue=DB_NOVALUE)
 Get/set the date this search was last run. More...
 
 SaveLastMatches ($ArrayofMatchingIds)
 Save array of last matches. More...
 
 LastMatches ()
 Return array of most recently matched ResourceIds for a search. More...
 
 GetSearchGroupsAsUrlParameters ()
 Get search groups as URL parameters (e.g. More...
 
 GetSearchGroupsAsUrlParameterArray ()
 Get search groups as an URL parameter array. More...
 
 GetSearchGroupsAsTextDescription ($IncludeHtml=TRUE, $StartWithBreak=TRUE, $TruncateLongWordsTo=0)
 Get multi-line string describing search criteria. More...
 
 GetSearchFieldNames ()
 Get list of fields to be searched. More...
 
 Delete ()
 Delete saved search. More...
 
 GetSearchId ()
 Get search id. More...
 

Static Public Member Functions

static TranslateSearchGroupsToUrlParameters ($SearchGroups)
 Translate search group array into URL parameters (e.g. More...
 
static TranslateSearchGroupsToUrlParameterArray ($SearchGroups)
 Translate a search group array to an URL parameter array. More...
 
static TranslateUrlParametersToSearchGroups ($GetVars)
 Translate URL parameters to legacy search group array. More...
 
static TranslateSearchGroupsToTextDescription ($SearchGroups, $IncludeHtml=TRUE, $StartWithBreak=TRUE, $TruncateLongWordsTo=0)
 Translate search group array into multi-line string describing search criteria. More...
 
static TranslateSearchGroupsToSearchFieldNames ($SearchGroups)
 Extract list of fields to be searched from search group array. More...
 
static GetSearchFrequencyList ()
 Get array of possible search frequency descriptions. More...
 

Public Attributes

const SEARCHFREQ_NEVER = 0
 
const SEARCHFREQ_HOURLY = 1
 
const SEARCHFREQ_DAILY = 2
 
const SEARCHFREQ_WEEKLY = 3
 
const SEARCHFREQ_BIWEEKLY = 4
 
const SEARCHFREQ_MONTHLY = 5
 
const SEARCHFREQ_QUARTERLY = 6
 
const SEARCHFREQ_YEARLY = 7
 

Detailed Description

Definition at line 10 of file SavedSearch.php.

Constructor & Destructor Documentation

SavedSearch::__construct (   $SearchId,
  $SearchName = NULL,
  $UserId = NULL,
  $Frequency = NULL,
  $SearchParameters = NULL 
)

Object constructor.

Parameters
int | null$SearchIdSaved search ID or NULL for new search
string | null$SearchNameUpdated search name (OPTIONAL)
int | null$UserIdUser who owns this search (OPTIONAL)
int | null$FrequencySearch mailing frequency (OPTIONAL)
mixed$SearchParametersSearchParameterSet describing this search (OPTIONAL)

Definition at line 34 of file SavedSearch.php.

References Frequency(), SaveLastMatches(), SearchName(), SearchParameters(), and UserId().

Member Function Documentation

SavedSearch::DateLastRun (   $NewValue = DB_NOVALUE)

Get/set the date this search was last run.

Parameters
mixed$NewValueUpdated value (OPTIONAL
Returns
current value

Definition at line 241 of file SavedSearch.php.

SavedSearch::Delete ( )

Delete saved search.

(NOTE: Object is no longer usable after this call!)

Definition at line 818 of file SavedSearch.php.

References MetadataSchema\MDFTYPE_FLAG, MetadataSchema\MDFTYPE_NUMBER, MetadataSchema\MDFTYPE_OPTION, and MetadataSchema\MDFTYPE_USER.

SavedSearch::Frequency (   $NewValue = DB_NOVALUE)

Get/set search frequency.

Parameters
int$NewValueNew search frequency value.
Returns
Current search frequency value.

Definition at line 220 of file SavedSearch.php.

Referenced by __construct().

Here is the caller graph for this function:

SavedSearch::GetSearchFieldNames ( )

Get list of fields to be searched.

Returns
Array of field names.

Definition at line 754 of file SavedSearch.php.

References SearchParameters().

static SavedSearch::GetSearchFrequencyList ( )
static

Get array of possible search frequency descriptions.

Frequencies may be excluded from list by supplying them as arguments.

Returns
Array of search frequency descriptions indexed by SEARCHFREQ constants.

Definition at line 789 of file SavedSearch.php.

SavedSearch::GetSearchGroupsAsTextDescription (   $IncludeHtml = TRUE,
  $StartWithBreak = TRUE,
  $TruncateLongWordsTo = 0 
)

Get multi-line string describing search criteria.

Parameters
bool$IncludeHtmlWhether to include HTML tags for formatting. (OPTIONAL, defaults to TRUE)
bool$StartWithBreakWhether to start string with BR tag. (OPTIONAL, defaults to TRUE)
int$TruncateLongWordsToNumber of characters to truncate long words to (use 0 for no truncation). (OPTIONAL, defaults to 0)
Returns
String containing text describing search criteria.

Definition at line 573 of file SavedSearch.php.

References SearchParameters().

SavedSearch::GetSearchGroupsAsUrlParameterArray ( )

Get search groups as an URL parameter array.

Returns
Array with strings like "F4" ("F" or "G" plus field ID) for the index and * "american+history" (search parameter) for the values.

Definition at line 395 of file SavedSearch.php.

References SearchGroups().

SavedSearch::GetSearchGroupsAsUrlParameters ( )

Get search groups as URL parameters (e.g.

something like F2=madison&F4=american+history&G22=17-41).

Returns
String containing URL parameters (no leading "?").

Definition at line 271 of file SavedSearch.php.

References SearchGroups().

SavedSearch::GetSearchId ( )

Get search id.

Returns
SearchId
Deprecated:

Definition at line 1028 of file SavedSearch.php.

References Id().

SavedSearch::Id ( )

Get ID of search.

Returns
Search ID.

Definition at line 200 of file SavedSearch.php.

Referenced by GetSearchId().

Here is the caller graph for this function:

SavedSearch::LastMatches ( )

Return array of most recently matched ResourceIds for a search.

Returns
Array of Resource Ids for most recent run of a search

Definition at line 260 of file SavedSearch.php.

SavedSearch::SaveLastMatches (   $ArrayofMatchingIds)

Save array of last matches.

Parameters
array$ArrayofMatchingIdsMatching Ids for a current search.

Definition at line 250 of file SavedSearch.php.

Referenced by __construct().

Here is the caller graph for this function:

SavedSearch::SearchGroups (   $NewSearchGroups = NULL)

Get/set search parameters from legacy array.

This function is for backward compatibility only and should not be used in new code.

Parameters
array | null$NewSearchGroupsUpdated legacy array
Returns
current search params as legacy array
Deprecated:

Definition at line 144 of file SavedSearch.php.

References SearchParameters().

Referenced by GetSearchGroupsAsUrlParameterArray(), and GetSearchGroupsAsUrlParameters().

Here is the caller graph for this function:

SavedSearch::SearchName (   $NewValue = DB_NOVALUE)

Get/set name of search.

Parameters
string$NewValueNew name of search value.
Returns
Current name of search value.

Definition at line 191 of file SavedSearch.php.

Referenced by __construct().

Here is the caller graph for this function:

SavedSearch::SearchParameters (   $NewParams = NULL)

Get/set search parameters.

Parameters
SearchParameterSet | null$NewParamsUpdated search parameters
Returns
current search parameters

Definition at line 162 of file SavedSearch.php.

Referenced by __construct(), GetSearchFieldNames(), GetSearchGroupsAsTextDescription(), and SearchGroups().

Here is the caller graph for this function:

static SavedSearch::TranslateSearchGroupsToSearchFieldNames (   $SearchGroups)
static

Extract list of fields to be searched from search group array.

Parameters
array$SearchGroupsSearch group array.
Returns
Array of field names.

Definition at line 764 of file SavedSearch.php.

static SavedSearch::TranslateSearchGroupsToTextDescription (   $SearchGroups,
  $IncludeHtml = TRUE,
  $StartWithBreak = TRUE,
  $TruncateLongWordsTo = 0 
)
static

Translate search group array into multi-line string describing search criteria.

Parameters
array$SearchGroupsSearch group array.
bool$IncludeHtmlWhether to include HTML tags for formatting. (OPTIONAL, defaults to TRUE)
bool$StartWithBreakWhether to start string with BR tag. (OPTIONAL, defaults to TRUE)
int$TruncateLongWordsToNumber of characters to truncate long words to (use 0 for no truncation). (OPTIONAL, defaults to 0)
Returns
String containing text describing search criteria.

Definition at line 591 of file SavedSearch.php.

References SearchEngine\LOGIC_AND, and StdLib\NeatlyTruncateString().

static SavedSearch::TranslateSearchGroupsToUrlParameterArray (   $SearchGroups)
static

Translate a search group array to an URL parameter array.

Parameters
array$SearchGroupsSearch group array to translate.
Returns
Array with strings like "F4" ("F" or "G" plus field ID) for the index and * "american+history" (search parameter) for the values.

Definition at line 406 of file SavedSearch.php.

References SearchEngine\LOGIC_AND.

static SavedSearch::TranslateSearchGroupsToUrlParameters (   $SearchGroups)
static

Translate search group array into URL parameters (e.g.

something like F2=madison&F4=american+history&G22=17-41). A search group array looks something like this:

$SearchGroups = array(
"MAIN" => array(
"SearchStrings" => array(
"XXXKeywordXXX" => "some words for keyword search",
"Title" => "some words we are looking for in titles",
),
),
"23" => array(
"SearchStrings" => array(
"Resource Type" => array(
"=Event",
"=Image",
),
),
),
"25" => array(
"SearchStrings" => array(
"Audience" => array(
"=Grades 10-12",
),
),
),
);

where "23" and "25" are the field IDs and "Resource Type" and "Audience" are the corresponding field names.

Parameters
array$SearchGroupsSearch group array.
Returns
String containing URL parameters (no leading "?").

Definition at line 313 of file SavedSearch.php.

static SavedSearch::TranslateUrlParametersToSearchGroups (   $GetVars)
static

Translate URL parameters to legacy search group array.

Parameters
array$GetVarsGet variables (as from $_GET)
Returns
array Legacy search group array

Definition at line 487 of file SavedSearch.php.

References SearchEngine\LOGIC_AND, and SearchEngine\LOGIC_OR.

SavedSearch::UpdateDateLastRun ( )

Update date this search was last run.

Definition at line 229 of file SavedSearch.php.

SavedSearch::UserId (   $NewValue = DB_NOVALUE)

Get/set user ID.

Parameters
int$NewValueNew user ID value.
Returns
Current user ID value.

Definition at line 210 of file SavedSearch.php.

Referenced by __construct().

Here is the caller graph for this function:

Member Data Documentation

const SavedSearch::SEARCHFREQ_BIWEEKLY = 4

Definition at line 20 of file SavedSearch.php.

Referenced by SavedSearchFactory\GetSearchesDueToRun().

const SavedSearch::SEARCHFREQ_DAILY = 2

Definition at line 18 of file SavedSearch.php.

Referenced by SavedSearchFactory\GetSearchesDueToRun().

const SavedSearch::SEARCHFREQ_HOURLY = 1

Definition at line 17 of file SavedSearch.php.

Referenced by SavedSearchFactory\GetSearchesDueToRun().

const SavedSearch::SEARCHFREQ_MONTHLY = 5

Definition at line 21 of file SavedSearch.php.

Referenced by SavedSearchFactory\GetSearchesDueToRun().

const SavedSearch::SEARCHFREQ_NEVER = 0

Definition at line 16 of file SavedSearch.php.

const SavedSearch::SEARCHFREQ_QUARTERLY = 6

Definition at line 22 of file SavedSearch.php.

Referenced by SavedSearchFactory\GetSearchesDueToRun().

const SavedSearch::SEARCHFREQ_WEEKLY = 3

Definition at line 19 of file SavedSearch.php.

Referenced by SavedSearchFactory\GetSearchesDueToRun().

const SavedSearch::SEARCHFREQ_YEARLY = 7

Definition at line 23 of file SavedSearch.php.

Referenced by SavedSearchFactory\GetSearchesDueToRun().


The documentation for this class was generated from the following file: