WordPress Eklentisi

LabelGrid Tools, yayın kataloğunuzu, sanatçı profillerinizi ve indirme geçitlerinizi LabelGrid’den WordPress sitenize otomatik olarak eşitleyen resmi WordPress eklentisidir. Doğruluğun kaynağı LabelGrid’dir; eklenti verilerinizi her 6 saatte bir aktarır, böylece web siteniz her zaman en güncel kataloğunuzu yansıtır.

Her planda kullanılabilir

LabelGrid Tools, tüm LabelGrid hesaplarına ek ücret olmadan sunulur; API planı gerekmez. Şu anda herhangi bir planda web sitenize Spotify ön kaydı eklemenin yoludur. Eklenti gerektirmeyen, uygulama içi bağımsız bir ön kayıt sayfası ileride planlanmaktadır.

Genel Bakış

Neler yapabilirsiniz

Özellik	Açıklama
Otomatik katalog eşitleme	Yayınlar, sanatçılar ve indirme geçitleri LabelGrid’den her 6 saatte bir eşitlenir
Yayın sayfaları	Kapak görseli ve 25’ten fazla dinleme platformuna ve mağazaya bağlantı içeren açılış sayfaları
Sanatçı profilleri	Biyografi, sosyal medya bağlantıları ve diskografi içeren sanatçı sayfaları
Yayın ızgaraları	Kataloğunuzun türe, etikete veya sanatçıya göre filtrelenebilir ızgaraları
Yayın afişleri	En son veya öne çıkan yayınlarınızı sergileyen ana sayfa afişleri
Spotify ön kaydı	Çalma listesi ve sanatçı takip işlemleriyle ön kayıt düğmeleri
Ön siparişler	iTunes, Apple Music, Beatport, Juno ve Amazon ön sipariş desteği
İndirme geçitleri	Sosyal medya takip işlemleriyle (Spotify, Twitter, SoundCloud) e-posta toplama geçitleri
Spotify Web Player	Yayın sayfalarında gömülü Spotify oynatıcısı
Basın bültenleri	Yayın sayfalarında ayrı basın bülteni bölümleri
iTunes ortaklık bağlantıları	Siteniz üzerinden yapılan iTunes alışverişlerinden komisyon kazanın
Yoast SEO entegrasyonu	Sosyal medya paylaşımı için Open Graph meta verileri

Gereksinimler

• WordPress 5.0 veya üzeri
• PHP 8.0 veya üzeri
• Etkin bir LabelGrid hesabı (API planı gerekmez)

---

Kurulum

WordPress yönetim panelinden

1. Plugins → Add New bölümüne gidin
2. “LabelGrid Tools” araması yapın
3. Install Now düğmesine tıklayın
4. Activate düğmesine tıklayın

Manuel kurulum

1. Eklentiyi LabelGrid’den indirin
2. Plugins → Add New → Upload Plugin bölümüne gidin
3. İndirdiğiniz ZIP dosyasını seçin
4. Install Now düğmesine tıklayın
5. Activate düğmesine tıklayın

---

Yapılandırma

API anahtarınızı edinme

Eklentiyi yapılandırmadan önce LabelGrid’de bir yetkilendirme anahtarı oluşturun:

1. LabelGrid’e giriş yapın
2. Kullanıcı menünüze tıklayın (sağ üst köşedeki adınız/avatarınız)
3. Açılır menüden Wordpress seçeneğine tıklayın
4. Configure Plugin düğmesine tıklayın
5. Step 1: Create Key bölümünde hangi etiketlerin dâhil edileceğini seçin:
   • Kataloğunuzun tamamını eşitlemek için All My Labels seçeneğini seçin
   • Ya da web sitenizde görünecekleri sınırlamak için belirli etiketleri seçin
