Semantic Bundle

Semantic Bundle is a pre-packaged bundle of extensions for use with wikis that are based around the Semantic MediaWiki extension. It can be obtained either through SVN or by downloading a single .tgz or .zip file.

Contents
Semantic Bundle contains a large number of MediaWiki extensions; chief among them is, of course, Semantic MediaWiki, an extension that enables semantic storage and querying of data. Other SMW-based extensions included in this bundle are:
 * Semantic Result Formats - defines many additional formats for SMW queries
 * Semantic Forms - allows wiki administrators to create easy-to-use, domain-specific editing interfaces for their wiki
 * Semantic Compound Queries - allows for displaying multiple queries at the same time
 * Semantic Internal Objects - allows for storing compound, "n-ary" data on pages
 * Semantic Drilldown - defines an easy browsing tool for the data set
 * Semantic Maps - allows for using various map services to display semantic coordinate data and enter coordinates within forms
 * Semantic Tasks - allows for sending reminder and notification emails to users for tasks
 * Semantic Forms Inputs - provides additional input types for Semantic Forms

There are other extensions included in Semantic Bundle that, though they do not use Semantic MediaWiki directly, are often used in conjunction with SMW. These are:
 * Admin Links - defines a special page that serves as a "control panel" for administrative tasks
 * Approved Revs - allows for setting a single revision of any page as the "approved" one; the approved revision's data is stored by SMW
 * ArrayExtension - defines useful parser functions for manipulating arrays
 * Data Transfer - allows importing data into and out of the wiki via XML and CSV formats
 * External Data - allows for displaying data from outside APIs in the wiki
 * Header Tabs - allows to convert top-level sections of the page into tabs; often used with Semantic Forms to make long forms more user-friendly
 * Maps - allows for displaying individual points and geocoding addresses using various map services; required by Semantic Maps
 * Page Object Model (POM) - a code library that helps extension and bot developers manipulate parts of structured wiki text easily using a model similar to the W3C DOM. It is also a MediaWiki API extension to perform such modifications remotely.
 * ParserFunctions - adds useful parser functions for programming logic and string manipulation
 * Replace Text - provides a form for administrators to do a text search-and-replace across the wiki
 * Validator - validates the input for parser functions and the like; required by both Maps and Semantic Maps
 * Widgets - allows adding widgets to wiki by simply creating pages in the Widget namespace

Semantic Bundle is not at all meant to be a comprehensive set of useful extensions, and there are many other extensions that are also quite useful, either in conjunction with SMW or in general, that were not included in the bundle, for technical or other reasons; we would encourage administrators setting up an SMW-based wiki to look at the wide variety of other extensions available. Some of these helpful extensions include CategoryTree, Configure, ConfirmEdit, FCKeditor, Halo, OpenID, reCAPTCHA, Semantic Signup and SemanticQueryFormTool.

Download
Semantic Bundle is available either as a downloadable .zip, 7z or .tgz file, or via SVN. You can get these files at the download page of the Semantic Bundle Google Code project. Once you have the .zip, 7z or .tgz file, you should move it to the /extensions directory and extract it there.

Downloading using SVN (experimental)
'''WARNING! This is experimental! You must know what you're doing!'''

This process modifies the externals definitions for  folder of the MediaWiki - make sure you do not check these externals into MediaWiki repository (although you would need to have commit rights to the MediaWiki repository to be able to do this).

To install bundle from SVN repository and maintain current version, change to  folder and type:

svn checkout http://semantic-mediawiki-bundle.googlecode.com/svn/trunk/ semantic-bundle

bundle building code will be checked out into. Change into it and run the following command:

make ext

this will create SVN externals in your  folder for all the extensions in the bundle and will automatically run svn update to fetch all the components of the bundle.

To check out development releases (trunks) of all the extensions in the bundle instead, run

make ext-dev

this will modify the externals and run update again switching over to trunk releases.

NOTE: if your MediaWiki is not managed using SVN, you can get the latest version of Semantic Bundle using the SVN command above, then type

make all

which will build a .tgz file which you can extract in your  directory.

Installation

 * 1) Extracting the files will create directories under  for each of the extensions contained in Semantic Bundle.
 * 2) Enter " " directory, and you can see , and   among several files.
 * 3) * contains calls to include all the extensions that Semantic Bundle contains. The calls to recommended extensions that every SMW-based wiki should use are not commented out, and the commented out ones are to optional extensions.
 * 4) Copy the existing  file to a new file named.
 * 5) *Don't refer directly to the sample configuration file within, any changes you make to sample file   will be lost while upgrading your version of Semantic Bundle.
 * 6) Include  and   within
 * 7) * holds version information for Semantic Bundle, it can help with debugging. It is also a good marketing for the Semantic Bundle project, so we ask you to please consider including it.
 * 8) Initializing Semantic MediaWiki.
 * 9) *Make sure you are logged in as an Administrator, such as the WikiSysop user.
 * 10) *Go to, click on the "Initialize or upgrade tables" button.
 * 11) *Note: If mediawiki stops working, you may need to temporarily uninclude the Semantic Forms extension and the Semantic Forms Inputs extension (and possibly others), for this page to show up correctly; once the tables have been created, you can re-add all the extensions. Sorry, this isn't very user friendly.
 * 1) *Go to, click on the "Initialize or upgrade tables" button.
 * 2) *Note: If mediawiki stops working, you may need to temporarily uninclude the Semantic Forms extension and the Semantic Forms Inputs extension (and possibly others), for this page to show up correctly; once the tables have been created, you can re-add all the extensions. Sorry, this isn't very user friendly.

For more information see installation and configuration sections for each extension.

Benefits
Semantic Bundle provides a number of important benefits over downloading and installing individual extensions; among them:
 * it provides a "best practices" set of extensions around Semantic MediaWiki, based on user experiences
 * it simplifies download, especially for those systems that don't have SVN, and especially for those extensions (like ParserFunctions) that don't have a downloadable version already
 * it tries to guarantee working code by using tagged, stable versions of extensions whenever possible
 * it simplifies installation by providing a pre-generated list of includes

Authors
Semantic Bundle was created, and is maintained, by Sergey Chernyshev, Yaron Koren and Jeroen De Dauw.

License
Semantic Bundle uses the BSD license.

Each extension in the bundle uses its own license, however: please consult extension pages for licensing details.

More information
More information, and bug reporting, is available at the Semantic Bundle Google Code page.