Functions:pageCustomSearchGroup

Description

Retrieves data associated with a particular Custom Search Group

Syntax

$csArr = eV::pageCustomSearchGroup($groupIdOrName);

Paramaters

• $groupIdOrName INT or STRING

the groupId as set by the system when creating the group or the exact name of the group (cap sensitive). Note: using the group name is not recommended as changes to the group name by content managers would disable the call to the group within the page template.

Return Values

Returns associative array of group information. Returns Boolean FALSE if no matching group is found. The array is as follows:

Array
(
    [groupName] => STRING
    [groupNotes] => STRING
    [groupId] => INT
    [selectField] => STRING
    [options] => Array
        (
            [optionId] => INT
            [optionName] => STRING
            [link] => STRING
            
        )
)

Elements from the custom search group associative array are as follows:

Examples

Using the selectField option. Using the groupId in the calling function

// call your group at the beginning of your script
$groupArr = eV:pageCustomSearchGroup(45);
 
//output your field
//first display the group name (which should describe to the visitor what the field is for)
// than output the select field
echo $groupArr['groupName'] . "<br>" . $groupArr['selectField'];

Using the options Array. Using the groupName in the calling function

// call your group at the beginning of your script
//NOTE: it is not recommended to use the group name in this function as changes to group name by content managers will disable this call
$groupArr = eV:pageCustomSearchGroup('Select a Category');
 
//output information about the group and open the list
echo $groupArr['groupName'] . "<br>" . $groupArr['groupNotes'] . "<ul>";
// build a series of links to jump to the group
foreach($groupArr['options'] as $option) echo "<li><a href=\"" . $option['link'] . "\">" . $option['optionName'] . "</a>";
//close the list
echo "</ul>";