Configurazione di Studio per sviluppatori web

Scarica Studio

Accedi a Maxisnap con l'account che ha Studio, poi:

• Su Windows: in Maxisnap, apri Impostazioni → Account → Configurazione guidata Studio, fai clic su “Inizia”, poi su “Scarica dashboard”. Maxisnap salva lo ZIP di Studio nella cartella Download e apre quella cartella.
• Su un Mac: in Maxisnap, apri Settings → Welcome & Help → Studio Setup Guide, fai clic su “Get Started”, poi su “Download Dashboard”. Maxisnap salva lo ZIP di Studio nella cartella Download.

Estrai lo ZIP. Su Windows, fai clic con il pulsante destro e scegli “Estrai tutto”. Su un Mac, fai doppio clic.

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

La Developer guide completa tratta l'architettura, l'API di upload, le chiavi e i ruoli, il modello di sicurezza e la risoluzione dei problemi. Nel download si trova in docs/Developer guide.html.

Edizione PHP: carica e completa la configurazione

1. Carica la cartella snaps nella radice web, inclusi i suoi file .htaccess nascosti, in modo che il risultato sia public_html/snaps/index.php. Uno snaps.zip con il tuo branding, ottenuto dalla pagina Start Here, funziona allo stesso modo: estrailo sul posto e non annidare snaps/snaps.
2. Apri https://yourcompany.com/snaps/ una volta. La pagina di configurazione controlla PHP e i permessi della cartella e suggerisce una chiave di amministratore di 40 caratteri; la chiave deve averne almeno 16. Copiala, poi fai clic su “Create my dashboard”.
3. Su nginx, riproduci le regole di routing e di blocco presenti in snaps/.htaccess. Mantieni privati uploads, data e branding.

La pagina di configurazione scrive your-settings.php, che viene mantenuto durante gli aggiornamenti:

'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

Edizione Cloudflare: deploy da terminale

La CLI inclusa legge prima l'account, mostra un piano di ciò che creerà e di ciò che non toccherà, e rifiuta i nomi già in uso. Se un deploy si interrompe a metà, rieseguire lo stesso comando lo fa proseguire senza creare nulla due volte.

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

Il deploy mostra una sola volta l'indirizzo di Studio e la chiave di amministratore, e scrive deployment.json nella cartella da cui viene eseguito. Conserva quel file: update e remove lo usano.

Verifica che funzioni

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"

Poi apri l'indirizzo di Studio in un browser e accedi con la chiave di amministratore. 401 significa chiave sbagliata; 404 significa indirizzo o cartella sbagliati.

Collega Maxisnap

• Maxisnap per Windows: apri Impostazioni → Account → Configurazione guidata Studio, fai clic su “Inizia”, poi su “Avanti” fino al passaggio 4, “Collega Maxisnap”. Incolla l'indirizzo e la chiave del tuo Studio, fai clic su “Verifica connessione”, poi su “Avanti” e infine su “Termina e salva” nell'ultima pagina. Vanno bene sia la chiave di amministratore della configurazione sia un codice di caricamento da People & access nella tua dashboard.
• Maxisnap per Mac: apri Settings → Welcome & Help → Studio Setup Guide e scegli “I already have a dashboard”. Incolla l'indirizzo e la chiave del tuo Studio, fai clic su “Test Connection”, poi su “Next” e infine su “Finish & Save”.

Conosci l'API di upload

• Le app di Maxisnap caricano con un'intestazione X-Dashboard-Key verso api/upload.php. Sono accettate immagini (PNG, JPG, GIF e WebP) e video (MP4, WebM e MOV).
• Maxisnap per Windows e Maxisnap per Mac inviano ogni caricamento a uno Studio su Cloudflare in un'unica richiesta, e lo Studio la accetta fino a 25 MB per file.
• L'edizione Cloudflare ha anche un'API di upload a blocchi per i file più grandi, descritta nella Developer guide: api/upload/start, part e complete.
• Le pagine di condivisione e i relativi file multimediali usano questi percorsi; ogni altro percorso è interno: /<slug> /<slug>.<ext>

Aggiornalo o rimuovilo in seguito

PHP: sostituisci solo i file elencati in snaps/How to update.txt, poi svuota la cache dell'host e della CDN. Catture, persone, branding e impostazioni restano.

Cloudflare: esegui questi comandi dalla cartella cloudflare del pacchetto più recente, con il vecchio deployment.json copiato al suo interno.

# 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

Leggi il documento tecnico su Cloudflare: ogni risorsa, permesso e chiamata API.