You are here

empty_behavior_text.inc in Facet API 7

The empty_text empty behavior class.

File

plugins/facetapi/empty_behavior_text.inc
View source
<?php

/**
 * @file
 * The empty_text empty behavior class.
 */

/**
 * Empty behavior plugin that displays markup, usually just some text.
 *
 * This plugin allows administrators to display markup filtered through text
 * formats as the contents of a facet when it has no items.
 */
class FacetapiEmptyBehaviorText extends FacetapiEmptyBehavior {

  /**
   * A boolean flagging whether the input format is set, FALSE means it is
   * being pulled from FacetapiEmptyBehavior::getDefaultSettings().
   *
   * @var bool
   */
  protected $formatSet = FALSE;

  /**
   * Overrides FacetapiEmptyBehavior::__construct().
   *
   * Checks if a format was selected, calls parent's constructor.
   */
  public function __construct(stdClass $settings) {
    if (isset($settings->settings['empty_text']['format'])) {
      $this->formatSet = TRUE;
    }
    parent::__construct($settings);
  }

  /**
   * Implements FacetapiEmptyBehavior::execute().
   */
  public function execute() {
    $format_id = $this->settings['empty_text']['format'];
    $text = $this
      ->translate('empty_text', $this->settings['empty_text']['value']);
    return array(
      '#markup' => check_markup($text, $format_id),
    );
  }

  /**
   * Overrides FacetapiEmptyBehavior::settingsForm().
   */
  public function settingsForm(&$form, &$form_state) {
    global $user;
    $format_id = $this->formatSet ? $this->settings['empty_text']['format'] : filter_default_format($user);
    $format = filter_format_load($format_id);

    // NOTE: There is a core bug with form #states and the text_format #type.
    // @see http://drupal.org/node/997826
    $form['widget']['empty']['empty_text'] = array(
      '#type' => 'text_format',
      '#access' => $format && filter_access($format, $user),
      '#title' => t('Empty text'),
      '#default_value' => $this->settings['empty_text']['value'],
      '#format' => $format_id,
      '#states' => array(
        'visible' => array(
          'select[name="empty_behavior"]' => array(
            'value' => 'text',
          ),
        ),
      ),
    );
  }

  /**
   * Overrides FacetapiEmptyBehavior::getDefaultSettings().
   */
  public function getDefaultSettings() {
    return array(
      'empty_text' => array(
        'value' => '',
        'format' => filter_fallback_format(),
      ),
    );
  }

}

Classes

Namesort descending Description
FacetapiEmptyBehaviorText Empty behavior plugin that displays markup, usually just some text.