__construct()
addFetchOptionJoin()
addPositionLimit()
assertValidCutOffOperator()
create()
fetchAllKeyed()
getConditionsForClause()
getContentTypeField()
getContentTypesWithField()
getExistingSearch()
getGeneralConstraintsFromInput()
getModelFromCache()
getOrderByClause()
getSearchById()
getSearchContentTypes()
getSearchDataHandler()
getSearchDataHandlers()
getSearchQueryHash()
getSearchResultsForDisplay()
getViewableSearchResultData()
getViewableSearchResults()
groupSearchResultsByType()
insertSearch()
limitQueryResults()
prepareLimitFetchOptions()
prepareSearch()
prepareStateLimitFromConditions()
resetLocalCacheData()
setAllowCachedRead()
setLocalCacheData()
sliceSearchResultsToPage()
standardizeNodePermissionsAndUserId()
standardizePermissionCombinationIdAndUserId()
standardizePermissionsAndUserId()
standardizeViewingUserReference()
standardizeViewingUserReferenceForNode()
unserializePermissionsInList()
_decodeSearchTableData()
_getCache()
_getDataRegistryModel()
_getDb()
_getLocalCacheData()
$_allowCachedRead
$_cache
$_db
$_localCacheData
$_modelCache
CONTENT_ID
CONTENT_TYPE
Search model.
Models don't share that much, so most implementations will be adding methods onto this class. This class simply provides helper methods for common actions.
package | XenForo_Search |
---|
__construct()
Use create() statically unless you know what you're doing.
inherited_from | \XenForo_Model::__construct() |
---|
addFetchOptionJoin(array $fetchOptions, integer $join)
Join should be one of the constants.
inherited_from | \XenForo_Model::addFetchOptionJoin() |
---|
array
integer
addPositionLimit(string $table, integer $limit, integer $offset, string $column) : string
It no limit value is specified, nothing will be returned.
This must be added within a WHERE clause. If a clause is required, it will begin with "AND", so ensure there is a condition before it.
inherited_from | \XenForo_Model::addPositionLimit() |
---|
string
Name of the table alias to prefix. May be blank for no table reference.
integer
Number of records to limit to; ignored if <= 0
integer
Offset from the start of the records. 0+
string
Name of the column that is storing the position
string
Position limit clause if neededassertValidCutOffOperator(string $operator)
inherited_from | \XenForo_Model::assertValidCutOffOperator() |
---|
string
create(string $class) : \XenForo_Model
The class must exist or be autoloadable or an exception will be thrown.
inherited_from | \XenForo_Model::create() |
---|
string
Class to load
fetchAllKeyed(string $sql, string $key, mixed $bind, string $nullPrefix) : array
The 'key' parameter provides the column name with which to key the result. For example, calling fetchAllKeyed('SELECT item_id, title, date FROM table', 'item_id') would result in an array keyed by item_id: [$itemId] => array('item_id' => $itemId, 'title' => $title, 'date' => $date)
Note that the specified key must exist in the query result, or it will be ignored.
inherited_from | \XenForo_Model::fetchAllKeyed() |
---|
string
SQL to execute
string
Column with which to key the results array
mixed
Parameters for the SQL
string
If the key is null, prefix the counter with this
array
getConditionsForClause(array $sqlConditions) : string
This always returns a value that can be used in a clause such as WHERE.
inherited_from | \XenForo_Model::getConditionsForClause() |
---|
array
string
getContentTypeField(string $contentType, string $fieldName) : string | false
inherited_from | \XenForo_Model::getContentTypeField() |
---|
string
string
string
false
getContentTypesWithField(string $fieldName) : array
inherited_from | \XenForo_Model::getContentTypesWithField() |
---|
string
array
Format: [content type] => field valuegetExistingSearch(string $searchType, string $searchQuery, array $constraints, string $order, boolean $groupByDiscussion, integer $userId, boolean $forceUsage) : array | false
string
The type of the search (usually content type or blank, but could be general string)
string
Text being queried for
array
Search constraints
string
Search order
boolean
True if results should be folded up into their discussion (or other container)
integer
User ID doing the search
boolean
True to force the usage of the cache (in debug mode)
array
false
getGeneralConstraintsFromInput(array $input, mixed $errors) : array
array
mixed
Returns a list of errors that occurred when getting constraints
array
ConstraintsgetModelFromCache(string $class) : \XenForo_Model
If it does not exist, it will be instantiated.
inherited_from | \XenForo_Model::getModelFromCache() |
---|
string
Name of the class to load
getOrderByClause(array $choices, array $fetchOptions, string $defaultOrderSql) : string
inherited_from | \XenForo_Model::getOrderByClause() |
---|
array
array
string
string
Order by clause or empty stringgetSearchById(integer $searchId) : array | false
integer
array
false
getSearchContentTypes() : array
array
Format: [content type] => search_handler_classgetSearchDataHandler(string $contentType) : \XenForo_Search_DataHandler_Abstract | false
getSearchDataHandlers(array $handlerContentTypes) : array
array
List of content types
array
Format: [content type] => XenForo_Search_DataHandler_Abstract objectgetSearchQueryHash(string $searchType, string $searchQuery, array $constraints, string $order, boolean $groupByDiscussion) : string
string
The type of the search (usually content type or blank, but could be general string)
string
Text being queried for
array
Search constraints
string
Search order
boolean
True if results should be folded up into their discussion (or other container)
string
Query hashgetSearchResultsForDisplay(array $results, array $viewingUser) : array
The results (in the returned "results" key) have extra, type-specific data included with them.
array
Search results ([] => array(content type, content id)
array
null
Information about the viewing user (keys: user_id, permission_combination_id, permissions) or null for visitor
array
Keys: results, handlersgetViewableSearchResultData(array $resultsGrouped, array $handlers, boolean $prepareData, array $viewingUser) : array
If no data is returned, the result is not viewable and should be hidden.
array
Search results, grouped by type (see {@link groupSearchResultsByType()})
array
Search data handler objects for all necessary content types
boolean
True if the data should be prepared as well
array
null
Information about the viewing user (keys: user_id, permission_combination_id, permissions) or null for visitor
array
Result data grouped, format: [content type][content id] => datagetViewableSearchResults(array $results, array $viewingUser) : array
array
Search results ([] => array(content type, content id)
array
null
Information about the viewing user (keys: user_id, permission_combination_id, permissions) or null for visitor
array
Same as input results, but unviewable entries removedgroupSearchResultsByType(array $results) : array
array
Format: [] => array(content type, content id)
array
Format: [content type][content id] => content idinsertSearch(array $results, string $searchType, string $searchQuery, array $constraints, string $order, boolean $groupByDiscussion, array $userResults, array $warnings, integer | null $userId, integer | null $searchDate) : array
array
List of results, in format [] => array(content type, content id)
string
The type of the search (usually content type or blank, but could be general string)
string
Text that was queried for
array
Additional search constraints
string
Search sort order
boolean
True if results should be folded up into their discussion (or other container)
array
List of user IDs that matched the keyword search
array
Any search warnings that occurred
integer
null
User doing search
integer
null
Time of search or null for now
array
Search info, including search_idlimitQueryResults(string $query, integer $limit, integer $offset) : string
If the limit value is 0 or less, no clause is applied.
inherited_from | \XenForo_Model::limitQueryResults() |
---|
string
SQL query to run
integer
Number of records to limit to; ignored if <= 0
integer
Offset from the start of the records. 0+
string
Query with limit applied if necessaryprepareLimitFetchOptions(array $fetchOptions) : array
Includes: limit, offset, page, and perPage.
inherited_from | \XenForo_Model::prepareLimitFetchOptions() |
---|
array
Unprepared options
array
Limit options; keys: limit, offsetprepareSearch(array $search) : array
array
array
prepareStateLimitFromConditions(array $fetchOptions, string $table, string $stateField, string $userField) : string
Looks for keys "deleted" and "moderated".
inherited_from | \XenForo_Model::prepareStateLimitFromConditions() |
---|
array
string
Name of the table to prefix the state and user fields with
string
Name of the field that holds the state
string
Name of the field that holds the user ID
string
SQL condition to limit stateresetLocalCacheData($name)
This can be used if you know when some cached data has expired.
inherited_from | \XenForo_Model::resetLocalCacheData() |
---|
setAllowCachedRead($allowCachedRead)
This may be controllable on an individual level basis, if the implementation allows it.
inherited_from | \XenForo_Model::setAllowCachedRead() |
---|
boolean
setLocalCacheData(string $name, $value)
This should only be used if you know what you're doing or for testing purposes!
Note that you cannot get the existing data via the public interface. If you think you need the set data, use a new object. It defaults to empty. :)
inherited_from | \XenForo_Model::setLocalCacheData() |
---|
string
sliceSearchResultsToPage(array $search, integer $page, integer $perPage) : array
array
Search, containing search results
integer
integer
array
Results for the specified pagestandardizeNodePermissionsAndUserId(integer $nodeId, array | null $permissions, integer | null $userId)
If an invalid permission set or user ID is provided, the current visitor's will be used.
inherited_from | \XenForo_Model::standardizeNodePermissionsAndUserId() |
---|
integer
Node permissions are for
array
null
Permissions for node or null to use current visitor's permissions
integer
null
User permissions belong to or null to use current visitor
standardizePermissionCombinationIdAndUserId(integer | null $permissionCombinationId, integer | null $userId)
If null, users current visitor's values.
inherited_from | \XenForo_Model::standardizePermissionCombinationIdAndUserId() |
---|
integer
null
Permission combination ID or null to use current visitor
integer
null
User permissions belong to or null to use current visitor
standardizePermissionsAndUserId(array | null $permissions, integer | null $userId)
If an invalid permission set or user ID is provided, the current visitor's will be used.
inherited_from | \XenForo_Model::standardizePermissionsAndUserId() |
---|
array
null
Global pPermissions or null to use current visitor's permissions
integer
null
User permissions belong to or null to use current visitor
standardizeViewingUserReference(array $viewingUser)
This array must contain all basic user info (preferably all user info) and include global permissions in a "permissions" key. If not an array or missing a user_id, the visitor's values will be used.
inherited_from | \XenForo_Model::standardizeViewingUserReference() |
---|
array
null
standardizeViewingUserReferenceForNode(integer $nodeId, array $viewingUser, array $nodePermissions)
inherited_from | \XenForo_Model::standardizeViewingUserReferenceForNode() |
---|
integer
array
null
Viewing user; if null, use visitor
array
null
Permissions for this node; if null, use visitor's
unserializePermissionsInList(array $items, string $serializedKey, string $targetKey) : array
inherited_from | \XenForo_Model::unserializePermissionsInList() |
---|
array
List of items
string
Key where serialized permissions are
string
Key where unserialized permissions will go
array
List of items with permissions unserialized_decodeSearchTableData(string $data, $isSearchResults) : array
string
array
_getCache(boolean $forceCachedRead) : \Zend_Cache_Core | \Zend_Cache_Frontend | false
If cache reads are disabled, this will return false.
inherited_from | \XenForo_Model::_getCache() |
---|
boolean
If true, the global "allow cached read" value is ignored
\Zend_Cache_Core
\Zend_Cache_Frontend
false
_getDb() : \Zend_Db_Adapter_Abstract
inherited_from | \XenForo_Model::_getDb() |
---|
\Zend_Db_Adapter_Abstract
_getLocalCacheData(string $name) : mixed
inherited_from | \XenForo_Model::_getLocalCacheData() |
---|
string
mixed
$_allowCachedRead : boolean
If not, it should be retrieved from the source.
inherited_from | \XenForo_Model::$$_allowCachedRead |
---|
$_cache : \Zend_Cache_Core | \Zend_Cache_Frontend
inherited_from | \XenForo_Model::$$_cache |
---|
$_db : \Zend_Db_Adapter_Abstract
inherited_from | \XenForo_Model::$$_db |
---|
$_localCacheData : array
This data is generally treated as canonical, even if {$_allowCachedRead} is false.
inherited_from | \XenForo_Model::$$_localCacheData |
---|
$_modelCache : array
inherited_from | \XenForo_Model::$$_modelCache |
---|
CONTENT_ID
CONTENT_TYPE