You are here

availability_calendar.field.inc in Availability Calendars 7.4

File

availability_calendar.field.inc
View source
<?php

/**
 * Defines the Availability Calendar field.
 *
 * Originally based on the Availability Calendars Module and the availability
 * module. This file contains all field API related hooks and other functions.
 * These hooks and functions should be present in the .module file, so this file
 * gets always )unconditionally) included by this module's .module file.
 *
 * Providing a field requires:
 * - Defining a field
 *   - hook_field_info()
 *   - hook_field_schema()
 *   - hook_field_validate()
 *   - hook_field_is_empty()
 *
 * - Defining a formatter for the field (the portion that outputs the field for
 *   display)
 *   - hook_field_formatter_info()
 *   - hook_field_formatter_view()
 *
 * - Defining a widget for the edit form
 *   - hook_field_widget_info()
 *   - hook_field_widget_form()
 *
 * See @link field_types Field Types API @endlink
 */

/***************************************************************
 * Field Type API hooks
 ***************************************************************/

/**
 * Implements hook_field_info().
 * @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/hook_field_info/7
 *
 * Provides the descriptions of the fields offered by this module.
 */
function availability_calendar_field_info() {

  // Get the states. They are used to determine some default settings.
  module_load_include('inc', 'availability_calendar', 'availability_calendar');
  $states = availability_calendar_get_states();
  if (!empty($states[1]) && $states[1]['css_class'] == 'cal-nc') {

    // State "Not communicated" exists, make this the default, but allow only
    // other states to be selected by the editor.
    $allowed_states = $states;
    unset($allowed_states[1]);
    $allowed_states = array_keys($allowed_states);
    $default_state = 1;
  }
  else {
    $allowed_states = array();

    // No state selected = all states.
    $default_state = 0;

    // Required, but no default.
  }
  return array(
    'availability_calendar' => array(
      'label' => t('Availability Calendar'),
      'description' => t('Allows to add an availability calendar to your entities.'),
      // States are not stored in the field settings but in their own table.
      // Fields can select a subset of this global set as allowed states.
      'settings' => array(
        'allocation_type' => AC_ALLOCATION_TYPE_OVERNIGHT,
        'allowed_states' => $allowed_states,
        'default_state' => $default_state,
      ),
      'instance_settings' => array(
        'allow_disable' => 1,
        'add_name' => 1,
      ),
      'default_widget' => 'availability_calendar',
      'default_formatter' => 'availability_calendar_viewport',
      'i18n_sync_callback' => 'availability_calendar_i18n_sync_availability_calendar_field',
    ),
  );
}

/**
 * Implements hook_field_settings_form().
 * @link http://api.drupal.org/api/drupal/modules--field_ui--field_ui.api.php/function/hook_field_settings_form/7
 *
 * Availability Calendar field sets the allowed states and the default state at
 * the field level.
 */
function availability_calendar_field_settings_form($field) {
  module_load_include('inc', 'availability_calendar', 'availability_calendar.widget');
  $settings = $field['settings'];
  $form = array();
  $form['allocation_type'] = array(
    '#type' => 'radios',
    '#title' => t('Allocation type'),
    '#description' => t('Define the type of rental or allocation you want to support with this field. Differences are minor and are found in wording and rental period display.'),
    '#default_value' => $settings['allocation_type'],
    '#options' => array(
      AC_ALLOCATION_TYPE_FULLDAY => t('Full day rental/allocation'),
      AC_ALLOCATION_TYPE_OVERNIGHT => t('Overnight rental/allocation'),
    ),
  );
  $form['allowed_states'] = array(
    '#type' => 'checkboxes',
    '#title' => t('Allowed states'),
    '#description' => t('Check the availability states that editors are allowed to select for this calendar instance.') . ' ' . t('Checking no states at all will allow all states.'),
    '#default_value' => $settings['allowed_states'],
    '#options' => availability_calendar_get_states('label'),
  );
  $form['default_state'] = array(
    '#type' => 'select',
    '#title' => t('Default state'),
    '#default_value' => $settings['default_state'],
    '#required' => TRUE,
    '#options' => availability_calendar_get_states('label'),
    '#description' => t('Define the state for days that not yet have a state set. This does not have to be an allowed state.'),
  );
  return $form;
}

