=== WordPress Wiki That Doesn't Suck ===
Contributors: jazzs3quence
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=AWM2TG3D4HYQ6
Tags: wiki, custom post types, support
Requires at least: 3.0
Tested up to: 3.2.1
Stable tag: 0.7
A WordPress Wiki that works.
== Description ==
Okay, so I wanted to add a wiki to my site that sells commercial themes. I've already got a support forum powered by BuddyPress, so the idea was that this would be for more static articles. Problem: I hate MediaWiki. I know BBCode and HTML and PHP and CSS and the wiki markup just baffles me. I can never remember how to do the *simplest* things, like create a freaking link. Really? All I want to do is throw a `` in there. If you're looking at this plugin, you know what I'm talking about. Problem Number 2: Currently, the WordPress plugins available for what I want to do either *aren't* what I want to do, or don't work with the latest version of WordPress. Hence this plugin.
*WordPress Wiki That Doesn't Suck* uses custom post types. And that's pretty much it. It creates a new custom post type (`wpwtds_article`) that can be accessed from the *Wiki != suck* menu it adds to your sidebar (!= is "not equal to" in coder jargon). Wiki articles are posted with the `wiki` slug, so your URLs will look like `http://mydomain.com/wiki/my-cool-article`.
== Installation ==
1. Unpack the zip file and upload to the `/wp-content/plugins/` directory or use the Add New Plugin option in WordPress to install.
2. Activate the plugin through the *Plugins* menu in WordPress.
3. Start writing articles!
== Frequently Asked Questions ==
= Can I change the default slug? =
Currently, no. I planned on adding this in...but I didn't. If you're interested in being a contributor and adding stuff that's missing, you're more than welcome to contact me.
= Why isn't *x* feature included? =
Basically, I had a specific need, custom post types seemed like the best answer. Plus, once it was done, I couldn't think of anything else it really needed.
= This isn't a *wiki* really, is it? I mean, there's no real way to contribute like a real Wiki... =
This wasn't a concern for me, since I just wanted someplace I could post support docs that was public. That said, presumably generic WordPress user roles will still work, so if you're an *Author* you'll be able to post new wiki articles, same as anything else.
= I've installed it, now what? =
After you install the plugin, wiki articles will use your theme's default `single.php` template file. You may want to actually *use* your wiki, as in have an actual wiki page, and for that, you'll need to add a custom template to your theme. We'll be providing a default template to use, but more than likely you'll need to modify it slightly to fit your specific theme. As of 0.6.2, I've added some example template files to the /templates directory in the plugin that you can copy to your theme and use for your wiki pages. Your mileage may vary as these will likely depend on the theme you are using, so you may need to modify the templates to fit the layout of your theme.
The best reference I can give you for working with custom post types (if you wanted to make your own wiki main page, for instance) is the Custom Post Types article in the Codex. The only thing you need to know is that the post types are identified as `wpwtds_article`s.
== Screenshots ==
1. WordPress Wiki That Doesn't Suck articles page
2. Edit/Add New article page
== Changelog ==
**Version 0.7**
* added inline documentation
* added custom HTML meta area that can be used in wiki template files
* added meta area in sample `single-wpwtds_article.php`
**Version 0.6.3**
* removed blank spaces at the end of file (kills 'headers already sent' error)
**Version 0.6.2**
* updated stable tag and tested up to
* updated requirements (since custom post types didn't exist in 2.8)
* fixed menu image and path to menu image
* added post type header image
* added wpwtds_ prefix to create_post_type function
* added wpwtds_section taxonomy to allow wiki posts to be split into different categories
* customized columns
* added example template files to the /templates directory
* added screenshots
**Version 0.6.1**
* updated `readme.txt`
**Version 0.6**
* added `with_front` qualifier to the `rewrite` option to use it's own permalink structure.
**Version 0.5**
* first public release
== Upgrade Notice ==
Nothing to see here.