[1.3.2] Added purifyArray(), which takes a list of HTML and purifies it all

git-svn-id: http://htmlpurifier.org/svnroot/htmlpurifier/trunk@615 48356398-32a2-884e-a903-53898d9a118a

NEWS

@@ -19,6 +19,7 @@ NEWS ( CHANGELOG and HISTORY )                                     HTMLPurifier
 ! Context object now accessible to outside
 ! Added enduser-youtube.html, explains how to embed YouTube videos. See
   also corresponding smoketest preserveYouTube.php.
+! Added purifyArray(), which takes a list of HTML and purifies it all
 - printDefinition.php: added labels, added better clarification
 . HTMLPurifier_Config::create() added, takes mixed variable and converts into
   a HTMLPurifier_Config object.

TODO

@@ -84,7 +84,6 @@ Requested
     3. Extend the tag exclusion system to specify whether or not the
     contents should be dropped or not (currently, there's code that could do
     something like this if it didn't drop the inner text too.)
- - Accept array input, by iterating and purifying all of the items
  - More user-friendly warnings when %HTML.Allow* attempts to specify a
    tag or attribute that is not supported
  - Allow specifying global attributes on a tag-by-tag basis in

library/HTMLPurifier.php

@@ -107,7 +107,6 @@ class HTMLPurifier
         
         $config = $config ? HTMLPurifier_Config::create($config) : $this->config;
         
-        
         $context =& new HTMLPurifier_Context();
         $html = $this->encoder->convertToUTF8($html, $config, $context);
         
@@ -131,6 +130,23 @@ class HTMLPurifier
         return $html;
     }
     
+    /**
+     * Filters an array of HTML snippets
+     * @param $config Optional HTMLPurifier_Config object for this operation.
+     *                See HTMLPurifier::purify() for more details.
+     * @return Array of purified HTML
+     */
+    function purifyArray($array_of_html, $config = null) {
+        $context_array = array();
+        foreach ($array_of_html as $key => $html) {
+            $array_of_html[$key] = $this->purify($html, $config);
+            $context_array[$key] = $this->context;
+        }
+        $this->context = $context_array;
+        return $array_of_html;
+    }
+    
+    
 }
 
 ?>

tests/HTMLPurifier/Test.php

@@ -68,6 +68,21 @@ class HTMLPurifier_Test extends UnitTestCase
         
     }
     
+    function test_purifyArray() {
+        
+        $this->purifier = new HTMLPurifier();
+        
+        $this->assertEqual(
+            $this->purifier->purifyArray(
+                array('Good', '<b>Sketchy', 'foo' => '<script>bad</script>')
+            ),
+            array('Good', '<b>Sketchy</b>', 'foo' => 'bad')
+        );
+        
+        $this->assertIsA($this->purifier->context, 'array');
+        
+    }
+    
 }
 
 ?>