WordPress Eklentisi: LabelGrid Tools Kurulumu

Eylül 2026’da güncellendi.

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. Eklenti, LabelGrid’in akıllı bağlantı deneyimine ulaşmanın iki yolundan biridir: her yayının LabelGrid alan adında barındırılan bir açılış sayfası ve kısa bağlantısı zaten vardır (bkz. Yayın Açılış Sayfaları); bu eklenti ise aynı yayın sayfalarını (mağaza bağlantıları, Spotify ön kaydetme düğmeleri ve indirme geçitleri) kataloğunuzun tamamı ve sanatçı profillerinizle birlikte kendi markalı WordPress alan adınıza taşır.

Genel Bakış

Neler yapabilirsiniz

Bu özelliklerin herhangi birini sitenize bir kısa kod olarak, yerli bir Gutenberg bloğu olarak veya Elementor aracılığıyla yerleştirebilirsiniz (bkz. Blocks (Gutenberg) ve Elementor).

Ö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 tüm büyük dinleme platformlarına ve mağazalara 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	Spotify takip işlemleriyle 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 7.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

Eklentinin eski sürümleri için oluşturulan anahtarlar artık çalışmıyor

LabelGrid, eklentinin eski sürümleri için oluşturulmuş API anahtarlarını artık kabul etmiyor. Download gate’leriniz, pre-save’leriniz veya katalog eşitlemeniz çalışmayı bıraktıysa aşağıdaki adımlarla yeni bir anahtar oluşturun ve eklentiye yapıştırın. Başka bir şey değiştirmeniz gerekmez: mevcut gate’leriniz ve pre-save’leriniz ayarlarını korur.

Anahtar reddedildiği sürece Download Gate sekmesi eklenti ayarlarından kaybolur. Özellik kaldırılmadı; geçerli bir anahtar kaydeder kaydetmez sekme geri gelir.

Bu denetimi eklenti değil LabelGrid yapar, dolayısıyla tüm sürümler etkilenir. Hâlâ 1.5.0 veya 1.6.0 kullanan siteler uyarısız kalmaz: tek bir eski ve daha az açık banner gösterirler, LabelGrid API DISABLED: Verify the API Token is correct and that your account is enabled for LabelGrid API Services., ve bu da aynı sorunu anlatır. Tüm mesajları ve anlamlarını sorun giderme bölümünde bulabilirsiniz.

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ı

LabelGrid Tools Settings sayfasını açmak için WordPress yönetim panelinizde LabelGrid Tools → General Settings bölümüne gidin; bu, WordPress Settings altında değil, en üst düzey bir menü öğesidir. Ayarlar sayfasında altı sekme vardır:

Connection · Release Pages · Artist Pages · Links & Services · Download Gate · System

Download Gate yalnızca indirme geçidi etkinken görünür. Eklentinin geçerli bir API anahtarı yokken sekme tamamen gizlenir; sekme yoksa aşağıdaki sorun giderme bölümüne bakın.

Connection

Setting	Description
LabelGrid API Token	LabelGrid’den kopyaladığınız erişim token’ını yapıştırın. 1.6.1 sürümünden itibaren bu alan tek satırlıktır ve LabelGrid’in artık verdiği daha kısa anahtarlara uygundur
Automatic LabelGrid API Content Sync	Otomatik katalog eşitlemesini etkinleştirin veya devre dışı bırakın

Release Pages

Setting	Description
Show unreleased releases	Yaklaşan yayınları sitenizde gösterin
Spotify Pre-Save	Yayınlanmamış içerikte Spotify ön kayıt düğmelerini etkinleştirin
Spotify Pre-Save - Collect Email	No / Yes (obligatory) / Yes (optional): ön kayıt sırasında e-posta toplayın
iTunes / Apple Music / Beatport / Juno / Amazon Music Pre-Order	iTunes, Apple Music, Beatport, Juno ve Amazon için ön sipariş bağlantılarını etkinleştirin
Show Spotify Web Player	Yayın sayfalarında gömülü Spotify oynatıcısını gösterin
Show press release	Basın bülteni bölümlerini gösterin
Show featured artists	Yayın sayfalarında öne çıkan sanatçıları gösterin
Show similar releases	Benzer yayınları gösterin
Field below Artwork	Kapak görselinin altında ne gösterileceğini seçin: yayın kodu veya plak şirketi

