You are here

wymeditor.inc in Wysiwyg 5.2

Same filename and directory in other branches
  1. 6.2 editors/wymeditor.inc
  2. 7.2 editors/wymeditor.inc

Editor integration functions for WYMeditor.

File

editors/wymeditor.inc
View source
<?php

/**
 * @file
 * Editor integration functions for WYMeditor.
 */

/**
 * Plugin implementation of hook_editor().
 */
function wysiwyg_wymeditor_editor() {
  $editor['wymeditor'] = array(
    'title' => 'WYMeditor',
    'vendor url' => 'http://www.wymeditor.org/',
    'download url' => 'http://www.wymeditor.org/download/',
    'library path' => wysiwyg_get_path('wymeditor') . '/wymeditor',
    'libraries' => array(
      'min' => array(
        'title' => 'Minified',
        'files' => array(
          'jquery.wymeditor.min.js',
        ),
      ),
      'pack' => array(
        'title' => 'Packed',
        'files' => array(
          'jquery.wymeditor.pack.js',
        ),
      ),
      'src' => array(
        'title' => 'Source',
        'files' => array(
          'jquery.wymeditor.js',
        ),
      ),
    ),
    'version callback' => 'wysiwyg_wymeditor_version',
    'themes callback' => 'wysiwyg_wymeditor_themes',
    'settings callback' => 'wysiwyg_wymeditor_settings',
    'plugin callback' => 'wysiwyg_wymeditor_plugins',
    'versions' => array(
      '0.5-rc1' => array(
        'js files' => array(
          'wymeditor.js',
        ),
      ),
    ),
  );
  return $editor;
}

/**
 * Detect editor version.
 *
 * @param $editor
 *   An array containing editor properties as returned from hook_editor().
 *
 * @return
 *   The installed editor version.
 */
function wysiwyg_wymeditor_version($editor) {
  $script = $editor['library path'] . '/jquery.wymeditor.js';
  if (!file_exists($script)) {
    return;
  }
  $script = fopen($script, 'r');
  fgets($script);
  $line = fgets($script);
  if (preg_match('@version\\s+([0-9a-z\\.-]+)@', $line, $version)) {
    fclose($script);
    return $version[1];
  }
  fclose($script);
}

/**
 * Determine available editor themes or check/reset a given one.
 *
 * @param $editor
 *   A processed hook_editor() array of editor properties.
 * @param $profile
 *   A wysiwyg editor profile.
 *
 * @return
 *   An array of theme names. The first returned name should be the default
 *   theme name.
 */
function wysiwyg_wymeditor_themes($editor, $profile) {
  return array(
    'compact',
    'default',
    'minimal',
    'silver',
    'twopanels',
  );
}

/**
 * Return runtime editor settings for a given wysiwyg profile.
 *
 * @param $editor
 *   A processed hook_editor() array of editor properties.
 * @param $config
 *   An array containing wysiwyg editor profile settings.
 * @param $theme
 *   The name of a theme/GUI/skin to use.
 *
 * @return
 *   A settings array to be populated in
 *   Drupal.settings.wysiwyg.configs.{editor}
 */
function wysiwyg_wymeditor_settings($editor, $config, $theme) {

  // @todo Setup $library in wysiwyg_load_editor() already.
  $library = isset($editor['library']) ? $editor['library'] : key($editor['libraries']);
  $settings = array(
    'basePath' => base_path() . $editor['library path'] . '/',
    'wymPath' => $editor['libraries'][$library]['files'][0],
    // @todo Does not work in Drupal; jQuery can live anywhere.
    'jQueryPath' => base_path() . 'misc/jquery.js',
    'updateSelector' => '.form-submit',
    'skin' => $theme,
  );
  if (isset($config['language'])) {
    $settings['lang'] = $config['language'];
  }

  // Add configured buttons.
  $settings['toolsItems'] = array();
  if (!empty($config['buttons'])) {
    $buttoninfo = _wysiwyg_wymeditor_button_info();
    $plugins = wysiwyg_get_plugins($editor['name']);
    foreach ($config['buttons'] as $plugin => $buttons) {
      foreach ($buttons as $button => $enabled) {

        // Iterate separately over buttons and extensions properties.
        foreach (array(
          'buttons',
          'extensions',
        ) as $type) {

          // Skip unavailable plugins.
          if (!isset($plugins[$plugin][$type][$button])) {
            continue;
          }

          // Add buttons.
          if ($type == 'buttons') {

            // Merge meta-data for internal default buttons.
            if (isset($buttoninfo[$button])) {
              $buttoninfo[$button] += array(
                'name' => $button,
              );
              $settings['toolsItems'][] = $buttoninfo[$button];
            }
            else {
              $settings['toolsItems'][] = array(
                'name' => $button,
                'title' => $plugins[$plugin][$type][$button],
                'css' => 'wym_tools_' . $button,
              );
            }
          }
        }
      }
    }
  }
  if (!empty($config['block_formats'])) {
    $containers = array(
      'p' => 'Paragraph',
      'h1' => 'Heading_1',
      'h2' => 'Heading_2',
      'h3' => 'Heading_3',
      'h4' => 'Heading_4',
      'h5' => 'Heading_5',
      'h6' => 'Heading_6',
      'pre' => 'Preformatted',
      'blockquote' => 'Blockquote',
      'th' => 'Table_Header',
    );
    foreach (explode(',', $config['block_formats']) as $tag) {
      if (isset($containers[$tag])) {
        $settings['containersItems'][] = array(
          'name' => strtoupper($tag),
          'title' => $containers[$tag],
          'css' => 'wym_containers_' . $tag,
        );
      }
    }
  }
  if (isset($config['css_setting'])) {
    if ($config['css_setting'] == 'theme') {

      // WYMeditor only supports one CSS file currently.
      $css = wysiwyg_get_css();
      $settings['stylesheet'] = reset($css);
    }
    else {
      if ($config['css_setting'] == 'self' && isset($config['css_path'])) {
        $settings['stylesheet'] = strtr($config['css_path'], array(
          '%b' => base_path(),
          '%t' => path_to_theme(),
        ));
      }
    }
  }
  return $settings;
}

