Configure o Dozokit Links em cinco minutos

Os passos

1. Clique no botão Deploy to Cloudflare acima.
2. Entre na Cloudflare ou crie sua conta grátis.
3. Quando a Cloudflare pedir, conecte sua conta do GitHub.
4. Deixe os nomes sugeridos (dozokit-links) como estão.
5. No campo PASSWORD, digite a senha que vai proteger seus links: 12 caracteres ou mais. Anote.
6. Clique em Create and deploy e espere um ou dois minutos.
7. Abra o endereço que a Cloudflare mostra no fim (algo como dozokit-links.seu-nome.workers.dev) e acrescente /admin no fim. Entre com sua senha.
8. Crie um link: cole o endereço para onde ele deve levar e, se quiser, dê um nome a ele.
9. Baixe o QR code dele como arquivo PNG ou SVG.

Antes de imprimir: seu próprio endereço curto (opcional)

Um código guarda o endereço com que foi feito, então defina seu próprio endereço curto antes de imprimir. Domínio na Cloudflare: na Cloudflare, abra Workers & Pages, depois dozokit-links, depois Settings → Domains & Routes → Add → Custom domain. Domínio em outro lugar (Registro.br, GoDaddy, Hostinger…): no seu registrador, redirecione go.seudominio.com.br para o seu endereço workers.dev, mantendo o caminho e a query (muitas vezes chamado de “forward path”). Depois, na página admin, abra Settings, digite go.seudominio.com.br em Your address e clique em Check and save: ele confere o redirecionamento antes de usá-lo. Baixe seus códigos depois disso. Os códigos já impressos continuam funcionando.

Mudar para onde um código leva

Na página admin, escolha o link, mude o endereço e salve. Os códigos impressos seguem o novo endereço em até um minuto. O nome depois da barra nunca muda.

Contar leituras

Cada leitura de um QR code e cada clique num link curto é contado por dia na página admin. Nada sobre a pessoa é guardado. Para ver esses números ao lado das visitas do seu site, adicione o endereço dos seus links como um site no Dozokit Analytics e copie o site id dele. Depois, no Dozokit Links, abra Settings, cole o endereço do seu analytics e o site id, salve e clique em Check the connection. Cada leitura aparece então como uma visita e uma meta chamada qr_scan ou link_click, com o nome do link.

Se você esquecer a senha

Na Cloudflare, abra o Worker, depois Settings → Variables and Secrets, e edite PASSWORD. A senha que você digitar ali funciona na hora.

Atualizar

Quando sai uma versão nova, a página admin avisa. Você atualiza no GitHub:

Só na primeira vez: o botão Deploy da Cloudflare copia tudo menos o botão de atualização, então adicione-o uma vez. Na página admin, abra Settings, depois Updates, cole o endereço da sua cópia no GitHub e clique em Add the update button. O GitHub abre o arquivo pronto para salvar: clique em Commit changes e confirme. Instalou antes da 1.0.2, sem a seção Updates ainda? Na sua cópia no GitHub, clique em Add file, depois Create new file, dê o nome .github/workflows/update.yml, cole o texto abaixo e clique em Commit changes. Adicionou o botão de atualização antes da 1.0.3? Abra Settings, depois Updates, e clique em Replace it: o GitHub abre o arquivo com a versão nova na sua área de transferência, então selecione tudo nele, cole e clique em Commit changes. A partir da 1.0.3, o botão só instala uma versão depois de conferir que ela foi assinada pelo Dozokit, então uma atualização só pode vir do Dozokit. O texto para colar

1. No github.com, abra dozokit-links, a cópia que a Cloudflare fez no seu nome.
2. Clique na aba Actions.
3. Clique em Update Dozokit Links na lista à esquerda.
4. Clique em Run workflow e depois no botão verde Run workflow.

Uns dois minutos depois, a Cloudflare já colocou a versão nova no ar sozinha. Seus links e contagens continuam. O que há de novo em cada versão