<?php
// $Id: apachesolr_search.module,v 1.1.2.6.2.88 2009-04-30 17:38:41 pwolanin Exp $

/**
 * @file
 *   Provides a content search implementation for node content for use with the
 *   Apache Solr search application.
 */

/**
 * Implementation of hook_help().
 */
function apachesolr_search_help($section) {
  switch ($section) {
    case 'admin/settings/apachesolr/index':
      $remaining = 0;
      $total = 0;
      // Collect the stats
      $status = module_invoke('apachesolr_search', 'search', 'status');
      $remaining += $status['remaining'];
      $total += $status['total'];

      return t('The search index is generated by !cron. %percentage of the site content has been sent to the server. There @items left to send.', array(
        '!cron' => l(t('running cron'), 'admin/reports/status/run-cron', array('query' => array('destination' => 'admin/settings/apachesolr/index'))),
        '%percentage' => ((int)min(100, 100 * ($total - $remaining) / max(1, $total))) .'%',
        '@items' => format_plural($remaining, t('is 1 item'), t('are @count items')
      )));
  }
}

/**
 * Implementation of hook_menu().
 */
function apachesolr_search_menu() {
  $items['admin/settings/apachesolr/query-fields'] = array(
    'title'            => 'Search fields',
    'page callback'    => 'apachesolr_search_settings_page',
    'access arguments' => array('administer site configuration'),
    'weight'           => 1,
    'type'             => MENU_LOCAL_TASK,
    'file'             => 'apachesolr_search.admin.inc',
  );
  $items['admin/settings/apachesolr/content-bias'] = array(
    'title'            => 'Content bias settings',
    'page callback'    => 'apachesolr_boost_settings_page',
    'access arguments' => array('administer site configuration'),
    'weight'           => 1,
    'type'             => MENU_LOCAL_TASK,
    'file'             => 'apachesolr_search.admin.inc',
  );

  return $items;
}

/**
 * Implementation of hook_update_index().
 */
function apachesolr_search_update_index() {
  $cron_limit = variable_get('apachesolr_cron_limit', 50);
  $result = apachesolr_get_nodes_to_index('apachesolr_search', $cron_limit);
  apachesolr_index_nodes($result, 'apachesolr_search');
}

/**
 * Implementation of hook_apachesolr_types_exclude().
 */
function apachesolr_search_apachesolr_types_exclude($namespace) {
  if ($namespace == 'apachesolr_search') {
    $excluded_types = variable_get('apachesolr_search_excluded_types', array());
    return array_filter($excluded_types);
  }
}

/**
 * Implementation of hook_search().
 */