Artist Pages

Setting	Description
Show Twitter feed	Sanatçı sayfalarında Twitter akışını gösterin
Show Bandsintown feed	Sanatçı sayfalarına Bandsintown akışı ekleyin

Links & Services

Setting	Description
Release services / Artist services	Yayın ve sanatçı sayfalarındaki streaming ve mağaza bağlantılarını sıralayın, gösterin veya gizleyin
Custom Services	Yayın ve sanatçı sayfalarında gösterilecek kendi servislerinizi ekleyin
Apple Performance Partner Program Token	Alışverişlerden komisyon kazanmak için iTunes ortaklık token’ınız

Download Gate

Setting	Description
Show press release	Basın görünürlüğü ayarları
Show featured artists	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
Gate button label	Geçit sihirbazı düğmesi için metin

System

Setting	Description
Error log level	Sorun giderme için günlük ayrıntı düzeyini belirleyin
Log Retention Days	Sistem günlüklerinin ne kadar süre saklanacağı
View System Logs	Kayıtlı sistem günlüklerini açın
System Information	Destek ekibiyle iletişime geçerken ekleyeceğiniz ortam bilgileri
Uninstall	Bir işlem değil, yalnızca bilgilendirme. Eklentiyi Eklentiler ekranından sildiğinizde API belirteci dahil ayarlarının ve günlük ile gate kayıt tablolarının silineceğini, buna karşılık sürümlerinizin, sanatçılarınızın, download gate’lerinizin ve alanlarının veritabanında kalacağını anlatır

---

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. Her kısa kodun, aynı seçeneklere sahip eşleşen bir Gutenberg bloğu da vardır (bkz. Blocks (Gutenberg)).

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 Release Pages ayarları sekmesinde “Spotify Pre-Save - Collect Email” seçeneğini etkinleştirin.

---

Geçit ve ön kayıt işlemleri

Bir indirme geçidi, indirme açılmadan önce hayranlardan Spotify’ı bağlamalarını ve bir ya da daha fazla işlemi tamamlamalarını ister. Ön kayıt her zaman yayının kendisini kaydeder ve bunun üstüne takip işlemleri ekleyebilir.

Kullanılabilen Spotify işlemleri şunlardır:

• Yayını kaydetme: ön kayıtta her zaman bulunur
• Bir sanatçıyı takip etme
• Bir çalma listesini takip etme
• Bir Spotify profilini takip etme: 1.6.0 ile geldi

Takip hedefleri artık yalnızca kendi kataloğunuzdaki sanatçılarla sınırlı değil; bir geçidi iş birliği yaptığınız veya konuk olan bir sanatçıya da yönlendirebilirsiniz.

SoundCloud ve Twitter işlemleri duraklatıldı

1.6.0 sürümünden itibaren indirme geçidi işlemleri yalnızca Spotify üzerinden yürür. SoundCloud ve Twitter işlemleri yeniden yazılırken duraklatıldı: artık çalışmıyor ve hayranlara görünmüyor, geçit ise Spotify işlemleriyle çalışmayı sürdürüyor.

Geçitlerinizden biri birden fazla servisin bağlanmasını istiyorduysa, eklenti artık yalnızca hâlâ kullanılabilen servisleri ister; aksi hâlde geçit hiçbir zaman tamamlanamazdı. Kayıtlı ayarınıza dokunulmaz ve diğer servisler geri geldiğinde yeniden geçerli olur. Daha önce birden fazla hesap isteyen her geçidi gözden geçirin ve kalan Spotify işlemlerinin hâlâ istediğiniz şeyi sorduğunu kontrol edin.

İşlemleri yalnızca SoundCloud veya Twitter olan bir geçit, isteyecek hiçbir şeyi kalmadığı için, siz ona bir Spotify işlemi ekleyene kadar hiç çalışmaz.

İşlem sınırları nasıl sayılır

