WordPress eklentisi

YHA WordPress Eklentisi: Kurulum, Ayarlar ve Sorun Giderme

YHA WordPress eklentisi ("Yazar Haber Ajansı", eklenti kodu yha-haber), Yazar Haber Ajansı abonelerinin ajans haberlerini kod yazmadan WordPress sitelerine aktarmasını sağlayan resmi eklentidir. Haberleri, fotoğrafları, düzeltmeleri ve iptalleri sitenize yazı olarak işler. Eklentiyi kurup YHA Abone'nin verdiği kurulum kodunu yapıştırdıktan sonra ajans kategorilerinin sitenizde hangi kategoriye düşeceğini seçer, haberlerin taslak olarak mı yoksa doğrudan yayın olarak mı ekleneceğine karar verirsiniz. Bu sayfa, YHA WordPress plugini için kurulumdan güncellemeye kadar tüm adımları anlatır.

Henüz bir WordPress haber siteniz yoksa önce WordPress haber sitesi kurma rehberimize göz atın. Eklenti dışındaki entegrasyon yollarının tamamı YHA geliştirici belgelerinde yer alıyor.

Eklenti ne yapar?

Eklenti sizin sitenizde çalışır ve ajansın API'sine anahtarla bağlanır. Temel görevleri şunlardır:

• Paketinizdeki haberleri ajansın akışından çeker; "Anlık" kipte ajans yeni haberde sitenizi dürter ve eklenti hemen çeker.
• Her haberi WordPress yazısı olarak oluşturur: başlık, spot, gövde, yayın tarihi ve kaynak notu.
• Fotoğrafları ortam kütüphanesine indirir; öne çıkan görsel ve galeri olarak atayabilir.
• Ajans kategorilerini ve illeri sitenizdeki kategorilerle eşler.
• Düzeltmeleri aynı yazıya işler, iptal edilen haberi yayından kaldırır, embargoya uyar.
• Yazıyı yayımladığınızda ajansa "yayınladım" bildirir; habere sonradan hukuki cevap ya da düzeltme gelirse bildirim yalnızca işaretleyen kurumlara gider.

Eklenti başka bağımlılık, dış kitaplık ya da izleme betiği içermez. Kendi entegrasyonunu yazmak isteyen geliştiriciler aynı verilere doğrudan YHA API üzerinden ulaşabilir; WordPress eklentisi de aynı yolu kullanır. Yalnızca besleme okumak isteyenler için YHA RSS ve Atom beslemeleri de vardır.

Gereksinimler

Çoklu sitede (multisite) her alt site kendi bağlantısıyla çalışır. Henüz aboneliğiniz yoksa YHA abonelik paketlerini inceleyip başvuru yapabilir veya teklif isteyebilirsiniz.

Eklentiyi edinme ve kurulum kodu

Eklenti WordPress.org dizininden değil, ajansın kendi kanalından dağıtılır. Paketi ve kurulum kodunu YHA Abone'deki entegrasyon sihirbazından alırsınız:

