Extension:SimpleViewer.php

From Organic Design wiki
Revision as of 20:34, 1 April 2008 by Rob (talk | contribs) (update - still need to fix url magic)

<?php

  1. Extension:SimpleViewer
Info.svg These are the MediaWiki extensions we're using and/or developing. Please refer to the information on the mediawiki.org wiki for installation and usage details. Extensions here which have no corresponding mediawiki article are either not ready for use or have been superseded. You can also browse our extension code in our local Subversion repository or our GitHub mirror.

Template:Php

  1. - Licenced under LGPL (http://www.gnu.org/copyleft/lesser.html)
  2. - Author: User:RobCategory:Extensions created with Template:Extension
  3. Template:Php

if (!defined('MEDIAWIKI')) die('Not an entry point.');

define('SIMPLEVIEWER_VERSION','0.0.1');

$egSimpleViewerMagic = "simpleviewer"; $wgExtensionFunctions[] = 'efSetupSimpleViewer';

  1. $wgExtensionFunctions[] = 'wfSetupSpecialSimpleViewer';

$wgSimpleViewerUrlMagic = '__x__';

$wgHooks['LanguageGetMagic'][] = 'efSimpleViewerLanguageGetMagic';

$wgExtensionCredits['parserhook'][] = array( 'name' => 'SimpleViewer', 'author' => 'User:Rob', 'description' => 'Mediawiki integration with SimpleViewer from Airtight interactive', 'url' => 'http://www.organicdesign.co.nz/Extension:SimpleViewer.php', 'version' => SIMPLEVIEWER_VERSION );

$wgExtensionCredits['specialpage'][] = array( 'name' => 'Special:SimpleViewer', 'author' => 'User:Rob', 'description' => 'Mediawiki integration with SimpleViewer from Airtight interactive.', 'url' => 'http://www.organicdesign.co.nz/Extension:SimpleViewer.php', 'version' => SIMPLEVIEWER_VERSION );

require_once "$IP/includes/SpecialPage.php";

class SimpleViewer {

# Properties var $prop1 = 'default value'; var $prop2 = 'default value';

# Constructor function __construct() { global $wgHooks,$wgParser,$egSimpleViewerMagic,$egSimpleViewerTag;

# Add the parser-function $wgParser->setFunctionHook($egSimpleViewerMagic,array($this,'magicSimpleviewer'));

# Add the tagHook $wgParser->setHook($egSimpleViewerTag,array($this,'tagSimpleviewer'));

}

# Expand the simpleviewer-magic function magicSimpleviewer(&$parser) { global $egSimpleViewerMagic, $wgOut, $wgScriptPath, $wgParser, $wgCanonicalNamespaceNames, $wgSimpleViewerUrlMagic; # Populate $argv with both named and numeric parameters $argv = array(); foreach (func_get_args() as $arg) if (!is_object($arg)) { if (preg_match('/^(.+?)\\s*=\\s*(.+)$/',$arg,$match)) $argv[$match[1]] = $match[2]; else $argv[] = $arg; }


    /* @params
       src - page containing a bullet list of images
       :: what follows are taken directly from the SimpleViewer docs
       maxImageWidth - width of your largest image in pixels. Used to determine the best layout for your gallery.
       maxImageHeight - height of your largest image in pixels. Used to determine the best layout for your gallery.
       textColor - Color of title and caption text (hexidecimal color value e.g 0xff00ff).
       frameColor - Color of image frame, navigation buttons and thumbnail frame (hexidecimal color value e.g 0xff00ff).
       frameWidth - Width of image frame in pixels.
       stagePadding - Distance between image and thumbnails and around gallery edge in pixels.
       thumbnailColumns - number of thumbnail rows. (To disable thumbnails completely set this value to 0.)
       thumbnailRows - number of thumbnail columns. (To disable thumbnails completely set this value to 0.)
       navPosition - Position of thumbnails relative to image. Can be "top", "bottom","left" or "right".
       title - Text to display as gallery Title
       enableRightClickOpen - Whether to display a 'Open In new Window...' dialog when right-clicking on an image. Can be "true" or "false"
       backgroundImagePath (optional) - Relative or absolute path to a JPG or SWF to load as the
       */
       

$title = Title::newFromText($argv['src']); $ns = $title->getNsText(); $db = $title->getDBkey(); $urlsafe = $ns.$wgSimpleViewerUrlMagic.$db;

       # add the javascript and build the embed code

$wgOut->addScript("<script type=\"text/javascript\" src=\"$wgScriptPath/extensions/SimpleViewer/simpleviewer/swfobject.js\"></script>");

$script = "

SimpleViewer requires Macromedia Flash. <a href='http://www.macromedia.com/go/getflashplayer/'>Get Macromedia Flash.</a> If you have Flash installed, <a href='index.html?detectflash=false'>click to view gallery</a>.

<script type='text/javascript'>var fo = new SWFObject('$wgScriptPath/extensions/SimpleViewer/simpleviewer/viewer.swf?a', 'viewer', '100%', '500px', '7', '#000000'); fo.addVariable('preloaderColor', '0xaaaaaa'); fo.addVariable('xmlDataPath', '$wgScriptPath/index.php/SpecialSimpleViewer/$urlsafe'); fo.write('flashcontent');</script>";

  1. /research/extensions/SimpleViewer/simpleviewer/Special:Test.xml
  1. /research/index.php/Special:SpecialSimpleViewer/Mint_Media:Gallery
  1. $wgScriptPath/index.php/Special:SpecialSimpleViewer/$urlsafe
  2. /research/index.php/Special:SpecialSimpleViewer?src=Mint_Media:Gallery
  1. $script = $wikitext;

# Return result with available parser flags return array( $script, 'noparse' => true, 'isHTML' => true );

}

