HTMLPurifier_Printer_ConfigForm Class Reference

Inheritance diagram for HTMLPurifier_Printer_ConfigForm:

Collaboration diagram for HTMLPurifier_Printer_ConfigForm:

Public Member Functions
	__construct ( $name, $doc_url=null, $compress=false)
	setTextareaDimensions ($cols=null, $rows=null)
	Sets default column and row size for textareas in sub-printers. More...
	render ($config, $allowed=true, $render_controls=true)
	Returns HTML output for a configuration form. More...
Public Member Functions inherited from HTMLPurifier_Printer
	__construct ()
	Initialize $generator. More...
	prepareGenerator ($config)
	Give generator necessary configuration if possible. More...

Static Public Member Functions
static	getCSS ()
	Retrieves styling, in case it is not accessible by webserver. More...
static	getJavaScript ()
	Retrieves JavaScript, in case it is not accessible by webserver. More...

Protected Member Functions
	renderNamespace ($ns, $directives)
	Renders a single namespace. More...
Protected Member Functions inherited from HTMLPurifier_Printer
	start ($tag, $attr=array())
	Main function that renders object or aspect of that object. More...
	end ($tag)
	Returns an end tag. More...
	element ($tag, $contents, $attr=array(), $escape=true)
	Prints a complete element with content inside. More...
	elementEmpty ($tag, $attr=array())
	text ($text)
	row ($name, $value)
	Prints a simple key/value row in a table. More...
	escape ($string)
	Escapes a string for HTML output. More...
	listify ($array, $polite=false)
	Takes a list of strings and turns them into a single list. More...
	getClass ($obj, $sec_prefix='')
	Retrieves the class of an object without prefixes, as well as metadata. More...

Protected Attributes
	$fields = array()
	Printers for specific fields. More...
	$docURL
	Documentation URL, can have fragment tagged on end. More...
	$name
	Name of form element to stuff config in. More...
	$compress = false
	Whether or not to compress directive names, clipping them off after a certain amount of letters. More...
Protected Attributes inherited from HTMLPurifier_Printer
	$generator
	For HTML generation convenience funcs. More...
	$config
	For easy access. More...

Detailed Description

Todo:

Rewrite to use Interchange objects

Definition at line 6 of file ConfigForm.php.

Constructor & Destructor Documentation

__construct()

HTMLPurifier_Printer_ConfigForm::__construct	(		$name,
			$doc_url = null,
			$compress = false
	)

Parameters

string	$name	Form element name for directives to be stuffed into
string	$doc_url	String documentation URL, will have fragment tagged on
bool	$compress	Integer max length before compressing a directive name, set to false to turn off

Definition at line 40 of file ConfigForm.php.

References $compress, $name, HTMLPurifier_VarParser\C_BOOL, and fields.

      {
        parent::__construct();
        $this->docURL = $doc_url;
        $this->name = $name;
        $this->compress = $compress;
        // initialize sub-printers
        $this->fields[0] = new HTMLPurifier_Printer_ConfigForm_default();
        $this->fields[HTMLPurifier_VarParser::C_BOOL] = new HTMLPurifier_Printer_ConfigForm_bool();
    }

Member Function Documentation

getCSS()

static HTMLPurifier_Printer_ConfigForm::getCSS ( )

static

Retrieves styling, in case it is not accessible by webserver.

Definition at line 72 of file ConfigForm.php.

    {
        return file_get_contents(HTMLPURIFIER_PREFIX . '/HTMLPurifier/Printer/ConfigForm.css');
    }

getJavaScript()

static HTMLPurifier_Printer_ConfigForm::getJavaScript ( )

static

Retrieves JavaScript, in case it is not accessible by webserver.

Definition at line 80 of file ConfigForm.php.

    {
        return file_get_contents(HTMLPURIFIER_PREFIX . '/HTMLPurifier/Printer/ConfigForm.js');
    }

render()

HTMLPurifier_Printer_ConfigForm::render	(		$config,
			$allowed = true,
			$render_controls = true
	)

Returns HTML output for a configuration form.

Parameters

HTMLPurifier_Config | array	$config	Configuration object of current form state, or an array where [0] has an HTML namespace and [1] is being rendered.
array | bool	$allowed	Optional namespace(s) and directives to restrict form to.
bool	$render_controls

Returns

string

Definition at line 93 of file ConfigForm.php.

