Pursae Belgeler
Pursae belgeleri

Kurulumdan eklenti yazmaya, her şey burada.

Pursae’yi kurmak, yönetmek ve genişletmek için ihtiyacın olan her şey. Bir konu seç ya da yukarıdan ara.

01 · 7BaşlarkenPursae 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…02 · 14OperasyonTü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…03 · 15Yerleşik eklentilerBir WordPress sitesinin genellikle ayrıca satın aldığı ya da kurduğu eklentiler Pursae'nin kendi ikili dosyasında gelir. Her biri Eklentiler…04 · 5Web Builderİ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…05 · 12TemalarBir Pursae teması; Go html/template dosyaları, varlıklar ve bir manifestten oluşur. Tema paketleri hiç kod içermez: tüm veriyi çekirdek…06 · 18Eklenti geliştirmeBir Pursae eklentisi, WebAssembly'ye derlenmiş, imzalı bir zip içinde paketlenmiş ve wazero sandbox'ında çalışan bir Go programıdır. Siteye…07 · 6Hub / Pazar yeriHub (wpgo-hub), eklenti ve tema pazar yerinin, çekirdek güncellemelerinin, lisansların ve imzalama anahtarlarının arkasındaki merkezi servistir.…08 · 8REST APIPursae, 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…09 · 5Karşılaştırmalı testlerPursae 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…
Başlarken

Sıfırdan çalışan bir siteye

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 nedir

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.

Kaynak: getting-started/index.md, README.md

Gereksinimler

Docker ileBinary ile
Çalışma ortamıDocker Desktop ya da Docker Engine + Compose v2 (hızlı başlangıç için ayrıca git ve make)Derlemek için Go 1.27; çalıştırmak için başka bir şey gerekmez
Veritabanıcompose tarafından başlatılır (PostgreSQL 17)Kullanıcının tablo oluşturabildiği PostgreSQL 14 veya üstü (compose 17 kullanır)
Bellek512 MB rahat yeteraynı
PortlarSite için 8088 (production'da 127.0.0.1), PostgreSQL için 5432 (127.0.0.1, yalnızca geliştirmede)WPGO_ADDR ne diyorsa (varsayılan :8080)

Pursae Linux, macOS ve Windows'ta (amd64 ve arm64) çalışır. Docker imajı Alpine tabanlıdır ve ayrıcalıksız bir kullanıcıyla çalışır.

Docker ile kurulum

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 olmadan:

docker compose --env-file docker/.env -f docker/compose.yaml -f docker/compose.prod.yaml up -d --build

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.

ServisNedirHost portu
wpgoPursae sunucusu8088 (production: 127.0.0.1:8088)
dbPostgreSQL 17127.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.

VolumeBağlandığı yerİçerik
pgdata/var/lib/postgresql/dataveritabanı
bin/data/binçalışan binary; Dashboard › Updates bunu değiştirir
uploads/data/uploadsortam kütüphanesi dosyaları
plugins/data/pluginskurulu eklenti paketleri
themes/data/themestema paketleri ve Theme File Editor'da düzenlenen dosyalar
pagecache/data/wpgo-cachePursae Cache disk kopyası (yeniden oluşturulabilir)
languages/data/languagesindirilen dil paketleri
backups/data/backupsTools › Backups arşivleri (zamanlanmış ve elle)
mail/data/mailSMTP 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.

Kaynak: install-docker.md, GUIDE.md

Binary ile kurulum

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.

KomutNe yapar
wpgo servemigration'ları uygular, sonra sunar (varsayılan)
wpgo migratebekleyen migration'ları uygular ve çıkar
wpgo versionsü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.

İlk ayarlayacağınız değişkenler

DeğişkenVarsayılanAmaç
DATABASE_URLpostgres://wpgo:wpgo@localhost:5432/wpgo?sslmode=disablePostgreSQL bağlantı dizesi
WPGO_ADDR:8080dinleme adresi
WPGO_SITE_URLhttp://localhost:8080genel URL; kurulumda ayarlara yazılır
WPGO_UPLOADS_DIR./data/uploadsmedya yüklemeleri; eklentiler, temalar, eklenti önbelleği ve e-posta bunun yanında durur
WPGO_SECRETüretiliroturum ve nonce imzalama anahtarı
WPGO_SMTP_HOST …—giden e-posta; yoksa iletiler .eml dosyası olur

Tam liste aşağıdaki Yapılandırma bölümünde; systemd unit örneği Reverse proxy ve TLS bölümünde.

Kaynak: install-binary.md

İlk siteniz

Kurulum sihirbazı

Site kurulana kadar her istek /wp-admin/install adresine yönlenir — WordPress'in beş dakikalık kurulumunun aynısı:

  1. Site başlığı
  2. İlk yöneticinin kullanıcı adı ve parolası
  3. O yöneticinin e-posta adresi
  4. arama motorlarından sitenin dizine eklenmemesinin istenip istenmeyeceği

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.

Yönetim paneli

MenüNotlar
Posts, Pages, Media, Commentsvarsayılan olarak blok editörü açılır; Settings › Writing altından Classic Editor'a geçilebilir
AppearanceThemes (Live Preview ile), Customize, Widgets, Menus, Theme File Editor; Add Theme tema paketi yükler
PluginsInstalled Plugins, Add Plugin (marketplace, yükleme); bir eklentiyi etkinleştirirken istediği izinler gösterilir
Usersadministrator, editor, author, contributor, subscriber rolleri; kullanıcı bazında yetki geçersiz kılma
ToolsImport ve Export (WXR), Site Health, kişisel veri dışa aktarma ve silme
SettingsGeneral, Writing, Reading, Discussion, Media, Permalinks, Privacy ve eklentilerin eklediği sayfalar
Pursae Cacheyerleş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.

Kaynak: first-site.md

Güncelleme

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:

  1. binary'yi Manager'dan indirir (en fazla 1 GB), boyutunu ve SHA-256'sını denetler;
  2. 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;
  3. 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;
  4. çalışan binary'yi <executable>.prev olarak saklar, güncellemeyi <executable>.update.json'a kaydeder ve yeni binary'yi eskisinin üzerine taşır;
  5. "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>.prev 24 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

  1. Veritabanını ve uploads dizinini yedekleyin. Migration'lar ileri yönlüdür; geri dönüşünüz yedektir.
  2. Sürüm notlarını okuyun (Hub'a bağlıyken Dashboard › Updates'te listelenir).
  3. 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.

Kaynak: upgrading.md

Son sürümler için güncelleme notları

Web Builder: Theme Builder ve Hello Pursae

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ı.

Yapılandırma: çekirdek ve veritabanı

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.

Çekirdek

DeğişkenVarsayılanAnlamı
DATABASE_URLpostgres://wpgo:wpgo@localhost:5432/wpgo?sslmode=disablePostgreSQL bağlantı dizesi (pgx URL biçimi)
WPGO_ADDR:8080HTTP sunucusunun dinlediği adres
WPGO_SITE_URLhttp://localhost:8080sonda eğik çizgi olmadan genel URL; kurulum sihirbazı bunu siteurl ve home seçeneklerine yazar
WPGO_UPLOADS_DIR./data/uploadsortam kütüphanesi dosyaları. Yanındaki dizinler: eklentiler (../plugins), derlenmiş eklenti önbelleği (../plugin-cache), temalar (../themes) ve geliştirme e-postaları (../mail)
WPGO_SECRETilk açılışta üretilir, ayarlarda saklanıroturum çerezleri ve nonce'lar için gizli anahtar. Birden çok instance tek veritabanını paylaşıyorsa ayarlayın
WPGO_WEB_DIRgömülüyönetim/tema şablonlarını, CSS ve JS'i bu dizinden okur, her istekte yeniden yükler (geliştirme)
WPGO_EMPTY_TRASH_DAYS30çö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_FORMATtextjson, erişim logunu istek başına bir JSON nesnesi olarak yazar (status, method, uri, duration, ip, request_id)
WPGO_BACKUPS_DIRuploads 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_DIRuploads yanında languages/kurulu dil paketleri
WPGO_TRANSLATIONS_APIhttps://api.wordpress.org/translationsdil 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
WPGO_LISTEN_FD—dahili: soket güncellenmiş binary'ye devredilirken ayarlanır; kendiniz ayarlamayın
WPGO_PLUGINS_DIR— (uploads yanında ../plugins)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).

ParametreVarsayılanAnlamı
pool_max_conns4 × CPU, en az 10, en çok 40instance 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_conns2boştayken açık tutulan bağlantılar
pool_max_conn_lifetime1h (+ en fazla 5 dk sapma)bir bağlantı bu süreden sonra yenilenir
pool_max_conn_idle_time15mminimumun üstündeki boşta bağlantılar bu süreden sonra kapanır
pool_health_check_period30sboştaki bağlantıların ne sıklıkla denetlendiği
DATABASE_URL=postgres://wpgo:secret@db:5432/wpgo?sslmode=disable&pool_max_conns=20

Kaynak: operations/configuration.md

Yapılandırma: temalar, eklentiler ve Hub