function apachesolr_search_search($op = 'search', $keys = NULL) {

  switch ($op) {
    case 'name':
      return t('Search');

    case 'reset':
      apachesolr_clear_last_index('apachesolr_search');
      return;

    case 'status':
      return apachesolr_index_status('apachesolr_search');

    case 'search':

      try {
        if (empty($filters) && !empty($_GET['filters'])) {
          $filters = $_GET['filters'];
        }
        if (empty($solrsort) && !empty($_GET['solrsort'])) {
          $solrsort = $_GET['solrsort'];
        }
        // This is the object that knows about the query coming from the user.
        $query = apachesolr_drupal_query($keys, $filters, $solrsort, 'search/' . arg(1));
        if (empty($query)) {
          throw new Exception(t('Could not construct a Solr query in function apachesolr_search_search()'));
        }

        $results = array();

        $params = array(
          'fl' => 'id,nid,title,comment_count,type,created,changed,score,url,uid,name',
          'rows' => variable_get('apachesolr_rows', 10),
          'facet' => 'true',
          'facet.mincount' => 1,
          'facet.sort' => 'true'
        );

        /**
         * Highlighting settings
         * These settings are set in solrconfig.xml.
         * See the defaults there.
         * If you wish to override them, you can via settings.php
         */

        $params['hl'] = variable_get('apachesolr_hl_active', NULL);
        $params['hl.fragsize']= variable_get('apachesolr_hl_textsnippetlength', NULL);
        $params['hl.simple.pre'] = variable_get('apachesolr_hl_pretag', NULL);
        $params['hl.simple.post'] = variable_get('apachesolr_hl_posttag', NULL);
        $params['hl.snippets'] = variable_get('apachesolr_hl_numsnippets', NULL);
        $params['hl.fl'] = variable_get('apachesolr_hl_fieldtohightlight', NULL);
        // We default to getting snippets from the body.
        $hl_fl = is_null($params['hl.fl']) ? 'body' : $params['hl.fl'];

        if (variable_get('apachesolr_search_spellcheck', FALSE)) {
          //Add new parameter to the search request
          $params['spellcheck.q'] = $query->get_query_basic();
          $params['spellcheck'] = 'true';
        }

        $facet_query_limits = variable_get('apachesolr_facet_query_limits', array());
        $facet_missing = variable_get('apachesolr_facet_missing', array());

        foreach (apachesolr_get_enabled_facets() as $module => $module_facets) {
          foreach($module_facets as $delta => $facet_field) {
            // TODO: generalize handling of date and range facets.
            if ($module == 'apachesolr_search' && ($facet_field == 'created' || $facet_field == 'changed')) {
              list($start, $end, $gap) = apachesolr_search_date_range($query, $facet_field);
              if ($gap) {
                $params['facet.date'][] = $facet_field;
                $params['f.'. $facet_field .'.facet.date.start'] = $start;
                $params['f.'. $facet_field .'.facet.date.end'] = $end;
                $params['f.'. $facet_field .'.facet.date.gap'] = $gap;
              }
            }
            else {
              $params['facet.field'][] = $facet_field;
              // Facet limits
              if (isset($facet_query_limits[$module][$delta])) {
                $params['f.' . $facet_field . '.facet.limit'] = $facet_query_limits[$module][$delta];
              }
              // Facet missing
              if (!empty($facet_missing[$module][$delta])) {
                $params['f.' . $facet_field . '.facet.missing'] = 'true';
              }
            }
          }
        }

        if (!empty($params['facet.field'])) {
          // Add a default limit for fields where no limit was set.
          $params['facet.limit'] = variable_get('apachesolr_facet_query_limit_default', 20);
        }

        if (isset($_GET['solrsort'])) {
          $sort = check_plain($_GET['solrsort']);
        }

        // Validate sort parameter
        if (isset($sort) && preg_match('/^([a-z0-9_]+ (asc|desc)(,)?)+$/i', $sort)) {
          $params['sort'] = $sort;
        }

        $page = isset($_GET['page']) ? $_GET['page'] : 0;
        $params['start'] = $page * $params['rows'];
        // This is the object that does the communication with the solr server.
        $solr = apachesolr_get_solr();

        // Note - we have query fields set in solrconfig.xml, which will operate when
        // none are set.
        $qf = variable_get('apachesolr_search_query_fields', array());
        $fields = $solr->getFields();
        if ($qf && $fields) {
          foreach ($fields as $field_name => $field) {
            if (!empty($qf[$field_name])) {
              if ($field_name == 'body') {
                // Body is the only normed field.
                $qf[$field_name] *= 40.0;
              }
              $params['qf'][] = $field_name . '^'. $qf[$field_name];
            }
          }
        }

        $data = $solr->getLuke();
        if (isset($data->index->numDocs)) {
          $total = $data->index->numDocs;
        }
        else {
          $total = db_result(db_query("SELECT COUNT(nid) FROM {node}"));
        }
        // For the boost functions for the created timestamp, etc we use the
        // standard date-biasing function, as suggested (but steeper) at
        // http://wiki.apache.org/solr/DisMaxRequestHandler
        // rord() returns 1 for the newset doc, and the number in the index for
        // the oldest doc.  The function is thus: $total/(rord()*$steepness + $total).
        $date_settings = variable_get('apachesolr_search_date_boost', '4:200.0');
        list($date_steepness, $date_boost) = explode(':', $date_settings);
        if ($date_boost) {
          $params['bf'][] = "recip(rord(created),$date_steepness,$total,$total)^$date_boost";
        }
        // Boost on comment count.
        $comment_settings = variable_get('apachesolr_search_comment_boost', '0:0');
        list($comment_steepness, $comment_boost) = explode(':', $comment_settings);
        if ($comment_boost) {
          $params['bf'][] = "recip(rord(comment_count),$comment_steepness,$total,$total)^$comment_boost";
        }
        // Boost for a more recent comment or node edit.
        $changed_settings = variable_get('apachesolr_search_changed_boost', '0:0');
        list($changed_steepness, $changed_boost) = explode(':', $changed_settings);
        if ($changed_boost) {
          $params['bf'][] = "recip(rord(last_comment_or_change),$changed_steepness,$total,$total)^$changed_boost";
        }
        // Boost for nodes with sticky bit set.
        $sticky_boost = variable_get('apachesolr_search_sticky_boost', 0);
        if ($sticky_boost) {
          $params['bq'][] = "sticky:true^$sticky_boost";
        }
        // Boost for nodes with promoted bit set.
        $promote_boost = variable_get('apachesolr_search_promote_boost', 0);
        if ($promote_boost) {
          $params['bq'][] = "promote:true^$promote_boost";
        }
        // Modify the weight of results according to the node types.
        $type_boosts = variable_get('apachesolr_search_type_boosts', array());
        if (!empty($type_boosts)) {
          foreach ($type_boosts as $type => $boost) {
            // Only add a param if the boost is != 0 (i.e. > "Normal").
            if ($boost) {
              $params['bq'][] = "type:$type^$boost";
            }
          }
        }
        
        // Cache the built query. Since all the built queries go through
        // this process, all the hook_invocations will happen later
        apachesolr_current_query($query);
        
        // This hook allows modules to modify the query and params objects.
        apachesolr_modify_query($query, $params, 'apachesolr_search');
        if (!$query) {
          return array();
        }

        $response = $solr->search($query->get_query_basic(), $params['start'], $params['rows'], $params);
        // The response is cached so that it is accessible to the blocks and anything
        // else that needs it beyond the initial search.
        $total = $response->response->numFound;
        apachesolr_static_response_cache($response);
        apachesolr_has_searched(TRUE);
        pager_query("SELECT %d", $params['rows'], 0, NULL, $total);
        if ($total > 0) {
          foreach ($response->response->docs as $doc) {
            $extra = array();
            $snippet = isset($response->highlighting->{$doc->id}->$hl_fl) ? theme('apachesolr_search_snippets', $doc, $response->highlighting->{$doc->id}->$hl_fl) : '';
            if (!isset($doc->body)) {
              $doc->body = $snippet;
            }
            $doc->created = strtotime($doc->created);
            $doc->changed = strtotime($doc->changed);
            // Allow modules to alter each document.
            drupal_alter('apachesolr_search_result', $doc);
            // Copy code from comment_nodeapi().
            $extra[] = format_plural($doc->comment_count, '1 comment', '@count comments');
            $results[] = array(
              'link' => url('node/' . $doc->nid),
              'type' => apachesolr_search_get_type($doc->type),
              'title' => $doc->title,
              'user' => theme('username', $doc),
              'date' => $doc->created,
              'node' => $doc,
              'extra' => $extra,
              'score' => $doc->score,
              'snippet' => $snippet,
            );
          }

          // Hook to allow modifications of the retrieved results
          foreach (module_implements('apachesolr_process_results') as $module) {
            $function = $module .'_apachesolr_process_results';
            $function($results);
          }
        }
        // Add search terms and filters onto the breadcrumb.
        drupal_set_breadcrumb(array_merge(menu_get_active_breadcrumb(), $query->get_breadcrumb($_GET['q'])));
        return $results;

      } // try
      catch (Exception $e) {
        watchdog('Apache Solr', $e->getMessage(), NULL, WATCHDOG_ERROR);
        apachesolr_failure(t('Solr search'), empty($query) ? $keys : $query->get_query_basic());
      }
      break;
  } // switch
}

