You are here

Home » API reference » Views (for Drupal 7) 7.3 » views_plugin_localization.inc

class views_plugin_localization in Views (for Drupal 7) 7.3

Same name and namespace in other branches
  1. 6.3 plugins/views_plugin_localization.inc \views_plugin_localization

The base plugin to handle localization of Views strings.

Hierarchy

Expanded class hierarchy of views_plugin_localization

Related topics

Views localization plugins
@todo.
1 string reference to 'views_plugin_localization'
views_views_plugins in includes/plugins.inc
Implements hook_views_plugins().

File

plugins/views_plugin_localization.inc, line 19
Definition of views_plugin_localization.

View source 
class views_plugin_localization extends views_plugin {

  /**
   * Store for exported strings.
   */
  public $export_strings = array();

  /**
   *
   */
  public $translate = TRUE;

  /**
   * Initialize the plugin.
   *
   * @param view $view
   *   The view object.
   */
  public function init(&$view) {
    $this->view =& $view;
  }

  /**
   * Translate a string / text with format.
   *
   * The $source parameter is an array with the following elements:
   * - value, source string
   * - format, input format in case the text has some format to be applied
   * - keys. An array of keys to identify the string. Generally constructed from
   *   view name, display_id, and a property, e.g., 'header'.
   *
   * @param string $source
   *   Full data for the string to be translated.
   *
   * @return string
   *   Translated string / text.
   */
  public function translate($source) {

    // Allow other modules to make changes to the string before and after
    // translation.
    $source['pre_process'] = $this
      ->invoke_translation_process($source, 'pre');
    $source['translation'] = $this
      ->translate_string($source['value'], $source['keys'], $source['format']);
    $source['post_process'] = $this
      ->invoke_translation_process($source, 'post');
    return $source['translation'];
  }

  /**
   * Translate a string.
   *
   * @param string $string
   *   The string to be translated.
   * @param array $keys
   *   An array of keys to identify the string. Generally constructed from
   *   view name, display_id, and a property, e.g. 'header'.
   * @param string $format
   *   The input format of the string. This is optional.
   */
  public function translate_string($string, $keys = array(), $format = '') {
  }

  /**
   * Save string source for translation.
   *
   * @param string $source
   *   Full data for the string to be translated.
   */
  public function save($source) {

    // Allow other modules to make changes to the string before saving.
    $source['pre_process'] = $this
      ->invoke_translation_process($source, 'pre');
    $this
      ->save_string($source['value'], $source['keys'], isset($source['format']) ? $source['format'] : '');
  }

  /**
   * Save a string for translation.
   *
   * @param string $string
   *   The string to be translated.
   * @param array $keys
   *   An array of keys to identify the string. Generally constructed from
   *   view name, display_id, and a property, e.g., 'header'.
   * @param string $format
   *   The input format of the string. This is optional.
   */
  public function save_string($string, $keys = array(), $format = '') {
  }

  /**
   * Delete a string.
   *
   * @param string $source
   *   Full data for the string to be translated.
   */
  public function delete($source) {
  }

  /**
   * Collect strings to be exported to code.
   *
   * @param string $source
   *   Full data for the string to be translated.
   */
  public function export($source) {
  }

  /**
   * Render any collected exported strings to code.
   *
   * @param string $indent
   *   An optional indentation for prettifying nested code.
   */
  public function export_render($indent = '  ') {
  }

  /**
   * Invoke hook_translation_pre_process() or hook_translation_post_process().
   *
   * Like node_invoke_nodeapi(), this function is needed to enable both passing
   * by reference and fetching return values.
   */
  public function invoke_translation_process(&$value, $op) {
    $return = array();
    $hook = 'translation_' . $op . '_process';
    foreach (module_implements($hook) as $module) {
      $function = $module . '_' . $hook;
      $result = $function($value);
      if (isset($result)) {
        $return[$module] = $result;
      }
    }
    return $return;
  }

  /**
   *
   */
  public function process_locale_strings($op) {
    $this->view
      ->init_display();
    foreach ($this->view->display as $display_id => $display) {
      $translatable = array();

      // Special handling for display title.
      if (isset($display->display_title)) {
        $translatable[] = array(
          'value' => $display->display_title,
          'keys' => array(
            'display_title',
          ),
        );
      }

      // Unpack handlers.
      if (is_object($this->view->display[$display_id]->handler)) {
        $this->view->display[$display_id]->handler
          ->unpack_translatables($translatable);
      }
      foreach ($translatable as $data) {
        $data['keys'] = array_merge(array(
          $this->view->name,
          $display_id,
        ), $data['keys']);
        switch ($op) {
          case 'save':
            $this
              ->save($data);
            break;
          case 'delete':
            $this
              ->delete($data);
            break;
          case 'export':
            $this
              ->export($data);
            break;
        }
      }
    }
  }

}

Members

Namesort descending Modifiers Type Description Overrides
views_object::$definition public property Handler's definition.
views_object::$options public property Except for displays, options for the object will be held here. 1
views_object::altered_option_definition function Collect this handler's option definition and alter them, ready for use.
views_object::construct public function Views handlers use a special construct function. 4
views_object::destroy public function Destructor. 2
views_object::export_option public function 1
views_object::export_options public function
views_object::export_option_always public function Always exports the option, regardless of the default value.
views_object::options Deprecated public function Set default options on this object. 1
views_object::option_definition public function Information about options for all kinds of purposes will be held here. 13
views_object::set_default_options public function Set default options.
views_object::set_definition public function Let the handler know what its full definition is.
views_object::unpack_options public function Unpack options over our existing defaults, drilling down into arrays so that defaults don't get totally blown away.
views_object::unpack_translatable public function Unpack a single option definition.
views_object::unpack_translatables public function Unpacks each handler to store translatable texts.
views_object::_set_option_defaults public function
views_plugin::$display public property The current used views display.
views_plugin::$plugin_name public property The plugin name of this plugin, for example table or full.
views_plugin::$plugin_type public property The plugin type of this plugin, for example style or query.
views_plugin::$view public property The top object of a view. Overrides views_object::$view 1
views_plugin::additional_theme_functions public function Provide a list of additional theme functions for the theme info page.
views_plugin::options_form public function Provide a form to edit options for this plugin. 13
views_plugin::options_submit public function Handle any special handling on the validate form. 9
views_plugin::options_validate public function Validate the options form. 10
views_plugin::plugin_title public function Return the human readable name of the display.
views_plugin::query public function Add anything to the query that we might need to. 7
views_plugin::summary_title public function Returns the summary of the settings in the display. 8
views_plugin::theme_functions public function Provide a full list of possible theme templates used by this style.
views_plugin::validate public function Validate that the plugin is correct and can be saved. 3
views_plugin_localization::$export_strings public property Store for exported strings.
views_plugin_localization::$translate public property 2
views_plugin_localization::delete public function Delete a string. 2
views_plugin_localization::export public function Collect strings to be exported to code. 2
views_plugin_localization::export_render public function Render any collected exported strings to code. 1
views_plugin_localization::init public function Initialize the plugin.
views_plugin_localization::invoke_translation_process public function Invoke hook_translation_pre_process() or hook_translation_post_process().
views_plugin_localization::process_locale_strings public function
views_plugin_localization::save public function Save string source for translation. 1
views_plugin_localization::save_string public function Save a string for translation. 1
views_plugin_localization::translate public function Translate a string / text with format. 2
views_plugin_localization::translate_string public function Translate a string. 2