function swfobject2_swftools_embed in SWF Tools 6.2

Same name and namespace in other branches

1. 5 swfobject2/swfobject2.module \swfobject2_swftools_embed()
2. 6 swfobject2/swfobject2.module \swfobject2_swftools_embed()

Implementation of swftools_embed hook Returns the markup for the page, plus set necessary javascript.

$methods and $vars should never be empty - unless the only reason for this call is to push the javascript into the header of the page in which case you don't add any paramters as all. This is useful for filtered nodes where the body is not regenerated every time.

File

swfobject2/swfobject2.module, line 35

Code

function swfobject2_swftools_embed($action = 'add_js', $methods = FALSE, $vars = FALSE, $html_alt = '') {

  // Set flag to indicate if the javascript has been added to the header
  static $swfobject2_has_run;

  // Output JavaScript to the header to load the SWF Object code
  if (!$swfobject2_has_run) {

    // Find out if swfobject2 is available locally and add script accordingly
    if (!swfobject2_available_locally()) {

      // We have to add script directly to the head as drupal_add_js can't handle external scripts (drupal.org/node/91250)
      drupal_set_html_head('<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/swfobject/2.2/swfobject.js"></script>');
    }
    else {

      // Add the local script library when it is present
      drupal_add_js(swftools_get_player_path() . '/swfobject2/swfobject.js');
    }

    // Set flag to show script is in place
    $swfobject2_has_run = TRUE;

    // If this is all that is being done then return here
    if ($action == 'add_js') {
      return;
    }
  }

  // Initialise a counter to give each div a unique id
  static $unique_id = 0;
  $unique_id++;

  // Construct a unique id for each div by using time() combined with $unique_id
  // This is necessary to prevent clashes between cached content
  $id = time() . $unique_id;

  // Anything in $vars->params will be output - we don't want src_path
  unset($vars->params['src_path']);

  // Unset flashvars string - we can use the array format and let drupal_to_js handle things
  unset($vars->params['flashvars']);

  // See if we should make the player accessible
  $accessible_html = swfobject2_wijering4_accessible($methods->player['name'], $vars, 'swf' . $id);

  // Generate js string ready for output to the page header
  // swfObject takes parameters swfURL, id, width, height, version, expressinstall, flashvars, params, attributes
  // At the moment expressInstall isn't enabled
  $swf_js = t('swfobject.embedSWF("!url", "!id", "!width", "!height", "!version", "", !flashvars, !params, !attributes);', array(
    '!url' => $vars->params['src'],
    '!id' => 'swfobject2-id-' . $id,
    '!width' => $vars->params['width'],
    '!height' => $vars->params['height'],
    '!version' => $vars->params['version'],
    '!flashvars' => drupal_to_js($vars->flashvars),
    '!params' => drupal_to_js($vars->params),
    '!attributes' => drupal_to_js(array(
      'id' => 'swf' . $id,
    )),
  ));

  // Generate the html markup ready to receive the substitution
  $html = '<div id="swfobject2-id-' . $id . '" class="swftools swfobject2">' . "\n";
  $html .= $html_alt . "\n";
  $html .= '</div>' . "\n";

  // Although SWF Object 2 recommends adding js to the page header that will prevent cached filters being used
  // So we add js to the page body in order that it gets cached too
  $html .= '<script type="text/javascript">' . "\n";
  $html .= $swf_js . "\n";
  $html .= '</script>' . "\n";
  $html .= $accessible_html;

  // Return html markup
  return $html;
}