function apachesolr_search_date_range($query, $facet_field) {
  foreach ($query->get_filters($facet_field) as $filter) {
    // If we had an ISO date library we could use ISO dates
    // directly.  Instead, we convert to Unix timestamps for comparison.
    // Only use dates if we are able to parse into timestamps.
    $start = strtotime($filter['#start']);
    $end = strtotime($filter['#end']);
    if ($start && $end && ($start < $end)) {
        $start_iso = $filter['#start'];
        $end_iso = $filter['#end'];
      // Determine the drilldown gap for this range.
      $gap = apachesolr_date_gap_drilldown(apachesolr_date_find_query_gap($start_iso, $end_iso));
    }
  }
  // If there is no $delta field in query object, get initial
  // facet.date.* params from the DB and determine the best search
  // gap to use.  This callback assumes $delta is 'changed' or 'created'.
  if (!isset($start_iso)) {
    $start_iso = apachesolr_date_iso(db_result(db_query("SELECT MIN($facet_field) FROM {node} WHERE status = 1")));
    $end_iso = apachesolr_date_iso(db_result(db_query("SELECT MAX($facet_field) FROM {node} WHERE status = 1")));
    $gap = apachesolr_date_determine_gap($start_iso, $end_iso);
  }
  // Return a query range from the beginning of a gap period to the beginning
  // of the next gap period.  We ALWAYS generate query ranges of this form
  // and the apachesolr_date_*() helper functions require it.
  return array("$start_iso/$gap", "$end_iso+1$gap/$gap", "+1$gap");
}

