Disqus comment threads on a docpad homepage

27 Feb 2014, 2 minute read

I really do get on well with docpad. Adding comments to the homepage blog entry was a little tricky though, so here’s the workaround I applied.

Despite wanting to move to a JVM-based static site generator, docpad does too many things to make me want to leave. It’s not perfect, but it has plugins to solve mosts of your basic problems, and is nicely hackable. Plus it’s written in CoffeScript, which is always a plus. The services plugin provides a neat way to inject Disqus comment threads into your pages. It’s almost zero configuration and works reliably, but it doesn’t work when you’re rendering dynamic content, for example the latest blog post on your home page.

Everything worked well until Disqus got confused. First it displayed the comments from a blog post on the homepage when it was no longer correct. Then it just started displaying the comment thread on all pages which didn’t have their own threads already. Not so good.

Fortunately Disqus support were very responsive, and got back to me explaining the problem: the Disqus widget doesn’t just need the title, it also needs a unique URL in its config. The services plugin doesn’t work for this, as it always gets the current page URL, so here’s a modified version of the original script which takes a post as a parameter so you can load dynamic comment threads wherever you like.

All you need to do is add the following to your docpad.cofee, I put it in the helpers section:

Then you can add the comments to your index page, like so:

I will submit this as a pull request just as soon as I figure out how to do it elegantly :), but this will do as a workaround for now.


Was this post useful? Why not help others find it by sharing on twitter. While you're there, get in touch and let me know what you think!

Using Grails respond for HTML, JSON and XML responses Testing Rhino JavaScript with Eclipse, Gradle, Groovy and Spock

Hi, I'm Ryan

I care about code, building great teams and the community. I run Slate Horse but I'm still a full-stack developer. Previously co-organiser of JSOxford and OxRUG.

Get in touch