Extension:Include WP

IncludeWP is a lightweight extension for including Wikipedia content into your wiki.

Feature overview

 * Include articles from Wikipedia or any other MediaWiki wiki into your pages.
 * Show only a limited amount of paragraphs on page load, with an option to show the full article.
 * Partial conversion to plain-text.
 * Removal of templates (such as infoboxes), ref tags, comments, categories and images.
 * Both internal and external links are rendered as plain-text.
 * Tables, lists, table of content, section headers and more are retained.
 * Usage of the MediaWiki Resource Loader when available with backward support for MW 1.16.x.

Download
You can find the current version of Include WP on the Google Code download page, as well as a list of legacy downloads.

You can also get the code directly from SVN. Tags can be obtained via

svn checkout http://svn.wikimedia.org/svnroot/mediawiki/tags/extensions/IncludeWP/REL_version

Where 'version' is the version number of the tag, such as 0_1 (see the available tags). The latest code can be obtained from trunk:

svn checkout http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/IncludeWP/

IncludeWP requires Validator 0.4.2 or above in order to work. A compatible copy of Validator always comes bundled with the regular releases, and is automatically loaded by IncludeWP, so you do not need to worry about it when using one of these. If you are getting the code from SVN, make sure you also get a copy of Validator (see here for instructions).

Installation
Once you have downloaded the code, place the IncludeWP and Validator directories within your MediaWiki 'extensions' directory. Then add the following code to your LocalSettings.php file:

Configuration
Configuration of IncludeWP is done by adding simple PHP statements to your LocalSettings.php file. These statements need to be placed AFTER the inclusion of IncludeWP. The options are listed below and their default is set in the Include WP settings file. You should NOT modify the settings file, but can have a look at it to get an idea of how to use the settings, in case the below descriptions do not suffice.

TODO

Usage
Description: Parser hook that allows displaying content of a Wikipedia article.

Implemented as both parser function and as tag extension.

Syntax
Tag extension with only the required parameters.



Tag extension with all parameters.



Tag extension with all parameters using the default parameter notation.

{page, Text}

Parser function with only the required parameters.

Parser function with all parameters.

Parser function with all parameters using the default parameter notation.

Version
This is a copy of the release notes file on SVN, which might be more up to date then this page.

Version 0.1
2011-02-13


 * Initial release

Possible improvements

 * Make the call to the remote API from the local API module. Currently the client makes a call to the remote API and then sends that to the local API, which is likely slower then the other approach.

Internationalization
Include WP is fully internationalized. Translation of Include WP messages is done through translatewiki.net. The translation for this extension can be found here. To add language values or change existing ones, you should create an account on translatewiki.net, then request permission from the administrators to translate a certain language or languages on this page (this is a very simple process). Once you have permission for a given language, you can log in and add or edit whatever messages you want to in that language.

Authors
Include WP has been written by Jeroen De Dauw.