/**
 * Implementation of hook_apachesolr_facets().
 *
 * Returns an array keyed by block delta.
 */
function apachesolr_search_apachesolr_facets() {
  $facets = array();

  $facets['type'] = array(
    'info' => t('Apache Solr Search: Filter by content type'),
    'facet_field' => 'type',
  );
  $facets['uid'] = array(
    'info' => t('Apache Solr Search: Filter by author'),
    'facet_field' => 'uid',
  );
  $facets['language'] = array(
    'info' => t('Apache Solr Search: Filter by language'),
    'facet_field' => 'language',
  );

  $facets['changed'] = array(
    'info' => t('Apache Solr Search: Filter by updated date'),
    'facet_field' => 'changed',
  );
  $facets['created'] = array(
    'info' => t('Apache Solr Search: Filter by post date'),
    'facet_field' => 'created',
  );

  // A book module facet.
  if (module_exists('book')) {
    $facets['is_book_bid'] = array(
      'info' => t('Apache Solr Search: Filter by Book'),
      'facet_field' => 'is_book_bid',
    );
  }

  // Get taxonomy vocabulary facets.
  if (module_exists('taxonomy')) {
    $vocabs = taxonomy_get_vocabularies();
    foreach ($vocabs as $vid => $vocab) {
      // In this case the delta and facet field are the same.
      $delta = 'im_vid_' . $vid;
      $facets[$delta] = array(
        'info' => t('Apache Solr Search: Filter by taxonomy @name', array('@name' => $vocab->name)),
        'facet_field' => $delta,
      );
    }
  }

  // Get CCK field facets.
  $fields = apachesolr_cck_fields();
  if ($fields) {
    foreach ($fields as $name => $field) {
      // $delta can only be 32 chars, and the CCK field name may be this
      // long also, so we cannot add anything to it.
      $facets[$field['field_name']] = array(
        'info' => t('Apache Solr Search: Filter by @field', array('@field' => $field['label'])),
        'facet_field' => apachesolr_index_key($field),
      );
    }
  }
  return $facets;
}

/**
 * Implementation of hook_block().
 */