6. Create New Key düğmesine tıklayın
7. WordPress sitenizin alan adını girin (ör. https://yoursite.com)
8. Anahtarı oluşturmak için OK düğmesine tıklayın
9. Erişim token’ını kopyalayın; bunu WordPress için kullanacaksınız

Dikkat

Her anahtar belirli bir alan adına bağlıdır. Birden fazla WordPress siteniz varsa, her biri için ayrı bir anahtar oluşturun.

Eklenti ayarları

WordPress yönetim panelinizde Settings → LabelGrid Tools bölümüne gidin. Ayarlar sayfasında dört sekme vardır:

LabelGrid GATE sekmesi

Ayar	Açıklama
API Token	LabelGrid’den kopyaladığınız erişim token’ını yapıştırın

General Options sekmesi

Ayar	Açıklama
Debug level	Sorun giderme için günlük ayrıntı düzeyini belirleyin
Log retention	Sistem günlüklerinin ne kadar süre saklanacağı
Auto-sync	Otomatik katalog eşitlemesini etkinleştirin veya devre dışı bırakın
iTunes Affiliate Token	Alışverişlerden komisyon kazanmak için iTunes ortaklık token’ınız

Releases sekmesi

Ayar	Açıklama
Show unreleased	Yaklaşan yayınları sitenizde gösterin
Spotify pre-save	Yayınlanmamış içerikte Spotify ön kayıt düğmelerini etkinleştirin
Pre-save email collection	No / Yes (obligatory) / Yes (optional): ön kayıt sırasında e-posta toplayın
Pre-orders	iTunes, Apple Music, Beatport, Juno ve Amazon için ön sipariş bağlantılarını etkinleştirin
Spotify Web Player	Yayın sayfalarında gömülü Spotify oynatıcısını gösterin
Press release	Basın bülteni bölümlerini gösterin
Featured artists	Yayın sayfalarında öne çıkan sanatçıları gösterin
Similar releases	Benzer yayınları gösterin
Show below artwork	Kapak görselinin altında ne gösterileceğini seçin: yayın kodu veya plak şirketi
Twitter feed on artists	Sanatçı sayfalarında Twitter akışını gösterin

Download Gate sekmesi

Ayar	Açıklama
Press	Basın görünürlüğü ayarları
Artists visibility	Geçit sayfalarında sanatçı gösterimini denetleyin
Button label	Geçit düğmeleri için özel metin
Welcome title	Geçit açılış sayfasında gösterilen başlık
Welcome description	Geçit açılış sayfası için açıklama metni
Wizard button label	Geçit sihirbazı düğmesi için metin

---

Katalog eşitleme

Eklenti, kataloğunuzu LabelGrid’den her 6 saatte bir otomatik olarak eşitler. Buna yayınlar, sanatçılar ve indirme geçitleri dâhildir.

Eklenti, WordPress’te üç özel gönderi türü (custom post type) oluşturur:

Gönderi türü	Açıklama	URL yapısı
Release	Kapak görseli, meta veriler ve platform bağlantıları içeren müzik yayınları	/release/release-name/
Artist	Biyografi ve sosyal medya bağlantıları içeren sanatçı profilleri	/artist/artist-name/
Gate Download	E-posta toplamalı indirme geçitleri	/free-download/gate-name/

İndirme geçitleri, geçitlerinizi gruplara ayırmanız için bir Gate Category sınıflandırması (taxonomy) da destekler.

Not

Doğruluğun kaynağı LabelGrid’dir. WordPress’te yayın veya sanatçı gönderilerinde yaptığınız düzenlemeler, bir sonraki eşitlemede üzerine yazılır. Tüm katalog değişikliklerini LabelGrid’de yapın.

---

Kısa kodlar (shortcode)

Eklenti, dört kategoride düzenlenmiş 11 kısa kod sunar: yayınlar, sanatçılar, indirme geçitleri ve ön kayıt.

Yayın kısa kodları

[labelgrid-release-list]

Yayınlarınızı filtrelenebilir bir ızgarada gösterin.

Temel örnek:

[labelgrid-release-list items-page="12" items-row="4"]

Parametreler:

Parametre	Varsayılan	Açıklama
show-title	null	Yayın başlıklarını göster
label	null	Plak şirketine göre filtrele
items-page	12	Sayfa başına yayın sayısı
items-row	4	Satır başına sütun sayısı
pagination	null	Sayfalandırmayı etkinleştir
showcase-last	null	Vitrin (showcase) modunu etkinleştir
item-filter	released	Filtre türü: released veya unreleased
title-below	null	Başlığı kapak görselinin altına konumlandır
filter-artists	null	Sanatçı ID’lerine göre filtrele
exclude	null	Belirli yayın ID’lerini hariç tut
image-quality	lgt_artwork_medium	Görsel boyutu ön ayarı

Yaklaşan yayınları göster:

[labelgrid-release-list item-filter="unreleased" items-row="3"]

[labelgrid-release-list-filter]

Yayın ızgaranızın üzerine bir açılır filtre ekleyin. Bu kısa kodu, aynı sayfada [labelgrid-release-list] öncesine yerleştirin.

Temel örnek:

[labelgrid-release-list-filter]
[labelgrid-release-list items-page="12"]

Parametreler:

Parametre	Varsayılan	Açıklama
record_label	null	Bir plak şirketi filtresi açılır menüsü göster

[labelgrid-release-banner]

Bir veya daha fazla yayını öne çıkaran bir afiş gösterin; ana sayfalar için idealdir.

Temel örnek:

[labelgrid-release-banner items-page="1"]

Parametreler:

Parametre	Varsayılan	Açıklama
label	null	Plak şirketine göre filtrele
items-page	1	Gösterilecek yayın sayısı
item-filter	released	Filtre türü: released veya unreleased
item-order	DESC	Sıralama düzeni: DESC (en yeni önce) veya ASC
filter-artists	null	Sanatçı ID’lerine göre filtrele
exclude	null	Belirli yayın ID’lerini hariç tut

[labelgrid-release-links]

Belirli bir yayın için dinleme ve mağaza bağlantılarını gösterin. Bunu yayın sayfası şablonlarının içinde veya bir yayın ID’si belirterek herhangi bir sayfada kullanın.

Temel örnek:

[labelgrid-release-links]

Belirli bir yayınla:

[labelgrid-release-links release-id="123" artists="true"]

Parametreler:

Parametre	Varsayılan	Açıklama
release-id	Geçerli gönderi ID’si	Yayın gönderisinin ID’si
artists	null	Bağlantıların yanında sanatçı bilgisini göster

[labelgrid-release-detail]

Kapak görseli, meta veriler, platform bağlantıları ve gömülü oynatıcı dâhil tüm yayın ayrıntı sayfasını oluşturun. Bu kısa kod geçerli gönderiyi kullanır ve hiçbir parametre almaz.

Örnek (bir yayın şablonunda):

[labelgrid-release-detail]

Sanatçı kısa kodları

[labelgrid-artist-list]

Sanatçılarınızı ızgara düzeninde gösterin.

Temel örnek:

[labelgrid-artist-list items-page="8" items-row="4"]

Parametreler:

Parametre	Varsayılan	Açıklama
show-title	false	Sanatçı adlarını görsellerin altında göster
category	null	Kategoriye göre filtrele
items-page	12	Sayfa başına sanatçı sayısı
items-row	4	Satır başına sütun sayısı
pagination	null	Sayfalandırmayı etkinleştir
title-below	null	Başlığı görselin altına konumlandır

[labelgrid-artist-detail]

Biyografi, sosyal medya bağlantıları ve diskografi dâhil tüm sanatçı profil sayfasını oluşturun. Bu kısa kod geçerli gönderiyi kullanır ve hiçbir parametre almaz.

Örnek (bir sanatçı şablonunda):

[labelgrid-artist-detail]

İndirme geçidi kısa kodları

[labelgrid-gate-button]

Bir indirme geçidi düğmesi gösterin. Tıklandığında, ziyaretçi indirmeye erişmeden önce geçit akışından (e-posta toplama ve isteğe bağlı sosyal medya takipleri) geçer.

Temel örnek:

[labelgrid-gate-button]

Özel metinle:

[labelgrid-gate-button gate-id="45" button-label="Get Free Download" custom-class="my-button"]

Parametreler:

Parametre	Varsayılan	Açıklama
gate-id	Geçerli gönderi ID’si	İndirme geçidi gönderisinin ID’si
post-id	Geçerli gönderi ID’si	İlişkili yayın gönderisinin ID’si
button-label	null	Özel düğme metni
custom-class	null	Ek CSS sınıfı
download-text	null	Özel indirme düğmesi metni

[labelgrid-gate-download-list]

İndirme geçitlerinizi ızgara düzeninde gösterin.

Temel örnek:

[labelgrid-gate-download-list items-page="6" items-row="3"]

Parametreler:

Parametre	Varsayılan	Açıklama
show-title	false	Geçit başlıklarını göster
category	null	Geçit kategorisine göre filtrele
items-page	12	Sayfa başına öğe sayısı
items-row	4	Satır başına sütun sayısı
pagination	null	Sayfalandırmayı etkinleştir
title-below	null	Başlığı görselin altına konumlandır

[labelgrid-gate-download-detail]

Tüm indirme geçidi ayrıntı sayfasını oluşturun. Bu kısa kod geçerli gönderiyi kullanır ve hiçbir parametre almaz.

Örnek (bir geçit şablonunda):

[labelgrid-gate-download-detail]

Ön kayıt kısa kodu

[labelgrid-presave-button]

Yaklaşan bir yayın için bir Spotify ön kayıt düğmesi gösterin. Ziyaretçiler yayını ön kayda alabilir ve isteğe bağlı olarak Spotify’da sanatçıyı ve bir çalma listesini takip edebilir.

Temel örnek:

[labelgrid-presave-button]

Belirli bir yayın için:

[labelgrid-presave-button release-id="123"]

Parametreler:

Parametre	Varsayılan	Açıklama
release-id	Geçerli gönderi ID’si	Yayın gönderisinin ID’si

İpucu

Ön kayıt akışı sırasında e-posta adresi toplamak için Releases ayarları sekmesinde “Pre-save email collection” seçeneğini etkinleştirin.

---

CSS sınıfları referansı

Eklenti, biçimlendirme için şu CSS sınıf öneklerini kullanır:

Sınıf	Öğe
.lgsquarelist	Yayın ve sanatçı listeleri için ızgara kapsayıcısı
.releaseelement	Tek bir yayın veya sanatçı kartı
.elementrow1 ila .elementrow8	Sütuna özel düzen (items-row ayarıyla eşleşir)
.elementrowx	Esnek düzen çeşidi
.spotify, .twitter, .youtube, .soundcloud, .facebook	Platform bağlantılarında hizmete özel biçimlendirme
.banner-*	Yayın afişi öğeleri
.gate, .gateimage, .freedownload	İndirme geçidi öğeleri

Not

Eklenti, Gutenberg blokları, Elementor widget’ları veya kenar çubuğu widget’ları içermez. İçeriği sayfalarınıza ve şablonlarınıza yerleştirmek için kısa kodları kullanın.

---

Sorun Giderme

Yayınlar görünmüyor

1. Settings → LabelGrid Tools bölümüne gidin ve API token’ınızın doğru girildiğini doğrulayın
2. General Options sekmesinde otomatik eşitlemenin etkin olduğunu kontrol edin
3. Bir sonraki eşitleme döngüsü için en fazla 6 saat bekleyin veya anında eşitlemeyi tetiklemek için eklentiyi devre dışı bırakıp yeniden etkinleştirin
4. Yayınların LabelGrid’de yayımlanmış olduğunu doğrulayın (taslak durumunda olmadığını)
5. Settings → LabelGrid Tools → General Options bölümüne gidip günlük ayrıntı düzeyini artırın, ardından günlükleri kontrol edin

Kısa kodlar düz metin olarak görünüyor

1. Eklentinin Plugins bölümünde etkin olduğundan emin olun
2. Kısa kod adlarında alt çizgi değil, tire kullandığınızı doğrulayın (ör. [labelgrid-release-list])
3. Kısa kod adında yazım hatası olup olmadığını kontrol edin

Biçimlendirme sorunları

1. Temanızla CSS çakışması olup olmadığını kontrol edin
2. Öğe sınıflarını incelemek için tarayıcınızın geliştirici araçlarını kullanın
3. Eklentinin sınıf adlarını hedefleyen özel CSS geçersiz kılmaları ekleyin (yukarıdaki CSS sınıfları referansına bakın)
4. Tema çakışmalarını ayıklamak için varsayılan bir WordPress temasıyla test edin

API bağlantı hataları

1. API token’ınızın geçerli ve süresi dolmamış olduğunu doğrulayın
2. LabelGrid hesabınızın etkin olduğunu onaylayın
3. Sunucunuzun gate.labelgrid.com adresine giden istekler yapabildiğini kontrol edin
4. Belirli hata mesajları için eklenti günlüklerini inceleyin

Geçit kayıtları ve dışa aktarımlar

İndirme geçidi kayıtları (toplanan e-posta adresleri), WordPress yönetim panelinden CSV olarak dışa aktarılabilir. İndirme geçidi gönderisine gidin ve dışa aktarma seçeneğini arayın.

---

Güncellemeler

Otomatik güncellemeler

1. WordPress yönetim panelinizde Plugins bölümüne gidin
2. “LabelGrid Tools” eklentisini bulun
3. Enable auto-updates seçeneğine tıklayın

Manuel güncellemeler

1. En son sürümü LabelGrid’den indirin
2. Plugins → Add New → Upload Plugin bölümüne gidin
3. Yeni ZIP dosyasını yükleyin
4. WordPress, mevcut sürümü değiştirmenizi isteyecektir
5. Replace current with uploaded seçeneğine tıklayın

---

İlgili konular

Web sitemizde LabelGrid Tools WordPress eklentisi hakkında daha fazla bilgi edinin: akıllı bağlantı açılış sayfaları, Spotify ön kayıt kampanyaları ve geçitli indirmeler.

---

Yardıma mı ihtiyacınız var?

WordPress eklentisiyle ilgili yardıma ihtiyacınız varsa, WordPress sürümünüz, PHP sürümünüz ve eklenti günlüklerindeki hata mesajlarına dair ayrıntılarla birlikte destek ekibimizle iletişime geçin.