danielebarchiesi@0: <?php
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * @file
danielebarchiesi@0:  * Hooks provided by the Search module.
danielebarchiesi@0:  */
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * @addtogroup hooks
danielebarchiesi@0:  * @{
danielebarchiesi@0:  */
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Define a custom search type.
danielebarchiesi@0:  *
danielebarchiesi@0:  * This hook allows a module to tell search.module that it wishes to perform
danielebarchiesi@0:  * searches on content it defines (custom node types, users, or comments for
danielebarchiesi@0:  * example) when a site search is performed.
danielebarchiesi@0:  *
danielebarchiesi@0:  * In order for the search to do anything, your module must also implement
danielebarchiesi@0:  * hook_search_execute(), which is called when someone requests a search
danielebarchiesi@0:  * on your module's type of content. If you want to have your content
danielebarchiesi@0:  * indexed in the standard search index, your module should also implement
danielebarchiesi@0:  * hook_update_index(). If your search type has settings, you can implement
danielebarchiesi@0:  * hook_search_admin() to add them to the search settings page. You can use
danielebarchiesi@0:  * hook_form_FORM_ID_alter(), with FORM_ID set to 'search_form', to add fields
danielebarchiesi@0:  * to the search form (see node_form_search_form_alter() for an example).
danielebarchiesi@0:  * You can use hook_search_access() to limit access to searching,
danielebarchiesi@0:  * and hook_search_page() to override how search results are displayed.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @return
danielebarchiesi@0:  *   Array with optional keys:
danielebarchiesi@0:  *   - title: Title for the tab on the search page for this module. Defaults
danielebarchiesi@0:  *     to the module name if not given.
danielebarchiesi@0:  *   - path: Path component after 'search/' for searching with this module.
danielebarchiesi@0:  *     Defaults to the module name if not given.
danielebarchiesi@0:  *   - conditions_callback: An implementation of callback_search_conditions().
danielebarchiesi@0:  *
danielebarchiesi@0:  * @ingroup search
danielebarchiesi@0:  */
danielebarchiesi@0: function hook_search_info() {
danielebarchiesi@0:   return array(
danielebarchiesi@0:     'title' => 'Content',
danielebarchiesi@0:     'path' => 'node',
danielebarchiesi@0:     'conditions_callback' => 'callback_search_conditions',
danielebarchiesi@0:   );
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Define access to a custom search routine.
danielebarchiesi@0:  *
danielebarchiesi@0:  * This hook allows a module to define permissions for a search tab.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @ingroup search
danielebarchiesi@0:  */
danielebarchiesi@0: function hook_search_access() {
danielebarchiesi@0:   return user_access('access content');
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Take action when the search index is going to be rebuilt.
danielebarchiesi@0:  *
danielebarchiesi@0:  * Modules that use hook_update_index() should update their indexing
danielebarchiesi@0:  * bookkeeping so that it starts from scratch the next time
danielebarchiesi@0:  * hook_update_index() is called.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @ingroup search
danielebarchiesi@0:  */
danielebarchiesi@0: function hook_search_reset() {
danielebarchiesi@0:   db_update('search_dataset')
danielebarchiesi@0:     ->fields(array('reindex' => REQUEST_TIME))
danielebarchiesi@0:     ->condition('type', 'node')
danielebarchiesi@0:     ->execute();
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Report the status of indexing.
danielebarchiesi@0:  *
danielebarchiesi@0:  * The core search module only invokes this hook on active modules.
danielebarchiesi@0:  * Implementing modules do not need to check whether they are active when
danielebarchiesi@0:  * calculating their return values.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @return
danielebarchiesi@0:  *  An associative array with the key-value pairs:
danielebarchiesi@0:  *  - 'remaining': The number of items left to index.
danielebarchiesi@0:  *  - 'total': The total number of items to index.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @ingroup search
danielebarchiesi@0:  */
danielebarchiesi@0: function hook_search_status() {
danielebarchiesi@0:   $total = db_query('SELECT COUNT(*) FROM {node} WHERE status = 1')->fetchField();
danielebarchiesi@0:   $remaining = db_query("SELECT COUNT(*) FROM {node} n LEFT JOIN {search_dataset} d ON d.type = 'node' AND d.sid = n.nid WHERE n.status = 1 AND d.sid IS NULL OR d.reindex <> 0")->fetchField();
danielebarchiesi@0:   return array('remaining' => $remaining, 'total' => $total);
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Add elements to the search settings form.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @return
danielebarchiesi@0:  *   Form array for the Search settings page at admin/config/search/settings.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @ingroup search
danielebarchiesi@0:  */
danielebarchiesi@0: function hook_search_admin() {
danielebarchiesi@0:   // Output form for defining rank factor weights.
danielebarchiesi@0:   $form['content_ranking'] = array(
danielebarchiesi@0:     '#type' => 'fieldset',
danielebarchiesi@0:     '#title' => t('Content ranking'),
danielebarchiesi@0:   );
danielebarchiesi@0:   $form['content_ranking']['#theme'] = 'node_search_admin';
danielebarchiesi@0:   $form['content_ranking']['info'] = array(
danielebarchiesi@0:     '#value' => '<em>' . t('The following numbers control which properties the content search should favor when ordering the results. Higher numbers mean more influence, zero means the property is ignored. Changing these numbers does not require the search index to be rebuilt. Changes take effect immediately.') . '</em>'
danielebarchiesi@0:   );
danielebarchiesi@0: 
danielebarchiesi@0:   // Note: reversed to reflect that higher number = higher ranking.
danielebarchiesi@0:   $options = drupal_map_assoc(range(0, 10));
danielebarchiesi@0:   foreach (module_invoke_all('ranking') as $var => $values) {
danielebarchiesi@0:     $form['content_ranking']['factors']['node_rank_' . $var] = array(
danielebarchiesi@0:       '#title' => $values['title'],
danielebarchiesi@0:       '#type' => 'select',
danielebarchiesi@0:       '#options' => $options,
danielebarchiesi@0:       '#default_value' => variable_get('node_rank_' . $var, 0),
danielebarchiesi@0:     );
danielebarchiesi@0:   }
danielebarchiesi@0:   return $form;
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Execute a search for a set of key words.
danielebarchiesi@0:  *
danielebarchiesi@0:  * Use database API with the 'PagerDefault' query extension to perform your
danielebarchiesi@0:  * search.
danielebarchiesi@0:  *
danielebarchiesi@0:  * If your module uses hook_update_index() and search_index() to index its
danielebarchiesi@0:  * items, use table 'search_index' aliased to 'i' as the main table in your
danielebarchiesi@0:  * query, with the 'SearchQuery' extension. You can join to your module's table
danielebarchiesi@0:  * using the 'i.sid' field, which will contain the $sid values you provided to
danielebarchiesi@0:  * search_index(). Add the main keywords to the query by using method
danielebarchiesi@0:  * searchExpression(). The functions search_expression_extract() and
danielebarchiesi@0:  * search_expression_insert() may also be helpful for adding custom search
danielebarchiesi@0:  * parameters to the search expression.
danielebarchiesi@0:  *
danielebarchiesi@0:  * See node_search_execute() for an example of a module that uses the search
danielebarchiesi@0:  * index, and user_search_execute() for an example that doesn't use the search
danielebarchiesi@0:  * index.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @param $keys
danielebarchiesi@0:  *   The search keywords as entered by the user.
danielebarchiesi@0:  * @param $conditions
danielebarchiesi@0:  *   An optional array of additional conditions, such as filters.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @return
danielebarchiesi@0:  *   An array of search results. To use the default search result
danielebarchiesi@0:  *   display, each item should have the following keys':
danielebarchiesi@0:  *   - 'link': Required. The URL of the found item.
danielebarchiesi@0:  *   - 'type': The type of item (such as the content type).
danielebarchiesi@0:  *   - 'title': Required. The name of the item.
danielebarchiesi@0:  *   - 'user': The author of the item.
danielebarchiesi@0:  *   - 'date': A timestamp when the item was last modified.
danielebarchiesi@0:  *   - 'extra': An array of optional extra information items.
danielebarchiesi@0:  *   - 'snippet': An excerpt or preview to show with the result (can be
danielebarchiesi@0:  *     generated with search_excerpt()).
danielebarchiesi@0:  *   - 'language': Language code for the item (usually two characters).
danielebarchiesi@0:  *
danielebarchiesi@0:  * @ingroup search
danielebarchiesi@0:  */
danielebarchiesi@0: function hook_search_execute($keys = NULL, $conditions = NULL) {
danielebarchiesi@0:   // Build matching conditions
danielebarchiesi@0:   $query = db_select('search_index', 'i', array('target' => 'slave'))->extend('SearchQuery')->extend('PagerDefault');
danielebarchiesi@0:   $query->join('node', 'n', 'n.nid = i.sid');
danielebarchiesi@0:   $query
danielebarchiesi@0:     ->condition('n.status', 1)
danielebarchiesi@0:     ->addTag('node_access')
danielebarchiesi@0:     ->searchExpression($keys, 'node');
danielebarchiesi@0: 
danielebarchiesi@0:   // Insert special keywords.
danielebarchiesi@0:   $query->setOption('type', 'n.type');
danielebarchiesi@0:   $query->setOption('language', 'n.language');
danielebarchiesi@0:   if ($query->setOption('term', 'ti.tid')) {
danielebarchiesi@0:     $query->join('taxonomy_index', 'ti', 'n.nid = ti.nid');
danielebarchiesi@0:   }
danielebarchiesi@0:   // Only continue if the first pass query matches.
danielebarchiesi@0:   if (!$query->executeFirstPass()) {
danielebarchiesi@0:     return array();
danielebarchiesi@0:   }
danielebarchiesi@0: 
danielebarchiesi@0:   // Add the ranking expressions.
danielebarchiesi@0:   _node_rankings($query);
danielebarchiesi@0: 
danielebarchiesi@0:   // Load results.
danielebarchiesi@0:   $find = $query
danielebarchiesi@0:     ->limit(10)
danielebarchiesi@0:     ->execute();
danielebarchiesi@0:   $results = array();
danielebarchiesi@0:   foreach ($find as $item) {
danielebarchiesi@0:     // Build the node body.
danielebarchiesi@0:     $node = node_load($item->sid);
danielebarchiesi@0:     node_build_content($node, 'search_result');
danielebarchiesi@0:     $node->body = drupal_render($node->content);
danielebarchiesi@0: 
danielebarchiesi@0:     // Fetch comments for snippet.
danielebarchiesi@0:     $node->rendered .= ' ' . module_invoke('comment', 'node_update_index', $node);
danielebarchiesi@0:     // Fetch terms for snippet.
danielebarchiesi@0:     $node->rendered .= ' ' . module_invoke('taxonomy', 'node_update_index', $node);
danielebarchiesi@0: 
danielebarchiesi@0:     $extra = module_invoke_all('node_search_result', $node);
danielebarchiesi@0: 
danielebarchiesi@0:     $results[] = array(
danielebarchiesi@0:       'link' => url('node/' . $item->sid, array('absolute' => TRUE)),
danielebarchiesi@0:       'type' => check_plain(node_type_get_name($node)),
danielebarchiesi@0:       'title' => $node->title,
danielebarchiesi@0:       'user' => theme('username', array('account' => $node)),
danielebarchiesi@0:       'date' => $node->changed,
danielebarchiesi@0:       'node' => $node,
danielebarchiesi@0:       'extra' => $extra,
danielebarchiesi@0:       'score' => $item->calculated_score,
danielebarchiesi@0:       'snippet' => search_excerpt($keys, $node->body),
danielebarchiesi@0:     );
danielebarchiesi@0:   }
danielebarchiesi@0:   return $results;
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Override the rendering of search results.
danielebarchiesi@0:  *
danielebarchiesi@0:  * A module that implements hook_search_info() to define a type of search may
danielebarchiesi@0:  * implement this hook in order to override the default theming of its search
danielebarchiesi@0:  * results, which is otherwise themed using theme('search_results').
danielebarchiesi@0:  *
danielebarchiesi@0:  * Note that by default, theme('search_results') and theme('search_result')
danielebarchiesi@0:  * work together to create an ordered list (OL). So your hook_search_page()
danielebarchiesi@0:  * implementation should probably do this as well.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @param $results
danielebarchiesi@0:  *   An array of search results.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @return
danielebarchiesi@0:  *   A renderable array, which will render the formatted search results with a
danielebarchiesi@0:  *   pager included.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @see search-result.tpl.php
danielebarchiesi@0:  * @see search-results.tpl.php
danielebarchiesi@0:  */
danielebarchiesi@0: function hook_search_page($results) {
danielebarchiesi@0:   $output['prefix']['#markup'] = '<ol class="search-results">';
danielebarchiesi@0: 
danielebarchiesi@0:   foreach ($results as $entry) {
danielebarchiesi@0:     $output[] = array(
danielebarchiesi@0:       '#theme' => 'search_result',
danielebarchiesi@0:       '#result' => $entry,
danielebarchiesi@0:       '#module' => 'my_module_name',
danielebarchiesi@0:     );
danielebarchiesi@0:   }
danielebarchiesi@0:   $output['suffix']['#markup'] = '</ol>' . theme('pager');
danielebarchiesi@0: 
danielebarchiesi@0:   return $output;
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Preprocess text for search.
danielebarchiesi@0:  *
danielebarchiesi@0:  * This hook is called to preprocess both the text added to the search index and
danielebarchiesi@0:  * the keywords users have submitted for searching.
danielebarchiesi@0:  *
danielebarchiesi@0:  * Possible uses:
danielebarchiesi@0:  * - Adding spaces between words of Chinese or Japanese text.
danielebarchiesi@0:  * - Stemming words down to their root words to allow matches between, for
danielebarchiesi@0:  *   instance, walk, walked, walking, and walks in searching.
danielebarchiesi@0:  * - Expanding abbreviations and acronymns that occur in text.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @param $text
danielebarchiesi@0:  *   The text to preprocess. This is a single piece of plain text extracted
danielebarchiesi@0:  *   from between two HTML tags or from the search query. It will not contain
danielebarchiesi@0:  *   any HTML entities or HTML tags.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @return
danielebarchiesi@0:  *   The text after preprocessing. Note that if your module decides not to alter
danielebarchiesi@0:  *   the text, it should return the original text. Also, after preprocessing,
danielebarchiesi@0:  *   words in the text should be separated by a space.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @ingroup search
danielebarchiesi@0:  */
danielebarchiesi@0: function hook_search_preprocess($text) {
danielebarchiesi@0:   // Do processing on $text
danielebarchiesi@0:   return $text;
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Update the search index for this module.
danielebarchiesi@0:  *
danielebarchiesi@0:  * This hook is called every cron run if search.module is enabled, your
danielebarchiesi@0:  * module has implemented hook_search_info(), and your module has been set as
danielebarchiesi@0:  * an active search module on the Search settings page
danielebarchiesi@0:  * (admin/config/search/settings). It allows your module to add items to the
danielebarchiesi@0:  * built-in search index using search_index(), or to add them to your module's
danielebarchiesi@0:  * own indexing mechanism.
danielebarchiesi@0:  *
danielebarchiesi@0:  * When implementing this hook, your module should index content items that
danielebarchiesi@0:  * were modified or added since the last run. PHP has a time limit
danielebarchiesi@0:  * for cron, though, so it is advisable to limit how many items you index
danielebarchiesi@0:  * per run using variable_get('search_cron_limit') (see example below). Also,
danielebarchiesi@0:  * since the cron run could time out and abort in the middle of your run, you
danielebarchiesi@0:  * should update your module's internal bookkeeping on when items have last
danielebarchiesi@0:  * been indexed as you go rather than waiting to the end of indexing.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @ingroup search
danielebarchiesi@0:  */
danielebarchiesi@0: function hook_update_index() {
danielebarchiesi@0:   $limit = (int)variable_get('search_cron_limit', 100);
danielebarchiesi@0: 
danielebarchiesi@0:   $result = db_query_range("SELECT n.nid FROM {node} n LEFT JOIN {search_dataset} d ON d.type = 'node' AND d.sid = n.nid WHERE d.sid IS NULL OR d.reindex <> 0 ORDER BY d.reindex ASC, n.nid ASC", 0, $limit);
danielebarchiesi@0: 
danielebarchiesi@0:   foreach ($result as $node) {
danielebarchiesi@0:     $node = node_load($node->nid);
danielebarchiesi@0: 
danielebarchiesi@0:     // Save the changed time of the most recent indexed node, for the search
danielebarchiesi@0:     // results half-life calculation.
danielebarchiesi@0:     variable_set('node_cron_last', $node->changed);
danielebarchiesi@0: 
danielebarchiesi@0:     // Render the node.
danielebarchiesi@0:     node_build_content($node, 'search_index');
danielebarchiesi@0:     $node->rendered = drupal_render($node->content);
danielebarchiesi@0: 
danielebarchiesi@0:     $text = '<h1>' . check_plain($node->title) . '</h1>' . $node->rendered;
danielebarchiesi@0: 
danielebarchiesi@0:     // Fetch extra data normally not visible
danielebarchiesi@0:     $extra = module_invoke_all('node_update_index', $node);
danielebarchiesi@0:     foreach ($extra as $t) {
danielebarchiesi@0:       $text .= $t;
danielebarchiesi@0:     }
danielebarchiesi@0: 
danielebarchiesi@0:     // Update index
danielebarchiesi@0:     search_index($node->nid, 'node', $text);
danielebarchiesi@0:   }
danielebarchiesi@0: }
danielebarchiesi@0: /**
danielebarchiesi@0:  * @} End of "addtogroup hooks".
danielebarchiesi@0:  */
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Provide search query conditions.
danielebarchiesi@0:  *
danielebarchiesi@0:  * Callback for hook_search_info().
danielebarchiesi@0:  *
danielebarchiesi@0:  * This callback is invoked by search_view() to get an array of additional
danielebarchiesi@0:  * search conditions to pass to search_data(). For example, a search module
danielebarchiesi@0:  * may get additional keywords, filters, or modifiers for the search from
danielebarchiesi@0:  * the query string.
danielebarchiesi@0:  *
danielebarchiesi@0:  * This example pulls additional search keywords out of the $_REQUEST variable,
danielebarchiesi@0:  * (i.e. from the query string of the request). The conditions may also be
danielebarchiesi@0:  * generated internally - for example based on a module's settings.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @param $keys
danielebarchiesi@0:  *   The search keywords string.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @return
danielebarchiesi@0:  *   An array of additional conditions, such as filters.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @ingroup callbacks
danielebarchiesi@0:  * @ingroup search
danielebarchiesi@0:  */
danielebarchiesi@0: function callback_search_conditions($keys) {
danielebarchiesi@0:   $conditions = array();
danielebarchiesi@0: 
danielebarchiesi@0:   if (!empty($_REQUEST['keys'])) {
danielebarchiesi@0:     $conditions['keys'] = $_REQUEST['keys'];
danielebarchiesi@0:   }
danielebarchiesi@0:   if (!empty($_REQUEST['sample_search_keys'])) {
danielebarchiesi@0:     $conditions['sample_search_keys'] = $_REQUEST['sample_search_keys'];
danielebarchiesi@0:   }
danielebarchiesi@0:   if ($force_keys = config('sample_search.settings')->get('force_keywords')) {
danielebarchiesi@0:     $conditions['sample_search_force_keywords'] = $force_keys;
danielebarchiesi@0:   }
danielebarchiesi@0:   return $conditions;
danielebarchiesi@0: }