CH SATRANÇ 1.0.0

KURULUM
1. WordPress > Eklentiler > Yeni ekle > Eklenti yükle bölümünü açın.
2. CH-Satranc-1.0.0.zip dosyasını yükleyin ve eklentiyi etkinleştirin.
3. “Satranç” adlı bir sayfa oluşturun.
4. Sayfaya Kısa Kod bloğu ekleyin ve [ch_satranc] yazın.
5. Sayfayı yayımlayın; masaüstünde ve telefonda oyunu kontrol edin.

AYARLAR
Ayarlar > CH Satranç: zorluk, tahta renkleri, ipucu ve geçerli hamle gösterimi.
Sayfaya özel örnek: [ch_satranc seviye="2" tema="wood"]
Seviye 1–5; tema green, wood veya blue.

OYUN
Bilgisayara karşı veya aynı cihazda iki kişiyle oynanır. Taşa ve hedef kareye
dokunun/tıklayın. Bilgisayarda sürükleme de desteklenir.
Rok, geçerken alma ve vezir/kale/fil/at terfisi vardır.
Mat, pat, yetersiz materyal kontrol edilir. Üç konum tekrarı ve 50 hamle
beraberliği bu oyunda otomatik uygulanır; ayrıca hak talebi düğmesi yoktur.
Geri al, tahta çevirme, ipucu, tam ekran ve PGN yükleme/indirme vardır.
Oyun aynı sayfa ve aynı tarayıcı için kaydedilir; cihazlar arasında eşitlenmez.
Site verilerini temizlemek kayıtları siler.

ZORLUK
Başlangıç, kolay, orta, zor ve uzman. Stockfish 19 Lite güç ayarı, arama
derinliği ve düşünme süresi birlikte değiştirilir. Seviyelere doğrulanmış
bir Elo puanı atanmaz. İpucu daha güçlü aramayla hazırlanır.

AÇILIŞLAR VE ÇALIŞMA
500 ECO kodu, 3177 farklı açılış/varyant adı ve 3865 doğrulanmış hamle dizisi.
Ad, Türkçe ana aile veya ECO ile arama; favoriler; ileri/geri izleme;
seçilen konumdan oynama; iki tarafı veya yalnız beyaz/siyahı çalışma.
Tamamlanan hatlar ve son çalışma tarayıcıda kaydedilir.
Farklı hamle sıralarından ulaşılan aynı konum tanınır.
Varyantların özgün adları korunmuştur; ana ailelere Türkçe adlar eklenmiştir.
Liste kaynak veri setinin bütün kayıtlarını içerir; bütün olası hamle
dizilerini veya bütün satranç teorisini kapsadığı iddia edilmez.
PGN kişisel çalışma hattı olarak eklenebilir (en fazla 50 hat).
PGN'de ana hat yüklenir; parantezli yan varyantlar atlanır.

GEREKSİNİMLER
WordPress 5.8+, PHP 7.4+, güncel WebAssembly destekli tarayıcı.
İlk açılışta sitenize bağlantı gerekir. Motor ve açılış dosyaları pakette
gelir; harici oyun servisi, API anahtarı veya üyelik kullanılmaz.
Motor ziyaretçinin cihazında çalışır. Yalnız oyun sayfasında yüklenir.
Sunucu .js dosyalarını JavaScript, .wasm dosyalarını application/wasm
olarak sunmalıdır. Önbellek/minify sorunu olursa CH Satranç iframe'i ve
app/vendor dosyalarını dosya birleştirmesinin dışında tutun.

LİSANSLAR VE KAYNAKLAR
CH Satranç: GPL-3.0-or-later. Tam metin LICENSE.txt.
chess.js 1.4.0: BSD-2-Clause, Jeff Hlywa ve katkıda bulunanlar.
https://github.com/jhlywa/chess.js/tree/v1.4.0
Resmi chess.ts kaynağı app/vendor-source içindedir. app/vendor/chess.js
derlenirken yalnız türler kaldırılmış, PGN okuyucu bağlantısı CH'nin ana
hat okuyucusuna yönlendirilmiştir. Hamleler chess.js ile doğrulanır.
app/vendor/pgn.js CH'nin kaynak kodudur; yan varyantları çalışma hattına almaz.
Kaynak derleme yardımcısı: app/vendor-source/build-chess.mjs (Node.js 24+).
Stockfish.js 19.0.1 Lite single: GPL v3, Stockfish ekibi ve Nathan Rugg.
https://github.com/nmrugg/stockfish.js/releases/tag/v19.0.1
Resmi kaynak arşivi app/vendor-source/stockfish.js-19.0.1.zip içindedir.
Motorun JS ve WASM dosyaları değiştirilmemiştir; yayımcı SHA-256 özetleri
kontrol edildi. Derleme adımları kaynak README ve build.js içinde; gerekli
araçlar ve ağ dosyaları resmi kaynakta açıklanır.
Lichess açılış verileri: CC0-1.0.
https://github.com/lichess-org/chess-openings
Verinin tarihi ve kapsamı app/openings.json içinde bulunur.

DOĞRULAMA
22 kural/veri kontrolü, 3865 hattın kaynak konuma ulaşması, beş motor
seviyesi ve mat hamlesi, 14 PHP ayar/kısa kod ve 9 işlem/çerçeve kontrolü geçti.
Tarayıcıda oyun, açılış arama/izleme, çalışma, kayıt ve terfi denendi.
Telefon genişliğinde hamle ve çerçeve yüksekliği kontrol edildi.
Paket yerelde test edildi; kullanıcının canlı WordPress sitesine kurulmadı.