Primeiros passos

Do cadastro ao primeiro comentário aparecendo no seu site. Leva poucos minutos e não precisa de servidor.

Passo a passo

1. Crie sua conta

   Abra o painel e escolha um usuário (3 a 30 caracteres: letras minúsculas, números, _ e ponto) e uma senha de pelo menos 8 caracteres. Não existe recuperação por e-mail, então guarde a senha num lugar seguro.

2. Cadastre o site

   Clique em Novo site, dê um nome e informe os domínios onde os comentários vão aparecer, um por linha. Veja a seção Domínios abaixo, porque é aqui que mais gente erra.

3. Copie o código

   Na aba Instalação o código já vem com a sua chave pública. Cole no ponto da página onde os comentários devem aparecer, normalmente logo depois do conteúdo.

4. Troque o ref

   No código, troque ID-UNICO-DA-PAGINA por algo que identifique a página, como post-42. Veja Como escolher o ref.

5. Abra a página e teste

   Recarregue a página. Os comentários devem aparecer com o botão Entrar. Se aparecer um erro, use a aba Testar conexão do painel ou a página Solução de problemas.

6. Ajuste o resto

   Escolha o template e as cores em Aparência, as regras em Configurações e, se o seu site tem login, ligue o login do seu site.

Domínios

O Qorum só responde para páginas que estão na lista de domínios do site. Isso impede que alguém copie sua chave pública e use os seus comentários em outro lugar.

O navegador manda a origem da página: protocolo, domínio e porta, sem o caminho. Para a página https://www.meusite.com/blog/post-42, a origem é https://www.meusite.com.

• Com e sem www são domínios diferentes. Se o site abre dos dois jeitos, cadastre os dois.
• http e https são diferentes. Se você digitar só meusite.com, o painel cadastra https://meusite.com.
• Para testar no seu computador, cadastre o endereço local com a porta, como http://localhost:3000.
• Subdomínios contam separado: https://blog.meusite.com precisa estar na lista se os comentários aparecem nele.

Como escolher o ref

O ref diz qual conversa mostrar. Duas páginas com o mesmo ref mostram os mesmos comentários. Regras:

• Até 200 caracteres: letras, números e _ . : @ / -. Sem espaço e sem acento.
• Use algo que não muda. O id do post no seu banco é melhor do que o título, que pode ser editado.
• Não use o endereço completo com ? e parâmetros: a mesma página com parâmetros diferentes viraria conversas diferentes.
• Se o site tem tipos de página diferentes, use um prefixo: post-42, produto:17, aula:3:video:2.

Exemplos por tipo de site

<!-- onde os comentários vão aparecer -->
<div id="comentarios"></div>
<script src="https://useqorum.com/widget.js"></script>
<script>
  Qorum.montar(document.getElementById('comentarios'), {
    key: 'pk_SUA_CHAVE_PUBLICA',
    ref: 'post-42'
  });
</script>

<?php // no arquivo do tema que mostra o post (single.php), depois de the_content() ?>
<div data-qorum
     data-key="pk_SUA_CHAVE_PUBLICA"
     data-ref="post-<?php the_ID(); ?>"
     data-title="<?php echo esc_attr( get_the_title() ); ?>"
     data-url="<?php the_permalink(); ?>"></div>
<script src="https://useqorum.com/widget.js" async></script>

import { useEffect, useRef } from 'react';

// carregue uma vez no index.html: <script src="https://useqorum.com/widget.js"></script>
export function Comentarios({ postId }) {
  const caixa = useRef(null);
  useEffect(() => {
    window.Qorum.montar(caixa.current, {
      key: 'pk_SUA_CHAVE_PUBLICA',
      ref: `post-${postId}`,
    });
  }, [postId]); // trocou de post, monta a conversa nova
  return <div ref={caixa} />;
}

<!-- carregue uma vez no index.html: <script src="https://useqorum.com/widget.js"></script> -->
<template><div ref="caixa"></div></template>

<script setup>
import { ref, watchEffect } from 'vue';
const props = defineProps({ postId: [String, Number] });
const caixa = ref(null);
watchEffect(() => {
  if (caixa.value) window.Qorum.montar(caixa.value, { key: 'pk_SUA_CHAVE_PUBLICA', ref: `post-${props.postId}` });
});
</script>

Em sites que trocam de página sem recarregar (React, Vue, Next e afins), chame Qorum.montar de novo quando a página mudar. Ele substitui a conversa anterior no mesmo elemento.

Antes de publicar

• Todos os domínios do site (com e sem www) estão na lista.
• Cada página tem um ref único e que não muda.
• A chave no código começa com pk_. Se começa com sk_, troque imediatamente: é a secreta.
• Você testou comentar, responder e apagar com uma conta de teste.