Extension:Livelets.php

<?

1. Extension:Livelets
2. - Allows live articles to be transcluded which update automatically on change in a non-polling, fully event-driven way
3. - Version 0.1 (2007-03-30)
4. - See http://www.mediawiki.org/wiki/Extension:Livelets for installation and usage details
5. - Licenced under LGPL (http://www.gnu.org/copyleft/lesser.html)
6. - Author: http://www.organicdesign.co.nz/nad

$wgLiveletsMagic = "live"; # the parser-function name for doing live-transclusions $wgExtensionFunctions[] = 'wfSetupLivelets'; $wgHooks['LanguageGetMagic'][] = 'wfLiveletsLanguageGetMagic'; $wgHooks['UnknownAction'][] = 'wfLiveletsActionHandler';

class Livelets {

var $version = '0.1, 2007-03-30'; var $magic; var $args; var $id = 0;

# Constructor function Livelets($magic) { global $wgParser,$wgHooks,$wgOut; $this->magic = $magic; $this->args = array(); $wgParser->setFunctionHook($magic,array($this,'functionHook')); $wgParser->setHook($magic,array($this,'tagHook')); $wgOut->addScript('<script type="text/javascript" src="http://www.organicdesign.co.nz/livelets.js"></script>'); }

# Remove live container content, store its parameters and convert it to $magic tags function functionHook(&$parser) { $magic = $this->magic; $id = $this->id++; $args = array(); foreach (func_get_args() as $arg) if (!is_object($arg)) { if (preg_match('/^(.+?)=(.+)$/',$arg,$match)) $args[$match[1]] = $match[2]; else $args[] = $arg; } $this->args[$id] = $args; return "<$magic>$id</$magic>"; }

# Convert the $magic tags to client-side javascript request code from its stored parameters function tagHook($id,$argv,&$parser) { global $wgScript; $args = $this->args[$id]; $title = $args[0];

return "

livelet#$id=$title

";

}

}

1. Called from $wgExtensionFunctions array when initialising extensions

function wfSetupLivelets() { global $wgLivelets,$wgLiveletsMagic; $wgLivelets = new Livelets($wgLiveletsMagic); }

1. Needed in MediaWiki >1.8.0 for magic word hooks to work properly

function wfLiveletsLanguageGetMagic(&$magicWords,$langCode = 0) { global $wgLiveletsMagic; $magicWords[$wgLiveletsMagic] = array(0,$wgLiveletsMagic); return true; }

1. Return naked if live action requested

function wfLiveletsActionHandler($action,$title) { global $wgHooks; if ($action == 'live') $wgHooks['ParserAfterTidy'][] = 'wfLiveletsNakedArticle'; return true; }

1. Output the naked page and die

function wfLiveletsNakedArticle(&$parser,&$text) { while(@ob_end_clean()); echo($text); die; } ?>