function apachesolr_search_block($op = 'list', $delta = 0, $edit = array()) {

  switch ($op) {
    case 'list':
      $enabled_facets = apachesolr_get_enabled_facets('apachesolr_search');
      $facets = apachesolr_search_apachesolr_facets();
      // Add the blocks
      $blocks = array();
      foreach ($enabled_facets as $delta => $facet_field) {
        if (isset($facets[$delta])) {
          $blocks[$delta] = $facets[$delta] + array('cache' => BLOCK_CACHE_PER_PAGE,);
        }
      }
      $blocks['currentsearch'] = array(
        'info' => t('Apache Solr Search: Current search'),
        'cache' => BLOCK_CACHE_PER_PAGE,
      );
      return $blocks;

    case 'view':
      if (apachesolr_has_searched()) {
        // Get the query and response. Without these no blocks make sense.
        $response = apachesolr_static_response_cache();
        if (empty($response)) {
          return;
        }
        $query = apachesolr_current_query();

        $facets = apachesolr_get_enabled_facets('apachesolr_search');
        if (empty($facets[$delta]) && ($delta != 'currentsearch')) {
          return;
        }

        // Get information needed by the taxonomy blocks about limits.
        $initial_limits = variable_get('apachesolr_facet_query_initial_limits', array());
        $limit_default = variable_get('apachesolr_facet_query_initial_limit_default', 10);

        // Handle taxonomy vocabulary facets
        if ((strpos($delta, 'im_vid_') === 0) && module_exists('taxonomy')) {

          if (is_object($response->facet_counts->facet_fields->$delta)) {
            $contains_active = FALSE;
            $terms = array();

            foreach ($response->facet_counts->facet_fields->$delta as $tid => $count) {
              if ($tid == '_empty_') {
                // TODO - for now we don't handle facet missing.
                continue;
              }
              $unclick_link = '';
              unset($active);
              $term = taxonomy_get_term($tid);
              $new_query = clone $query;
              if ($active = $query->has_filter('tid', $tid)) {
                $contains_active = TRUE;
                $new_query->remove_filter('tid', $term->tid);
                $path = $new_query->get_path();
                $querystring = $new_query->get_url_querystring();
                $unclick_link = theme('apachesolr_unclick_link', $path, $querystring);
              }
              else {
                $new_query->add_filter('tid', $term->tid);
                $path = $new_query->get_path();
                $querystring = $new_query->get_url_querystring();
              }
              $countsort = $count == 0 ? '' : 1 / $count;
              // if numdocs == 1 and !active, don't add.
              if ($response->response->numFound > 1 || $active) {
                $terms[$term->vid][$active ? $countsort . $term->name : 1 + $countsort . $term->name] = theme('apachesolr_facet_item', $term->name, $count, $path, $querystring, $active, $unclick_link, $response->response->numFound);
              }
            }
          }
          $vid = substr($delta, 7);
          $vocab = taxonomy_vocabulary_load($vid);
          if (is_numeric($vid) && is_array($terms) && isset($terms[$vid]) && is_array($terms[$vid])) {
            ksort($terms[$vid]);
            $limit = isset($initial_limits['apachesolr_search'][$delta]) ? $initial_limits['apachesolr_search'][$delta] : $limit_default;
            return array(
              'subject' => t('Filter by @name', array('@name' => $vocab->name)),
              'content' => theme('apachesolr_facet_list', $terms[$vid], $limit),
            );
          }
          return;
        }

        switch ($delta) {
          case 'currentsearch':
            $fields = $query->get_filters();
            $path = $query->get_path();
            $options = array();
            if (!$fields) {
              $options['attributes']['class'] = 'active';
            }
            $links[] = apachesolr_l($search_keys, $path, $options);
            foreach($fields as $field) {
              if ($field['#name']) {
                $new_query = clone $query;
                $new_query->remove_filter($field['#name'], $field['#value']);
                $path = $new_query->get_path();
                $querystring = $new_query->get_url_querystring();
                $unclick_link = theme('apachesolr_unclick_link', $path, $querystring);
                if (! $fielddisplay = theme("apachesolr_breadcrumb_". $field['#name'], $field['#value'])) {
                  $fielddisplay = $field['#value'];
                }
                $links[] = theme('apachesolr_facet_item', $fielddisplay, NULL, $path, $querystring, $active, $unclick_link, $response->response->numFound);
              }
            }
            $content = theme('apachesolr_currentsearch', $response->response->numFound, $links);
            return array('subject' => t('Current search'), 'content' => $content);
          case 'is_book_bid':
            return apachesolr_facet_block($response, $query, 'apachesolr_search', $delta, $delta, t('Filter by book'), 'apachesolr_search_get_book');
          case 'language':
            return apachesolr_facet_block($response, $query, 'apachesolr_search', $delta, $delta, t('Filter by language'), 'locale_language_name');
           case 'uid':
            return apachesolr_facet_block($response, $query, 'apachesolr_search', $delta, $delta, t('Filter by author'), 'apachesolr_search_get_username');
          case 'type':
            return apachesolr_facet_block($response, $query, 'apachesolr_search', $delta, $delta, t('Filter by type'), 'apachesolr_search_get_type');
          case 'changed':
            return apachesolr_date_facet_block($response, $query, 'apachesolr_search', $delta, $delta, t('Filter by modification date'));
          case 'created':
            return apachesolr_date_facet_block($response, $query, 'apachesolr_search', $delta, $delta, t('Filter by post date'));

          default:
           if ($fields = apachesolr_cck_fields()) {
            foreach ($fields as $name => $field) {
              if ($field['field_name'] == $delta) {
                $index_key = apachesolr_index_key($field);
                return apachesolr_facet_block($response, $query, 'apachesolr_search', $delta, $index_key, t('Filter by @field', array('@field' => $field['label'])));
              }
            }
          }
        }
        break;
      }
      break;

    case 'configure':
      if ($delta != 'currentsearch') {
        return apachesolr_facetcount_form('apachesolr_search', $delta);
      }
      break;

    case 'save':
      if ($delta != 'currentsearch') {
        apachesolr_facetcount_save($edit);
      }
      break;
  }
}

