{"id":147893,"date":"2013-08-23T08:14:32","date_gmt":"2013-08-23T15:14:32","guid":{"rendered":"http:\/\/css-tricks.com\/?p=147893"},"modified":"2013-08-26T10:12:18","modified_gmt":"2013-08-26T17:12:18","slug":"the-move-to-bbpress","status":"publish","type":"post","link":"https:\/\/css-tricks.com\/the-move-to-bbpress\/","title":{"rendered":"The Move to bbPress"},"content":{"rendered":"<p>The Forums on CSS-Tricks started life as <a href=\"https:\/\/www.phpbb.com\/\" rel=\"noopener\">phpBB<\/a> sometime in 2008. There is even an <a href=\"https:\/\/css-tricks.com\/video-screencasts\/48-skinning-phpbb\/\">ancient video<\/a> of how to apply a basic skin. Sometime in 2010 I moved them to <a href=\"http:\/\/vanillaforums.org\/\" rel=\"noopener\">Vanilla Forums<\/a> in a response to heavy spam and the general unwieldy nature of phpBB. Now in 2013, the forums have been moved yet again, this time to <a href=\"http:\/\/bbpress.org\/\" rel=\"noopener\">bbPress<\/a>.<\/p>\n<p><!--more--><\/p>\n<p>This move was inspired by a few things.<\/p>\n<ul>\n<li>Heavy spam again, with nowhere to turn to fight it. One plan was to force email verification, but that setting had a bug where emails would never get verified and bug users forever. I could never find a fix.<\/li>\n<li>I didn&#8217;t love the theming. It was hard for me to figure out what stuff was in what files, then when I did figure it out, you had to copy that entire file over to your theme and customize it there. That made it safe to upgrade, but also meant that upgrading didn&#8217;t do anything because you are overriding any new changes.<\/li>\n<li>The Vanilla community is fairly small and I didn&#8217;t find it particularly helpful. I&#8217;m sure they are nice folks, but I could never seem to get the help I needed.<\/li>\n<li>Every other part of this site is powered by WordPress, so bringing it all under one roof was mega appealing. bbPress is just a plugin for WordPress now, meaning an account on CSS-Tricks works for the Forums, The Lodge, and for commenting on the blog. Not to mention spam blocking via Akismet and custom controls (we were getting terrible &#8220;Kitchen&#8221; related spam, and now I just mark as Pending any new thread that has that word in it.)<\/li>\n<\/ul>\n<h3>The Conversion Process<\/h3>\n<p>bbPress ships default with an import tool. It&#8217;s in the admin under Tools > Forums > Import Forums once the plugin is activated. <\/p>\n<figure id='post-147931 media-147931' class='align-none'><img src='https:\/\/i0.wp.com\/css-tricks.com\/wp-content\/uploads\/2013\/08\/importer.png' alt='' data-recalc-dims=\"1\" \/><\/figure>\n<p>It specifically works with Vanilla as well as several other popular forum software products. All I did was give it the information it needed to connect to the database, check that I wanted to import users as well, and let it run. <\/p>\n<p>It moves everything into your normal WordPress database. There were over 100,000 posts in there, and it moved them all in about 4-5 hours. Normally database operations are pretty fast, but it makes sense that it takes this long in this case. It specifically only moves a little bit at a time and waits in between requests. This is a live site after all, and best not to hammer it. I did take down the Vanilla forums while this was going on, so no new posts would be made that would be lost. It did hang a few times during the process, but luckily the converter is smart. It saves its progress along the way and when you restart it, it restarts from where it left off.<\/p>\n<h3>The Transition<\/h3>\n<p>Categories moved over to new &#8220;Forums&#8221; perfectly. The forums were largely ready to rock as soon as the conversion was done. <\/p>\n<p>I was ready to accept that old forums URL&#8217;s would just be broken. Kind of a bummer, but not too tragic as it wasn&#8217;t ultra-common to link to threads out in the wild and Google would catch up fairly quickly. However that didn&#8217;t need to happen!<\/p>\n<p>The old URL&#8217;s were like:<\/p>\n<pre><code>https:\/\/css-tricks.com\/forums\/discussion\/23936\/opinions-on-css-frameworks<\/code><\/pre>\n<p>And the new URL&#8217;s:<\/p>\n<pre><code>https:\/\/css-tricks.com\/forums\/topic\/opinions-on-css-frameworks\/<\/code><\/pre>\n<p>That was close enough to RegEx, and <a href=\"https:\/\/twitter.com\/_MattDolan\/status\/360044190618497024\" rel=\"noopener\">Matt Dolan had the answer<\/a> for me:<\/p>\n<pre rel=\"HTAccess\"><code class=\"language-markup\">RewriteRule ^forums\/discussion\/[0-9]+\/(.+)\/?$ \/forums\/topic\/$1\/ [R=301,L]<\/code><\/pre>\n<hr>\n<p>Another concern was user accounts. Any user who had a Lodge account (i.e. anyone who backed me on Kickstarter or had since signed up) who also had a forums account ran the risk of having the same username on WordPress as they were using on Vanilla. My own account had the same problem. <\/p>\n<p>Fortunately bbPress import is smart about this and creates the new user under username &#8220;imported__OLD_USERNAME&#8221;. Like so:<\/p>\n<figure id='post-147933 media-147933' class='align-none'><img src='https:\/\/i0.wp.com\/css-tricks.com\/wp-content\/uploads\/2013\/08\/old-username.png' alt='' data-recalc-dims=\"1\" \/><\/figure>\n<p>If a user expresses any confusion on this, I can easily fix it. I simply delete the &#8220;imported_&#8221; user and choose to attribute all posts to the old user.<\/p>\n<figure id='post-147934 media-147934' class='align-none'><img src='https:\/\/i0.wp.com\/css-tricks.com\/wp-content\/uploads\/2013\/08\/delete-user.png' alt='' data-recalc-dims=\"1\" \/><\/figure>\n<p>There is <a href=\"http:\/\/wordpress.org\/plugins\/username-changer\/\" rel=\"noopener\">a plugin for changing usernames<\/a> too, if anyone ends up wanting to do that.<\/p>\n<hr>\n<p>Passwords were the final hiccup. Of course the passwords are encrypted, so there is no way to import them from one system to the other. I just put up a notice in the forums that let people know that if they had any trouble logging in to just reset their password and it was fine (and expected).<\/p>\n<h3>Using Markdown<\/h3>\n<p>Why use Markdown as the language for users to write comments, replies, and new threads? There are a bunch of reasons. On any system that allows users to write and post what they write, you&#8217;ll at the very least need some auto-paragraphing. If people type a bunch of text then return-return, you&#8217;ll want to display it as two paragraphs. WordPress has autop, but Markdown also does this. <\/p>\n<p>The more obvious advantage to Markdown is that it makes it easier to &#8220;just type&#8221; out a response. Italic\/Emphasize something by *putting asterisks around it* or **bold** it. Links are just [link](url). Quotes are just paragraphs that start with >. <\/p>\n<p>But what made it very important to me is the code escaping. People post a good amount of HTML in the comments and in the forums. They shouldn&#8217;t have to go out and escape all that HTML just to post it (e.g. turn &lt; into &amp;lt;). Markdown auto-escapes code that you intentionally are specifying as code (e.g. it is within `backticks` or indented 4 spaces). That is extremely helpful.<\/p>\n<p>That combined with WordPress general safety stuff (e.g. stripping <code>&lt;script&gt;<\/code> tags) makes it a pretty nice system.<\/p>\n<p>I use the <a href=\"http:\/\/wordpress.org\/plugins\/wp-markdown\/\" rel=\"noopener\">WP-Markdown<\/a> plugin by <a href=\"http:\/\/stephenharris.info\/\" rel=\"noopener\">Stephen Harris<\/a> which works both in comments and in bbPress. I ended up finding a few bugs with my setup, so I got the help of <a href=\"http:\/\/zaowebdesign.com\/\" rel=\"noopener\">Justin Sainton<\/a> to get it working just right. At this second, there is one more little bug regarding lists in Markdown to sort out, but after that I can send anyone the patched version of WP-Markdown if they want it. Stephen is aware of the changes and thinking they might not be right for the public version.<\/p>\n<h3>The Aftermath<\/h3>\n<p>One of the big bugs after launch was a login issue where users would log in, change pages, and appear to be logged out (<a href=\"http:\/\/www.youtube.com\/watch?v=AMALI4FmlUE&#038;feature=youtu.be\" rel=\"noopener\">as demo&#8217;d here<\/a>). It seemed like a caching issue to me. I use W3 Total Cache for that, but I had that set to not cache anything in the forums or anything for any logged in user.<\/p>\n<p>So far, my best guess is that it&#8217;s browser-level caching. I found this in the .htaccess:<\/p>\n<pre rel=\"HTAccess\"><code class=\"language-markup\">ExpiresByType text\/html A3600<\/code><\/pre>\n<p>&#8230;which is the content-type for the document when pages are served. So that would make sense the the browser was trying to hang onto that page. I removed it, but it looks like something that W3 Total Cache adds by default so it gets re-added when those settings are changed. I&#8217;ll see if they have any thoughts on this.<\/p>\n<hr>\n<p>The very next day there was a bunch of &#8220;Kitchen&#8221; spam again, which was amazing to me. That tells me the spammers are very likely human beings, which also explains how they got through the CAPTCHA effortlessly.<\/p>\n<p>All I had to do though was Settings > Discussion > Comment Moderation and put those words in there and it has all but stopped.<\/p>\n<figure id='post-147936 media-147936' class='align-none'><img src='https:\/\/i0.wp.com\/css-tricks.com\/wp-content\/uploads\/2013\/08\/kitchen.png' alt='' data-recalc-dims=\"1\" \/><\/figure>\n<h3>The Future<\/h3>\n<p>I have a variety of functionality stuff I&#8217;d like to add via Plugin, and am looking for someone who wants to take on any of these as a freelance job.<\/p>\n<ul>\n<li>Alteration to WP-Markdown to allow GitHub flavored Markdown.<\/li>\n<li>A plugin that allows the original poster of a thread to (or an admin) to mark a particular answer as &#8220;the answer&#8221;. That reply would get a special class so it can be styled, and the thread itself when shown in the forum list will get a special class so it can be marked as &#8220;solved&#8221; there.<\/li>\n<li>An alteration to one of the &#8220;Mark as Read&#8221; plugins which allows you to 1) mark everything as read and 2) will auto-mark a thread as read when you open it.<\/li>\n<li>An alteration to the <a href=\"http:\/\/wordpress.org\/plugins\/feature-comments\/\" rel=\"noopener\">Feature Comments plugin<\/a> that makes it work with bbPress also.<\/li>\n<li>A plugin that will send a user an email notification when they are @replied in a reply.<\/li>\n<li>A plugin that will &#8220;Clean up users&#8221; &#8211; e.g. auto-delete users that have 1) no associated posts anywhere on site 2) haven&#8217;t logged in in X time 3) have no gravatar. I have a lot of spam users this would clean up.<\/li>\n<li>A plugin that would allow any users to &#8220;Report this topic&#8221; &#8211; in case it is spam or inappropriate.<\/li>\n<li>Some kind of way to allow forum moderators to see the &#8220;Pending&#8221; queue of posts that require moderation and publish\/delete\/spam them.<\/li>\n<li>A &#8220;Nuke&#8221; plugin &#8211; When an admin sees a spam post, they can &#8220;Nuke&#8221; it which 1) deletes it 2) deletes everything else that user has posted. 3) deletes the user.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>The Forums on CSS-Tricks started life as phpBB sometime in 2008. There is even an ancient video of how to apply a basic skin. Sometime in 2010 I moved them to Vanilla Forums in a response to heavy spam and the general unwieldy nature of phpBB. Now in 2013, the forums have been moved yet [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"sig_custom_text":"","sig_image_type":"featured-image","sig_custom_image":0,"sig_is_disabled":false,"inline_featured_image":false,"c2c_always_allow_admin_comments":false,"footnotes":"","jetpack_publicize_message":"","jetpack_is_tweetstorm":false,"jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":[]},"categories":[4],"tags":[],"jetpack_publicize_connections":[],"acf":[],"jetpack_featured_media_url":"","jetpack-related-posts":[{"id":253157,"url":"https:\/\/css-tricks.com\/plugins-loaded\/","url_meta":{"origin":147893,"position":0},"title":"Plugins Loaded","date":"March 25, 2017","format":false,"excerpt":"A huge high-five to John James Jacoby for his help here on CSS-Tricks fixing up our Markdown + bbPress integration. John runs Plugins Loaded, a source of high-quality WordPress plugins that you can use for free, or choose to pay to support.","rel":"","context":"In &quot;Article&quot;","img":{"alt_text":"","src":"https:\/\/i0.wp.com\/css-tricks.com\/wp-content\/uploads\/2017\/03\/plugins-loaded.png?fit=1067%2C1200&ssl=1&resize=350%2C200","width":350,"height":200},"classes":[]},{"id":1008,"url":"https:\/\/css-tricks.com\/from-the-forums\/","url_meta":{"origin":147893,"position":1},"title":"From The Forums","date":"September 12, 2008","format":false,"excerpt":"Yesterday I \"upgraded\" the forums from phpBB 3.0.0 to 3.0.2. It was a bit of a debacle, probably mostly my fault, and it was down for a lot of the day. It's back up and running now though! Apparently it fixed an issue one user was having with IE 7,\u2026","rel":"","context":"In &quot;Article&quot;","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":7789,"url":"https:\/\/css-tricks.com\/custom-vanilla-forums-work-by-trademark-productions\/","url_meta":{"origin":147893,"position":2},"title":"Custom Vanilla Forums Work by Trademark Productions","date":"November 3, 2010","format":false,"excerpt":"I had some custom Vanilla Forums work done by Trademark Productions. This is my thank you to them and how my experience went down.","rel":"","context":"In &quot;Article&quot;","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":803,"url":"https:\/\/css-tricks.com\/forums-now-have-rss-feed\/","url_meta":{"origin":147893,"position":3},"title":"Forums Now Have RSS Feed","date":"June 21, 2008","format":false,"excerpt":"It blows my mind that phpBB doesn't come with RSS feeds for forums. The new v3 is incredibly nice in so many other ways, it seems like it would have been a trivial addition for such a talented dev team. But what do I know. Fortunately, a kind forum reader\u2026","rel":"","context":"In &quot;Article&quot;","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":248638,"url":"https:\/\/css-tricks.com\/state-word-2016\/","url_meta":{"origin":147893,"position":4},"title":"State of the Word 2016","date":"December 4, 2016","format":false,"excerpt":"Some highlights-of-highlights, based on Brian Krogsgard's post: BuddyPress and bbPress will get new support and engagement over the next year. WordPress 4.6 was available in 50 languages the day it was released. the REST API [endpoints] get included in WordPress 4.7. WordPress.com is now fully on PHP7. WordPress.org will now\u2026","rel":"","context":"In &quot;Link&quot;","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":7309,"url":"https:\/\/css-tricks.com\/how-long-should-we-ban-ips\/","url_meta":{"origin":147893,"position":5},"title":"How Long Should We Ban IPs?","date":"September 3, 2010","format":false,"excerpt":"There are all kinds of reasons IPs get banned. A forums manager might ban an IP because the user at it is spamming. An admin of an email server might also ban IPs for spamming. A web service might ban an IP for using an API in an unapproved way.\u2026","rel":"","context":"In &quot;Article&quot;","img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"featured_media_src_url":null,"_links":{"self":[{"href":"https:\/\/css-tricks.com\/wp-json\/wp\/v2\/posts\/147893"}],"collection":[{"href":"https:\/\/css-tricks.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/css-tricks.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/css-tricks.com\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/css-tricks.com\/wp-json\/wp\/v2\/comments?post=147893"}],"version-history":[{"count":7,"href":"https:\/\/css-tricks.com\/wp-json\/wp\/v2\/posts\/147893\/revisions"}],"predecessor-version":[{"id":148169,"href":"https:\/\/css-tricks.com\/wp-json\/wp\/v2\/posts\/147893\/revisions\/148169"}],"wp:attachment":[{"href":"https:\/\/css-tricks.com\/wp-json\/wp\/v2\/media?parent=147893"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/css-tricks.com\/wp-json\/wp\/v2\/categories?post=147893"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/css-tricks.com\/wp-json\/wp\/v2\/tags?post=147893"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}