Geçitler eskisinden çok daha fazla Spotify işlemi kabul eder ve geçit düzenleyici, siz düzenlerken kaç tane kullandığınızı gösterir.

Her bağlantı bir işlem sayılır. Üç çalma listesi bağlantısı içeren bir işlem satırı bir değil üç sayılır. Bir geçit sınıra yaklaştığında hesabın şaştığı yer tam olarak burasıdır.

Ön kayıt sırasında çalma listelerinde arama

Bir ön kayıt, yayını hayranın çalma listelerinden birine eklemeyi önerdiğinde, hayran listenin tamamını kaydırmak yerine kendi çalma listelerinde arama yapabilir.

---

Blocks (Gutenberg)

1.5.0 sürümünden itibaren LabelGrid Tools, her özellik için yerli blok düzenleyici blokları sunar. WordPress düzenleyicisinde blok ekleyiciye (+ düğmesi) tıklayın ve LabelGrid Tools kategorisine bakın, ya da bir bloğu adıyla arayın. Her bloğun seçeneklerini blok kenar çubuğunda ayarlayın: bunlar, eşleşen kısa kodunun kabul ettiği seçeneklerin aynısıdır.

Her kısa kod için bir tane olmak üzere 11 blok vardır:

Blok	Eşdeğer kısa kod	Ne yapar
LabelGrid Release List	[labelgrid-release-list]	Yayınlarınızın duyarlı ızgarası (sütunlar, sayfa başına öğe sayısı, etiket, sayfalandırma, başlık seçenekleri)
LabelGrid Release List Filter	[labelgrid-release-list-filter]	Tür filtresi (bir plak şirketi yapılandırıldığında ayrıca bir plak şirketi filtresi); aynı görünümde bir yayın listesiyle birlikte kullanın
LabelGrid Release Banner	[labelgrid-release-banner]	Bir yayını öne çıkaran tam genişlikte bir afiş: ana sayfalar için ideal
LabelGrid Release Links	[labelgrid-release-links]	Geçerli yayın için dinleme ve mağaza bağlantıları
LabelGrid Release Detail	[labelgrid-release-detail]	Tüm yayın gövdesi; bir Releases tekli şablonunda kullanın
LabelGrid Artist List	[labelgrid-artist-list]	Sanatçılarınızın duyarlı ızgarası
LabelGrid Artist Detail	[labelgrid-artist-detail]	Tüm sanatçı gövdesi; bir Artists tekli şablonunda kullanın
LabelGrid Gate Button	[labelgrid-gate-button]	İndirme geçidi düğmesi; yalnızca LabelGrid bağlantısı etkinken oluşturulur
LabelGrid Gate Download List	[labelgrid-gate-download-list]	Geçitli indirmelerin ızgarası; yalnızca bağlantı etkinken
LabelGrid Gate Download Detail	[labelgrid-gate-download-detail]	Tüm geçitli indirme gövdesi; yalnızca bağlantı etkinken
LabelGrid Presave Button	[labelgrid-presave-button]	Spotify ön kayıt düğmesi; yalnızca bağlantı etkinken ve yayın tarihi geçmemişken oluşturulur

Bloklar ve kısa kodlar birbirinin yerine kullanılabilir

Her blok, eşleşen kısa koduyla aynı oluşturucuyu sarmalar; bu nedenle bloklarla oluşturulan bir sayfa ile kısa kodlarla oluşturulan bir sayfa aynı çıktıyı üretir. Bloklar yalnızca eklemelidir: bir blok eklemek, onu eklemediğiniz bir sayfayı asla değiştirmez ve eklentiyi güncellediğinizde mevcut yayın ve sanatçı şablonlarınız değişmeden kalır. Kısa kodları mı tercih ediyorsunuz? Tam desteklenmeye devam ederler ve her temada çalışırlar.

Ayrıntının iki kez oluşturulmasından kaçının

Site Editor’daki (blok temalarında) tekli öğe şablonunda, Release Detail / Artist Detail bloğunu ya da WordPress’in Post Content (“İçerik”) bloğunu kullanın, ikisini birden değil. İkisini birden kullanmak, yayın veya sanatçı ayrıntısının iki kez oluşturulmasına neden olur.

