Web geliştiricileri için Studio kurulumu

Studio paketini indirin

Studio'su olan hesapla Maxisnap'te oturum açın, ardından:

• Windows'ta: Maxisnap'te Ayarlar → Hesap → Maxisnap Studio kurulum sihirbazını açın, “Başlayın” düğmesine, ardından “Paneli indir” düğmesine tıklayın. Maxisnap, Studio ZIP dosyasını İndirilenler klasörünüze kaydeder ve o klasörü açar.
• Mac'te: Maxisnap'te Settings → Welcome & Help → Studio Setup Guide bölümünü açın, “Get Started” düğmesine, ardından “Download Dashboard” düğmesine tıklayın. Maxisnap, Studio ZIP dosyasını İndirilenler klasörünüze kaydeder.

ZIP dosyasını ayıklayın. Windows'ta dosyaya sağ tıklayın ve “Tümünü Ayıkla” seçeneğini seçin. Mac'te dosyaya çift tıklayın.

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

Tam kapsamlı Developer guide belgesi mimariyi, yükleme API'sini, anahtarları ve rolleri, güvenlik modelini ve sorun gidermeyi kapsar. İndirilen paketteki docs/Developer guide.html dosyasıdır.

PHP sürümü: yükleyin ve kurulumu tamamlayın

1. snaps klasörünü, gizli .htaccess dosyalarıyla birlikte web kök dizinine yükleyin; sonuç public_html/snaps/index.php olmalıdır. Start Here sayfasından aldığınız markalı snaps.zip dosyası da aynı şekilde çalışır; onu olduğu yerde ayıklayın ve snaps/snaps şeklinde iç içe klasör oluşturmayın.
2. https://yourcompany.com/snaps/ adresini bir kez açın. Kurulum sayfası PHP'yi ve klasör izinlerini kontrol eder ve 40 karakterlik bir Yönetici anahtarı önerir; anahtar en az 16 karakter olmalıdır. Anahtarı kopyalayın, ardından “Create my dashboard” düğmesine tıklayın.
3. nginx'te snaps/.htaccess içindeki yönlendirme ve engelleme kurallarını yeniden oluşturun. uploads, data ve branding öğelerini gizli tutun.

Kurulum sayfası, güncellemeler boyunca korunan your-settings.php dosyasını yazar:

'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

Cloudflare sürümü: bir terminalden dağıtım

Pakette bulunan CLI önce hesabı okur, neyi oluşturacağını ve neye dokunmayacağını gösteren bir plan sunar ve zaten kullanımda olan adları reddeder. Bir dağıtım yarıda kalırsa, aynı komut yeniden çalıştırıldığında hiçbir şeyi iki kez oluşturmadan devam eder.

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

Dağıtım, Studio adresini ve Yönetici anahtarını yalnızca bir kez yazdırır ve çalıştığı klasöre deployment.json dosyasını yazar. O dosyayı saklayın: update ve remove komutları onu kullanır.

Çalıştığını kontrol edin

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"

Ardından Studio adresini bir tarayıcıda açın ve Yönetici anahtarıyla oturum açın. 401 yanlış bir anahtar, 404 ise yanlış bir adres ya da klasör anlamına gelir.

Maxisnap'i bağlayın

• Windows için Maxisnap: Ayarlar → Hesap → Maxisnap Studio kurulum sihirbazını açın, “Başlayın” düğmesine tıklayın, ardından “Maxisnap'ı bağlayın” başlıklı 4. adıma gelene kadar “İleri” düğmesine tıklayın. Studio'nuzun adresini ve anahtarını yapıştırın, “Bağlantıyı test et” düğmesine, ardından “İleri” düğmesine, son sayfada da “Bitir ve Kaydet” düğmesine tıklayın. Hem kurulumda gösterilen Yönetici anahtarı hem de panelinizdeki People & access bölümünden alınan bir yükleme kodu çalışır.
• Mac için Maxisnap: Settings → Welcome & Help → Studio Setup Guide bölümünü açın ve “I already have a dashboard” seçeneğini seçin. Studio'nuzun adresini ve anahtarını yapıştırın, “Test Connection” düğmesine, ardından “Next” düğmesine, sonra da “Finish & Save” düğmesine tıklayın.

Yükleme API'sini tanıyın

• Maxisnap uygulamaları, X-Dashboard-Key başlığıyla api/upload.php adresine yükleme yapar. Görüntüler (PNG, JPG, GIF ve WebP) ve videolar (MP4, WebM ve MOV) kabul edilir.
• Windows için Maxisnap ve Mac için Maxisnap, her yüklemeyi Cloudflare'deki bir Studio'ya tek bir istekte gönderir ve Studio bunu dosya başına 25 MB'a kadar kabul eder.
• Cloudflare sürümünde ayrıca daha büyük dosyalar için parçalı bir yükleme API'si vardır; Developer guide belgesinde anlatılır: api/upload/start, part ve complete.
• Paylaşım sayfaları ve medya dosyaları şu yolları kullanır; diğer tüm yollar dahilidir: /<slug> /<slug>.<ext>

Daha sonra güncelleyin veya kaldırın

PHP: yalnızca snaps/How to update.txt içinde listelenen dosyaları değiştirin, ardından barındırıcı ve CDN önbelleklerini temizleyin. Yakalamalar, kişiler, markalama ve ayarlar korunur.

Cloudflare: eski deployment.json dosyasını daha yeni paketin cloudflare klasörüne kopyalayın, ardından aşağıdaki komutları o klasörden çalıştırın.

# 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

Cloudflare teknik bilgi notunu okuyun: her kaynak, izin ve API çağrısı.