class FrxInclude in Forena Reports 7.4

@file FrxInclude Include a reference to another report as an asset. @author davidmetzler

Hierarchy

• class \FrxRenderer
  • class \FrxInclude

2 string references to 'FrxInclude'

forena_forena_controls in ./forena.module

Self register controls with forena.

FrxInclude::generate in renderers/FrxInclude.inc

Implement template generator.

File

renderers/FrxInclude.inc, line 8

FrxInclude Include a reference to another report as an asset. @author davidmetzler

class FrxInclude extends FrxRenderer {
  public function render() {

    // Get data from source
    $attributes = $this
      ->mergedAttributes();
    $output = '';

    // Determine data type
    $include = @$attributes['src'];
    $title = @$attributes['title'];

    // Quit if we have no data.
    if (!$include) {
      return '';
    }

    // Reformat URL
    @(list($url, $query_str) = @explode('?', $include));
    $url = $this->teng
      ->replace($url, TRUE);
    $report_url = $url;
    $parts = @explode('/', $url);
    $file = @$parts[count($parts) - 1];
    $parts = explode('.', $file);

    // Determine file extention
    $ext = count($parts) > 1 ? $parts[count($parts) - 1] : '';
    $query = array();
    if ($query_str) {
      parse_str($query_str, $query);
      foreach ($query as $key => $value) {
        $query[$key] = $this->teng
          ->replace($value, TRUE);
      }
    }

    // Build URL
    $options = array(
      'query' => $query,
    );
    $url = url($url, $options);
    $mode = isset($attributes['mode']) ? $attributes['mode'] : '';
    if (!$mode) {

      // Try and default in old method for loading.
      if ($this->format == 'web' && strlen($ext) <= 4) {
        $mode = 'reference';
      }
    }
    switch ($mode) {
      case 'ajax':
        if (strpos($url, '/nojs/') === FALSE) {
          if (!isset($attributes['id'])) {
            $attributes['id'] = 'frx-include';
          }
          $id = @$attributes['id'];
          $url = url("{$report_url}/nojs/{$id}/replace", $options);
          if (isset($attributes['class'])) {
            $attributes['class'] .= ' use-ajax forena-autoload';
          }
          else {
            $attributes['class'] = 'use-ajax forena-autoload';
          }
        }
        $output = $this
          ->render_reference($url, $ext, $attributes, $title);
        break;
      case 'reference':
        $output = $this
          ->render_reference($url, $ext, $attributes, $title);
        break;
      case 'inline':
      default:
        $output = forena_report_include(str_replace('reports/', '', $report_url), $query);
    }
    return $output;
  }
  function render_reference($url, $ext, $attributes, $title) {
    $ext = strtolower($ext);
    if (!$title) {
      $title = "{$ext} document";
    }
    $attributes = $this->teng
      ->replace($attributes);
    switch ($ext) {
      case 'png':
      case 'gif':
      case 'jpg':
      case 'jpeg':
        $x = new SimpleXMLElement('<img/>');
        $x['src'] = $url;
        if (isset($attributes['height'])) {
          $x['height'] = $attributes['height'];
        }
        if (isset($attributes['width'])) {
          $x['width'] = $attributes['width'];
        }
        break;
      case 'svg':
        $x = new SimpleXMLElement('<embed/>');
        $x['src'] = $url;
        $x['type'] = 'image/svg+xml';
        $x['pluginspage'] = "http://www.adobe.com/svg/viewer/install/";
        if (isset($attributes['height'])) {
          $x['height'] = $attributes['height'];
        }
        if (isset($attributes['width'])) {
          $x['width'] = $attributes['width'];
        }
        break;
      default:
        $x = new SimpleXMLElement('<a>' . htmlentities($title, ENT_QUOTES, 'UTF-8') . '</a>');
        $x['href'] = $url;
    }
    if (isset($attributes['id'])) {
      $x['id'] = $attributes['id'];
    }
    if (isset($attributes['class'])) {
      $x['class'] = $attributes['class'];
    }
    return $x
      ->asXML();
  }

  /**
   * Implement template generator.
   * @see FrxRenderer::generate()
   */
  public function generate($xml, &$config) {
    $src = $this
      ->extract('src', $key);
    $div = $this
      ->blockDiv($config);
    $frx = array(
      'src' => $src,
      'renderer' => 'FrxInclude',
    );
    $this
      ->addNode($div, 4, 'div', NULL, $config, $frx);
  }

}

Members

