From 89339c7d3bec84464b9234ae4dfcfe93a72b9576 Mon Sep 17 00:00:00 2001
From: John Bintz <john@coswellproductions.com>
Date: Fri, 23 Oct 2009 07:17:20 -0400
Subject: [PATCH] add some docs and rearrange things

---
 classes/WhatDidTheySayAdmin.inc | 35 +++++++++++++++++++--------------
 1 file changed, 20 insertions(+), 15 deletions(-)

diff --git a/classes/WhatDidTheySayAdmin.inc b/classes/WhatDidTheySayAdmin.inc
index 8419167..1893e67 100644
--- a/classes/WhatDidTheySayAdmin.inc
+++ b/classes/WhatDidTheySayAdmin.inc
@@ -577,21 +577,10 @@ class WhatDidTheySayAdmin {
   /** Handle data updates **/
 
   /**
-   * Handle an update to options.
-   * @param array $info The part of the $_POST array for What Did They Say?!?
+   * Filter input for harmful things.
+   * @param string|array $node Either a string or an array of strings to process.
+   * @return string|array Either a processed string or an array of processed strings.
    */
-  function handle_update($info) {
-    if (isset($info['module'])) {
-      $method_name = "handle_update_" . str_replace("-", "_", $info['module']);
-      if (method_exists($this, $method_name)) {
-        $info = $this->_clean_child($info);
-      
-        $result = $this->{$method_name}($info);
-        if (!empty($result)) { $this->notices[] = $result; }
-      }
-    }
-  }
-
   function _clean_child($node) {
     if (is_array($node)) {
       $new_nodes = array();
@@ -605,11 +594,27 @@ class WhatDidTheySayAdmin {
       $node = (string)$node;
       foreach (array('script', 'style', 'link') as $tag) { $node = preg_replace("#<${tag}.*/${tag}>#", '', $node); }
       if (!$options['allow_html']) { $node = strip_tags($node); }
-      
+
       return $node;
     }
   }
 
+  /**
+   * Handle an update to options.
+   * @param array $info The part of the $_POST array for What Did They Say?!?
+   */
+  function handle_update($info) {
+    if (isset($info['module'])) {
+      $method_name = "handle_update_" . str_replace("-", "_", $info['module']);
+      if (method_exists($this, $method_name)) {
+        $info = $this->_clean_child($info);
+      
+        $result = $this->{$method_name}($info);
+        if (!empty($result)) { $this->notices[] = $result; }
+      }
+    }
+  }
+
   /**
    * Handle updates to queued transcripts.
    * @param array $info The part of the $_POST array for What Did They Say?!?