/**
 * Implements hook_field_instance_settings_form().
 * @link http://api.drupal.org/api/drupal/modules--field_ui--field_ui.api.php/function/hook_field_instance_settings_form/7
 *
 * Availability Calendar field has no instance settings.
 */
function availability_calendar_field_instance_settings_form($field, $instance) {
  $settings = $instance['settings'];
  $form = array();
  $form['allow_disable'] = array(
    '#type' => 'checkbox',
    '#title' => t('Allow to disable the calendar for a @type instance', array(
      '@type' => $instance['bundle'],
    )),
    '#default_value' => $settings['allow_disable'],
    '#weight' => -2,
  );
  $form['add_name'] = array(
    '#type' => 'checkbox',
    '#title' => t('Add a name property to the calendar for a @type instance', array(
      '@type' => $instance['bundle'],
    )),
    '#description' => t('Useful to distinguish calendars when you have multiple calendar values for this field.'),
    '#default_value' => $settings['add_name'],
    '#weight' => -1,
  );
  return $form;
}

/**
 * Implements hook_field_is_empty().
 * @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/hook_field_is_empty/7
 *
 * A calendar is never considered empty, as we have to store the enabled state.
 */
function availability_calendar_field_is_empty($item) {
  return FALSE;
}

/**
 * Implements hook_field_validate().
 * @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/hook_field_validate/7
 *
 * Verifies that the calendar is valid. The calendar field itself is always
 * valid, though a specific widget form may fail validation. This is to be
 * handled by #element_validate's defined by the widget itself.
 */
function availability_calendar_field_validate($entity_type, $entity, $field, $instance, $langcode, $items, &$errors) {
}

/**************************************************************************
 * Field Type API: Widget
 *
 * The widget is the form element used to receive input from the user
 * when the field is being populated.
 **************************************************************************/

/**
 * Implements hook_field_widget_info.
 * @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/hook_field_widget_info/7
 *
 * This module defines a widget based on a monthly display, optionally in a
 * viewport. Other widgets may be defined in the future or by other modules.
 */
function availability_calendar_field_widget_info() {
  $settings = array(
    'show_number_of_months' => 18,
    // 6 = saturday = default change over day.
    'first_day_of_week' => variable_get('date_first_day', 6),
    'show_week_number' => 0,
    'show_only_first_letter' => 0,
    'show_split_day' => 0,
  );
  $viewport_settings = $settings + array(
    'viewport' => array(
      'dimensions_calculation' => 'fixed',
      'cols' => 3,
      'rows' => 2,
      'scroll' => 1,
      'button_placement' => 'before',
    ),
  );
  $field_types = array(
    'availability_calendar',
  );
  $behaviors = array(
    'multiple values' => FIELD_BEHAVIOR_DEFAULT,
    'default value' => FIELD_BEHAVIOR_NONE,
  );
  return array(
    'availability_calendar' => array(
      'label' => t('Show the calendar as a number of months'),
      'description' => '',
      'field types' => $field_types,
      'settings' => $settings,
      'behaviors' => $behaviors,
    ),
    'availability_calendar_viewport' => array(
      'label' => t('Show the calendar in a viewport'),
      'description' => t('Allows to define the number of months to show at once, and provides buttons to scroll through the months. Takes up less space.'),
      'field types' => $field_types,
      'settings' => $viewport_settings,
      'behaviors' => $behaviors,
    ),
  );
}

/**
 * Implements hook_field_widget_settings_form
 * @link http://api.drupal.org/api/drupal/modules--field_ui--field_ui.api.php/function/hook_field_widget_settings_form/7
 */
function availability_calendar_field_widget_settings_form($field, $instance) {
  $widget = $instance['widget'];
  $type = $widget['type'];
  $settings = $widget['settings'];
  $form = availability_calendar_field_widget_and_formatter_settings_form($field, $instance, TRUE, $type, $settings);
  return $form;
}