/**
 * Callback function for the 'Filter by book' facet block.
 */
function apachesolr_search_get_book($facet, &$options) {
  if (is_numeric($facet)) {
    return db_result(db_query('SELECT title FROM {node} WHERE nid = %d', $facet));
  }
  else {
    $options['html'] = TRUE;
    return theme('placeholder', t('Not in any book'));
  }
}

/**
 * Callback function for the 'Filter by name' facet block.
 */
function apachesolr_search_get_username($facet) {
  if ($facet == 0) {
    return variable_get('anonymous', t('Anonymous'));
  }
  else {
    return db_result(db_query("SELECT name FROM {users} WHERE uid = %d", $facet));
  }
}

/**
 * Callback function for the 'Filter by type' facet block.
 */
function apachesolr_search_get_type($facet) {
  $type = node_get_types('name', $facet);
  // A disabled or missing node type returns FALSE.
  return ($type === FALSE) ? $facet : $type;
}

/**
 * Implementation of hook_form_[form_id]_alter().
 *
 * This adds spelling suggestions to the search form.
 */
function apachesolr_search_form_search_form_alter(&$form, $form_state) {

  if (($form['module']['#value'] == 'apachesolr_search') && variable_get('apachesolr_search_spellcheck', FALSE) && apachesolr_has_searched() && ($response = apachesolr_static_response_cache())) {
    //Get spellchecker suggestions into an array.
    $suggestions = get_object_vars($response->spellcheck->suggestions);

    if ($suggestions) {
      //Get the original query and replace words.
      $query = apachesolr_current_query();

      foreach($suggestions as $word => $value) {
        $replacements[$word] = $value->suggestion[0];
      }
      $new_keywords = strtr($query->get_query_basic(), $replacements);

      $form['basic']['suggestion'] = array(
        '#prefix' => '<div class="spelling-suggestions">',
        '#suffix' => '</div>',
        '#type' => 'item',
        '#title' => t('Did you mean'),
        '#value' => l($new_keywords, $query->get_path($new_keywords)),
      );
    }
  }
}

/**
 * Implementation of hook_form_[form_id]_alter().
 *
 * This adds spelling suggestions to the search form.
 */
