Widget

The widget is the ready-made comment section. It runs isolated from your page, follows your site's font and fetches the appearance you chose in the dashboard.

Install

Load the script once per page and call Qorum.montar with the element where the comments will appear:

<div id="comentarios"></div>
<script src="https://useqorum.com/widget.js"></script>
<script>
  const comments = Qorum.montar(document.getElementById('comentarios'), {
    key: 'pk_YOUR_PUBLIC_KEY',
    ref: 'post-42'
  });
</script>

Options

Without key or ref, the widget shows the notice "Qorum: missing key or ref" instead of the comments.

Methods

Qorum.montar returns an object with these methods:

Automatic mounting

If you'd rather not write JavaScript, use attributes. The widget looks for elements with data-qorum when the page loads:

<div data-qorum
     data-key="pk_YOUR_PUBLIC_KEY"
     data-ref="post-42"
     data-title="Post title"
     data-template="cartoes"
     data-theme="auto"
     data-idioma="en"></div>
<script src="https://useqorum.com/widget.js" async></script>

Automatic mounting doesn't accept token. If you use your site's login, use Qorum.montar.

Appearance

Template, colors, theme, corners, default order and the dislike button live in the dashboard, in the Appearance tab, with a live preview. The widget fetches this configuration by itself, so you change the look without touching the code. Open pages may take up to a minute to get the change. See the five templates working in Templates.

What readers can do

• Comment and reply. Every reply sits under the main comment, with the @name of whoever it answers.
• Like and dislike. Clicking again undoes it.
• Edit and delete their own comments. Deleting a main comment deletes its replies too.
• Report other people's comments, choosing a reason.
• Copy the link to a comment.
• See the replies they got in the notification bell.

A living conversation

Formatting

The bar under the text box applies formatting. You can also type:

Any other HTML that is typed shows up as text and is never executed. Ctrl + Enter publishes.

Images

With the option turned on in Settings, the Image button shows up in the bar:

• Up to 4 images per comment, up to 32 MB each.
• Formats: JPG, PNG, GIF and WebP. The format is checked by the file's content, not its name.
• With an image, the text can be empty.
• Every image is converted to WebP before being stored, because it loads faster. Animated GIFs stay animated.
• Images whose longest side is over 2560 pixels are scaled down to 2560, keeping the proportions. Over 40 megapixels, the image is refused.
• Images are stored with no expiration date.
• If approval before publishing is set to "Only comments with a link or image", comments with images go to the queue.

Direct link to a comment

Every comment has the page address plus #qorum-ID. Whoever opens that link sees the comment highlighted at the top and the page scrolls to it. That's the link Copy link creates and the one notifications use.

Sites with a Content-Security-Policy

If your site uses CSP, allow Qorum in these directives, otherwise the browser blocks the widget with no warning on screen:

script-src  https://useqorum.com
connect-src https://useqorum.com
img-src     https://i.ibb.co https://i.ytimg.com   (images and video covers)
frame-src   https://www.youtube-nocookie.com      (videos)

With GIFs on, also allow https://static.klipy.com in img-src.

Profile photos and other card images come from the addresses your site sends.