add SimpleTable extension

SimpleTable.php

@@ -0,0 +1,169 @@
+<?php
+
+/*
+ * Tabbed Data extension.
+ *
+ * This extension implements a simple method to display tabular data, with a
+ * far simpler markup than the standard Wiki table markup.  The goal is to
+ * allow tabular data to be very easily pasted in from an external source,
+ * such as a spreadsheet.  The disadvantage is that it doesn't allow for any
+ * fancy formatting; for example, there is no way (as yet) to set row and cell
+ * parameters, including row and cell spanning.  However, it makes a very
+ * simple way to include tabular data in a Wiki.
+ *
+ * All you need to do is prepare your data in rows, with fields separated
+ * by tab characters.  Excel's "Save as" -> "Text (Tab delimited)" function
+ * saves data in this format.  Place the data inside <tab>...</tab> tags,
+ * and set any table parameters inside the opening <tab> tag; eg.:
+ *
+ *   <tab class=wikitable>
+ *   field1\tfield2\t...
+ *   field1\tfield2\t...
+ *   </tab>
+ *
+ * Additional parameters allowed in the tag are:
+ *   sep                  Specify a different separator; see the $separators array.
+ *   head                 Specify a heading; "head=top" makes the first row a heading,
+ *                        "head=left" makes the first column a heading, "head=topleft"
+ *                        does both.
+ *   applycssborderstyle  Adds a style to the table and each cell using css
+ *                        border-colapse to give the table a black 1px border
+ *
+ * Thanks for contributions to:
+ *	Smcnaught
+ *	Frederik Dohr
+ */
+
+$wgExtensionFunctions[] = 'wfSimpleTable';
+$wgExtensionCredits['parserhook'][] = array(
+  'name'=>'SimpleTable',
+  'author'=>'Johan the Ghost',
+  'url'=>'http://www.mediawiki.org/wiki/Extension:SimpleTable',
+  'description'=>'Convert tab-separated or similar data into a Wiki table',
+);
+
+
+/*
+ * Setup SimpleTable extension.
+ * Sets a parser hook for <tab></tab>.
+ */
+function wfSimpleTable() {
+    new SimpleTable();
+}
+
+
+class SimpleTable {
+
+    /*
+     * The permitted separators.  An array of separator style name
+     * and preg pattern to match it.
+     */
+    private $separators = array(
+        'space' => '/ /',
+        'spaces' => '/\s+/',
+        'tab' => '/\t/',
+        'comma' => '/,/',
+        'colon' => '/:/',
+        'semicolon' => '/;/',
+        'bar' => '/\|/',
+    );
+
+
+    /*
+     * Construct the extension and install it as a parser hook.
+     */
+    public function __construct() {
+        global $wgParser;
+        $wgParser->setHook('tab', array(&$this, 'hookTab'));
+    }
+
+
+    /*
+     * The hook function. Handles <tab></tab>.
+     * Receives the table content and <tab> parameters.
+     */
+    public function hookTab($tableText, $argv, $parser) {
+        // The default field separator.
+        $sep = 'tab';
+
+        // Default value for using table headings.
+        $head = null;
+
+        // If we are to apply border-colapse CSS Border Style
+        $applycssborderstyle = false;
+
+        // Build the table parameters string from the tag parameters.
+        // The 'sep' and 'head' parameters are special, and are handled
+        // here, not passed to the table.
+        $params = '';
+        foreach ($argv as $key => $val) {
+            if ($key == 'sep')
+                $sep = $val;
+            else if ($key == 'head')
+                $head = $val;
+            else if ($key == 'applycssborderstyle') 
+                $applycssborderstyle = $val;
+            else
+                $params .= ' ' . $key . '="' . $val . '"';
+        }
+
+        if (!array_key_exists($sep, $this->separators))
+            return "Invalid separator: $sep";
+
+        // Parse and convert the table body.
+        $wikiText = $this->convertTable($tableText, $head, $this->separators[$sep], $applycssborderstyle);
+
+        // If we are not to apply the css border style
+        if ($applycssborderstyle == false) {
+          // Wrap the body in table tags, with the table parameters.
+          $wikiTable = "{|" . $params . "\n" . $wikiText . "|}";
+        } else {
+          $tablestyletext = 'style="border-collapse: collapse; border-width: 1px; border-style: solid; border-color: #000"';
+          $wikiTable = "{|" . $tablestyletext . " " . $params . "\n" . $wikiText . "|}";
+        }
+
+        // Done.  Parse the result, so that the table can contain Wiki
+        // text.  Thanks to Smcnaught.
+        $ret = $parser->parse($wikiTable,
+                              $parser->mTitle,
+                              $parser->mOptions,
+                              false,
+                              false);
+	$HTML = trim( str_replace("</table>\n\n", "</table>", $ret->getText()) ); # remove superfluous newlines
+        return $HTML;
+    }
+
+
+    /*
+     * Convert tabbed data into a Wiki-markup table body.
+     */
+    private function convertTable($tabbed, $head, $pattern, $applycssborderstyle) {
+        $wikitab = '';
+
+        // Remove initial and final newlines.
+        $tabbed = trim($tabbed);
+
+        // Split the input into lines, and convert each line to table format.
+        $lines = preg_split('/\n/', $tabbed);
+        $row = 0;
+        foreach ($lines as $line) {
+            $wikitab .= "|-\n";
+            $bar = strpos($head, 'top') !== false && $row == 0 ? '!' : '|';
+
+            if ($applycssborderstyle !== false) {
+              $bar = $bar . 'style="border-style: solid; border-width: 1px" |';
+            } 
+
+            $fields = preg_split($pattern, $line);
+            $col = 0;
+            foreach ($fields as $field) {
+                $cbar = strpos($head, 'left') !== false && $col == 0 ? '!' : $bar;
+                $wikitab .= $cbar . " " . $field . "\n";
+                ++$col;
+            }
+            ++$row;
+        }
+        return $wikitab;
+    }
+
+}

install

@@ -22,6 +22,7 @@ install $SOURCEDIR/wikifarm-log-split.pl $INSTALLDIR/etc/
 install $SOURCEDIR/wikifarm-php.ini /etc/php5/conf.d/
 install $SOURCEDIR/{login,logout,index,claim-wiki-by-password}.php $INSTALLDIR/wikis/
 install $SOURCEDIR/GeSHiHighlight.php /usr/share/mediawiki-extensions/
+install $SOURCEDIR/SimpleTable.php /usr/share/mediawiki-extensions/
 
 install /usr/share/doc/awstats/examples/awstats_buildstaticpages.pl $INSTALLDIR/etc/awstats_buildstaticpages.pl
 perl -pi~ -e 's:2>&1:1>&2: if $.==372' $INSTALLDIR/etc/awstats_buildstaticpages.pl