/**
 * Implements hook_field_widget_form().
 * @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/hook_field_widget_form/7
 *
 * The widget that we define contains a checkbox to enable/disable the calendar,
 * displays a number of months and a radio button set for the allowed states.
 *
 * Changing the calendar is done by selecting a state and then defining a range
 * of states that should get the selected state.
 */
function availability_calendar_field_widget_form(&$form, &$form_state, $field, $instance, $langcode, $items, $delta, $element) {
  module_load_include('inc', 'availability_calendar', 'availability_calendar.widget');
  $element = availability_calendar_field_widget_month_form($form, $form_state, $field, $instance, $langcode, $items, $delta, $element);
  return $element;
}

/**
 * Implements hook_field_attach_submit.
 * @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/hook_field_attach_submit/7
 */
function availability_calendar_field_attach_submit($entity_type, $entity, $form, &$form_state) {
  if (!empty($form_state['availability_calendar_updates'])) {
    module_load_include('inc', 'availability_calendar', 'availability_calendar.widget');
    availability_calendar_field_attach_submit_inc($entity_type, $entity, $form, $form_state);
  }
}

/******************************************************************************
 *  Field Type API: Formatter
 *
 *  These are the api hooks that present formatted (themed) output to the user.
 *****************************************************************************/

/**
 * Implements hook_field_formatter_info().
 * @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/hook_field_formatter_info/7
 *
 * This module defines a formatter based on a monthly display, optionally in a
 * viewport. Other formatters may be defined in the future or by other modules.
 */
function availability_calendar_field_formatter_info() {
  $settings = array(
    'show_number_of_months' => 12,
    // 6 = saturday = default change over day.
    'first_day_of_week' => variable_get('date_first_day', 6),
    'show_week_number' => 0,
    'show_only_first_letter' => 0,
    'show_split_day' => 0,
    'selectable' => module_exists('availability_calendar_booking_formlet'),
  );
  $viewport_settings = $settings + array(
    'viewport' => array(
      'dimensions_calculation' => 'fixed',
      'cols' => 3,
      'rows' => 1,
      'scroll' => 1,
      'button_placement' => 'after',
    ),
  );
  $result = array(
    'availability_calendar' => array(
      'label' => t('Show the calendar as a set of months'),
      'field types' => array(
        'availability_calendar',
      ),
      'settings' => $settings,
    ),
    'availability_calendar_viewport' => array(
      'label' => t('Show the calendar in a viewport'),
      'description' => t('Allows to define the number of months to show at once, and provides buttons to scroll through the months. Takes up less space.'),
      'field types' => array(
        'availability_calendar',
      ),
      'settings' => $viewport_settings,
    ),
  );
  if (module_exists('colorbox')) {
    $colorbox_settings = $settings + array(
      'colorbox' => array(
        'width' => '720',
        'height' => 'auto',
      ),
    );
    $result['availability_calendar_colorbox'] = array(
      'label' => t('Show the calendar in a Colorbox'),
      'description' => t('Show the calendar in a Colorbox, so it takes up almost no space.'),
      'field types' => array(
        'availability_calendar',
      ),
      'settings' => $colorbox_settings,
    );
  }
  return $result;
}

/**
 * Implements hook_field_formatter_settings_form().
 * @link http://api.drupal.org/api/drupal/modules--field_ui--field_ui.api.php/function/hook_field_formatter_settings_form/7
 */
function availability_calendar_field_formatter_settings_form($field, $instance, $view_mode) {
  $display = $instance['display'][$view_mode];
  $type = $display['type'];
  $settings = $display['settings'];
  $element = availability_calendar_field_widget_and_formatter_settings_form($field, $instance, FALSE, $type, $settings);
  return $element;
}

/**
 * Returns the common elements for the widget and formatter settings forms.
 *
 * The widget and the formatter have almost all their settings in common. This
 * method returns the form elements that are common to both.
 *
 * @param array $field
 *   The field structure being configured.
 * @param array $instance
 *   The instance structure being configured.
 * @param boolean $widget
 *   Whether we are creating the form elements for the widget (true) or the
 *   formatter (false).
 * @param string $type
 *   The widget or formatter type. Both use the same names:
 *   availability_calendar or availability_calendar_viewport.
 * @param array $settings
 *   The current widget or formatter settings (to use for the default values).
 * @return array
 */