Not

Gate Button, Gate Download List, Gate Download Detail ve Presave Button blokları yalnızca etkin bir plana sahip bir LabelGrid hesabına bağlı sitelerde oluşturulur.

---

Elementor

Her LabelGrid Tools özelliği bir kısa kod olarak da kullanılabilir ve Elementor’ın yerleşik Shortcode widget’ı — Elementor’ın ücretsiz sürümüne dahildir — herhangi bir özelliği ekstra bir eklenti olmadan bir sayfaya yerleştirir. Aşağıda açıklanan Theme Builder yöntemi bundan farklıdır: tekli şablonlar, görüntüleme koşulları ve Post Content widget’ı Elementor Pro özellikleridir. Elementor’ın ücretsiz sürümünde bunun yerine herhangi bir sayfada bir Shortcode widget’ı kullanın; ayrıca eklentinin yerleşik yayın ve sanatçı sayfaları, herhangi bir Elementor şablonu olmadan da kendiliğinden oluşturulur.

Elementor Pro’nun Theme Builder’ıyla yayın ve sanatçı sayfaları oluşturmak için:

1. Bir Theme Builder → Single şablonu oluşturun ve görüntüleme koşulunu Releases (ve/veya Artists) olarak ayarlayın.
2. Yayın veya sanatçı gövdesi için [labelgrid-release-detail] / [labelgrid-artist-detail] içeren bir Shortcode widget’ı kullanın; bu yöntem ayrıntıyı her zaman oluşturur. Post Content widget’ı da çoğu yapılandırmada ayrıntıyı oluşturur. Birini kullanın, asla ikisini birden değil, yoksa ayrıntı iki kez oluşturulur.
3. Yayın ızgaralarını, afişleri, sanatçı listelerini, akıllı bağlantı düğmelerini, ön kayıtları ve indirme geçitlerini, düzeninizin başka herhangi bir yerine Shortcode widget’ıyla ekleyin.

Not

İndirme geçidi ve ön kayıt özellikleri yalnızca etkin bir plana sahip bir LabelGrid hesabına bağlı sitelerde oluşturulur.

---

Yayın ve sanatçı sayfaları için kendi tema şablonunuzu kullanma

Varsayılan olarak eklenti, kendi düzenini sayfa içeriğine ekleyerek yayın ve sanatçı tekli sayfalarını oluşturur; böylece hiçbir tema değişikliği yapmadan çalışırlar. Bu sayfaları temanızda oluşturmayı tercih ederseniz eklenti geri çekilebilir ve klasik bir PHP şablonunun bunları oluşturmasına izin verebilir.

Klasik bir temada oluşturmayı devralmak için:

1. Temanızın functions.php dosyasına add_theme_support( 'labelgrid-tools-templates' ); satırını ekleyin.
2. Temanıza klasik bir single-release.php ve/veya single-artist.php şablonu ekleyin.

Bir tema hem katılım sağladığında hem de eşleşen şablonu sunduğunda eklenti, şablonunuzun devraldığını algılar ve kendi içerik eklemesini bastırır; böylece sayfa, tekrarlanan bir düzen olmadan şablonunuzdan tek seferde oluşturulur. Yayın veya sanatçı gövdesini, şablonunuzun içinde Release Detail / Artist Detail blokları veya [labelgrid-release-detail] / [labelgrid-artist-detail] kısa kodlarıyla istediğiniz yere yerleştirin.

Katılımı istek başına lgt_use_theme_templates filtresiyle de değiştirebilirsiniz. Bu filtre geçerli katılım değerini ve geçerli gönderiyi alır, true veya false döndürür; böylece tema şablonunuzu yalnızca bazı yayınlar veya sanatçılar için etkinleştirebilirsiniz.

Not

Bu geçersiz kılma yalnızca klasik PHP şablonları için geçerlidir. Yayın ve sanatçı sayfalarını bir blok temasının Site Editor’ından devralmak henüz desteklenmemektedir ve planlanan bir eklemedir. Katılım sağlamayan siteler etkilenmez: yerleşik düzen tıpkı önceden olduğu gibi oluşturulmaya devam eder.

