From 42d2858c9da55544709671ccb0761ebbb231cf19 Mon Sep 17 00:00:00 2001
From: "Edward Z. Yang" <edwardzyang@thewritingpot.com>
Date: Thu, 13 Mar 2008 05:35:57 +0000
Subject: [PATCH] [3.1.0] Experimental kses support.

git-svn-id: http://htmlpurifier.org/svnroot/htmlpurifier/trunk@1610 48356398-32a2-884e-a903-53898d9a118a
---
 NEWS                                    |  1 +
 library/HTMLPurifier.kses.php           | 28 +++++++++++++++++++++++++
 tests/HTMLPurifier/PHPT/kses/basic.phpt | 15 +++++++++++++
 3 files changed, 44 insertions(+)
 create mode 100644 library/HTMLPurifier.kses.php
 create mode 100644 tests/HTMLPurifier/PHPT/kses/basic.phpt

diff --git a/NEWS b/NEWS
index e93192d8..8c07d048 100644
--- a/NEWS
+++ b/NEWS
@@ -35,6 +35,7 @@ NEWS ( CHANGELOG and HISTORY )                                     HTMLPurifier
   to true to use them.
 ! HTML Purifier now has its own Exception hierarchy under HTMLPurifier_Exception.
   Developer error (not enduser error) can cause these to be triggered.
+! Experimental kses() wrapper introduced with HTMLPurifier.kses.php
 - Autoclose now operates iteratively, i.e. <span><span><div> now has
   both span tags closed.
 - Various HTMLPurifier_Config convenience functions now accept another parameter
diff --git a/library/HTMLPurifier.kses.php b/library/HTMLPurifier.kses.php
new file mode 100644
index 00000000..28314c4d
--- /dev/null
+++ b/library/HTMLPurifier.kses.php
@@ -0,0 +1,28 @@
+<?php
+
+/**
+ * @file
+ * Emulation layer for code that used kses(), substituting in HTML Purifier.
+ */
+
+require_once dirname(__FILE__) . '/HTMLPurifier.auto.php';
+
+function kses($string, $allowed_html, $allowed_protocols = null) {
+    $config = HTMLPurifier_Config::createDefault();
+    $allowed_elements = array();
+    $allowed_attributes = array();
+    foreach ($allowed_html as $element => $attributes) {
+        $allowed_elements[$element] = true;
+        foreach ($attributes as $attribute => $x) {
+            $allowed_attributes["$element.$attribute"] = true;
+        }
+    }
+    $config->set('HTML', 'AllowedElements', $allowed_elements);
+    $config->set('HTML', 'AllowedAttributes', $allowed_attributes);
+    $allowed_schemes = array();
+    if ($allowed_protocols !== null) {
+        $config->set('URI', 'AllowedSchemes', $allowed_protocols);
+    }
+    $purifier = new HTMLPurifier($config);
+    return $purifier->purify($string);
+}
diff --git a/tests/HTMLPurifier/PHPT/kses/basic.phpt b/tests/HTMLPurifier/PHPT/kses/basic.phpt
new file mode 100644
index 00000000..da2c05a8
--- /dev/null
+++ b/tests/HTMLPurifier/PHPT/kses/basic.phpt
@@ -0,0 +1,15 @@
+--TEST--
+HTMLPurifier.kses.php basic test
+--FILE--
+<?php
+require '../library/HTMLPurifier.kses.php';
+echo kses(
+    '<a class="foo" style="color:#F00;" href="https://google.com">Foo<i>Bar</i>',
+    array(
+        'a' => array('class' => 1, 'href' => 1),
+    ),
+    array('http') // no https!
+);
+
+--EXPECT--
+<a class="foo">FooBar</a>