Merge pull request #481 from wallabag/dev

[github/wallabag/wallabag.git] / inc / 3rdparty / htmlpurifier / HTMLPurifier / AttrCollections.php

<?php\r
\r
/**\r
 * Defines common attribute collections that modules reference\r
 */\r
\r
class HTMLPurifier_AttrCollections\r
{\r
\r
    /**\r
     * Associative array of attribute collections, indexed by name.\r
     * @type array\r
     */\r
    public $info = array();\r
\r
    /**\r
     * Performs all expansions on internal data for use by other inclusions\r
     * It also collects all attribute collection extensions from\r
     * modules\r
     * @param HTMLPurifier_AttrTypes $attr_types HTMLPurifier_AttrTypes instance\r
     * @param HTMLPurifier_HTMLModule[] $modules Hash array of HTMLPurifier_HTMLModule members\r
     */\r
    public function __construct($attr_types, $modules)\r
    {\r
        // load extensions from the modules\r
        foreach ($modules as $module) {\r
            foreach ($module->attr_collections as $coll_i => $coll) {\r
                if (!isset($this->info[$coll_i])) {\r
                    $this->info[$coll_i] = array();\r
                }\r
                foreach ($coll as $attr_i => $attr) {\r
                    if ($attr_i === 0 && isset($this->info[$coll_i][$attr_i])) {\r
                        // merge in includes\r
                        $this->info[$coll_i][$attr_i] = array_merge(\r
                            $this->info[$coll_i][$attr_i],\r
                            $attr\r
                        );\r
                        continue;\r
                    }\r
                    $this->info[$coll_i][$attr_i] = $attr;\r
                }\r
            }\r
        }\r
        // perform internal expansions and inclusions\r
        foreach ($this->info as $name => $attr) {\r
            // merge attribute collections that include others\r
            $this->performInclusions($this->info[$name]);\r
            // replace string identifiers with actual attribute objects\r
            $this->expandIdentifiers($this->info[$name], $attr_types);\r
        }\r
    }\r
\r
    /**\r
     * Takes a reference to an attribute associative array and performs\r
     * all inclusions specified by the zero index.\r
     * @param array &$attr Reference to attribute array\r
     */\r
    public function performInclusions(&$attr)\r
    {\r
        if (!isset($attr[0])) {\r
            return;\r
        }\r
        $merge = $attr[0];\r
        $seen  = array(); // recursion guard\r
        // loop through all the inclusions\r
        for ($i = 0; isset($merge[$i]); $i++) {\r
            if (isset($seen[$merge[$i]])) {\r
                continue;\r
            }\r
            $seen[$merge[$i]] = true;\r
            // foreach attribute of the inclusion, copy it over\r
            if (!isset($this->info[$merge[$i]])) {\r
                continue;\r
            }\r
            foreach ($this->info[$merge[$i]] as $key => $value) {\r
                if (isset($attr[$key])) {\r
                    continue;\r
                } // also catches more inclusions\r
                $attr[$key] = $value;\r
            }\r
            if (isset($this->info[$merge[$i]][0])) {\r
                // recursion\r
                $merge = array_merge($merge, $this->info[$merge[$i]][0]);\r
            }\r
        }\r
        unset($attr[0]);\r
    }\r
\r
    /**\r
     * Expands all string identifiers in an attribute array by replacing\r
     * them with the appropriate values inside HTMLPurifier_AttrTypes\r
     * @param array &$attr Reference to attribute array\r
     * @param HTMLPurifier_AttrTypes $attr_types HTMLPurifier_AttrTypes instance\r
     */\r
    public function expandIdentifiers(&$attr, $attr_types)\r
    {\r
        // because foreach will process new elements we add, make sure we\r
        // skip duplicates\r
        $processed = array();\r
\r
        foreach ($attr as $def_i => $def) {\r
            // skip inclusions\r
            if ($def_i === 0) {\r
                continue;\r
            }\r
\r
            if (isset($processed[$def_i])) {\r
                continue;\r
            }\r
\r
            // determine whether or not attribute is required\r
            if ($required = (strpos($def_i, '*') !== false)) {\r
                // rename the definition\r
                unset($attr[$def_i]);\r
                $def_i = trim($def_i, '*');\r
                $attr[$def_i] = $def;\r
            }\r
\r
            $processed[$def_i] = true;\r
\r
            // if we've already got a literal object, move on\r
            if (is_object($def)) {\r
                // preserve previous required\r
                $attr[$def_i]->required = ($required || $attr[$def_i]->required);\r
                continue;\r
            }\r
\r
            if ($def === false) {\r
                unset($attr[$def_i]);\r
                continue;\r
            }\r
\r
            if ($t = $attr_types->get($def)) {\r
                $attr[$def_i] = $t;\r
                $attr[$def_i]->required = $required;\r
            } else {\r
                unset($attr[$def_i]);\r
            }\r
        }\r
    }\r
}\r
\r
// vim: et sw=4 sts=4\r