---

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

Kısa kodlar her temada ve sayfa oluşturucusunda çalışır. Aynı özellikler, yerli Gutenberg blokları olarak ve Elementor aracılığıyla da kullanılabilir (yukarıda bkz. Blocks (Gutenberg) ve Elementor).

---

Sorun Giderme

Gate’ler, pre-save’ler ve katalog eşitlemesi çalışmayı bıraktı

LabelGrid, eklentinin eski sürümleri için oluşturulmuş API anahtarlarını artık kabul etmiyor. Siz hiçbir şey değiştirmediğiniz hâlde download gate’ler, Spotify pre-save’leri veya katalog eşitlemesi durduysa neredeyse her zaman sebebi budur.

Çözüm: yeni bir anahtar oluşturup eklentiye yapıştırın. Adımlar ilk seferkiyle aynıdır ve yukarıdaki yapılandırma bölümünde yer alır. Mevcut gate’leriniz ve pre-save’leriniz ayarlarını koruduğu için yeniden kurmanız gereken bir şey yoktur.

Nasıl fark edersiniz:

• Download gate’ler, pre-save’ler ve katalog eşitlemesi çalışmayı bırakır.
• Download Gate sekmesi eklenti ayarlarında görünmez. Özellik kaldırılmadı; geçerli bir anahtar yokken sekme gizlenir ve yenisini kaydettiğinizde geri gelir.
• 1.6.1 sürümü WordPress yönetim panelinde üç belirli uyarıdan birini gösterir. 1.5.0 ve 1.6.0 dahil daha eski sürümler bunun yerine tek bir eski ve daha az açık uyarı gösterir — LabelGrid API DISABLED: Verify the API Token is correct and that your account is enabled for LabelGrid API Services. ve Set API in General Settings bağlantısı — ama tam olarak aynı şekilde etkilenir; çünkü denetim eklentide değil LabelGrid tarafında yapılır.

Eklentinin uyarıları ne anlama geliyor

1.6.1 sürümü üç mesajdan birini gösterir. Bunlardan ikisi LabelGrid API DISABLED: ifadesiyle başlar, bu yüzden harekete geçmeden önce cümlenin tamamını okuyun. Mesajlar burada İngilizce olarak alıntılanmıştır, çünkü eklenti şu anda bunları çevirmiyor.

Anahtarınızın değiştirilmesi gerekiyor:

LabelGrid API DISABLED: Your API key was rejected. Keys created for older versions of this plugin are no longer accepted — create a new API key in your LabelGrid account and paste it below.

Yapılandırma bölümündeki adımlarla yeni bir anahtar oluşturun ve eklentiye yapıştırın.

Henüz bir anahtar kaydedilmemiş:

LabelGrid API DISABLED: No API key is set, so gates, pre-saves and catalog sync are inactive.

Bir anahtar oluşturup eklenti ayarlarına yapıştırın.

Geçici bir bağlantı sorunu, anahtar sorunu değil:

LabelGrid API UNAVAILABLE: We could not reach LabelGrid to check your connection. This is usually temporary and your key is probably fine — the check runs again automatically.

Hangi sürümde olursanız olun, bağlantıyı hemen yeniden kontrol ettirmek için bir şeyi değiştirmeniz gerekir. Save Settings düğmesi, bir ayar gerçekten değişene kadar devre dışı kalır ve aynı anahtarı yeniden yapıştırmak değişiklik sayılmaz. Herhangi bir ayarı değiştirip kaydedin, sonra eski hâline getirip yeniden kaydedin. System sekmesindeki Log Retention Days bunun için uygundur, çünkü başka hiçbir şeyi etkilemez. Her kayıt yeni bir bağlantı denetimi başlatır ve siteniz tam olarak eski hâliyle kalır.

