function views_php_form_element in Views PHP 7.2

Same name and namespace in other branches

1. 8 views_php.module \views_php_form_element()
2. 6 views_php.module \views_php_form_element()
3. 7 views_php.module \views_php_form_element()

Helper function; builds form for PHP code options of views handlers/plugins.

6 calls to views_php_form_element()

views_php_handler_area::options_form in plugins/views/views_php_handler_area.inc

Implements views_handler#option_definition().

views_php_handler_field::options_form in plugins/views/views_php_handler_field.inc

Implements views_handler#options_form().

views_php_handler_filter::options_form in plugins/views/views_php_handler_filter.inc

Implements views_handler#option_definition().

views_php_handler_sort::options_form in plugins/views/views_php_handler_sort.inc

Implements views_handler#option_definition().

views_php_plugin_access::options_form in plugins/views/views_php_plugin_access.inc

Implements views_plugin#options_form().

... See full list

File

./views_php.module, line 44

Allows to use PHP in views.

Code

function views_php_form_element($handler, $checkbox = FALSE, $input, $variables = array()) {
  static $default_variables;
  if (!isset($default_variables)) {
    $default_variables = array(
      '$view' => t('The view object.'),
      '$handler' => t('The handler object.'),
      '$plugin' => t('The plugin object.'),
      '$static' => t('A variable that can be used to store reusable data per row.'),
      '$row' => t('Contains the retrieved record from the database per row.'),
      '$data' => t('Contains the retrieved record from the database for all rows.'),
      '$results' => t('Array containing the view\'s result.'),
      '$cache' => t('The cache object.'),
    );
  }
  list($name, $title, $description, $use_delimiters) = $input;
  $container = array(
    '#type' => 'container',
    // @todo #tree => FALSE doesn't work here.
    '#parents' => array(
      'options',
    ),
  );
  if (!empty($checkbox)) {
    list($checkbox_name, $checkbox_title, $checkbox_description) = $checkbox;
    $checkbox = array(
      '#type' => 'checkbox',
      '#title' => $checkbox_title,
      '#description' => $checkbox_description,
      '#default_value' => $handler->options[$checkbox_name] && !empty($handler->options[$name]),
    );
    $container['#states'] = array(
      'invisible' => array(
        'input[name="options[use_' . $name . ']"]' => array(
          'checked' => FALSE,
        ),
      ),
    );
  }
  $container[$name] = array(
    '#type' => 'textarea',
    '#id' => drupal_html_id('edit-options-' . $name),
    '#title' => $title,
    '#default_value' => $handler->options[$name],
    '#rows' => 5,
    '#description' => $description . ' <strong>' . ($use_delimiters ? t('Use &lt;?php ?&gt; delimiters to enclose PHP code.') : t('Do not use &lt;?php ?&gt; delimiters.')) . '</strong>',
  );

  // Only users with use PHP permission can set/modify input.
  if (!user_access('use PHP for settings')) {
    $container[$name]['#disabled'] = TRUE;
    $container[$name]['#value'] = $container[$name]['#default_value'];
    $container[$name]['#description'] .= ' <strong>' . t('You do not have permission to modify this.') . '</strong>';
  }
  $items = array();
  foreach ($variables as $variable_name => $description) {
    if (is_int($variable_name)) {
      $variable_name = $description;
      $description = isset($default_variables[$description]) ? $default_variables[$description] : '';
    }
    $items[] = l($variable_name, '', array(
      'fragment' => $container[$name]['#id'],
      'external' => TRUE,
    )) . ': ' . $description;
    if (strpos($variable_name, '$row') === 0) {
      $php_value = $input[0] == 'php_value' ? true : false;
      foreach ($handler->view->display_handler
        ->get_handlers('field') as $field => $field_handler) {

        // Do not add fields that will not have data when evaluating the value code. This occurs because
        // the value code is evaluated in hook_views_post_execute(), but field data is made available in hook_views_pre_render(),
        // which is called after hook_views_post_execute().
        if ($php_value && $field_handler->table != $field_handler->view->base_table) {
          continue;
        }
        $items[] = l($variable_name . '->' . $field, '', array(
          'fragment' => $container[$name]['#id'],
          'external' => TRUE,
        )) . ': ' . $field_handler
          ->ui_name();
      }
    }
  }
  $container[$name . '_variables'] = array(
    '#type' => 'fieldset',
    '#title' => t('Available variables'),
    '#collapsible' => TRUE,
    '#collapsed' => TRUE,
    '#attributes' => array(
      'class' => array(
        'views-php-variables',
      ),
    ),
    '#attached' => array(
      'js' => array(
        drupal_get_path('module', 'views_php') . '/views_php.js',
      ),
    ),
  );
  $container[$name . '_variables']['variables'] = array(
    '#theme' => 'item_list',
    '#items' => $items,
  );
  if (!empty($checkbox)) {
    return array(
      $checkbox_name => $checkbox,
      $name => $container,
    );
  }
  return array(
    $name => $container,
  );
}