/**
 * Return internal plugins for this editor; semi-implementation of hook_wysiwyg_plugin().
 */
function wysiwyg_wymeditor_plugins($editor) {
  $plugins = array(
    'default' => array(
      'buttons' => array(
        'Bold' => t('Bold'),
        'Italic' => t('Italic'),
        'InsertOrderedList' => t('Numbered list'),
        'InsertUnorderedList' => t('Bullet list'),
        'Outdent' => t('Outdent'),
        'Indent' => t('Indent'),
        'Undo' => t('Undo'),
        'Redo' => t('Redo'),
        'CreateLink' => t('Link'),
        'Unlink' => t('Unlink'),
        'InsertImage' => t('Image'),
        'Superscript' => t('Superscript'),
        'Subscript' => t('Subscript'),
        'ToggleHtml' => t('Source code'),
        'Paste' => t('Paste'),
        'InsertTable' => t('Table'),
        'Preview' => t('Preview'),
      ),
      'internal' => TRUE,
    ),
  );
  return $plugins;
}

/**
 * Helper function to provide additional meta-data for internal default buttons.
 */
function _wysiwyg_wymeditor_button_info() {
  return array(
    'Bold' => array(
      'title' => 'Strong',
      'css' => 'wym_tools_strong',
    ),
    'Italic' => array(
      'title' => 'Emphasis',
      'css' => 'wym_tools_emphasis',
    ),
    'Superscript' => array(
      'title' => 'Superscript',
      'css' => 'wym_tools_superscript',
    ),
    'Subscript' => array(
      'title' => 'Subscript',
      'css' => 'wym_tools_subscript',
    ),
    'InsertOrderedList' => array(
      'title' => 'Ordered_List',
      'css' => 'wym_tools_ordered_list',
    ),
    'InsertUnorderedList' => array(
      'title' => 'Unordered_List',
      'css' => 'wym_tools_unordered_list',
    ),
    'Indent' => array(
      'title' => 'Indent',
      'css' => 'wym_tools_indent',
    ),
    'Outdent' => array(
      'title' => 'Outdent',
      'css' => 'wym_tools_outdent',
    ),
    'Undo' => array(
      'title' => 'Undo',
      'css' => 'wym_tools_undo',
    ),
    'Redo' => array(
      'title' => 'Redo',
      'css' => 'wym_tools_redo',
    ),
    'CreateLink' => array(
      'title' => 'Link',
      'css' => 'wym_tools_link',
    ),
    'Unlink' => array(
      'title' => 'Unlink',
      'css' => 'wym_tools_unlink',
    ),
    'InsertImage' => array(
      'title' => 'Image',
      'css' => 'wym_tools_image',
    ),
    'InsertTable' => array(
      'title' => 'Table',
      'css' => 'wym_tools_table',
    ),
    'Paste' => array(
      'title' => 'Paste_From_Word',
      'css' => 'wym_tools_paste',
    ),
    'ToggleHtml' => array(
      'title' => 'HTML',
      'css' => 'wym_tools_html',
    ),
    'Preview' => array(
      'title' => 'Preview',
      'css' => 'wym_tools_preview',
    ),
  );
}

Functions

Namesort descending Description
wysiwyg_wymeditor_editor Plugin implementation of hook_editor().
wysiwyg_wymeditor_plugins Return internal plugins for this editor; semi-implementation of hook_wysiwyg_plugin().
wysiwyg_wymeditor_settings Return runtime editor settings for a given wysiwyg profile.
wysiwyg_wymeditor_themes Determine available editor themes or check/reset a given one.
wysiwyg_wymeditor_version Detect editor version.
_wysiwyg_wymeditor_button_info Helper function to provide additional meta-data for internal default buttons.