Today, more than ever, an application needs to be able to integrate with other applications and the Discourse API allows you to easily integrate your Discourse forum with any other application. We do have a Ruby based API client, but your company or server might not support Ruby, so our documentation can easily be used to write an integration in any programming language through simple HTTP REST calls.
To aid in integrating with the Discourse API there are Postman files that you can import into your Postman app so that you can easily make API calls. Postman is a great tool that allows you to make API requests and see the HTTP status codes and responses. It can be a lot friendlier to use instead of a command line tool like cURL. Here is a demo:
What can you do with the API?
You can use the API to manage all aspects of users like creating new user accounts, suspending a user, logging off a user, and assign roles to a user.
You can also create and respond to topics, gather stats about users, send private messages, upload files, and pretty much anything else you can think of.
Discourse also has support for webhooks! This means that Discourse will send a POST request to an endpoint you specify every time an event triggers such as a new topic, new post, or a new user is created. This means that if you wanted to be notified every time someone mentions a specific keyword you wouldn’t have to poll Discourse every X minutes, but instead could just listen for the webhook event. Your app could then parse the topic and then use the API to send you a personal message in Discourse notifying you that keyword was used.
The Discourse API Docs are of course open source and so contributions are more than welcome. If you find a bug, an un-documented endpoint, or anything else please feel free open a pull request following the contributing instructions.
This brings the total Discourse team size up from 9 to 11 souls.
Where do we go from here? Everywhere! Can’t stop. Won’t stop.
More Discourses, more features, more plugins, more integrations. Maybe throw a few new Emoji in there for good measure while we’re at it. And all of it, always, 100% free and open source for you, forever.
* OK technically yesterday but come on that was a Sunday!
Thanks to Sam Saffron, we released an Official Android Discourse app and an official iOS Discourse app. These apps offer native push notifications and a way to aggregate all your Discourse sites in one place.
The apps are free to use for all, but do note that push notifications require special support from Apple and Google respectively, and are currently only available to sites hosted by us. As with all Discourse code, the app is 100% open source.
Improved Mobile Progress Expansion and Back Button
We’ve drastically improved the behavior of the Back button that appears on the timeline — both on desktop, and on mobile. You will see a back button pop up more reliably when you scroll up while reading a topic, so you never lose your place. And if you expand the mobile progress bar, you now have full access to the timeline, just like on desktop!
Revamped Categories Page
We noticed site owners struggled to decide what their home page should be: a static list of categories, or a dynamic list of topics. Both pages have their pros and cons, and you want to get it right, as the home page is the primary experience for most users.
We’ve added a new default which lets you have the best of both worlds — a set of relatively static categories for navigation on the left, and a list of the most recently updated topics on the right.
“Why not both?” indeed!
As much as we enjoy Discourse, we have to admit that our setup process wasn’t exactly.. fun. In this release we set out to change that.
When you set up a Discourse for the first time, you’ll now be greeted by the setup wizard, who helpfully walks you through all the steps to getting started with a brand new Discourse instance!
Thanks to Robin for this major improvement in ease of setup. We have plans to make the wizard even better in future releases, but it’s already worlds better than our previous “I hope you enjoy reading this wall of Getting Started text” strategy.
Onebox Everywhere and Start Topic With a Link
In all versions of Discourse, pasting a link on a line by itself resulted in “oneboxing”, or a quick expansion of the link into a title, summary, and picture. But only for certain whitelisted websites. In Discourse 1.7, we’ve extended this support to all links. Any link that supports OpenGraph or oEmbed will now onebox!
We also made it easier to start a topic with a link, as it’s so common to want to have a conversation about an article you read online. Simply paste a link into the title field and we’ll populate the body and title for you. And the resulting topic will show a link source, ala Reddit.
Redesigned Email Summaries
Email summaries are critical to the health of any Discourse instance — we automatically email anyone who hasn’t been seen on the site for a week with a “greatest hits” of the most interesting community discussions, with an eye on enticing them back to participate.
Since we mail a lot of these out, they need to be great. With the help of Rewphus from the community and Neil from our team, we completely redesigned the summary to make it more visually interesting and show more relevant stats to each user, such as now many new notifications they have, or how many new likes they’ve gotten (if available).
(Note that we only email people we haven’t seen once per week, for a maximum of year since we last saw them. Proper unsubscribe email headers are built in, plus a one-click link to unsubscribe.)
Advanced Search UI
We’ve improved basic search a few times, and we’ve added a number of advanced search terms, but they were hard to find and use. No longer! Thanks to community member cpradio, we now have a proper user interface for advanced search. Fill out exactly what you want to search for in a simple form — no complex commands required!
Enhanced Groups Pages
There’s been a lot of interest in more dynamic Groups pages, as well as continuing on our march toward making every @group first class citizens alongside every @user.
Guo Xiang Tan spent a few weeks improving our groups pages, adding descriptions and full names to groups, as well as letting people (if allowed by the group) to join and leave the group, or request membership to a closed group.
Although we didn’t uncover any critical vulnerabilities from our Hacker One program so far, we have benefited from several minor issues they uncovered. And we absolutely want to reward and publicly acknowledge anyone who privately discloses a security vulnerability that helps make Discourse safer for everyone. This is important to us, and we feel Hacker One gives us a framework for doing so, as well as “defense in depth.”
This is an important milestone, along with improved plugin versioning in this release, but there’s still much work to be done in ensuring safety and stability with third party plugins.
Ember 2.10 Latest
These are just highlights of 1.7 — there are literally hundreds of other tiny improvements, refinements, and bugfixes that we aren’t covering here, but are in the full release notes.
Easy One Click Upgrade
Who wouldn’t want all these fantastic new features? That’s reason enough to upgrade! But do note this is another major security release — we urge everyone to upgrade to it as soon as possible. Fortunately, upgrading is as easy as clicking the Update button in our simple one click updater. It’s linked right from your dashboard:
You may need to SSH in to update your server in some upgrade scenarios. But it’s easy!
Also, thanks to the greater Discourse community for their numerous contributions toward this release — translations in Transifex, posting support and bug requests on meta.discourse, or simply providing feedback based on extensive participation in multiple Discourse communities. All your suggestions make Discourse better for everyone.
For insight into what’s coming up in future releases of Discourse, keep an eye on the releases category at meta discourse. And now, onward to Discourse 1.8!