/docs
pSEO Wizard dokümantasyonu
Sitenizden yayında sayfalara giden yolda ihtiyacınız olan her şey: sihirbaz nasıl çalışır, sayfaları kod yazmadan sitenize nasıl eklersiniz ve bir şey ters giderse ne yapmalısınız.
Son güncelleme: Eylül 2026
/how-it-works
Nasıl çalışır
Sihirbaz beş adımdan oluşur. Ödeme yapmadan önce istediğiniz adıma dönüp değişiklik yapabilirsiniz.
- 01
Sitenizi yapıştırın
Ana sayfanızı ve birkaç önemli sayfayı (hizmetler, fiyatlar, menü, hakkımızda, iletişim) okur, işletmenizin türünü belirleriz. Her sayfada kullanılmasını istediğiniz temel bilgileri de ekleyebilirsiniz.
- 02
Bir kalıp seçin
Aramaların yapısını, örneğin “{Hizmet} {Şehir}” veya “{Kitle} için {Ürün}”, ve bir sayfa şablonu seçin.
- 03
Değerleri ekleyin
Birleştirilecek hizmetleri, şehirleri veya kitleleri yazın; her kombinasyon bir sayfa olur. Konum hedefliyorsanız, müşterilerinize hizmet verme biçiminize uygun olup olmadıklarını kontrol ederiz.
- 04
Oluşturun
Önce ücretsiz sayfanızı oluşturun. Beğendiğinizde geri kalanın ödemesini yapın (en az 10 sayfa); sayfalar tek tek yazılır.
- 05
Yayınlayın veya indirin
Sayfaları WordPress, Shopify, Webflow veya WooCommerce'e gönderin ya da yüklemeye hazır HTML dosyaları olarak indirin.
/html-export
Sayfalarınızı indirin
5. adımdaki Paketi İndir, sayfaları istediğiniz yerde barındırmak için gereken her şeyi içeren bir ZIP dosyası verir:
dist/Her sayfa için stili içine gömülü, hazır bir HTML dosyası; başka dosyaya ihtiyaç duymadan doğru görünür.dist/index.htmlTüm sayfalarınızın bağlantılı basit bir listesi.sitemap.xmlGoogle Search Console'a gönderebileceğiniz bir site haritası.data/Geliştiriciler için aynı sayfalar JSON olarak (başlık, slug, meta açıklama ve HTML).
Yayına almak için
- Dosyayı zipten çıkarın.
- dist/ içindeki dosyaları hostinginize, tercihen bir /blog klasörüne yükleyin; örneğin hosting dosya yöneticisiyle veya FTP ile.
- Kontrol etmek için bir sayfayı tarayıcıda açın, ardından sitemap.xml'i Google Search Console'a gönderin.
/json
Geliştiriciler için JSON
İndirme paketinde sayfalarınız veri olarak da yer alır; böylece onları kendi uygulamanızdan sunabilirsiniz. data/wizard-data.json, her sayfa için bir nesne içeren bir dizidir:
| Alan | Tür | İçeriği |
|---|---|---|
title | string | Arama sonuçlarında görünen sayfa başlığı, en fazla 60 karakter. |
meta_description | string | Arama sonuçlarında başlığın altında görünen meta açıklama. |
h1 | string | Sayfadaki ana başlık. |
body_html | string | Eksiksiz HTML belgesi: head bölümü, içine gömülü CSS, yapılandırılmış veriler ve “Bunu da okuyun” bağlantıları. Olduğu gibi sunun. |
slug | string | Sayfa URL'sinin son kısmı, örneğin plumber-in-camden. |
keywords | object | Bu sayfa için kullanılan değerler; kalıbınızdaki her değişken için bir tane. |
status | string | Dışa aktarımdaki sayfalar için her zaman “success”. |
locale | string | Sayfanın dil kodu, örneğin en veya ar. |
data/content.json aynı sayfaları, bazı araçların beklediği üç ek adla içerir: content (body_html ile aynı), metaDescription ve description (ikisi de meta_description ile aynı).
Örnek sayfa nesnesi (body_html kısaltılmıştır)
{
"title": "Plumber in Camden | Example Plumbing",
"meta_description": "Same-day plumbing in Camden: boiler service from £89 and leak repairs by Gas Safe registered engineers.",
"h1": "Plumber in Camden",
"body_html": "<!DOCTYPE html><html lang=\"en\" dir=\"ltr\"><head>…</head><body>…</body></html>",
"slug": "plumber-in-camden",
"keywords": { "Service": "Plumber", "Area": "Camden" },
"status": "success",
"locale": "en"
}Sayfaları kendi uygulamanızdan sunun
Sayfanın URL'si için body_html'i yanıtın tamamı olarak gönderin. Kendi şablonunuzun içine koymayın: head bölümü, stilleri ve yapılandırılmış verileri zaten içindedir. Kullandığınız teknolojiye uygun örneği seçin:
Statik hosting (framework olmadan)
# Put the exported pages under /blog on any static host
unzip your-site-bundle.zip -d export
mkdir -p public/blog
cp export/dist/*.html public/blog/
# /blog/plumber-in-camden.html works now. For /blog/plumber-in-camden,
# turn on "clean URLs" (Netlify, Vercel, Cloudflare Pages) or, on nginx:
location /blog/ {
try_files $uri $uri.html =404;
}Next.js
import pages from '@/data/wizard-data.json';
export async function GET(_req: Request, { params }: { params: Promise<{ slug: string }> }) {
const { slug } = await params;
const page = pages.find(p => p.slug === decodeURIComponent(slug));
if (!page) return new Response('Not found', { status: 404 });
return new Response(page.body_html, {
headers: { 'Content-Type': 'text/html; charset=utf-8' }
});
}Astro
---
import pages from '../../data/wizard-data.json';
export function getStaticPaths() {
return pages.map(page => ({ params: { slug: page.slug }, props: { page } }));
}
const { page } = Astro.props;
---
<Fragment set:html={page.body_html} />Nuxt
import pages from '~~/data/wizard-data.json';
export default defineEventHandler((event) => {
const slug = decodeURIComponent(getRouterParam(event, 'slug') ?? '');
const page = pages.find(p => p.slug === slug);
if (!page) throw createError({ statusCode: 404 });
setHeader(event, 'Content-Type', 'text/html; charset=utf-8');
return page.body_html;
});PHP (Laravel)
use Illuminate\Support\Facades\Route;
Route::get('/blog/{slug}', function (string $slug) {
$pages = json_decode(file_get_contents(storage_path('app/wizard-data.json')), true);
$page = collect($pages)->firstWhere('slug', $slug);
abort_unless($page, 404);
return response($page['body_html'])
->header('Content-Type', 'text/html; charset=utf-8');
});“Bunu da okuyun” bağlantılarını ve /blog URL'lerini çalışır tutun
- Sayfalar arasındaki bağlantılar 3. adımda seçtiğiniz URL yapısını kullanır: /blog/{slug} ya da dil önekiyle /{prefix}/blog/{slug}. Her sayfayı 1. adımda girdiğiniz sitede tam olarak bu yolda sunarsanız, bağlantılar ve sayfanın yapılandırılmış verileri hiçbir değişiklik gerekmeden doğru olur.
- Sayfalarınız farklı bir yoldaysa HTML'i elle düzenlemeyin. Her “Bunu da okuyun” bağlantısında hedef sayfanın slug'ını taşıyan bir data-pseo-link özelliği vardır; hepsini tek seferde değiştirebilirsiniz:
read-also.js // Each "Read also" link carries data-pseo-link="<slug>" const html = page.body_html.replace( /href="[^"]*"(\s+data-pseo-link="([^"]+)")/g, (_, attr, slug) => `href="/guides/${slug}"${attr}` ); - dist/ içindeki HTML dosyaları ise birbirine {slug}.html olarak bağlanır. Hepsini birlikte aynı klasöre (tercihen /blog) yükleyin; temiz URL'ler açık da olsa kapalı da olsa çalışmaya devam ederler.
- Bir kampanyanın tüm sayfalarını birlikte içe aktarın. İçe aktarmadığınız bir sayfaya giden bağlantı 404 verir: HTML dışa aktarımı bu bağlantıları sizin için kaldırır; kendi uygulamanızda da slug'ı verilerinizde olmayan bağlantıları atlayabilirsiniz.
- Sayfa yayına girdikten sonra slug'ı değiştirmeyin. Değiştirmeniz gerekirse eski adresten yenisine 301 yönlendirmesi ekleyin.
/publish
Kodsuz yayınlama
5. adımda sitenizi bağlayın, sayfaları sizin yerinize gönderelim. Platformunuzdan yalnızca bir kez anahtar almanız gerekir; aşağıdaki adımlar nerede bulacağınızı gösterir.
WordPress
Sayfalar taslak yazı olarak gelir; yayına almadan önce kontrol edebilirsiniz.
- WordPress yönetim panelinde Kullanıcılar → Profil'i açın ve Uygulama Parolaları bölümüne inin.
- “pSEO Wizard” gibi bir ad yazın, Yeni Uygulama Parolası Ekle'ye tıklayın ve gösterilen parolayı kopyalayın. Parola yalnızca bir kez gösterilir.
- 5. adımda WordPress'i seçin; site adresinizi, WordPress kullanıcı adınızı ve bu uygulama parolasını girin (normal giriş parolanızı değil).
- Yayınla'ya tıklayın, ardından WordPress'te Yazılar → Taslaklar'ı açıp sayfaları inceleyin ve yayınlayın.
Shopify
Sayfalar, seçtiğiniz blogda yayınlanmış makaleler olarak eklenir.
- Shopify yönetim panelinde Ayarlar → Uygulamalar ve satış kanalları → Uygulama geliştir'i açın ve bir uygulama oluşturun.
- Admin API kapsamlarını yapılandır bölümünde read_content ve write_content'i açın, kaydedin ve Uygulamayı yükle'ye tıklayın.
- API kimlik bilgileri'ni açın ve shpat_ ile başlayan Admin API erişim belirtecini kopyalayın.
- 5. adımda Shopify'ı seçin, mağaza adresinizi (magazaniz.myshopify.com) ve belirteci girin, bir blog seçin ve Yayınla'ya tıklayın.
Webflow
Sayfalar bir CMS koleksiyonuna öğe olarak eklenir ve sitenizi bir sonraki yayınlayışınızda canlıya çıkar.
- Webflow Designer'da Post Body adında zengin metin alanı ve Post Summary adında metin alanı olan bir CMS koleksiyonu (örneğin “Rehberler”) oluşturun. Webflow'un blog şablonunda ikisi de hazırdır.
- Koleksiyonun şablon sayfasını açın ve adı ile Post Body alanını tasarımınıza bağlayın.
- Site ayarları → Uygulamalar ve entegrasyonlar → API erişimi altında bir API belirteci oluşturun.
- 5. adımda Webflow'u seçin, belirteci yapıştırın, siteyi ve koleksiyonu seçin, Yayınla'ya tıklayın; ardından sitenizi Webflow'da yayınlayın.
WooCommerce
Sayfalar taslak ürün olarak eklenir; sattığınız bir şeyi anlatan sayfalar için uygundur.
- WordPress yönetim panelinde WooCommerce → Ayarlar → Gelişmiş → REST API'yi açın ve Anahtar ekle'ye tıklayın.
- Anahtara Okuma/Yazma izni verin, ardından tüketici anahtarını (ck_…) ve tüketici gizli anahtarını (cs_…) kopyalayın.
- 5. adımda WooCommerce'i seçin, mağaza adresinizi ve iki anahtarı girin, Yayınla'ya tıklayın; ardından Ürünler altındaki taslakları inceleyin.
Wix
Henüz doğrudan Wix bağlantısı yok, ama sayfaları elle ekleyebilirsiniz.
- Sayfalarınızı 5. adımda indirin (yukarıdaki “Sayfalarınızı indirin” bölümüne bakın).
- Wix Editör'de yeni bir sayfa ekleyin, ardından Kod Yerleştir → HTML Yerleştir'i ekleyip bir sayfanın .html dosyasının tüm içeriğini yapıştırın.
- Sayfanın URL'sini ve SEO başlığını Wix'te sayfayla uyumlu olacak şekilde ayarlayın. Arama motorları yerleştirilmiş HTML'yi normal sayfalar kadar iyi okuyamaz; bu yüzden WordPress, Shopify veya Webflow genelde daha iyi sıralanır.
/pricing
Fiyat ve ödeme
Her sayfa için bir kez ödersiniz. Abonelik yoktur ve her hesabın ilk sayfası ücretsizdir.
| Sayfalar | Sayfa başına fiyat |
|---|---|
| 1–500 | $0,30 |
| 501–1.500 | $0,25 |
| 1.501–3.500 | $0,20 |
| 3.501+ | $0,15 |
- Fiyatlar kademelidir: her fiyat yalnızca kendi aralığındaki sayfalara uygulanır. Örneğin 600 sayfa: 500 × 0,30 $ + 100 × 0,25 $ = 175 $.
- Ücretli siparişler en az 10 sayfa olmalıdır. İndirim veya kupon kodu yoktur.
- Ücretli bir kampanyayı değiştirirseniz, henüz oluşturulmamış sayfaların tutarı bir sonraki siparişinizde kullanmak üzere hesabınıza bakiye olarak döner.
- Ödemeleri Merchant of Record'umuz Dodo Payments yürütür. Kartları ve yerel ödeme yöntemlerini kabul eder, varsa satış vergisini veya KDV'yi ödeme sırasında ekler.
/facts
Sayfalar nasıl doğru kalır
Arama motorları da müşteriler de bilgi uyduran sayfaları cezalandırır. Bu kurallar her sayfa için geçerlidir:
Bilgiler sitenizden gelir
Fiyatlar, hizmetler, yorumlar ve rakamlar yalnızca sitenizden ve girdiğiniz temel bilgilerden alınır. Sitenizde olmayan bir rakam sayfadan silinir.
Her sayfa farklıdır
Her sayfanın kendi planı vardır ve biten sayfalar birbiriyle karşılaştırılır. Diğerlerini fazla tekrar eden bir sayfa yeniden yazılır.
Konumlar konusunda dürüst
Müşteriler size geliyorsa, uzaktaki yerler için sizi uyarırız. Siz müşteriye gidiyorsanız, sayfalar o bölgeye hizmet verdiğinizi söyler; orada şubeniz olduğunu asla söylemez.
/blog altında yayın
Sayfalar varsayılan olarak bir /blog klasörüne gider; böylece çok sayıda yeni sayfa sitenizin geri kalanından ayrı durur.
/help
Sorun giderme
- WordPress girişin hatalı olduğunu söylüyor (401 veya 403)
- Normal parolanızı değil, uygulama parolasını ve WordPress kullanıcı adınızı (e-postanızı değil) kullanın. Bazı güvenlik eklentileri WordPress REST API'yi engeller; kullanıcınız için izin verip tekrar deneyin.
- Shopify bağlanmıyor
- shpat_ ile başlayan Admin API erişim belirtecini kullanın ve uygulamaya read_content ile write_content kapsamlarını verin. Kapsamları değiştirdikten sonra uygulamayı yeniden yükleyip yeni belirteci kopyalayın.
- Yükledikten sonra sayfa 404 veriyor
- Dosyanın, sayfa URL'sinin beklediği klasörde (örneğin /blog/) olduğunu ve 3. adımda belirlediğiniz URL dil önekinin sitenizle eşleştiğini kontrol edin.
- Butonlar yanlış sayfaya gidiyor
- Butonlar 1. adımdaki Hedef URL'ye ya da varsa sitenizdeki ilgili sayfaya (rezervasyon, menü, fiyatlar, iletişim) gider. Hedef URL'yi oluşturmadan önce ayarlayın; mevcut sayfalarda bağlantıyı 4. adımdaki sayfa düzenleyicisinden değiştirin.
Hâlâ takıldınız mı? support@wizardseo.co adresine yazın, yardımcı olalım.