Pursae nedir, neye ihtiyaç duyar, Docker ile ya da tek bir binary olarak nasıl kurulur, ilk kurulum sihirbazı nasıl işler ve güncellemeler ile geri dönüşler nasıl yönetilir.
Pursae, WordPress çekirdeğinin Go ile yeniden yazılmış hâlidir. Tek bir statik binary olarak gelir, PostgreSQL veritabanıyla konuşur ve alışık olduğunuz WordPress yönetim panelini (/wp-admin/), blok editörünü, wp/v2 REST API'sini, klasik temaları ve bir sayfa oluşturucuyu sunar. Eklentiler, etkinleştirirken verdiğiniz izinlerle bir sandbox içinde çalışan WebAssembly paketleridir; bu yüzden bozuk bir eklenti siteyi çökertemez ya da izin verilmeyen bir şeyi okuyamaz.
Yönetim paneli — Dashboard, Posts, Pages, Media, Comments, Appearance (Themes, Customize, Widgets, Menus, Theme File Editor), Plugins, Users, Tools, Settings; WordPress ile aynı HTML ve CSS.
Editörler — blok editörü (@wordpress/* paketleri üzerine kurulu Pursae Editor) ve yerleşik Classic Editor eklentisi (TinyMCE).
Pursae Web Builder — sayfaları statik HTML olarak yayımlayan, bölüm tabanlı görsel sayfa oluşturucu; yeni kurulumda kapalıdır.
REST API — çerez + nonce ve Application Password kimlik doğrulamalı wp/v2.
Temalar — paketle gelen temalar ve zip olarak yüklenen, kod içermeyen tema paketleri.
Pursae Cache — etiket tabanlı temizlemeli yerleşik tam sayfa önbelleği.
Sistem — açılışta migration'lar, zamanlanmış olaylar ve e-posta için bir iş çalıştırıcı, WXR içe/dışa aktarma.
18 yerleşik eklenti — Commerce, Web Builder, SEO, Cache, Security, CDN, Headless, Cookie, Pixel, Analytics, Forum, SMTP, Custom Fields, Multi Language, Contact Form, Maintenance, Backup Manager, Classic Editor. Yeni kurulumda Pursae Cache ve Classic Editor dışında hepsi kapalıdır.
Mimari
Yönetim paneli, editörler ve paketli temalar gömülü tek bir statik binary (CGO_ENABLED=0).
HTTP için gin, PostgreSQL 17 üzerinde pgx (14 ve üstü çalışır); migration'lar açılışta çalışır.
Eklentiler wazero içinde WebAssembly olarak çalışır — cgo yok, ayrı bir runtime yok.
Desteklenmeyenler PHP eklentileri ve PHP temaları (temalar theme.json manifestli Go şablonlarıdır) ile multisite.
Docker (macOS/Windows'ta Docker Desktop, Linux'ta Compose v2'li Docker Engine) ve git gerekir; make isteğe bağlıdır.
Sunucuda (production build)
Production build https://hub.pursae.com ile konuşur; böylece çekirdek güncellemeleri Dashboard › Updates'te tek tıktır. Ayarlar docker/.env dosyasına yazılır (git tarafından yok sayılır).
git clone https://github.com/pursae/pursae.git
cd pursae
cp docker/.env.example docker/.env # WPGO_DB_PASSWORD, WPGO_SITE_URL (https://…), WPGO_SMTP_*, WPGO_MAIL_FROM ayarlayın
make prod-up # site 127.0.0.1:8088'de; Caddy ya da nginx'i buraya yönlendirin
make prod-logs logu izler, make prod-down yığını durdurur (veriler korunur). Önüne bir TLS proxy koyun, ardından https:// adresini açın.
Kurulumu hemen tamamlayın. Kurulum sihirbazı bitene kadar siteye erişebilen herkes onu çalıştırıp yönetici olabilir.
Kendi makinenizde (geliştirme build'i)
git clone https://github.com/pursae/pursae.git
cd pursae
make docker-up
# make olmadan:
docker compose -f docker/compose.yaml up -d --build
Bu geliştirme build'i hub.pursae.com ile konuşmaz (çekirdek güncellemesi yok; onun yerine yerel bir Pursae Manager arar), test veritabanı parolası wpgo'yu kullanır ve demo eklenti imza anahtarına güvenir. Pursae'yi denemek içindir, site yayınlamak için değil. İlk build Go modüllerini indirip binary'yi derler (bir iki dakika); sonra http://localhost:8088 adresini açınca kurulum sihirbazı karşınıza çıkar.
Servis
Nedir
Host portu
wpgo
Pursae sunucusu
8088 (production: 127.0.0.1:8088)
db
PostgreSQL 17
127.0.0.1:5432 (production: yayımlanmaz)
Farklı port ya da adres
Site URL'si kurulum anında ayarlara yazılır; bu yüzden ilk çalıştırmadan önce belirleyin:
WPGO_PORT=9000 WPGO_SITE_URL=http://localhost:9000 make docker-up
# yerel ağdaki başka bir cihazdan erişmek için:
WPGO_SITE_URL=http://192.168.1.50:8088 make docker-up
Yanlış URL ile kurduysanız Settings › General altından değiştirin ya da baştan başlayın (bkz. Sorun giderme).
Volume'lar
Compose durumu adlandırılmış volume'larda tutar; docker compose down hiçbir şey kaybettirmez.
Volume
Bağlandığı yer
İçerik
pgdata
/var/lib/postgresql/data
veritabanı
bin
/data/bin
çalışan binary; Dashboard › Updates bunu değiştirir
uploads
/data/uploads
ortam kütüphanesi dosyaları
plugins
/data/plugins
kurulu eklenti paketleri
themes
/data/themes
tema paketleri ve Theme File Editor'da düzenlenen dosyalar
pagecache
/data/wpgo-cache
Pursae Cache disk kopyası (yeniden oluşturulabilir)
languages
/data/languages
indirilen dil paketleri
backups
/data/backups
Tools › Backups arşivleri (zamanlanmış ve elle)
mail
/data/mail
SMTP olmadan gönderilen iletilerin .eml dosyaları
Günlük komutlar
make docker-up # geliştirme: derle ve arka planda başlat
make docker-down # durdur; veriler korunur
make prod-up # production: docker/compose.prod.yaml ve docker/.env ile
make prod-down # production yığınını durdur (veriler korunur)
make prod-logs # production sunucu logunu izle
make test # birim testleri + PostgreSQL entegrasyon testleri
make docker-test # aynı test paketi bir Go container'ı içinde
make build # bin/wpgo'yu derle
make builder # Web Builder editörünü web/web-builder'a yeniden derle (Node 22+ gerekir)
docker compose -f docker/compose.yaml logs -f wpgo
docker compose -f docker/compose.yaml restart wpgo
Demo imza anahtarı Compose dosyası, paketteki örnek eklentiler kurulabilsin diye WPGO_TRUST_DEV_KEY=1 ayarlar. Bu yalnızca geliştirme içindir: make prod-up'ın eklediği docker/compose.prod.yaml bunu kapatır.
Go 1.27 ve yapılandırılan kullanıcının tablo oluşturabildiği bir PostgreSQL veritabanı (14 veya üstü; compose 17 kullanır) gerekir.
Derleme
git clone https://github.com/pursae/pursae.git
cd pursae
make build # bin/wpgo dosyasını üretir
make build, CGO_ENABLED=0 go build -o bin/wpgo ./cmd/wpgo komutudur: yönetim paneli, editörler ve paketli temalar gömülü statik bir binary çıkar. İstediğiniz yere kopyalayabilirsiniz.
Çalıştırma
export DATABASE_URL='postgres://wpgo:wpgo@localhost:5432/wpgo?sslmode=disable'
export WPGO_SITE_URL='https://blog.example.com' # genel adres, sonda eğik çizgi olmadan
export WPGO_UPLOADS_DIR=/var/lib/wpgo/uploads
./bin/wpgo serve
Açılışta sunucu veritabanı migration'larını çalıştırır (advisory lock altında; birden çok instance aynı anda başlayabilir), uploads dizinini oluşturur ve WPGO_ADDR üzerinde dinler (varsayılan :8080). Siteyi açınca kurulum sihirbazı gelir.
Komut
Ne yapar
wpgo serve
migration'ları uygular, sonra sunar (varsayılan)
wpgo migrate
bekleyen migration'ları uygular ve çıkar
wpgo version
sürümü yazdırır
Belgelerde geçen diğer alt komutlar: wpgo launch (Docker entrypoint'i), wpgo healthcheck / wpgo healthcheck ready, wpgo mcp (MCP stdio köprüsü) ve wpgo adminsec disable-hide-login.
Geliştirme modu
Şablonları, CSS ve JS'i gömülü kopya yerine çalışma dizininden okuyun; düzenlemeler sayfa yenilenince görünür:
make db # compose dosyasından yalnızca PostgreSQL'i başlatır
WPGO_WEB_DIR=web go run ./cmd/wpgo serve
make dev ikisini birden yapar. make test birim testlerini ve PostgreSQL entegrasyon testlerini compose veritabanına karşı paket paket çalıştırır; testler TEST_DB ile adı verilen veritabanını (varsayılan wpgo_test) silip yeniden oluşturur. Aynı anda test koşan her checkout'a ayrı bir ad verin, ör. make test TEST_DB=wpgo_test_feature.
Sihirbaz ilk yorumuyla birlikte "Hello world!" yazısını, Sample Page'i, taslak bir Privacy Policy sayfasını ve varsayılan kenar çubuğu widget'larını oluşturur. Ardından /wp-login adresinden giriş yapın.
.php gerekmez Yönetim URL'lerinde .php uzantısı yoktur (/wp-admin/edit, /wp-login). WordPress yazımları (/wp-admin/edit.php, /wp-login.php) yine çalışır: GET istekleri kalıcı olarak yönlendirilir, POST'lar yerinde karşılanır; yer imleri, istemciler ve WordPress için yazılmış rehberler çalışmaya devam eder.
Import ve Export (WXR), Site Health, kişisel veri dışa aktarma ve silme
Settings
General, Writing, Reading, Discussion, Media, Permalinks, Privacy ve eklentilerin eklediği sayfalar
Pursae Cache
yerleşik sayfa önbelleği
Yazı yazmak
Posts › Add New blok editörünü açar. Yazın, medya ekleyin (Media Library penceresi gerçek wp.media'dır), kategori ve etiket seçin, sonra Publish'e basın. Yazı etkin temayla ön sayfada ve REST API'de /wp-json/wp/v2/posts adresinde görünür. [gopher-facts] gibi eklenti kısa kodları bir Shortcode bloğuna ya da paragrafa yazılabilir; eklenti bunları sayfa oluşturulurken açar.
Kalıcı bağlantılar
Settings › Permalinks WordPress yapılarını sunar (/%year%/%monthnum%/%postname%/, /%postname%/, …). Web sunucusunda rewrite kuralı gerekmez: yönlendirmeyi Go sunucusu kendisi yapar.
Sonraki adımlar
Tema kurun: Appearance › Themes › Add Theme.
Eklenti kurun: Plugins › Add Plugin ya da bir paket yükleyin.
Siteyi TLS arkasına alın (bkz. Reverse proxy ve TLS).
WordPress'ten geliyorsanız: orada Tools › Export (WXR) ile dışa aktarın, burada Tools › Import ile içe alın — yazılar, sayfalar, terimler, yorumlar, menüler ve genel URL'lerinden indirilen medya. Ürünler WooCommerce'in ürün CSV'si ile taşınır. Kullanıcı parolaları, ayarlar, PHP eklentileri ve temaları taşınmaz.
Production bir site kendini Dashboard › Updates üzerinden tek tıkla günceller; yeni bir sürüm çıktığında her yönetim sayfasında "Pursae X is available! Please update now." uyarısı görünür. Aksi hâlde binary'yi değiştirir (ya da imajı yeniden derler) ve başlatırsınız. Geliştirme build'leri (make docker-up, make dev) https://hub.pursae.com'dan güncelleme almaz. Veritabanı migration'ları açılışta, sunucu dinlemeye başlamadan önce otomatik çalışır.
Tek tıkla güncelleme ne yapar
Pursae Manager sitenin platformu için derlenmiş bir sürüm yayımladığında (GET /api/v1/index içindeki core.artifacts çalışan GOOS/GOARCH'ı içeriyorsa) Dashboard › Updates Update to version X düğmesini gösterir. Ardından site:
binary'yi Manager'dan indirir (en fazla 1 GB), boyutunu ve SHA-256'sını denetler;
sürümde adı geçen Manager anahtarının pursae-core-v1\n{version}\n{os}-{arch}\n{sha256 hex} üzerindeki Ed25519 imzasını doğrular;
indirilen binary'yi bir kez çalıştırır (version): sistemin başlatamadığı ya da başka sürüm bildiren binary, hiçbir şey değişmeden reddedilir;
çalışan binary'yi <executable>.prev olarak saklar, güncellemeyi <executable>.update.json'a kaydeder ve yeni binary'yi eskisinin üzerine taşır;
"Updated, restarting…" gösterir, bir core_update olayı kaydeder ve kendini yeniden çalıştırır; yeni sürüm açılışta kendi migration'larını uygular.
Yeniden başlatma ziyaretçileri düşürmez: dinleme soketi yeni binary'ye devredilir (WPGO_LISTEN_FD), süren istekler önce biter (en fazla 10 saniye), bu arada gelen bağlantılar yeni sürüm kabul edene kadar çekirdek kuyruğunda bekler — bir iki saniye, hata sayfası yok; Dokploy'daki Traefik gibi bir proxy arkasında da.
Otomatik geri dönüş
Yeni binary istekleri yanıtlamaya başlayınca (iki dakika içinde) güncellemeyi onaylar; o zamana kadar .update.json "pending" kalır. Önce çöker ve yeniden başlatılırsa — Docker'ın restart: unless-stopped'ı, systemd'nin Restart=always'ı ya da başka bir supervisor ile — ikinci açılış <executable>.prev'i geri koyup çalıştırır ve Dashboard › Updates "Pursae X did not start, so the site went back to Y" der. Yeniden çalıştırma tamamen başarısız olursa önceki binary hemen geri konur.
Bir supervisor altında çalıştırın Yoksa çöken süreci kimse yeniden başlatmaz. Migration'lar yalnızca ileri yönlüdür: geri dönen site yeni sürümün uyguladığı migration'ları korur; bu yüzden sürümler şemaya yalnızca ekleme yapar.
Önceki sürümü saklama ve yeniden kurma
Onaydan sonra .update.json "confirmed" olarak (gelinen sürümle birlikte) kaydedilir ve <executable>.prev24 saat tutulur, sonra silinir (açılışta ve saatte bir kontrol edilir). Site hiçbir zaman birden fazla ek binary tutmaz, o da yalnızca bir gün.
Dashboard › Updates › "Previous version", Reinstall version Y sunar: 24 saat içinde saklanan .prev denetlenip geri takılır (indirme yok); sonrasında Y'nin imzalı build'i Pursae Manager'dan (GET /api/v1/core/{version}) yeniden indirilir ve bir güncelleme gibi doğrulanır. Manager yoksa .prev silindikten sonra düğme görünmez.
Yeniden kurulum "pending" bir güncelleme olarak kaydedilir; açılmayan bir binary yine geri döner. Kendiliğinden asla olmaz ve yeni sürümün migration'ları geri alınmaz (düğme onay ister) — eski sürüm bunlarla çalışamıyorsa yedeği geri yükleyin.
Bir denetim başarısız olursa hiçbir şey değiştirilmez. Executable değiştirilemiyorsa (go run build'i ya da sunucunun yazamadığı bir dizin) düğmenin yerinde nedeni yazar. Beta sürümleri yalnızca lisansı beta kanalını içeren sitelere sunulur.
Statik sürüm build'leri
CGO_ENABLED=0 go build -buildmode=exe -tags nodynamic -ldflags "-X wpgo/internal/server.Version=0.2.0" ./cmd/wpgo
make build ve make release bunu yapar. Statik olması önemlidir: Go'nun varsayılan Linux build'i derleme makinesinin ELF yorumlayıcısını ister, nodynamic ise AVIF çözücüsünü purego'dan uzak tutar — glibc'li bir makinede derlenen böyle bir binary Alpine imajında açılmaz.
Docker
İmaj wpgo launch ile başlar: binary'sini bin volume'una (/data/bin, WPGO_BIN_DIR) kurar ve oradan çalıştırır; böylece panelden yapılan güncelleme container yeniden başlasa da kalır. Daha yeni imaj kazanır: imajdaki binary daha yüksek sürüm bildiriyorsa onu kurar; aynı sürümü bildiren yeniden derlenmiş imaj (VERSION'sız geliştirme build'leri) binary farklıysa yine kazanır; daha yüksek sürümlü kurulu binary (panelden güncelleme) korunur.
git pull && make prod-up # kaynaktan production; migration'lar açılışta çalışır
git pull && make docker-up # geliştirme yığını
Binary
git pull
make build
systemctl restart wpgo # ya da nasıl çalıştırıyorsanız
Birden çok instance aynı anda başlayabilir: migration çalıştırıcı PostgreSQL advisory lock alır ve eksikleri bir kez uygular. wpgo migrate sunucuyu açmadan uygular; deploy adımı için kullanışlıdır.
Güncellemeden önce
Veritabanını ve uploads dizinini yedekleyin. Migration'lar ileri yönlüdür; geri dönüşünüz yedektir.
Eklenti uyumluluğunu kontrol edin: plugin.json gereken en düşük çekirdek sürümünü (requires) belirtir; Plugins ekranı daha yeni çekirdek isteyen eklentiyi etkinleştirmez.
Elle geri dönüş
Yeni sürümü durdurun, veritabanı yedeğini geri yükleyin, önceki binary'yi başlatın. Uploads, eklenti ve tema paketleri düz dosyalardır; güncelleme bunlara dokunmaz.
Eklentiler ve temalar
Paketler Plugins › Add Plugin ve Appearance › Add Theme üzerinden güncellenir (daha yeni paketi yükleyin ya da marketplace'ten kurun). Aynı slug ile yeniden kurulan eklenti paketi değiştirir ve verilen izinleri korur; yeni sürümü yüklemek için devre dışı bırakıp yeniden etkinleştirin ve etkinleştirme ekranındaki izinleri gözden geçirin.
Header, footer ve single, page, özel yazı türü, ön sayfa, arşiv, arama ve 404 şablonları Web Builder › Theme Builder'da tasarlanır ve yeni paketli tema Hello Pursae tarafından gösterilir. 0029_web_builder_templates.sql migration'ı wb_template yazı türünü ekler; mevcut hiçbir şey değişmez.
Eklentisi zaten açık olan siteler otomatik geçirilmez: bir kereye mahsus Switch to Hello Pursae (ya da Dismiss) bildirimi görünür. Bundan sonra eklentiyi etkinleştirmek Hello Pursae'ye geçirir (Switch back bağlantısıyla), devre dışı bırakmak geri döndürür.
Kendi gezinme ya da footer bölümü olan eski builder sayfaları tam sayfa tuval olarak görünmeye devam eder; her sayfa kendi ayarlarındaki Header & footer altından seçim yapabilir.
Builder API sürümü artık 2: güncelleme sırasında açık kalan editör sekmesi yeniden yükleme ister. Yayımlanmış sayfaların yeniden üretilmesi gerekmez.
Genel Pursae Custom Fields yazı türleri artık güzel kalıcı bağlantılara (/<slug>/<post>/) ve isteğe bağlı arşive sahip; eski ?p=<id> bağlantıları yönlendirilir. Hiçbir sayfa ya da yazının, bir özel yazı türünün rewrite ya da arşiv slug'ını kullanmadığından emin olun.
Yeni Pursae Web Builder (eski builder verisi silinir)
Önce veritabanını yedekleyin. Yeni builder'ı getiren sürüm, Elementor türevi önceki builder'ın yerini alır ve onun sakladığı her şeyi dönüştürücü olmadan siler (0028_drop_old_builder migration'ı). Geri dönmenin tek yolu yedeği geri yüklemektir.
Silinenler: tabloları (revizyonlar, global sınıf ve değişkenler, varsayılan stiller, form gönderimleri), kayıtlı şablonlar, tema parçaları, popup'lar ve bileşenler, tüm _elementor_*/_gwe_* post meta anahtarları, seçenekleri ve onunla kaydedilmiş temalar. Sayfalar içeriklerini düz HTML olarak korur; eski Canvas ya da Full Width şablonundaki sayfalar temanın varsayılan şablonuna döner. Üretilmiş CSS, form yüklemeleri ve özel ikon setleri bir sonraki açılışta uploads'tan silinir (yerel fontlar kalır); Hello Web Builder ya da eski builder ile kaydedilmiş bir temadaki site önceki temasına ya da Twenty Twenty-Five'a geçer. Eski builder sayfaları yeni builder'da yeni belge olarak açılır — yeniden oluşturup yayımlayın.
Operasyon
Pursae'yi production'da çalıştırmak
Tüm ortam değişkenleri, Docker kurulumu, proxy ve TLS, önbellek, zamanlanmış işler, e-posta, yedekler, güvenlik, Hub bağlantısı, sürüm yayımlama, sorun giderme ve MCP üzerinden yapay zekâ ajanları.
Pursae tamamen ortam değişkenleriyle yapılandırılır. Geri kalan her şey (site başlığı, kalıcı bağlantılar, e-posta göndericisi, önbellek ayarları, güvenilen eklenti anahtarları) options tablosunda durur ve panelden düzenlenir.
oturum çerezleri ve nonce'lar için gizli anahtar. Birden çok instance tek veritabanını paylaşıyorsa ayarlayın
WPGO_WEB_DIR
gömülü
yönetim/tema şablonlarını, CSS ve JS'i bu dizinden okur, her istekte yeniden yükler (geliştirme)
WPGO_EMPTY_TRASH_DAYS
30
çöpe atılan yazı ve yorumların günlük wp_scheduled_delete işi tarafından silinmeden önce tutulduğu gün sayısı. 0 her günlük çalışmada çöpü boşaltır (Trash bağlantıları görünür kalır)
WPGO_LOG_FORMAT
text
json, erişim logunu istek başına bir JSON nesnesi olarak yazar (status, method, uri, duration, ip, request_id)
WPGO_BACKUPS_DIR
uploads yanında backups/
Backup Manager arşivleri (elle, zamanlanmış ve güvenlik anlık görüntüleri). Herkese açık sunulan uploads dizininin dışında tutun
WPGO_LANG_DIR
uploads yanında languages/
kurulu dil paketleri
WPGO_TRANSLATIONS_API
https://api.wordpress.org/translations
dil paketlerinin indirildiği adres (bir ayna ya da testlerde sahte sunucu)
WPGO_BIN_DIR
— (imajda /data/bin)
wpgo launch'ın binary'yi kurduğu kalıcı dizin; panelden yapılan güncelleme container yeniden başlasa da kalır
eklenti paketleri dizini; her instance aynı volume'a ihtiyaç duyar (Docker sayfasında geçer)
Veritabanı havuzu
DATABASE_URL, pgx havuz parametrelerini sorgu parametresi olarak alır; verilmeyen her biri aşağıdaki varsayılanı alır (pgx tek başına yalnızca max(4, CPUs) bağlantıya izin verirdi).
Parametre
Varsayılan
Anlamı
pool_max_conns
4 × CPU, en az 10, en çok 40
instance başına bağlantı. Tüm instance'ların toplamını (yedekler ve psql dahil) PostgreSQL'in max_connections değerinin (varsayılan 100) altında tutun
pool_min_conns
2
boştayken açık tutulan bağlantılar
pool_max_conn_lifetime
1h (+ en fazla 5 dk sapma)
bir bağlantı bu süreden sonra yenilenir
pool_max_conn_idle_time
15m
minimumun üstündeki boşta bağlantılar bu süreden sonra kapanır
market dizinindeki dev-key.pub'a güvenir. Yalnızca geliştirme
WPGO_EXPOSE_USERS
ayarsız
1 ziyaretçilerin hesapları listelemesine izin verir (genel REST users, /?author=N, kullanıcı sitemap'i); bu yollar hesap adlarını ifşa ettiği için kapalıdır
WPGO_TRUSTED_PROXIES
loopback ve özel ağ aralıkları
X-Forwarded-For / X-Real-IP başlıklarına güvenilen proxy'ler (virgülle ayrılmış IP veya CIDR); none hiçbirine güvenmez
WPGO_HUB
ayarsız (açık)
off, Pursae Manager'ı (hub.pursae.com) her build'de kapatır: hiçbir şey gönderilmez; güncelleme bildirimi, tek tık güncelleme, marketplace ve lisans da olmaz. Kaldırılıp yeniden başlatılana kadar her yönetim sayfası uyarır. Önerilmez
Yalnızca devhub build'leri: https://hub.pursae.com yerine kullanılacak Manager (https; localhost / *.localhost / *.test için http); off kapatır. Production binary'leri yok sayar
WPGO_TRUST_HUB_KEYS
ayarsız (geliştirme compose dosyasında 1)
Yalnızca devhub build'leri: 1, Manager'ın listelediği her anahtara — release root onaylı olsun olmasın — güvenir. Production binary'leri yok sayar
Pursae Manager ve devhub build'leri
Her Pursae kurulumu https://hub.pursae.com adresindeki Pursae Manager ile konuşur. Production binary'sinde bu adresi değiştiren ya da anahtar denetimini gevşeten bir değişken veya seçenek yoktur: Pursae release root anahtarı binary'ye sabitlenmiştir ve yalnızca bu kökün onayladığı Manager anahtarları çekirdek güncellemelerini ve Manager imzalı eklentileri doğrular. ROOT_KEYS build argümanı (-ldflags -X wpgo/internal/server.rootKeysLinked=…) anahtar rotasyonu için release root ekler; sabitlenmiş olanı asla kaldırmaz.
go run -tags devhub ./cmd/wpgo serve # make dev bunu yapar
docker compose -f docker/compose.yaml up # GO_TAGS=devhub ile derler
Devhub binary'si WPGO_DEV_HUB_URL'yi (pursae-manager.test, host gateway için bir extra_hosts takma adıdır) ve WPGO_TRUST_HUB_KEYS=1'i okur; böylece yerel Manager'ın geçici anahtarı sürümleri ve eklentileri doğrular. Production compose dosyası GO_TAGS="" ile derler ve iki değişkeni de kaldırır.
Devhub binary'sini asla yayına almayın.
Tema dosyalarını düzenleme
Appearance › Theme File Editor yeniden derleme gerektirmez. Kaydetmek /data/themes'e (ya da WPGO_THEMES_DIR'e) bir geçersiz kılma yazar; şablon seti yeniden ayrıştırılır ve sayfa deneme amaçlı oluşturulur. Şablon ya da render hatası otomatik geri alınır ve gösterilir. Restore original geçersiz kılmayı kaldırır.
Yapılandırma: içerik, yerleşik eklentiler, compose ve testler#
İçerik
Değişken
Varsayılan
Anlamı
WPGO_POST_REVISIONS
25
yazı başına tutulan revizyon (WordPress'in WP_POST_REVISIONS'ı); eskileri kayıtta silinir, Web Builder yayınları dahil. Negatif değer hepsini tutar. Tools › Revisions mevcut yazılardaki fazlayı siler
Yazı araması kelimeleri site dilinde köklerine indirir (Settings › General › Site Language → PostgreSQL metin arama yapılandırması, ör. english, turkish; yoksa simple). Dili değiştirmek vektörleri arka planda yeniden oluşturur.
Yerleşik eklentiler
Değişken
Varsayılan
Anlamı
WPGO_ADMINSEC_DISABLE_HIDE_LOGIN
ayarsız
Pursae Security'nin özel giriş URL'si için kurtarma anahtarı: 1/true/yes ayarlı olduğu sürece /wp-login'i geri getirir (ayarladıktan sonra sunucuyu yeniden başlatın). wpgo adminsec disable-hide-login ayarı kalıcı olarak kapatır
WPGO_CDN_SETTINGS
ayarsız
Pursae CDN ayarları tek bir JSON nesnesi olarak (gocdn_settings seçeneğinin anahtarları, ör. {"provider":"aws","bucket":"media",…}). Kayıtlı ayarları geçersiz kılar ve salt okunur gösterilir; kimlik bilgileri veritabanı dışında kalabilir. Geçersiz JSON logda uyarıyla yok sayılır
internal/webbuilder/contract.go içindeki WPGO_BUILDER_AI* değişkenleri dağıtılmayan Web Builder AI modülüne aittir; ayarlamak etki etmez.
Yalnızca compose
make prod-up bunları, WPGO_SITE_URL'yi, e-posta ayarlarını ve WPGO_PLUGIN_KEYS / WPGO_TRUSTED_PROXIES'i docker/.env'den okur (şablon: docker/.env.example).
Değişken
Varsayılan
Anlamı
WPGO_PORT
8088
site için host portu
WPGO_BIND
127.0.0.1
sitenin yayımlandığı host adresi, yalnızca compose.prod.yaml ile (geliştirme dosyası tüm arayüzlerde yayımlar)
WPGO_DB_PORT
5432
127.0.0.1 üzerinde PostgreSQL host portu, yalnızca geliştirme dosyasında; production PostgreSQL'i yayımlamaz
WPGO_DB_PASSWORD
— (zorunlu)
veritabanı parolası, yalnızca compose.prod.yaml ile (geliştirme dosyası wpgo kullanır); pgdata volume'u oluşturulurken uygulanır
Test paketi
Değişken
Varsayılan
Anlamı
WPGO_TEST_ADMIN_DB
—
test veritabanını silip yeniden oluşturmak için kullanılan bağlantı
WPGO_TEST_DB
—
test veritabanı URL'si; ikisi de ayarsızsa entegrasyon testleri atlanır
TEST_DB (make değişkeni)
wpgo_test
make test'in silip yeniden oluşturduğu veritabanı
WPGO_I18N_MISSES
—
geliştirme: çevirisi olmayan her arayüz metnini bu dosyaya ekler (JSON satırları); WPGO_I18N_MISSES_* yalnızca i18n kapsam testlerince okunur
Bilinmesi gereken seçenekler (ortam değişkeni değil, veritabanı)
Seçenek
Nerede
Anlamı
plugin_trusted_keys
—
satır ya da virgülle ayrılmış genel anahtarlar; WPGO_PLUGIN_KEYS ile birleştirilir
plugin_allow_unsigned
—
true imzasız eklenti paketlerini kabul eder (yalnızca geliştirme)
wpgo_cache_*, wpgo_opt_*
Pursae Cache ekranları
sayfa önbelleği ve sayfa optimizasyonu
image_output_format
Settings › Media
"" (varsayılan): WebP yüklemeleri için JPEG boyutlar (saydamlıkta PNG); webp: WebP yüklemeleri için WebP boyutlar; webp-all: JPEG, PNG ve WebP yüklemeleri için WebP, görselin kendisi de WebP kaydedilir (photo.jpg → photo.webp, 2560 px üstünde photo-scaled.webp). Kalite 86, cgo yok. Filtre: image_editor_output_format. Mevcut görseller yeniden üretilmez
docker/Dockerfile iki aşamalı bir build'dir: golang:1.27-alpine statik binary'yi derler; son aşama ca-certificates ve tzdata içeren alpine:3.22, ayrıcalıksız wpgo kullanıcısı (uid 10001) ve /data/uploads, /data/plugins, /data/plugin-cache, /data/mail, /data/themes, /data/wpgo-cache, /data/languages, /data/bin, /data/backups veri dizinleridir. Entrypoint wpgo launch, varsayılan komut serve, açılan port 8080. examples/plugins/dist'teki örnek eklenti paketleri varsa /usr/share/wpgo/plugins'e kopyalanır.
Yapılandırma referansındaki diğer her şeyi ortama ekleyebilirsiniz, örneğin WPGO_PLUGIN_KEYS.
Production değişiklikleri (compose.prod.yaml)
make prod-up, docker/.env'deki ayarlarla compose.prod.yaml'ı ekler. WPGO_DB_PASSWORD ve WPGO_SITE_URL ayarlanana kadar başlamayı reddeder ve:
devhub etiketi olmadan derler (güncellemeler yalnızca https://hub.pursae.com'dan; WPGO_DEV_HUB_URL / WPGO_TRUST_HUB_KEYS kaldırılır);
veritabanı parolasını WPGO_DB_PASSWORD'den alır (POSTGRES_PASSWORD ve DATABASE_URL için);
PostgreSQL'i yayımlamaz; siteyi yalnızca 127.0.0.1:8088'de yayımlar (WPGO_BIND adresi değiştirir);
WPGO_TRUST_DEV_KEY=0 ayarlar, WPGO_PLUGIN_KEYS ve WPGO_TRUSTED_PROXIES'i geçirir, iki servisi de durdurulmadıkça yeniden başlatır ve stop_grace_period: 35s ayarlar.
Veritabanı parolasını değiştirmekPOSTGRES_PASSWORD yalnızca pgdata volume'u ilk oluşturulurken uygulanır; mevcut veritabanında önce ALTER USER wpgo PASSWORD '...' ile değiştirin.
Production kontrol listesi
Önüne TLS sonlandıran bir proxy koyun ve WPGO_SITE_URL'yi https:// adresine ayarlayın.
Site yayına girer girmez kurulum sihirbazını tamamlayın.
Gerçek eklentiler için kendi imza anahtarlarınızı WPGO_PLUGIN_KEYS'e yazın.
Parola sıfırlama e-postaları ulaşsın diye SMTP'yi (WPGO_SMTP_*, WPGO_MAIL_FROM) yapılandırın.
pgdata, uploads, plugins ve themes'i yedekleyin; backups volume'unu sunucu dışına kopyalayın.
Birden fazla wpgo kopyası çalıştırıyorsanız WPGO_SECRET'ı açıkça ayarlayın.
Dashboard › Updates'ten güncelleyin; güçlü bir yönetici parolası seçin.
veritabanı 2 sn içinde ping'e yanıt veriyor ve tüm migration'lar uygulanmışsa; aksi hâlde 503
readiness: yük dengeleyiciler, Kubernetes readinessProbe
İkisi de kimlik doğrulamasızdır; bakım modu, Pursae Security ve sayfa önbelleğinden önce yanıt verir, Cache-Control: no-store gönderir ve loglanmaz. İmajın HEALTHCHECK'i wpgo healthcheck'i çalıştırır (WPGO_ADDR üzerinde /healthz'i sorar; wpgo healthcheck ready/readyz'i sorar), curl gerekmez.
Kapanış, zaman aşımları ve limitler
SIGTERM'de: yeni bağlantı kabul edilmez, süren istekler biter (en fazla 10 sn), iş çalıştırıcı durur (en fazla 10 sn), arka plan yazmaları — 404 logu, sayaçlar, bekleyen CDN temizlemeleri — boşaltılır (en fazla 5 sn), sonra havuz kapanır. Docker'ın varsayılan bekleme süresi 10 sn olduğundan stop_grace_period: 35s; terminationGracePeriodSeconds için de aynısını kullanın.
İstek başlıkları: 10 sn; boştaki keep-alive: 120 sn; 60 sn ilerlemeyen istek gövdesi başarısız olur. Genel okuma/yazma zaman aşımı bilinçli olarak yok (yedekler, içe aktarmalar, yavaş yüklemeler ve Headless abonelik akışları dakikalarca sürer) — istek başı limitleri proxy'ye koyun.
İstek gövdesi limiti: 512 MB (bir ekranın kabul ettiği en büyük yükleme 256 MB'lık WXR içe aktarmasıdır); Backup Manager içe aktarması 16 GB'a kadar arşiv alır. Daha büyükleri 413 alır.
Her yanıt bir X-Request-ID taşır (makulse proxy'ninki, değilse üretilen); erişim log satırı id=<request id> ile biter.
wpgo servisinde restart: unless-stopped vardır (açılmayan bir çekirdek güncellemesini de geri getirir); compose.prod.yaml bunu db'ye de ekler. Tek veritabanını paylaşan instance'lar her 10 saniyede plugins tablosunu yüklediklerle karşılaştırır; eklenti paketleri WPGO_PLUGINS_DIR'de durduğundan her instance aynı volume'a ihtiyaç duyar.
Pursae düz HTTP sunar. TLS'i bir proxy'de sonlandırın ve WPGO_SITE_URL'yi genel https:// adresine ayarlayın (ya da kurulumdan sonra Settings › General'dan değiştirin). Sunucu, bir isteği güvenli saymak için X-Forwarded-Proto: https'e güvenir: o zaman Strict-Transport-Security ve güvenli çerezler ayarlar, https:// bağlantılar üretir.
Ziyaretçi IP'leri ve güvenilen proxy'ler
Giriş kısıtlaması, yorum flood denetimi, Pursae Security IP engel listesi, bakım modu IP beyaz listesi ve loglar proxy'nin değil ziyaretçinin adresini görsün diye X-Forwarded-For gönderin. Bu başlığa yalnızca güvenilen bir proxy'den geldiğinde inanılır: varsayılan olarak loopback ve özel aralıklar (127.0.0.0/8, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, ::1, fc00::/7). Proxy'nizin genel bir adresi varsa WPGO_TRUSTED_PROXIES'e yazın; none hiçbir proxy'ye güvenmez.
Neden önemli Güvenilen bir proxy olmadan tüm ziyaretçiler proxy'nin adresini paylaşır ve tek bir ziyaretçinin beş başarısız girişi herkesi 15 dakika kilitler. Öte yandan güvenilen özel ağlardaki ve porta doğrudan erişebilen her makine kendi adresini seçebilir — portu yalnızca proxy'nin erişebileceği yerde yayımlayın ya da WPGO_TRUSTED_PROXIES'i tam olarak proxy'nizin adresine ayarlayın. Site URL'si https:// ve WPGO_TRUSTED_PROXIES ayarsızsa sunucu açılışta bir hatırlatma loglar.
/batch/v1 alt istekleri X-Forwarded-*, X-Real-IP ya da Forwarded'ı kendileri ayarlayamaz; dış isteğin başlıklarını taşırlar.
Caddy
blog.example.com {
reverse_proxy 127.0.0.1:8080
}
Caddy yönlendirme başlıklarını ayarlar, sertifikaları alır ve WebSocket yükseltmelerini kendiliğinden geçirir.
Statik dosyalar (/wp-includes/, /wp-admin/css/, tema ve eklenti varlıkları) uzun önbellek başlıklarıyla binary tarafından sunulur; root ya da try_files gerekmez. nginx bunları proxy_cache'te tutabilir; Pursae Cache tüm sayfalar için X-Accel-Expires da üretebilir.
GraphQL abonelikleri (Pursae Headless)
Abonelikler /wp-json/headlessgo/v1/graphql üzerinde server-sent events ve WebSocket ile iletilir. SSE ek bir şey istemez (yanıtlar X-Accel-Buffering: no taşır). WebSocket için yükseltme başlıkları geçirilmelidir:
Apache'nin mod_proxy_wstunnel'a (ya da 2.4.47+ sürümünde ProxyPass / http://127.0.0.1:8080/ upgrade=websocket'e) ihtiyacı vardır. Host başlığını koruyun: tarayıcı WebSocket'i yalnızca sitenin kendi origin'inden ya da Headless ayarlarındaki bir CORS origin'inden kabul edilir.
Apache
<VirtualHost *:443>
ServerName blog.example.com
SSLEngine on
ProxyPreserveHost On
RequestHeader set X-Forwarded-Proto "https"
ProxyPass / http://127.0.0.1:8080/
ProxyPassReverse / http://127.0.0.1:8080/
</VirtualHost>
/etc/wpgo.env; DATABASE_URL, WPGO_SITE_URL, WPGO_UPLOADS_DIR, WPGO_SECRET ve e-posta ayarlarını içerir.
Birden çok instance
Ortak bir uploads dizini (NFS ya da nesne depolama bağlantısı) ile tek veritabanına karşı istediğiniz kadar wpgo süreci çalıştırın. Her instance'a aynı WPGO_SECRET'ı verin.
Zamanlayıcı işleri FOR UPDATE SKIP LOCKED ile alır (olaylar bir kez çalışır); migration'lar advisory lock ile sıraya girer.
Ayarlar süreç başına bellekte tutulur; bir değişiklik PostgreSQL LISTEN/NOTIFY ile kısa sürede diğerlerine ulaşır (her biri bir ek bağlantı tutar, ayrıca dakikada bir yeniden yükler).
Bir ayarı kaydetmenin yan etkileri (eklenti başlatma, önbelleği yeniden yapılandırma) yalnızca kaydeden instance'ta çalışır — eklenti açıp kapattıktan sonra diğerlerini yeniden başlatın.
Her önbellek temizliği wpgo_cache_purge kanalında duyurulur; dinleyicisi yeniden bağlanan instance sayfa önbelleğini boşaltır.
Headless GraphQL abonelikleri yalnızca istemcinin bağlı olduğu instance üzerinden yapılan değişiklikleri görür; instance'lar arası takip için webhook'larını kullanın.
Pursae Cache, varsayılan olarak açık gelen yerleşik bir eklentidir; LiteSpeed Cache'ten esinlenir ama sunucudan bağımsızdır. Oluşturulan genel sayfaları Go süreci içinde önbelleğe alır (bellek LRU, isteğe bağlı disk kalıcılığı), etiketlerle hassas biçimde temizler ve bir ön proxy'ye ya da CDN'e de önbelleğe almasını söyleyebilir. Yönetim menüsü: Pursae Cache (Dashboard, Cache, Page Optimization, Toolbox).
Ne önbelleğe alınır
Giriş yapmamış ve yorum yazarı çerezi taşımayan ziyaretçilerin genel sitedeki GET istekleri. Çerez ayarlayan, Cache-Control: private/no-store/no-cache gönderen, Content-Encoding içeren ya da X-WPGo-Cache-Control: no-cache ile işaretlenen (nonce'lu formlar) yanıtlar asla önbelleğe alınmaz. Yanıtlar X-WPGo-Cache: hit|miss|bypass taşır. Arama sonuçları sayfa önbelleğinden sunulmaz.
Ayarlar (Pursae Cache › Cache)
Seçenek
Varsayılan
Anlamı
wpgo_cache_enabled
açık
eklentinin kendisi (Plugins ekranından açılıp kapanır)
wpgo_cache_serve
—
"Enable Cache" anahtarı: önbelleklemeyi durdurur, eklentiyi ve ekranlarını korur
wpgo_cache_ttl_public
7 gün
yazı, sayfa ve arşivlerin TTL'si
wpgo_cache_ttl_front
7 gün
ön sayfanın TTL'si
wpgo_cache_ttl_feed
7 gün
beslemelerin TTL'si
wpgo_cache_ttl_404
1 saat
bulunamayan sayfaların TTL'si
wpgo_cache_mobile
kapalı
mobil kullanıcı ajanları için ayrı kayıtlar
wpgo_cache_logged_in
kapalı
giriş yapmış kullanıcılar için de önbellek (kullanıcı başına)
wpgo_cache_exclude_uri
—
asla önbelleğe alınmayan yol önekleri, satır başına bir tane
wpgo_cache_drop_qs
—
önbellek anahtarında yok sayılan sorgu parametreleri (izleme parametreleri)
Diğer Cache Settings: Cache Query Strings, Do Not Cache Cookies, Do Not Cache User Agents, Browser Cache TTL, 301 Redirect TTL, Memory Limit, Preload (her temizlikten sonra 30 sn gecikmeyle ve günlük). Tarayıcı URL'lerini çekirdek sitemap sağlayıcılarından alır (ana sayfa, tüm genel yazı türleri, taksonomiler ve yazarlar).
Page Optimization (wpgo_opt_*): görsellerde lazy-load (ekranın üstündeki ilk görseller hariç), betikleri erteleme / dışlama listeli Defer All JavaScript, Delay JavaScript (listelenen parçayı içeren betikler ilk etkileşimde ya da zaman aşımında yüklenir), HTML küçültme, satır içi CSS küçültme, tema fontlarını önden yükleme, preconnect / dns-prefetch origin'leri.
Bir yazıyı yayımlamak ya da düzenlemek; kendi sayfasını, ana sayfayı, beslemeleri, yazar ve terim arşivlerini, ait olduğu tarihleri (ve yeni URL 404 olarak önbelleğe alınmış olabileceği için 404'ü) temizler.
Yorumlar yazıyı temizler; bir terimi düzenlemek ya da silmek onu listeleyen veya ona bağlanan sayfaları temizler; bir medyayı düzenlemek ya da silmek onu öne çıkan görsel olarak gösteren sayfaları temizler.
Ayar, tema, menü ve widget değişiklikleri ile bir eklenti ayar sayfasını kaydetmek her şeyi temizler. Yazıları posts API ile değiştiren eklentiler de aynı temizlemeleri tetikler.
Kapsayan bir temizlikle çakışan render ziyaretçiye gönderilir ama saklanmaz — temizlik her zaman kazanır. Aynı anonim sayfa için eşzamanlı ıskalar tek kez render edilir; diğerleri bekler (en fazla 10 sn) ve önbellekten sunulur.
Admin çubuğunda Purge this page ve Purge all vardır; Toolbox'taki tarayıcı temizlikten sonra önbelleği ısıtır. Birden çok instance varsa her temizlik hepsine ulaşır.
Ön proxy'ler ve CDN'ler
wpgo_cache_server
Üretilen başlıklar
litespeed
X-LiteSpeed-Cache-Control, X-LiteSpeed-Tag
nginx
proxy_cache / fastcgi_cache için X-Accel-Expires
generic
Cache-Control: s-maxage, Surrogate-Key ve Cache-Tag (Varnish, Fastly, Cloudflare)
auto
istek LiteSpeed üzerinden geldiyse yalnızca LiteSpeed başlıkları; aksi hâlde hiçbir şey
none
yalnızca süreç içi önbellek
Temizlemeler proxy'ye ulaşır. Front Server Purge URL ayarlandığında her temizlik bir PURGE isteği olarak iletilir: URL temizlikleri purge URL'sine sayfa yolu eklenerek gider; etiket temizlikleri önekli etiketleri (varsayılan wpgo_) listeleyen Surrogate-Key, Cache-Tag ve X-LiteSpeed-Purge taşır; tam temizlik X-Purge-All: 1 ve X-LiteSpeed-Purge: * gönderir. İstekler arka planda 5 sn zaman aşımıyla gider. Purge URL yoksa Front Server Lifetime (varsayılan 300 sn) s-maxage, X-Accel-Expires ve X-LiteSpeed-Cache-Control'ü sınırlar ve bir uyarı gösterilir.
temizleme etiketleri (hassas temizleme için gerekli)
X-WPGo-Cache-TTL: 300
saniye cinsinden TTL geçersiz kılma; 0 = önbelleğe alma
X-WPGo-Cache-Control: no-cache
bu yanıtı önbelleğe alma
Üçü de yanıt süreçten çıkmadan silinir. Önbelleğin içinde gzip yapmayın: önbellek saklarken bir kez sıkıştırır ve Accept-Encoding'i kendisi müzakere eder (dıştaki bir gzip katmanı zaten Content-Encoding taşıyan yanıtları atlamalıdır). Bir janitor süresi dolan kayıtları siler; ısıtma süreç içinde çalışır (ör. Concurrency: 4, RatePerSecond: 10).
WordPress zamanlanmış görevleri bir ziyaretçi sayfa açtığında çalıştırır. Pursae'nin gerçek bir iş çalıştırıcısı vardır: her instance 15 saniyede bir vakti gelen zamanlanmış yazıları yayımlar ve jobs tablosunun vakti gelen satırlarını FOR UPDATE SKIP LOCKED ile alır; birden çok instance bir işi asla iki kez çalıştırmaz. Ziyaretçi, wp-cron.php ya da sistem crontab'ı gerekmez.
Yinelenen bir olay tek kez bulunur (birlikte başlayan instance'larda tekrarı benzersiz bir indeks önler). Site kapalıyken kaçırılan çalışmalar tek tek telafi edilmez: olay bir kez çalışır, sonra bir sonraki zaman dilimini bekler — wp_reschedule_event() gibi.
Yerleşik olaylar
İş
Sıklık
Ne yapar
wp_scheduled_delete
günlük
30 gündür çöpte olan yazı ve yorumları siler (WPGO_EMPTY_TRASH_DAYS)
wp_scheduled_auto_draft_delete
günlük
7 günden eski otomatik taslakları siler
delete_expired_transients
günlük
süresi dolmuş transient'ları siler
wp_session_gc
saatlik
giriş oturumlarını ve eski giriş denemelerini sona erdirir
Backup Manager'ın zamanlanmış yerel yedeği, yalnızca bir zamanlama ayarlıyken; ensureEvents tarafından yeniden oluşturulmaz
Eklenti olayları
cron iznine sahip eklentiler kendi kancalarını (cron_<name>) en az bir dakikalık aralıkla ya da tek seferlik olarak zamanlar; bu satırlar sıklık olarak every:<seconds> ve payload'da eklenti slug'ını taşır.
Hatalar ve yeniden denemeler
Başarısız olan iş (hata ya da panic) 1, 4, 9 ve 16 dakika sonra yeniden denenir.
Tek seferlik iş beşinci hatadan sonra hata metniyle failed olarak işaretlenir.
Yinelenen iş asla kalıcı olarak başarısız olmaz: denemeleri bir sonraki normal çalışmasını geçmez; art arda beş hatadan sonra o çalışmayı bekler ve Site Health için attempts ile last_error'ı korur.
Çalışırken locked_at dakikada bir yenilenir; kilidi on dakikadan eski running satır kuyruğa geri döner.
SIGTERM'de eldeki iş iptal edilmiş bir context alır ve deneme sayılmadan kuyruğa geri döner. Biten tek seferlik işler bir hafta tutulur.
İnceleme
SELECT name, recurrence, status, run_at, attempts, last_error FROM jobs ORDER BY run_at;
Tools › Site Health zamanlanmış olayları ve başarısız işleri listeler. Kaybolan yinelenen olay bir sonraki açılışta yeniden oluşturulur (ensureEvents). Tools › Scheduled Actions (/wp-admin/scheduled-actions, manage_options) tüm kuyruğu durum, çalışmalar, denemeler ve son hatayla listeler; kalıcı olarak başarısız iş yeniden denenebilir (deneme sayısı sıfırlanır) ya da silinebilir; çalışan işler silinemez.
Arka planda WXR içe aktarma
Tools › Import: WXR dosyasını yükleyin, yazarları eşleyin ve "Download and import file attachments"ı seçin; içe aktarma ilerleme ekranı ve bir raporla (bir hafta tutulur) wxr_import işi olarak çalışır. Dosya uploads yanındaki wxr-imports/'ta durur (sunulmaz) ve iş bitince silinir. Yeniden içe aktarmak güvenlidir: mevcut yazılar ve medya atlanır.
Pursae, WordPress'in gönderdiği e-postaların aynısını gönderir: yeni kullanıcı bildirimleri, parola sıfırlama, yorum moderasyonu ve "yeni yorum" bildirimleri, yönetici e-posta değişikliği onayı, kişisel veri dışa aktarma bağlantıları. İletiler jobs tablosunda kuyruğa alınır ve zamanlayıcı tarafından teslim edilir; yavaş bir SMTP sunucusu hiçbir isteği geciktirmez.
WPGO_SMTP_HOST=smtp.example.com
WPGO_SMTP_PORT=587 # 465 = örtük TLS; diğer portlar sunulduğunda STARTTLS kullanır
WPGO_SMTP_USER=postmaster@example.com
WPGO_SMTP_PASS=…
WPGO_MAIL_FROM='Example Blog <no-reply@example.com>'
Docker'da docker/compose.yaml bu değişkenleri sunucuya geçirir. make prod-up için docker/.env'e yazın ve değişikliği uygulamak için make prod-up'ı yeniden çalıştırın.
Teslim edilebilirlik Alıcı sunucular kabul etsin diye gerçek bir WPGO_MAIL_FROM ayarlayın ve bunun için SPF/DKIM kurun.
Hatalar artan aralıklarla yeniden denenir (1, 4, 9, 16 dakika); beş denemeden sonra iş başarısız işaretlenir ve Tools › Site Health'te görünür.
Geliştirme: .eml dosyaları
docker compose -f docker/compose.yaml exec wpgo ls /data/mail
Dosyayı bir e-posta istemcisinde açın ya da metin olarak okuyun; örneğin parola sıfırlama bağlantısını görürsünüz. Panelde Settings › General yönetim e-posta adresini, Settings › Discussion hangi yorum olaylarının bildirim göndereceğini belirler. Pursae kendiliğinden Gravatar'a ya da başka bir üçüncü tarafa asla bağlanmaz.
Bir site üç şeydir: veritabanı, uploads dizini ve yanındaki eklenti ve tema dizinleri. Binary ve paketli temalar yedek gerektirmez.
Ne
Nerede (compose)
Nerede (binary)
veritabanı
pgdata volume'u
kendi PostgreSQL'iniz
medya
uploads volume'u (/data/uploads)
WPGO_UPLOADS_DIR
eklenti paketleri
plugins volume'u (/data/plugins)
<uploads>/../plugins
tema paketleri ve düzenlenen tema dosyaları
themes volume'u (/data/themes)
WPGO_THEMES_DIR
Backup Manager arşivleri
backups volume'u (/data/backups)
WPGO_BACKUPS_DIR
bin (imaj ya da Dashboard › Updates yenisini koyar), pagecache, languages (yeniden indirilir) ve mail yedek gerektirmez.
Veritabanı
# dump (make prod-up yığınında -f docker/compose.yaml'dan sonra -f docker/compose.prod.yaml ekleyin)
docker compose -f docker/compose.yaml exec db pg_dump -U wpgo -Fc wpgo > wpgo.dump
# aynı veritabanına geri yükleme
docker compose -f docker/compose.yaml exec -T db pg_restore -U wpgo -d wpgo --clean --if-exists < wpgo.dump
# kendi PostgreSQL'iniz
pg_dump -Fc "$DATABASE_URL" > wpgo.dump
pg_restore -d "$DATABASE_URL" --clean --if-exists wpgo.dump
Dosyalar
docker run --rm -v wpgo_uploads:/data/uploads -v wpgo_plugins:/data/plugins -v wpgo_themes:/data/themes \
-v wpgo_backups:/data/backups -v "$PWD":/backup alpine tar czf /backup/wpgo-files.tgz /data
Volume adlarının başında compose proje adı wpgo bulunur.
Siteyi taşımak
Veritabanının dump'ını alın ve dosyaları yeni sunucuya kopyalayın.
Mevcut oturumlar korunsun istiyorsanız yeni instance'ı aynı WPGO_SECRET ile başlatın.
Dump'ı geri yükleyin; adres değiştiyse URL'yi Settings › General'dan güncelleyin — kurulumdan sonra site URL'si ortamda değil veritabanında durur.
Backup Manager
Yerleşik Backup Manager eklentisi (varsayılan olarak kapalı) aynı yedeği panelden tek bir .zip olarak alır (veritabanı satırları JSON satırları olarak, artı dosyalar), bunu bu ya da başka bir sitede geri yükler ve zamanlanmış yerel yedekler çalıştırır (günlük ya da haftalık, en yeni N tanesini tutarak). Arşivler WPGO_BACKUPS_DIR'e gider, asla herkese açık uploads içine değil.
Arşivleri sunucu dışına kopyalayın Zamanlanmış yedekler aynı sunucuda kalır; S3 ya da FTP gibi uzak depolama dahil değildir.
Geri yükleme, bu sitenin kendi gizli anahtarını (auth_secret), adresini ve Backup Manager ayarlarını korur. Yerleşik eklentilerin şifreli sakladığı gizli bilgiler (SMTP parolaları ve token'ları, CDN kimlik bilgileri, Multi Language çeviri anahtarı, Security doğrulayıcı uygulamaları) bu site için yeniden şifrelenir; Pursae Security yedek kodları yalnızca hash olarak saklandığından yeniden üretilmelidir. Kaynak site WPGO_SECRET ile şifrelediyse bu siteyi aynı değerle başlatın.
İçerik dışa aktarma (WXR)
Tools › Export; yazılar, sayfalar, medya referansları, yorumlar ve terimlerle bir WXR dosyası yazar ("All content" Pursae Custom Fields yazı türlerini ve taksonomilerini de taşır). Tools › Import bunu okur; kayıtlı olmayan yazı türlerindeki öğeler atlanır ve raporda listelenir. Bu bir yedek değil, içerik aktarımıdır: parolalar, ayarlar, eklentiler ya da temalar taşınmaz.
Parolalar argon2id ile hash'lenir. Oturumlar rastgele bir çerez token'ına bağlı sunucu tarafı satırlardır (HttpOnly, SameSite=Lax, TLS arkasında Secure); 2 gün, "Remember Me" ile 14 gün sürer.
Giriş kısıtlaması: bir adresten 15 dakika içinde beş başarısız giriş o adresi engeller; bir kullanıcı adı için (herhangi bir adresten) yirmi başarısızlık o adı engeller. Denemeler parola kontrolünden önce sayılır; REST Basic kimlik doğrulaması da sayılır. Bilinmeyen kullanıcı adı yanlış parola kadar zaman alır ve aynı anda en fazla CPU sayısının iki katı kadar parola hash'i çalışır.
Nonce'lar tüm yönetim formlarını ve REST API'yi (X-WP-Nonce) korur.
Güvenlik başlıkları: X-Content-Type-Options: nosniff, X-Frame-Options: SAMEORIGIN, Referrer-Policy: strict-origin-when-cross-origin, bir Content-Security-Policy (ön yüz: script-src 'self' 'unsafe-inline', uzak betik yok) ve TLS arkasında Strict-Transport-Security.
Yüklemeler veridir, asla kod değil: /wp-content/uploads/ sandbox'lı bir CSP ile sunulur; yüklenen HTML ya da SVG betik çalıştıramaz.
İçerik filtreleme: unfiltered_html yetkisi olmayan kullanıcıların ve tüm eklentilerin içeriği kaydedilmeden önce filtrelenir (KSES).
Sandbox'lı eklentiler: dosya sistemi yok, host'un izin verdiği dışında ağ yok, bellek sınırı, çağrı başına zaman aşımı ve onayladığınız izinler. Paketler imzalıdır; yalnızca güvendiğiniz anahtarlar kurulabilir.
Çok rollü kullanıcılar: yetkiler rollerin birleşimidir, kullanıcı bazında izin ve yasak tanımlanabilir — yasak kazanır.
Üçüncü taraf çağrısı yok: Gravatar yok. Sitenin konuştuğu tek servis Hub'dır (bir sonraki bölüme bakın).
Production kontrol listesi
TLS'i bir proxy'de sonlandırın ve WPGO_SITE_URL'yi https:// adresine ayarlayın.
make prod-up ve docker/.env'deki ayarlarla başlatın; site yayına girer girmez kurulum sihirbazını çalıştırın.
Kendi eklenti imza anahtarlarınızı WPGO_PLUGIN_KEYS'e ya da plugin_trusted_keys'e yazın; plugin_allow_unsigned'ı kapalı bırakın; WPGO_TRUST_DEV_KEY0 kalmalı.
Birden çok instance çalıştırıyorsanız WPGO_SECRET'ı kendiniz ayarlayın ve gizli tutun.
Kimse tema dosyalarını düzenlemeyecekse WPGO_DISALLOW_FILE_EDIT=1 ayarlayın (ya da Pursae Security › Hardening › Disable file editors); bu hem panel editörlerini hem REST tema dosyası yollarını kapsar.
İstemcilerin sunucuya yalnızca proxy üzerinden ulaşmasını sağlayın; proxy'nin özel ağını başka makineler de paylaşıyorsa WPGO_TRUSTED_PROXIES'i proxy'nin adresine ayarlayın.
Parola sıfırlamaları ulaşsın diye SMTP'yi yapılandırın.
Veritabanını ve veri dizinlerini yedekleyin.
Etkinleştirirken eklenti izinlerini gözden geçirin. Art arda beş kez başarısız olan eklenti otomatik devre dışı kalır.
Hesaplar varsayılan olarak listelenemez: /?author=N 404 döner, /wp/v2/users giriş ister, kullanıcı sitemap'i boştur ve giriş formu bilinmeyen kullanıcı ile yanlış parolaya aynı mesajı verir. Genel bir yazar listesine ihtiyacınız varsa yalnızca o zaman WPGO_EXPOSE_USERS=1 ayarlayın. Yazar arşivleri (/author/<nicename>) herkese açık kalır ve slug giriş adından gelir; yayın yapan her hesaba giriş adından farklı bir görünen ad ve takma ad verin.
Çekirdeği güncel tutun ve imajları düzenli yeniden derleyin (build en güncel golang:1.27 imajını kullanır); govulncheck ./... temiz kalmalı.
Pursae Security (yerleşik eklenti) bunun üzerine iki adımlı giriş, özel giriş URL'si, kilitlemeler ve bir etkinlik logu ekler.
Güvenlik açığı bildirmek Herkese açık bir issue yerine GitHub deposunda özel bir security advisory açın.
Her production build güncellemeler, tema ve eklenti marketplace'i ve lisanslar için https://hub.pursae.com adresindeki Pursae Manager ile konuşur.
Ne zaman
Ne
Günde bir kez (ve çekirdek güncellemesinden bir dakika sonra)
site URL'si, Pursae sürümü, dil, işletim sistemi ve CPU mimarisi, lisans anahtarı (girildiyse), etkin tema ve kurulu eklenti/temaların sürümleri, etkin olup olmadıkları ve kaynakları (yerleşik, Hub'dan, yüklenmiş)
Olduğu anda (toplu gönderilir)
paket işlemleri: eklenti kuruldu/güncellendi/etkinleştirildi/devre dışı bırakıldı/silindi; tema kuruldu/güncellendi/etkinleştirildi/önizlendi/silindi; demo içe aktarıldı; çekirdek güncellendi — her biri slug, sürüm ve zamanla
Hub'a yapılan her istekte
başlık olarak site URL'si ve lisans anahtarı; Hub, her web sunucusu gibi sunucunun IP adresini de görür
İçeriğiniz, kullanıcılarınız, e-posta adresleri, parolalar, ziyaretçiler, siparişler ya da veritabanınızdaki başka hiçbir şey asla gönderilmez. Karşılığında site imzalı çekirdek güncellemelerini (her binary, Pursae'ye gömülü release anahtarının onayladığı bir Hub anahtarıyla imzalıdır), imzalı Wasm eklentilerini, tema kütüphanesini (SHA-256 ile denetlenir), pro ve beta paket lisanslarını ve ürün logosunu alır.
Kapatmak
WPGO_HUB=off ayarlayın (Docker'da docker/.env içinde) ve yeniden başlatın; site hub.pursae.com'a hiçbir şey göndermez. Güncellemeleri yeniden almak için kaldırıp yeniden başlatın.
Önerilmez Hub kapalıyken site güncelleme bildirimi ya da tek tık güncelleme — güvenlik düzeltmeleri dahil — almaz; marketplace, imzalı eklentiler ve lisanslar da olmaz. Her sürümde binary'yi kendiniz değiştirirsiniz ve her yönetim sayfası bunu belirtir.
Bir sürüm, platform başına bir statik binary'den oluşan ve GitHub release olarak yayımlanan bir settir. Pursae Manager bunu içe aktarır, her binary'nin hash'ini onaylı anahtarıyla imzalar ve her site sürümü Dashboard › Updates altında görür. Manager asla derleme yapmaz ve dosyaların kopyasını tutmaz; siteler GitHub'dan indirir.
1. Derleme ve yayımlama
make release VERSION=0.2.0 # kararlı
make release VERSION=0.3.0-beta.1 BETA=1 # beta kanalı (GitHub pre-release)
make release VERSION=0.2.0 DRY_RUN=1 # yalnızca derle ve denetle, dist/release/v0.2.0 içine
tools/release.sh:
commit edilmemiş değişiklikleri, izlenmeyen dosyaları ya da başka bir commit'i gösteren v0.2.0 etiketini reddeder;
linux-amd64, linux-arm64, darwin-arm64, darwin-amd64 ve windows-amd64'ü CGO_ENABLED=0 go build -trimpath -buildmode=exe -tags nodynamic -ldflags "-s -w -X wpgo/internal/server.Version=0.2.0" ile derler; Linux binary'lerinin statik olduğunu ve makinenizin binary'sinin sürümü bildirdiğini denetler;
SHA256SUMS yazar;
yayımlamadan önce sorar, ardından sürümü commit'ler ("Pursae 0.2.0"), v0.2.0 etiketini atar, public remote'una gönderir ve binary'ler (pursae-<os>-<arch>, Windows'ta .exe) ile SHA256SUMS'u içeren GitHub release'ini oluşturur.
Ayar
Varsayılan
Anlamı
VERSION
—
yayımlanacak sürüm
BETA
—
1 beta kanalına yayımlar (GitHub pre-release)
DRY_RUN
—
1 yalnızca derler ve denetler
RELEASE_REPO
pursae/pursae
herkese açık olmalı; siteler kimlik bilgisi olmadan indirir
RELEASE_REMOTES
—
sürüm ayarı (belgede ayrıntı verilmiyor)
TARGETS
—
sürüm ayarı (belgede ayrıntı verilmiyor)
NOTES_FILE
GitHub'ın ürettiği notlar
sürüm notları
YES
—
1 soru sormaz
Go, git ve GitHub CLI (gh auth login) gerekir.
2. Pursae Manager'a içe aktarma
Core › Import: etiket, kanal (kararlı ya da beta lisanslar için beta), notlar, Import Release. Manager sürümü GitHub API'sinden okur, her pursae-<os>-<arch> dosyasını bir kez indirir, SHA256SUMS'a göre (ve Linux binary'lerinin statik olduğunu) denetler, pursae-core-v1\n{version}\n{os}-{arch}\n{sha256}'yı imzalar, hash'i, imzayı ve GitHub URL'sini saklar ve yayımlar. Binary'si olmayan platforma sürüm sunulmaz.
3. Siteler ne yapar
Bir sonraki güncelleme kontrolünde (günlük ya da Dashboard › Updates'te) siteler sürümü görür. Update, platformun binary'sini Manager'dan ister, GitHub'a yönlendirmeyi izler, SHA-256'yı ve imzayı denetler, executable'ı değiştirir ve yeniden başlar.
Release dosyalarını asla değiştirmeyin İçe aktarmadan sonra GitHub'da değiştirilen bir dosya denetimden geçemez ve siteler reddeder. Bunun yerine yeni bir yama sürümü yayımlayın (ve GitHub'ın immutable releases özelliğini açmayı düşünün).
Yeniden başlatmadan sonra site yine /wp-admin/install'a yönleniyor
Veritabanı boş ya da başka bir veritabanı kullanılıyor. pgdata volume'unun durduğunu (docker volume ls) ve DATABASE_URL'nin kurulum yaptığınız veritabanını gösterdiğini kontrol edin.
Docker yeniden başladı, site kapalı
Container'lar her zaman geri gelmez. make prod-up (production) ya da docker compose -f docker/compose.yaml up -d (geliştirme) çalıştırın. Yığını hangi komutla başlattıysanız onu kullanın — production sunucusunda geliştirme dosyası, geliştirme ayarlarını ve yanlış veritabanı parolasını getirir.
Bağlantılar/varlıklar eski bir IP ya da portu gösteriyor
Site URL'si kurulumda kaydedildi. Settings › General'dan değiştirin ya da doğru WPGO_SITE_URL ile baştan başlayın.
8088 ya da 5432 portu dolu (ör. yerel bir WordPress)
WPGO_PORT=9000 WPGO_DB_PORT=5433 WPGO_SITE_URL=http://localhost:9000 make docker-up
İlk build yavaş ya da modüller inmiyor
Docker'ın ağ erişimi olduğundan emin olun; sonraki build'ler önbelleklenir.
Giriş çalışıyor ama her yönetim işleminde nonce geçersiz deniyor
Yük dengeleyicinin arkasındaki instance'ların WPGO_SECRET'ları farklı. Hepsine aynı değeri verin.
TLS proxy arkasında http:// bağlantılar
Proxy X-Forwarded-Proto: https göndermeli ve WPGO_SITE_URL (ya da Settings › General) https:// adresi olmalı.
Eklenti: "signature could not be verified"
Paket imzasız ya da güvenilmeyen bir anahtarla imzalı. Yazarın genel anahtarını WPGO_PLUGIN_KEYS'e ya da plugin_trusted_keys'e ekleyin; yerel geliştirmede plugin_allow_unsigned'ı ayarlayın.
Eklenti: "disabled after 5 consecutive failures"
Plugins'te log satırlarını okuyun (son beşi gösterilir); sıfırlamak için devre dışı bırakıp yeniden etkinleştirin.
Pursae'de yerleşik bir Model Context Protocol sunucusu vardır. Bağlanan bir yapay zekâ istemcisi (Claude, Cursor ve diğerleri) içerik yazıp yayımlayabilir, medya yükleyebilir, menü kurabilir, tema dosyası düzenleyebilir, tema değiştirebilir, eklenti açıp kapatabilir, önbelleği temizleyebilir ve yerleşik eklentilerin ayarlarını değiştirebilir — hepsi tek bir kimlik bilgisinin izinleriyle REST API üzerinden.
Giriş: OAuth 2.1 (tarayıcıda onay ekranı) ya da kullanıcı adı ve Application Password ile HTTP Basic. Her araç bir REST isteği olarak çalışır; yetkiler ve kapsamlar doğrudan REST çağrılarındaki gibi uygulanır.
stdio:wpgo mcp, yerel komut başlatan istemciler için bir köprüdür; site yerel ya da uzak olabilir.
Kaynaklar: geliştirici belgeleri (pursae-docs://developer/…); ajan, temaları ve eklentileri değiştirmeden önce nasıl çalıştıklarını okuyabilir.
1. Giriş yapın
OAuth (kopyalanacak parola yok): istemciyi uç noktaya yönlendirin. İstemci yetkilendirme sunucusunu 401 yanıtından bulur, kendini kaydeder ve sitenin Authorize Application ekranını tarayıcıda açar: adı kontrol edin, kapsamları işaretleyin (varsayılan Content ve Media; kullanıcının yapabildiği her şey için açıkça Full access kutusu gerekir) ve onaylayın. Users › Profile › Connected applications altından istediğiniz an iptal edebilirsiniz.
claude mcp add --transport http pursae https://example.com/wp-json/pursae/v1/mcp
# ardından Claude Code içinde /mcp çalıştırıp "Authenticate"i seçin
Application Password (OAuth desteklemeyen istemciler, betikler ve wpgo mcp için): Users › Profile › Application Passwords — bir ad verin, gereken kapsamları işaretleyin (tüm yetkileriniz için hiçbirini işaretlemeyin) ve parolayı kopyalayın (yalnızca bir kez gösterilir). İçerik işleri için Editor, tema, eklenti ve ayarlar için Administrator kullanın. Ajanın erişimini hemen kesmek için aynı ekrandan iptal edin.
İş
Önerilen kapsamlar
Yazma ve yayımlama
content, media, seo
Tasarım işleri
themes, media, cache
Tüm siteyi yönetmek
hiçbiri (tam erişim)
2. İstemciyi bağlayın
Uzak siteler için HTTPS kullanın: Basic kimlik doğrulama parolayı her istekte gönderir.
Başlık değeri Basic + user:password'ün base64'üdür. Diğer MCP istemcileri de aynı şekilde çalışır.
wpgo mcp bayrakları
Bayrak
Ortam değişkeni
Anlamı
--url
PURSAE_URL
site adresi
--user
PURSAE_USER
giriş adı ya da e-posta
--password
PURSAE_APP_PASSWORD
Application Password; ortam değişkenini tercih edin (bayrak ps'te görünür ve köprü uyarı verir)
—
PURSAE_CONFIG_DIR
OAuth token'larının saklandığı dizini değiştirir
wpgo mcp login --url https://example.com [--scope "content media"] [--no-browser], PKCE'li OAuth 2.1 akışını çalıştırır (127.0.0.1 üzerinde loopback yönlendirme) ve token çiftini <user config dir>/pursae/mcp-<host>.json dosyasına (0600 izinli düz dosya, işletim sistemi anahtarlığı değil) kaydeder. Sonrasında wpgo mcp --url https://example.com parola istemez: Bearer token gönderir ve 401'de bir kez yeniler. Köprü localhost, 127.0.0.1 ve ::1 dışında düz http:// URL'leri reddeder; stdout'a yalnızca protokol mesajları yazar, hatalar stderr'e gider.
Oturumlar ve akış
initialize bir Mcp-Session-Id döndürür; bilinmeyen ya da sona ermiş kimlik 404 alır (yeniden initialize edin). Başlık yoksa sunucu durumsuz yanıt verir. Oturumlar kullanıcıya aittir, kullanıcı başına 10 ile sınırlıdır ve bir saat kullanılmazsa sona erer.
POST, application/json ya da Accept bunu tercih ediyorsa tek olaylı text/event-stream ile yanıt verir.
Accept: text/event-stream ile GET sunucu→istemci akışını açar: bildirimler ve her 25 saniyede bir : keep-alive; son 64 olay Last-Event-ID ile yeniden bağlananlar için tutulur; oturum başına tek akış; token ya da parola iptal edilince veya süresi dolunca akış biter.
DELETE oturumu sonlandırır (204).
Araçlar
Alan
Araçlar
Yazılar ve sayfalar
list_posts, get_post, create_post, update_post, delete_post ve sayfalar için aynıları
Medya
list_media, upload_media (base64 ya da genel bir URL), update_media, delete_media
list_option_groups, get_options, update_options (contact, cookie, gocdn, headless, maintenance, multilang, pixel, security, seo, smtp; gizli bilgiler maskelenir)
Diğer her şey
site_info, rest_request (herhangi bir REST yolu, aynı izinlerle)
tools/list yalnızca kimlik bilgisinin kullanabildiği araçları gösterir (kapsamlar, yetkiler, etkin eklentiler); bir eklenti açılıp kapandığında notifications/tools/list_changed gönderilir. Reddedilen çağrılar REST hata koduyla döner (rest_forbidden, rest_scope_forbidden, …). Açıklamalar MCP spesifikasyonunu izler: okuma araçlarında (ve seo_analyze'da) readOnlyHint, salt ekleme yapmayan her araçta destructiveHint.
Güvenlik
Yazma yapan her çağrı 90 gün loglanır (zaman, kullanıcı, OAuth uygulaması ya da Application Password adı, araç, yol, durum; gövde yok). ai_activity, GET /pursae/v1/mcp/activity ya da Tools › AI Access (/wp-admin/ai-access, manage_options) ile okunur; bu ekran uç noktayı, hazır istemci yapılandırmalarını ve her OAuth iznini Revoke düğmesiyle de gösterir.
Saatlik bir iş süresi dolan OAuth izinlerini ve kodlarını, sahipsiz istemcileri ve saklama süresini aşan etkinliği siler.
400 KB'ı aşan araç yanıtları kesilir ve structuredContent taşımaz.
write_theme_file şablonları saklamadan önce denetler; restore_theme_file düzenlemeleri geri alır; WPGO_DISALLOW_FILE_EDIT=1 tema dosyası değişikliklerini tamamen yasaklar.
upload_media yalnızca genel adreslerden indirir; Pursae Security'nin kilitlemeleri ve IP engel listesi uç noktaya da uygulanır.
Ajana işi görecek en dar kapsamları ve en az yetkili kullanıcıyı verin.
Bir WordPress sitesinin genellikle ayrıca satın aldığı ya da kurduğu eklentiler Pursae'nin kendi ikili dosyasında gelir. Her biri Eklentiler ekranında listelenir, yeni kurulumda kapalıdır, kapalıyken hiçbir şey eklemez (menü, rota, çıktı yok) ve devre dışı bırakıldığında verisini korur.
Premium eklentileri modül olarak içeren bir WooCommerce klonu: ürünler, sepet, ödeme, vergi, kargo, kuponlar, siparişler, ödeme geçitleri, e-postalar ve iki REST API'si. İç adı goocommerce, anahtarı native_goocommerce. Kapalıyken ekranları 404, REST rotaları rest_no_route döndürür.
Veri
Ürünler product / product_variation türünde yazılar ve goo_products içinde bir satırdır.
HPOS benzeri siparişler: goo_orders, goo_order_items, goo_order_notes; ayrıca nitelik, kupon, vergi oranı, kargo bölgesi/yöntemi, oturum, indirme izni, API anahtarı ve webhook tabloları.
Modüller (Pursae Commerce › Extensions, hepsi varsayılan olarak kapalı)
Subscriptions:wc/v3/subscriptions (CRUD, toplu işlem, notlar, siparişler), webhook konuları, müşterinin adres/ödeme yöntemi değiştirmesi ve yeniden abone olması, yönetimde elle abonelik ve "Process renewal".
Gift Cards: iptal/iadede devre dışı kalır, son kullanmadan bir hafta önce hatırlatma, beş renk tasarımı (isteğe bağlı görsel), PDF kart ve imzalı yazdırma sayfası; Store API ve wc/v3/gift-cards.
Product Add-Ons: nonce korumalı dosya yükleme (adres başına 10 dakikada 20, sahipsiz dosyalar 24 saat sonra silinir), koşullu alanlar, tarih sınırları.
Bookings: imzalı .ics indirmeleri ve özel ICS akışı, gece yarısını aşan bloklar, geçit destekliyorsa iptal edilen ücretli rezervasyonların otomatik iadesi, wc-bookings/v1 REST.
Memberships: siparişlere ve aboneliklere bağlı yaşam döngüsü, hoş geldin / bitmek üzere / bitti e-postaları, kısıtlı içerik için kademeli açılış (drip).
Vitrin, bloklar ve API'ler
Mağaza sayfaları, WooCommerce'in tema uyumluluk modu gibi etkin temanın içinde render edilir; WooCommerce'in şablonları, sınıfları ve alan adları korunur. Temalar theme.json içinde "supports": { "woocommerce": true } bildirir.
Kısa kodlar goocommerce_* adını taşır ve woocommerce_* takma adına da yanıt verir. Sunucuda render edilen bloklar: ürünler, öne çıkan ürün, ürün kategorileri, mini sepet, ürün arama.
wc/store/v1 (Store API) ve wc/v3 (yönetim API'si) WooCommerce'in JSON biçimlerini, parametrelerini, hata kodlarını ve başlıklarını izler; wc-analytics gelir, sipariş ve ürün raporları sunar.
Kupon/müşteri/sipariş/ürün olayları, modül konuları ve action.<hook> için webhook'lar; başarısız gönderim 10 sn ve 1 dk sonra yeniden denenir, art arda 5 hatada webhook kapanır; "Send test delivery" düğmeli gönderim günlüğü.
WooCommerce sütun adlarıyla ve Meta: <key> sütunlarıyla CSV ürün içe/dışa aktarma; 50 satırlık partilerle içe aktarma; siparişler, kuponlar, abonelikler ve müşteriler için CSV dışa aktarma.
Ödeme ve eşzamanlılık
Geçitler: banka havalesi (BACS), çek, kapıda ödeme, Stripe (Stripe'ın barındırdığı Checkout, imzalı webhook, API ile iade, kayıtlı kartlar, oturumsuz yenilemeler) ve Test payments geçidi.
Sipariş durumu değişiklikleri sipariş başına sıraya alınır; stok ve kupon kullanımı koşullu güncellemelerle düşülür, bu yüzden son ürünü kaçıran bir ödeme fazla satış yapmak yerine siparişi beklemeye alır.
Sınırlar iyzico henüz yok. BACS, çek, kapıda ödeme ve Bookings otomatik iade yapmaz. Konum belirleme CDN/proxy ülke başlıklarını kullanır (GeoIP veritabanı yok). Sepet ve Ödeme için henüz editör bloğu yok; [goocommerce_cart] ve [goocommerce_checkout] kısa kodlarını kullanın. E-postalar ve modüllerin ön yüz metinleri hâlâ İngilizce. Ödeme adımı stoku doğrular ama ayırmaz.
Yoast SEO Premium ile Rank Math Pro'nun yaptıklarının birleşimi; WordPress tarzı yönetim arayüzüyle tek eklenti. Kısa adı seo-go, anahtarı native_seogo, tüm ayarlar tek JSON seçeneğinde (seogo_options). Kapalıyken rotaları 404 döner, <head>'e hiçbir şey eklenmez ve çekirdeğin wp-sitemap.xml ile robots.txt dosyaları sunulur.
İçe aktarılan sitelerle uyumluluk
Rank Math'in %var% sözdizimini yazar, Yoast'un %%var%% sözdizimini de kabul eder; iki eklentinin değişken adları da çalışır.
_seogo_* meta anahtarlarını kullanır ama her okumada önce Yoast'un _yoast_wpseo_*, sonra Rank Math'in rank_math_* anahtarlarına düşer; WordPress'ten taşınan site SEO verisini dönüştürme gerekmeden korur. Tools › Import ve WXR içe aktarıcısı da veriyi kopyalar.
Yoast ve Rank Math'in FAQ / How-to bloklarını ve içerik haritası kısa kodlarını okur; iki eklentinin REST head uç noktalarını (yoast/v1/get_head, rankmath/v1/getHead) ve seogo/v1/get_head uç noktasını sunar.
Editör ve analiz
Tek SEO kutusu: klasik editörde meta kutusu, Pursae Editor'da kenar çubuğu ve belge paneli, Pursae Web Builder'ın Page tools penceresinde SEO sekmesi.
Odak anahtar ifade ve ilgili ifadeler, mobil/masaüstü snippet önizlemesi, değişkenli başlık ve açıklama, canonical, tüm robots yönergeleri, içerik haritası başlığı, birincil kategori, Open Graph / X önizlemeleri.
SEO analizi: Yoast'un tüm değerlendirmeleri ve Rank Math'in ek testleri; Yoast tarzı trafik ışıkları ve yanında Rank Math'in 100 puanlık skoru. Okunabilirlik: Yoast'un 7 değerlendirmesi, Flesch ve okuma süresi bilgi olarak; Türkçe için geçiş kelimeleri ve Türkçeye uygun küçük harf dönüşümü (I/ı, İ/i).
Köşe taşı (pillar) içerik, iç bağlantı önerileri, sahipsiz içerik filtresiyle bağlantı sayacı, toplu düzenleyici (sayfa başına 50) ve yazı listelerinde SEO / Okunabilirlik sütunları.
Schema sekmesi: sayfa türü, makale türü, Product ve özel JSON-LD.
Site geneli çıktı
İçerik türü, taksonomi ve arşiv başına arama görünümü şablonları (Commerce ürünleri ve Custom Fields yazı türleri dahil), aynı 14 ayırıcı, Knowledge Graph (kurum veya kişi), sosyal ayarlar, webmaster doğrulama (Google, Bing, Baidu, Yandex, Pinterest, Naver), RSS öncesi/sonrası metin, robots.txt düzenleyici, JSON olarak ayar içe/dışa aktarma.
Yoast'un @id şemasıyla schema grafiği, FAQ ve How-to blokları, Product, LocalBusiness (Local SEO modülü) ve özel JSON-LD. Blok ve kısa kod olarak içerik haritası (breadcrumb), BreadcrumbList şemasıyla.
Yoast'un URL şemasıyla site haritaları (/sitemap_index.xml), dosya başına 1000 URL (ayarlanabilir), görsel girdileri, Pursae Multi Language ile hreflang alternatifleri; /sitemap.xml ve /wp-sitemap*.xml 301 ile yönlenir. Haber site haritası (son 48 saat) ve video site haritası (YouTube/Vimeo gömmeleri ve sitedeki videolar).
Anahtar dosyası, otomatik ve elle gönderim ve yeniden denemelerle IndexNow.
Yönlendirmeler, 404'ler ve Search Console
301, 302, 307, 410, 451 yönlendirmeleri; tam eşleşme, içerir, ile başlar, ile biter ve regex; kategoriler, isabet sayaçları, CSV içe/dışa aktarma, yazı ve terim slug'ı değişince otomatik yönlendirme.
İsabet, referer ve user agent kaydeden, yok sayma listeli ve "Redirect" düğmeli 404 izleyici; her 404 için isteğe bağlı yedek URL.
Site sahibinin kendi Google OAuth istemcisiyle (salt okunur kapsam) Search Console raporu: son 28 günün tıklama, gösterim, TO ve konumu, en iyi 10 sorgu ve sayfa. Gizli anahtar ve token'lar şifreli saklanır.
Modüller tek tek açılıp kapatılabilir; rol yöneticisi rol başına seogo_* yetkileri verir. İlk etkinleştirmede beş adımlı kurulum sihirbazı açılır.
Dışarıda bırakılanlar Search Console dışındaki Rank Math Analytics, Content AI ve Yoast AI, SEMrush/Wincher, Yoast kelime biçimleri ve eş anlamlılar, kapsayıcı dil, görsel schema oluşturucu ve şablonları, wp/v2 üzerindeki yoast_head alanları, terim ekranında canlı analiz ve .htaccess düzenleyici (Pursae her isteği kendisi sunduğu için geçerli değil).
Advanced Custom Fields PRO 6.x'in yerleşik klonu. İç adı acfgo, anahtarı native_acfgo. Alan grupları, içeriği ACF'nin dışa aktarma JSON'u olan acf-field-group yazılarıdır; değerler tam olarak ACF gibi saklanır (name → değer, _name → alan anahtarı, tekrarlayıcı satırlar name_{i}_{sub}, seçenekler options_{name}). Bu sayede WXR ile gelen ACF verisi olduğu gibi okunur.
Alan grupları ve alan türleri
Görünümler, satır ve toplu işlemler, arama içeren Field Groups listesi; sürükle-bırak düzenleyici; alan ayarı sekmeleri (General, Validation, Presentation, Conditional Logic); ACF tarzı group_… / field_… anahtarları.
<data>/acf-json ve etkin tema paketinde Local JSON, "Sync available" ile; Go kodundan kayıt (acfgoRegisterLocalGroup).
PRO türleri dahil tüm ACF alan türleri: text, text area, number, range, email, URL, password, image, file, WYSIWYG, oEmbed, gallery, select, checkbox, radio, button group, true/false, link, post object, page link, relationship, taxonomy, user, Google Map, tarih / tarih-saat / saat seçiciler, renk seçici, message, accordion, tab, group, Repeater (sayfalamalı), Flexible Content, Clone, Icon Picker.
Çift yönlü Relationship, Post Object ve User alanları değerlerini ilgili nesnelerin hedef alanına yansıtır.
Alanların göründüğü yerler
Konum kuralları (VE kurallarından oluşan VEYA grupları): yazı türü, şablon, durum, biçim, kategori, taksonomi, sayfa türü/üst sayfa, mevcut kullanıcı ve rolü, kullanıcı formu, taksonomi terimi, ek dosya, yorum, menü ve menü öğesi, ACF Blocks, Options Page.
Sunum ayarları (stil, konum, etiket ve açıklama yerleşimi, ekranda gizleme); kutular hem klasik editörde hem Pursae Editor'da.
Koşullu mantık editörde canlı ve kayıtta; doğrulama gönderimden önce ajax ile ve sunucuda, REST yazmaları dahil.
Arayüzden oluşturulan seçenek sayfaları; türleri yönetim menüsü, ön yüz rotaları, arşivler ve /wp/v2/<rest_base> REST rotalarıyla kaydeden Post Types ve Taxonomies arayüzü.
acf-blocks/<name>/block.json klasörlerinden, Go html/template render şablonuyla ACF Blocks.
Geliştirici erişimi
Yazılar, sayfalar, kullanıcılar, terimler, yorumlar ve medya üzerinde REST acf nesnesi (okuma ve doğrulamalı yazma; biçimli değerler için ?acf_format=standard).
Tema şablon fonksiyonları get_field, the_field, get_field_object, get_fields, have_rows, get_sub_field vb.; Go yardımcıları acfGetField, acfUpdateField; Wasm eklentileri get_post ile acf nesnesi alır.
Tools: alan grupları, yazı türleri, taksonomiler ve seçenek sayfaları için JSON içe/dışa aktarma.
Farklar PHP olmadığı için acf/* PHP filtreleri, acf_form() ve Generate PHP yok. Widget konumları, alan değeri revizyonları, bir alanı başka gruba taşıma ve CPT UI içe aktarma dışarıda. Bazı seçiciler yerel kontrollerdir (tarayıcının tarih girişi, wpLink yerine URL alanları, Google Maps seçici yerine adres ve koordinat); WYSIWYG yalnızca klasik editörün yüklendiği ekranlarda TinyMCE'dir.
Polylang Pro'nun (3.9) birebir işlevsel klonu; üstüne TranslatePress tarzı görsel çeviri, otomatik metin yakalama, dile göre medya metinleri ve makine çevirisi. İç adı golylang, Polylang'in anahtarlarını kullanan golylang seçeneği. Kapalıyken menü yoktur, pll/v1 ad alanı gizlidir ve /fr/ URL'leri 404 döner.
Diller ve URL'ler
Yaklaşık 100 hazır yerel ayar, RTL, bayrak (iki harfli kodla emoji bayrak), sıra ve varsayılan dil içeren Languages ekranı; dil başına etkinleştirme/devre dışı bırakma.
Dil dizinden, alt alan adından, ayrı alan adlarından veya içerikten (?lang=); varsayılan dili gizleme; tarayıcı dilini algılama; çevrilmiş ve paylaşılan slug'lar.
Her bağlantı dili taşır; sorgular, akışlar, arama ve site haritaları o dile daraltılır; <html lang>, dir="rtl", hreflang ve dile göre site haritaları.
İçerik ve metinler
Yazı, sayfa, terim ve medya listelerinde dil sütunları; klasik editörde, Pursae Editor'da ve Pursae Web Builder'da Languages kutusu; terimleri, öne çıkan görseli, özel alanları ve fazlasını kopyalayan çeviri ekleme akışı.
Taksonomiler, özel alanlar, yorum/ping durumu, sabitleme, tarih, biçim, üst sayfa, şablon, sıra ve öne çıkan görsel senkronizasyonu (her çeviri kendi Pursae SEO metinlerini korur).
İçerik çoğaltma, toplu çeviri, Untranslated / Outdated görünümleri, içerik için XLIFF 1.2, metinler için PO içe/dışa aktarma.
Site başlığı, slogan, tarih/saat biçimleri, URL slug'ları, tema gettext ve Customizer metinleri, Wasm eklenti metinleri ve sayfalarda kaydedilen metinleri kapsayan Strings ekranı.
Her yükleme için tek Medya Kütüphanesi öğesi; alternatif metin, başlık, altyazı ve açıklama dile göre çevrilir.
Dile göre menüler, dil değiştirici menü öğesi, blok ve pll_the_languages şablon fonksiyonu.
Görsel ve makine çevirisi
Görsel çeviri ekranı: sayfa bir iframe içinde, yanında metin paneli; sayfadaki herhangi bir metne tıklayıp canlı önizlemeyle çevirin. Her tema türüyle çalışır, en az iki dil gerekir; alt alan adı/alan adı URL modlarında yoktur.
DeepL, Google Cloud Translation veya OpenAI uyumlu bir API ile makine çevirisi (varsayılan kapalı). Anahtar AES-GCM ile mühürlenir ve bir daha gösterilmez; metin yalnızca bir yönetici istediğinde gönderilir; istekler sunucudan ve yalnızca genel adreslere gider.
Dile özel manage_translations ve translate_{lang} yetkileri, site yöneticisi olmayan çevirmenlere çeviri ekranlarını açar.
Dışarıda bırakılanlar.mo dil paketi indirme ve yerel ayar yedeği, kurulum sihirbazı (Languages ekranı aynı adımları yapar), senkronize yazılar, eski widget'lar ve widget başına dil, Quick/Bulk Edit dil seçimi, WPML API'si ve WP-CLI wp pll.
Contact Form 7'nin (6.2.3 üzerinden incelendi) yerleşik klonu; Flamingo tarzı kayıt saklama ve Really Simple CAPTCHA içinde. İç adı gontact-form, anahtarı native_gontact_form. CF7 ile aynı yazı türü (wpcf7_contact_form), meta anahtarları, varsayılan şablonlar, yönetim ekranları, form işaretlemesi ve JavaScript olayları; CF7 formları, temaları ve betikleri değişmeden çalışır.
Formlar ve yerleştirme
Liste, ekleme ve düzenleme ekranlarıyla Contact menüsü; Form, Mail, Mail (2), Messages ve Additional Settings sekmeleri; etiket oluşturucu; yapılandırma doğrulayıcı.
[contact-form-7 id="…"] ve [contact-form …] kısa kodları (hash kimlik, sayısal kimlik, başlıkla arama) ve contact-form-7/contact-form-selector bloğu.
Koşullu gruplar (equals, contains, greater than… kurallı [group]), sunucuda yeniden denetlenir.
Gönderim ve e-posta
Aynı durum kodları ve yanıt biçimiyle CF7'nin REST feedback, schema ve refill uç noktaları; JavaScript'siz yedek akış ve satır içi hatalar.
Tüm mail etiketleri ve özel etiketler; HTML e-posta; ekler bellekte tutulur (gönderim başına 25 MiB) ve diske hiç yazılmaz; kayıt başına teslim durumu.
Kayıtlar gontact_entries tablosunda: listeleme, arama, görüntüleme, silme, formül güvenli CSV dışa aktarma, gün cinsinden saklama süresi; form başına do_not_store: true.
X-Pursae-Signature ile imzalanan giden webhook'lar (webhook_url); Wasm kancaları wpcf7_validate, wpcf7_before_send_mail, wpcf7_spam, wpcf7_mail_sent.
Spam koruması
Bal küpü alanı ve HMAC imzalı en kısa doldurma süresi (3 sn) varsayılan olarak açık; adres başına dakikada 30 gönderim ve 30 yenileme sınırı; yasaklı kelimeler; quiz.
reCAPTCHA v3 ve Cloudflare Turnstile (Pursae Cookie açıksa reCAPTCHA yalnızca onaydan sonra yüklenir).
Saf Go ile çizilen yerleşik görsel CAPTCHA: birbirine benzeyen karakterler olmadan 4 karakter, tek kullanımlık, bir saatte süresi dolar, cevap yalnızca HMAC olarak saklanır, sayfa önbelleğinin arkasında çalışır.
Taşınmayanlar Akismet, Constant Contact, Brevo, Stripe, reflection / listo, sesli CAPTCHA (erişilebilir alternatif [quiz] etiketi) ve arayüz çevirileri (arayüz İngilizce).
WP Mail SMTP'nin (Lite ve Pro) yerleşik klonu. İç adı wpgo-mail-smtp, anahtarı native_wp_mail_smtp, ayarlar özgün eklentinin anahtar adlarıyla tek JSON seçeneğinde. Eklenti kapalıyken wp_mail()WPGO_SMTP_* ortam değişkenlerini (geliştirme sitelerinde .eml dosyalarını) kullanmaya devam eder. Pro özellikleri lisans gerekmeden dahildir.
Göndericiler
Other SMTP (yerel istemci: SSL, STARTTLS, Auto TLS, AUTH PLAIN/LOGIN), SendLayer, SMTP.com, Brevo, Mailgun, SendGrid, Postmark, SparkPost, Amazon SES, Microsoft 365 / Outlook, Google / Gmail, Zoho Mail, Elastic Email, Mailjet, MailerSend, Resend, SMTP2GO, Mandrill.
OAuth göndericileri site sahibinin kendi uygulamasını kullanır; token'lar otomatik yenilenir. Tüm göndericiler Cc, Bcc ve ekleri iletir.
Gizli bilgiler (parolalar, API anahtarları, OAuth token'ları) AES-256-GCM ile şifrelenir ve formlara geri yazılmaz.
Yönlendirme ve güvenilirlik
Test e-postası ve alan adı denetleyicisi (SPF, DKIM, DMARC, MX) içeren kurulum sihirbazı.
Gönderen e-posta / adını zorlama, Return Path, yedek bağlantı, ek bağlantılar ve konu, mesaj, gönderen, alıcı, yanıt adresi veya başlatıcıya göre Smart Routing.
Dakika, saat, gün, hafta ve ay başına gönderim sınırları; sınırı aşan e-posta yeniden kuyruğa alınır.
Günlük, raporlar ve uyarılar
İçerik, durum, yeniden gönderme (başka alıcılara da), CSV veya EML (zip) dışa aktarma, saklama süresi ve DNT/GPC ziyaretlerini saymayan isteğe bağlı imzalı açılma/tıklama takibiyle Email Log.
Günlük gönderilen/başarısız grafiği, açılma, tıklama ve geri dönme oranları, haftalık özet e-postası içeren raporlar; pano bileşeni ve Site Health satırı.
Hata eşiğiyle e-posta, Slack, Discord, Microsoft Teams, Twilio SMS veya özel webhook uyarıları; Postmark, SendGrid, Mailgun ve Amazon SES'ten (SNS imzası doğrulanır) teslim, geri dönme ve şikâyet durumu.
Çekirdek ve Commerce bildirim türlerini tek tek kapatan Email Controls; Do Not Send; hata ayıklama olayları.
Özgün eklentinin her WPMS_* sabiti ortamdan okunur (WPMS_ON=true ile).
Dışarıda bırakılanlar Tek tıkla Gmail/Microsoft kurulumu (WPForms aktarıcısı ve lisans gerektirir), XLSX dışa aktarma, ek dosya içeriğini saklama, push ve WhatsApp uyarıları, kullanım takibi, başka SMTP eklentilerinden içe aktarma, multisite ve WP-CLI.
Wordfence Login Security, Two Factor, WPS Hide Login ve Solid Security'nin oturum açma, kullanıcı ve sıkılaştırma bölümleri düzeyinde bir giriş güvenliği eklentisi. İç adı adminsecgo, anahtarı native_adminsecgo. Devre dışı bırakmak kullanıcıların doğrulama yöntemlerini, ayarları ve günlüğü korur, /wp-login adresini geri getirir.
İkinci doğrulama adımları
MFA: e-postayla gelen 6 haneli kodlar (10 dakika geçerli, tek kullanımlık, 60 sn yeniden gönderme beklemesi, 5 deneme). Çalışan e-posta gerekir (Pursae SMTP veya WPGO_SMTP_HOST).
2FA: tekrar oynatma korumalı doğrulayıcı uygulama (TOTP, RFC 6238), QR kodu sunucuda saf Go ile üretilir; önce MFA açık olmalıdır.
Bir kez gösterilen 10 yedek kod; "bu cihazı hatırla" (varsayılan 30 gün); TOTP gizli anahtarları AES-256-GCM ile mühürlü, kodlar yalnızca HMAC özeti olarak saklanır.
Rol başına zorunluluk (MFA veya 2FA), geçiş süresiyle (varsayılan 7 gün); yönetici sıfırlaması ve wpgo adminsec reset-user.
Giriş koruması
Özel giriş adresi; ziyaretçilere /wp-login ve /wp-admin 404 döner (ya da yönlenir); acil çıkış WPGO_ADMINSEC_DISABLE_HIDE_LOGIN=1.
IP başına kilitleme (varsayılan 15 dakikada 5 hata → 20 dakika) ve kullanıcı adı başına kilitleme, kademeli kilitleme (4 kilitten sonra varsayılan 24 saat), IP/CIDR izin ve engel listeleri.
Genel hata mesajları, kullanıcı numaralandırmayı engelleme, giriş formlarında isteğe bağlı Turnstile veya reCAPTCHA v3, parola sıfırlama e-postası sınırları.
Güç puanlı rol bazlı parola politikası, en yaygın 10.000 parolanın reddi, isteğe bağlı Have I Been Pwned denetimi (k-anonimlik), zorunlu parola değişikliği.
Oturum başına çıkışlı etkin oturumlar listesi, boşta kalma zaman aşımı.
Sıkılaştırma ve denetim
Güvenlik başlıkları (X-Frame-Options, Referrer-Policy, Permissions-Policy, X-Content-Type-Options, HSTS), kapatılmış dosya düzenleyiciler, gizli sürüm, isteğe bağlı yalnızca giriş yapmışlara REST, e-posta uyarıları.
Dosya bütünlüğü taraması (ikili dosyanın SHA-256'sı, çekirdek web dosyaları, paketle gelen tema düzenlemeleri, temalar ve yüklemelerdeki sunucu tarafı betikler).
Filtreli, CSV dışa aktarımlı ve saklama süreli (varsayılan 90 gün) etkinlik günlüğü; 0–100 % güvenlik puanlı pano.
Güvenlik duvarı IP başına hız sınırı (varsayılan dakikada 900 istek) ve URL ile User-Agent üzerindeki temel WAF kuralları çekirdeğin parçasıdır ve bu eklenti olmadan da varsayılan olarak açıktır; Settings › Firewall ile ayarlanır, WPGO_FIREWALL=off ile kapatılır.
Dahil olmayanlar Kötü amaçlı yazılım imza tarayıcısı, passkey (WebAuthn), parola süresi dolması ve XML-RPC (Pursae'de XML-RPC uç noktası yok).
Complianz, CookieYes ve Cookie Notice & Compliance düzeyinde çerez onayı ve çerez yönetimi; GDPR / ePrivacy, KVKK, CCPA/CPRA ve Google Consent Mode v2 için tasarlandı. İç adı gooike, anahtarı native_gooike.
Banner ve tercihler
Eşit belirginlikte Tümünü reddet ve Tümünü kabul et düğmeleri ile Özelleştir içeren ilk katman; kategori başına anahtar, bildirilen çerezler, ziyaretçinin onay kimliği ve tarihini gösteren tercihler penceresi.
Necessary, Preferences, Statistics, Marketing kategorileri ve özel kategoriler; onayın geri çekilmesi kategorinin çerezlerini siler; politika sürümü değişince veya süre dolunca yeniden sorar (varsayılan 12 ay, 1–24).
Canlı önizlemeli ve özel CSS destekli 14 banner teması (çubuk, üst çubuk, kutular, modal, hap, cam, koyu, marka rengi, kart, bildirim, onay duvarı, bölünmüş panel, yan panel).
8 dil için hazır setleri olan 26 düzenlenebilir ziyaretçi metni; Pursae Multi Language ile otomatik dil; odak tuzağı ve azaltılmış hareket desteğiyle klavyeyle erişilebilir.
Engelleme ve Consent Mode
Zorunlu olmayan betikleri onaya kadar etkisiz basan betik yöneticisi (head, body açılışı, footer); yalnızca kimlikle eklenen bilinen servisler: GA4, Tag Manager, Meta Pixel, Hotjar, Clarity, LinkedIn, TikTok, Google Ads, Pinterest, Microsoft UET, Matomo, Intercom, HubSpot, Stripe.js.
İçerik, tema ve diğer eklentilerdeki bilinen takip betiklerinin otomatik engellenmesi; YouTube, Vimeo, Google Maps, Spotify, SoundCloud, Instagram, X, Facebook, TikTok, Dailymotion ve Twitch gömmeleri "İçeriği yükle" yer tutucusunun arkasında bekler.
Google Consent Mode v2 betiği <head> içinde ilk sırada; kategori başına eşleme; GPC ve DNT sinyallerine uyar.
Servislerin sunucuları Content-Security-Policy'ye otomatik eklenir.
Bildirim, tarayıcı ve günlük
[gooike_cookie_table] ile çerez bildirimi; çerezleri bildirilmiş veya yeni olarak işaretleyen sunucu tarafı tarayıcı (ve haftalık tarama görevi).
Anonimleştirilmiş IP (IPv4 /24, IPv6 /48, ya da özet, ya da hiç), user-agent HMAC'i, filtreler, onay kimliği başına geçmiş, formül güvenli CSV ve saklama süresi (varsayılan 12 ay) içeren onay günlüğü.
GDPR, KVKK (aydınlatma metni bağlantısıyla) ve CCPA (opt-out, "Do Not Sell or Share") modları; CDN ülke başlıklarından isteğe bağlı coğrafi hedefleme; çerez politikası sayfası oluşturucu (KVKK için Türkçe Aydınlatma Metni şablonu).
Her ziyaretçiye aynı HTML gider; sayfalar Pursae Cache ile önbelleğe alınabilir kalır.
IAB TCF v2.2 yok Pursae Cookie TC dizesi yazmaz; bu yüzden AB/AEA/BK ziyaretçilerine AdSense / Ad Manager reklamı sunan siteler için uygun değildir, orada Google sertifikalı bir CMP kullanın. Başsız tarayıcıyla tarama da yoktur (JavaScript çerezleri bilinen servisler listesinden gelir).
PixelYourSite Pro, Pixel Manager for WooCommerce ve GTM4WP sınıfında, sıfırdan yazılmış reklam ve analitik takibi. İç adı pixelgo, anahtarı native_pixelgo, sürüm 0.1.
Platformlar
Platform
Tarayıcı
Sunucu tarafı
Meta Pixel
Evet
Conversions API
Google Analytics 4
Evet
Measurement Protocol, yalnızca Purchase (ve iade)
Google Ads
Dönüşümler, yeniden pazarlama, gelişmiş dönüşümler
Hayır
TikTok
Evet
Events API
Pinterest
Evet
Conversions API
Microsoft Advertising (UET)
Evet
Hayır
Google Tag Manager
Konteyner ve GA4 e-ticaret dataLayer
Hayır
Olaylar
Tüm platformlar için tek olay modeli: sayfa görüntüleme, arama, kaydırma, sayfada kalma süresi, tel/mailto tıklamaları, dış bağlantılar, indirmeler, formlar, yorumlar, kayıtlar, HTML5, YouTube ve Vimeo videoları.
Pursae Commerce mağaza olayları: ViewContent, ViewCategory, AddToCart, RemoveFromCart, ViewCart, InitiateCheckout, AddPaymentInfo, Purchase (sipariş ve tarayıcı başına bir kez).
Sayfa ziyareti, CSS seçici tıklaması, kaydırma, süre veya form gönderimine bağlı özel olaylar; özetlenmiş müşteri verisiyle gelişmiş eşleştirme (isteğe bağlı); UTM ve tıklama kimliği atıf çerezi (90 gün).
Onay ve teslim
Pursae Cookie ve "Require consent" (varsayılan) ile etiketler onaya kadar etkisiz kalır; Pursae Cookie yoksa hiçbir etiket basılmaz.
Tarayıcı ve sunucu olayları tekilleştirme için aynı olay kimliğini paylaşır; Purchase payment_complete anında da gönderilir, böylece site dışı ödemeler de sayılır. 2 sn, 15 sn ve 90 sn sonra yeniden deneme, kabul edilmemiş Purchase'lar için saatlik tarama ve Retry düğmeli teslim günlüğü.
Token'lı bir URL'de ürün katalog akışı (Google Merchant / Meta için RSS 2.0), 500'lük sayfalarla akıtılır, isteğe bağlı varyasyon başına öğe.
Rol hariç tutma, hata ayıklama modu, window.pixelgo.track(), ayar içe/dışa aktarma, platform başına test olayı.
0.1'de yok Google Ads ve Microsoft Advertising sunucu tarafı olayları, Snapchat, Reddit ve X etiketleri, abonelik/rezervasyona özel olaylar, tek sayfalı uygulamalarda sayfa görüntüleme tekilleştirmesi.
Plausible, Jetpack Stats ve MonsterInsights panosu sınıfında, gizlilik dostu site istatistikleri ve gerçek kullanıcı Core Web Vitals ölçümü. Anahtarı native_pursae_analytics, sürüm 0.1.
Gizlilik
Çerez yok, tarayıcı depolaması yok, parmak izi betiği yok; IP adresi saklanmaz. Ziyaretçi; günlük rastgele tuz, IP, user agent ve sunucu adının SHA-256 özetidir; tuz ertesi gün silinir.
Giriş yapmış kullanıcılar, Do Not Track / Global Privacy Control ve hariç tutulan IP aralıkları ayardır. Onay bannerı gerekmez.
Toplama
Her ziyaretçiye aynı giden 2,3 KB'lık betik (gzip ile 1,2 KB), sayfa önbelleğinin arkasında çalışır.
Sayfa görüntülemeleri (yol, UTM source/medium/campaign, referer sunucusu, görünüm genişliği), olaylar (dış bağlantı, indirme, form, 404) ve görüntüleme sonu verileri (görünür süre, LCP, INP, CLS, FCP, TTFB).
Cihaz, tarayıcı, işletim sistemi, kaynak (Google, Bing, ChatGPT, Perplexity gibi bilinen servisler), CDN/proxy başlıklarından ülke. Botlar, ön yüklemeler, yönetim yolları ve bir adresten dakikada 300'ü aşan istekler atılır.
Analytics ekranı
Dönemler: bugün (saatlik), 7 gün, 30 gün, bu ay, 90 gün, 12 ay.
Önceki döneme göre değişimle tekil ziyaretçi, ziyaret, sayfa görüntüleme, ziyaret başına görüntüleme, hemen çıkma oranı, ziyaret süresi; anlık ziyaretçiler; SVG grafik.
En çok görüntülenen sayfalar, giriş sayfaları, kaynaklar, UTM kampanyaları, ülkeler, cihazlar, tarayıcılar, işletim sistemleri, hedefler, dış bağlantılar, indirmeler, 404 sayfaları.
Google eşikleriyle p75 Core Web Vitals ve en yavaş LCP'li sayfalar. Saklama 30–3650 gün (varsayılan 395). JSON API GET /pursae/v1/analytics.
0.1'de yok Çok günlük tekil ziyaretçi, günlük tekillerin toplamıdır (tasarım gereği). Filtre/detaya inme, temadan özel olaylar, gelir hedefleri, CSV dışa aktarma, herkese açık pano, e-posta raporları ve GeoIP veritabanı yok.
Nesne depolama, CDN teslimi ve anında görsel işleme: WP Offload Media, imgix / Cloudflare Images tarzı bir görsel CDN ve CDN Enabler alanı; Pursae Cache ve birden çok CDN için temizleme. İç adı gocdn, anahtarı native_gocdn.
Depolama ve aktarma
Amazon S3, Cloudflare R2, DigitalOcean Spaces, Backblaze B2, MinIO ya da herhangi bir S3 API'si; kendi SigV4 istemcisiyle (AWS SDK yok) ve adım adım bağlantı testiyle.
Çok parçalı yükleme (varsayılan 16 MB'tan itibaren), sunucu tarafı şifreleme (SSE-S3, SSE-KMS, SSE-C), depolama sınıfı, nesne sürümleme; gizli anahtarlar AES-GCM ile mühürlü; WPGO_CDN_SETTINGS ile yapılandırma.
Yeni yüklemeler ve tüm boyutlar arka planda kopyalanır; yerel dosyalar isteğe bağlı silinir; silinen dosyalar yönlendirme, önceden imzalı URL veya proxy ile sunulur; devam ettirilebilir toplu aktarma, geri indirme, kaldırma ve "geçerli kovaya taşı" görevleri.
Devre dışı bırakmak URL'leri asla bozmaz: yalnızca kovada bulunan dosyalar sunulmaya devam eder.
Uzak depolama tarayıcısı ve medya seçicide "Remote storage" sekmesi (kopya veya bağlantı olarak içe aktarma).
Görseller ve dosyalar
Görsel servisi /cdn-img/<path>?w=&h=&fit=&q=&fm=: JPEG, PNG, GIF, WebP ve AVIF (varsayılan kapalı), hareketli GIF'ler, fm=auto ile biçim seçimi, imzalı URL'ler, kötüye kullanım sınırları, disk veya kova üzerinde varyant önbelleği. cgo yok.
Ön yüzdeki tema, eklenti ve çekirdek dosyaları için asset CDN; CDN kaynakları CSP'ye eklenir.
Ön yüz, akışlar, site haritaları ve REST'te URL yeniden yazma; editörler yerel URL'leri görür.
Temizleme ve özel dosyalar
Pursae Cache ile Cloudflare, Amazon CloudFront, BunnyCDN, KeyCDN ve Fastly'den bir ya da birkaçını eşzamanlı temizleme; değişikliklerde otomatik temizleme.
uploads/private/ altındaki özel dosyalar yalnızca süreli imzalı bağlantılarla sunulur; Commerce indirilebilir dosyaları bunları kullanır.
Sınırlar AVIF kaynak görseller kabul edilmez, surrogate-key / etiket temizleme yok, SSE-C nesnelerinin genel veya önceden imzalı URL'si yok, önceden imzalı URL'ler önbelleğe alınan sayfa HTML'ine yazılmaz.
Bütün siteyi tek bir .zip dosyasına yedekler ve aynı ya da başka bir Pursae sitesine geri yükler; All-in-One WP Migration gibi, ama SQL dökümü olmadan: satırlar doğrudan PostgreSQL'den JSON satırları olarak çıkarılır, pg_dump / psql gerekmez. Kısa adı backup-manager, menü yöneticilere açık.
Neler yedeklenir
Seçilebilir bölümler: yazılar ve taksonomi, medya kütüphanesi (yüklemelerle), kullanıcılar ve roller, ayarlar, temalar, eklentiler, sayfa oluşturucu verisi, her yerleşik eklentinin tabloları, diğer eklenti verileri.
Kullanıcılar tümü, seçilen roller veya seçilen kişilerle sınırlanabilir; bağımlı tablolar (ON DELETE CASCADE) kendiliğinden eklenir.
Arşiv: manifest.json, database/<table>.jsonl ve dosyalar; her girdi için SHA-256.
Geri yükleme
Önce isteğe bağlı güvenlik anlık görüntüsü; veritabanı geri yüklemesi tek işlemde çalışır ve herhangi bir hatada geri alınır; dosyalar hazırlanır ve ancak veritabanı başarılı olursa yerine taşınır.
Eski site adresinin (JSON'da kaçışlı hâli dahil) yeni adrese isteğe bağlı yeniden yazılması; daha yeni şemadan gelen arşivler reddedilir.
Zamanlama ve depolama
Otomatik yerel yedekler; 1–100 zamanlanmış arşiv saklanır (varsayılan 7); hatalar Last scheduled backup altında görünür.
Arşivler WPGO_BACKUPS_DIR içinde (varsayılan <data>/backups, herkese açık yüklemelerin dışında), 0600 izniyle; 16 GB'a kadar yüklemeler diske akıtılır; aynı anda tek görev çalışır.
Dikkat Yedek, parola özetlerini ve site gizli anahtarlarını içerir. Kullanıcıları geri yüklemek herkesin oturumunu kapatır; eklentileri geri yüklemek yeniden başlatma gerektirir. Yalnızca Pursae CDN kovasında bulunan medya arşive girmez. Henüz yok: arşiv şifreleme, uzak depolama (S3, FTP, bulut sürücüler), kurulmamış siteye geri yükleme, birleştirerek geri yükleme.
WebFactory'nin Maintenance eklentisinin (v4.32) klonu; tek site kurulumuna uyan Maintenance PRO bölümleri, SeedProd tarzı Coming Soon modu ve zamanlanmış bakım penceresiyle. Anahtarı native_maintenance, ayarlar maintenance_settings içinde. Kapı sayfa önbelleğinden önce çalışır; kapalı bir site asla önbellekteki sayfayı sunmaz.
Modlar ve erişim
Bakım modu (503 + Retry-After) veya Coming Soon modu (200); önbellek kapatma başlıkları her zaman, noindex varsayılan olarak.
Aç/kapa düğmeli yönetim çubuğu göstergesi; zamanlanmış başlangıç, otomatik kapanan geri sayım.
Atlama yolları: giriş yapmış kullanıcılar (rol filtresiyle), tarayıcı botları, IP ve CIDR beyaz listesi, önekli URL kuralları, gizli bağlantı, site parolası (bcrypt, hız sınırlı), sayfadaki giriş formu.
Anonim REST istekleri JSON 503 alır (Coming Soon'da 403); akışlar ve site haritaları varsayılan olarak kapalı; ?maintenance-preview.
Sayfa tasarımı
7 yerleşik tema (Default, Minimal, Card, Split, Neon, Sunrise, Editorial); logo, arka plan görseli/rengi/gradyanı, bulanıklık, kaplama, 7 sistem yazı tipi yığını, özel CSS. Başka sunuculardan hiçbir şey yüklenmez.
Ya da sayfa olarak yayımlanmış bir Pursae Web Builder şablonu.
Modüller: geri sayım, ilerleme çubuğu, abonelik formu (çift onay, onay notu, CSV dışa aktarma, abonelere bildirim), sosyal simgeler, özel HTML.
SEO başlığı, açıklama, favicon, og:image, GA4 (Pursae Cookie açıksa onaya bağlı); metinler Pursae Multi Language ile çevrilir.
Dışarıda bırakılanlar YouTube video arka planları, harita ve videolar (üçüncü taraf çerçeveler), ön yükleyici, reCAPTCHA, e-posta listesi entegrasyonları, sürükle-bırak sıralama (Web Builder şablonu kullanın), Force SSL ve beyaz etiket.
Siteyi bir headless CMS'e dönüştürür: Next.js, Nuxt, Astro veya mobil uygulamalar için Content-Type Builder, Content Manager ve teslim API'si; popüler açık kaynak headless CMS'lerin kurallarını izler (koleksiyon ve tekil türler, bileşenler, dinamik bölgeler, filters[field][$op], populate, documentId). İç adı headlessgo, anahtarı native_headlessgo. Bunun karşılığı olan tek bir WordPress eklentisi yok.
Modelleme ve düzenleme
Alan türleri: metin, zengin metin (bloklar veya Markdown), sayılar, boolean, tarih ve saatler, e-posta, parola (argon2id), numaralandırma, medya, ilişki, JSON, UID, bileşen, dinamik bölge.
Her kardinalitede ilişki; içerik türlerine, WordPress yazı, sayfa ve kullanıcılarına, herhangi bir genel yazı türüne veya taksonomiye; senkron tutulan çift yönlü ilişkiler.
Şema değişiklikleri kayıtlı veriyi taşır (yeniden adlandırma, silme, tür dönüşümü); NDJSON girdi ve JSON şema içe/dışa aktarma.
Taslak ve yayın, Pursae Multi Language ile i18n, toplu işlemler, geri yüklemeli içerik geçmişi, zamanlanmış yayın, düzenleme kilidi ve yayından önce inceleme akışı içeren Content Manager.
Teslim API'si
/wp-json/headlessgo/v1 altında REST: CRUD, yayınlama, zamanlama, medya yükleme, filtreler, tam metin _q, ilişkiler üzerinden sıralama, sayfalama, populate, fields, locale ve status; modelden üretilen openapi.json ve TypeScript türleri.
Mutasyonlar, fragmanlar, yönergeler, introspection ve şartnameye uygun doğrulamayla GraphQL; WebSocket (graphql-transport-ws) ve server-sent events üzerinden abonelikler.
Genel izin matrisi (varsayılan olarak hiçbir şey açık değil), API token'ları (salt okunur, tam, özel; yalnızca SHA-256 saklanır), JWT ile isteğe bağlı giriş yapmış kullanıcılar, CORS izin listesi, hız sınırı, ETag/304 ve CDN önbellek etiketleri.
Kalıcı yeniden deneme kuyruklu imzalı webhook'lar; kısa ömürlü önizleme token'larıyla önizleme URL'leri; ön yüzün render edilmesini durduran headless modu.
Sınırlar Abonelikler yalnızca kendi süreçlerindeki yazmaları görür; bir okuma en fazla 1000 sorgu çalıştırabilir ve 20000 ilişkili girdi yükleyebilir; REST ve GraphQL kilitlenmez ve inceleme yapamaz; giriş yapmış kullanıcılar için yenileme token'ı yok; yönetim metinleri yalnızca Türkçeye çevrili.
bbPress sınıfında, sıfırdan yazılmış tartışma panoları (0.2.5). Anahtarı native_pursae_forum. Her görünüm etkin temanın bir sayfası olarak render edilir; forum demo içeriğiyle gelen dört kütüphane teması var: Campfire, Devboard, Guild Hall ve Study Circle.
Forumlar ve gönderiler
Forumları barındıran kategoriler, sabitlenmiş ve kapatılmış konular, JavaScript'siz gönderim, iki kez temizlenen temel HTML, PostgreSQL tam metin arama, profiller ve üye listesi.
Konu etiketleri, görüntülenme sayıları, sıralama sekmeleri (en yeni, popüler, yanıtsız, çözüldü), beğeniler, kabul edilen cevaplar, çevrimiçi olanlar, benzer konular, taslak ve önizleme, e-postayla takip, gönderi şikâyeti.
[pursae_forum] kısa kodu ve forum_user_menu gibi tema fonksiyonları; herkese açık salt okunur forum/v1 REST.
Üyeler
48 saat geçerli onay bağlantılı e-posta kaydı, Pursae Security kurallarıyla giriş, "Continue with Google" (PKCE'li OAuth 2.0, OpenID Connect).
Profil fotoğrafları (2 MB'a kadar, 512 px'e kırpılır), baş harfli avatarlar, Gravatar yok.
Puanlar, altı varsayılan seviye (Newcomer'dan Legend'a, en fazla 30) ve kurala dayalı ya da elle verilen rozetler (en fazla 100).
Spam önlemleri: bal küpü, imzalı zaman token'ı, captcha, kayıt ve gönderi hız sınırları, sel (flood) aralığı.
Moderasyon ve entegrasyon
Ön yüzde moderatör çubuğu, yönetimde kuyruk, ilk gönderi moderasyonu, engelleme, düzenleme penceresi (varsayılan 30 dakika).
Yönetim sekmeleri: Overview, Forums, Moderation, Members, Badges & Levels, Settings, Google sign-in.
Pursae Multi Language ile dil önekleri ve hreflang; forum etiketli, önbelleğe alınabilir ziyaretçi sayfaları.
0.2.5'te yok Dile göre forumlar, misafir gönderisi, özel forumlar, iç içe yanıtlar, konu birleştirme/bölme, haftalık özet e-postası, forum RSS ve site haritası girdileri, Web Builder bileşenleri ve bbPress içe aktarıcıları.
İkili dosyanın içinde gelen, bölüm tabanlı görsel sayfa oluşturucu. Ziyaretçiler hiçbir zaman React yüklemez: yayımlanan sayfa, küçük ve isteğe bağlı bir betikle statik bir HTML/CSS anlık görüntüsüdür.
Pursae Web Builder yerleşik bir eklentidir (slug golementor, seçenek native_golementor). Editör, github.com/pursae/Builder'dan derlenen bir React uygulamasıdır. Theme Builder ile sitenin header, footer ve içerik şablonlarını da tasarlar; bunları gömülü Hello Pursae teması gösterir.
Yeni kurulumda kapalıdır. Eklentiler › Pursae Web Builder › Etkinleştir onu açar ve siteyi Hello Pursae'ye geçirir; önceki tema hatırlanır (web_builder_previous_theme) ve bir bildirim Switch back sunar.
Eklenti kapalıyken menü girdisi, "Edit with" bağlantısı, rota, varlık veya ön yüz çıktısı yoktur; builder ile yapılmış sayfalar temanın içinde okunabilir yedek HTML'lerini gösterir.
Web Builder › Settings (manage_options) builder'ın düzenlediği yazı türlerini seçer (varsayılan sayfalar ve yazılar) ve Regenerate edilecek sayfaları listeler.
Editör arayüzü İngilizcedir; Türkçe dahildir (kullanıcının dilinden seçilir).
Bir sayfayı Edit with Pursae Web Builder ile açın (blok editörü araç çubuğu, klasik editör, satır eylemi veya site araç çubuğu). URL /wp-admin/post?post={id}&action=web-builder'dır; edit_post gerekir ve WordPress yazı kilidini alır.
Bölümlerden kurun: navigation, hero, banner, features, media, steps, quote, FAQ, call to action, footer, text, image, form, layout ve custom ya da kütüphanedeki kayıtlı bir bölüm. Masaüstü, tablet ve mobil arasında geçin.
Değişiklikler birkaç saniyede bir kendi taslağınız olarak otomatik kaydedilir; canlı sayfaya dokunulmaz.
Publish sayfayı tarayıcıda işler ve belgeyle anlık görüntüyü gönderir; sunucu ikisini de doğrular ve temizler. Yayımlama yetkisi olmayanlar Pending Review alır. Eşzamanlı bir yayımlama, üzerine yazmak yerine çakışma gösterir.
Her yayımlama aynı zamanda bir çekirdek revizyonudur; builder her birinin belgesini tutar (sayfa başına en yeni 50).
Preview (?preview=true) son yayımlanan anlık görüntüyü gösterir.
Ayrılmış (detached) sayfalar Builder ile yapılmış bir sayfayı başka yerde düzenlemek (blok veya klasik editör, Hızlı Düzenle, REST) onu ayırır: site düzenlenen içeriği temanın içinde gösterir, builder ise yeniden yayımlamayı (dış düzenlemeler atılır) ya da sayfayı diğer editöre bırakmayı önerir.
Site ayarları ve tasarım belirteçleri
Builder açıkken Özelleştirici gizlenir; editör menüsündeki Site settings başlık, slogan, logo, site ikonu, ana sayfa ve Ek CSS'i düzenler (edit_theme_options).
Tasarım belirteçleri: beş renk (primary, secondary, accent, text, background) ve iki font (heading, body), :root üzerinde --wb-color-* / --wb-font-* olarak. var(--wb-color-primary) kullanan bir anlık görüntü, yeniden yayımlamadan değişikliği izler.
Ziyaretçilerin aldığı
Sayfa CSS'i 24 KiB'a kadar satır içidir (üstü önbellekli bir dosya); fontlar yerel @font-face; görseller çekirdek görsel filtrelerinden geçer.
Çalışma zamanı (runtime.<hash>.js, gzip'li 8 KB altı) yalnızca sayfa menü, SSS/akordeon, sekme, kapatılabilir çubuk, form, hareket veya gömme kullanıyorsa yüklenir. İçerik JavaScript kapalıyken de okunabilir.
Formlar web-builder/v2/forms/{page}/{section} adresine gönderilir; honeypot, en kısa doldurma süresi, IP başına hız sınırı ve Pursae Contact Form captcha'sı uygulanır; mesajlar yönetici e-postasına gider.
Diğer her yerde (REST content.rendered, Headless, beslemeler, arama, site haritaları, dışa aktarımlar) sayfa, belgeden posts.content içine üretilen yedek HTML'dir.
Açılır pencerelerpopup türünde şablonlardır: sayfa yüklenince, kaydırma derinliğinde, çıkış niyetinde veya tıklamada açılır; her görüntülemede, oturum başına, bir kez veya N günde bir; sayfa başına en fazla beş; durum çerezde değil localStorage / sessionStorage'da (wb-popup:<id>) tutulur.
Henüz yok Yapay zekâ (derlemeden çıkarıldı; siteden hiçbir AI isteği çıkmaz), açılır alt menüler, form entegrasyonları ve ödemeler, global sınıflar ve kitler, kurulum sihirbazı.
Web Builder › Theme Builder (edit_theme_options) sitenin şablonlarını listeler. Şablon, dinamik widget'lar ve yazı döngüleriyle tasarlanan, istek anında gerçek içerikle doldurulan bir builder belgesidir. Şablonlar yalnızca Hello Pursae etkinken görünür; şablon yayımlandığında etkindir, taslak veya devre dışı şablon hiç gösterilmez.
Tür
Doldurduğu yer
Varsayılan koşul
Header
her sayfanın üstü
Entire Site
Footer
her sayfanın altı
Entire Site
Single Post
yazıların ana içeriği
All posts
Single Page
sayfaların ana içeriği
All pages
Single
tek bir özel yazı türünün girdileri
O türün tüm girdileri
Front Page
ön sayfa
Front Page
Archive
blog, kategori, etiket, yazar, tarih ve yazı türü arşivleri
All Archives
Search Results
arama sonuçları
Search Results
404 Page
"bulunamadı" sayfası
404 Page
Single Product / Product Archive
Pursae Commerce ürün ve mağaza görünümleri (yalnızca Commerce açıkken)
—
Dinamik widget'lar
Grup
Widget'lar
Site
Site logo, Site title, Tagline, Menu, Search form, Copyright
Post
Post title, Post content, Post excerpt, Featured image, Post info, Post terms, Post date, Post author, Author box, Post navigation, Comments ve Posts (bir döngü)
Archive
Archive title, Archive description, Pagination
Search
Search query
Editör widget'ları Preview as ile seçilen gerçek içerikle çizer; asla örnek içerik uydurmaz. Posts döngüsü tasarlanan tek bir kartı şu kaynaklardan biriyle tekrarlar: Posts of the page (sayfalamalı tek kaynak), Custom query (1–24 yazı, sıralama, terimler, yazar, atlama, mevcut yazıyı hariç tutma) veya Related posts.
Görüntüleme koşulları
Her kural Include veya Exclude artı bir yerdir: Entire Site, Singular (…), Archives (…), 404 Page. Eşleşen herhangi bir Exclude şablonu çıkarır; aksi halde en özgül kural kazanır:
belirli bir öğe, terim veya yazar;
Front Page ve 404 Page;
bir terimde (In), Child of, By author;
bir yazı türü; Posts Page, Date Archives, Search Results, Author Archives, bir yazı türü arşivi, bir taksonominin tüm terimleri;
All Singular, All Archives;
Entire Site.
Eşitlikte daha yüksek Priority (−100 ile 100 arası, varsayılan 0), ardından daha yakın zamanda değiştirilen şablon kazanır. Arama sayfasında Search Results şablonu aynı kurala sahip Archive şablonunu yener.
Sayfa nasıl birleştirilir
Hello Pursae etkinken her sayfa Header + Main + Footer'dır. Main; sayfanın kendi builder tasarımı, yoksa eşleşen ana şablon, yoksa temanın varsayılanıdır. Builder ile yapılmış bir sayfa Site templates veya This page only (canvas) seçer. ?wb_template_preview=<id> önizleme için bir şablonu zorlar; yayımlama, devre dışı bırakma, çöpe atma veya koşul değiştirme Pursae Cache'i temizler.
Builder'ın tema kütüphanesi pazar yerindeki temaları hazır, tam site tasarımları olarak sunar. Web Builder › Theme Library'den veya editörde Studio › Items › Components › Browse theme library'den açılır. Tek bir içe aktarma; koşullarıyla Theme Builder şablonlarını (Header, Footer, Front Page, Single Post, Single Page, Archive, Search Results, 404 Page), temanın demo sayfalarını ve görsellerini ve primary ile footer konumlarına atanmış menülerini oluşturur.
Seçim
Sonuç
Replace them
temanın şablonları yayına girer; sizinkiler devre dışı bırakılır (taslak, asla silinmez)
Keep both
temanın şablonları taslak olarak kaydedilir; sitede hiçbir şey değişmez (menü yok)
Yazılarınıza, sayfalarınıza, kategorilerinize, kullanıcılarınıza ve ayarlarınıza asla dokunulmaz; yeniden içe aktarma idempotenttir (yazı meta'sı _wb_theme, _wb_theme_key). edit_theme_options, ayrıca edit_pages ve publish_pages gerekir.
İçe aktarma akışı
POST /web-builder/v2/themes/{slug}/import{mode: "replace" | "keep", pages: bool}: görseller içe aktarılır, şablonlar ve sayfalar taslak olarak oluşturulur.
Editör her belgeyi çizer ve normal publish rotasıyla yayımlar.
POST /web-builder/v2/themes/{slug}/finish: replace modunda aynı türlerdeki diğer şablonlar taslağa alınır, menüler atanır, önbellek temizlenir.
Sözleşme, React editörünün Go sunucusuyla nasıl konuştuğunun tek doğruluk kaynağıdır. İki yarısı, internal/webbuilder/contract.go ve builder/host/contract.ts, alan alan eşleşmeli ve tek bir commit'te değişmelidir.
Sürümler ve el sıkışma
Sabit
Değer
Anlamı
APIVersion
2
REST ve açılış şeması (2 = Theme Builder)
RendererVersion
1
statik işaretleme + çalışma zamanı öznitelikleri
APIHeader
X-WB-Api
editör her web-builder/v2 isteğinde gönderir
Uyumsuz yük değişiklikleri APIVersion'ı artırır; yalnızca uyumsuz statik işaretleme değişiklikleri RendererVersion'ı artırır (eklemeli data-wb-* öznitelikleri artırmaz).
Eksik veya farklı X-WB-Api409wb_api_mismatch döndürür; editör otomatik kaydı durdurur ve "Reload" sunar.
Açılış yapılandırması window.__WEB_BUILDER__ asla bir AI anahtarı veya gizli değer içermez.
Belge modeli ve yayımlama
Sayfa belgesi (doc, JSON) doğruluk kaynağıdır; tarayıcıdan gelen anlık görüntü ve CSS güvenilmezdir.
Yayımlama tek bir transaction'da çalışır: API kontrolü, edit_post, kilit (409 wb_locked), revizyon kontrolü (baseRev, 409 wb_rev_conflict), belge doğrulama (422 wb_invalid_doc), unfiltered_html yoksa html bölümleri ve özel CSS'in çıkarılması, temizleme, yedek HTML'in posts.content'e yazılması, docs satırının upsert'i, önbellek temizliği. Yanıt neyin stripped edildiğini listeler.
Kayma (drift): dışarıdan bir kayıt sonrası sha256(posts.content) != content_hash ise sayfa detached olur; bunu yalnızca reattach: true ile bir yayımlama temizler.
Üst düzey bölüm / bölüm başına öğe / Item.sub derinliği
≤ 200 / ≤ 500 / ≤ 4
Id'ler
^[A-Za-z0-9_-]{1,64}$, belge içinde benzersiz
Bölüm kind
nav hero banner features media steps quote faq cta footer text image form layout html custom ve loop
Dizgeler
≤ 64 KiB; html bölüm içeriği ≤ 256 KiB
href
http, https, mailto, tel, #…, göreli
Ayrıcalıklı (yalnızca unfiltered_html)
html bölümleri, style.css
Anlık görüntü
tam olarak bir kök div.wb-page[data-wb-root]; ≤ 2 MiB; on* ve data-wb-* dışındaki data öznitelikleri atılır; script, style, object, embed… atılır
iframe'ler
YouTube (nocookie), Vimeo gömmeleri veya unfiltered_html yazarlarından sandbox="allow-scripts" + srcdoc
CSS
@import, expression(, javascript: yok; @font-face yalnızca /wp-content/uploads/web-builder/fonts/'dan; toplam ≤ 1 MiB; </style → 422
Çalışma zamanı ve Theme Builder modeli
Çalışma zamanı özellikleri: menu acc tabs dismiss form motion embed, hepsi data-wb-* öznitelikleriyle; her gizleme kuralı .wb-js'e kapsamlanır ve prefers-reduced-motion dikkate alınır.
Koşul dilbilgisi <mode>/<scope> (ör. include/general, include/singular/post, exclude/archive/category/12); puanlar 10 (general) ile 50 (belirli öğe, terim veya yazar) arası; şablon başına en fazla 50 kural, her biri 200 bayt.
Anlık görüntü yer tutucuları (data-wb-slot, data-wb-if, data-wb-loop, data-wb-menu-loc…) her istekte sunucu tarafından doldurulur; yazılar, menüler veya logo değişince şablonları yeniden yayımlamak gerekmez.
Bir Pursae teması; Go html/template dosyaları, varlıklar ve bir manifestten oluşur. Tema paketleri hiç kod içermez: tüm veriyi çekirdek hazırlar, tema yalnızca nasıl basılacağına karar verir.
Bir tema; şablonlar ve varlıklardan, sunduğu widget alanları, menü konumları ve Özelleştirici seçeneklerinin tanımından ve yüklediği stil ve betiklerden oluşur. İki türü vardır:
ikili dosyaya derlenmiş (web/themes/<slug>/ + bir theme_<slug>.go)
<data>/themes/<slug>/ (WPGO_THEMES_DIR)
functions.php karşılığı
Go kodu: açılışta kaydedilen, wp_head, body sınıfları ve şablon verisi için kancaları olan bir *Theme
theme.json: bir Go temasının kodla kaydettiği her şey, veri olarak
Kurulum
Pursae ile birlikte gelir
Görünüm › Temalar › Yeni Tema Ekle › Yükle veya pazar yeri
Kod
evet (Go, çekirdekle birlikte incelenir)
yok: şablonlar, CSS, JS, görseller. İmzalanmaz; SHA-256 ile doğrulanır
Bir paketin ifade edebildiği her şeyi gömülü Classic teması da kullanır; bu yüzden web/themes/classic/templates referans uygulamadır.
Temanın kontrol ettikleri
her sayfa türünün işaretlemesi: index, single, page, archive, search, 404 ve header, footer, sidebar, comments parçaları;
stil sayfaları ve betikler, editör stilleri ve önceden yüklenen fontlar;
widget alanları ve menü konumları;
canlı önizlemeli Özelleştirici bölümleri ve ayarları;
blok editörünün tema hakkında bildikleri: renk paleti, geniş hizalama, destekler;
Pursae Forum'un görünümü: forum sayfa sarmalayıcısı, forum renk belirteçleri ve tüm forum görünümleri.
Çekirdeğin her tema için yaptıkları
Çekirdek tüm sayfa modelini kurar (belge başlığı, wp_head() çıktısı, body sınıfları, döngü, sayfalama, yorumlar, menüler, widget alanları, yönetim çubuğu); tema yalnızca nasıl basılacağına karar verir. Tema hiçbir zaman veritabanını sorgulamaz veya girdi temizlemez; paketlerin kodsuz ve kurulumunun güvenli olmasının nedeni budur.
Web Builder sayfaları Pursae Web Builder ile yayımlanan bir sayfa, temanın header, footer ve stil sayfası olmadan bir tuval (canvas) belgesi olarak sunulur. Theme Builder şablonları temanın çıktısını yalnızca gömülü Hello Pursae temasında değiştirir; bir tema paketi Theme Builder parçalarını alamaz.
Kancaları silmeyin{{.Head}}, wp_head() çıktısını (beslemeler, blok stilleri, sizin stilleriniz, Özelleştirici CSS'i, eklenti varlıkları), {{.Footer}} ise wp_footer() çıktısını basar. Bunlar olmadan betikler, yönetim çubuğu ve eklentiler çalışmaz.
3. Varlıklar
style.css, betikler, fontlar ve görseller assets/ altına konur ve theme.json'dan (styles, scripts, preload_fonts, editor_styles) referans verilir. screenshot.png (1200×900) Temalar ekranındaki küçük resimdir.
4. Zip'leyin
cd starter
zip -r ../starter.zip theme.json templates assets readme.md
Dosyalar zip'in kökünde durur (tek bir üst düzey klasör de kabul edilir ve atılır). Sınırlar: paket başına 32 MiB, dosya başına 4 MiB ve yalnızca şu uzantılar: .json .html .css .js .map .svg .png .jpg .jpeg .gif .webp .avif .ico .woff .woff2 .ttf .otf .md .txt.
5. Yükleyin ve etkinleştirin
Görünüm › Temalar › Yeni Tema Ekle › Tema Yükle, starter.zip'i seçin. Paket doğrulanır (theme.json, şablon sözdizimi, dosya türleri), <data>/themes/starter/ içine açılır ve Temalar ekranında listelenir. Canlı Önizleme etkinleştirmeden gösterir; Etkinleştir siteyi değiştirir. Slug'ı gömülü bir temayla aynı olan paket reddedilir.
6. Yineleyin
Yeniden yükleyin ya da Görünüm › Tema Dosya Düzenleyicisi ile yerinde düzenleyin (katman dizini aynı <data>/themes/starter/'dır). Geliştirme sırasında WPGO_THEMES_DIR'i çalışma kopyanıza yönlendirin: sunucu açılışta her <dir>/<slug>/theme.json'u yükler.
Hello Pursae (hello-pursae), Pursae Web Builder için yapılmış gömülü bir Go temasıdır: header, footer, single, archive, search ve 404 görünümleri builder'ın Theme Builder'ında tasarlanan boş bir tuval. Şablon olmadan da kullanılabilir sade bir temadır: minimal bir header, içerik ve bir footer.
hello-pursae; en az bir Theme Builder parçası işlendiğinde ek olarak wb-site
Ne zaman etkin olur
Pursae Web Builder'ı etkinleştirmek siteyi Hello Pursae'ye geçirir ve önceki temayı web_builder_previous_theme içinde saklar; eklentiyi devre dışı bırakmak, site hâlâ Hello Pursae'deyse geri döner (önceki tema yoksa varsayılan temaya). Kullanıcı arada başka bir tema seçtiyse hiçbir şey değişmez. Hello Pursae'den önce builder'ı açmış siteler sessiz geçiş yerine tek seferlik bir "Switch to Hello Pursae" bildirimi alır.
Şablonlar temanın çıktısının yerini nasıl alır
Theme Builder şablonları yalnızca Hello Pursae etkin (veya önizlenen) temayken kullanılır. Kontrol slug üzerindendir; bir tema paketi veya başka bir gömülü tema şablon parçası almaz. Çekirdek her istek için şablonları görüntüleme koşullarına göre seçer ve hazır işaretlemeyi temaya .Data.wb içinde verir:
Alan
Ne
Yoksa
.Data.wb.Header
doldurulmuş header şablonu
Hello Pursae'nin header'ı: özel logo veya site başlığı, slogan, primary menü
.Data.wb.Main
sayfanın kendi builder tasarımı, yoksa eşleşen Single Post, Single Page, Single, Front Page, Archive, Search Results veya 404 şablonu, doldurulmuş
temanın varsayılan görünümü
.Data.wb.HasMain
Main kendi <main> yer işaretini taşıyor
—
.Data.wb.Canvas
tuvale ayarlı builder sayfası: header ve footer basılmaz
—
.Data.wb.Footer
doldurulmuş footer şablonu
footer menüsü, telif satırı ve gizlilik bağlantısı
{{define "site-header"}}{{$wb := .Data.wb}}{{if and $wb $wb.Canvas}}{{else if and $wb $wb.Header}}<div class="wb-part wb-part-header">{{$wb.Header}}</div>{{else}}<header id="site-header" class="site-header">…</header>{{end}}{{end}}
Sayfada her zaman tam olarak bir <main> ve atlama bağlantısının #content hedefi bulunur. Çekirdek tüm parçaların fontlarını birleştirir, her parçanın CSS'ini <style id="wb-css-<post id>"> olarak basar, builder'ın temel CSS'ini ve çalışma zamanını bir kez ekler ve yönetim çubuğuna Edit Header / Edit Template / Edit Footer ekler.
Düzenleme Hello Pursae'nin şablonları Tema Dosya Düzenleyicisi'nde değiştirilebilir; .Data.wb dallarını koruyun, yoksa Theme Builder parçaları görünmez. Builder ile kurulmuş bir sitenin görünümünü değiştirmek için temayı değil, builder'daki şablonları düzenleyin.
Şablonlar Go html/template dosyalarıdır. Çıktı bağlama göre otomatik kaçışlanır; çekirdeğin zaten HTML olarak işlediği değerler (.Content, .Head, menüler, widget alanları) template.HTML'dir ve olduğu gibi basılır. Yalnızca index.html zorunludur.
İstek
Sırayla denenen şablonlar
statik sayfa gösteren ön sayfa
front-page.html, sayfanın kendi şablonu, page.html, singular.html, index.html
son yazıları gösteren ön sayfa veya yazılar sayfası
Paket belirtimi Tema paketi belirtimi ayrıca yazılar için single-<format> ve singular, terim arşivleri için category-<slug> ve tag-<slug> adaylarını listeler. _wp_page_template değeri ayarlı bir sayfa, ön sayfada da önce o şablonu dener.
Parçalar (header.html, footer.html, sidebar.html, comments.html, content*.html) {{template "header" .}} ile dahil edilir. Tüm dosyalar tek bir şablon kümesine ayrıştırılır; herhangi bir dosyadaki {{define "name"}} diğerlerinden çağrılabilir.
Arama formları Pursae Multi Language dili sorguyla birlikte taşınsın diye formu .HomeURL ile değil, <form role="search" method="get" action="{{.SearchAction}}">{{.SearchHidden}}… biçiminde yazın.
Fonksiyonlar
Fonksiyon
Ne yapar
safe, safeURL, safeAttr
bir dizgeyi güvenilir HTML / URL / öznitelik olarak işaretler
kses s
kullanıcının yazdığı HTML için wp_kses_post()
date t format
zamanı sitenin saat diliminde WordPress biçimiyle biçimler; "" sitenin tarih biçimini kullanır
çevrilebilir dizgeler (önce görünüm: __ . "Skip to content"); Pursae Multi Language açıkken Diller › Çeviriler altında listelenir
Paket temaları ayrıca {{nav_menu . "primary"}}, {{has_nav_menu . "primary"}}, {{dynamic_sidebar . "sidebar-1"}}, {{is_active_sidebar . "sidebar-1"}} ve {{theme_mod . "accent"}} fonksiyonlarını, bunlara ek olarak .Data.Settings (tiplenmiş tüm Özelleştirici ayarları) ve .Data.Nav (konuma göre işlenmiş menüler) alanlarını alır.
Odak noktası olan görsellere çekirdek object-position ekler; böylece object-fit: cover kırpmaları şablon kodu olmadan noktayı görünür tutar.
theme.json, bir Go temasının kodla kaydedeceği her şeyi tanımlar. Bilinmeyen alanlar reddedilir.
Metadata
Alan
Zorunlu
Kurallar
slug
evet
^[a-z0-9]+(-[a-z0-9]+)*$, 2–64 karakter; dizin adı ve tanımlayıcı (tema modları, widget'lar ve menüler slug başına saklanır). Gömülü slug'lar ayrılmıştır
name
evet
Temalar ekranında gösterilir
version
evet
semver
description, author, author_url, theme_url
hayır
Temalar ekranı ve pazar yeri; URL'ler http(s)
tags
hayır
pazar yeri filtreleri (blog, dark, one-column, …)
requires_core
hayır
en düşük Pursae sürümü (çalışan sürümden yeni olamaz)
screenshot
hayır
assets/ altında bir dosya, genelde screenshot.png
Yapı
Alan
Kaydettiği
widget_areas[]
register_sidebar(): id, name, description; isteğe bağlı before_widget, after_widget, before_title, after_title. {{index .Areas "sidebar-1"}} ile basılır
Sayfa Nitelikleri "Template" seçimi için {"<name>": "<Label>"}. Ad bir handle'dır; index, page, front-page veya singular olamaz; templates/<name>.html bulunmalıdır; etiket tek satır, en fazla 80 karakter, işaretlemesiz
Varlıklar
Alan
Anlamı
styles[]
wp_enqueue_style(): handle, src, deps, media
scripts[]
wp_enqueue_script(): handle, src, deps, in_footer
editor_styles[]
add_editor_style(): blok editörüne ve TinyMCE'ye yüklenir
preload_fonts[]
assets/ altındaki .woff2 dosyaları; her sayfada wp_head içinde önceden yüklenir
block_styles
true: çekirdek blok stilleri blok başına, satır içi; blok adları dizisi o blokları da dışarıda bırakır; varsayılan false (tüm blok kütüphanesi)
Editör ve Özelleştirici
Alan
Anlamı
palette[]
editor-color-palette: name, slug, color; ayrıca --wp--preset--color--<slug> olarak basılır
etiket id'si: <handle>-css, <handle>-js; desen ^[a-z0-9]+([_-][a-z0-9]+)*$, liste içinde benzersiz
src
paket içi bir yol (/wp-content/themes/<slug>/<path> adresinden sunulur) veya mutlak URL
deps
önce yüklenen handle'lar; bağımlılık döngüsü hatadır
media
all (varsayılan), print, screen and (min-width: …)
in_footer
betiği </body> öncesine basar
CSP Uzak URL'lere sitenin Content Security Policy'si izin vermelidir (style-src 'self'; uzak stil sayfalarına varsayılan olarak, uzak betiklere hiçbir zaman izin verilmez). Fontları ve betikleri pakette gönderin.
Çekirdek handle'ları
Handle
Ne
wp-block-library
blok kütüphanesi stil sayfası; block_styles açık değilse her sayfada
dashicons
ikon fontu (yönetim çubuğuyla yüklenir)
jquery
/wp-includes/js/jquery/ altından jQuery
comment-reply
iç içe yanıtlar; çekirdek bunu iç içe yorumlu tekil sayfalarda kendisi ekler
wp_head'in sırayla bastıkları
temanın head_top'u (yalnızca gömülü temalar),
robots, besleme bağlantıları, giriş yapmış kullanıcılar için yönetim çubuğu stilleri,
blok kütüphanesi stil sayfası ve satır içi tema/global stiller (block_styles ile: yalnızca kullanılan blokların stilleri),
sizin preload_fonts[], styles[] ve head scripts[]'leriniz, ardından Özelleştirici css_var özellikleri,
rel="https://api.w.org/", generator meta, canonical ve shortlink,
özel arka plan, site ikonu, Ek CSS,
eklenti stil sayfaları ve head betikleri.
wp_footer; comment-reply'ı, yönetim çubuğu betiğini, footer betiklerinizi ve eklenti footer betiklerini basar.
Fontlar, blok başına stiller ve önbellek
Fontlar assets/fonts/ altına gider; assets/fonts/inter.woff2 dosyası /wp-content/themes/<slug>/fonts/inter.woff2 adresinden sunulur; assets/style.css içindeki url(fonts/inter.woff2) da buna çözülür. Siz eklemedikçe hiçbir harici font servisine bağlanılmaz.
"block_styles": true, 140 KB'lık render-blocking block-library/style.min.css'i kaldırır ve yalnızca sayfadaki blokların stillerini satır içine alır; bu durumda wp-block-library'yi deps'ten de çıkarın.
styles[] ve scripts[], Cache-Control: public, max-age=31536000, immutable ile sunulur: değişiklik gönderdiğinizde version'ı artırın. Tema Dosya Düzenleyicisi'nde kaydedilen dosyalar ve sürümsüz URL'ler no-cache'tir.
Pursae Cache'te "Defer JavaScript" açık ve handle listesi boşsa sizin scripts[]'leriniz de ertelenir (yalnızca body'deki betikler; bu yüzden in_footer tercih edin).
<title>'ı çekirdek basar; her zaman açık, uyumluluk için tutulur
post-thumbnails
Öne Çıkan Görsel paneli; .Thumbnail doldurulur
custom-logo
Site Kimliği'nde logo kontrolü; .CustomLogo işler (ayarlanmadıkça açık)
html5
listelenen parçalar için HTML5 işaretlemesi
responsive-embeds
wp-embed-responsive body sınıfı ve en-boy oranı CSS'i
align-wide
Geniş ve Tam hizalamalar; .alignwide ve .alignfull'u stillendirin
wp-block-styles
çekirdeğin görüş sahibi blok stilleri (theme.min.css)
custom-spacing, custom-line-height
padding/margin ve satır yüksekliği kontrolleri
Palet renkleri her renk kontrolünde görünür; bloklar has-<slug>-color / has-<slug>-background-color sınıflarını alır ve çekirdek --wp--preset--color--<slug> özelliklerini basar; CSS'inizde var(--wp--preset--color--accent) kullanın. Blok işaretlemesini çekirdek işler: statik bloklar kaydedildiği gibi, dinamik bloklar (son yazılar, arama, arşivler, kategoriler, senkronize desenler, kısa kod) Go'da.
Paketlerde yok Blok desenleri ve site editörü blok şablonları bu sürümde tema paketlerinin parçası değildir: /wp/v2/templates boş liste döndürür. Tema yapmanın yolu klasik şablonlardır.
Görünüm › Özelleştir; Site Kimliği, Renkler, Menüler, Widget'lar, Ana Sayfa Ayarları, Ek CSS ve temanın tanımladığı bölümleri sunar. Değerler tema başına saklanan tema modlarıdır; temayı değiştirip geri dönünce korunurlar.
tema modu adı (tema genelinde benzersiz; custom_logo ve custom_css çekirdeğindir)
label, description
kontrol
type
color (#rrggbb), text, textarea, number, checkbox, select / radio (choices ile), image (ek id'si)
default
kullanıcı kaydedene kadar kullanılır; türle uyumlu olmalı
transport
refresh (varsayılan) veya canlı önizleme için postMessage (image için değil)
css_var
değeri :root üzerinde özel özellik olarak basar (--accent: #2271b1)
body_class
değer doğruysa bu sınıfı <body>'ye ekler; {value} ile değer yerleştirilir (layout-grid)
<footer class="site-footer">{{with index .ThemeMods "footer_text"}}<p>{{.}}</p>{{end}}</footer>
title_tagline adlı bölümdeki ayarlar Site Kimliği altında görünür.
postMessage ile css_var ve body_class değişikliklerini çekirdeğin önizleme betiği kendisi uygular; diğerleri için wp.customize('setting_id', …) dinleyen bir betik ekleyin (bkz. Classic'in assets/js/customize-preview.js dosyası).
Değişiklikler bir changeset üzerinden önizlenir ve Yayımla ile birlikte kaydedilir.
Görünüm › Tema Dosya Düzenleyicisi, kurulu her temanın şablonlarını, stil sayfalarını ve betiklerini tarayıcıda açar; gömülü temalar dahil (Go yapıştırıcı kodları derlenmiştir, düzenlenemez).
Dosyalar bir katman (overlay) üzerinden okunur: önce <data>/themes/<slug>/<path> (WPGO_THEMES_DIR, Docker'da themes birimi), sonra gömülü kopya veya kurulu paket.
Kaydetmek katmana yazar, şablon kümesini yeniden ayrıştırır ve bir sayfayı deneme olarak işler; şablon veya işleme hatası otomatik geri alınır ve düzenleyicide gösterilir.
Restore original katman dosyasını siler (gömülü temalar). Bir pakette katman ile paket dizini aynıdır, yani düzenlemeler kurulu dosyaların düzenlemesidir; düzenlenen varlıklar .edited-files'a yazılır ve paket güncellenene kadar no-cache ile sunulur.
WPGO_DISALLOW_FILE_EDIT=1 düzenleyiciyi salt okunur yapar. edit_themes yetkisi gerekir.
Düzenlenemeyenler Go ile yazılmış tema yapıştırıcısı, theme.json anlamı (bunlar için paketi yeniden yükleyin) ve eklentiler (eklenti kodu derlenmiş WebAssembly'dir).
Kurulu temalar WPGO_THEMES_DIR içinde (varsayılan <data>/themes), slug başına bir alt dizinde yaşar. Sunucu her dizini açılışta ve bir yüklemeden sonra yükler; doğrulanamayan paket loglanır ve atlanır. Dizin adı slug'a eşit olmalıdır.
assets/, /wp-content/themes/<slug>/ adresinden sunulur; theme.json'daki her yol assets/ altını göstermelidir.
Sınırlar: paket başına 32 MiB, dosya başına 4 MiB, açılmış hali 64 MiB, 2000 dosya; yalnızca izinli uzantılar. Bir şey değiştirilmeden önce şablonlar ayrıştırılabilmelidir.
Yükleme install_themes ister; kurulu bir slug'a sahip paket onu yalnızca daha yüksek sürümle değiştirir (tema modları ve widget'lar korunur). Silme delete_themes ister; etkin tema silinemez.
Temalar imzalanmaz; Hub ve yükleyici zip'in SHA-256'sını doğrular.
Bir mağaza teması "supports": {"woocommerce": true} bildirir ve Pursae Commerce › Store Themes altında listelenir.
Demo içerik
Bir tema demo/demo.json ve demo/images/ altında görseller (.jpg, .jpeg, .png, .webp; her biri ≤ 1 MiB, ≤ 24 görsel) gönderebilir. Kurulumda doğrulanır. İçe aktarma etkin temanın kartında, etkinleştirmeden sonra ve kütüphanede Install & Import Demo olarak sunulur; import yetkisi gerekir.
İçe aktarılan öğeler _wpgo_demo = "<tema slug>" taşır; ikinci içe aktarma bunları atlar, Remove Demo Content tam olarak bunları siler ve değiştirdiklerini geri yükler.
İçerikteki belirteçler: {{media:hero}}, {{media_id:hero}}, {{page:about}}, {{post:…}}, {{category:…}}, {{tag:…}}; her biri demodaki bir öğeyi adlandırmalıdır.
Sınırlar: 24 görsel, 50 sayfa, 100 yazı, 10 menü, yazı başına 20 yorum; menüler 3 seviyeye kadar iç içe; içe aktarmanın iki dakikalık sınırı vardır.
Demo içerikli Canlı Önizleme
/wp-admin/theme-preview?theme=<slug>, bir temayı demosu içe aktarılmış haliyle bir sandbox içinde gösterir: wpgo_preview_<slug> PostgreSQL şemasında, dosyaları <data>/preview/<slug>/ içinde ikinci bir site. Gerçek siteye dokunulmaz. En fazla 8 sandbox tutulur; yalnızca GET ve HEAD'e izin verilir ve yanıtlar X-Robots-Tag: noindex, nofollow taşır.
Kütüphanenin kaynakları library/themes/<slug>/ altındadır; her biri eksiksiz bir tema paketidir ve Pursae Manager'a yayımlanır (make publish-themes). Site kütüphaneyi Pursae Manager'dan (varsayılan https://hub.pursae.com, GET /api/v1/themes, lisans anahtarı başına 12 saat önbellek) veya WPGO_THEME_LIBRARY_DIR ayarlıysa bir dizinden okur. Görünüm › Tema Ekle, kategori filtreleri ve aramayla Library sekmesinde açılır; Install Tema Yükle ile aynı yükleyiciyi kullanır, kütüphanede daha yüksek sürüm varsa Update sunulur.
Depoda 67 kütüphane teması bulunur. Hepsinde demo içerik vardır. "Mağaza" supports.woocommerce'u, "Forum" Pursae Forum temalarını, "WB" Web Builder parçaları olan temaları işaretler.
Tema
Kategori
Tarz
AppNest (appnest)
startup
Telefon maketleri ve mağaza butonlarıyla mobil uygulama tanıtım sitesi
Archform (archform)
architecture
Tek renkli, beton dokulu, dev görseller, grotesk ve italik serif
Atelier Nord (atelier-nord)
portfolio
İsviçre ızgarası, büyük grotesk yazı
Atlas Academy (atlas-academy)
education
Mor, mercan ve nane tonlarında cesur neo-brütalist kurs sitesi
Aurum & Pearl (aurum-and-pearl) · Mağaza
shop
Sakin lüks mücevher, fildişi ve altın
Bean There (bean-there)
restaurant
Nane vurgulu espresso kafe, menü panosu ve demleme rehberleri
Bright Smile Dental (bright-smile)
health
Taze akuamarin ve beyaz, yuvarlak ve eğlenceli
Byte Notes (byte-notes)
technology
Kod bloklu, öncelikle koyu geliştirici blogu
Campfire (campfire) · Forum
personal
Sıcak bir üretici topluluğu forumu, kâğıt üzerinde köz ve yosun
Campus Commons (campus-commons)
education
Okullar ve çevrim içi kurslar için samimi akademik tema, lacivert ve hardal
Cloudline (cloudline)
technology
SLA rakamları ve duyurularla net mavi BT hizmetleri sitesi
Crumb & Crust (crumb-and-crust)
food
Parlak tarif blogu, yuvarlak kartlar, mercan ve tereyağı sarısı
Datafield (datafield)
science
Şekil ve dipnotlu, grafik esintili araştırma defteri
Devboard (devboard) · Forum
technology
Kod stilli ve istatistik kenar çubuklu yoğun geliştirici soru-cevap panosu
Dog-Ear Books (dog-ear-books) · Mağaza
shop
Bağımsız kitapçı, gazete başlığı ve raflar
Driftwood Inn (driftwood-inn)
hotel
Butik sahil oteli, kumlu nötrler ve okyanus mavisi, ferah serif
Encore (encore)
music
Neon vurgulu karanlık sahne
Ever After (ever-after)
wedding
Pudra ve adaçayı tonlarında serif ve el yazısı tipli romantik düğün sitesi
Evergreen Care (evergreen-care)
health
Randevu çağrılı, yumuşak camgöbeği ve beyaz sakin klinik sitesi
Faithful Commons (faithful-commons)
religion
Kemerli pencereli, yumuşak taş ve altın tonlarında misafirperver ibadet yeri
Fernwood (fernwood) · Mağaza · WB
home
Botanik bitki dükkânı, orman yeşili ve kiremit
Frame by Frame (frame-by-frame)
entertainment
Kâğıt, mürekkep ve festival altını tonlarında sinematik letterbox dergi
Gearhead Garage (gearhead-garage)
automotive
Karbon siyahı ve yarış kırmızısı oto atölyesi, açılı kenarlar, dar büyük harfler
Glow Botanica (glow-botanica) · Mağaza
shop
Yumuşak cilt bakımı butiği, pudra karolar ve kemerler
Good Boy Supply (good-boy-supply) · Mağaza · WB
pets
Eğlenceli evcil hayvan dükkânı, lacivert ve güneş sarısı
Green Basket (green-basket) · Mağaza
shop
Samimi organik market, yaprak ve tereyağı
Green Pulse (green-pulse)
environment
İklim haberleri dergisi, koyu orman ve elektrik yeşili, veri vurguları
Greenleaf Market (greenleaf-market)
shop
Kraft kâğıt üzerinde organik çiftlik dükkânı, taze yeşiller ve el yazısı etiketler
Guild Hall (guild-hall) · Forum · WB
gaming
Koyu mor üzerinde limon yeşili ve macenta, karanlık oyun topluluğu merkezi
Headline Daily (headline-daily)
magazine
Yoğun haber ön sayfası, kırmızı ve siyah
Hearth & Herb (hearth-and-herb)
food
Rustik ev yemekleri, ot yeşili ve ahşap, yazdırılabilir tarifler
Ink & Needle (ink-and-needle)
beauty
Blackletter ve kan kırmızısıyla siyah ve kemik rengi dövme stüdyosu
Inkwell (inkwell)
blog
Büyük ilk harfler ve ortalanmış başlıkla klasik editoryal serif
Ironbeam Construction (ironbeam)
construction
İş güvenliği sarısı ve çelik, dar endüstriyel yazı
Justitia (justitia)
legal
Bordo ve antrasit, Caslon serif, altın ince çizgiler
Keystone Estates (keystone-estates)
real-estate
Temiz ajans, orman yeşili ve taş, arama odaklı hero
Kiln & Loom (kiln-and-loom) · Mağaza
shop
Sıcak editoryal el sanatları pazarı, kiremit ve çivit
Kite & Crayon (kite-and-crayon) · Mağaza · WB
kids
Parlak çocuk oyuncak dükkânı, krem üzerinde domates ve nane
Launchpad (launchpad)
startup
Gradyan ağlı hero ve değişiklik günlüğüyle SaaS açılış sayfası
Ledger & Co. (ledger-co)
business
Kurumsal lacivert ve arduvaz, serif başlıklar, pirinç vurgu
Little Sprouts (little-sprouts)
kids
Neşeli ana renkler, yuvarlak şekiller ve dalgalı kenarlar
Lumen Folio (lumen-folio)
photography
Koyu, kenardan kenara masonry galeri
Nest & Nook (nest-and-nook)
home
Ferah nötr iç mekânlar, masonry odalar, önce/sonra ve görünümü satın al
Northstar Ventures (northstar-ventures)
finance
Koyu lacivert ve gümüş, serif makaleli girişim sermayesi firması
Numera (numera)
finance
Sakin mavi-yeşil, net tablolar, samimi geometrik sans
Oak & Form (oak-and-form) · Mağaza
shop
Ferah İskandinav mobilya, keten ve meşe
Open Hands (open-hands)
nonprofit
Etki rakamları ve bağış butonlarıyla sıcak, umutlu yardım kuruluşu sitesi
Pageturner (pageturner)
books
Caslon yazı, bordo mürekkep ve kitap kapağı rafıyla edebi yazar sitesi
Paper Lantern (paper-lantern)
personal
Krem kâğıt üzerinde sıcak, el yazısı günlük
Paws & Whiskers (paws-and-whiskers)
pets
Turuncu ve camgöbeği, yuvarlak ve eğlenceli samimi veteriner kliniği
Peak Athletics (peak-athletics) · Mağaza
shop
Enerjik spor ekipmanı, karbon ve volt
Petal & Stem (petal-and-stem)
shop
Buket kataloglu botanik çiçekçi, şakayık ve yosun
Pixel Arcade (pixel-arcade)
gaming
Piksel yazı ve neon skorlarla retro-fütüristik koyu arayüz
Podwave (podwave)
podcast
Dalga formlarıyla parlak, yuvarlak program sitesi, mor ve mercan
Pulse Fit (pulse-fit)
fitness
Yüksek enerjili koyu spor salonu, elektrik yeşili, kalın dar yazı
Quiet Hours (quiet-hours)
minimal
Eş aralıklı, yalnızca metin, açık ve koyu
Roast & Ritual (roast-and-ritual) · Mağaza
shop
Sıcak kahve kavurucusu, paket etiketi kartları ve damgalar
Studio Fizz (studio-fizz)
agency
Cesur, renkli ve eğlenceli
Study Circle (study-circle) · Forum · WB
education
Beyaz üzerinde camgöbeği ve güneş sarısı, samimi çalışma grubu forumu
Sugar & Saffron (sugar-and-saffron)
food
Pastel pastane blogu, el yazısı ve serif yazı, kemerli fotoğraflar
Summit Trails (summit-trails)
sports
Topografik kontürlerle yürüyüş kulübü, arduvaz ve alp turuncusu
Threadline (threadline) · Mağaza
shop
Minimal giyim butiği, serif ve kum
Trattoria (trattoria)
restaurant
Sıcak kiremit tonlu trattoria, klasik serif, fiyat noktalı menü
Velvet Runway (velvet-runway)
fashion
Editoryal serif dergi, sade lüks
Velvet Salon (velvet-salon)
beauty
Gül kurusu ve şampanya tonlarında, kemerli görselli kuaför ve güzellik salonu
Voltage (voltage-store) · Mağaza
shop
Koyu elektronik mağazası, büyük arama ve parlayan kartlar
Wanderline (wanderline)
travel
Afiş yazısı ve gün batımı renkleriyle maceracı seyahat günlüğü
Pursae Forum her forum sayfasını (dizin, forumlar, konular, profiller, üye listesi, giriş, kayıt, hesap) etkin temanın içinde çizer; yani her tema forumu değişiklik olmadan gösterir. Forum için yapılan bir tema adım adım daha ileri gidebilir:
Adım
Yazdığınız
Kazandığınız
1. Hiçbir şey
—
forum, kendi forum.css'iyle page.html zincirinizde
2. Renk ve yazı
style.css içinde --pf-* belirteçleri
her forum görünümü paletinizi, fontlarınızı ve köşe yarıçapınızı kullanır
3. Sarmalayıcı
supports: {"pursae-forum": true} ve templates/forum.html
forum görünümleri için kendi düzeniniz; forum kendi başlığını ve içerik yolunu basar
Forum sayfası sentetik bir sayfadır (.Q.Kindpage, yazı ID 0); forum.html, page.html, singular.html, index.html sırasıyla işlenir; body pursae-forum ve pf-view-<view> sınıflarını alır.
Geçersiz kılmalar kendi kendine yeterli olmalı, kök <div class="pf …" data-view="<view>">'i korumalıdır; hata verirse eklentinin şablonuna düşülür.
Belirteçleri (--pf-accent, --pf-surface, --pf-text, --pf-radius, --pf-font…) :root'a değil body .pf'ye koyun; Web Builder'ın --wb-* belirteçlerine düşerler.
Hazır referanslar: Campfire, Devboard (paket), Guild Hall ve Study Circle (paket + Web Builder parçaları). Tam rehber: docs/developer/themes/forum.md
Eklenti geliştirme
Eklentiler
Bir Pursae eklentisi, WebAssembly'ye derlenmiş, imzalı bir zip içinde paketlenmiş ve wazero sandbox'ında çalışan bir Go programıdır. Siteye yalnızca küçük bir host API üzerinden, yöneticinin etkinleştirme sırasında onayladığı izinlerle erişir.
Site her plugin.wasm dosyasını, saf Go ile yazılmış bir WebAssembly çalışma zamanı olan wazero içinde çalıştırır. Eklenti çekirdekle yalnızca JSON mesajları ve host fonksiyonları üzerinden konuşur; her host fonksiyonu ve hook, plugin.json içinde bildirilen bir izinle korunur.
Yalıtım. Dosya sistemi, soket ya da ortam değişkeni yok. Eklenti yalnızca host'tan gelen JSON mesajlarını görür ve yalnızca izinlerinin izin verdiği host fonksiyonlarını çağırabilir.
Hata sınırlama. Eklentideki bir panic, sonsuz döngü ya da os.Exit yakalanır: çağrı zaman aşımına uğrar veya başarısız olur, filtre orijinal değerini korur, modül yeniden örneklenir. Art arda beş hatadan sonra eklenti devre dışı bırakılır ve yönetici nedenini görür.
Taşınabilirlik. Tek bir plugin.wasm, Pursae'nin çalıştığı her platformda çalışır. SDK bugün Go'dur (wpgo/sdk/go/wpgo); ABI düz JSON olduğundan başka diller de izleyebilir. wpgotest ile test edin; wpgo plugin new|build ile iskelet oluşturup paketleyin.
Bir eklenti neler yapabilir
İhtiyaç
SDK
İzin
Render edilmiş yazı içeriğini ve başlıkları değiştirmek (the_excerpt ayrılmış, henüz tetiklenmiyor)
Paketler Ed25519 ile imzalanır. Bir site bir paketi yalnızca imzası güvendiği bir anahtarla (WPGO_PLUGIN_KEYS veya plugin_trusted_keys seçeneği) doğrulanıyorsa ya da yönetici geliştirme için imzasız paketlere açıkça izin verdiyse kurar. Hub üzerinden yayımlanan eklentiler Hub'ın anahtarıyla yeniden imzalanır ve siteler bu anahtara otomatik güvenir. assets/ altındaki dosyalar, plugin.json içindeki özetleri sayesinde imzanın kapsamındadır.
Go 1.27 ve Pursae deposunun bir kopyası gerekir (SDK modülü ve wpgo-pkg aracı için). Eklentinin kendisi sıradan bir Go main paketidir.
1. Modülü oluşturun
SDK depoda wpgo/sdk/go/wpgo olarak durur; wpgo modülü henüz ayrı yayımlanmadığı için en basit düzen depo içinde bir dizindir:
cd pursae
mkdir -p examples/plugins/hello-reader
cd examples/plugins/hello-reader
Eklentiyi kendi deponuzda tutmak için modülü yerel kopyanıza yönlendirin:
go mod init example.com/hello-reader
go mod edit -require=wpgo@v0.0.0 -replace=wpgo=../pursae
2. Kodu yazın (main.go)
// Command hello-reader greets readers at the end of every post.
package main
import (
"html"
"wpgo/sdk/go/wpgo"
)
func init() {
// Filters receive the current value and the extra arguments the core passed.
wpgo.AddFilter("the_content", wpgo.DefaultPriority, func(_ wpgo.Context, content string, args []any) string {
post, _ := args[0].(map[string]any)
if single, _ := post["is_single"].(bool); !single {
return content
}
name := "reader"
if u, _ := wpgo.CurrentUser(); u != nil { // needs users:read
name = u.DisplayName
}
return content + "<p class=\"hello-reader\">Thanks for reading, " + html.EscapeString(name) + "!</p>"
})
}
func main() {} // never called: the host drives the plugin through its exports
init içinde kaydedilen hook'lar kuyruğa alınır ve eklenti başlatılırken host'a gönderilir; wpgo.OnInit ile kaydedilen callback'ler hemen ardından çalışır ve host fonksiyonlarını çağırabilir.
3. Tanımlayın: plugin.json
{
"slug": "hello-reader",
"name": "Hello Reader",
"version": "1.0.0",
"description": "Greets readers at the end of every post.",
"author": "You",
"requires": "0.1.0",
"license": "GPL-2.0-or-later",
"permissions": ["content:filter", "users:read"],
"hooks": ["the_content"]
}
Abone olunan her hook hooks içinde, bir hook'un veya host fonksiyonunun gerektirdiği her izin permissions içinde olmalıdır; manifest paketlemede ve kurulumda doğrulanır.
c-shared kullanın.-buildmode=c-shared, dışa aktarımları başlatmadan sonra çağrılabilen bir WASI reactor üretir. Varsayılan derleme modu, main dönünce çalışma zamanı kapanan bir komut üretir; yükleyici bunu reddeder ve c-shared kullanmanızı söyler.
5. Paketleyin ve imzalayın
go build -o wpgo-pkg ./internal/plugins/cmd/wpgo-pkg # once, from the Pursae checkout
./wpgo-pkg keygen -out mykey # writes mykey.pub and mykey.key (keep .key private)
./wpgo-pkg pack -dir examples/plugins/hello-reader -wasm plugin.wasm -key mykey.key -out hello-reader-1.0.0.zip
./wpgo-pkg verify -pub mykey.pub hello-reader-1.0.0.zip
pack, -dir dizininden plugin.json, readme.md, icon.svg ve assets/ dizinini alır. tools/build-plugins.sh, tüm örnek eklentiler için 4. ve 5. adımları bir geliştirme anahtarıyla yapar.
6. Kurun
Anahtarınıza güvenin: ortamda WPGO_PLUGIN_KEYS='<contents of mykey.pub>' ya da anahtarı plugin_trusted_keys seçeneğine yapıştırın. Yerel denemeler için bunun yerine plugin_allow_unsigned ayarlanabilir.
Eklentiler › Yeni Ekle › Upload Plugin, zip'i seçin, sonra Activate. Etkinleştirme ekranı manifestteki izinleri listeler; verdiklerinizi işaretleyin.
Bir yazı açın: selamlama oradadır. Eklentinin günlüğü (son satırları Eklentiler ekranında görünür) bir çağrının reddedildiğini veya başarısız olduğunu söyler.
7. Yineleyin
wpgo plugin new -slug my-plugin -sdk /path/to/pursae; plugin.json, main.go, wpgotest kullanan bir birim testi, readme.md ve go.mod yazar. wpgo plugin build -dir my-plugin [-key mykey.key] tek adımda Wasm'a derler ve paketler; wpgo plugin keygen|pack|verifywpgo-pkg komutlarıdır, yani yayımlanan wpgo ikili dosyası paketleme için yeterlidir. Yeniden yükleyin (aynı slug paketi değiştirir), devre dışı bırakıp yeniden etkinleştirin. Callback'leri normal Go araç zincirinde wpgo.Dispatch ile test edin.
Sonraki adım.shortcode-demo örneği yaklaşık 150 satırda kısa kodlar, REST rotaları, bir ayar sayfası, varlıklar, transient'lar ve zamanlanmış bir olay kullanır.
2–64 karakter, ^[a-z0-9]+(-[a-z0-9]+)*$. Eklentiyi tanımlar, hook'larının sahibidir, REST ad alanının ve seçenek adlarının önekidir. Ayrılmış: core, yerleşik eklenti slug'ları (classic-editor, wpgo-cache, goocommerce, …) ve çekirdek REST ad alanı kökleri (wp, wp-admin, wp-json, wp-content, wp-includes, wp-site-health, wp-block-editor, wp-abilities, admin, oembed, batch, pursae, wpgo, wc, wc-admin, wc-analytics, wc-store, wc-telemetry, pll, contact-form-7, web-builder, elementor, gooike, headlessgo, pixelgo, seogo, rankmath, yoast); bunlardan birini kullanan paket kurulumda reddedilir
name
evet
en fazla 100 karakter
version
evet
1.2.3 veya 1.2.3-beta.1; Hub sonuncudan yeni olmayan sürümü reddeder
description
hayır
en fazla 2000 karakter, düz metin
author, author_uri, plugin_uri
hayır
URI'ler mutlak http(s) URL olmalı
requires
hayır
asgari Pursae sürümü; daha yeni çekirdek gerektiren eklenti kurulumda ve etkinleştirmede reddedilir
requires_plugins
hayır
önce etkin olması gereken eklentilerin slug'ları (Wasm slug'ı veya yerleşik eklenti slug'ı, ör. contact-form-7); etkinleştirme reddedilir ve eksikler listelenir
license
hayır
bir SPDX tanımlayıcısı
permissions
evet (boş olabilir)
izin sözlüğünden; tekrar yok
hooks
evet (boş olabilir)
eklentinin abone olabileceği her hook (harf, rakam, _ . : / -, en fazla 128). Listelenmeyen hook'u kaydetmek çalışma anında reddedilir; izin gerektiren bir hook o iznin bildirilmesini gerektirir
shortcodes
hayır
kaydedilebilecek her etiket (^[a-z0-9_-]{1,64}$); content:filter gerektirir
assets
wpgo-pkg pack doldurur
yol → assets/ altındaki her dosyanın hex SHA-256'sı; elle yazmayın
Hub aynı dosyayı okur ve ayrıca pazar yeri kaydında gösterilen tested_core, author_url ve homepage takma adlarını da anlar.
Doğrulama
wpgo-pkg pack ve sitenin kurucusu doğrulamayı çalıştırır ve tüm sorunları birlikte bildirir:
Etkinleştirmede yönetici her izni tek satırlık açıklamasıyla görür ve bir alt kümesini verebilir. Eklenti bildirilen ile verilenin kesişimini alır; daha fazlasını isteyen çağrı permission_denied döner ve günlüğe yazılır, ama hata sayılmaz.
Eklenti, bildirilen ve verilen izinlerin kesişimiyle çalışır. Eksik izin gerektiren bir host fonksiyonu veya hook permission_denied ile başarısız olur (günlüğe yazılır, ölümcül değildir).
İzin
Yöneticiye gösterilen
Açtığı yetenekler
options:read
Read site options
GetOption ve benzerleri: eklentinin kendi seçenekleri (<slug>_*, plugin_<slug>_*) ve herkese açık çekirdek seçenekleri; geri kalan her şey (sırlar, kullanıcılar, e-posta, lisanslar, diğer eklentilerin ve yerleşik eklentilerin ayarları) bulunamadı olarak okunur
options:write
Create and change site options
<slug>_* / plugin_<slug>_* için UpdateOption, eklentinin kendi ad alanında saklanır. Çekirdek seçenek adları slug'ınızla başlasa bile reddedilir; auth_, wpgo_, native_, pursae_ veya başka bir eklentinin plugin_ önekiyle başlayan adlar da
posts:read
Read posts and receive post data from post lifecycle hooks
GetPost, QueryPosts; save_post, save_post_*, wpgo_post_stats hook'ları ve ayrılmış yazı yaşam döngüsü adları
Eklentinin seçenekleri options tablosunda wasm:<slug>:<name> olarak saklanır; eklenti düz adı kullanmaya devam eder (GetOption("hello_gopher_footer")), ad alanını host ekler.
Yönergeler ve uygulama
Eklentinin bugün ihtiyaç duyduğunu isteyin. posts:write ve http:outbound isteyen bir içerik eklentisi etkinleştirme ekranında şüpheli görünür.
Zarifçe geri çekilin: wpgo.IsPermissionDenied(err), isteğe bağlı bir izin verilmediğinde alternatif yola geçmenizi sağlar.
İzinleri readme.md içinde açıklayın; Hub listeyi pazar yeri sayfasında gösterir.
Denetim host'ta isteğiniz çözülmeden önce, hook kaydedilirken de yeniden yapılır (add_hook reddedilir, callback hiç çalışmaz). Manifest doğrulayıcısı hook ve kısa kodları paketlemede ve kurulumda bildirilen izinlerle çapraz denetler.
WordPress'teki gibi: filtreler bir değer alır ve geri döndürür, aksiyonlar argüman alır ve bir şey döndürmez. Callback'ler artan öncelik sırasıyla çalışır (varsayılan 10); çekirdek ve eklenti callback'leri tek bir kayıt defterini paylaşır, bu yüzden eklenti çekirdek davranışından önce veya sonra çalışabilir.
AddFilter generic'tir: değer JSON'dan bildirdiğiniz türe (string, map[string]any, bir struct) çözülür; çözme başarısız olursa host orijinal değeri korur ve günlüğe yazar. ctx eklenti slug'ını, hook adını ve callback kimliğini taşır. Her hook manifestteki hooks içinde listelenmelidir.
Çekirdeğin tetiklediği hook'lar
Hook
Tür
Değer / argümanlar
İzin
the_content
filtre
Render edilmiş yazı HTML'i (bloklar, autop ve kısa kodlardan sonra); argüman post: {"id", "type", "is_single"} (arşivlerde is_single false)
{"type", "documentId", "locale", "action", "data"}; 400 ValidationError ile reddetmek için "errors" ekleyin (en fazla 20) veya data içindeki skaler öznitelikleri değiştirin. 5 sn bütçe
Eklenti kaldırılmadan önce (wpgo.OnDeactivate); 5 sn bütçe
—
uninstall
Eklenti silindiğinde (wpgo.OnUninstall); 5 sn bütçe; ardından seçenekleri, transient'ları ve olayları silinir
—
cron_<name>
Zamanlayıcı tarafından {"plugin": "<slug>", "args": {…}} ile tetiklenir
cron
Ayrılmış adlar
İzin kuralları çekirdeğin ileride tetikleyeceği adları şimdiden sınıflandırır, böylece bugünkü manifestler geçerli kalır. Henüz tetiklenmeyen bir hook'a abone olmak serbesttir; callback sadece hiç çalışmaz.
İzin
Hook adları
content:filter
the_ ile başlayan her şey, comment_text, widget_text, widget_title, get_the_excerpt, wp_title, document_title_parts, body_class, post_class
Zaman aşımları: içerik hook'u veya kısa kod 2 sn, REST işleyicisi 10 sn, cron_* 30 sn. Süreyi aşan callback öldürülür, filtre değerini korur, eklenti bir sonraki çağrıda yeniden örneklenir.
Hatalar sayılır: art arda beş hata (panic, zaman aşımı, bozuk yanıt) eklentiyi devre dışı bırakır. Bütçesinin %75'ini (1,5 sn) kullanan bir çağrı da sayılır; REST ve cron bu yavaş çağrı kuralından muaftır. İzin hataları sayılmaz.
Aynı anda tek çağrı: meşgul bir eklenti için istek en fazla bir çağrı zaman aşımı kadar bekler, sonra callback atlanır ve günlüğe yazılır; böyle bir sayfa Pursae Cache tarafından saklanmaz.
Yeniden örnekleme: yeni örnek init fonksiyonlarınızı ve OnInit'i yeniden çalıştırır; tüm kayıtları orada yapın.
Temizlenen çıktı:content:html olmadan eklediğiniz HTML KSES'ten geçer; <script>, <style> veya yorum içindeki değişiklikler atılır.
Yeniden giriş: aynı çağrı zincirinde eklentinize yeniden girecek bir callback, kilitlenme yerine atlanır.
Her host fonksiyonu bir wpgo import'una gönderilen JSON isteğidir ve tipli bir SDK fonksiyonuyla sarılır. Hatalar *wpgo.Error türündedir: permission_denied (wpgo.IsPermissionDenied(err)), invalid_request veya host_error. Wasm host'u dışında her fonksiyon wpgo.ErrNotInHost döndürür.
Seçenekler: eklentinin kendi seçenekleri ve herkese açık çekirdek seçenekleri okunabilir; yalnızca kendileri yazılabilir ve wasm:<slug>:<name> olarak saklanır. Adlar en fazla 191 karakter.
Yazılar:Post alanları ID, Title, Content, Excerpt, Status, Type, Slug, Date, Modified, Author, Link, Terms, Meta. PostQuery: Type, Status, Search, Author, Term, OrderBy, Order, PerPage (1–100, varsayılan 10), Page. PostInput alanları işaretçidir (wpgo.String("…")): Title (≤1000), Content (≤1 MiB), Excerpt (≤10 000), Status, Type, Slug, Meta. Alt çizgiyle başlayan meta anahtarları reddedilir; içerik KSES'ten geçer.
Kullanıcılar:User alanları ID, Login, DisplayName, Roles, Caps ve Can(cap). Eklentiler e-posta adreslerini veya parola özetlerini asla görmez.
Storage eklenti başına özel bir anahtar/değer tablosudur (anahtar ≤256 karakter, değer ≤1 MiB) ve eklentiyle birlikte silinir. Transient'lar TTL'li JSON değerleridir (anahtar ≤172 karakter, değer ≤1 MiB), her gün temizlenir.
HTTP:HTTPGet; Status, Header, Body döndürür (≤1 MiB, büyüğü hatadır), 8 sn zaman aşımı, özel ve loopback adresler engelli. HTTPRequest GET, POST, PUT, PATCH, DELETE, HEAD destekler; ≤32 başlık (Host, Content-Length ve hop-by-hop reddedilir), gövde ≤1 MiB.
E-posta: 1–10 alıcı, göndereni site belirler, eklenti başına saatte 60 mesaj.
Bildirimler: türler NoticeInfo/Success/Warning/Error, düz metin ≤2000 karakter, bir admin_notices callback'i içinde.
Çeviri: Pursae Multi Language açıksa metinler Languages › Translations altında "Plugin: name" olarak listelenir; değilse metin aynen döner. Metin ≤10000 bayt, bağlam ≤200 bayt.
Eklenti, misafir doğrusal belleği üzerinden UTF-8 JSON konuşan bir WASI preview1 reactor modülüdür. wasm32-wasi'ye derlenip fonksiyon dışa aktarabilen her dil bunu uygulayabilir; referans Go SDK'dır. Paketlenmiş (packed) değer, ptr<<32 | len'e eşit bir u64'tür.
Araç zincirleri. Daha küçük çalışma zamanları (TinyGo, Rust, AssemblyScript) standart Go derlemesinden çok daha küçük paketler üretir, ancak proje bugün yalnızca standart Go araç zincirini test eder.
Misafir export'u
İmza
Amaç
_initialize
() -> ()
dil çalışma zamanı başlatma (Go: paket init'leri)
wpgo_init
() -> ()
_initialize'dan sonra bir kez; hook'ları add_hook ile kaydeder
Misafir {"value":…} veya {"error":"…"} ile yanıt verir. type: filter, action, shortcode (args = [attrs, content]) veya rest (args = [request], değer {"status":200,"body":…,"headers":{…}}). Arayüz callback'leri admin_page, dashboard_widget, meta_box, meta_box_save, block ve builder_widget türlerini kullanır.
Host import'ları wpgo modülündedir ve hepsinin imzası (ptr, len i32) -> i64'tür. Her biri wpgo_alloc ile ayrılmış bir zarfa paketlenmiş işaretçi döndürür:
Yanıt iletilemezse import 0 döner. Örnek istekler: add_hook{"type":"filter|action","hook":"…","priority":10,"callback":"…"}; schedule_event{"hook":"cron_x","interval":3600,"at":0,"args":{…}} (interval 0 = at anında tek seferlik); register_rest_route{"namespace":"<slug>/v1","route":"/items/(?P<id>\\d+)","methods":["GET"],"callback":"…"}; register_settings_page{"option_prefix":"plugin_<slug>_"} döndürür. register_* ve enqueue_* kayıtları çalışma zamanında tutulur ve yeniden örneklemeden sonra tekrar gönderilir; tekrarlamak etkisizdir. Misafir herhangi bir export içindeyken host import'larını çağırabilir.
rest:routes ile eklenti kendi ad alanı altında rotalar kaydeder. Çekirdek isteği diğer REST istekleri gibi doğrular (çerez + X-WP-Nonce ya da Application Password) ve bir RestRequest iletir; eklenti durum kodu, JSON gövde ve isteğe bağlı başlıklar döndürür.
Ad alanı: eklenti slug'ı veya <slug>/v<N>. Çekirdek rotaları önce eşleşir ve yabancı ad alanları reddedilir; eklentiler çekirdek rotaları asla gölgeleyemez.
Rota: iki uçtan sabitlenmiş, adlandırılmış gruplu bir düzenli ifade, ör. /items/(?P<id>\d+).
Metotlar: GET, POST, PUT, PATCH, DELETE (boşsa GET). HEADGET işleyicisini kullanır; OPTIONS izin verilen metotlarla yanıtlanır.
func init() {
wpgo.RegisterRestRoute("shortcode-demo/v1", "/facts", []string{"GET", "POST"}, facts)
wpgo.RegisterRestRoute("shortcode-demo/v1", `/facts/(?P<id>\d+)`, nil, fact)
}
func facts(_ wpgo.Context, req *wpgo.RestRequest) *wpgo.RestResponse {
if req.Method == "GET" {
return wpgo.JSON(200, map[string]any{"facts": allFacts()})
}
if !req.User.Can("edit_posts") { // nil user → false
return wpgo.RestError(403, "rest_forbidden", "Sorry, you are not allowed to add facts.")
}
var in struct{ Fact string `json:"fact"` }
if err := req.BindJSON(&in); err != nil || in.Fact == "" {
return wpgo.RestError(400, "rest_invalid_param", "fact is required")
}
// …store it…
return wpgo.JSON(201, map[string]any{"fact": in.Fact})
}
İstek alanı
İçerik
Method
X-HTTP-Method-Override / _method işlendikten sonra
Route
eşleşen yol, ör. /shortcode-demo/v1/facts/7
Params
adlandırılmış gruplar; req.Param("id")
Query
URL sorgu parametreleri, her birinin ilk değeri (tümü için req.QueryAll)
JSON gövde (req.BindJSON(&v)) veya JSON string; en fazla 1 MiB
User
{ID, Login, DisplayName, Roles, Caps} veya nil
Yanıt ve kimlik doğrulama
wpgo.JSON(status, v) gövdeyi kodlar; wpgo.RestError(status, code, message){"code","message","data":{"status"}} biçimini üretir. İzin verilen yanıt başlıkları: Cache-Control, Expires, ETag, Last-Modified, Vary, Link, Retry-After, Content-Language, Content-Disposition, X-WP-Total, X-WP-TotalPages, Location (aynı site yolu) ve eklentinin kendi X-<Slug>-* başlıkları; diğerleri atılır ve günlüğe yazılır. Gövde en fazla 1 MiB; panic, 10 sn zaman aşımı veya bozuk sonuç 500 rest_plugin_error verir.
permission_callback yoktur: req.User'ı kendiniz denetleyin (req.User.Can("edit_posts") nil üzerinde güvenlidir). Nonce'suz çerez anonim sayılır.
RegisterRestRouteWithHeaders ek başlıklar ister (ör. Stripe-Signature, X-Hub-Signature-256); rota başına en fazla 16; Cookie, Authorization, Proxy-Authorization reddedilir.
req.RawBodyBytes() HMAC doğrulaması için değiştirilmemiş gövdeyi döndürür.
wpgo.Text(status, contentType, text); text/plain, text/csv, text/html, text/xml, application/xml, application/rss+xml veya application/atom+xml ile yanıtlar; nosniff ile gönderilir, HTML Content-Security-Policy: sandbox ile sandbox'lanır.
Eklenti ayar sayfası için yönetim HTML'i render edemez; sayfayı bildirir ve çekirdek onu Ayarlar › <Menü başlığı> altında render eder, girdiyi doğrular, her alanı bir seçenek olarak kaydeder ve "Settings saved." gösterir. İzinler: kaydetmek için admin:settings, değerleri okumak için options:read.
asla geri basılmaz; boş girdi saklanan değeri korur
Placeholder
color
#rgb, #rrggbb, #rrggbbaa veya ""
—
date
YYYY-MM-DD veya ""
—
Kurallar: ID^[a-z0-9_]{1,64}$ ve benzersiz; sayfa başına 1–50 alan; etiketler ve placeholder'lar ≤200, açıklamalar ≤2000 karakter. Her şey kaçışlanır. Her alan plugin_<slug>_<id> seçeneği olarak saklanır (slug'daki tireler alt çizgi olur) ve yalnızca sahibi eklenti okuyabilir.
heading := wpgo.SettingString("heading", "Did you know?")
count := int(wpgo.SettingFloat("count", 3))
greet := wpgo.SettingBool("greet", true)
name := wpgo.SettingName("heading") // "plugin_shortcode_demo_heading"
Sayfayı kaydetmek sayfa önbelleğini temizler. Özel HTML, eklentiyi çağıran düğmeler, dosya yükleme veya Ayarlar dışındaki sayfalar burada mümkün değildir; bunlar için bir yönetim sayfası (admin:pages) kullanın.
cron ile eklenti yinelenen veya tek seferlik olaylar planlar. Çekirdeğin iş çalıştırıcısı bunları jobs tablosunda saklar ve zamanı gelince eklentinin hook'unu bir aksiyon olarak tetikler; ziyaretçi gerekmez ve birden çok sunucu örneğinde bile olay bir kez çalışır. Hook adı cron_ ile başlamalı, hooks içinde listelenmeli ve bir aksiyon kaydı olmalıdır. Planlamayı OnInit içinden yapın.
Kısa kodlar WordPress sözdizimini kullanır ve the_content içinde bloklar ve autop'tan sonra, the_content filtrelerinden önce genişletilir (öncelik 11'deki do_shortcode gibi).
[gopher-facts] self-closing
[gopher-facts count="3" style=plain] attributes: quoted or bare, names are lower-cased
[box title="Note"]Some *text*[/box] enclosing: the content is passed to the callback
[[gopher-facts]] escaped: rendered as the literal text [gopher-facts]
Etiketi plugin.json içinde shortcodes altında listeleyin (content:filter gerekir):
wpgo.AddShortcode("box", func(ctx wpgo.Context, attrs map[string]string, content string) string {
title := attrs["title"]
if title == "" {
title = "Note"
}
return `<div class="box"><strong>` + html.EscapeString(title) + `</strong>` + content + `</div>`
})
attrs adlandırılmış öznitelikleri ve "0", "1", … altında konumsal olanları tutar.
content etiketler arasındaki ham metindir (autop uygulanmış); iç içe kısa kodlar sizin için genişletilmez.
Eklenti content:html tutmuyorsa çıktı KSES'ten (wp_kses_post) geçer. ctx.Hook etiketin kendisidir.
Panic veya zaman aşımı boş string olarak render edilir ve günlüğe yazılır.
Yazı ve sayfa içeriğinde (Shortcode bloğu ve klasik içerik) çalışır; özetlerde, widget metninde veya REST API'nin content.rendered alanında çalışmaz.
Paketin assets/ dizinindeki dosyalar, eklenti etkinken /wp-content/plugins/<slug>/assets/<path>?ver=<version> adresinden sunulur. İzin: content:filter; bir betik ayrıca ön yüzde content:html, yönetimde admin:scripts gerektirir (wpgo.Both ikisini de). Yönetimdeki bir stil dosyasıadmin:settings (yalnızca eklentinin ayar sayfasında) veya admin:scripts (her yönetim ekranında) gerektirir.
Kural
Değer
Uzantılar
.css .js .svg .png .jpg .jpeg .webp .woff2
Boyut
dosya başına 2 MiB, paket başına 16 MiB ve 256 dosya
Yollar
harf, rakam, ., -, _; hiçbir parça noktayla başlamaz; alt dizinlere izin var
Bütünlük
wpgo-pkg pack her dosyanın SHA-256'sını plugin.jsonassets alanına yazar; kurucu listelenmemiş, eksik veya değiştirilmiş varlıkları reddeder
Enqueue fonksiyonlarını init veya OnInit içinden çağırın; bunlar statik kayıtlardır. Font ve görsellere CSS'ten göreli URL'lerle, HTML'den /wp-content/plugins/<slug>/assets/… ile başvurun. Sitenin CSP'si betik ve stillere yalnızca kendi kökeninden izin verir; satır içi <script> yerine paketlenmiş betik tercih edin.
Yönetim sayfaları, meta kutuları, bloklar ve bileşenler#
Ayar sayfalarının ötesinde eklenti, her biri kendi iznine sahip beş tür arayüz ekleyebilir. Eklenti HTML döndürür; çekirdek onu yerleştirir ve temizler: yönetim çıktısı admin:scripts yoksa betikleri, olay işleyicilerini ve iframe'leri kaybeder (wp.KsesAdmin); ön yüz çıktısı (bloklar, bileşenler) content:html yoksa KSES'ten geçer.
Ne
SDK
İzin
Sınır
Yönetim menüsünde sayfa
RegisterAdminPage(AdminPage{…})
admin:pages
20
Pano kutusu
RegisterDashboardWidget(id, title, cap, fn)
admin:dashboard
10
Yazı düzenleme ekranında kutu
RegisterMetaBox(MetaBox{…})
admin:metaboxes
20
Pursae Editor bloğu
RegisterBlock(Block{…})
blocks:register
50
Pursae Web Builder bileşeni
RegisterBuilderWidget(BuilderWidget{…})
builder:widgets
50
Bir render callback'i 1 MiB HTML döndürebilir ve en fazla 256 KiB girdi alır. Yönetim sayfaları 10 sn, diğerleri 2 sn bütçe alır.
Yönetim sayfaları
wpgo.RegisterAdminPage(wpgo.AdminPage{
Slug: "", PageTitle: "Gopher Board", MenuTitle: "Gopher Board",
Parent: "tools", // "" = top-level, "self" = under the plugin's main page, or a core menu
Render: func(ctx wpgo.Context, req wpgo.AdminRequest) wpgo.AdminResponse {
if req.Method == "POST" { /* req.Form["message"] … */ }
return wpgo.AdminResponse{HTML: `<input name="message"> <button class="button button-primary">Save</button>`,
Notices: []wpgo.PageNotice{{Type: "success", Message: "Saved."}}}
},
})
URL: /wp-admin/admin?page=<plugin slug> veya …?page=<plugin slug>.<Slug>.
Parent: "" (dashicons-*Icon'lu üst düzey menü), self ya da dashboard, posts, media, pages, comments, appearance, plugins, users, tools, settings.
Capability varsayılanı manage_options. Çekirdek HTML'inizi nonce'lu bir <form method="post"> ile sarar; POST'lar eklentiye yalnızca nonce denetiminden sonra ulaşır. En fazla 10 düz metin bildirim.
Meta kutuları klasik editörde ve Pursae Editor'de görünür (varsayılan post ve page). Bildirilen Fields yazı metası plugin_<slug>_<field id> olarak saklanır; Render çıktısı asla form denetimi içeremez; OnSave yazı kimliğini ve değerleri alır.
Bloklar<plugin slug>/<name> adını alır, dinamiktir (yalnızca öznitelikler kaydedilir), Attributes'tan inspector denetimleri ve /wp/v2/block-renderer/<name> ile sunucu önizlemesi vardır. Etkin olmayan eklentinin bloğu hiçbir şey render etmez.
Bileşen türü <plugin slug>/<ID>'dir. Çekirdek bileşenleri GET /wp-json/web-builder/v2/plugin-widgets ile sunar ve POST /wp-json/web-builder/v2/plugin-widgets/render ile render eder (ikisi de edit_posts gerektirir).
Henüz tamamlanmadı. Builder'ın bileşen paneli eklenti bileşenlerini henüz listelemiyor; editör tarafı beklemede, bu yüzden bileşene bugün yalnızca bu uç noktalardan ulaşılabilir.
Eklentiler cgo ve süreç sınırı olmadan wazero içinde çalışır; yalıtım, modülün yalnızca doğrusal belleğe ve host'un verdiği import'lara sahip olmasından gelir.
Alan
Erişim
Dosya sistemi
yok: preopen yok, WASI dosya çağrıları başarısız olur
Ağ
http:outbound ile HTTPGet / HTTPRequest dışında yok (8 sn, 1 MiB, loopback ve özel adresler engelli)
Ortam, argümanlar
yok
Saat ve rastgelelik
var (time.Now, crypto/rand)
stdout / stderr
eklenti günlüğüne yakalanır
Diğer eklentiler
görünmez; seçenekler, storage ve transient'lar slug'a göre kapsamlanır
Sınır
Varsayılan
Doğrusal bellek
1024 sayfa = eklenti başına 64 MiB
Eşzamanlılık
eklenti başına aynı anda tek çağrı
Derlenmiş kod
bellekte tutulur, açılışta yeniden derlenir
Hook, kısa kod callback'i
2 sn
REST rota işleyicisi
10 sn
cron_* callback'i
30 sn
Örnekleme + wpgo_init
10 sn
Sınırı geçen mesaj
8 MiB
Yazı içeriği
1 MiB; başlık 1000, özet 10 000, slug 200 karakter
REST gövdesi, HTTP yanıt gövdesi, storage/transient değeri
1 MiB (anahtarlar 256 / 172 karakter)
Yönetim bildirimi
2000 karakter
Ayar sayfası
50 alan
Cron aralığı
60 sn ile 1 yıl arası
Varlıklar
dosya başına 2 MiB, paket başına 16 MiB ve 256 dosya
Hata yönetimi
Trap, zaman aşımı, os.Exit, panic veya bozuk yanıt günlüğe yazılır; filtre değerini korur, kısa kod boş render edilir, REST rotası 500 döner. Art arda beş hatadan sonra eklenti devre dışı kalır (hook'lar, kısa kodlar, rotalar, ayar sayfası ve varlıklar kaybolur), neden Eklentiler ekranında gösterilir ve yeniden başlatmada da korunur. Sıfırlamak için yeniden etkinleştirin.
Kodunuz için. Callback'leri kısa tutun, yavaş işi zamanlanmış bir olaya taşıyın; paket düzeyindeki duruma güvenmeyin (örnek her an değişebilir; storage kullanın); goroutine'ler yalnızca host export'unuzun içindeyken çalışır; Go çalışma zamanı 64 MiB sınırının bir kısmını kullanır, bu yüzden akış ve sayfalama kullanın.
64 MiB; -buildmode=c-shared ile derlenmiş WASI reactor
readme.md
hayır
1 MiB; pazar yeri sayfasında gösterilir
icon.svg
hayır
256 KiB; pazar yeri simgesi
assets/…
hayır
dosya başına 2 MiB, toplam 16 MiB
signature
site imza istiyorsa
1 KiB
Başka dosyaya izin verilmez.
wpgo-pkg
wpgo plugin keygen|pack|verify|new|build # the same tool is built into the wpgo binary
go build -o wpgo-pkg ./internal/plugins/cmd/wpgo-pkg
wpgo-pkg keygen -out mykey [-comment "My plugins key"]
# writes mykey.pub (publish this) and mykey.key (mode 0600; keep it private); existing files are kept
wpgo-pkg pack -dir ./my-plugin -wasm plugin.wasm -key mykey.key -out my-plugin-1.0.0.zip
# packs plugin.json, readme.md, icon.svg and assets/** from -dir; omit -key for an unsigned package
wpgo-pkg verify -pub mykey.pub my-plugin-1.0.0.zip
# verifies the signature and prints the manifest summary
Anahtar dosyaları base64'tür, isteğe bağlı # yorum satırları içerebilir. tools/build-plugins.sh [plugin-dir …] örnek eklentileri bir geliştirme anahtarıyla examples/plugins/dist/ içine derler; kendi anahtarınızla imzalamak için WPGO_SIGNING_KEY=/path/to/key ayarlayın.
plugin_allow_unsigned açık, bazı güvenilen anahtarlar var
kurulur
reddedilir
kurulur
plugin_allow_unsigned açık, hiç güvenilen anahtar yok
—
doğrulanmamış olarak kurulur
kurulur
güvenilen anahtar yok, plugin_allow_unsigned kapalı
—
reddedilir
reddedilir
Yalnızca geliştirme.plugin_allow_unsigned'ın bir ekranı yoktur; üretimde asla açmayın.
Güvenilen anahtarlar şunlardan gelir: WPGO_PLUGIN_KEYS (virgülle ayrılmış), plugin_trusted_keys seçeneği (Eklentiler > Trusted Keys, hemen etkili), Manager'ın anahtar listesi (her dizin yenilemesinde değiştirilir) ve geliştirmede WPGO_TRUST_DEV_KEY=1 iken örnek paketlerin yanındaki dev-key.pub.
Güncellemeler ve sürümleme
Site her eklentiyi hangi anahtarın imzaladığını kaydeder. Yeni sürüm aynı anahtardan gelmeli (Pursae Manager'ın herhangi iki anahtarı aynı yayıncı sayılır) ve daha eski olmamalıdır: Manager'dan gelen böyle bir paket reddedilir; yüklemede Replace current with uploaded seçeneği sunulur. Manager güncellemesinden önce önceki paket <slug>.zip.prev olarak saklanır ve yeni sürüm yüklenemezse geri konur. Her sürümde version'ı artırın; Hub var olan veya daha düşük bir sürümü reddeder. 64 MiB'tan büyük paketler reddedilir.
SDK her platformda derlenir. Host dışında host fonksiyonları wpgo.ErrNotInHost döndürür; hook kaydı ve wpgo.Dispatch ise çalışır. Bu, WebAssembly olmadan go test için yeterlidir.
func TestFooterOnSinglePosts(t *testing.T) {
wpgo.Init() // flushes registrations made in init(); safe to call more than once
req := map[string]any{
"plugin": "hello-reader", "hook": "the_content", "type": "filter",
"callback": callbackFor(t, "the_content"),
"value": "<p>Hi</p>",
"args": []any{map[string]any{"id": 1, "type": "post", "is_single": true}},
}
raw, _ := json.Marshal(req)
var resp struct {
Value string `json:"value"`
Error string `json:"error"`
}
if err := json.Unmarshal(wpgo.Dispatch(raw), &resp); err != nil || resp.Error != "" {
t.Fatalf("dispatch: %v %s", err, resp.Error)
}
if !strings.HasSuffix(resp.Value, "Thanks for reading, reader!</p>") {
t.Fatalf("got %q", resp.Value)
}
}
Callback adları üretilir (the_content#1, shortcode:box#2, rest:ns/route#3). Kısa kod istekleri "type": "shortcode" ve "args": [attrs, content]; REST istekleri "type": "rest" ve "args": [request] kullanır.
Host'u taklit etmek: wpgotest
wpgo/sdk/go/wpgo/wpgotest host'u taklit eder; GetOption, Storage, Transients, GetPost, QueryPosts, CurrentUser, HTTPGet/HTTPRequest, SendMail veya AdminNotice çağıran kod düz go test ile çalışır.
func TestRates(t *testing.T) {
h := wpgotest.New(t)
h.SetOption("plugin_rates_currency", "EUR")
h.StubHTTP("https://api.example.com/rates", 200, `{"eur":1.1}`)
h.AddPost(wpgo.Post{Title: "Hello", Content: "body"})
h.SetUser(&wpgo.User{ID: 1, Caps: []string{"edit_posts"}})
// ... call your code, then inspect what it did:
_ = h.Storage() // plugin storage
_ = h.Mails() // queued mail
_ = h.Notices() // admin notices
_ = h.Requests() // outbound HTTP requests
}
Stub'lanmamış URL'ler reddedilmiş istek gibi başarısız olur; taklit izinleri uygulamaz. Arayüz için: h.RenderAdminPage, h.RenderBlock, h.Registered("register_meta_box"). Depo içinde internal/plugins testleri gerçek bir plugin.wasm'ı plugins.NewRuntime ve plugins.MemoryHost ile çalıştırır.
Bir sitede
WPGO_WEB_DIR=web ve plugin_allow_unsigned ile çalıştırın; yükleyin, etkinleştirin, eklenti günlüğünü Eklentiler ekranında okuyun (sunucu günlüğünde de plugin=<slug> ile).
WPGO_MARKET_DIR=/path/to/zips paketlerinizi tek tıkla kurulum için Eklentiler › Yeni Ekle'de listeler.
Hub, sitelerin Eklentiler › Yeni Ekle ekranında okuduğu pazar yeridir. Yayımlamayı bir Hub operatörü yönetim panelinden yapar; geliştirici olarak siz bir paket ve kayıt bilgilerini teslim edersiniz.
Paketi kendi anahtarınızla imzalayarak derleyin ve paketleyin: Hub imzanızı köken kanıtı (provenance) olarak saklar ve kendi anahtarıyla yeniden imzalar, böylece siteler ek yapılandırma olmadan kurar.
plugin.json'u eksiksiz doldurun. Hub şunları okur: slug, name, version, description (kart metni: bir iki cümle), author, author_url, homepage, requires_core, tested_core, permissions, hooks (author_uri, plugin_uri, requires aynı veridir).
readme.md (kayıt sayfası olur) ve kare bir icon.svg ekleyin (yoksa yer tutucu üretilir).
Yalnızca istediğiniz izinlerle temiz bir sitede test edin.
Gönderme: zip'i Hub operatörüne gönderin; herkese açık Hub için deponun eklenti gönderim süreci üzerinden. Güncellemeler daha yüksek bir version ile aynı şekilde yayımlanır. Ayrıntılar aşağıdaki Hub bölümünde.
Hub (wpgo-hub), eklenti ve tema pazar yerinin, çekirdek güncellemelerinin, lisansların ve imzalama anahtarlarının arkasındaki merkezi servistir. Her üretim Pursae sitesi https://hub.pursae.com ile konuşur.
/api/v1/ altında, sitelerin ve herkese açık sitenin okuduğu herkese açık JSON API: kimlik doğrulama yok, önbelleğe alınabilir, hız sınırlı;
/admin/ altında, operatörün eklenti ve tema pazar yerini, çekirdek sürümlerini ve imzalama anahtarlarını yönettiği yönetim paneli.
Üretimdeki bir siteyi başka yere yönlendirecek ortam değişkeni veya seçenek yoktur; yalnızca geliştirme derlemeleri (-tags devhub) WPGO_DEV_HUB_URL'i okur. Siteler Hub ile yalnızca https üzerinden konuşur (düz http yalnızca localhost, loopback, *.localhost ve *.test için); yönlendirmeler asla http'ye düşmez.
Özellik
Uç nokta
Göründüğü yer
Eklenti pazar yeri
GET /api/v1/plugins
Eklentiler › Yeni Ekle
Tema pazar yeri
GET /api/v1/themes
Görünüm › Temalar › Yeni Tema
Paket indirmeleri
…/{slug}/download[/{version}]
tek tıkla kurulum; site SHA-256'yı ve eklentiler için Hub imzasını denetler
Çekirdek sürümleri
GET /api/v1/index → core
Pano › Güncellemeler (Update to version X)
Önceki çekirdek sürümü
GET /api/v1/core/{version}
Pano › Güncellemeler › Reinstall version Y
Eklenti güncellemeleri
GET /api/v1/plugins
Eklentiler ve Pano › Güncellemeler
Lisans denetimi
GET /api/v1/license
Ayarlar › Lisans
İmzalama anahtarları
GET /api/v1/index → keys
güvenilen eklenti anahtarlarına otomatik eklenir (her yenilemede değiştirilir)
Ürün logosu
GET /api/v1/index → brand
her ekranda gelen logonun yerini alır
Katalog yanıtları Cache-Control: public, max-age=300 taşır; siteler kataloğu 12 saat önbelleğe alır. Host başına 10 dakikada bir ping kabul edilir (aksi halde 429).
Doğruladığı sürümle aynı yanıtta listelenen bir anahtar hiçbir şey kanıtlamaz; bu yüzden çekirdek kendini güncellerken ikili dosyaya derlenmiş bir sürüm kök anahtarı gerekir: internal/server/hub_trust.go içindeki rootKeysBuiltin (sabitlenmiş Pursae sürüm kökü), artı yalnızca kök ekleyen -ldflags "-X wpgo/internal/server.rootKeysLinked=…" (Docker: --build-arg ROOT_KEYS=…).
endorsement = base64(Ed25519.Sign(rootKey, "pursae-hub-key-v1\n" + id + "\n" + public)). Eklenti paketleri de yalnızca onaylanmış Hub anahtarlarına karşı doğrulanır (wpgo_hub_trust_keys açıkken). Üretim ikili dosyası bunu gevşetemez; WPGO_TRUST_HUB_KEYS=1 ile bir geliştirme derlemesi listelenen her anahtara güvenir. Ele geçirilmiş bir Manager anahtarı, yeni anahtar üretip kök tarafından onaylatarak ve eskisini listelemeyi bırakarak döndürülür.
Ayarlar › Lisans, lisans anahtarını alır (pursae_license_key seçeneği, eklentiler asla okuyamaz); GET /api/v1/license ile denetlenir ve 12 saat önbelleğe alınır. Her Hub isteği X-Pursae-Site ve anahtar varsa X-Pursae-License taşır; Hub bu durumda Pro ve Private paketleri ile beta sürümleri de listeler (Pro, Private, Beta rozetleri).
İstatistikler varsayılan olarak açıktır ve Ayarlar › Lisans › "Send usage statistics" (pursae_send_stats) ile kapatılabilir. Günlük ping POST /api/v1/sites/ping'dir (wpgo_hub_check tarafından da çalıştırılır) ve url, version, locale, os, arch, license, theme, plugins, themes ve contacts içerir. Olaylar (POST /api/v1/sites/events): plugin_install, plugin_update, plugin_activate, plugin_deactivate, plugin_delete, theme_install, theme_update, theme_activate, theme_delete, theme_preview, demo_import ve core_update.
Gizlilik. Site asla kullanıcı verisi, e-posta adresi (güncelleme e-postalarını kabul etmiş contacts dışında), yazı içeriği, başlık veya ziyaretçi bilgisi göndermez. Herkese açık site sayısı GET /api/v1/sites/count'tur; site listesi herkese açık değildir.
Hub kataloğunu (GET /api/v1/plugins, son güncellemeye göre sıralı; ad, slug, açıklama ve yazara göre aranabilir) yerleşik eklentilerin ve WPGO_MARKET_DIR'deki paketlerin yanında listeler. Kartta ad, yazar, sürüm, açıklama, simge, eklentinin istediği izinler, indirme sayısı ve asgari çekirdek sürümü görünür; ayrıntı görünümü paketin readme.md'sini gösterir. Kartlar requires_core ve tested_core'dan "Requires Pursae X" ve "Tested up to Y" gösterir; çalışan çekirdekten yenisini isteyen kayıtta devre dışı bir Incompatible düğmesi çıkar. tags filtre bağlantılarıdır (?tag=<tag>).
Install Now paketi download_url'den indirir, SHA-256'yı kayıttaki sha256 ile ve imzayı güvenilen bir anahtarla doğrular (Hub anahtarlarına otomatik güvenilir), eklentiyi etkin olmayan olarak saklar ve imzalayan anahtarı kaydeder.
Activate, eklentinin neler yapabileceğini verdiğiniz izin ekranını açar.
Upload Plugin sekmesi de aynı imza denetiminden geçer.
Temalar
Görünüm › Temalar › Yeni Tema › Library, Hub'ın tema kataloğunu (GET /api/v1/themes) gösterir. Tema paketleri kod içermez ve imzalanmaz; Install boyutu ve SHA-256'yı denetler, theme.json, şablonlar ve demoyu doğrular ve <data>/themes/<slug>/ içine açar. Live Preview önce demo içerikli bir sandbox kurar. WPGO_THEME_LIBRARY_DIR kütüphaneyi yerel bir dizinden sunar.
Güncellemeler
Hub'dan kurulan eklentiler (source = hub), katalog daha yüksek bir version listelediğinde Eklentiler ekranında ve Pano › Güncellemeler altında (Update Plugins) güncelleme satırı gösterir. Güncellemeler kurulum gibi SHA-256 ve imzayı doğrular; etkin eklenti yalnızca önceden verilmiş ve yeni sürümün hâlâ istediği izinleri korur. İsteğe bağlı changelog güncelleme satırında görünür.
Otomatik güncellemeler: Eklentiler ekranındaki "Enable auto-updates" bağlantısı (pursae_plugin_auto_updates seçeneği); günlük wpgo_hub_check bunları kendisi günceller, ancak etkin bir eklentiyi yalnızca yeni sürüm yeni bir izin istemiyorsa.
Çevrimdışı: Hub'a ulaşılamazsa yalnızca yerleşik eklentiler, paketle gelen temalar ve yerel paketler görünür; yüklemeler çalışmaya devam eder.
Yayımlama Hub'ın yönetim panelinden yapılır (Admin › Plugins, Admin › Themes): operatör bir zip yükler, kaydı inceler ve yayımlar. Geliştiriciler paketi ve kayıt bilgilerini teslim eder; herkese açık Hub için projenin gönderim süreci üzerinden.
Eklentinizi göndermek. İmzalı zip'i Hub operatörüne gönderin: herkese açık Hub için deponun eklenti gönderim süreci üzerinden, özel bir Hub için kurumunuzla nasıl anlaşıldıysa öyle. Belgeler herkese açık gönderim sürecini daha ayrıntılı tarif etmiyor.
Hub'ın yayımlamada yaptıkları
Zip'i ve manifesti ayrıştırıp doğrular; slug için zaten var olan veya en son yayımlanandan düşük bir sürümü reddeder.
Geliştiricinin signature dosyasını (varsa) köken kanıtı olarak saklar ve zip'i aynı özet üzerinde Hub'ın kendi imzasıyla yeniden paketler.
Yeniden paketlenmiş zip'i, SHA-256'sını ve boyutunu saklar.
Kayıt alanları plugin.json'dan gelir (slug, name, version, description, author, author_url/author_uri, homepage/plugin_uri, requires_core/requires, tested_core, permissions, hooks); operatör açıklamayı ve ana sayfayı geçersiz kılabilir. readme.md ayrıntı sayfası, icon.svg simge olur.
Yayımladıktan sonra
Öğe hemen GET /api/v1/plugins'te görünür (download_url, sha256, signed_by ve izinlerle) ve sitelerde 12 saatlik katalog önbelleği içinde. Her indirme downloads'u artırır; eski sürümler GET /api/v1/plugins/{slug} içindeki versions altında kalır; unpublish bir öğeyi dosyalarını silmeden gizler.
Temalar (theme.json, templates/, assets/ içeren zip) doğrulanır ama imzalanmaz; çekirdeğin tema kütüphanesi make publish-themes PURSAE_MANAGER_DIR=/path/to/pursae-manager [PREINSTALL=slug,slug|all] ile yayımlanır.
Hub'ın imzalama anahtarı WPGOHUB_DATA_DIR/keys/<id>.key içindedir; eski açık anahtarlar GET /api/v1/index'te listelenmeye devam eder, böylece kurulu paketler doğrulanmaya devam eder.
Üretim ikili dosyaları her zaman https://hub.pursae.com ile konuşur. Kendi Manager'ınızı, geliştirme derlemelerine (-tags devhub) karşı paket ve sürüm geliştirip test etmek için ya da kendi ikili dosyalarını derleyen bir fork'un Hub'ı olarak (kendi config.DefaultHubURL ve sürüm kök anahtarıyla) çalıştırın.
wpgo-hub, PostgreSQL ve bir veri dizini kullanan tek bir ikili dosyadır; Pursae compose yığınında host portu 8090'da yayımlanır.
Değişken
Varsayılan
Anlamı
WPGOHUB_ADDR
:8080
dinleme adresi
WPGOHUB_PUBLIC_URL
http://localhost:8090
download_url ve bağlantılarda kullanılır; herkese açık https:// adresine ayarlayın
oturum imzalama; yeniden başlatmalar ve replikalar için ayarlayın
WPGOHUB_TEST_DB
—
entegrasyon testleri yalnızca ayarlıysa çalışır
TLS arkasına koyun; GET /healthzok döner.
İlk çalıştırma
Operatör hesabını oluşturmak için /setup'ı açın, sonra /login (argon2id, giriş kısıtlaması).
Ekran
İşlevi
/admin
genel bakış: site sayısı, eklenti ve temalar, son ping'ler, son çekirdek sürümü
/admin/sites
host'lar, sürümler, ilk/son görülme, local işareti; arama; silme
/admin/plugins, /admin/themes
zip yükleme, yayımla/yayından kaldır, sürümler, kaydı düzenleme, silme
/admin/releases
çekirdek sürümleri: sürüm, indirme ve not URL'leri, notlar; yayımla
/admin/keys
imzalama anahtarları; yenisini üret
/admin/settings
hub adı, herkese açık URL, hız sınırları
İlk eklentiden önce./admin/keys altında bir imzalama anahtarı üretin: paketler onunla yeniden imzalanır ve siteler onu GET /api/v1/index'ten güvenilen anahtarlarına ekler.
Siteleri bağlamak
Başka bir Hub'a yalnızca geliştirme derlemesi bağlanır: -tags devhub ile derleyin (make dev veya GO_TAGS=devhub ayarlayan geliştirme compose dosyası), WPGO_DEV_HUB_URL=http://localhost:8090 (compose varsayılanı http://pursae-manager.test:8090) ve WPGO_TRUST_HUB_KEYS=1 ayarlayın. WPGO_DEV_HUB_URL=off tüm Hub'lardan bağlantıyı keser. Üretim ikili dosyaları ikisini de yok sayar.
API
Herkese açık Hub ile aynı API: GET /api/v1/index, /plugins, /plugins/{slug}, /plugins/{slug}/download[/{version}], /plugins/{slug}/icon, /themes için aynıları (/screenshot ile), POST /api/v1/sites/ping, GET /api/v1/sites/count.
Pursae, WordPress REST API'sini /wp-json/ adresinde sunar. wp/v2 ad alanı WordPress'e o kadar yakındır ki blok editörü, mobil uygulamalar ve headless istemciler değişmeden çalışır.
WordPress'ten farklar Henüz wp-site-health/v1, wp/v2/plugins veya wp/v2/font-families yok; wp/v2/templates boş liste döndürür. Blok türleri, desen dizini ve blok dizini aramaları boş liste döndürür.
Yönetim sayfaları nonce'u wpApiSettings.nonce içinde verir; kimliği doğrulanmış her yanıt X-WP-Nonce içinde yenisini döndürür.
Uygulama Parolaları Kullanıcılar › Profil › Uygulama Parolaları altında, /wp/v2/users/me/application-passwords üzerinden veya /wp-admin/authorize-application akışıyla oluşturulur.
Bir adresten 15 dakika içinde beş Basic-auth hatasından sonra sonraki istekler 429 too_many_retries alır.
Yalnızca TLS Basic kimlik doğrulama parolayı her istekte gönderir; Uygulama Parolalarını yalnızca TLS üzerinden kullanın.
Uygulama Parolası kapsamları
Kapsamsız bir parola kullanıcısının tüm yetkilerine sahiptir. Kapsamlı bir parola iki kez daraltılır: yetkiler kapsamların gerektirdiğine indirilir ve başka bir kapsamın rotası data.required_scope ile 403 rest_scope_forbidden döndürür. Kapsamlar asla yetki eklemez.
Her kapsamlı parola ayrıca REST dizinini ve /wp/v2/users/me'yi okuyabilir ve /pursae/v1/mcp'yi kullanabilir. Kapsamlı bir parola Uygulama Parolası oluşturamaz, değiştiremez veya iptal edemez.
OAuth 2.1 uç noktaları
Uç nokta
Amaç
/.well-known/oauth-protected-resource
korunan kaynak metadata'sı (RFC 9728)
/.well-known/oauth-authorization-server
yetkilendirme sunucusu metadata'sı (RFC 8414)
POST /oauth/register
dinamik istemci kaydı (RFC 7591), yalnızca public istemciler
/wp-admin/oauth-authorize
kapsam kutucuklu onay ekranı
POST /oauth/token
authorization_code (PKCE) ve refresh_token grant'leri
POST /oauth/revoke
belirteç iptali (RFC 7009)
S256 ile PKCE zorunludur; kodlar 5 dakika yaşar ve bir kez çalışır.
Erişim belirteçleri (pat_…) bir saat, yenileme belirteçleri (prt_…) 30 gün geçerlidir ve her kullanımda döndürülür. Yalnızca SHA-256 özetleri saklanır.
Bir kullanıcı en fazla 20 grant tutar. Headless teslim API'si (/wp-json/headlessgo/v1) kendi API belirteçlerini kullanır.
Yetkiler
Yazma işlemleri WordPress gibi denetlenir: edit_posts, edit_pages, upload_files, manage_options / edit_theme_options, manage_categories ve öğe başına meta yetkileri. Yetkisi olmayan kimliği doğrulanmış kullanıcı: 403 rest_forbidden; anonim: 401.
AI ajanlarının ve betiklerin bir siteyi yönetmek için kullandığı rotalar. Her biri kendi yönetim ekranının yetkisini denetler ve bir Uygulama Parolası kapsamına aittir.
Yöntem
Yol
Amaç
GET, POST
/pursae/v1/plugins
eklentileri listele; POST {"package": "<base64 zip>"} imzalı bir paketi pasif olarak kurar
GET, DELETE
/pursae/v1/plugins/{slug}
tek eklenti; kurulu bir Wasm eklentisini kaldır
POST
/pursae/v1/plugins/{slug}/activate, /deactivate
etkinleştir / devre dışı bırak (Wasm: permissions)
GET, POST
/pursae/v1/themes
temaları listele; POST {"package": "<base64 zip>", "activate": true} bir tema paketi kurar
DELETE
/pursae/v1/themes/{slug}
pasif bir temayı sil
POST
/pursae/v1/themes/{slug}/activate
temayı değiştir
GET
/pursae/v1/themes/{slug}/files
düzenlenebilir dosyalar
GET, POST, DELETE
/pursae/v1/themes/{slug}/file?file=…
oku, Tema Dosya Düzenleyicisi gibi kaydet (hatada geri alınır), orijinali geri yükle
POST
/pursae/v1/media/{id}/replace
ID'yi koruyarak medya dosyasını değiştir
GET
/pursae/v1/cache
Pursae Cache durumu, istatistikleri, tarayıcı
POST
/pursae/v1/cache/purge
{"all": true}, {"url": "/about/"}, {"post": 12} veya {"tags": ["home"]}
GET, POST
/pursae/v1/cache/settings
önbellek seçenekleri
GET, POST
/pursae/v1/headless/types, …/types/{uid}
Pursae Headless içerik türleri ({uid} üzerinde DELETE)
sürüm, veritabanı, cron kuyruğu, Site Sağlığı puanı, güncellemeler, son yedek
GET, POST
/pursae/v1/updates
mevcut güncellemeler; POST {"type": "plugin"|"theme"|"core", "slug": "…"} birini kurar
GET, POST
/pursae/v1/backups
arşivler veya yedek başlat (job ile 202)
GET
/pursae/v1/mcp/activity
yazan MCP araç çağrılarının denetim kaydı
GET
/pursae/v1/options, GET/POST /options/{group}
yerleşik eklenti ayarları (contact, cookie, forum, gocdn, headless, maintenance, multilang, pixel, security, seo, smtp); gizli değerler ******** olarak okunur
Eklentiler uç noktalarını kendi ad alanlarında ekler: /wp-json/<slug>/v1/… (sürüm numarası farklı olabilir). Eklenti etkinken dizinde routes ve namespaces altında listelenirler; devre dışı bırakıldığında veya kapatıldığında kaybolurlar.
Önce çekirdek rotalar eşleştirilir; bir eklenti asla bir wp/v2 yolunu ele geçiremez.
Kimlik doğrulama çekirdeğindir; eklenti varsa kullanıcıyı alır ve kendi denetimlerini uygular.
OPTIONS izin verilen yöntemleri döndürür; kabul edilmeyen yöntem 404 rest_no_route'tur.
İstek gövdeleri 1 MiB ile sınırlıdır; JSON eklenti için çözülür, diğer türler metin olarak geçirilir.
Hata veren eklenti 500 rest_plugin_error döndürür; tekrarlanan hatalardan sonra devre dışı kalır ve rota yeniden etkinleştirilene kadar 404 döndürür.
Yanıtlar application/json; charset=UTF-8'dir; _fields ve _envelope uygulanmaz.
Kapsamlar Eklenti rotaları hiçbir Uygulama Parolası kapsamına girmez; kapsamlı bir parola bunlarda 403 rest_scope_forbidden alır.
Karşılaştırmalı testler
Performans
Pursae ve WordPress, 2026-11-09'da aynı makinede, aynı içerik, tema ve konteyner sınırlarıyla ölçüldü. Tüm yapılandırmalar ve ham sonuçlar depoda; WordPress'in kazandığı yerler de tablolarda duruyor.
Önbelleksiz sayfalar: WordPress'in yaklaşık 8 katı verim. Ana sayfa 397'ye karşı 51 req/s, tekil yazı 394'e karşı 58, REST yazı listesi 1.046'ya karşı 89, yönetim panosu 627'ye karşı 72 (yalın kuruluma karşı yalın kurulum).
Yaygın eklenti setiyle: yaklaşık 13 kat (tekil yazı 232'ye karşı 19 req/s), ürün sayfası 194'e karşı 16 req/s. Altı WordPress eklentisi verimi yaklaşık üçte bire düşürüyor ve bir sayfayı 32'den 139 sorguya çıkarıyor; altı Pursae yerleşik eklentisinin maliyeti %30–40 (ana sayfada 13 → 16 sorgu).
Önbellekli sayfalar: berabere. nginx'in sunduğu WP Super Cache ve Pursae Cache yaklaşık 0,1 ms'de yanıt veriyor ve ikisi de yük üreticinin sınırına dayanıyor (28–35 bin req/s).
Bellek: tüm Pursae yığını boşta 95 MiB; WordPress yalın kurulumda 233 MiB, eklentilerle 330 MiB. Yük altında tepe değer 184–202 MiB'a karşı 276–489 MiB.
Arama sayfası önbelleğe alınmıyor (/?s= yanıtı Cache-Control: no-cache): 105–119 req/s; WP Super Cache arama sonuçlarını önbelleğe alıp 5.724 req/s sunuyor. Önbelleksiz hâlde yine yalın WordPress'in 2,5 katı (119'a karşı 48), ama Pursae'nin en yavaş sayfası (yük altında 93 ms TTFB, tek istekte 26 ms).
Önbellekli sayfalar iyi kurulmuş bir WordPress sayfa önbelleğinden daha hızlı değil.
Soğuk başlangıç aynı: iki tarafta da tüm yığın için yaklaşık 3 sn, yalnızca uygulama için yaklaşık 1 sn.
Veritabanı daha büyük: 59 tablo ve 16 MB'a karşı 92 tablo ve 30 MB; çünkü göçler yerleşik eklentilerin tablolarını eklenti açık olsun olmasın oluşturuyor.
Pursae Cache önbelleksiz rotaları biraz yavaşlattı (REST listesi 1.046 → 885 req/s, yönetim yazı listesi p50 27 → 70 ms).
"Ayarlı" WordPress önbelleksiz isteklerde yalın kurulumdan yavaştı (REST listesi 89'a karşı 64 req/s, yönetim 72'ye karşı 43); sonuçlar görüldükten sonra ayarlanmadı, yapılandırıldığı gibi bırakıldı.
Yalın kurulum + WooCommerce, Yoast SEO, Polylang, ACF, Elementor ve Contact Form 7, sayfa önbelleği yok
Commerce, SEO, Multi Language, Custom Fields, Web Builder, Contact Form; Pursae Cache kapalı
İçerik, tema ve sınırlar
Deterministik içerik (bench/content/gen.py): blok işaretlemeli 1000 yazı, 10 kategori, 60 etiket, 50 sayfa, 5 kategoride 200 ürün, öne çıkan görsel olarak 12 görsel. Kalıcı bağlantılar iki tarafta da /%postname%/.
Veri yükleme WordPress'te 125,2 sn (WXR içe aktarma 7,5 sn), Pursae'de 13,5 sn (WXR içe aktarma 5,5 sn) sürdü.
Tema: iki tarafta Twenty Twenty-Five (WordPress'in 1.5 sürümü ve Pursae'nin Go şablonu uyarlaması); Pursae'nin ana sayfa HTML'i yaklaşık yarı boyutta, çoğunlukla WordPress daha fazla blok CSS'ini satır içine koyduğu için.
Sınırlar: uygulama 2 CPU / 1 GiB, veritabanı 1 CPU / 1 GiB. WordPress ayrıca nginx (1 CPU, 256 MiB) ve ayarlı kurulumda Redis (0,5 CPU, 256 MiB) alıyor.
Uç noktalar: ana sayfa, tekil yazı, kategori arşivi, ürün (yalnızca gerçek site kurulumları), arama (/?s=garden), REST yazı listesi ve yönetici olarak giriş yapılmış pano ile yazı listesi.
Ölçümler
Yük: kendi konteynerinde k6 (4 CPU), rastgele örnek URL'ler üzerinde kapalı döngüde 10 sanal kullanıcı; her URL önce bir kez istenir, 5 sn ısınma, ardından üç adet 20 sn'lik koşu. Raporlanan: req/s, TTFB p50, gecikme p95/p99, üç koşunun medyanı.
Soğuk ve ılık istekler: yeniden başlatmadan sonra yük testinin hiç dokunmadığı URL'lerde ilk ve ikinci istek; TTFB ve sunucu tarafında sayılan veritabanı ifadeleri.
Bellek: tüm konteynerlerin docker stats toplamı, boşta ve tepe. Soğuk başlangıç: ilk ana sayfa yanıtına kadar geçen saniye. Boyut: imajlar, diskteki kurulum, veritabanı. Lighthouse: ana sayfa, mobil ön ayar, üç koşunun medyanı.
Adalet kuralları Her taraf kendi önerilen üretim biçiminde çalışır (WordPress resmî imajı WordPress.org nginx yapılandırmasının arkasında; Pursae kendi Dockerfile'ından, üretim derlemesi). WP-Cron sayfa görüntülemelerinde kapalı. Sürümler sabitlenmiş. Sonuçlar görüldükten sonra hiçbir şey ayarlanmadı.
Compose v2'li Docker (Docker'a 8 GB bellek fazlasıyla yeter), Python 3 ve Lighthouse sütunu için Node ile Chrome gerekir.
make bench her şeyi yaklaşık bir saatte çalıştırır; sonuçlar bench/results/<date>/ altına yazılır.
Hızlı bir bakış için: make bench BENCH_ARGS="--setups wp-stock,pursae-nocache --runs 1 --duration 5s".
bench/run.py --help seçenekleri listeler: --vus, --duration, --reuse (veri yüklemeyi atlar), --keep (yığınları 18081 ve 18082 portlarında açık bırakır).
Her kurulum ham k6 özetlerini, sorgu örneklerini, Lighthouse puanlarını ve result.json dosyasını bench/results/<date>/<setup>/ altına bırakır; summary.json hepsini tutar, bench/report.py bunu summary.md'ye dönüştürür.
Dosya
İçerik
bench/run.py
Orkestrasyon: derleme, veri yükleme, kurulum değiştirme, ölçüm
WordPress yığını, nginx yapılandırmaları (yalın ve WP Super Cache), php-fpm havuzları, PhpRedis imajı
bench/pursae/compose.yaml
Pursae yığını
bench/content/gen.py
WXR dosyası ve ürün verileri
bench/k6/load.js
Yük testi
Bu sayıların sınırları Tek makine, macOS üzerinde Docker Desktop (bir Linux sanal makinesi): mutlak değerler çıplak Linux'takinden düşüktür, bu yüzden değerlerden çok iki taraf arasındaki oran önemlidir. İki taraftaki önbellek isabetleri de yük üreticinin sınırına dayanır; önbellekli verim "ikisi de yeterince hızlı" der, hangisinin daha hızlı olduğunu söylemez. Temalar eşdeğerdir ama aynı değildir; yerleşik eklentiler de karşılaştırıldıkları WordPress eklentilerinin özellik özellik kopyası değildir.
Her yerleşik eklenti, insanların genellikle para ödediği bir WordPress eklentisinin temel özelliklerini karşılar. Fiyatlar, satıcının fiyat sayfasında 2026-11-09'da okunan, yıllık faturalanan en ucuz tek site planının liste fiyatıdır (yenileme fiyatı), vergiler hariç.
Pursae yerleşik eklentisi
Temel özelliklerini karşıladığı
Plan
Yıllık fiyat
Commerce
WooCommerce (ücretsiz) + WooCommerce Subscriptions gibi premium eklentiler
Subscriptions, 1 yıl
$279
Web Builder
Elementor Pro
Essential, 1 site
$60
SEO
Yoast SEO Premium (ve Rank Math PRO)
1 site
$118.80
Cache
WP Rocket
Single
$60 (ilk yıl $36, kampanya 2026-11-28'e kadar)
CDN
WP Offload Media
Bronze (2.000 medya öğesine kadar)
$69 (ilk yıl $39)
Cookie
Complianz Premium
Personal, 1 site
$59
Pixel
PixelYourSite Pro
Starter, 1 site
$199
SMTP
WP Mail SMTP Pro
Pro, 1 site
$99 (ilk yıl $49)
Custom Fields
ACF PRO
Personal, 1 site
$49
Multi Language
Polylang Pro
Pro
€99 (yenilemelerde %50 indirim)
Backup Manager
All-in-One WP Migration Unlimited Extension
Standard (50 siteye kadar)
$69
Contact Form
Contact Form 7
—
ücretsiz
Security
Wordfence / Solid Security'nin giriş güvenliği bölümü — güvenlik duvarı ve kötü amaçlı yazılım tarayıcısı yok
Wordfence Premium
($149, karşılaştırılamaz)
Maintenance
Maintenance PRO (WebFactory)
Personal
yalnızca ömür boyu satılıyor (tek sefer $59)
Headless
Bir headless CMS katmanı; karşılığı olan tek bir WordPress eklentisi yok
—
—
Toplam Liste fiyatlarıyla toplandığında yıllık fiyatı olan satırlar tek site için yılda yaklaşık $1,062 artı €99 eder (Security, Maintenance, Headless ve Contact Form hariç). Pursae'nin yerleşik eklentileri GPL lisanslı ikili dosyada ek ücret olmadan gelir.
Siteyi çalıştırmak için gerekli çerezleri kullanırız; ziyaret istatistikleri çerezsiz tutulur. Tercih ve pazarlama çerezleri yalnızca izin verirsen açılır.
Çerez tercihinizi, tarihini, politika sürümünü ve rıza kimliğinizi saklar; böylece bant her sayfada yeniden çıkmaz.
12 ay
wpgo_logged_in
Bu site
Forumda ve yönetim panelinde oturumunuzu açık tutar; “beni hatırla” seçiliyse daha uzun kalır.
Oturum / 14 gün
pll_language
Bu site
Seçtiğiniz dili (Türkçe veya İngilizce) hatırlar.
1 yıl
pursae-theme
Bu site (tarayıcı depolaması)
Açık veya koyu tema seçiminizi hatırlar; yalnızca siz tema değiştirdiğinizde oluşur. Sunucuya gönderilmez.
Siz temizleyene kadar
pursae-cookie
Bu site (tarayıcı depolaması)
Çerez tercihlerinizi ve bunları yaptığınız zamanı tarayıcınızda kaydeder.
Siz temizleyene kadar
pursae-stars
Bu site (tarayıcı depolaması)
GitHub düğmesindeki yıldız sayısını bir saat saklar; böylece GitHub'a her sayfada yeniden istek gönderilmez. Kişisel veri içermez ve sunucuya gönderilmez.
1 saat
Tercihler
Seçtiğin sekmeyi ve kapattığın kutuları hatırlar.
Pazarlama
Reklam pikselleri. İzin vermezsen hiçbiri yüklenmez.