DeğişkenVarsayılanAnlamı
WPGO_THEMES_DIR<data>/themestema paketleri (<slug>/theme.json) ve Theme File Editor'ın kaydettiği geçersiz kılmalar
WPGO_THEME_LIBRARY_DIR— (kütüphane Hub'dan gelir)Add Themes › Library'yi yerel bir tema paketleri dizininden sunar (geliştirme, çevrimdışı siteler; depodaki library/themes). Hub indirmeleri uploads yanındaki theme-library-cache/'te önbelleklenir
WPGO_DISALLOW_FILE_EDITkapalı1/true Theme File Editor'ı salt okunur yapar (DISALLOW_FILE_EDIT gibi)
WPGO_PLUGIN_KEYS—eklenti paketlerini imzalamaya güvenilen, virgülle ayrılmış base64 Ed25519 genel anahtarları; plugin_trusted_keys seçeneğine ek olarak
WPGO_MARKET_DIRexamples/plugins/dist, sonra /usr/share/wpgo/pluginsPlugins › Add Plugin'de sunulan .zip paketlerinin dizini
WPGO_TRUST_DEV_KEYayarsız (compose'da 1)market dizinindeki dev-key.pub'a güvenir. Yalnızca geliştirme
WPGO_EXPOSE_USERSayarsız1 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_PROXIESloopback 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_HUBayarsı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
WPGO_DEV_HUB_URLayarsız (geliştirme compose dosyasında http://pursae-manager.test:8090)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_KEYSayarsı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şkenVarsayılanAnlamı
WPGO_POST_REVISIONS25yazı 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şkenVarsayılanAnlamı
WPGO_ADMINSEC_DISABLE_HIDE_LOGINayarsızPursae 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_SETTINGSayarsızPursae 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şkenVarsayılanAnlamı
WPGO_PORT8088site için host portu
WPGO_BIND127.0.0.1sitenin yayımlandığı host adresi, yalnızca compose.prod.yaml ile (geliştirme dosyası tüm arayüzlerde yayımlar)
WPGO_DB_PORT5432127.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şkenVarsayılanAnlamı
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_testmake 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çenekNeredeAnlamı
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_formatSettings › 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
pursae_license_keySettings › LicenseHub'a gönderilen lisans anahtarı

Docker

İmaj

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.

docker build -f docker/Dockerfile -t wpgo:local .
docker run --rm -p 8080:8080 \
  -e DATABASE_URL='postgres://wpgo:wpgo@db:5432/wpgo?sslmode=disable' \
  -e WPGO_SITE_URL=https://blog.example.com \
  -e WPGO_UPLOADS_DIR=/data/uploads \
  -v wpgo-uploads:/data/uploads -v wpgo-plugins:/data/plugins -v wpgo-themes:/data/themes \
  wpgo:local

compose.yaml

ServisAmaç
dbpostgres:17-alpine, veritabanı wpgo, kullanıcı ve parola wpgo, pg_isready ile sağlık kontrolü, 127.0.0.1:${WPGO_DB_PORT:-5432} üzerinde yayımlanır
wpgosite; Dockerfile'dan derlenir (GO_TAGS=devhub), veritabanının sağlıklı olmasını bekler, restart: unless-stopped
testtest profili: aynı veritabanına karşı bir Go container'ında go test ./... -p 1 çalıştırır (make docker-test)
DATABASE_URL: postgres://wpgo:wpgo@db:5432/wpgo?sslmode=disable
WPGO_SITE_URL: ${WPGO_SITE_URL:-http://localhost:8088}
WPGO_UPLOADS_DIR: /data/uploads
WPGO_TRUST_DEV_KEY: ${WPGO_TRUST_DEV_KEY:-1}   # yalnızca demo
WPGO_DEV_HUB_URL: ${WPGO_DEV_HUB_URL:-http://pursae-manager.test:8090}   # yalnızca devhub build'leri
WPGO_TRUST_HUB_KEYS: ${WPGO_TRUST_HUB_KEYS:-1}                           # yalnızca devhub build'leri
WPGO_TRUSTED_PROXIES: ${WPGO_TRUSTED_PROXIES:-}
WPGO_SMTP_HOST: ${WPGO_SMTP_HOST:-}      # host yoksa: /data/mail içinde .eml dosyaları
WPGO_SMTP_PORT: ${WPGO_SMTP_PORT:-587}
WPGO_SMTP_USER: ${WPGO_SMTP_USER:-}
WPGO_SMTP_PASS: ${WPGO_SMTP_PASS:-}
WPGO_MAIL_FROM: ${WPGO_MAIL_FROM:-}

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ştirmek POSTGRES_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.

Sağlık kontrolleri

Uç nokta200 döndüğü durumKullanım
GET /healthzsüreç HTTP sunuyorsa (veritabanına dokunulmaz)liveness: Docker HEALTHCHECK, Kubernetes livenessProbe
GET /readyzveritabanı 2 sn içinde ping'e yanıt veriyor ve tüm migration'lar uygulanmışsa; aksi hâlde 503readiness: 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.

Loglar, yeniden başlatma ve birden çok instance

docker compose -f docker/compose.yaml logs -f wpgo   # production: make prod-logs
docker compose -f docker/compose.yaml restart wpgo

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.

Kaynak: operations/docker.md

Reverse proxy ve TLS

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.

nginx

server {
    listen 443 ssl http2;
    server_name blog.example.com;
    ssl_certificate     /etc/letsencrypt/live/blog.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/blog.example.com/privkey.pem;
    client_max_body_size 64m;          # medya yüklemeleri

    location / {
        proxy_pass         http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header   Host              $host;
        proxy_set_header   X-Forwarded-Proto $scheme;
        proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header   X-Real-IP         $remote_addr;
    }
}
server {
    listen 80;
    server_name blog.example.com;
    return 301 https://$host$request_uri;
}

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:

    location = /wp-json/headlessgo/v1/graphql {
        proxy_pass         http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade           $http_upgrade;
        proxy_set_header   Connection        "upgrade";
        proxy_set_header   Host              $host;
        proxy_set_header   X-Forwarded-Proto $scheme;
        proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_read_timeout 120s;           # sunucu her 20 sn'de ping atar
    }

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>

systemd unit

[Unit]
Description=Pursae
After=network.target postgresql.service

[Service]
User=wpgo
EnvironmentFile=/etc/wpgo.env
ExecStart=/usr/local/bin/wpgo serve
Restart=always

[Install]
WantedBy=multi-user.target

/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.

Kaynak: operations/reverse-proxy-and-tls.md

Önbellek (Pursae Cache)

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çenekVarsayılanAnlamı
wpgo_cache_enabledaçıkeklentinin 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_public7 günyazı, sayfa ve arşivlerin TTL'si
wpgo_cache_ttl_front7 günön sayfanın TTL'si
wpgo_cache_ttl_feed7 günbeslemelerin TTL'si
wpgo_cache_ttl_4041 saatbulunamayan sayfaların TTL'si
wpgo_cache_mobilekapalımobil kullanıcı ajanları için ayrı kayıtlar
wpgo_cache_logged_inkapalı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)
wpgo_cache_diskkapalıkayıtları diske yazar, yeniden başlatmada korunur
wpgo_cache_serverautoüretilecek proxy başlıkları: auto, litespeed, nginx, generic, none
wpgo_cache_warm_result—tarayıcının (crawler) son sonucu

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.

Etiketler ve temizleme

Önbellekteki her sayfa etiketlenir (home, post:12, term:3, author:1, media:7, feed, date:2026-10, archive:post, 404, search).

  • 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
litespeedX-LiteSpeed-Cache-Control, X-LiteSpeed-Tag
nginxproxy_cache / fastcgi_cache için X-Accel-Expires
genericCache-Control: s-maxage, Surrogate-Key ve Cache-Tag (Varnish, Fastly, Cloudflare)
autoistek LiteSpeed üzerinden geldiyse yalnızca LiteSpeed başlıkları; aksi hâlde hiçbir şey
noneyalnı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.

Geliştiriciler için: uygulamanın ayarladığı yanıt başlıkları

BaşlıkAnlamı
X-WPGo-Cache-Tags: home,post:12,term:3,author:1,feedtemizleme etiketleri (hassas temizleme için gerekli)
X-WPGo-Cache-TTL: 300saniye cinsinden TTL geçersiz kılma; 0 = önbelleğe alma
X-WPGo-Cache-Control: no-cachebu 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).

Kaynak: operations/caching.md, internal/cache/README.md

Zamanlanmış olaylar (cron)

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ıkNe yapar
wp_scheduled_deletegünlük30 gündür çöpte olan yazı ve yorumları siler (WPGO_EMPTY_TRASH_DAYS)
wp_scheduled_auto_draft_deletegünlük7 günden eski otomatik taslakları siler
delete_expired_transientsgünlüksüresi dolmuş transient'ları siler
wp_session_gcsaatlikgiriş oturumlarını ve eski giriş denemelerini sona erdirir
wpgo_cache_janitorsaatliksüresi dolmuş sayfa önbelleği kayıtlarını siler
seogo_404_trimsaatlikPursae SEO'nun 404 logunu izleyici limitinde tutar
wp_mailtek seferlikkuyruktaki bir e-postayı teslim eder
publish_future_posther tiktetarihi gelen yazıları yayımlar
wpgo_backup_scheduledgünlük ya da haftalıkBackup 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.

Kaynak: operations/cron.md

E-posta

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.

DeğişkenVarsayılanAnlamı
WPGO_SMTP_HOST—SMTP sunucusu; yoksa iletiler .eml dosyası olur
WPGO_SMTP_PORT587465 örtük TLS demektir, diğerleri sunulduğunda STARTTLS
WPGO_SMTP_USER, WPGO_SMTP_PASS—kimlik bilgileri
WPGO_MAIL_FROM<Site title> <wordpress@host>gönderici; host site URL'sinden alınır
WPGO_MAIL_DIRuploads yanında mail/ (Docker'da /data/mail)SMTP kapalıyken .eml dosyalarının yazıldığı yer
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.

Kaynak: operations/mail.md

Yedekler

Bir site üç şeydir: veritabanı, uploads dizini ve yanındaki eklenti ve tema dizinleri. Binary ve paketli temalar yedek gerektirmez.

NeNerede (compose)Nerede (binary)
veritabanıpgdata volume'ukendi PostgreSQL'iniz
medyauploads volume'u (/data/uploads)WPGO_UPLOADS_DIR
eklenti paketleriplugins volume'u (/data/plugins)<uploads>/../plugins
tema paketleri ve düzenlenen tema dosyalarıthemes volume'u (/data/themes)WPGO_THEMES_DIR
Backup Manager arşivleribackups 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

  1. Veritabanının dump'ını alın ve dosyaları yeni sunucuya kopyalayın.
  2. Mevcut oturumlar korunsun istiyorsanız yeni instance'ı aynı WPGO_SECRET ile başlatın.
  3. 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.

Kaynak: operations/backups.md

Güvenlik

Yerleşik olanlar

  • 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

  1. TLS'i bir proxy'de sonlandırın ve WPGO_SITE_URL'yi https:// adresine ayarlayın.
  2. make prod-up ve docker/.env'deki ayarlarla başlatın; site yayına girer girmez kurulum sihirbazını çalıştırın.
  3. 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_KEY 0 kalmalı.
  4. Birden çok instance çalıştırıyorsanız WPGO_SECRET'ı kendiniz ayarlayın ve gizli tutun.
  5. 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.
  6. İ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.
  7. Parola sıfırlamaları ulaşsın diye SMTP'yi yapılandırın.
  8. Veritabanını ve veri dizinlerini yedekleyin.
  9. Etkinleştirirken eklenti izinlerini gözden geçirin. Art arda beş kez başarısız olan eklenti otomatik devre dışı kalır.
  10. 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.
  11. Ç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.

Kaynak: operations/security.md

Pursae'nin hub.pursae.com'a gönderdikleri

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 zamanNe
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 istektebaş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.

Kaynak: README.md

Sürüm yayımlama

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:

  1. commit edilmemiş değişiklikleri, izlenmeyen dosyaları ya da başka bir commit'i gösteren v0.2.0 etiketini reddeder;
  2. 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;
  3. SHA256SUMS yazar;
  4. 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.
AyarVarsayılanAnlamı
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_REPOpursae/pursaeherkese 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_FILEGitHub'ın ürettiği notlarsü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).

Kaynak: operations/releases.md

Sorun giderme

BelirtiNeden ve çözüm
Yeniden başlatmadan sonra site yine /wp-admin/install'a yönleniyorVeritabanı 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österiyorSite 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 inmiyorDocker'ın ağ erişimi olduğundan emin olun; sonraki build'ler önbelleklenir.
Giriş çalışıyor ama her yönetim işleminde nonce geçersiz deniyorYük dengeleyicinin arkasındaki instance'ların WPGO_SECRET'ları farklı. Hepsine aynı değeri verin.
TLS proxy arkasında http:// bağlantılarProxy 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.
Zamanlanmış yazılar yayımlanmıyor / e-postalar gitmiyorZamanlayıcı wpgo serve içinde çalışır; sunucu logunu ve Tools › Site Health'teki başarısız işleri kontrol edin.
Tema dosyası düzenledikten sonra "Template error"Editör bozuk kayıtları geri alır; WPGO_THEMES_DIR altındaki dosyaları diskte düzenlediyseniz düzeltin ya da gömülü kopyaya dönmek için silin.
make prod-up: "Create docker/.env first" / "set WPGO_DB_PASSWORD"cp docker/.env.example docker/.env yapın ve WPGO_DB_PASSWORD ile WPGO_SITE_URL'yi doldurun.
Dashboard › Updates hiç yeni sürüm önermiyorGeliştirme build'i Hub ile konuşmaz; production build'ini (make prod-up) çalıştırın.
Loglar nerede?Sürecin standart çıktısında: docker compose logs -f wpgo, make prod-logs ya da servis yöneticinizin journal'ı. Her istek durum ve süresiyle loglanır.

Baştan başlamak

Geri alınamaz Bu, tüm volume'ları siler: veritabanı, uploads, eklentiler, düzenlenmiş temalar, yedekler ve güncellenmiş binary.
docker compose -f docker/compose.yaml down -v
make docker-up

Kaynak: operations/troubleshooting.md

Yapay zekâ ajanları (MCP)

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.

  • Uç nokta: https://<site>/wp-json/pursae/v1/mcp, MCP'nin streamable HTTP taşıması.
  • 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ımlamacontent, media, seo
Tasarım işlerithemes, media, cache
Tüm siteyi yönetmekhiç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.

# Claude Code
claude mcp add --transport http pursae https://example.com/wp-json/pursae/v1/mcp \
  --header "Authorization: Basic $(printf 'admin:abcd efgh ijkl mnop qrst uvwx' | base64)"

Claude Desktop yerel komutlar başlattığı için köprüyü claude_desktop_config.json içinde kullanın (Settings › Developer › Edit Config):

{
  "mcpServers": {
    "pursae": {
      "command": "/usr/local/bin/wpgo",
      "args": ["mcp"],
      "env": {
        "PURSAE_URL": "https://example.com",
        "PURSAE_USER": "admin",
        "PURSAE_APP_PASSWORD": "abcd efgh ijkl mnop qrst uvwx"
      }
    }
  }
}

Docker imajıyla: "command": "docker", "args": ["run", "--rm", "-i", "-e", "PURSAE_URL", "-e", "PURSAE_USER", "-e", "PURSAE_APP_PASSWORD", "<image>", "mcp"].

Cursor — ~/.cursor/mcp.json (ya da projede .cursor/mcp.json):

{
  "mcpServers": {
    "pursae": {
      "url": "https://example.com/wp-json/pursae/v1/mcp",
      "headers": { "Authorization": "Basic YWRtaW46YWJjZCBlZmdoIGlqa2wgbW5vcCBxcnN0IHV2d3g=" }
    }
  }
}

Başlık değeri Basic + user:password'ün base64'üdür. Diğer MCP istemcileri de aynı şekilde çalışır.

wpgo mcp bayrakları

BayrakOrtam değişkeniAnlamı
--urlPURSAE_URLsite adresi
--userPURSAE_USERgiriş adı ya da e-posta
--passwordPURSAE_APP_PASSWORDApplication Password; ortam değişkenini tercih edin (bayrak ps'te görünür ve köprü uyarı verir)
—PURSAE_CONFIG_DIROAuth 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

AlanAraçlar
Yazılar ve sayfalarlist_posts, get_post, create_post, update_post, delete_post ve sayfalar için aynıları
Medyalist_media, upload_media (base64 ya da genel bir URL), update_media, delete_media
Terimlerlist_terms, create_term, update_term, delete_term
Menülerlist_menus, create_menu, list_menu_locations, list_menu_items, create_menu_item, update_menu_item, delete_menu_item
Stiller ve ayarlarget_global_styles (salt okunur), get_settings, update_settings
Yorumlarlist_comments, create_comment, moderate_comment, delete_comment
Kullanıcılarlist_users, get_me, create_user, update_user, delete_user
Pursae Commerce (commerce kapsamı)commerce_list_products, commerce_get_product, commerce_create_product, commerce_update_product, commerce_update_stock, commerce_delete_product, commerce_list_orders, commerce_get_order, commerce_update_order, commerce_sales_report
Pursae Web Builder (content kapsamı)web_builder_get_document, web_builder_save_draft
Pursae SEOseo_get_meta, seo_update_meta, seo_analyze, seo_get_settings, seo_update_settings, seo_list_redirects, seo_create_redirect, seo_delete_redirect
Eklentilerlist_plugins, activate_plugin, deactivate_plugin, install_plugin, delete_plugin
Site işlemlerisite_health, list_updates, run_update, list_backups, create_backup, delete_theme, ai_activity
Temalarlist_themes, activate_theme, install_theme, list_theme_files, read_theme_file, write_theme_file, restore_theme_file
Pursae Cachecache_status, cache_purge, cache_get_settings, cache_update_settings
Pursae Headless (settings kapsamı)headless_list_types, headless_save_type, headless_update_type, headless_delete_type, headless_find, headless_get_entry, headless_create_entry, headless_save_entry, headless_publish, headless_unpublish, headless_delete_entry
Yerleşik eklenti ayarlarılist_option_groups, get_options, update_options (contact, cookie, gocdn, headless, maintenance, multilang, pixel, security, seo, smtp; gizli bilgiler maskelenir)
Diğer her şeysite_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.

Kaynak: operations/ai-mcp.md

Yerleşik eklentiler

İkili dosyaya derlenmiş eklentiler

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.

Pursae Commerce

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ı)

KategoriModüller
Ürün sunumuProduct Bundles, Pre-Orders, Product Add-Ons, Product Compare, Quick View, Dynamic Pricing
Mağaza yönetimiBookings, PDF Invoices & Packing Slips
ÖdemeSubscriptions, Gift Cards
Kargo ve teslimatTable Rate Shipping
Müşteri bağlılığıMemberships, Points and Rewards, Wishlists
  • 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üğü.
  • Analytics raporları (Overview, Products, Revenue, Orders, Variations, Categories, Coupons, Taxes, Downloads, Stock, Customers) ve sınırsız CSV; haftalık mağaza özeti e-postası.
  • 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.

Kaynak: docs/goocommerce-features.md

Pursae SEO

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).

Kaynak: docs/seo-go-features.md

Pursae Custom Fields

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.

Kaynak: docs/acf-go-features.md

Pursae Multi Language

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.

Kaynak: docs/golylang-features.md

Pursae Contact Form

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.
  • Form etiketleri: text, email, url, tel, textarea, number, range, date, select (Commerce verisinden data:countries), checkbox, radio, acceptance, quiz, file, submit, hidden, count, response, captchac / captchar.
  • 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).

Kaynak: docs/gontact-form-features.md

Pursae SMTP

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.

Kaynak: docs/wpgo-mail-smtp-features.md

Pursae Security

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.
  • Komut satırı: wpgo adminsec disable-hide-login, reset-user, unlock-all, deactivate.
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).

Kaynak: docs/adminsecgo-features.md

Pursae Cookie

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).