References HTMLPurifier_Printer\$config, $key, $ret, HTMLPurifier_Printer\element(), HTMLPurifier_Printer\elementEmpty(), HTMLPurifier_Printer\end(), HTMLPurifier_Config\getAllowedDirectivesForForm(), HTMLPurifier_Printer\prepareGenerator(), renderNamespace(), and HTMLPurifier_Printer\start().

    {
        if (is_array($config) && isset($config[0])) {
            $gen_config = $config[0];
            $config = $config[1];
        } else {
            $gen_config = $config;
        }

        $this->config = $config;
        $this->genConfig = $gen_config;
        $this->prepareGenerator($gen_config);

        $allowed = HTMLPurifier_Config::getAllowedDirectivesForForm($allowed, $config->def);
        $all = array();
        foreach ($allowed as $key) {
            list($ns, $directive) = $key;
            $all[$ns][$directive] = $config->get($ns . '.' . $directive);
        }

        $ret = '';
        $ret .= $this->start('table', array('class' => 'hp-config'));
        $ret .= $this->start('thead');
        $ret .= $this->start('tr');
        $ret .= $this->element('th', 'Directive', array('class' => 'hp-directive'));
        $ret .= $this->element('th', 'Value', array('class' => 'hp-value'));
        $ret .= $this->end('tr');
        $ret .= $this->end('thead');
        foreach ($all as $ns => $directives) {
            $ret .= $this->renderNamespace($ns, $directives);
        }
        if ($render_controls) {
            $ret .= $this->start('tbody');
            $ret .= $this->start('tr');
            $ret .= $this->start('td', array('colspan' => 2, 'class' => 'controls'));
            $ret .= $this->elementEmpty('input', array('type' => 'submit', 'value' => 'Submit'));
            $ret .= '[<a href="?">Reset</a>]';
            $ret .= $this->end('td');
            $ret .= $this->end('tr');
            $ret .= $this->end('tbody');
        }
        $ret .= $this->end('table');
        return $ret;
    }

Here is the call graph for this function:

renderNamespace()

HTMLPurifier_Printer_ConfigForm::renderNamespace (   $ns,   $directives  )

protected

Renders a single namespace.

Parameters

	$ns	String namespace name
array	$directives	array of directives to values

Returns

string

Definition at line 144 of file ConfigForm.php.

References $def, $ret, $type, $url, HTMLPurifier_Printer\element(), HTMLPurifier_Printer\end(), fields, and HTMLPurifier_Printer\start().

Referenced by render().

    {
        $ret = '';
        $ret .= $this->start('tbody', array('class' => 'namespace'));
        $ret .= $this->start('tr');
        $ret .= $this->element('th', $ns, array('colspan' => 2));
        $ret .= $this->end('tr');
        $ret .= $this->end('tbody');
        $ret .= $this->start('tbody');
        foreach ($directives as $directive => $value) {
            $ret .= $this->start('tr');
            $ret .= $this->start('th');
            if ($this->docURL) {
                $url = str_replace('%s', urlencode("$ns.$directive"), $this->docURL);
                $ret .= $this->start('a', array('href' => $url));
            }
            $attr = array('for' => "{$this->name}:$ns.$directive");

            // crop directive name if it's too long
            if (!$this->compress || (strlen($directive) < $this->compress)) {
                $directive_disp = $directive;
            } else {
                $directive_disp = substr($directive, 0, $this->compress - 2) . '...';
                $attr['title'] = $directive;
            }

            $ret .= $this->element(
                'label',
                $directive_disp,
                // component printers must create an element with this id
                $attr
            );
            if ($this->docURL) {
                $ret .= $this->end('a');
            }
            $ret .= $this->end('th');

            $ret .= $this->start('td');
            $def = $this->config->def->info["$ns.$directive"];
            if (is_int($def)) {
                $allow_null = $def < 0;
                $type = abs($def);
            } else {
                $type = $def->type;
                $allow_null = isset($def->allow_null);
            }
            if (!isset($this->fields[$type])) {
                $type = 0;
            } // default
            $type_obj = $this->fields[$type];
            if ($allow_null) {
                $type_obj = new HTMLPurifier_Printer_ConfigForm_NullDecorator($type_obj);
            }
            $ret .= $type_obj->render($ns, $directive, $value, $this->name, array($this->genConfig, $this->config));
            $ret .= $this->end('td');
            $ret .= $this->end('tr');
        }
        $ret .= $this->end('tbody');
        return $ret;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setTextareaDimensions()

HTMLPurifier_Printer_ConfigForm::setTextareaDimensions	(		$cols = null,
			$rows = null
	)

Sets default column and row size for textareas in sub-printers.

Parameters

$cols	Integer columns of textarea, null to use default
$rows	Integer rows of textarea, null to use default

Definition at line 59 of file ConfigForm.php.

References $cols, $rows, and fields.

    {
        if ($cols) {
            $this->fields['default']->cols = $cols;
        }
        if ($rows) {
            $this->fields['default']->rows = $rows;
        }
    }

Field Documentation

$compress

HTMLPurifier_Printer_ConfigForm::$compress = false

protected

Whether or not to compress directive names, clipping them off after a certain amount of letters.

False to disable or integer letters before clipping. bool

Definition at line 33 of file ConfigForm.php.

Referenced by __construct().

$docURL

HTMLPurifier_Printer_ConfigForm::$docURL

protected

Documentation URL, can have fragment tagged on end.

string

Definition at line 19 of file ConfigForm.php.

$fields

HTMLPurifier_Printer_ConfigForm::$fields = array()

protected

Printers for specific fields.

HTMLPurifier_Printer[]

Definition at line 13 of file ConfigForm.php.

$name

HTMLPurifier_Printer_ConfigForm::$name

protected

Name of form element to stuff config in.

string

Definition at line 25 of file ConfigForm.php.

Referenced by __construct(), and HTMLPurifier_Printer_ConfigForm_NullDecorator\render().

---

The documentation for this class was generated from the following file:

• libs/composer/vendor/ezyang/htmlpurifier/library/HTMLPurifier/Printer/ConfigForm.php