function availability_calendar_field_widget_and_formatter_settings_form($field, $instance, $widget, $type, $settings) {
  $element = array();
  $element['show_number_of_months'] = array(
    '#type' => 'textfield',
    '#title' => t('Total number of months to @show', array(
      '@show' => $widget ? t('edit') : t('show'),
    )),
    '#default_value' => $settings['show_number_of_months'],
    '#required' => TRUE,
    '#element_validate' => array(
      'element_validate_integer_positive',
    ),
  );
  if ($widget) {
    $element['show_number_of_months']['#description'] = t('The number of months to show when the calendar is being edited. Setting this larger than the number of months shown to normal visitors, allows editors to enter information into future calendar months before it is made publicly available.');
  }
  $element['first_day_of_week'] = array(
    '#type' => 'select',
    '#title' => t('First day of week'),
    '#default_value' => $settings['first_day_of_week'],
    // Use ISO-8601 week day numbers.
    '#options' => array(
      1 => t('Monday'),
      2 => t('Tuesday'),
      3 => t('Wednesday'),
      4 => t('Thursday'),
      5 => t('Friday'),
      6 => t('Saturday'),
      7 => t('Sunday'),
    ),
  );
  $element['show_week_number'] = array(
    '#type' => 'checkbox',
    '#title' => t('Show the week number before each row of the calendar'),
    '#default_value' => $settings['show_week_number'],
  );
  $element['show_only_first_letter'] = array(
    '#type' => 'checkbox',
    '#title' => t('Show only the first letter from the day of the week'),
    '#default_value' => $settings['show_only_first_letter'],
  );
  $element['show_split_day'] = array(
    '#type' => 'checkbox',
    '#title' => t('Show split day states'),
    '#description' => t('Check this option if you want to show bookings from pm to am next morning.'),
    '#default_value' => $field['settings']['allocation_type'] === AC_ALLOCATION_TYPE_OVERNIGHT && $settings['show_split_day'],
    '#access' => $field['settings']['allocation_type'] === AC_ALLOCATION_TYPE_OVERNIGHT,
  );
  if (!$widget) {
    $element['selectable'] = array(
      '#type' => 'checkbox',
      '#title' => t('Interactive'),
      '#description' => t('Check this option if you want to let users interact with the calendar by clicking on available dates.'),
      '#default_value' => $settings['selectable'],
    );
  }
  if ($type == 'availability_calendar_viewport') {
    $element['viewport'] = array(
      '#type' => 'fieldset',
      '#tree' => TRUE,
      '#title' => t('Viewport settings'),
    );
    $element['viewport']['dimensions_calculation'] = array(
      '#type' => 'radios',
      '#title' => t('Which method to use to calculate the width (and height) of the viewport'),
      '#title_display' => 'before',
      '#options' => array(
        'none' => t('None'),
        'fixed' => t('Fixed'),
        'responsive_block' => t('Available width'),
        'responsive_inline' => t('Available width minus the width of the buttons'),
      ),
      'none' => array(
        '#description' => t('You should provide the width and height in custom CSS. The number of months to show horizontally and vertically are still needed to define the animations.'),
      ),
      'fixed' => array(
        '#description' => t('The width and height are based on the number of months to show horizontally and vertically.'),
      ),
      'responsive_block' => array(
        '#description' => t('Use this option in a responsive design where the next/previous buttons are placed above or below the viewport.'),
      ),
      'responsive_inline' => array(
        '#description' => t('Use this option in a responsive design where the next/previous buttons are placed inline with the viewport.'),
      ),
      '#default_value' => $settings['viewport']['dimensions_calculation'],
      '#required' => TRUE,
    );
    $name = $widget ? 'instance[widget][settings][viewport][dimensions_calculation]' : 'fields[' . $field['field_name'] . '][settings_edit_form][settings][viewport][dimensions_calculation]';
    $element['viewport']['cols'] = array(
      '#type' => 'textfield',
      '#title' => t('Number of months to show horizontally'),
      '#description' => t('The %responsive option overrules this setting.', array(
        '%responsive' => t('Responsive'),
      )),
      '#default_value' => $settings['viewport']['cols'],
      '#required' => $settings['viewport']['dimensions_calculation'] === 'none' || $settings['viewport']['dimensions_calculation'] === 'fixed',
      '#disabled' => $settings['viewport']['dimensions_calculation'] !== 'none' && $settings['viewport']['dimensions_calculation'] !== 'fixed',
      '#states' => array(
        'required' => array(
          ":input[name='{$name}']" => array(
            array(
              'value' => 'none',
            ),
            array(
              'value' => 'fixed',
            ),
          ),
        ),
        'enabled' => array(
          ":input[name='{$name}']" => array(
            array(
              'value' => 'none',
            ),
            array(
              'value' => 'fixed',
            ),
          ),
        ),
      ),
      '#element_validate' => array(
        'element_validate_integer_positive',
      ),
    );
    $element['viewport']['rows'] = array(
      '#type' => 'textfield',
      '#title' => t('Number of months to show vertically'),
      '#default_value' => $settings['viewport']['rows'],
      '#required' => TRUE,
      '#element_validate' => array(
        'element_validate_integer_positive',
      ),
    );
    $element['viewport']['scroll'] = array(
      '#type' => 'textfield',
      '#title' => t('Number of rows or cols to scroll'),
      '#description' => t('If the number of rows is 1, the viewport will scroll horizontally, otherwise it will scroll vertically.'),
      '#default_value' => $settings['viewport']['scroll'],
      '#required' => TRUE,
      '#element_validate' => array(
        'element_validate_integer_positive',
      ),
    );
    $element['viewport']['button_placement'] = array(
      '#type' => 'select',
      '#title' => t('Button placement'),
      '#description' => t("Define where you want the have the buttons placed. If selecting '@not', you will have to define your own buttons.", array(
        '@not' => t('Not'),
      )),
      '#default_value' => $settings['viewport']['button_placement'],
      '#options' => array(
        'before' => t('Before'),
        'after' => t('After'),
        'before_after' => t('1 Before and 1 after'),
        'not' => t('Not'),
      ),
      '#required' => TRUE,
    );
  }
  if ($type == 'availability_calendar_colorbox') {
    $element['colorbox'] = array(
      '#type' => 'fieldset',
      '#tree' => TRUE,
      '#title' => t('Colorbox settings'),
    );
    $element['colorbox']['width'] = array(
      '#type' => 'textfield',
      '#title' => t('Width of the colorbox'),
      '#default_value' => $settings['colorbox']['width'],
      '#required' => FALSE,
      '#element_validate' => array(
        'availability_calendar_field_widget_and_formatter_settings_form_validate_colorbox_width',
      ),
    );
    $element['colorbox']['height'] = array(
      '#type' => 'textfield',
      '#title' => t('Height of the colorbox'),
      '#default_value' => $settings['colorbox']['height'],
      '#required' => FALSE,
      '#element_validate' => array(
        'availability_calendar_field_widget_and_formatter_settings_form_validate_colorbox_height',
      ),
    );
  }
  return $element;
}

