Configuração do Studio para desenvolvedores web

Obtenha o download do Studio

Entre no Maxisnap com a conta que tem o Studio e então:

• No Windows: no Maxisnap, abra Configurações → Conta → Assistente de configuração, clique em “Comece agora” e depois em “Baixar painel”. O Maxisnap salva o ZIP do Studio na sua pasta Downloads e abre essa pasta.
• No Mac: no Maxisnap, abra Settings → Welcome & Help → Studio Setup Guide, clique em “Get Started” e depois em “Download Dashboard”. O Maxisnap salva o ZIP do Studio na sua pasta Downloads.

Extraia o ZIP. No Windows, clique nele com o botão direito e escolha “Extrair Tudo”. No Mac, clique duas vezes nele.

Maxisnap-Studio-v<version>/
  Maxisnap Studio - Start Here.html   guided setup (branding + every route)
  snaps/                              PHP edition: upload this folder to a web host
  cloudflare/                         Cloudflare Workers edition (Worker + R2 + D1)
    deploy/cli.mjs                    deploys it through the Cloudflare API (Node 20+)
  docs/Developer guide.html           architecture, upload API, security, updates
  docs/Cloudflare setup - technical brief.html
  AGENTS.md                           instructions for AI coding assistants

O Developer guide completo cobre a arquitetura, a API de envio, as chaves e as funções, o modelo de segurança e a solução de problemas. Ele é o arquivo docs/Developer guide.html do download.

Edição PHP: envio e conclusão da configuração

1. Envie a pasta snaps para a raiz do site, incluindo os arquivos .htaccess ocultos dela, de modo que o resultado seja public_html/snaps/index.php. Um snaps.zip personalizado da página Start Here funciona do mesmo jeito: extraia-o no próprio local e não deixe snaps/snaps aninhado.
2. Abra https://yourcompany.com/snaps/ uma vez. A página de configuração verifica o PHP e as permissões da pasta e sugere uma chave de administrador de 40 caracteres; a chave deve ter pelo menos 16. Copie-a e clique em “Create my dashboard”.
3. No nginx, reproduza as regras de roteamento e de bloqueio de snaps/.htaccess. Mantenha uploads, data e branding privados.

A página de configuração grava o your-settings.php, que é mantido nas atualizações:

'dashboard_key' => '…',          // the Admin key; the setup page writes it
'base_url'      => 'https://yourcompany.com/snaps',  // the address setup was opened at; fix it here if share links come out wrong
'max_upload_mb' => 500,          // your host's PHP limits still apply

Edição Cloudflare: implantação a partir de um terminal

A CLI incluída lê primeiro a conta, mostra um plano do que vai criar e do que não vai tocar e recusa nomes que já estão em uso. Se uma implantação parar no meio do caminho, executar o mesmo comando de novo continua de onde parou, sem criar nada em duplicidade.

cd cloudflare
# Option 1: the bundled CLI (Node 20+; plan first, then --yes). PowerShell:
$env:CLOUDFLARE_API_TOKEN = "<token: Account Settings Read; Workers Scripts, R2 and D1 Edit;
                              for --zone/--hostname also Zone Read, DNS Read, Workers Routes Read>"
node deploy/cli.mjs whoami
node deploy/cli.mjs plan --account <account id> --name snaps
#   no workers.dev name on the account yet? The plan asks you to "Choose your free
#   workers.dev name": add --subdomain <your-company> to both commands (account-wide).
#   A subdomain of your domain as well: add --zone <zone id> --hostname snaps.example.com
node deploy/cli.mjs deploy --account <account id> --name snaps --yes
#   prints the Studio address and the Admin key once, and writes deployment.json here

# Option 2: plain Wrangler (create the bucket and database, set their ids in wrangler.jsonc)
npm install
npx wrangler r2 bucket create maxisnap-studio-media
npx wrangler d1 create maxisnap-studio
npx wrangler secret put ADMIN_KEY
npm run sync
npx wrangler deploy

A implantação mostra o endereço do Studio e a chave de administrador uma única vez e grava o deployment.json na pasta de onde é executada. Guarde esse arquivo: update e remove o usam.

Confira se funciona

curl.exe -s -H "X-Dashboard-Key: <Admin key>" https://<studio address>/api/health.php
# {"ok":true,"app":"Maxisnap Studio","version":"…"}   the Cloudflare edition adds "edition":"cloudflare"

Depois, abra o endereço do Studio em um navegador e entre com a chave de administrador. 401 significa chave errada; 404 significa endereço ou pasta errados.

Conecte o Maxisnap

• Maxisnap para Windows: abra Configurações → Conta → Assistente de configuração, clique em “Comece agora” e depois em “Avançar” até chegar à etapa 4, “Conectar o Maxisnap”. Cole o endereço e a chave do seu Studio, clique em “Testar conexão”, depois em “Avançar” e, na última página, em “Concluir e salvar”. Você pode usar a chave de administrador que a configuração mostrou ou um código de envio de People & access, no seu painel.
• Maxisnap para Mac: abra Settings → Welcome & Help → Studio Setup Guide e escolha “I already have a dashboard”. Cole o endereço e a chave do seu Studio, clique em “Test Connection”, depois em “Next” e, por fim, em “Finish & Save”.

Conheça a API de envio

• Os apps do Maxisnap enviam os arquivos para api/upload.php com um cabeçalho X-Dashboard-Key. São aceitas imagens (PNG, JPG, GIF e WebP) e vídeos (MP4, WebM e MOV).
• O Maxisnap para Windows e o Maxisnap para Mac enviam cada arquivo a um Studio na Cloudflare em uma única solicitação, e ele aceita até 25 MB por arquivo.
• A edição Cloudflare também tem uma API de envio em partes para arquivos maiores, descrita no Developer guide: api/upload/start, part e complete.
• As páginas de compartilhamento e os arquivos de mídia delas usam estes caminhos; todos os outros caminhos são internos: /<slug> /<slug>.<ext>

Atualize ou remova depois

PHP: substitua apenas os arquivos listados em snaps/How to update.txt e depois limpe os caches da hospedagem e da CDN. As capturas, as pessoas, a marca e as configurações permanecem.

Cloudflare: execute estes comandos a partir da pasta cloudflare do pacote mais novo, com o deployment.json antigo copiado para dentro dela.

# Update: from a newer package's cloudflare folder, with the old deployment.json copied in
node deploy/cli.mjs update --record deployment.json --yes
# New Admin key (shown once):
node deploy/cli.mjs update --record deployment.json --yes --new-admin-key
# Remove the custom domain and the Worker; the bucket and database (the captures) stay
node deploy/cli.mjs remove --record deployment.json --yes
# Also delete every capture: cannot be undone
node deploy/cli.mjs remove --record deployment.json --yes --delete-data

Leia o resumo técnico da Cloudflare: todos os recursos, permissões e chamadas de API.