1. YHA Abone'de Çıkışlar · Entegrasyonlar · Yeni bağlantı → "WordPress" seçin.
2. Site adresinizi (https://…) yazın ve yayın biçimini seçin (taslak ya da doğrudan; asıl seçim eklentinin ayar sayfasındadır).
3. "Anlık bildirim"i açın ya da kapalı bırakın. Açıksa ajans yeni haberde sitenizi dürter; kapalıysa eklenti zamanlanmış görevle (WP-Cron) çeker.
4. Paketleri ve kategorileri seçin.
5. Kurulum kodunu (yhak1_…) kopyalayın. Kod yalnızca bir kez gösterilir; kaybederseniz entegrasyon ayrıntısında "Kurulum kodunu yenile" deyin.
6. "Eklentiyi indir" ile yha-haber-<sürüm>.zip paketini alın.

Kurulum kodu anahtarı, anlık bildirim sırrını ve entegrasyon kimliğini tek metinde taşır. API adresi koddan alınmaz, eklentide sabittir; sahte bir kod eklentiyi başka bir sunucuya yönlendiremez. Webhook'suz çalışmak isterseniz kurulum kodu yerine bir API anahtarı (yha_canli_…) da yapıştırabilirsiniz.

Yöntem 1: Yönetim panelinden zip yükleme

1. WordPress yönetim panelinde Eklentiler › Yeni Ekle sayfasına gidin.
2. Üstteki Eklenti Yükle düğmesine tıklayın, yha-haber-<sürüm>.zip dosyasını seçin ve Şimdi Kur deyin.
3. Kurulum bitince eklentiyi etkinleştirin.
4. Ayarlar › Yazar Haber Ajansı › Bağlantı sekmesinde kurulum kodunu yapıştırıp kaydedin. YHA Abone'deki sihirbaz "Bağlandı" dediğinde ilk haberler birkaç dakika içinde düşer.

WordPress'in eklenti yönetimiyle ilgili genel bilgileri resmi WordPress eklenti yönetimi belgesinde bulabilirsiniz.

Yöntem 2: FTP veya SFTP ile yükleme

Barındırıcınız zip yüklemeyi kısıtlıyorsa zip dosyasını bilgisayarınızda açın, çıkan yha-haber klasörünü FTP/SFTP istemcisiyle wp-content/plugins/ dizinine yükleyin, ardından Eklentiler sayfasında etkinleştirip kurulum kodunu girin.

Sırları wp-config.php'de tutmak

Kurulum kodundan gelen sırlar veritabanında şifreli saklanır. Daha güvenli yol, anahtarı ve imza sırrını wp-config.php'ye sabit olarak yazmaktır:

define( 'YHA_HABER_ANAHTAR', 'yha_canli_...' );
define( 'YHA_HABER_IMZA_SIRRI', 'whsec_...' );

Anahtarı kimseyle paylaşmayın, ekran görüntülerinde görünmesine izin vermeyin. Sızdığını düşünüyorsanız YHA Abone'den kurulum kodunu yenileyin.

Ayarlar

Eklentinin ayarları Ayarlar › Yazar Haber Ajansı sayfasında beş sekmededir:

Kategori eşleme

Ajans haberleri kendi kategorileriyle gelir. Eşleme sekmesinde her ajans kategorisi için sitenizdeki karşılığını seçersiniz:

Ajansın diğer kategorileri Asayiş, Sağlık, Eğitim, Kültür ve Sanat, Yaşam ve Çevre'dir. İpuçları:

• Eşlenmemiş ajans kategorilerinin haberleri varsayılan kategoriye düşer. Bir kategoriyi hiç almak istemiyorsanız onu YHA Abone'deki bağlantının kategori seçiminden çıkarın.
• Birden fazla ajans kategorisini tek bir site kategorisine bağlayabilirsiniz; il eşlemesiyle yerel kategorileri de besleyebilirsiniz.
• Kategori yapınızı sık değiştirmeyin; her değişiklik eski haberlerin URL'lerini ve iç linklerini etkileyebilir.

Yayın biçimi: taslak mı, doğrudan mı?

Önerimiz, en azından başlangıçta taslak biçimini kullanmanızdır. Aynı ajans metni pek çok sitede yayınlandığı için arama sonuçlarında öne çıkmanın yolu habere kendi katkınızı eklemektir: özgün bir başlık, yerel bağlam, önceki haberlerinize bağlantı. Google'ın faydalı içerik oluşturma rehberi içeriğin okura özgün değer katmasını ister; ajans haberini editör dokunuşuyla yayınlamak bu beklentiyle uyumludur. Flaş haberleri öne çıkarmak için Yayın sekmesindeki flaş önekini kullanabilirsiniz.

Düzeltme ve iptal

Düzeltme geldiğinde eklenti aynı yazıyı günceller; editörünüzün yaptığı yerel değişikliklere nasıl davranılacağını Yayın sekmesindeki "düzeltme davranışı" ve "yerel değişiklik" ayarlarıyla belirlersiniz. İptal edilen haberin yazısı taslağa çekilir (başlığa "İPTAL: " eklenir) ya da çöp kutusuna gider ve yeniden yayımlanamaz.

Fotoğraf ve video

Eklenti paketinizin açtığı fotoğrafları ortam kütüphanenize indirir; fotoğraf seçeneğini, videoyu, öne çıkan görseli ve galeriyi Yayın sekmesinde ayarlarsınız. Dikkat edilecekler:

• Fotoğraflar API'nin aylık indirme kotasına girer; kota dolarsa "kota" uyarısı görürsünüz.
• Fotoğraflar sitenizin diskinde yer kaplar; barındırma kotanızı ve dosya yükleme sınırını takip edin.
• Kullanım hakkı abonelik sözleşmenizle sınırlıdır.
• Alt metin boş kalıyorsa editör kontrolünde açıklayıcı bir alt metin ekleyin.

Kaynak gösterimi

Eklenti her yazının sonuna ajansın kaynak notunu, tanıtım içeriğinde de tanıtım uyarısını ekler; bu not kapatılamaz. Kaynak "Yazar Haber Ajansı" ya da "YHA" olarak görünür.

Aktarılan haberler için SEO ayarları

Eklenti haberi sitenize taşır; haberin arama sonuçlarında nasıl görüneceğini ise sitenizin SEO ayarları belirler:

• Başlık ve meta açıklama: Editör kontrolünde haberin başlığını okurunuza göre yeniden yazın; her haberin meta açıklaması benzersiz olmalı.
• Yapılandırılmış veri: Haber detay sayfalarında NewsArticle veya Article şeması kullanın; şemadaki yazar, tarih ve görsel bilgileri sayfada görünenlerle aynı olmalı.
• Haber site haritası: Aktarılan haberlerin de haber site haritasına girdiğinden emin olun.
• Etiket kullanımı: Ajanstan gelen her etiketi ayrı bir sayfaya dönüştürmeyin; çok sayıda tek haberli etiket sayfası düşük değerli sayfa sayısını artırır.
• İç bağlantı: Editör aktarılan habere aynı konudaki önceki haberlerinizden en az birine bağlantı ekleyebilir.

Önerilen editör iş akışı

1. Sabah taraması: Editör, gece boyunca taslak olarak düşen haberleri kategorilere göre gözden geçirir.
2. Seçim: Okur kitlenizi ilgilendiren haberler seçilir; her ajans haberini yayınlamak zorunda değilsiniz.
3. Zenginleştirme: Seçilen haberlere özgün başlık, kısa bir yerel bağlam paragrafı ve ilgili haber bağlantıları eklenir.
4. Görsel kontrolü: Öne çıkan görselin doğru kırpıldığı ve alt metninin açıklayıcı olduğu kontrol edilir.
5. Yayın: Haber yayınlanır; eklenti ajansa "yayınladım" bildirimini kendiliğinden gönderir.

Zamanlanmış çekme: WP-Cron ve sistem cron'u

Eklenti WP-Cron ile 5 dakikada bir, anlık bildirim açıkken 15 dakikada bir çeker. WP-Cron gerçek bir zamanlayıcı değildir; yalnızca siteye biri girdiğinde tetiklenir, bu yüzden az ziyaret alan sitede gecikebilir. WordPress'in cron belgesi düzenli çalışması gereken işler için sistem cron'unu anlatır. DISABLE_WP_CRON tanımlıysa ya da sitenize az ziyaret geliyorsa sistem cron'u kurun:

*/5 * * * * cd /var/www/site && wp cron event run --due-now >/dev/null 2>&1
# ya da
*/5 * * * * curl -s https://ornek-site.example/wp-cron.php?doing_wp_cron >/dev/null

WP-Cron'u tamamen sistem cron'una devretmek isterseniz wp-config.php'ye define( 'DISABLE_WP_CRON', true ); ekleyin. Son başarılı çekme üç aralıktan eskiyse yönetim ekranında sarı uyarı çıkar.

Anlık bildirim, güvenlik eklentileri ve REST yolu

Anlık kipte ajans sitenizin POST /wp-json/yha-haber/v1/bildirim yolunu imzalı bir istekle dürter; eklenti hemen akıştan çeker. Kalıcı bağlantılar kapalıysa yol /?rest_route=/yha-haber/v1/bildirim olur (eklenti doğru adresi ajansa bildirir). Ayrıntılar için YHA webhook bildirimleri sayfasına bakabilirsiniz.

Giriş zorunlu kılan güvenlik eklentileri ve barındırıcı güvenlik duvarları bu yolu engelleyebilir; "Bağlantıyı sına" 401 ya da 403 görürse "REST yolu engellenmiş" der. Yapılacaklar:

• Güvenlik eklentisinde /wp-json/yha-haber/ yolunu izinli yapın (yol yalnızca imzalı isteğe açıktır).
• Güvenlik duvarında ajansın çıkış adreslerine izin verin.
• Önbellek eklentileri /wp-json/ yollarını önbelleğe almamalıdır. Yeni haber yayınlandığında ana sayfa ve kategori önbelleğinin temizlendiğinden de emin olun.

Sorun giderme

Sorun ajans tarafındaysa durum bilgisini YHA servis durumu sayfasından takip edebilirsiniz. Çözemediğiniz durumlar için destek@yha.com.tr adresine eklenti sürümünüzü, WordPress ve PHP sürümünüzü ve Günlük sekmesindeki hata mesajını ileterek yazın.

Güncelleme ve gizlilik

• Eklenti güncellemeleri ajansın kendi kanalından gelir ve WordPress'in Güncellemeler ekranında görünür. Her paket imzalıdır; eklenti imzayı doğrulamadan kurmaz.
• Zorunlu güncellemede yönetim ekranında kapatılamaz bir uyarı çıkar.
• Güncellemeden önce site yedeği alın; büyük güncellemeleri mümkünse önce bir test ortamında deneyin.
• Eklenti ajansa yalnızca bağlantı durumunu gönderir (site adresi, WordPress, PHP ve eklenti sürümü, sayaçlar, son hatalar); kişi verisi göndermez. Bu bilgi eklentinin readme.txt dosyasında ve ayar sayfasında yazar.

Zamanlanmış görevlerin nasıl çalıştığını ve sistem cron'unun nasıl kurulduğunu cron job nedir? rehberinde ayrıntılı anlattık.

Sıkça Sorulan Sorular

YHA WordPress eklentisi ücretli mi?

Eklenti YHA abonelerinin kullanımı içindir; WordPress bağlantısı ve kullandığı API kanalı abonelik paketinize sözleşmeyle eklenir. Fiyatlar sitede yayımlanmaz, teklifle verilir.

Eklentiyi önce deneyebilir miyim?

Evet. Bağlantı sekmesinde ortamı "Deneme" seçip yha_deneme_… anahtarıyla bağlanırsanız eklenti yapay örnek içerikle çalışır; Sınama sekmesi uyumluluk sınamasının adımlarını gösterir. Bkz. Deneme ortamı.

Eklenti birden fazla sitede kullanılabilir mi?

Her site YHA Abone'de kendi bağlantısıyla (site adresi ve kurulum kodu) kurulur; çoklu sitede her alt site ayrı bağlanır. Ajans içeriğini kaç sitede yayımlayabileceğiniz abonelik sözleşmenize bağlıdır.

Haberleri yayınlamadan önce düzenleyebilir miyim?

Evet. Taslak biçiminde haberler yayına girmeden önce editörünüzün önüne düşer; başlığı, girişi ve görseli düzenleyebilir, yerel bilgi ekleyebilirsiniz.

Ajanstaki bir haber düzeltilirse sitemdeki yazı da güncellenir mi?

Evet; eklenti düzeltmeyi aynı yazıya işler. Editörünüzün yazıda yaptığı değişikliklerin korunup korunmayacağını Yayın sekmesindeki düzeltme davranışı ve yerel değişiklik ayarları belirler.

Eklenti sitemi yavaşlatır mı?

Haber çekme arka planda, zamanlanmış görev olarak ya da ajansın dürtmesiyle çalışır; okurların gördüğü sayfaların yüklenmesine doğrudan eklenmez. Sistem cron'u kullanmak, ziyaretçi isteklerinin cron işini tetiklemesini de önler.

Hangi haberlerin geleceğini nasıl seçerim?

Gelecek haberleri paketiniz ve YHA Abone'deki bağlantıda seçtiğiniz paketler ve kategoriler belirler; eklentideki eşleme ise haberlerin hangi WordPress kategorisine düşeceğini belirler. Paketinizde olmayan bir kategori için satış ekibiyle görüşmeniz gerekir.

Eklenti yerine RSS veya API kullanabilir miyim?

Evet. Kendi çözümünü yazmak isteyenler için YHA API ve beslemeleri hazırdır. RSS ile WordPress'e haber çekmenin genel yöntemleri için WordPress haber çekme rehberimize bakabilirsiniz; ancak genel RSS eklentileri düzeltme ve iptalleri işlemez.