/**
 * Form element validate callback for the width form value.
 */
function availability_calendar_field_widget_and_formatter_settings_form_validate_colorbox_width($element) {
  if (!empty($element['#value']) && preg_match('/^[0-9]+(\\.[0-9]+)?%?$/', $element['#value']) === 0) {
    form_error($element, t('Width should be a positive number or percentage.'));
  }
}

/**
 * Form element validate callback for the height form value.
 */
function availability_calendar_field_widget_and_formatter_settings_form_validate_colorbox_height($element) {
  if (!empty($element['#value']) && preg_match('/^([0-9]+(\\.[0-9]+)?%?|auto)$/', $element['#value']) === 0) {
    form_error($element, t('Height should be a positive number, a percentage, or %auto.', array(
      '%auto' => 'auto',
    )));
  }
}

/**
 * Implements hook_field_formatter_settings_summary().
 * @link http://api.drupal.org/api/drupal/modules--field_ui--field_ui.api.php/function/hook_field_formatter_settings_summary/7
 */
function availability_calendar_field_formatter_settings_summary($field, $instance, $view_mode) {
  $display = $instance['display'][$view_mode];
  $settings = $display['settings'];
  $summary = array();
  $summary[] = t('Show');
  $summary[] = format_plural($settings['show_number_of_months'], '1 month', '@count months');
  if ($display['type'] === 'availability_calendar_colorbox') {
    $summary[] = t('in a Colorbox');
  }
  else {
    if ($display['type'] === 'availability_calendar_viewport') {
      if (substr($settings['viewport']['dimensions_calculation'], 0, strlen('responsive')) === 'responsive') {
        $summary[] = t('in a responsive viewport of');
        $summary[] = format_plural($settings['viewport']['rows'], '1 row', '@count rows');
      }
      else {
        $summary[] = t('in a viewport of @count by', array(
          '@count' => $settings['viewport']['cols'],
        ));
        $summary[] = format_plural($settings['viewport']['rows'], '1 month', '@count months');
      }
    }
  }
  return implode(' ', $summary);
}