1.6.2 sürümünden itibaren, kayıtlı bir anahtar olduğu sürece günlük arka plan denetimi de kendiliğinden yeniden çalışır. Kesintisi ya da istek sınırı geçmiş bir site, kimse dokunmadan kendini toparlar. 1.5.0, 1.6.0 ve 1.6.1’de bu hiç olmuyordu: eklenti kendini devre dışı bıraktıktan sonra, biri ayarları elle kaydedene kadar günlük denetim bağlantı testini atlıyordu.

Bu yalnızca bağlantı sorunları için geçerlidir. Reddedilen bir anahtar hiçbir sürümde kendiliğinden düzelmez; yukarıdaki “Anahtarınızın değiştirilmesi gerekiyor” bölümüne bakın. Sorun sürerse aşağıdaki API bağlantı hataları bölümüne bakın.

Yayınlar görünmüyor

1. LabelGrid Tools → General Settings bölümüne gidin (WordPress Settings altında değil, en üst düzey menü) ve API token’ınızın doğru girildiğini doğrulayın
2. Connection 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. LabelGrid Tools → General Settings → System 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 api.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

---

SSS

”LabelGrid Tools WordPress eklentisi nedir?”

LabelGrid Tools, LabelGrid’in resmi WordPress eklentisidir. Yayın kataloğunuzu, sanatçı profillerinizi ve indirme geçitlerinizi LabelGrid’den WordPress sitenize her 6 saatte bir otomatik olarak eşitler; ayrıca akıllı bağlantılı yayın sayfaları, Spotify ön kayıt düğmeleri ve geçitli indirmeler ekler. Eklenti, WordPress Eklenti Dizini’nde bulunur.

”WordPress eklentisini kullanmak için ücretli ya da API planı gerekiyor mu?”

Hayır, LabelGrid Tools tüm LabelGrid hesaplarına ek ücret olmadan sunulur ve API planı gerekmez. Sağladığı Gate özellikleri tüm standart ve API planlarına dahildir; dağıtım olmadan yalnızca WordPress entegrasyonu isteyen kullanıcılar için ayrıca bağımsız bir Gate planı vardır.

”Eklentiyi nasıl kurar ve bağlarım?”

WordPress’te Plugins, ardından Add New bölümünden LabelGrid Tools’u kurun ve etkinleştirin. LabelGrid’de kullanıcı menünüzü, ardından Wordpress ve Configure Plugin seçeneklerini açın, alan adınız için bir yetkilendirme anahtarı oluşturun ve erişim token’ını eklentinin Connection ayarlar sekmesine yapıştırın. Her anahtar tek bir alan adına bağlıdır.

”Eklenti kataloğumu ne sıklıkta eşitler?”

Eklenti; yayınlarınızı, sanatçılarınızı ve indirme geçitlerinizi LabelGrid’den her 6 saatte bir eşitler. Doğruluğun kaynağı LabelGrid’dir, bu nedenle tüm katalog düzenlemelerini LabelGrid’de yapın; eşitlenen WordPress gönderilerinde doğrudan yapılan değişikliklerin üzerine bir sonraki eşitlemede yazılır.

”Eklentiyle siteme Spotify ön kaydı ekleyebilir miyim?”

Evet. Release Pages ayarlar sekmesinde Spotify ön kaydını etkinleştirin ve yaklaşan bir yayının sayfasına [labelgrid-presave-button] kısa kodunu yerleştirin. Ziyaretçiler yayını ön kaydedebilir, isterlerse sanatçıyı ve bir çalma listesini takip edebilir; ön kayıt akışı sırasında e-posta da toplayabilirsiniz.

”Gutenberg bloklarını veya Elementor’ı kullanabilir miyim, yoksa yalnızca kısa kodları mı?”

Üçü de. 1.5.0 sürümünden itibaren her özellik bir kısa kod olarak, blok ekleyicide LabelGrid Tools kategorisinde bulabileceğiniz yerli bir Gutenberg bloğu olarak ve Elementor’ın Shortcode widget’ı aracılığıyla kullanılabilir. Her blok, eşleşen kısa koduyla aynı çıktıyı oluşturur ve kısa kodlar her temada çalışmaya devam eder.

---

İ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. Ayrıca bkz. Ön Kaydetme Kampanyaları.

---

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.