function _petreference_potential_references in Previewable email templates 6
Fetch an array of all candidate referenced pets.
This info is used in various places (allowed values, autocomplete results, input validation...). Some of them only need the nids, others nid + titles, others yet nid + titles + rendered row (for display in widgets). The array we return contains all the potentially needed information, and lets consumers use the parts they actually need.
Parameters
$field: The field description.
$string: Optional string to filter titles on (used by autocomplete).
$match: Operator to match filtered name against, can be any of: 'contains', 'equals', 'starts_with'
$ids: Optional pet ids to lookup (the $string and $match arguments will be ignored).
$limit: If non-zero, limit the size of the result set.
Return value
An array of valid pets in the form: array( nid => array( 'title' => The pet title, 'rendered' => The text to display in widgets (can be HTML) ), ... )
4 calls to _petreference_potential_references()
- petreference_allowed_values in modules/
petreference/ petreference.module - Implementation of hook_allowed_values().
- petreference_autocomplete in modules/
petreference/ petreference.module - Menu callback; Retrieve a pipe delimited string of autocomplete suggestions for existing users
- petreference_autocomplete_validate in modules/
petreference/ petreference.module - Validate an autocomplete element.
- petreference_field in modules/
petreference/ petreference.module - Implementation of hook_field().
File
- modules/
petreference/ petreference.module, line 738 - Defines a field type for referencing pet template to a node.
Code
function _petreference_potential_references($field, $string = '', $match = 'contains', $ids = array(), $limit = NULL) {
static $results = array();
// Create unique id for static cache.
$cid = $field['field_name'] . ':' . $match . ':' . ($string !== '' ? $string : implode('-', $ids)) . ':' . $limit;
if (!isset($results[$cid])) {
$references = FALSE;
if (module_exists('views') && !empty($field['advanced_view']) && $field['advanced_view'] != '--') {
$references = _petreference_potential_references_views($field, $string, $match, $ids, $limit);
}
// If the view doesn't exist, we got FALSE, and fallback to the regular 'standard mode'.
if ($references === FALSE) {
$references = _petreference_potential_references_standard($field, $string, $match, $ids, $limit);
}
// Store the results.
$results[$cid] = !empty($references) ? $references : array();
}
return $results[$cid];
}