# Needed in some versions to prevent Special:Version from breaking function __toString() { return 'SimpleViewer'; }

	}

class SpecialSpecialSimpleViewer extends SpecialPage {

# Constructor function __construct() { SpecialPage::SpecialPage( 'SpecialSimpleViewer', # name as seen in links etc '*', # user rights required false, # listed in special:specialpages false, # function called by execute() - defaults to wfSpecial{$name} false, # file included by execute() - defaults to Special{$name}.php, only used if no function false # includable ); }

# Override SpecialPage::execute() # - $param is from the URL, eg Special:SpecialSimpleViewer/param function execute($param) {

}

}


  1. Called from $wgExtensionFunctions array when initialising extensions

function efSetupSimpleViewer() { global $egSimpleViewer, $wgSimpleViewerUrlMagic; $egSimpleViewer = new SimpleViewer();

       global $wgOut, $wgCanonicalNamespaceNames, $wgParser, $wgScriptPath;

#$wgParser->disableCache();


       print($_REQUEST['title']);


if(preg_match("#^SpecialSimpleViewer/#", $_REQUEST['title'])) {

# is this an image request? $m = preg_match_all("#SpecialSimpleViewer/images/(\d+)/(.+)#i", $_REQUEST['title'], $matches, PREG_SET_ORDER); $size = $matches[0][1]; $file = $matches[0][2];

       # if the url is of the form Special:SpecialSimpleViewer/images/200/foo.jpg
       # then send a redirect to get thumb.php to do the resizing

if($m > 0) { header("Location: $wgScriptPath/thumb.php?f=$file&width=$size"); exit; }

       # Redirect can make things a bit slower so may provide the image directly in future
       
       # if we got this far it's not an image and we should output an XML file

header('Content-Type: text/html');

       print "hello";
       # params:
       # src = article name containing a list of images for the gallery, article may also contain a DPL query
       
       preg_match_all("#SpecialSimpleViewer/(.+)$#", $_REQUEST['title'], $matches, PREG_SET_ORDER);
       #print_r($matches);
       $t = str_replace($wgSimpleViewerUrlMagic, ':', $matches[0][1]);
       print($_REQUEST['title']);

# get article content

       $title    = Title::newFromText($t);
       # if the image article does not exist exit

if(!$title) { print "does not exist";

           $wgOut->disable();
           wfResetOutputBuffers();
           return;
       }


       $article  = new Article($title);
       $wikitext = $article->getContent();
       # parse the wikitext to expand templates and parser functions
       $wgParser = new Parser();

$wikitext = $wgParser->preprocess($wikitext,$title,new ParserOptions());

       print $wikitext;
       
       # need some heiristics here to handle a few reasonable image-article-list formats
       # we accept the default output format of DPL for now
       

# $wikitext =

  • Image:Industrial-design-a-to-z.jpg
  • etc

    # make a list of image names excluding the namespace (Image:) $ns_image = $wgCanonicalNamespaceNames[NS_IMAGE]; preg_match_all("|".$ns_image.":([a-z-_.]+?)\]|i", $wikitext, $image);


           # standard header, other options to add later		
    

    print("<?xml version='1.0' encoding='UTF-8'?> <simpleviewerGallery maxImageWidth='600' maxImageHeight='600' textColor='0x000000' frameColor='0x000000' frameWidth='2' stagePadding='40' thumbnailColumns='3' thumbnailRows='3' navPosition='left' title='title of gallery' enableRightClickOpen='true' backgroundImagePath= imagePath='$wgScriptPath/index.php/SpecialSpecialSimpleViewer/images/500/' thumbPath='$wgScriptPath/index.php/SpecialSpecialSimpleViewer/images/100/'>");

           # simpleviewer requires a TRAILING / on the imagePath and thumbPath params
    


           # loop and generate <image> containers
           foreach($image[1] as $i) {
               print("<image><filename>$i</filename>Arles old town.</image>\n");
           }
    
           # close document        
           print("</simpleviewerGallery>");
    
           $wgOut->disable();
           wfResetOutputBuffers();
           }
       
    

    }

    function wfSetupSpecialSimpleViewer() { global $wgLanguageCode,$wgMessageCache;

    # Add the messages used by the specialpage if ($wgLanguageCode == 'en') { $wgMessageCache->addMessages(array( 'specialsimpleviewer' => 'SimpleGallery', # The friendly page title 'exampleMessage' => "Example message: $1", )); }

    # Add the specialpage to the environment SpecialPage::addPage(new SpecialSpecialSimpleViewer()); }

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

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