WordPress için HaberAPI Publisher Pro

HaberAPI WordPress Eklentisi

Portal'dan aldığınız API key ile içerik havuzunu WordPress sitenize bağlayın. New-only/full backfill, story upsert, SEO paket eşleşmeleri, tema uyumluluğu ve remote update kanalları (stable/beta/canary) tek eklenti içinde.

Eklentiyi İndirPortal Hesabı AçAPI Quickstart

Stable ZIP paketini doğrudan indirebilirsiniz. Eklentiyi aktive edip senkron ve update akışı için aktif public.read API key gerekir.

Target Model

`post` + `haber_article`

Tema Kapsamı

Top6 + Generic

Güncelleme

Stable / Beta / Canary

WP-CLI

Sync + Backfill + Diagnostics

Neler Sunuyor?

TS/Python SDK'larla aynı operasyonel kapsamı WordPress tarafına taşır; kurumsal haber operasyonunu admin paneli + CLI ile yönetilebilir hale getirir.

Tam Havuz Senkronu

New-only veya full backfill ile güncel akış ve geçmiş arşivi aynı eklentiyle yönet.

Story Bazlı Upsert

Aynı story için tek post güncellenir; revision ve manuel düzenleme kilitleri korunur.

SEO + Discover Paketleri

SEO title/spot/body, discover title önerileri ve meta description önerileri otomatik yazılır.

Tema Uyumluluğu

Newspaper, JNews, Astra, GeneratePress, Kadence ve News Magazine X için resmi parity kontrolleri.

Güvenli Remote Update

Stable/Beta/Canary kanalları, checksum ve imza doğrulama ile güvenli sürüm geçişi.

Queue + Retry Motoru

WP cron, deterministic queue claim, lease recovery ve retry/backoff ile yüksek hacim stabilitesi.

Ana Modüller

  • Target post type: native `post` veya `haber_article`
  • Kategori/tag/source/topic/entity/geo taxonomy eşleşmesi
  • Kategori yoksa deterministic term create + attach
  • Featured image sideload + fallback davranışı
  • Webhook hızlandırma + idempotent event işleme
  • Tombstone algılama: trash + audit + noindex
  • WP-CLI operasyonları (`wp haberapi ...`)
  • Multisite network-aware ayar izolasyonu

Eklenti Hangi Alanları Doldurur?

API'den dönen içerik, SEO ve sınıflandırma alanları WordPress veri modeline otomatik eşlenir.

İçerik Alanları

  • Başlık
  • Özet/Excerpt
  • Body/Content
  • Canonical URL
  • Kaynak URL

SEO Alanları

  • SEO Title
  • SEO Spot
  • SEO Body
  • OG/Twitter başlık-açıklama
  • Structured data alanları

Öneri Paketleri

  • 5 Discover title önerisi
  • 5 Meta description önerisi
  • Story update değişim özeti

Sınıflandırma

  • Kategori
  • Tag
  • Topic
  • Entity
  • Geo city

Tema Uyumluluğu (Top6 + Generic)

Tema adapter katmanı ve render parity kontrolleri ile içeriklerin liste/single/archive davranışı doğrulanır.

Newspaper

Private fixture smoke + render parity

theme_adapter_mode: newspaper

Resmi

JNews

Private fixture smoke + render parity

theme_adapter_mode: jnews

Resmi

Astra

Public theme smoke + parity report

theme_adapter_mode: astra

Resmi

GeneratePress

Public theme smoke + parity report

theme_adapter_mode: generatepress

Resmi

Kadence

Public theme smoke + parity report

theme_adapter_mode: kadence

Resmi

News Magazine X

Public theme smoke + parity report

theme_adapter_mode: news-magazine-x

Yeni Resmi Destek

Generic

Pre-compat öneri seti + risk flag raporu

theme_adapter_mode: generic

Fallback

Kurulum Rehberi

Aşağıdaki adımlarla eklentiyi üretime hazır şekilde kurabilirsiniz.

1) Ön Koşullar

  • WordPress 6.4+
  • PHP 8.1+
  • Portal üzerinden aktif API key

2) Eklentiyi Yükle

ZIP paketini aşağıdaki butonla indirip yönetim panelinden veya WP-CLI ile kurabilirsiniz.

Eklentiyi İndirHesap Oluştur
# WP-CLI ile kurulum (publisher pro)
wp plugin install haberapi-publisher-pro-1.5.2.zip --activate

# WP-CLI ile kurulum (mirror)
wp plugin install haberapi-connector-1.0.0.zip --activate

3) API Key ve Senkron Ayarları

WordPress admin menüsünden HaberAPI > Settings ekranına girin:

  • API Key: portal'dan aldığınız key
  • API Base URL: https://haberapi.com.tr/v1
  • Update Service URL: https://haberapi.com.tr/wp-updates/v1
  • Update Channel: stable / beta / canary

4) Senkron Modunu Seç

New-only Sync (Önerilen başlangıç)

Yalnız yeni gelen haberleri düzenli aralıklarla içeri alır.

Full Backfill

Geçmişteki tüm havuzu batch/batch kuyruğa alarak içeri taşır.

# New-only tetikle
wp haberapi sync run

# Full backfill başlat
wp haberapi backfill run --from=2026-01-01T00:00:00Z

5) Tema ve Yayın Davranışını Doğrula

Hedef tema için parity durumunu kontrol edin ve update kanalınızı doğrulayın.

# Tema uyumluluğu kontrolü
wp haberapi theme-compat check --theme=news-magazine-x

# Render smoke
wp haberapi theme-compat render-smoke --theme=news-magazine-x

# New-only teşhis
wp haberapi sync verify-new-only --strict=1

Remote Update ve Güvenlik

Yeni plugin sürümleri private manifest servisi üzerinden otomatik bulunur ve doğrulanır.

Update Kanalları

  • Stable: genel müşteri dağıtımı (1.5.2)
  • Beta: erken erişim müşterileri (1.5.1-beta.1)
  • Canary: pilot tenant doğrulaması (1.5.1-canary.1)

Kanal erişimi tenant entitlement ve ring politikasına göre yönetilir.

Paket Doğrulama

  • SHA-256 checksum doğrulaması
  • Ed25519 imza doğrulaması
  • Başarısız doğrulamada kurulum iptali

Bu doğrulamalar kurulumdan önce çalışır ve audit kaydı bırakır.

Webhook Güvenliği

Webhook callback'leri X-Webhook-Timestamp ve X-Webhook-Signature ile doğrulanır.

signature = HMAC_SHA256(secret, timestamp + "." + raw_body)

Canlıya Geçiş Planı

Önce stable kanal ile pilot sitenizde doğrulayın, ardından kategori bazlı publish politikası ve full backfill ile üretime alın.

API Key AlPlugin ZIP İndirKurumsal Destek AlGeliştirici Dokümantasyonu

Teknik Kaynaklar