answers.search.inc in Answers 7.3

Search functions for the 'Answers' module.

File

includes/answers.search.inc

<?php

/**
 * @file
 * Search functions for the 'Answers' module.
 */

/**
 * The module provides two key functions.
 *
 *   1. A search view for searching for questions
 *   2. A workflow requires the user to review similar questions before posting.
 *
 * Function 1: A search view for searching for questions.
 *
 *   1. A user can start a search by using the path
 * "questions/search?keys=<keys>"
 *   2. An exposed views form catches this routing
 *   2. The user is shown a list of matching questions.
 *     - The display is provided using a list view like that used in the rest of
 * Answers (e,g, the path "questions/all")
 *     - The display adds a link to allow users to create a new question if
 * desired.
 *   3. The user can view one of the questions, ask a new question, or modify
 * the search.
 *
 *  Function 2: A workflow for asking new questions which requires the user to
 * review similar questions
 *
 *   1. A user can start to ask a question at 'questions/start_ask'
 *   2. The function answers_menu catches this path and calls the
 * 'answers_search_start_ask' function
 *   3. This function provides a simple search form. It allows the user to enter
 * a question
 *   4. This question is then passed to 'questions/continue_ask?keys=<question>
 *   5. An exposed views form catches this routing and shows matching questions
 *   6. The user can view one of the questions, modify their question, or go on
 * to ask their question
 *   7. If the user goes on, the question is passed to
 * 'node/add/question?title=<question>'
 *   8. The function answers_form_alter is called and inserts the title into the
 * form
 */

/**
 * Ask question form.
 */
function answers_start_ask_form($form, &$form_state) {

  // This tells it to submit to question/contiue_ask with current question
  // as search term.
  $form['#method'] = 'GET';
  $form['#action'] = url('questions/continue_ask');
  $form['keys'] = array(
    '#type' => 'textfield',
    '#title' => t('Question'),
    '#size' => 80,
  );
  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Begin'),
    '#submit' => array(
      'answers_start_ask_submit',
    ),
  );
  $form['#after_build'] = array(
    'answers_remove_extra_elements',
  );
  return $form;
}

/**
 * Removes uneeded elements from the form defination.
 */
function answers_remove_extra_elements($form) {
  unset($form['form_build_id'], $form['form_token'], $form['form_id']);
  return $form;
}

/**
 * Pseudo implementation of hook_form_alter().
 *
 * @see answers_form_alter()
 */
function _answers_search_form_views_exposed_form_alter(&$form, &$form_state) {
  $view = $form_state['view'];

  // @FIXME This appears to be checking for what view/display it's altering?
  if ($view->name == 'questions_list' && ($view->current_display == 'page_5' || $view->current_display == 'page_4')) {

    // Delete the title from the search box.
    $form['#info']['filter-keys']['label'] = '';

    // Change the length & description of the search box.
    $form['keys']['#title'] = t('Question');
    $form['keys']['#size'] = 80;
    $form['keys']['#attributes']['title'] = t('Enter your question');

    // Change the title of the standard search button.
    $form['submit']['#value'] = t('Search');
  }

  // If "Continue question display", add a button for posting the question.
  if ($view->name == 'questions_list' && $view->current_display == 'page_5') {
    $form['submit']['#value'] = t('Search Again');
    $form['continue_ask'] = array(
      '#type' => 'submit',
      '#name' => 'test',
      '#value' => t('Continue With Your Question'),
      '#submit' => array(
        'answers_continue_ask_submit',
      ),
    );
  }
}

/**
 * Redirect form to the question form.
 *
 * @todo Remove this and use GET instead of posted form.
 */
function answers_continue_ask_submit($form, &$form_state) {
  $form_state['no_redirect'] = FALSE;
  $form_state['redirect'] = array(
    'node/add/question',
    array(
      'query' => array(
        'title' => $form_state['input']['keys'],
      ),
    ),
  );
}

Functions

Name	Description
answers_continue_ask_submit	Redirect form to the question form.
answers_remove_extra_elements	Removes uneeded elements from the form defination.
answers_start_ask_form	Ask question form.
_answers_search_form_views_exposed_form_alter	Pseudo implementation of hook_form_alter().