Extension:ToolboxExtender

From MediaWiki.org

Jump to: navigation, search
Manual on MediaWiki Extensions
List of MediaWiki Extensions
ToolboxExtender

Release status: stable

Implementation Hook
Description Provides the capability to add arbitrary wikitext to the toolbox on the Monobook skin.
Author(s) Jean-Lou Dupont
Version 1.0.0
MediaWiki 1.11, 1.12
Download SVN
See SVN ($Id: ToolboxExtender.doc.wikitext 653 2007-10-29 14:25:20Z jeanlou.dupont $)
Hooks used

MonoBookTemplateToolboxEnd

Contents

[edit] Purpose

Provides the capability to add arbitrary wikitext to the toolbox on the Monobook skin.

[edit] Usage

Edit the page MediaWiki:Registry/ToolboxExtender with the desired wikitext.

[edit] Example

The following is an example page for MediaWiki:Registry/ToolboxExtender. The page relies on Extension:SecureHTML, Extension:ImageLink, Extension:InterWikiLinkManager and Extension:HeadScripts.

__NOEDITSECTION__ __NOTOC__  
bookmarks
* {{#imagelink:{{DiggImage}}     |digg:submit?phase=2&url=$titleURI$&title=$title$}}
* {{#imagelink:{{DeliciousImage}}|delicious:post?url=$titleURI$&title=$title$}}

 <!-- below is the javascript required to 'fix' the magic words in the URI above -->
 <!-- relevant page level variables defined by MediaWiki are: wgArticlePath, wgTitle, wgServer, wgCanonicalNamespace  -->

<html><script>
/* jQuery based
 */
$(document).ready(function() {
   // do stuff when DOM is ready
   fixMagicWords();
 });

function fixMagicWords()
{
 $("a").filter(".extiw").each(function(i)
  {
    if (/\$title\$/g)
     this.href = fixTitleMagicWord( this.href );
    if (/\$titleURI\$/g)
     this.href = fixTitleUriMagicWord( this.href );
  });

};
function fixTitleMagicWord( href )
{
 title = getValidTitle();
 return href.replace( /\$title\$/g,  title );
};
function fixTitleUriMagicWord( href )
{
 title = getValidTitle();
 path = wgArticlePath.replace( /\$1/g, title );
 return href.replace( /\$titleURI\$/g, wgServer + path );
};
function getValidTitle()
{
 title = wgTitle.replace( / /g, '_' );
 if (wgCanonicalNamespace.length == 0)
  return title;
 else
  return wgCanonicalNamespace + ':' + title;
};
</script></html>

[edit] Dependancy



[edit] Installation

See the Mediawiki Extension table entry "download" above.[1]

[edit] LocalSettings.php

Extension:ExtensionManager: See footnote[2]

require_once( "$IP/extensions/ToolboxExtender/ToolboxExtender.php" );

[edit] PEAR

PEAR is a repository of software code.

pear channel-discover mediawiki.googlecode.com/svn
  • Install extension through PEAR:
pear install mediawiki/ToolboxExtender
  • Add the following to LocalSettings.php[2][3]:
require 'MediaWiki/ToolboxExtender/ToolboxExtender.php';

[edit] Upgrades through PEAR

Sometimes, it is necessary to clear PEAR's cache in order to perform upgrades.

pear clear-cache

or use the force method:

pear upgrade --force mediawiki/ToolboxExtender

[edit] PEAR Web Frontend

For easier remote package management, PEAR Frontend WEB can be installed. Installation notes can be found here. An example of the WEB frontend is available here.

[edit] RSS feed

To keep kept up-to-date with this channel, use the following RSS feedImage:Rss2.jpg.

[edit] Notes

[edit] Sandbox

You are invited in the author's sandbox to try-out some of his extensions.


  1. The most recent release is always available through the extension's PEAR and SVN repositories. This page is not necessarily up-to-date.
  2. 2.0 2.1 2.2 Extension:ExtensionManager does not require any modification to LocalSettings.php because ExtensionManager includes the extension.
    Note that if PHP code caching is in place (e.g. APC, eAccelerator), then to successfully complete the installation a cache flush might be needed.
  3. Modifications to LocalSettings.php is only necessary if not using Extension:ExtensionManager

[edit] History

Personal tools
In other languages