The method I explain here gives you access to the MediaWiki API class as opposed to the standard MediaWiki rendering class. Most of this code came from MediaWiki’s api.php which you can find in MediaWiki 1.13.

Here’s what the API output will look like for the Foobar page on Wikipedia (in XML).

I spent quite a bit of time poking around in the MediaWiki /includes directory and trying different hack-ish methods before this page that had exactly what I needed! It did need updating, but I was happy to oblige. I even had this whole post written up using a sloppier approach before finding the FauxRequest class that I explain below.

The code

Let’s start with the sample code, then go over the details.

$mediawiki_root = '/Users/eyeRmonkey/www/mediawiki-test';
putenv("MW_INSTALL_PATH=$mediawiki_root");
// Initialise common code
require ($mediawiki_root . '/includes/WebStart.php');

class MediaWikiAPIWrapper {
	public function make_fake_request($params) {
		$request = new FauxRequest($params, true);

		$api = new ApiMain($request);

		// Process data & use an output buffer to capture the resutls
		$api->execute();
		$result = $api->getResult();
		$data = &$result->getData();

		return $data;
	}
}

Initializing

The first matter of business is lines 1 through 4. These need to be called outside of any function or class. I spent some time trying to figure out why none of MediaWiki’s global variables were showing up in print_r($GLOBALS) before thinking to require_once() it outside of any functions. Duh. Make sure you get the path to your MediaWiki installation root correct (no trailing slash, obviously).

Most of the work get’s done on line 4. This get’s all the code ready for a standard API call from the web. This whole approach is meant to be used by an extension, so we need to play catchup by initializing the core MediaWiki code.

Faking the Request

The good folks at MediaWiki were are kind enough to provide us with a class specifically meant for faking an API request! Joy! It’s called FauxRequest and it extends the WebRequest object that is used by default for API calls. The FauxRequest class takes an array of keys and values that represent what would’ve been passed in the URL.

The API manual has more information on formats and different queries you can make to the API.

Here is what your $params array might look like to grab the Main Page:

$data = array(
		'action' => 'parse',
		'page' => 'Main_Page'
	);

Running the API

Lines 10 through 15 create an instance of the API and pass in our FauxRequest object to get things rolling!

The $data array will hold all of the information that you would get from a format=php API call. As always, you could use print_r() to display the Array for debugging purposes.

That’s it!

mod_rewrite Issues

On my wiki, the .htaccess mod_rewrite rules that I have seem to be preventing the API from functioning totally correctly. A workaround I discovered is to use the following API call: /api.php?action=parse&title=Main_Page&text={{:Main_Page}}. This works by asking the API to translate the text parameter into rendered text. The {{:Main_Page}} says that the text is actually a transclusion-ed page. It’s definitely a hack, but it works on servers with weird rewrite rules for pretty URLs.

Further reading

• API: Query Properties
• API: Expanding templates and rendering – Relevant to the transclusion workaround.

Seize the moment of excited curiosity on any subject to solve your doubts; for if you let it pass, the desire may never return, and you may remain in ignorance.
-William Wirt

Ever since I first ran across this jewel of advice, I have always made an effort to apply it to my life. Whenever my interest in a certain subject flares, I make a point to explore it before my focus has a chance to shift elsewhere.

As of late, my excitement and curiosity have revolved around photography. I bought a Nikon D40 in June and have since only put it to good use on occasion. Since I purchased it, I’ve had a nagging sense that my photos weren’t turning out as interesting or “professional looking” as those taken by my friends who are amateur photographers. Part of this has to do with the fact that I’m not always as creative as I’d like. I also knew the source of my displeasure wasn’t the fact that I have an entry-level Nikon, because I’ve been told time and time again that the camera doesn’t matter.

Photo by Will Foster

It wasn’t until recently (while browsing Will Foster’s Flickr gallery) that I realized what my photos were missing: light. In retrospect, it seems so obvious. After all, in it’s simplest form, a photograph is just the capturing of light. All I’ve ever used is my D40′s pop-up flash (which leads to harsh lighting and harsh shadows in photographs). It had never occurred to me that a hot-shoe flash (or an off camera flash) could dramatically improve the quality of my photos.

After doing some research, I went out and bought a Nikon SB-600 Speedlight. The difference in my photos was noticeable right away. Below is a comparison of the D40′s pop-up flash and the SB-600. My roommate, Ryan, was happy to stand in for this experiment. The photo on the left was taken using the built-in pop-up flash on the D40. To the right we have a the remarkable results using the SB-600. The key to the second photo was that I angeled the flash head to bounce off the ceiling and then to Ryan. If you look at the larger version, you can really see the natural shading and definition on his face. An off camera flash (or two) could’ve produced even better results!

The day after I bought the speedlight, Will wrote a retrospective new years blog, in which, he mentioned a site called Strobist. I decided to check out the site, and after an hour or two, I finally came out of my trance of amazement. The site was packed to the brim with useful information for a photographer on a budget. The mantra as Strobist can be found at the top of every page on the site: Less Gear. More Brain. Better Light.

The Strobist community certainly takes these words to heart. They have entire series of courses designed to help you get your an inexpensive, off camera lighting system so you can get creative with your photos. I’m working my way through their Lighting 101 series right now. I ordered an “eBay trigger” so I can start wirelessly triggering my flashes. I’m already started preparing all my friends for the amount of modeling that I’ll be forcing them to partake in once those triggers arrive.

After my interest in photography was reignited, I started pillaging through my dad’s old gear which had been sitting in his closet for an eternity. I ended swiping an SB-15, an umbrella and a stand for the umbrella. I also ordered an extra flash trigger from eBay so I could fire the SB-15 remotely also.

I’m now on my way to doing some cool things with my photography. I plan on reading Strobist and other photography blogs on a regular basis. I also hope to be at the next Portland Strobist Photo Shoot. I’m also looking into building a DIY flash ring.

What have been some turning points in your photographic journey? Or more generally, what have you been excited about recently that you made a point to pursue?