Workshop Tanıtım ve API

Devs Dokümentasyonu Güncellendi Feb 28, 2026

Workshop Genel Özellikleri

Workshop, geliştiricilerin projelerini topluluğa sunmalarını sağlayan bir "Marketplace" mantığıyla çalışır.

1. Proje Gösterimi ve Filtreleme

Kategorizasyon: Projeler; Temalar (Themes), Eklentiler (Plugins) ve Araçlar (Tools) olarak sınıflandırılır.
Dinamik Arama: Anahtar kelimelerle projeler arasında hızlı arama yapılabilir.
Detay Sayfası: Her projenin kendine ait; açıklama, ekran görüntüleri, GitHub bağlantısı ve indirme linklerini içeren bir sayfası vardır.

2. Etkileşim ve Değerlendirme Sistemi

Yıldızlı Oylama: Kullanıcılar projelere 1 ile 5 arasında yıldız verebilir.
Yorum Sistemi: Kullanıcılar deneyimlerini paylaşabilir.
Moderasyon Kuyruğu: Workshop üzerindeki tüm yorumlar ve puanlamalar, spamı önlemek adına Admin onayından geçtikten sonra yayınlanır.

API Entegrasyonu

Artado Workshop, verilerini dış uygulamalara veya yan projelere (örneğin bir masaüstü istemcisi veya ana site vitrini) sunmak için basit bir JSON API sağlar.

API Uç Noktası (Endpoint)

GET /Workshop/api.php

Örnek Yanıt Formatı

Başarılı bir istek sonucunda aşağıdaki yapı döner:

{
  "themes": [
    {
      "id": 12,
      "title": "Artado Midnight",
      "author": "Sxi",
      "version": "1.0.2",
      "rating": 4.5,
      "download_url": "https://devs.artado.xyz/public/uploads/files/midnight.css"
    }
  ],
  "plugins": [
    {
      "id": 5,
      "title": "My IP",
      "author": "Sxinar",
      "status": "stable"
    }
  ]
}

📂 Workshop Dosya Yapısı

Geliştiriciler için Workshop dizini altındaki kritik dosyalar:

Dosya	Açıklama
`index.php`	Workshop ana sayfası (Proje listeleme).
`project.php`	Tekil proje detay sayfası ve indirme butonları.
`api.php`	JSON veri çıktısı sağlayan API dosyası.
`comment_handler.php`	Gelen yorumları ve puanları veritabanına işleyen arka plan dosyası.
`footer.php`	Workshop sayfalarına özel alt bilgi alanı.

Workshop'a Proje Ekleme Süreci

Kullanıcı paneli üzerinden "Yeni Proje Oluştur" formunu doldurun.
Proje dosyalarını ve tanıtım görselini yükleyin.
Proje kategorisini (Tema, Eklenti vb.) seçin.
Admin panelinden onay bekleyin. Onaylanan projeler otomatik olarak /Workshop dizininde listelenir.

İpucu: Eğer API'yi dış bir domainden çağıracaksanız, api.php dosyasında Access-Control-Allow-Origin başlıklarının ayarlandığından emin olun.