Kaynak: docs/gooike-features.md

Pursae Pixel

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

PlatformTarayıcıSunucu tarafı
Meta PixelEvetConversions API
Google Analytics 4EvetMeasurement Protocol, yalnızca Purchase (ve iade)
Google AdsDönüşümler, yeniden pazarlama, gelişmiş dönüşümlerHayır
TikTokEvetEvents API
PinterestEvetConversions API
Microsoft Advertising (UET)EvetHayır
Google Tag ManagerKonteyner ve GA4 e-ticaret dataLayerHayı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.

Kaynak: docs/pixelgo-features.md

Pursae Analytics

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.

Kaynak: docs/analytics-features.md

Pursae CDN

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.

Kaynak: docs/gocdn-features.md

Pursae Backup Manager

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.

Kaynak: docs/backup-manager-features.md

Pursae Maintenance

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.

Kaynak: docs/maintenance-go-features.md

Pursae Headless

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.

Kaynak: docs/headlessgo-features.md

Pursae Forum

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ı.

Kaynak: docs/forum-features.md

Web Builder

Pursae Web Builder

İ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.

Nedir

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).

Genel bakış: docs/developer/web-builder.md

Editör kavramları ve düzenleme akışı

  1. 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.
  2. 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.
  3. Değişiklikler birkaç saniyede bir kendi taslağınız olarak otomatik kaydedilir; canlı sayfaya dokunulmaz.
  4. 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.
  5. Her yayımlama aynı zamanda bir çekirdek revizyonudur; builder her birinin belgesini tutar (sayfa başına en yeni 50).
  6. 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 pencereler popup 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ı.

Theme Builder

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ürDoldurduğu yerVarsayılan koşul
Headerher sayfanın üstüEntire Site
Footerher sayfanın altıEntire Site
Single Postyazıların ana içeriğiAll posts
Single Pagesayfaların ana içeriğiAll pages
Singletek bir özel yazı türünün girdileriO türün tüm girdileri
Front Pageön sayfaFront Page
Archiveblog, kategori, etiket, yazar, tarih ve yazı türü arşivleriAll Archives
Search Resultsarama sonuçlarıSearch Results
404 Page"bulunamadı" sayfası404 Page
Single Product / Product ArchivePursae Commerce ürün ve mağaza görünümleri (yalnızca Commerce açıkken)—

Dinamik widget'lar

GrupWidget'lar
SiteSite logo, Site title, Tagline, Menu, Search form, Copyright
PostPost 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ü)
ArchiveArchive title, Archive description, Pagination
SearchSearch 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:

  1. belirli bir öğe, terim veya yazar;
  2. Front Page ve 404 Page;
  3. bir terimde (In), Child of, By author;
  4. bir yazı türü; Posts Page, Date Archives, Search Results, Author Archives, bir yazı türü arşivi, bir taksonominin tüm terimleri;
  5. All Singular, All Archives;
  6. 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.

Rehber: docs/developer/web-builder-theme-builder.md

Builder'da tema kütüphanesi

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çimSonuç
Replace themtemanın şablonları yayına girer; sizinkiler devre dışı bırakılır (taslak, asla silinmez)
Keep bothtemanı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ışı

  1. 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.
  2. Editör her belgeyi çizer ve normal publish rotasıyla yayımlar.
  3. 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.

Bir kütüphane temasını içe aktarılabilir yapmak

theme.json'a "web_builder": "web-builder/parts.json" ekleyin ve dosyayı gönderin (format web-builder-theme, sürüm 1):

{
  "format": "web-builder-theme", "version": 1,
  "templates": [
    {"key": "header", "type": "header", "title": "Header", "conditions": ["include/general"], "priority": 0, "doc": {"site": {}, "sections": []}}
  ],
  "pages": [
    {"key": "about", "slug": "about", "title": "Our promise", "doc": {}, "page": {"layout": "site"}}
  ]
}
  • doc bir builder DocState'idir, yayımlama gibi doğrulanır; {{media:<id>}} demo görselin URL'siyle değiştirilir.
  • Menüler ve görseller demo/demo.json'dan gelir; type, single dışında herhangi bir şablon türüdür; key a-z0-9- ve benzersizdir.
  • Header ve footer'ı menülere bağlayın (menu: "primary", logoSource: "site") ve dinamik widget'lar kullanın; böylece tek tema her siteye uyar.

Entegrasyon sözleşmesi

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

SabitDeğerAnlamı
APIVersion2REST ve açılış şeması (2 = Theme Builder)
RendererVersion1statik işaretleme + çalışma zamanı öznitelikleri
APIHeaderX-WB-Apieditö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-Api 409 wb_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.
  • Depolama (migration 0027_web_builder.sql): web_builder_docs, web_builder_drafts, web_builder_revisions, web_builder_library. Şablonlar wb_template türünde yazılardır (migration 0029).

Doğrulama kuralları (temel sınırlar)

KuralSınır / izinli
İstek gövdesi≤ 4 MiB (413 wb_too_large)
Ü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 kindnav 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
hrefhttp, 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'lerYouTube (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.
  • PageSettings.layout: site veya canvas.

Tam sözleşme: docs/developer/web-builder-contract.md

Temalar

Temalar

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.

Genel bakış: gömülü temalar ve tema paketleri

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:

Gömülü Go temalarıTema paketleri
ÖrneklerTwenty Sixteen, Twenty Seventeen, Twenty Twenty, Twenty Twenty-One, Twenty Twenty-Five, Classic, Hello Pursaeyüklediğiniz her tema
Konumikili 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 *Themetheme.json: bir Go temasının kodla kaydettiği her şey, veri olarak
KurulumPursae ile birlikte gelirGörünüm › Temalar › Yeni Tema Ekle › Yükle veya pazar yeri
Kodevet (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.

Kaynak: docs/developer/themes/index.md

İlk temanız

Bir tema paketi, içinde kod olmayan bir dizindir:

starter/
  theme.json          metadata, widget areas, menus, styles, customizer options
  templates/          Go html/template files
    index.html
    single.html
    page.html
    header.html
    footer.html
  assets/
    style.css
    screenshot.png
  readme.md           optional, shown on the marketplace page

1. theme.json

En az şu kadarı:

{
  "slug": "starter",
  "name": "Starter",
  "version": "1.0.0",
  "description": "A minimal starting point.",
  "author": "Gopher Co.",
  "screenshot": "screenshot.png",
  "menu_locations": [{"id": "primary", "name": "Primary Menu"}],
  "widget_areas": [{"id": "sidebar-1", "name": "Sidebar", "description": "Appears on the right."}],
  "styles": [{"handle": "starter-style", "src": "assets/style.css"}]
}

2. Şablonlar

Zorunlu tek şablon templates/index.html'dir; diğerleri WordPress hiyerarşisi boyunca ona düşer. Blog için eksiksiz bir index.html:

{{template "header" .}}
<main id="main" class="site-main">
{{range .Posts}}
  <article id="post-{{.ID}}" class="{{.Class}}">
    <h2 class="entry-title"><a href="{{.Permalink}}">{{.Title}}</a></h2>
    <div class="entry-meta">{{.EntryMeta}}</div>
    <div class="entry-content">{{if .ShowExcerpt}}{{.Excerpt}}{{else}}{{.Content}}{{end}}</div>
  </article>
{{else}}
  <p>Nothing found.</p>
{{end}}
{{.Pagination}}
</main>
{{template "footer" .}}

header.html ve footer.html, sayfaların dahil ettiği parçaları tanımlar:

{{define "header"}}<!doctype html>
<html lang="en-US">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{{.DocumentTitle}}</title>
{{.Head}}
</head>
<body class="{{.BodyClass}}">
{{.BodyOpen}}
<header class="site-header">
  {{.CustomLogo}}
  <p class="site-title"><a href="{{.HomeURL}}" rel="home">{{.SiteName}}</a></p>
  <p class="site-description">{{.Description}}</p>
  {{with index .Menus "primary"}}<nav aria-label="Primary"><ul class="menu">
    {{range .}}<li class="menu-item{{if .Current}} current-menu-item{{end}}"><a href="{{.URL}}">{{.Label}}</a></li>{{end}}
  </ul></nav>{{end}}
</header>
{{end}}

{{define "footer"}}
{{with index .Areas "sidebar-1"}}<aside class="widget-area">{{.}}</aside>{{end}}
<footer class="site-footer">{{.PrivacyLink}}</footer>
{{.Footer}}{{.AdminBar}}
</body>
</html>
{{end}}
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 ve Theme Builder

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.

ÖğeDeğer
Menü konumlarıprimary (Primary Menu), footer (Footer Menu)
Desteklercustom-logo, title-tag, post-thumbnails, menus, html5, align-wide, responsive-embeds, editor-styles, automatic-feed-links
Dosyalarweb/themes/hello-pursae/templates/header.html, pages.html, content.html; assets/style.css, editor-style.css, screenshot.png
Kodinternal/server/theme_hellopursae.go
Body sınıfları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:

AlanNeYoksa
.Data.wb.Headerdoldurulmuş header şablonuHello Pursae'nin header'ı: özel logo veya site başlığı, slogan, primary menü
.Data.wb.Mainsayfanı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.HasMainMain kendi <main> yer işaretini taşıyor—
.Data.wb.Canvastuvale ayarlı builder sayfası: header ve footer basılmaz—
.Data.wb.Footerdoldurulmuş footer şablonufooter 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 ve hiyerarşi

Ş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.

İstekSırayla denenen şablonlar
statik sayfa gösteren ön sayfafront-page.html, sayfanın kendi şablonu, page.html, singular.html, index.html
son yazıları gösteren ön sayfa veya yazılar sayfasıhome.html, index.html
bir yazısingle.html, index.html
bir sayfapage.html, index.html
özel yazı türü girdisisingle-<type>.html, single.html, index.html
özel yazı türü arşiviarchive-<type>.html, archive.html, index.html
kategori arşivicategory.html, archive.html, index.html
etiket arşivitag.html, archive.html, index.html
yazı biçimi veya özel taksonomi arşivitaxonomy-<taxonomy>-<term>.html, taxonomy-<taxonomy>.html, taxonomy.html, archive.html, index.html
yazar arşiviauthor.html, archive.html, index.html
tarih arşividate.html, archive.html, index.html
arama sonuçlarısearch.html, index.html
bulunamadı404.html, index.html
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.

Site görünümü (temel alanlar)

GrupAlanlar
Sayfa.Template, .Q (ana sorgu: .Q.Kind, .Q.Post, .Q.Term, .Q.Search, .Q.Paged…), .DocumentTitle, .Head, .Footer, .BodyOpen, .BodyClass, .AdminBar, .SiteName, .Description, .HomeURL, .CustomLogo, .SiteIcon, .ThemeMods, .CustomCSS, .Theme, .ThemeURI, .Data
İçerik.Posts, .Post, .TotalPosts, .TotalPages, .Pagination, .PostNav, .ArchiveTitle, .ArchiveDesc, .SearchQuery, .SearchAction, .SearchHidden, .Comments, .PrivacyLink, .CanPublish
Gezinme ve widget'lar.Menus (konum başına öğeler: .ID, .Label, .URL, .Target, .Classes, .Children, .Current…), .HasMenus, .PrimaryMenu, .SocialMenu, .Areas, .Sidebar1, .ContentBottom
Bir yazı.ID, .Title, .Permalink, .Content, .Excerpt, .ShowExcerpt, .Class, .EntryMeta, .EditLink, .Date, .DateText, .DateISO, .AuthorName, .AuthorURL, .Categories, .Tags, .Thumbnail, .ThumbnailURL, .CommentCount, .Post (ham kayıt)
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

FonksiyonNe yapar
safe, safeURL, safeAttrbir dizgeyi güvenilir HTML / URL / öznitelik olarak işaretler
kses skullanıcının yazdığı HTML için wp_kses_post()
date t formatzamanı sitenin saat diliminde WordPress biçimiyle biçimler; "" sitenin tarih biçimini kullanır
setting, settingStr, settingBool, settingInt, settingIDbir seçeneği okur
plural, num, add, sub, seq, dictsayılar, aralıklar, parçalara geçirilecek map'ler
list, split, contains, lower, ucfirst, repeat, trimSlash, texturize, query, json, versiondizge ve kodlama yardımcıları
__, _e, esc_html__, esc_attr__, _x, _n…ç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

theme.json, bir Go temasının kodla kaydedeceği her şeyi tanımlar. Bilinmeyen alanlar reddedilir.

Metadata

AlanZorunluKurallar
slugevet^[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
nameevetTemalar ekranında gösterilir
versionevetsemver
description, author, author_url, theme_urlhayırTemalar ekranı ve pazar yeri; URL'ler http(s)
tagshayırpazar yeri filtreleri (blog, dark, one-column, …)
requires_corehayıren düşük Pursae sürümü (çalışan sürümden yeni olamaz)
screenshothayırassets/ altında bir dosya, genelde screenshot.png

Yapı

AlanKaydettiğ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
menu_locations[]register_nav_menus(): id, name. Görünüm › Menüler'den atanır
page_templatesSayfa 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

AlanAnlamı
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_stylestrue: ç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

AlanAnlamı
palette[]editor-color-palette: name, slug, color; ayrıca --wp--preset--color--<slug> olarak basılır
supportstitle-tag, custom-logo, post-thumbnails, html5, responsive-embeds, align-wide, wp-block-styles, custom-spacing, custom-line-height
customizer.sections[]id, title, priority, settings[] (bkz. Özelleştirici)

Kütüphane metadata'sı

AlanAnlamı
categorysabit bir listeden biri (blog, magazine, portfolio, shop, restaurant, … 40 değer)
stylekütüphane kartındaki kısa ifade (en fazla 80 karakter, tek satır, işaretlemesiz)
demodemo içerik dosyası, demo/ altında bir .json
web_builderWeb Builder parça dosyası, web-builder/ altında bir .json

REST themes uç noktası bunları category, style ve has_demo olarak bildirir.

Stiller ve betikler

Paket varlıklarını theme.json üzerinden yükler; çekirdek etiketleri wp_head() ve wp_footer() içinde bağımlılık sırasıyla, ?ver=<tema sürümü> ekiyle basar.

"styles": [
  {"handle": "starter-fonts", "src": "https://fonts.example.com/inter.css"},
  {"handle": "starter-style", "src": "assets/style.css", "deps": ["starter-fonts", "wp-block-library"], "media": "all"},
  {"handle": "starter-print", "src": "assets/print.css", "media": "print"}
],
"scripts": [
  {"handle": "starter-nav", "src": "assets/js/navigation.js", "in_footer": true},
  {"handle": "starter-gallery", "src": "assets/js/gallery.js", "deps": ["jquery"], "in_footer": true}
],
"editor_styles": ["assets/editor-style.css"],
"preload_fonts": ["assets/fonts/inter-var.woff2"]
AlanAnlamı
handleetiket id'si: <handle>-css, <handle>-js; desen ^[a-z0-9]+([_-][a-z0-9]+)*$, liste içinde benzersiz
srcpaket 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
mediaall (varsayılan), print, screen and (min-width: …)
in_footerbetiğ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ı

HandleNe
wp-block-libraryblok kütüphanesi stil sayfası; block_styles açık değilse her sayfada
dashiconsikon fontu (yönetim çubuğuyla yüklenir)
jquery/wp-includes/js/jquery/ altından jQuery
comment-replyiç içe yanıtlar; çekirdek bunu iç içe yorumlu tekil sayfalarda kendisi ekler

wp_head'in sırayla bastıkları

  1. temanın head_top'u (yalnızca gömülü temalar),
  2. robots, besleme bağlantıları, giriş yapmış kullanıcılar için yönetim çubuğu stilleri,
  3. blok kütüphanesi stil sayfası ve satır içi tema/global stiller (block_styles ile: yalnızca kullanılan blokların stilleri),
  4. sizin preload_fonts[], styles[] ve head scripts[]'leriniz, ardından Özelleştirici css_var özellikleri,
  5. rel="https://api.w.org/", generator meta, canonical ve shortlink,
  6. özel arka plan, site ikonu, Ek CSS,
  7. 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).

Blok editörü desteği

Blok editörü temanın neleri desteklediğini /wp-json/wp/v2/themes?status=active adresine sorar ve tuvalini buna göre biçimlendirir.

"supports": {
  "title-tag": true,
  "post-thumbnails": true,
  "custom-logo": {"width": 240, "height": 80, "flex-width": true, "flex-height": true},
  "html5": ["search-form", "comment-form", "gallery", "caption", "style", "script"],
  "responsive-embeds": true,
  "align-wide": true,
  "wp-block-styles": true,
  "custom-spacing": true,
  "custom-line-height": true
}
AnahtarEtkisi
title-tag<title>'ı çekirdek basar; her zaman açık, uyumluluk için tutulur
post-thumbnailsÖne Çıkan Görsel paneli; .Thumbnail doldurulur
custom-logoSite Kimliği'nde logo kontrolü; .CustomLogo işler (ayarlanmadıkça açık)
html5listelenen parçalar için HTML5 işaretlemesi
responsive-embedswp-embed-responsive body sınıfı ve en-boy oranı CSS'i
align-wideGeniş 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-heightpadding/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.

Özelleştirici

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.

"customizer": {
  "sections": [
    {"id": "starter_layout", "title": "Layout", "priority": 40, "settings": [
      {"id": "content_width", "label": "Content width", "type": "radio", "default": "normal",
       "choices": {"narrow": "Narrow", "normal": "Normal", "wide": "Wide"}},
      {"id": "show_sidebar", "label": "Show sidebar", "type": "checkbox", "default": true, "body_class": "has-sidebar"},
      {"id": "footer_text", "label": "Footer text", "type": "textarea", "default": ""}
    ]},
    {"id": "starter_colors", "title": "Theme colors", "settings": [
      {"id": "accent", "label": "Accent", "type": "color", "default": "#2271b1", "css_var": "--accent", "transport": "postMessage"}
    ]}
  ]
}
Ayar alanıAnlamı
idtema modu adı (tema genelinde benzersiz; custom_logo ve custom_css çekirdeğindir)
label, descriptionkontrol
typecolor (#rrggbb), text, textarea, number, checkbox, select / radio (choices ile), image (ek id'si)
defaultkullanıcı kaydedene kadar kullanılır; türle uyumlu olmalı
transportrefresh (varsayılan) veya canlı önizleme için postMessage (image için değil)
css_vardeğeri :root üzerinde özel özellik olarak basar (--accent: #2271b1)
body_classdeğ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.

Tema Dosya Düzenleyicisi

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).

Tema paketi formatı

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.
  • Bölümler: version (1), options (yalnızca blogname, blogdescription, posts_per_page, date_format), categories, tags, media, pages, posts, menus, widgets, customizer.
  • İç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.

Belirtim: docs/theme-package.md

Tema kütüphanesi

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.

TemaKategoriTarz
AppNest (appnest)startupTelefon maketleri ve mağaza butonlarıyla mobil uygulama tanıtım sitesi
Archform (archform)architectureTek 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)educationMor, mercan ve nane tonlarında cesur neo-brütalist kurs sitesi
Aurum & Pearl (aurum-and-pearl) · MağazashopSakin lüks mücevher, fildişi ve altın
Bean There (bean-there)restaurantNane vurgulu espresso kafe, menü panosu ve demleme rehberleri
Bright Smile Dental (bright-smile)healthTaze akuamarin ve beyaz, yuvarlak ve eğlenceli
Byte Notes (byte-notes)technologyKod bloklu, öncelikle koyu geliştirici blogu
Campfire (campfire) · ForumpersonalSıcak bir üretici topluluğu forumu, kâğıt üzerinde köz ve yosun
Campus Commons (campus-commons)educationOkullar ve çevrim içi kurslar için samimi akademik tema, lacivert ve hardal
Cloudline (cloudline)technologySLA rakamları ve duyurularla net mavi BT hizmetleri sitesi
Crumb & Crust (crumb-and-crust)foodParlak tarif blogu, yuvarlak kartlar, mercan ve tereyağı sarısı
Datafield (datafield)scienceŞekil ve dipnotlu, grafik esintili araştırma defteri
Devboard (devboard) · ForumtechnologyKod stilli ve istatistik kenar çubuklu yoğun geliştirici soru-cevap panosu
Dog-Ear Books (dog-ear-books) · MağazashopBağımsız kitapçı, gazete başlığı ve raflar
Driftwood Inn (driftwood-inn)hotelButik sahil oteli, kumlu nötrler ve okyanus mavisi, ferah serif
Encore (encore)musicNeon vurgulu karanlık sahne
Ever After (ever-after)weddingPudra ve adaçayı tonlarında serif ve el yazısı tipli romantik düğün sitesi
Evergreen Care (evergreen-care)healthRandevu çağrılı, yumuşak camgöbeği ve beyaz sakin klinik sitesi
Faithful Commons (faithful-commons)religionKemerli pencereli, yumuşak taş ve altın tonlarında misafirperver ibadet yeri
Fernwood (fernwood) · Mağaza · WBhomeBotanik bitki dükkânı, orman yeşili ve kiremit
Frame by Frame (frame-by-frame)entertainmentKâğıt, mürekkep ve festival altını tonlarında sinematik letterbox dergi
Gearhead Garage (gearhead-garage)automotiveKarbon siyahı ve yarış kırmızısı oto atölyesi, açılı kenarlar, dar büyük harfler
Glow Botanica (glow-botanica) · MağazashopYumuşak cilt bakımı butiği, pudra karolar ve kemerler
Good Boy Supply (good-boy-supply) · Mağaza · WBpetsEğlenceli evcil hayvan dükkânı, lacivert ve güneş sarısı
Green Basket (green-basket) · MağazashopSamimi 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)shopKraft kâğıt üzerinde organik çiftlik dükkânı, taze yeşiller ve el yazısı etiketler
Guild Hall (guild-hall) · Forum · WBgamingKoyu mor üzerinde limon yeşili ve macenta, karanlık oyun topluluğu merkezi
Headline Daily (headline-daily)magazineYoğun haber ön sayfası, kırmızı ve siyah
Hearth & Herb (hearth-and-herb)foodRustik ev yemekleri, ot yeşili ve ahşap, yazdırılabilir tarifler
Ink & Needle (ink-and-needle)beautyBlackletter ve kan kırmızısıyla siyah ve kemik rengi dövme stüdyosu
Inkwell (inkwell)blogBü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)legalBordo ve antrasit, Caslon serif, altın ince çizgiler
Keystone Estates (keystone-estates)real-estateTemiz ajans, orman yeşili ve taş, arama odaklı hero
Kiln & Loom (kiln-and-loom) · MağazashopSıcak editoryal el sanatları pazarı, kiremit ve çivit
Kite & Crayon (kite-and-crayon) · Mağaza · WBkidsParlak çocuk oyuncak dükkânı, krem üzerinde domates ve nane
Launchpad (launchpad)startupGradyan ağlı hero ve değişiklik günlüğüyle SaaS açılış sayfası
Ledger & Co. (ledger-co)businessKurumsal lacivert ve arduvaz, serif başlıklar, pirinç vurgu
Little Sprouts (little-sprouts)kidsNeşeli ana renkler, yuvarlak şekiller ve dalgalı kenarlar
Lumen Folio (lumen-folio)photographyKoyu, kenardan kenara masonry galeri
Nest & Nook (nest-and-nook)homeFerah nötr iç mekânlar, masonry odalar, önce/sonra ve görünümü satın al
Northstar Ventures (northstar-ventures)financeKoyu lacivert ve gümüş, serif makaleli girişim sermayesi firması
Numera (numera)financeSakin mavi-yeşil, net tablolar, samimi geometrik sans
Oak & Form (oak-and-form) · MağazashopFerah İskandinav mobilya, keten ve meşe
Open Hands (open-hands)nonprofitEtki rakamları ve bağış butonlarıyla sıcak, umutlu yardım kuruluşu sitesi
Pageturner (pageturner)booksCaslon yazı, bordo mürekkep ve kitap kapağı rafıyla edebi yazar sitesi
Paper Lantern (paper-lantern)personalKrem kâğıt üzerinde sıcak, el yazısı günlük
Paws & Whiskers (paws-and-whiskers)petsTuruncu ve camgöbeği, yuvarlak ve eğlenceli samimi veteriner kliniği
Peak Athletics (peak-athletics) · MağazashopEnerjik spor ekipmanı, karbon ve volt
Petal & Stem (petal-and-stem)shopBuket kataloglu botanik çiçekçi, şakayık ve yosun
Pixel Arcade (pixel-arcade)gamingPiksel yazı ve neon skorlarla retro-fütüristik koyu arayüz
Podwave (podwave)podcastDalga formlarıyla parlak, yuvarlak program sitesi, mor ve mercan
Pulse Fit (pulse-fit)fitnessYüksek enerjili koyu spor salonu, elektrik yeşili, kalın dar yazı
Quiet Hours (quiet-hours)minimalEş aralıklı, yalnızca metin, açık ve koyu
Roast & Ritual (roast-and-ritual) · MağazashopSıcak kahve kavurucusu, paket etiketi kartları ve damgalar
Studio Fizz (studio-fizz)agencyCesur, renkli ve eğlenceli
Study Circle (study-circle) · Forum · WBeducationBeyaz üzerinde camgöbeği ve güneş sarısı, samimi çalışma grubu forumu
Sugar & Saffron (sugar-and-saffron)foodPastel pastane blogu, el yazısı ve serif yazı, kemerli fotoğraflar
Summit Trails (summit-trails)sportsTopografik kontürlerle yürüyüş kulübü, arduvaz ve alp turuncusu
Threadline (threadline) · MağazashopMinimal giyim butiği, serif ve kum
Trattoria (trattoria)restaurantSıcak kiremit tonlu trattoria, klasik serif, fiyat noktalı menü
Velvet Runway (velvet-runway)fashionEditoryal serif dergi, sade lüks
Velvet Salon (velvet-salon)beautyGül kurusu ve şampanya tonlarında, kemerli görselli kuaför ve güzellik salonu
Voltage (voltage-store) · MağazashopKoyu elektronik mağazası, büyük arama ve parlayan kartlar
Wanderline (wanderline)travelAfiş yazısı ve gün batımı renkleriyle maceracı seyahat günlüğü

Kaynaklar: library/themes