Name	Modifiers	Type	Description	Overrides
FrxInclude::generate	public	function	Implement template generator. Overrides FrxRenderer::generate
FrxInclude::render	public	function	Default Render action, which simply does normal forena rendering. You can use renderDomNode at any time to generate the default forena rendering methods. Overrides FrxRenderer::render
FrxInclude::render_reference		function
FrxRenderer::$blockName	public	property
FrxRenderer::$blockParms	public	property
FrxRenderer::$columns	public	property
FrxRenderer::$dataProvider	public	property
FrxRenderer::$doc_types	public	property
FrxRenderer::$dom	public	property
FrxRenderer::$format	public	property
FrxRenderer::$frxAttributes	public	property
FrxRenderer::$frxReport	public	property	@var FrxReport
FrxRenderer::$htmlAttributes	public	property
FrxRenderer::$id	public	property
FrxRenderer::$input_format	public	property
FrxRenderer::$name	public	property
FrxRenderer::$numeric_columns	public	property
FrxRenderer::$reportDocDomNode	public	property
FrxRenderer::$reportDocNode	public	property
FrxRenderer::$teng	public	property
FrxRenderer::$xmlns	public	property
FrxRenderer::$xpathQuery	public	property
FrxRenderer::addAttributes	public static	function	Helper function for convergint methods to a standard associated array.
FrxRenderer::addFragment		function	Append a textual XHTML fragment to the dom. We do not use the DOMDocumentFragment optioin because they don't properly import namespaces. .
FrxRenderer::addNode		function	Add a node to the existing dom element with attributes
FrxRenderer::addText		function	Add a text node to the current dom node.
FrxRenderer::arrayAttributes	public	function	Puts attributes back in array format prior to rendering.
FrxRenderer::blockDiv	public	function	Generate generic div tag.
FrxRenderer::columns	public	function	Extract a list of columns from the data context.
FrxRenderer::configAjax	public	function	Generate ajax configuration attributes for use in template configurtion forms.
FrxRenderer::configForm	public	function	Returns the section Enter description here ...	7
FrxRenderer::configValidate	public	function	Default configuration validator. Simply validates header and footer attributes.	7
FrxRenderer::drupalRender	public	function	Render a drupal form in a forena template
FrxRenderer::extract	public	function	Extract a configuration var removing it from the array
FrxRenderer::extractChildSource	public	function	Get the textual representations of html for the configuration engine.
FrxRenderer::extractSource	public	function	Get the textual representations of html for the configuration engine.
FrxRenderer::extractTemplateHTML	public	function	Get the textual representations of html for the configuration engine.
FrxRenderer::extractXPath	public	function	Extracts the inner html of all nodes that match a particular xpath expression.
FrxRenderer::extractXPathInnerHTML	public	function	Extracts the inner html of all nodes that match a particular xpath expression.
FrxRenderer::idFromBlock	public	function	Simple function to get id from node.
FrxRenderer::initReportNode	public	function	This function is called to give the renderer the current conetxt in report rendering. It makes sure the renderer has the current DOM nodes dom documnent, and other attributes.
FrxRenderer::innerXML	public	function	Return the inside xml of the current node
FrxRenderer::mergedAttributes	public	function	Standard php array containing merged attributes Enter description here ...
FrxRenderer::removeChildren	public	function	Rmove all the children of a dom node in the current report.
FrxRenderer::removeChildrenExcept	public	function	Removes all chidren from the dome node expect those with a tagname specified by the the $tags argurment
FrxRenderer::renderChildren	public	function
FrxRenderer::renderDomNode	public	function	Recursive report renderer Walks the nodes rendering the report.
FrxRenderer::replacedAttributes	public	function	Gives the token replaced attributes of a node.
FrxRenderer::replaceTokens	public	function	A helper function to allow replacement of tokens from inside a renderer wihout needing to understand the object
FrxRenderer::resetTemplate	public	function	Starting at the current report node, this function removes all child nodes. It aso removes any FRX attributes on the current as well.
FrxRenderer::scrapeConfig	public	function	Default method for extracting configuration information from the template. This just scrapes teh current child html as the template.	7
FrxRenderer::setAttributes	public	function	Set FRX attributes.
FrxRenderer::setFirstNode	public	function	Sets the first child element to a node and returns it. IF the node
FrxRenderer::validateTextFormats	public	function	Helper funciton for validating text_format type controls.
FrxRenderer::weight_sort	public	function	Sort a column list by weight.
FrxRenderer::weight_sort_comp	public static	function
FrxRenderer::xmlToValues	public	function	Convert XML to key value pairs. This is used in support of graping to get specific key/value pairs in an array format suitable for passing off to php libraries.
FrxRenderer::__construct	public	function		2