/**
 * Implements hook_field_formatter_view().
 * @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/hook_field_formatter_view/7
 */
function availability_calendar_field_formatter_view($entity_type, $entity, $field, $instance, $langcode, $items, $display) {
  module_load_include('inc', 'availability_calendar', 'availability_calendar');
  $element = array();
  $settings = $display['settings'] + $instance['settings'] + $field['settings'];
  foreach ($items as $delta => $item) {
    if ($item['enabled'] == '1') {
      $element[$delta] = array(
        '#theme' => $display['type'],
        '#settings' => $settings,
        '#langcode' => $langcode,
        '#cid' => $item['cid'],
        '#cvid' => availability_calendar_get_cvid(),
        '#name' => !empty($item['name']) ? $item['name'] : '',
      );
    }
  }
  return $element;
}

Functions

Namesort descending Description
availability_calendar_field_attach_submit Implements hook_field_attach_submit. @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/...
availability_calendar_field_formatter_info Implements hook_field_formatter_info(). @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/...
availability_calendar_field_formatter_settings_form Implements hook_field_formatter_settings_form(). @link http://api.drupal.org/api/drupal/modules--field_ui--field_ui.api.php/fun...
availability_calendar_field_formatter_settings_summary Implements hook_field_formatter_settings_summary(). @link http://api.drupal.org/api/drupal/modules--field_ui--field_ui.api.php/fun...
availability_calendar_field_formatter_view Implements hook_field_formatter_view(). @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/...
availability_calendar_field_info Implements hook_field_info(). @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/...
availability_calendar_field_instance_settings_form Implements hook_field_instance_settings_form(). @link http://api.drupal.org/api/drupal/modules--field_ui--field_ui.api.php/fun...
availability_calendar_field_is_empty Implements hook_field_is_empty(). @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/...
availability_calendar_field_settings_form Implements hook_field_settings_form(). @link http://api.drupal.org/api/drupal/modules--field_ui--field_ui.api.php/fun...
availability_calendar_field_validate Implements hook_field_validate(). @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/...
availability_calendar_field_widget_and_formatter_settings_form Returns the common elements for the widget and formatter settings forms.
availability_calendar_field_widget_and_formatter_settings_form_validate_colorbox_height Form element validate callback for the height form value.
availability_calendar_field_widget_and_formatter_settings_form_validate_colorbox_width Form element validate callback for the width form value.
availability_calendar_field_widget_form Implements hook_field_widget_form(). @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/...
availability_calendar_field_widget_info Implements hook_field_widget_info. @link http://api.drupal.org/api/drupal/modules--field--field.api.php/function/...
availability_calendar_field_widget_settings_form Implements hook_field_widget_settings_form @link http://api.drupal.org/api/drupal/modules--field_ui--field_ui.api.php/fun...