|
|
(74 intermediate revisions by 2 users not shown) |
Line 1: |
Line 1: |
− | <?
| + | {{svn|http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/Livelets}} |
− | # Extension:Livelets
| |
− | # - Allows live articles to be transcluded which update automatically on change in a non-polling, fully event-driven way
| |
− | # - Version 0.1 (2007-03-30)
| |
− | # - See http://www.mediawiki.org/wiki/Extension:Livelets for installation and usage details
| |
− | # - Licenced under LGPL (http://www.gnu.org/copyleft/lesser.html)
| |
− | # - Author: http://www.organicdesign.co.nz/nad
| |
| | | |
− | $wgLiveletsMagic = "live"; # the parser-function name for doing live-transclusions
| + | == Notes == |
− | $wgExtensionFunctions[] = 'wfSetupLivelets';
| + | Add dev notes here, e.g. regarding the SWF live updates |
− | $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/wiki/index.php?title=livelets.js&action=raw'><!-- livelets --></script>\n");
| |
− | }
| |
− | | |
− | # 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];
| |
− | | |
− | return "<script type='text/javascript'>liveletRequest(document.getElementById('$id'))</script><div class='livelet' id='$id' url='$wgScript?title=$title&action=live'>livelet#$id=$title</div>";
| |
− | }
| |
− | | |
− | }
| |
− | | |
− | # Called from $wgExtensionFunctions array when initialising extensions
| |
− | function wfSetupLivelets() {
| |
− | global $wgLivelets,$wgLiveletsMagic;
| |
− | $wgLivelets = new Livelets($wgLiveletsMagic);
| |
− | }
| |
− | | |
− | # 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;
| |
− | }
| |
− | | |
− | # Return naked if live action requested
| |
− | function wfLiveletsActionHandler($action,$title) {
| |
− | global $wgHooks;
| |
− | if ($action == 'live') $wgHooks['ParserAfterTidy'][] = 'wfLiveletsNakedArticle';
| |
− | return true;
| |
− | }
| |
− | | |
− | # Output the naked page and die
| |
− | function wfLiveletsNakedArticle(&$parser,&$text) {
| |
− | while(@ob_end_clean());
| |
− | echo($text);
| |
− | die;
| |
− | }
| |
− | ?>
| |