Forum temaları (Pursae Forum)

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ımYazdığınızKazandığınız
1. Hiçbir şey—forum, kendi forum.css'iyle page.html zincirinizde
2. Renk ve yazıstyle.css içinde --pf-* belirteçleriher 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.htmlforum görünümleri için kendi düzeniniz; forum kendi başlığını ve içerik yolunu basar
4. Tema widget'larıforum_user_menu, forum_recent_topics, forum_stats, forum_urlheader'da Giriş / Katıl, ana sayfada son konular
5. Görünüm geçersiz kılmalarıtemplates/forum/<view>.htmlbir görünüm için kendi işaretlemeniz
6. Demodemo/demo.json içinde bir "forum" bölümütek tıkla üyeler, forumlar, konular ve yanıtlar
  • Forum sayfası sentetik bir sayfadır (.Q.Kind page, 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.

Genel bakış ve mimari

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.

┌──────────── Pursae ────────────┐      ┌──── plugin.wasm (sandbox) ────┐
│ the_content ──► hooks ───────────────┼─────►│ wpgo.AddFilter("the_content") │
│ [tag] ───────► shortcodes ───────────┼─────►│ wpgo.AddShortcode("tag")      │
│ /wp-json/<slug>/v1/… ► REST routes ──┼─────►│ wpgo.RegisterRestRoute(...)   │
│ Settings › Plugin ◄── settings page ─┼──────┤ wpgo.RegisterSettingsPage()   │
│ jobs table ───► cron_* actions ──────┼─────►│ wpgo.ScheduleEvent(...)       │
│ options, posts, users, storage,      │◄─────┤ wpgo.GetOption, GetPost, …    │
│ transients, HTTP, notices, assets    │      │ (each needs a permission)     │
└──────────────────────────────────────┘      └───────────────────────────────┘

Neden WebAssembly

  • 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)AddFilter("the_content", …), AddFilter("the_title", …)content:filter
Açılışta veya yönetim ekranlarında kod çalıştırmakAddAction("init", …), AddAction("admin_notices", …)— / admin:notices
Kısa kodlar [tag attr="v"]…[/tag]AddShortcodecontent:filter
/wp-json/<slug>/v1/ altında REST uç noktalarıRegisterRestRouterest:routes
Yazı okumak ve yazmakGetPost, QueryPosts, InsertPost, UpdatePostposts:read, posts:write
Kimin oturum açtığını bilmekCurrentUserusers:read
Zamanlanmış görevlerScheduleEvent, AddAction("cron_…")cron
Ayarlar altında bir ayar sayfasıRegisterSettingsPage, Setting*admin:settings, options:read
Seçenekler (options)GetOption, UpdateOptionoptions:read, options:write
Özel veri ve önbelleklerStorage, Transientsstorage
Dışa giden HTTP GETHTTPGethttp:outbound
Sitede veya yönetimde CSS ve JSEnqueueStyle, EnqueueScript + paketteki assets/content:filter
Pano bildirimleriAdminNoticeadmin:notices
Yönetim sayfaları, Pano bileşenleri, meta kutularıRegisterAdminPage, RegisterDashboardWidget, RegisterMetaBoxadmin:pages, admin:dashboard, admin:metaboxes
Dinamik bloklar, Web Builder bileşenleriRegisterBlock, RegisterBuilderWidgetblocks:register, builder:widgets

İmzalama ve güven

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.

Kaynak: docs/developer/plugins/index.md, çalışma zamanı ayrıntıları internal/plugins/README.md.

İlk eklentiniz

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.

4. Derleyin

GOOS=wasip1 GOARCH=wasm CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -buildmode=c-shared -o plugin.wasm .
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|verify wpgo-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.

Manifest: plugin.json

plugin.json paketin kökünde durur. Bilinmeyen alanlar reddedilir; böylece bir yazım hatası bir izni sessizce düşüremez.

{
  "slug": "gopher-facts",
  "name": "Gopher Facts",
  "version": "1.2.0",
  "description": "Random gopher facts as a shortcode and a REST route.",
  "author": "Gopher Co.",
  "author_uri": "https://example.com",
  "plugin_uri": "https://example.com/gopher-facts",
  "requires": "0.1.0",
  "license": "GPL-2.0-or-later",
  "permissions": ["content:filter", "rest:routes", "options:read", "admin:settings"],
  "hooks": ["the_content", "cron_gopher_facts_refresh"],
  "shortcodes": ["gopher-facts"],
  "assets": {"style.css": "3f1a…"}
}
AlanZorunluKurallar
slugevet2–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
nameeveten fazla 100 karakter
versionevet1.2.3 veya 1.2.3-beta.1; Hub sonuncudan yeni olmayan sürümü reddeder
descriptionhayıren fazla 2000 karakter, düz metin
author, author_uri, plugin_urihayırURI'ler mutlak http(s) URL olmalı
requireshayırasgari Pursae sürümü; daha yeni çekirdek gerektiren eklenti kurulumda ve etkinleştirmede reddedilir
requires_pluginshayı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
licensehayırbir SPDX tanımlayıcısı
permissionsevet (boş olabilir)izin sözlüğünden; tekrar yok
hooksevet (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
shortcodeshayırkaydedilebilecek her etiket (^[a-z0-9_-]{1,64}$); content:filter gerektirir
assetswpgo-pkg pack doldururyol → 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:

plugin.json has 2 problems:
  - hook "the_content" requires the "content:filter" permission; add it to "permissions"
  - unknown permission "posts:all" (known: admin:dashboard, admin:metaboxes, admin:notices, admin:pages, admin:scripts, admin:settings, blocks:register, builder:widgets, commerce:orders, content:filter, content:html, cron, forms:access, headless:entries, http:outbound, mail:send, options:read, options:write, posts:read, posts:write, rest:routes, storage, users:read)

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.

İzinler

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).

İzinYöneticiye gösterilenAçtığı yetenekler
options:readRead site optionsGetOption 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:writeCreate 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:readRead posts and receive post data from post lifecycle hooksGetPost, QueryPosts; save_post, save_post_*, wpgo_post_stats hook'ları ve ayrılmış yazı yaşam döngüsü adları
posts:writeCreate and change postsInsertPost, UpdatePost; ayrılmış wp_insert_post_data, wp_insert_attachment_data, pre_post_update, content_save_pre, title_save_pre, excerpt_save_pre
users:readSee who the current user isCurrentUser
forms:accessSee what visitors submit in contact forms and decide what counts as spamYorum hook'ları preprocess_comment, pre_comment_approved, comment_post; gizlilik hook'ları pursae_personal_data_export / pursae_personal_data_erase; Pursae Contact Form wpcf7_* (wpcf7_mail_sent, wpcf7_spam, wpcf7_validate ve wpcf7_before_send_mail filtreleri)
headless:entriesSee Pursae Headless entries as they are saved, published and deleted, and validate or derive their valuesheadless_entry_validate, headless_entry_saved, headless_entry_published, headless_entry_unpublished, headless_entry_deleted
content:filterModify content shown to visitorsthe_*, comment_text, widget_text, widget_title, get_the_excerpt, wp_title, document_title_parts, body_class, post_class hook'ları; AddShortcode; EnqueueStyle, EnqueueScript. Eklenen HTML KSES'ten (wp_kses_post) geçer
content:htmlShow unfiltered HTML and scripts to visitors (sitenin tam kontrolü)Temizlenmemiş kısa kod ve içerik filtresi çıktısı; ön yüzde EnqueueScript. Varsayılan olarak işaretli değil
admin:scriptsRun code in the admin (sitenin tam kontrolü)wpgo.Admin veya wpgo.Both ile EnqueueScript; her yönetim ekranında stiller. Varsayılan olarak işaretli değil
rest:routesAdd REST API endpointsRegisterRestRoute
admin:settingsAdd a settings page to the adminRegisterSettingsPage; yönetimde EnqueueStyle (yalnızca eklentinin kendi ayar sayfasında)
admin:noticesShow notices in the admin dashboardadmin_notices hook'u (ve all_admin_notices, …); AdminNotice
cronRun scheduled taskscron_*, wpgo_cron* hook'ları; ScheduleEvent, ScheduleSingleEvent, UnscheduleEvent
storageStore private plugin dataStorage, Transients
http:outboundMake outbound HTTP requestsHTTPGet, HTTPRequest
mail:sendSend e-mail from the siteSendMail
admin:pagesAdd pages to the admin menuRegisterAdminPage; admin:scripts yoksa çıktı temizlenir
admin:dashboardAdd widgets to the DashboardRegisterDashboardWidget
admin:metaboxesAdd boxes to the post edit screen and see what is typed into themRegisterMetaBox; alanlar plugin_<slug>_* yazı metası olarak saklanır
blocks:registerAdd blocks to Pursae Editor and render them for visitorsRegisterBlock; content:html yoksa çıktı temizlenir
builder:widgetsAdd widgets to Pursae Web Builder and render them for visitorsRegisterBuilderWidget
commerce:ordersSee store orders: customers' names, addresses and what they boughtwoocommerce_* hook'ları: woocommerce_new_order, woocommerce_order_status_changed, woocommerce_payment_complete

Log, init veya sözlüğün sınıflandırmadığı hook'lar için izin gerekmez.

Eklentinin okuyabildiği seçenekler

Kendi <slug>_* (tireler alt çizgi olur) ve plugin_<slug>_* seçenekleri, artı şu herkese açık çekirdek seçenekleri: blogname, blogdescription, siteurl, home, WPLANG, timezone_string, gmt_offset, date_format, time_format, start_of_week, use_smilies, default_category, default_post_format, posts_per_page, posts_per_rss, rss_use_excerpt, show_on_front, page_on_front, page_for_posts, blog_public, default_ping_status, default_comment_status, require_name_email, comment_registration, close_comments_for_old_posts, close_comments_days_old, show_comments_cookies_opt_in, thread_comments, thread_comments_depth, page_comments, comments_per_page, default_comments_page, comment_order, show_avatars, avatar_rating, avatar_default, görsel boyutu seçenekleri (thumbnail_size_w … large_size_h, thumbnail_crop), uploads_use_yearmonth_folders, permalink_structure, category_base, tag_base, template, stylesheet, sticky_posts, wp_page_for_privacy_policy, site_icon, users_can_register, blog_charset, html_type.

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.

Hook'lar

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.

wpgo.AddFilter("the_content", 20, func(ctx wpgo.Context, content string, args []any) string { … })
wpgo.AddAction("admin_notices", wpgo.DefaultPriority, func(ctx wpgo.Context, args []any) { … })

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

