BBCode (PEAR) plugin version 1.3.1 for WordPress 1.5+ by Ben XO (http://www.ben-xo.com/) http://www.ben-xo.com/v6/wordpress-twiki-bbcode-plugin/ Release Date: 4th Jan 2006 This plugin allows BBCode markup to be used in the content, excerpt, and comments of WordPress. Uses PEAR::Text_Wiki_BBCode. You can read more about BBCode here: http://www.phpbb.com/phpBB/faq.php?mode=bbcode You can read more about PEAR::Text_Wiki_BBCode here: http://pear.php.net/package/Text_Wiki_BBCode ** PLEASE CHECK THE WEBSITE FOR THE LATEST VERSION BEFORE GOING ANY FURTHER! ** ** http://www.ben-xo.com/v6/wordpress-twiki-bbcode-plugin/ ** PREFACE: -------- This plugin comes in 3 versions! * BUNDLED (with PEAR::Text_Wiki 1.0.3-xo and PEAR::Text_Wiki_BBCode 0.0.2-xo) * STANDALONE (uses PEAR::Text_Wiki_BBCode already installed on your web server) * ROLL-YOUR-OWN (this is the STANDALONE version where you've downloaded your own version of PEAR::Text_Wiki_BBCode and turned it into your very own BUNDLED version) *PLEASE NOTE* The "BUNDLED" version of this plugin behaves somewhat like vBulletin rather than phpBB. It uses my own slightly modified versions of Text_Wiki and Text_Wiki_BBCode. The differences are as such: 1) [raw]...[/raw] code to allow real HTML! 2) [size=...] works like vBulletin, which means they are sizes 1-7 and also +1, +2, ... +7 and -1, -2, ... -7 are the allowed sizes. In phpBB, you specify a point size such as 12, 18, 24, 36. YOU PROBABLY WANT THE BUNDLED VERSION UNLESS THE OFFICIAL VERSIONS ARE MUCH NEWER THAN MINE. Read on to make your decision! WHICH VERSION IS FOR ME? ------------------------ You need the **BUNDLE** version if: * You have absolutely no idea what version of PEAR::Text_Wiki_BBCode your web server has, * Or: your web server is missing PEAR::Text_Wiki_BBCode * Or: your web server has PEAR::Text_Wiki_BBCode version 0.0.2 or lower * Or: you frankly don't care which version it has and just want to get on with this You need the **STANDALONE** version if: * PEAR::Text_Wiki_BBCode is already installed on your server ...and you're already using it ...and you are happy with how it works! * Or: the official version of PEAR::Text_Wiki is significantly better than 1.0.3 ...and you want the extra features ...and you can install it on your web server. * Or: the official version of PEAR::Text_Wiki_BBCode is significantly better than 0.0.2 ...and you want the extra features ...and you can install it on your web server. You need the **ROLL-YOUR-OWN** version if: * You would have chosen the Bundle version, but: * ...it sucks compared to what a bright, new, modern version of Text_Wiki_BBCode can do * ...but you can't install Text_Wiki_BBCode on your web server At the time of writing Text_wiki_BBCode is still in development, and I've made some small changes to it to make it more friendly to use as a plugin for WordPress in the bundled version. In the future, I hope that these changes will make it into the official version of PEAR::Text_Wiki_BBCode. If they do, then it will probably make more sense to use the Standalone version of this WordPress plugin instead of using the bundled one. Check here for the latest versions: http://pear.php.net/package/Text_Wiki (1.0.3 is latest version at time of writing) http://pear.php.net/package/Text_Wiki_BBCode (0.0.2 is latest version at time of writing) If there are no newer, you almost certainly want the BUNDLED version - please check. The BUNDLED version will have the vBulletin BBCode behaviour. The other two versions will have the phpBB BBCode behaviour. (The differences are listed in the PREFACE above.) INSTALLATION (BUNDLE): ---------------------- 1) upload text_wiki_bbcode.php into wp-content/plugins 2) upload the Text_Wiki folder into wp-content/plugins 3) Activate the plugin. That's it! INSTALLATION (STANDALONE): -------------------------- 1) You must already have PEAR::Text_Wiki and PEAR::Text_Wiki_BBCode installed on your server. *If you're not sure, use the bundled version instead of this version* 2) upload text_wiki_bbcode.php into wp-content/plugins 3) Activate the plugin. That's it! 4) Optional: if wordpress is now completely broken, that means you should have chosen the BUNDLE version. So download that and install it. This will probably fix everything. INSTALLATION (ROLL-YOUR-OWN): ----------------------------- We're going to start with the STANDALONE version and make our own BUNDLE version! 1) Make a folder called Text_Wiki in wp-content/plugins. IT MUST BE CAPITALIZED EXACTLY LIKE THAT! 2) Download the latest version of Text_Wiki and Text_Wiki_BBCode from the URLs above. 3) Extract Text_Wiki somewhere. 4) Find the folder "Text" (which contains another folder called "Wiki" and other things). 5) Upload the whole "Text" folder into wp-content/plugins/Text_Wiki 6) Extract Text_Wiki_BBCode somewhere. 7) Find the folder "Text" (which contains another folder called "Wiki", just as before). 8) Upload the whole "Text" folder into wp-content/plugins/Text_Wiki, OVER THE TOP of what's already there. 9) upload text_wiki_bbcode.php into wp-content/plugins 10) Activate plugin. Hurrah! That's it. USAGE: ------ You may now use BBCode as per you can in vBulletin or phpBB and other bulletin boards, in your posts, comments and excerpts! Additionally, if you are using the BUNDLED version, you may use raw HTML by putting it inside of [raw]...[/raw]. This may work in the STANDALONE and ROLL-YOUR-OWN versions too, depending on what's gone into the official versions of Text_Wiki, but it's not there at the time of writing. BUGS: ----- Almost as certain death and taxes. CHANGELOG: ---------- Jan 4th 2006 v1.3 initial public release. Jan 17th 2006 v1.3.1 fixed include_path bug for Windows users. -- Ben XO (me@ben-xo.com)