Fri Jan 21 2022 - ...
! This Article Contains Technical Jargon
What if we told you could have almost all the same essential functionality, but without using JS?
How to Use It
If you're using WordPress, the FastComments plugin version 3.10.1 automatically adds support for SSR as a fallback for your users that browse with JS disabled.
For custom implementations, fetch the UI for a comment thread, simply call the
/ssr/comments for that page:
$urlId is the url, or id, of the page. Documentation on this is here.
For example, with PHP we can send an iframe to the page that renders the comment thread inside:
We could also make an API call to get the HTML for a comment thread, and render, or store it.
Complete documentation is available in the SSR Docs at docs.fastcomments.com.
Because we love enterprise-sounding acronyms, don't worry, SSR supports SSO. An example of Single-Sign-On with SSR is here.
Why This Was Built
One of the main complaints about services like FastComments is that they require JS. We already make our comment widget slim as possible, and ensure we meet our API call SLAs of < 20ms, but many smaller communities won't pick such a solution if it means adding JS to their site.
FastComments uses its own small microframework for rendering the UI. This framework uses a similar approach to React, except that manual dom manipulations outside the initial render are allowed.
The core comment widget library has a single entry point - it takes a set of state and creates resulting HTML and CSS to be rendered. We simply call this on the server, too. When the user interacts with the page, the state is changed and the latest HTML fetched. This was built as a result of a hackathon that took place as part of the new year.
Since the UI is rendered by the server, one time, live commenting features are not available.
Additionally, the notifications bell is not currently available. We will be open to adding this feature in the future.
Crawlers and SEO
FastComments already works well with web crawlers; if SEO is a concern, using SSR is not required.
We plan on launching a Forum solution in the future. Traditionally, forums are paginated, and server-side rendered. Modern Forum solutions step away from this norm by using infinite scrolling and client side rendering. We don't think this has to be the only option for using a third party Forum solution.
We hope you've found this guide helpful and easy to read. Feel free to comment below with any questions.