HookTürDeğer / argümanlarİzin
the_contentfiltreRender edilmiş yazı HTML'i (bloklar, autop ve kısa kodlardan sonra); argüman post: {"id", "type", "is_single"} (arşivlerde is_single false)content:filter
the_titlefiltreBaşlık HTML'i (kaçışlı, texturize edilmiş); argüman {"id", "type"}. content:html yoksa eklemeler temizlenircontent:filter
wp_head, wp_footerfiltreO ana kadar basılan işaretleme; eklemelerinizle döndürün (content:html yoksa temizlenir)content:filter
admin_noticesaksiyonArgüman yok; bildirimleri wpgo.AdminNotice ile kuyruğa alınadmin:notices
wpgo_post_statsfiltreKlasik editörün yayımla kutusundaki istatistikler (map[string]any); argüman post: {"id", "title", "content"}posts:read
wpcf7_mail_sentaksiyonTek bir map: contact_form_id, title, posted_data; e-posta gönderildikten sonraforms:access
wpcf7_spamfiltreSpam kararı (bool); argümanlar contact_form_id, posted_data, remote_ip, user_agentforms:access
preprocess_commentfiltreGönderilen yorum {"post_id", "parent", "user_id", "author", "email", "url", "content", "ip", "user_agent"}; author, email, url, content değiştirilebilirforms:access
pre_comment_approvedfiltreKarar approved, pending, spam veya trash (ya da 1 / 0); argüman: yorumforms:access
comment_postaksiyonYorum kimliği, son durum, yorum nesnesiforms:access
pursae_personal_data_exportfiltreGrup listesi {"group_id", "group_label", "group_description", "items"}; kendi grubunuzu ekleyin. Argüman: e-posta adresiforms:access
pursae_personal_data_eraseaksiyonE-posta adresi; sakladığınız veriyi silin veya anonimleştirinforms:access
user_register, wp_loginaksiyonKullanıcı kimliği ve CurrentUser'ın döndürdüğü biçimde kullanıcıusers:read
image_editor_output_formatfiltreKaynak MIME → çıktı MIME eşlemesi (ör. {"image/jpeg": "image/webp"}); argümanlar: dosya adı, MIME türü—
pursae_media_replacedaksiyonEk kimliği ve {"id", "url", "old_url", "new_url", "file", "mime_type", "original_name"}—
pursae_media_focal_pointaksiyonEk kimliği ve {"id", "url", "focal_point"}—
save_post_<type>, ardından save_postaksiyonYazı kimliği ve yazı (GetPost biçiminde); yalnızca yazı ve sayfalarposts:read
transition_post_statusaksiyonYeni durum, eski durum (yeni yazıda "new"), yazıposts:read
trashed_post, untrashed_post, before_delete_post, deleted_postaksiyonYazı kimliği, yazıposts:read
woocommerce_new_order, woocommerce_payment_completeaksiyonSipariş kimliği, sipariş {id, status, currency, total, customer_id, payment_method, billing, shipping, items, date_created}commerce:orders
woocommerce_order_status_changedaksiyonSipariş kimliği, eski durum, yeni durum, siparişcommerce:orders
headless_entry_validatefiltre{"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çeheadless:entries
headless_entry_saved, _published, _unpublished, _deletedaksiyon{"event", "type", "documentId", "locale", "status", "entry"}headless:entries

Yaşam döngüsü hook'ları

HookNe zamanİzin
initAçılışta tüm etkin eklentiler yüklendikten sonra; etkinleştirme, güncelleme veya başka bir örnek tarafından yüklemeden sonra yalnızca o eklenti için—
activateYönetici eklentiyi etkinleştirdiğinde (wpgo.OnActivate)—
deactivateEklenti kaldırılmadan önce (wpgo.OnDeactivate); 5 sn bütçe—
uninstallEklenti 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 tetiklenircron

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.

İzinHook adları
content:filterthe_ ile başlayan her şey, comment_text, widget_text, widget_title, get_the_excerpt, wp_title, document_title_parts, body_class, post_class
posts:readsave_post, save_post_<type>, wp_insert_post, publish_post, transition_post_status, before_delete_post, deleted_post, trashed_post, untrashed_post, post_updated, wpgo_post_stats
posts:writewp_insert_post_data, wp_insert_attachment_data, pre_post_update, content_save_pre, title_save_pre, excerpt_save_pre
admin:noticesadmin_notices, all_admin_notices, network_admin_notices, user_admin_notices
croncron_ veya wpgo_cron ile başlayan her şey
headless:entriesheadless_entry_ ile başlayan her şey
commerce:orderswoocommerce_ ile başlayan her şey

Bilinmesi gereken davranışlar

  • 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.
  • Türler korunur: string filtresi string, wpgo_post_stats bir JSON nesnesi döndürmelidir. Hook'lar isteğin kullanıcısıyla tetiklenir; cron callback'leri kullanıcı görmez.

Host API

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.

SDKHost importİzin
AddFilter, AddActionadd_hookhook'unki
OnInit(fn)—kayıtlar gönderildikten sonra çalışır
Log(level, msg), Logflogyok (düzeyler debug, info, warning, error)
GetOption, GetOptionJSON, OptionBoolget_optionoptions:read
UpdateOption(name, value)update_optionoptions:write
GetPost(id), QueryPosts(PostQuery)get_post, query_postsposts:read
InsertPost(PostInput), UpdatePost(id, PostInput)insert_post, update_postposts:write
CurrentUser() (anonim ve cron'da nil)get_current_userusers:read
AddShortcode(tag, fn)register_shortcodecontent:filter + manifestte etiket
RegisterRestRoute, RegisterRestRouteWithHeadersregister_rest_routerest:routes
RegisterSettingsPage, Setting, SettingString/Bool/Float, SettingNameregister_settings_page, get_optionadmin:settings, options:read
EnqueueStyle, EnqueueScriptenqueue_style, enqueue_scriptcontent:filter (+ admin:settings, content:html / admin:scripts)
RegisterAdminPage, RegisterDashboardWidget, RegisterMetaBox, RegisterBlock, RegisterBuilderWidgetregister_admin_page, register_dashboard_widget, register_meta_box, register_block, register_builder_widgetadmin:pages, admin:dashboard, admin:metaboxes, blocks:register, builder:widgets
ScheduleEvent, ScheduleSingleEvent, UnscheduleEvent, UnscheduleEventArgsschedule_event, unschedule_eventcron (+ manifestte hook)
Storage.Get/Set/Delete/Liststorage_get, storage_set, storage_delete, storage_liststorage
Transients.Get/Set/Deletetransient_get, transient_set, transient_deletestorage
HTTPGet(url), HTTPRequest(HTTPRequestArgs{…})http_get, http_requesthttp:outbound
SendMail(Mail{To, Subject, Body, HTML, ReplyTo})send_mailmail:send
AdminNotice(kind, message)add_admin_noticeadmin:notices
T(text), X(text, context)translateyok

Ayrıntılar

  • 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.
p, err := wpgo.InsertPost(wpgo.PostInput{
	Title:   wpgo.String("Weekly digest"),
	Content: wpgo.String("<p>…</p>"),
	Status:  wpgo.String("publish"),
	Meta:    map[string]any{"digest_week": 43},
})

ABI (sürüm 1)

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İmzaAmaç
_initialize() -> ()dil çalışma zamanı başlatma (Go: paket init'leri)
wpgo_init() -> ()_initialize'dan sonra bir kez; hook'ları add_hook ile kaydeder
wpgo_alloc(size i32) -> i32host'un yazacağı tampon ayırır
wpgo_free(ptr, size i32)wpgo_handle'ın döndürdüğü tamponu serbest bırakır
wpgo_handle(ptr, len i32) -> i64bir callback çalıştırır; paketlenmiş yanıt döner

Host'un wpgo_handle'a gönderdiği istek:

{"plugin":"slug","callback":"…","hook":"the_content","type":"filter","args":[…],"value":…}

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:

{"ok":true,"result":…}
{"ok":false,"code":"permission_denied|invalid_request|host_error","error":"…"}

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.

Tam istek/sonuç tablosu: docs/developer/plugins/abi.md.

REST rotaları

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). HEAD GET 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
MethodX-HTTP-Method-Override / _method işlendikten sonra
Routeeşleşen yol, ör. /shortcode-demo/v1/facts/7
Paramsadlandırılmış gruplar; req.Param("id")
QueryURL sorgu parametreleri, her birinin ilk değeri (tümü için req.QueryAll)
HeadersAccept, Content-Type, Accept-Language, User-Agent, Referer, Origin, X-Requested-With
BodyJSON 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.

curl http://localhost:8088/wp-json/shortcode-demo/v1/facts
curl -u admin:'xxxx xxxx xxxx xxxx xxxx xxxx' -H 'Content-Type: application/json' \
     -d '{"fact":"Gophers read JSON."}' http://localhost:8088/wp-json/shortcode-demo/v1/facts

Webhook alıcıları ve JSON olmayan yanıtlar

  • 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.

Ayar sayfaları

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.

wpgo.RegisterSettingsPage(wpgo.SettingsPage{
	PageTitle:   "Gopher Facts",
	MenuTitle:   "Gopher Facts",
	Description: "Options of the Gopher Facts plugin.",
	Fields: []wpgo.SettingsField{
		{ID: "heading", Label: "Heading", Type: "text", Default: "Did you know?", Placeholder: "Shown above the list"},
		{ID: "count", Label: "Facts per page", Type: "number", Default: 3, Min: ptr(1), Max: ptr(10)},
		{ID: "greet", Label: "Greet logged-in readers", Type: "checkbox", Default: true,
			Description: "Adds a personal greeting."},
		{ID: "style", Label: "List style", Type: "select", Default: "cards",
			Options: []wpgo.SettingsOption{{Value: "cards", Label: "Cards"}, {Value: "plain", Label: "Plain list"}}},
		{ID: "footer", Label: "Footer note", Type: "textarea", Rows: 3},
	},
})
TürKaydedilen biçimEk
textstringPlaceholder
textareastring (CRLF normalleştirilir, ≤64 KiB)Rows, Placeholder
numberJSON sayıMin, Max (sınırlanır), Placeholder
checkboxtrue / falseDescription etiket olur
select, radiostring; Options dışındaki değerler yok sayılırOptions (1–100)
emailgeçerli adres veya ""Placeholder
urlhttp(s) URL veya ""Placeholder
passwordasla geri basılmaz; boş girdi saklanan değeri korurPlaceholder
color#rgb, #rrggbb, #rrggbbaa veya ""—
dateYYYY-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.

Zamanlanmış olaylar

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.

const refresh = "cron_gopher_facts_refresh"

func init() {
	wpgo.AddAction(refresh, wpgo.DefaultPriority, func(_ wpgo.Context, args []any) {
		payload, _ := args[0].(map[string]any)      // {"plugin": "...", "args": {...}}
		// fetch, compute, store…
		_ = wpgo.Transients.Set("facts", fetchFacts(), 2*time.Hour)
	})
	wpgo.OnInit(func() {
		_ = wpgo.ScheduleEvent(refresh, time.Hour, map[string]any{"source": "api"})
	})
}
FonksiyonEtki
ScheduleEvent(hook, interval, args)Her interval'da bir (≥1 dakika, ≤1 yıl), ilk çalışma bir aralık sonra. Aynı aralık ve argümanlar mevcut planı korur; farklıları onu değiştirir
ScheduleSingleEvent(hook, at, args)at anında bir kez (sıfır = mümkün olan en kısa sürede; en fazla bir yıl ileri). Hook ve argümanlara göre anahtarlanır
UnscheduleEvent(hook)Eklentinin o hook için tüm çalışmalarını kaldırır
UnscheduleEventArgs(hook, args)Yalnızca tam olarak bu argümanlarla planlananları kaldırır
  • args (≤64 KiB JSON) "args" altında gelir. Çalışmaların isteği ve kullanıcısı yoktur; cron'dan oluşturulan yazıların yazarı olmaz.
  • Başarısız çalışma günlüğe yazılır ve eklenti hatası sayılır; olay planlı kalır. Aynı adı dinleyen başka bir eklenti onu asla almaz.
  • Devre dışı eklentinin olayları atlanır; eklentiyi silmek olaylarını, seçeneklerini ve transient'larını kaldırır.
  • cron_* callback'inin 30 saniyesi vardır ve yavaş çağrı kuralından muaftır.
SELECT name, run_at, recurrence, payload FROM jobs WHERE name LIKE 'cron_%'

Kısa kodlar (shortcodes)

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.

Varlıklar (CSS ve JavaScript)

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.

KuralDeğer
Uzantılar.css .js .svg .png .jpg .jpeg .webp .woff2
Boyutdosya başına 2 MiB, paket başına 16 MiB ve 256 dosya
Yollarharf, rakam, ., -, _; hiçbir parça noktayla başlamaz; alt dizinlere izin var
Bütünlükwpgo-pkg pack her dosyanın SHA-256'sını plugin.json assets alanına yazar; kurucu listelenmemiş, eksik veya değiştirilmiş varlıkları reddeder
SunumCache-Control: public, max-age=604800, nosniff; SVG'lere sandbox CSP
func init() {
	wpgo.EnqueueStyle(wpgo.Style{Handle: "gopher-facts", Src: "style.css", Where: wpgo.Front})
	wpgo.EnqueueScript(wpgo.Script{Handle: "gopher-admin", Src: "js/admin.js", Where: wpgo.Admin, InFooter: true})
	wpgo.EnqueueScript(wpgo.Script{Handle: "gopher-widgets", Src: "js/widgets.js", Deps: []string{"gopher-core"}, Where: wpgo.Both})
}
AlanAnlamı
Handle^[a-z0-9_-]{1,64}$; etiket kimliği <slug>-<handle>-css / -js olur
Srcassets/ içindeki yol; stiller .css, betikler .js
Wherewpgo.Front (varsayılan), wpgo.Admin, wpgo.Both
Depsbu eklentinin aynı türden handle'ları (≤10)
Mediastil dosyasının media özniteliği, varsayılan all
InFooter</body> öncesine bas
Strategybetikler: "", "defer", "async"; boşsa ön yüz head betikleri için defer
Modulebetikler: type="module"
Databetikler: window.<handle>Data olarak basılan map (≤16 KiB JSON; my-plugin → myPluginData)

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.

NeSDKİzinSınır
Yönetim menüsünde sayfaRegisterAdminPage(AdminPage{…})admin:pages20
Pano kutusuRegisterDashboardWidget(id, title, cap, fn)admin:dashboard10
Yazı düzenleme ekranında kutuRegisterMetaBox(MetaBox{…})admin:metaboxes20
Pursae Editor bloğuRegisterBlock(Block{…})blocks:register50
Pursae Web Builder bileşeniRegisterBuilderWidget(BuilderWidget{…})builder:widgets50

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.

Pano bileşenleri, meta kutuları, bloklar

  • Pano bileşeni kutu kimliği plugin_<slug>_<id>; capability "" = read.
  • 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.
wpgo.RegisterMetaBox(wpgo.MetaBox{
	ID: "notes", Title: "Gopher Notes", Context: "side", PostTypes: []string{"post"},
	Fields: []wpgo.SettingsField{{ID: "subtitle", Label: "Subtitle", Type: "text"}},
	Render: func(ctx wpgo.Context, req wpgo.AdminRequest) string { return "<p>Shown above the fields.</p>" },
	OnSave: func(ctx wpgo.Context, postID int64, values map[string]any) { /* after the fields were stored */ },
})

Web Builder bileşenleri

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.

Tam örnek: examples/plugins/ui-demo.

Sınırlar ve sandbox

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.

AlanErişim
Dosya sistemiyok: 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ümanlaryok
Saat ve rastgelelikvar (time.Now, crypto/rand)
stdout / stderreklenti günlüğüne yakalanır
Diğer eklentilergörünmez; seçenekler, storage ve transient'lar slug'a göre kapsamlanır
SınırVarsayılan
Doğrusal bellek1024 sayfa = eklenti başına 64 MiB
Eşzamanlılıkeklenti başına aynı anda tek çağrı
Derlenmiş kodbellekte tutulur, açılışta yeniden derlenir
Hook, kısa kod callback'i2 sn
REST rota işleyicisi10 sn
cron_* callback'i30 sn
Örnekleme + wpgo_init10 sn
Sınırı geçen mesaj8 MiB
Yazı içeriği1 MiB; başlık 1000, özet 10 000, slug 200 karakter
REST gövdesi, HTTP yanıt gövdesi, storage/transient değeri1 MiB (anahtarlar 256 / 172 karakter)
Yönetim bildirimi2000 karakter
Ayar sayfası50 alan
Cron aralığı60 sn ile 1 yıl arası
Varlıklardosya 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.

Paketleme ve imzalama

Zip kökündeki dosyaZorunluSınır
plugin.jsonevet64 KiB
plugin.wasmevet64 MiB; -buildmode=c-shared ile derlenmiş WASI reactor
readme.mdhayır1 MiB; pazar yeri sayfasında gösterilir
icon.svghayır256 KiB; pazar yeri simgesi
assets/…hayırdosya başına 2 MiB, toplam 16 MiB
signaturesite imza istiyorsa1 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.

İmza

digest    = SHA-256("wpgo-plugin-v1\n" || u64be(len(plugin.json)) || plugin.json || u64be(len(plugin.wasm)) || plugin.wasm)
signature = base64(Ed25519.Sign(privateKey, digest)) + "\n"

Varlıklar plugin.json içindeki SHA-256'ları aracılığıyla kapsanır; readme.md ve icon.svg imzalanmaz (yalnızca görüntüleme amaçlı).

Sitenin kabul ettikleri

Site yapılandırmasıGüvenilen anahtarBilinmeyen anahtarİmzasız
varsayılan (anahtarlar tanımlı, plugin_allow_unsigned kapalı)kurulurreddedilirreddedilir
plugin_allow_unsigned açık, bazı güvenilen anahtarlar varkurulurreddedilirkurulur
plugin_allow_unsigned açık, hiç güvenilen anahtar yok—doğrulanmamış olarak kurulurkurulur
güvenilen anahtar yok, plugin_allow_unsigned kapalı—reddedilirreddedilir
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.

Test

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'a yayımlama

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.

  1. 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.
  2. 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).
  3. readme.md (kayıt sayfası olur) ve kare bir icon.svg ekleyin (yoksa yer tutucu üretilir).
  4. 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.

Örnek eklentiler

Depodaki examples/plugins/ altında; tools/build-plugins.sh bunları examples/plugins/dist/ içine derler.

EklentiGösterdiğiİzinler
hello-gopherhello_gopher_footer doğruysa tekil yazılara the_content altbilgisi; admin_notices'ta rastgele bir gopher cümlesioptions:read, content:filter, admin:notices
word-counterword_count ekleyen wpgo_post_stats filtresiposts:read
shortcode-demo (Gopher Facts)[gopher-facts], [recent-gophers], /wp-json/shortcode-demo/v1/ altında REST, Ayarlar › Gopher Facts, assets/style.css, transient'lar, cron_shortcode_demo_tickoptions:read, content:filter, rest:routes, posts:read, users:read, cron, admin:settings, storage
feed-digestSaatlik cron_feed_digest_refresh, HTTPGet ile bir JSON akışını transient'a alır; [feed-digest limit="5"]http:outbound, storage, cron, content:filter, options:read, options:write
publish-notifiersave_post + HTTPRequest: yayımlamada {"id", "title", "link"}'i publish_notifier_webhook URL'ine POST ederposts:read, http:outbound, options:read
ui-demo (Gopher Board)Araçlar altında yönetim sayfası, Pano bileşeni, Gopher Notes meta kutusu, Gopher Badge bloğu ve Web Builder bileşenistorage, admin:pages, admin:dashboard, admin:metaboxes, blocks:register, builder:widgets
Hub / Pazar yeri

Hub ve Pazar Yeri

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.

Hub nedir

Hub'ın iki yüzü vardır:

  • /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.

ÖzellikUç noktaGöründüğü yer
Eklenti pazar yeriGET /api/v1/pluginsEklentiler › Yeni Ekle
Tema pazar yeriGET /api/v1/themesGö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ümleriGET /api/v1/index → corePano › Güncellemeler (Update to version X)
Önceki çekirdek sürümüGET /api/v1/core/{version}Pano › Güncellemeler › Reinstall version Y
Eklenti güncellemeleriGET /api/v1/pluginsEklentiler ve Pano › Güncellemeler
Lisans denetimiGET /api/v1/licenseAyarlar › Lisans
İmzalama anahtarlarıGET /api/v1/index → keysgüvenilen eklenti anahtarlarına otomatik eklenir (her yenilemede değiştirilir)
Ürün logosuGET /api/v1/index → brandher 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).

