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,$wgScript; $this->magic = $magic; $this->args = array(); $wgParser->setFunctionHook($magic,array($this,'functionHook')); $wgParser->setHook($magic,array($this,'tagHook')); $wgOut->addScript("<script type='text/javascript'>

// Request an URL function liveletRequest(livelet) { livelet.url = '$wgScript?title=' + livelet.getAttribute('title') + '&action=live' livelet.xmlhttp = null if (window.XMLHttpRequest) livelet.xmlhttp = new XMLHttpRequest() else if (window.ActiveXObject) livelet.xmlhttp = new ActiveXObject('Microsoft.XMLHTTP') if (livelet.xmlhttp != null) { livelet.xmlhttp.onreadystatechange = stateChange livelet.xmlhttp.open('GET',livelet.url,true) livelet.xmlhttp.send(null) //livelet.xmlhttp.livelet = livelet } else alert('Your browser does not support XMLHTTP!') }

// Update the livelet content when loaded function stateChange() { if (this.readyState == 4) { if (this.status == 200) { //alert(this.livelet.innerHTML) alert(this.responseText + 'recvd') //this.livelet.innerHTML = this.responseText } else alert('Problem retrieving XML data!') } }

// Trap fscommands from the SWF movie function livelets_DoFScommand(cmd,args) { alert(args) }

</script>");

$swf = '/wiki/extensions/livelets/livelets.swf'; $wgOut->addHTML("<object classid='clsid:D27CDB6E-AE6D-11cf-96B8-444553540000' codebase='http://active.macromedia.com/flash2/cabs/swflash.cab#version=4,0,0,0' id='livelets' width=100 height=100> <param name='movie' value='$swf'> <embed swliveconnect='true' name='livelets' src='$swf' width=100 height=100 type='application/x-shockwave-flash' pluginspage='http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash'> </embed></object>"); }

# Remove live container content, store its parameters and convert it to $magic tags function functionHook(&$parser) { $magic = $this->magic; $id = 'livelet'.$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];

$html = "

livelet#$id=$title

";

$html .= "<script type='text/javascript'>liveletRequest(document.getElementById('$id'))</script>"; return $html; }

}

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; } ?>