Description
The main purpose of this plugin is to provide a page to display documentation. Not a Wiki per se, as its not intented to be collaborative (although it can be), rather, it just uses Custom Post Types to separate documentation articles from the rest of your content. This plugin came as a result of my undying hatred of MediaWiki. I know BBCode and HTML and PHP and CSS and still 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 youre looking at this plugin, you know what Im talking about. When this plugin was written the WordPress plugins available for what I want to do either arent what I want to do, or dont work with the latest version of WordPress. Hence this plugin.
WordPress Wiki That Doesnt Suck uses custom post types. And thats 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.
To display your wiki articles on a page, you can either use the included template files (in the /templates directory), or you can use the [wpwtds] shortcode thats been added in 0.9.
You can see WPWTDS in action at http://museumthemes.com/wiki/ and http://eventespresso.com/support/documentation/
Screenshots
Installation
- Unpack the zip file and upload to the
/wp-content/plugins/directory or use the Add New Plugin option in WordPress to install. - Activate the plugin through the Plugins menu in WordPress.
- Start writing articles!
- Use the
[wpwtds]shortcode or the included template file examples to display a list of wiki articles on your page.
FAQ
-
Not yet.
-
Basically, I had a specific need, custom post types seemed like the best answer. Plus, once it was done, I couldnt think of anything else it really needed.
-
This wasnt a concern for me, since I just wanted someplace I could post support docs that was public. That said, generic WordPress user roles will still work, so if youre an Author youll be able to post new wiki articles, same as anything else.
-
After you install the plugin, wiki articles will use your themes default
single.phptemplate file. You may want to actually use your wiki, as in have an actual wiki page, and for that, youll either need to add a custom template to your theme or use the[wpwtds]shortcode. To use the shortcode, all you need to do is add[wpwtds]on a post or a page and it will display a list of all your wiki articles.A default template that you can use is provided if you want to customize the layout. More than likely youll need to modify it slightly to fit your specific 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_articles.