Güven kökü

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=…).

"keys": [{"id": "hub-2026", "public": "<base64 Ed25519>", "endorsement": "<base64 Ed25519 signature>"}]

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.

Lisanslar ve sitenin gönderdikleri

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.

Pazar yeri (Marketplace)

Eklentiler › Yeni Ekle

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>).

  1. 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.
  2. 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.

Pazar yerine yayımlama

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ı

  1. 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.
  2. digest = SHA-256("wpgo-plugin-v1\n" || u64be(len(json)) || json || u64be(len(wasm)) || wasm) hesaplar.
  3. 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.
  4. 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.

Kendi Hub'ınızı çalıştırmak

Ü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şkenVarsayılanAnlamı
WPGOHUB_ADDR:8080dinleme adresi
WPGOHUB_PUBLIC_URLhttp://localhost:8090download_url ve bağlantılarda kullanılır; herkese açık https:// adresine ayarlayın
DATABASE_URLpostgres://wpgohub:wpgohub@localhost:5432/wpgohub?sslmode=disablePostgreSQL
WPGOHUB_DATA_DIR./datapaketler ve anahtarlar
WPGOHUB_SECRETrastgeleoturum 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 /healthz ok 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
/admingenel bakış: site sayısı, eklenti ve temalar, son ping'ler, son çekirdek sürümü
/admin/siteshost'lar, sürümler, ilk/son görülme, local işareti; arama; silme
/admin/plugins, /admin/themeszip 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/keysimzalama anahtarları; yenisini üret
/admin/settingshub 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.

Kaynaklar: hub/index.md, marketplace.md, publishing.md, running-your-own-hub.md.

REST API

REST API

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.

Genel bakış ve temel URL

API /wp-json/ (ve ?rest_route=/…) adresindedir.

curl -s https://blog.example.com/wp-json/ | jq .namespaces
curl -s 'https://blog.example.com/wp-json/wp/v2/posts?per_page=2&_fields=id,title,link'

Kurallar

  • Giriş ve çıkış JSON; Content-Type: application/json gövdeler ya da form gövdeleri ve sorgu parametreleri.
  • Koleksiyonlar page, per_page ile sayfalanır ve X-WP-Total, X-WP-TotalPages ile Link: rel="next"/"prev" döndürür.
  • _fields yanıtı kırpar, _embed bağlı kaynakları gömer, _envelope gövdeyi durum ve başlıklarla sarar.
  • Yöntem geçersiz kılma: POST'ta X-HTTP-Method-Override veya ?_method=DELETE. PUT/PATCH POST'a, HEAD GET'e düşer.
  • Hatalar: {"code": "rest_no_route", "message": "…", "data": {"status": 404}}.
  • OPTIONS, rotanın yöntemleri ve Allow ile yanıt verir.

Ad alanları

Ad alanıİçerik
wp/v2posts, pages, blocks, media, categories, tags, users, comments, settings, types, taxonomies, statuses, themes, search, patterns, sidebars, widgets, block renderer, global styles
wp-block-editor/v1editörün bağlantı önizlemesi için URL ayrıntıları
oembed/1.0oEmbed vekili
batch/v1toplu istekler
web-builder/v2Pursae Web Builder (yalnızca builder açıkken)
pursae/v1betikler ve AI ajanları için site yönetimi
forum/v1Pursae Forum (yalnızca açıkken)
<plugin-slug>/v1eklentilerin eklediği rotalar
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.

Kimlik doğrulama

YöntemKimin içinNasıl
Anonimherkese açık okumalarkimlik bilgisi yok; yayımlanmış yazılar, sayfalar, medya, terimler, herkese açık profiller, yorumlar
Çerez + noncetarayıcı istemcilerioturum çerezi artı wp_rest eylemi için X-WP-Nonce (veya ?_wpnonce=); nonce'suz çerez anonimdir, yanlış nonce 403 rest_cookie_invalid_nonce
Uygulama Parolalarıbetikler, uygulamalar, CIkullanıcı adı ve 24 karakterlik parolayla (bir kez gösterilir) HTTP Basic; yanlış veya eksikse 401 incorrect_password
OAuth 2.1MCP istemcileriOAuth akışından Authorization: Bearer pat_… belirteçleri; Uygulama Parolaları gibi kapsamlarla daraltılır
curl -u 'editor:abcd efgh ijkl mnop qrst uvwx' \
     -H 'Content-Type: application/json' \
     -d '{"title":"From the API","status":"draft"}' \
     https://blog.example.com/wp-json/wp/v2/posts
  • 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.

KapsamRotalar
content/wp/v2/posts, pages, blocks, categories, tags, comments, types, taxonomies, search, block-renderer, /web-builder/v2, /pll/v1, /batch/v1
media/wp/v2/media
themes/wp/v2/templates, template-parts, global-styles, themes, menus, menu-items, menu-locations, navigation, sidebars, widgets, /pursae/v1/themes
plugins/pursae/v1/plugins, /pursae/v1/updates
cache/pursae/v1/cache
seo/seogo/v1, /pursae/v1/seo
settings/wp/v2/settings, /pursae/v1/options, /pursae/v1/headless, /pursae/v1/health, /pursae/v1/backups, /pursae/v1/mcp/activity
commerce/wc/v3
users/wp/v2/users
curl -u admin:… -H 'Content-Type: application/json' \
     -d '{"name":"Cursor","scopes":["content","media","seo"]}' \
     https://blog.example.com/wp-json/wp/v2/users/me/application-passwords

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ç noktaAmaç
/.well-known/oauth-protected-resourcekorunan kaynak metadata'sı (RFC 9728)
/.well-known/oauth-authorization-serveryetkilendirme sunucusu metadata'sı (RFC 8414)
POST /oauth/registerdinamik istemci kaydı (RFC 7591), yalnızca public istemciler
/wp-admin/oauth-authorizekapsam kutucuklu onay ekranı
POST /oauth/tokenauthorization_code (PKCE) ve refresh_token grant'leri
POST /oauth/revokebelirteç 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.

Uç noktalar: yazılar, sayfalar, bloklar

Rotalar /wp-json/wp/v2 altındadır. GET'in çalıştığı her yerde HEAD, POST'un çalıştığı her yerde PUT/PATCH çalışır.

YöntemYolAmaç
GET, POST/posts, /pages, /blockslistele ve oluştur; filtreler page, per_page, search, author, categories, tags, tax_relation, after, before, status, orderby, slug, include, exclude, parent, sticky…; ham içerik için context=edit
GET, POST, DELETE/posts/{id}, /pages/{id}, /blocks/{id}oku, güncelle, çöpe at (?force=true siler); sayfalar template okur ve yazar
GET, POST/posts/{id}/autosaves (ve pages, blocks)editörün otomatik kaydı
GET/posts/{parent}/autosaves/{id}üst öğenin tek bir otomatik kaydı
GET/posts/{id}/revisions (ve pages…)revizyonlar

Pursae Multi Language açıkken yazılar, sayfalar ve terimler lang ve translations ({"en": 12, "fr": 15}) taşır; koleksiyonlar ?lang=fr alır.

Uç noktalar: medya, terimler, kullanıcılar ve yorumlar

YöntemYolAmaç
GET, POST/medialistele; multipart/form-data (file) veya Content-Disposition'lı ham gövdeyle yükle; görsel boyutları üretilir
GET, POST, DELETE/media/{id}title, caption, alt_text, description, post; görsellerde ayrıca focal_point ({"x": 0.3, "y": 0.2})
POST/media/{id}/post-processson işleme
GET, POST/categories, /tagslistele ve oluştur; search, parent, post, slug, hide_empty, orderby
GET, POST, DELETE/categories/{id}, /tags/{id}güncelleme/silme manage_categories ister
GET/taxonomies, /taxonomies/{taxonomy}taksonomiler
GET/usersherkese açık profiller (who=authors) veya list_users ile tümü
GET/users/{id}tek kullanıcı
GET, POST/users/memevcut kullanıcı; tam kayıt için context=edit
POST/users/me/application-passwords, …/application-passwords/{uuid}Uygulama Parolası oluştur (düz parola bir kez döner) veya güncelle; scopes dizi veya virgüllü liste
GET, POST/commentslistele ve oluştur; anonim yorumlar Tartışma ayarlarına uyar
GET, POST, DELETE/comments/{id}tek yorum

Uç noktalar: site, temalar ve widget'lar

YöntemYolAmaç
GET, POST/settingssite ayarları (manage_options); geçersiz değer 400 rest_invalid_param, hiçbir şey kaydedilmez
GET/types, /types/{type}yazı türleri
GET/statuses, /statuses/{status}yazı durumları
GET/themes, /themes/{stylesheet}status=active, etkin temayı theme_supports ile döndürür
GET/searchsearch, type, subtype
GET, POST/sidebars, /sidebars/{id}widget alanları
GET, POST, DELETE/widgets, /widgets/{id}widget'lar
GET, POST/widget-types, …/{id}/encode, …/{id}/renderwidget türleri
GET/menu-locationsmenü konumları
GET, POST/block-renderer/{name}dinamik blokların sunucu tarafı işlenmesi
GET/block-patterns/patterns, /block-patterns/categoriesçekirdek ve Twenty Twenty-Five desenleri
GET/block-types, /block-directory/search, /pattern-directory/patterns, /wp_pattern_categoryboş listeler
GET/templates, /templates/lookup, /template-partsboş (site editörü yok)
GET, POST/global-styles/{id}, /global-styles/themes/{stylesheet}, …/variationsglobal stiller

Uç noktalar: site yönetimi (pursae/v1)

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öntemYolAmaç
GET, POST/pursae/v1/pluginseklentileri 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, /deactivateetkinleştir / devre dışı bırak (Wasm: permissions)
GET, POST/pursae/v1/themestemaları 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}/activatetemayı değiştir
GET/pursae/v1/themes/{slug}/filesdü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}/replaceID'yi koruyarak medya dosyasını değiştir
GET/pursae/v1/cachePursae 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)
GET, POST/pursae/v1/headless/entries/{uid}, …/{uid}/{doc}girdileri listele, oluştur, güncelle, sil; /publish, /unpublish
GET, POST/pursae/v1/seo/settingsPursae SEO ayarları (kısmi birleştirme)
GET, POST/pursae/v1/seo/redirectsyönlendirmeler (code 301, 302, 307, 410, 451); /{id} üzerinde DELETE
GET/pursae/v1/analyticsPursae Analytics özeti (?range=today|7d|30d|month|90d|12m)
GET/pursae/v1/healthsürüm, veritabanı, cron kuyruğu, Site Sağlığı puanı, güncellemeler, son yedek
GET, POST/pursae/v1/updatesmevcut güncellemeler; POST {"type": "plugin"|"theme"|"core", "slug": "…"} birini kurar
GET, POST/pursae/v1/backupsarşivler veya yedek başlat (job ile 202)
GET/pursae/v1/mcp/activityyazan 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
POST, GET, DELETE/pursae/v1/mcpMCP sunucusu (streamable HTTP)

Uç noktalar: forum ve diğer ad alanları

Pursae Forum (forum/v1)

Yalnızca Pursae Forum açıkken. Okuma rotaları herkese açıktır; listeler page ve per_page alır (varsayılan 10, en fazla 100).

