Sorun: "Özel yazılım" tek bir kurulum yolu değil
Bir siteye SEO düzeltmesini otomatik yazdırma fikri geldiğinde, ekipler genelde tek bir soru sorar: "Bağlantıyı nasıl kurarız?" Ama bu soru, sitenin altyapısına göre en az dört farklı cevaba dağılır ve her cevabın ön koşulu, yetkilisi ve sınırı farklıdır. Özel yazılım bağlantısı rehberi bu dört yolu ayrı ayrı tanımlıyor; AI hazır çözümler sayfası ise her yolda editörün elinde ne olduğunu (kopyala-yapıştır mı, tek tık mı, kontrollü otomasyon mu) gösteriyor. Bu iki kaynağı yan yana koymadan karar vermek, yanlış platforma yanlış paketi uygulamaya kadar gidebilir.
Karar tablosu: altyapıya göre kurulum yolu
| Altyapı | Kurulum yolu | Ön koşul | Kim uygular | |---|---|---|---| | Apache + PHP ile statik HTML | PHP referans paketi (.zip) | HTTPS, PHP 7.4+, DOM/XML, Apache 2.4 mod_rewrite, web kökü dışında yazılabilir özel bir klasör | Sunucuya dosya yazma yetkisi olan geliştirici veya barındırma sorumlusu | | WordPress | Rampika Connect eklentisi | Güncel eklenti kurulu ve eşleştirilmiş olmalı | Panel erişimi olan editör; eklenti kurulumu için site yöneticisi | | Shopify | Mağaza bağlantısı, erişim belirteciyle | Shopify yönetici paneline erişim | Mağaza sahibi veya yetkili çalışan | | Next.js / Node.js / diğer özel uygulama | Rehberdeki v1 sözleşmesini uygulayan bir sunucu rotası (`/api/rampika-connect` benzeri) | HMAC imza doğrulama, nonce yönetimi, işlem kaydı gibi sunucu tarafı kod yazımı | Geliştirici; editör bu yolu tek başına kuramaz |
Bu tablodaki PHP satırının gereksinimleri (web kökü dışı özel klasör, 0700/0600 izinleri, Apache mod_rewrite) yalnızca o kurulum yoluna aittir; Next.js veya başka bir Node tabanlı uygulamaya otomatik olarak genellenmez. Next.js/Node yolunda kurulan şey bir dosya paketi değil, rehberde tarif edilen v1 sözleşmesine uyan bir HTTP uç noktasıdır ve bunu yazmak geliştirici işidir.
Yol seçildikten sonra: hangi iş, hangi işlemle sınırlı
Kurulum yolu ne olursa olsun, bağlantı üzerinden yapılabilecek iş sabit bir liste değil, rehberde bildirilen işlemlerle (action) sınırlı. Örneğin `metadata.apply` bir işlemdir; `metadata.title` ve `metadata.description` ise bu işlemin üzerinde çalıştığı ayrı yeteneklerdir (capability). Bir sitenin bağlantısı `capabilities` sorgusunda hangi yetenekleri döndürüyorsa yalnız onlar kullanılabilir — her bağlantının başlık, açıklama, taslak yazma veya yayınlama işlemlerinin tamamını desteklediği varsayılmamalı.
Kopyala-yapıştır yolu ise kurulum yolundan bağımsız olarak her planda geçerli: AI hazır çözümler sayfası'na göre metni kopyalayıp kendi yönetim panelinden yapıştırmak, hiçbir bağlantı kurulumu gerektirmez ama bu durumda elle yapılan değişikliklerin otomatik doğrulaması veya geri alınması da olmaz.
Örnek karar formu (varsayımsal)
Aşağıdaki form gerçek bir vaka değil, kurulum yolu seçerken doldurulabilecek örnek bir şablondur:
- Site ve altyapı: ornek-magaza.com — özel Next.js uygulaması
- İhtiyaç: Başlık ve açıklama düzeltmelerinin panelden onaylanıp otomatik yazılması
- Uygun kurulum yolu: Rehberdeki v1 sözleşmesine göre sunucu tarafı uç nokta
- Ön koşul: HTTPS origin, imza anahtarı üretimi, nonce deposu — geliştirici erişimi gerekir
- İşi üstlenecek rol: Backend geliştirici; editör yalnız hangi alanların (metadata.title, metadata.description) desteklenmesini istediğini belirtir
- Tamamlanma gözlemi: `capabilities` sorgusunun beklenen yetenekleri döndürmesi, ardından tek bir alanda test yazma/geri alma denemesinin doğrulanması
- Açık kalan soru: Yayınlanmamış makale taslağının (`article.draft`) sitemap ve blog listesinde görünmediğinin kontrolü kim tarafından yapılacak?
Bu form, her satırı doldurmadan "bağlantıyı kuralım" demenin, hangi platformda hangi yetkinin gerektiğini gözden kaçırdığını göstermek için hazırlanmıştır.
Erişim notu
Hangi yol seçilirse seçilsin, metni onaylamak ile siteye yazmak farklı işlerdir. WordPress ve Shopify'da bu ayrım eklenti/erişim belirteci kurulumuyla; özel yazılımda ise sunucu koduna yetkili erişimle çözülür. Bağlantı kurulmamış olması, metni kopyalayıp panelden elle uygulamayı engellemez — sadece otomatik yazma ve geri alma imkanını devre dışı bırakır.