function apachesolr_search_form_apachesolr_settings_alter(&$form, $form_state) {
  $form['apachesolr_search_spellcheck'] = array(
    '#type' => 'checkbox',
    '#title' => t('Enable spellchecker and suggestions'),
    '#default_value' => variable_get('apachesolr_search_spellcheck', FALSE),
    '#description' => t('Enable spellchecker and get word suggestions. Also known as the "Did you mean ... ?" feature.'),
  );

  $form['#submit'][] = 'apachesolr_search_build_spellcheck';
  // Move buttons to the bottom.
  $buttons = $form['buttons'];
  unset($form['buttons']);
  $form['buttons'] = $buttons;
}

/**
 * Implementation of hook_form_[form_id]_alter().
 *
 * Rebuild (empty) the spellcheck dictionary when the index is deleted..
 */
function apachesolr_search_form_apachesolr_delete_index_form_alter(&$form, $form_state) {
  $form['submit']['#submit'][] = 'apachesolr_search_build_spellcheck';
}

function apachesolr_search_build_spellcheck() {
  try {
    $solr = apachesolr_get_solr();
    $params['spellcheck'] = 'true';
    $params['spellcheck.build'] = 'true';
    $response = $solr->search('solr', 0, 0, $params);
  }
  catch (Exception $e) {
    watchdog('Apache Solr', $e->getMessage(), NULL, WATCHDOG_ERROR);
  }
}

/**
 * Implementation of hook_theme().
 */
function apachesolr_search_theme() {
  return array(
    'apachesolr_breadcrumb_is_book_bid' => array(
      'arguments' => array('bid' => NULL),
    ),
    'apachesolr_breadcrumb_uid' => array(
      'arguments' => array('uid' => NULL),
    ),
    'apachesolr_breadcrumb_tid' => array(
      'arguments' => array('tid' => NULL),
    ),
    'apachesolr_breadcrumb_type' => array(
      'arguments' => array('type' => NULL),
    ),
    'apachesolr_breadcrumb_changed' => array(
      'arguments' => array('type' => NULL),
    ),
    'apachesolr_breadcrumb_created' => array(
      'arguments' => array('type' => NULL),
    ),
    'apachesolr_currentsearch' => array(
      'arguments' => array('total_found' => NULL, 'links' => NULL),
    ),
    'apachesolr_search_snippets' => array(
      'arguments' => array('doc' => NULL, 'snippets' => NULL),
    ),
  );
}

function theme_apachesolr_breadcrumb_date_range($range) {
  if (preg_match('@[\[\{](\S+) TO (\S+)[\]\}]@', $range, $match)) {
    return apachesolr_date_format_range($match[1], $match[2]);
  }
  return $range;
}

function theme_apachesolr_breadcrumb_changed($range) {
  return theme_apachesolr_breadcrumb_date_range($range);
}

function theme_apachesolr_breadcrumb_created($range) {
  return theme_apachesolr_breadcrumb_date_range($range);
}

/**
 * Return the username from $uid
 */
function theme_apachesolr_breadcrumb_uid($uid) {
  return apachesolr_search_get_username($uid);
}

/**
 * Return the term name from $tid.
 */
function theme_apachesolr_breadcrumb_tid($tid) {
  $term = taxonomy_get_term($tid);
  return $term->name;
}

/**
 * Return the human readable text for a content type.
 */
function theme_apachesolr_breadcrumb_type($type) {
  return node_get_types('name', $type);
}

/**
 * Return the title of a book.
 */
function theme_apachesolr_breadcrumb_is_book_bid($bid) {
  if (is_numeric($bid)) {
    return db_result(db_query('SELECT title FROM {node} WHERE nid = %d', $bid));
  }
  else {
    return t('Not in any book');
  }
}

/**
 * Return current search block contents
 */
function theme_apachesolr_currentsearch($total_found, $links) {
  return theme_item_list($links, format_plural($total_found, 'Search found 1 item', 'Search found @count items'));
}

/**
 * Theme the highlighted snippet text for a search entry.
 *
 * @param object $doc
 * @param array $snippets
 *
 */
function theme_apachesolr_search_snippets($doc, $snippets) {
  return implode(' ... ', $snippets);
}