YöntemYolAmaç
GET/forum/v1/forumstüm forum ağacı, düz
GET/forum/v1/forums/{id}/topicsbir forumun konuları (sort=latest|popular|unanswered|solved, tag=)
GET/forum/v1/topics/{id}, /topics/{id}/repliesbir konu ve yanıtları
POST/forum/v1/topics/{id}/viewgörüntülenme sinyali
POST / GET/forum/v1/presence / /forum/v1/onlineçevrim içi işaretle / çevrim içi sayılarını oku
GET/forum/v1/stats, /tags, /topics/similar, /levels, /badges, /weekly, /meistatistikler, etiketler, benzer konular, oyunlaştırma, üye durumu
POST, DELETE/forum/v1/posts/{id}/likebeğen / beğeniyi geri al
POST/forum/v1/posts/{id}/reportbildir (spam abuse off_topic other)
POST, DELETE/forum/v1/topics/{id}/subscription, /topics/{id}/solutione-postayla takip; çözümü kabul et / geri çek
POST/forum/v1/previewiçeriği gönderilecek haliyle işle
GET, POST, DELETE/forum/v1/draftüyenin yeni konu taslağı

Üye rotaları çerez + X-WP-Nonce veya Uygulama Parolası ister (aksi halde 401 rest_not_logged_in).

Diğer ad alanları

YöntemYolAmaç
GET/ (/wp-json/)dizin: site bilgisi, ad alanları, yöntemleriyle her rota
POST/batch/v1tek çağrıda en fazla 25 istek (iç içe batch yok)
GET/oembed/1.0/proxyurl=: editör için sağlayıcının oEmbed'i
GET/wp-block-editor/v1/url-detailsurl=: bir bağlantının başlığı, ikonu, açıklaması
GET, POST, DELETE/pll/v1/languages, /pll/v1/languages/{id or code}, /pll/v1/settingsPursae Multi Language
GET, POST/pll/v1/media/{id}/i18ndile göre medya metinleri
POST/pll/v1/translate, /pll/v1/translate/testmakine çevirisi vekili (kullanıcı başına dakikada 60 çağrı)
POST/pll/v1/visual/stringsdizge çevirilerini kaydet (≤ 200 öğe)
çeşitli/web-builder/v2/…Pursae Web Builder belgeleri, kütüphane, tercihler, fontlar, formlar, şablonlar, temalar, site ayarları

Eklenti rotaları

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.

curl -s https://blog.example.com/wp-json/ | jq '.namespaces'
# ["batch/v1", "oembed/1.0", "shortcode-demo/v1", "wp-block-editor/v1", "wp/v2"]
curl -s https://blog.example.com/wp-json/shortcode-demo/v1/facts/1
  • Ö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.

Öne çıkanlar

  • Ö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.
  • Lighthouse (ana sayfa, mobil): 100; WordPress yalın 96, ayarlı 99, eklenti setiyle 67.

Pursae'nin kazanmadığı yerler

  • 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ı.

Kaynak: docs/developer/benchmarks.md

Yöntem

Donanım ve sürümler

  • Apple M2 Pro (32 GB), macOS üzerinde Docker Desktop 29.7.2; Docker'a 12 CPU / 7,7 GB.
  • WordPress 7.1.4, PHP 8.3.36, MariaDB 11.4, nginx 1.27, Redis 7, WooCommerce 11.2.2, Yoast SEO 28.8, Polylang 3.9.2, ACF 6.8.11, Elementor 4.3.6, Contact Form 7 6.2.4.1, Redis Object Cache 3.0.0, WP Super Cache 3.1.5.
  • Pursae 0.1.9 (commit cb856438), PostgreSQL 17. k6 1.3.0, 10 sanal kullanıcı, üç adet 20 saniyelik koşunun medyanı.

Kurulumlar

KurulumWordPressPursae
YalınWordPress 7.1.4, PHP 8.3 php-fpm (resmî imaj, OPcache açık, pm = dynamic, 5 alt süreç), nginx, MariaDB 11.4, eklenti yokPursae Cache kapalı, yerleşik eklenti yok (yeni kurulumdaki gibi Classic Editor açık)
Önbellekli ("ayarlı")Yalın kurulum + Redis 7 ile Redis Object Cache, sayfaları nginx'in diskten sunduğu WP Super Cache (gzip_static), 12'lik statik php-fpm havuzu, innodb_buffer_pool_size = 512MPursae Cache açık (varsayılanlar)
Gerçek siteYalın kurulum + WooCommerce, Yoast SEO, Polylang, ACF, Elementor ve Contact Form 7, sayfa önbelleği yokCommerce, 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ı.

Tüm sonuçlar

Sütunlar: WP yalın · WP ayarlı · WP + 6 eklenti · Pursae, önbelleksiz · Pursae, önbellekli · Pursae + 6 yerleşik. Tire, o kurulumda mağaza olmadığını gösterir.

Verim (req/s, yüksek daha iyi)

Uç noktaWP yalınWP ayarlıWP + 6 eklentiPursae, önbelleksizPursae, önbellekliPursae + 6 yerleşik
Ana sayfa5131.4141939734.128273
Tekil yazı5830.2481939434.698232
Kategori arşivi5028.2931839535.168312
Ürün——16——194
Arama485.72418119105116
REST yazı listesi8964181.046885349
Yönetim panosu (giriş yapılmış)724319627478510
Yönetim yazı listesi (giriş yapılmış)523614210178203

Yük altında TTFB p50 (ms)

Uç noktaWP yalınWP ayarlıWP + 6 eklentiPursae, önbelleksizPursae, önbellekliPursae + 6 yerleşik
Ana sayfa195,80,1505,624,20,134,3
Tekil yazı183,60,1500,915,70,127,8
Kategori arşivi197,50,1511,724,40,131,0
Ürün——592,7——60,7
Arama202,10,8527,793,396,392,4
REST yazı listesi106,0183,9522,78,49,014,9
Yönetim panosu (giriş yapılmış)107,9207,3513,58,510,211,1
Yönetim yazı listesi (giriş yapılmış)130,2293,6709,827,369,734,2

Yük altında gecikme p95 (ms)

Uç noktaWP yalınWP ayarlıWP + 6 eklentiPursae, önbelleksizPursae, önbellekliPursae + 6 yerleşik
Ana sayfa214,00,4585,935,40,554,4
Tekil yazı198,30,4574,864,80,579,1
Kategori arşivi263,60,4589,234,70,544,1
Ürün——669,6——85,7
Arama260,51,8596,8107,2179,3157,7
REST yazı listesi160,6196,0589,117,827,971,0
Yönetim panosu (giriş yapılmış)176,5291,0579,356,064,556,8
Yönetim yazı listesi (giriş yapılmış)204,1306,3786,284,796,084,1

Yük altında gecikme p99 (ms)

Uç noktaWP yalınWP ayarlıWP + 6 eklentiPursae, önbelleksizPursae, önbellekliPursae + 6 yerleşik
Ana sayfa268,00,7594,850,21,189,2
Tekil yazı208,80,7582,281,51,0104,5
Kategori arşivi286,40,7619,943,01,157,1
Ürün——681,3——94,6
Arama271,639,5603,7166,9200,2193,0
REST yazı listesi167,0200,0623,927,137,776,8
Yönetim panosu (giriş yapılmış)180,7298,5590,862,875,966,8
Yönetim yazı listesi (giriş yapılmış)227,4378,5799,191,1171,592,1

Yeniden başlatma sonrası ilk istek (soğuk): TTFB · veritabanı sorgusu

Uç noktaWP yalınWP ayarlıWP + 6 eklentiPursae, önbelleksizPursae, önbellekliPursae + 6 yerleşik
Ana sayfa49,1 ms · 32 sorgu2,5 ms · 0 sorgu125,5 ms · 139 sorgu13,6 ms · 13 sorgu2,5 ms · 0 sorgu17,1 ms · 16 sorgu
Tekil yazı85,1 ms · 41 sorgu57,0 ms · 12 sorgu120,7 ms · 156 sorgu9,4 ms · 19 sorgu13,6 ms · 19 sorgu14,0 ms · 37 sorgu
Kategori arşivi47,8 ms · 34 sorgu59,0 ms · 12 sorgu125,9 ms · 145 sorgu10,7 ms · 15 sorgu13,3 ms · 15 sorgu17,1 ms · 24 sorgu
Ürün——147,7 ms · 177 sorgu——20,0 ms · 55 sorgu
Arama85,4 ms · 37 sorgu71,9 ms · 8 sorgu133,1 ms · 146 sorgu30,1 ms · 14 sorgu34,9 ms · 14 sorgu38,5 ms · 17 sorgu
REST yazı listesi33,6 ms · 42 sorgu36,0 ms · 28 sorgu172,2 ms · 205 sorgu7,0 ms · 7 sorgu6,0 ms · 7 sorgu9,2 ms · 37 sorgu
Yönetim panosu (giriş yapılmış)58,6 ms · 47 sorgu58,9 ms · 8 sorgu242,5 ms · 213 sorgu13,0 ms · 21 sorgu13,0 ms · 21 sorgu15,1 ms · 25 sorgu
Yönetim yazı listesi (giriş yapılmış)31,4 ms · 48 sorgu34,2 ms · 10 sorgu185,3 ms · 205 sorgu17,4 ms · 20 sorgu13,7 ms · 20 sorgu16,4 ms · 25 sorgu

İkinci istek (ılık): TTFB · veritabanı sorgusu

Uç noktaWP yalınWP ayarlıWP + 6 eklentiPursae, önbelleksizPursae, önbellekliPursae + 6 yerleşik
Ana sayfa49,0 ms · 32 sorgu2,1 ms · 0 sorgu125,8 ms · 135 sorgu9,2 ms · 13 sorgu2,2 ms · 0 sorgu16,6 ms · 16 sorgu
Tekil yazı72,1 ms · 41 sorgu2,2 ms · 0 sorgu118,5 ms · 151 sorgu8,7 ms · 19 sorgu2,4 ms · 0 sorgu13,3 ms · 37 sorgu
Kategori arşivi46,1 ms · 34 sorgu2,1 ms · 0 sorgu120,0 ms · 140 sorgu12,4 ms · 15 sorgu2,2 ms · 0 sorgu13,7 ms · 24 sorgu
Ürün——138,5 ms · 172 sorgu——15,3 ms · 55 sorgu
Arama64,1 ms · 37 sorgu4,1 ms · 0 sorgu128,5 ms · 146 sorgu26,1 ms · 14 sorgu25,8 ms · 14 sorgu34,7 ms · 17 sorgu
REST yazı listesi40,8 ms · 42 sorgu31,5 ms · 6 sorgu141,6 ms · 155 sorgu5,3 ms · 7 sorgu6,4 ms · 7 sorgu10,7 ms · 37 sorgu
Yönetim panosu (giriş yapılmış)25,4 ms · 47 sorgu29,9 ms · 8 sorgu140,2 ms · 213 sorgu7,0 ms · 20 sorgu7,2 ms · 20 sorgu9,6 ms · 24 sorgu
Yönetim yazı listesi (giriş yapılmış)27,3 ms · 48 sorgu29,8 ms · 10 sorgu170,1 ms · 205 sorgu11,3 ms · 20 sorgu11,3 ms · 20 sorgu13,5 ms · 25 sorgu

Kaynaklar

ÖlçümWP yalınWP ayarlıWP + 6 eklentiPursae, önbelleksizPursae, önbellekliPursae + 6 yerleşik
Boşta bellek (MiB, tüm konteynerler)233338330957579
Yük altında tepe bellek (MiB)276489428202184184
Soğuk başlangıç, tüm yığın (sn)3,162,903,943,053,143,05
Soğuk başlangıç, yalnızca uygulama (sn)1,080,791,791,030,980,84
Docker imajları (MB)389406389171171171
Diskteki kurulum (MB, yüklemeler hariç)342,0355,7342,0139,0139,0139,0
Veritabanı boyutu (MB)16,416,416,330,130,130,1
Veritabanı tabloları595959929292
Lighthouse performans (ana sayfa, mobil)969967100100100
Lighthouse LCP (ms)2.7052.1065.7051.8801.8801.881
Ana sayfa ağırlığı (KB)340192867171171175

Ham veri: bench/results/2026-11-09/summary.md

Testleri yeniden üretmek

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.pyOrkestrasyon: derleme, veri yükleme, kurulum değiştirme, ölçüm
bench/wp/compose.yaml, bench/wp/nginx/*.conf, bench/wp/php/*WordPress yığını, nginx yapılandırmaları (yalın ve WP Super Cache), php-fpm havuzları, PhpRedis imajı
bench/pursae/compose.yamlPursae yığını
bench/content/gen.pyWXR dosyası ve ürün verileri
bench/k6/load.jsYü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.

Yerleşik eklentilerin yerini tuttukları

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 eklentisiTemel özelliklerini karşıladığıPlanYıllık fiyat
CommerceWooCommerce (ücretsiz) + WooCommerce Subscriptions gibi premium eklentilerSubscriptions, 1 yıl$279
Web BuilderElementor ProEssential, 1 site$60
SEOYoast SEO Premium (ve Rank Math PRO)1 site$118.80
CacheWP RocketSingle$60 (ilk yıl $36, kampanya 2026-11-28'e kadar)
CDNWP Offload MediaBronze (2.000 medya öğesine kadar)$69 (ilk yıl $39)
CookieComplianz PremiumPersonal, 1 site$59
PixelPixelYourSite ProStarter, 1 site$199
SMTPWP Mail SMTP ProPro, 1 site$99 (ilk yıl $49)
Custom FieldsACF PROPersonal, 1 site$49
Multi LanguagePolylang ProPro€99 (yenilemelerde %50 indirim)
Backup ManagerAll-in-One WP Migration Unlimited ExtensionStandard (50 siteye kadar)$69
Contact FormContact Form 7—ücretsiz
SecurityWordfence / Solid Security'nin giriş güvenliği bölümü — güvenlik duvarı ve kötü amaçlı yazılım tarayıcısı yokWordfence Premium($149, karşılaştırılamaz)
MaintenanceMaintenance PRO (WebFactory)Personalyalnızca ömür boyu satılıyor (tek sefer $59)
HeadlessBir 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.

Kaynak: docs/developer/benchmarks.md