Plugin WordPress

LabelGrid Tools adalah plugin WordPress resmi yang secara otomatis menyinkronkan katalog rilis, profil artis, dan download gate Anda dari LabelGrid ke situs web WordPress Anda. LabelGrid adalah sumber kebenaran: plugin mengimpor data Anda setiap 6 jam, sehingga situs web Anda selalu menampilkan katalog terbaru Anda.

Tersedia di semua paket

LabelGrid Tools tersedia untuk semua akun LabelGrid tanpa biaya tambahan; paket API tidak diperlukan. Saat ini, plugin inilah cara untuk menambahkan Spotify pre-save ke situs web Anda di paket apa pun. Halaman pre-save mandiri di dalam aplikasi (tanpa perlu plugin) sedang direncanakan untuk masa mendatang.

Gambaran Umum

Yang bisa Anda lakukan

Fitur	Deskripsi
Sinkronisasi katalog otomatis	Rilis, artis, dan download gate disinkronkan dari LabelGrid setiap 6 jam
Halaman rilis	Halaman arahan dengan artwork dan tautan ke 25+ platform streaming dan toko
Profil artis	Halaman artis dengan biografi, tautan media sosial, dan diskografi
Grid rilis	Grid katalog Anda yang bisa difilter berdasarkan genre, label, atau artis
Banner rilis	Banner beranda yang menampilkan rilis terbaru atau unggulan Anda
Spotify pre-save	Tombol pre-save dengan tindakan follow playlist dan artis
Pra-pesan	Dukungan untuk pra-pesan iTunes, Apple Music, Beatport, Juno, dan Amazon
Download gate	Gate pengumpulan email dengan tindakan follow media sosial (Spotify, Twitter, SoundCloud)
Spotify Web Player	Pemutar Spotify yang disematkan pada halaman rilis
Siaran pers	Bagian siaran pers khusus pada halaman rilis
Tautan afiliasi iTunes	Dapatkan komisi atas pembelian iTunes melalui situs Anda
Integrasi Yoast SEO	Metadata Open Graph untuk berbagi di media sosial

Persyaratan

• WordPress 5.0 atau lebih tinggi
• PHP 8.0 atau lebih tinggi
• Akun LabelGrid yang aktif (tidak memerlukan paket API)

---

Pemasangan

Dari admin WordPress

1. Buka Plugins → Add New
2. Cari “LabelGrid Tools”
3. Klik Install Now
4. Klik Activate

Pemasangan manual

1. Unduh plugin dari LabelGrid
2. Buka Plugins → Add New → Upload Plugin
3. Pilih berkas ZIP yang sudah diunduh
4. Klik Install Now
5. Klik Activate

---

Konfigurasi

Mendapatkan kunci API Anda

Sebelum mengonfigurasi plugin, buat kunci otorisasi di LabelGrid:

1. Masuk ke LabelGrid
2. Klik menu pengguna Anda (nama/avatar Anda di pojok kanan atas)
3. Klik Wordpress dari menu turun
4. Klik tombol Configure Plugin
5. Pada Step 1: Create Key, pilih label mana yang akan disertakan:
   • Pilih All My Labels untuk menyinkronkan seluruh katalog Anda
   • Atau pilih label tertentu untuk membatasi apa yang muncul di situs web Anda
6. Klik Create New Key
7. Masukkan domain situs web WordPress Anda (mis. https://yoursite.com)
8. Klik OK untuk membuat kunci
9. Salin token akses; Anda akan membutuhkannya untuk WordPress

Perhatian

Setiap kunci terikat pada satu domain tertentu. Jika Anda memiliki beberapa situs WordPress, buat kunci terpisah untuk masing-masing.

Pengaturan plugin

Buka Settings → LabelGrid Tools di admin WordPress Anda. Halaman pengaturan memiliki empat tab:

Tab LabelGrid GATE

Pengaturan	Deskripsi
API Token	Tempel token akses yang Anda salin dari LabelGrid

Tab General Options

Pengaturan	Deskripsi
Debug level	Atur tingkat detail pencatatan untuk pemecahan masalah
Log retention	Berapa lama log sistem disimpan
Auto-sync	Aktifkan atau nonaktifkan sinkronisasi katalog otomatis
iTunes Affiliate Token	Token afiliasi iTunes Anda untuk mendapatkan komisi atas pembelian

Tab Releases

Pengaturan	Deskripsi
Show unreleased	Tampilkan rilis mendatang di situs Anda
Spotify pre-save	Aktifkan tombol Spotify pre-save pada konten yang belum dirilis
Pre-save email collection	No / Yes (obligatory) / Yes (optional): kumpulkan email selama proses pre-save
Pre-orders	Aktifkan tautan pra-pesan untuk iTunes, Apple Music, Beatport, Juno, dan Amazon
Spotify Web Player	Tampilkan pemutar Spotify yang disematkan pada halaman rilis
Press release	Tampilkan bagian siaran pers
Featured artists	Tampilkan artis unggulan pada halaman rilis
Similar releases	Tampilkan rilis serupa
Show below artwork	Pilih apa yang ditampilkan di bawah artwork: kode rilis atau label rekaman
Twitter feed on artists	Tampilkan feed Twitter pada halaman artis

Tab Download Gate

Pengaturan	Deskripsi
Press	Pengaturan visibilitas pers
Artists visibility	Kendalikan tampilan artis pada halaman gate
Button label	Teks khusus untuk tombol gate
Welcome title	Judul yang ditampilkan pada halaman arahan gate
Welcome description	Teks deskripsi untuk halaman arahan gate
Wizard button label	Teks untuk tombol wizard gate

---

Sinkronisasi katalog

Plugin secara otomatis menyinkronkan katalog Anda dari LabelGrid setiap 6 jam. Ini mencakup rilis, artis, dan download gate.

Plugin membuat tiga jenis post kustom di WordPress:

Jenis post	Deskripsi	Struktur URL
Release	Rilis musik dengan artwork, metadata, dan tautan platform	/release/release-name/
Artist	Profil artis dengan biografi dan tautan media sosial	/artist/artist-name/
Gate Download	Download gate dengan pengumpulan email	/free-download/gate-name/

Download gate juga mendukung taksonomi Gate Category untuk mengelompokkan gate Anda ke dalam grup.

Catatan

LabelGrid adalah sumber kebenaran. Suntingan yang Anda buat pada post rilis atau artis di WordPress akan ditimpa pada sinkronisasi berikutnya. Lakukan semua perubahan katalog di LabelGrid.

---

Shortcode

Plugin menyediakan 11 shortcode yang dikelompokkan ke dalam empat kategori: rilis, artis, download gate, dan pre-save.

Shortcode rilis

[labelgrid-release-list]

Tampilkan rilis Anda dalam grid yang bisa difilter.

Contoh dasar:

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

Parameter:

Parameter	Default	Deskripsi
show-title	null	Tampilkan judul rilis
label	null	Filter berdasarkan label rekaman
items-page	12	Jumlah rilis per halaman
items-row	4	Jumlah kolom per baris
pagination	null	Aktifkan paginasi
showcase-last	null	Aktifkan mode showcase
item-filter	released	Jenis filter: released atau unreleased
title-below	null	Posisikan judul di bawah artwork
filter-artists	null	Filter berdasarkan ID artis
exclude	null	Kecualikan ID rilis tertentu
image-quality	lgt_artwork_medium	Preset ukuran gambar

Tampilkan rilis mendatang:

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

[labelgrid-release-list-filter]

Tambahkan filter menu turun di atas grid rilis Anda. Tempatkan shortcode ini sebelum [labelgrid-release-list] pada halaman yang sama.

Contoh dasar:

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

Parameter:

Parameter	Default	Deskripsi
record_label	null	Tampilkan menu turun filter label rekaman

[labelgrid-release-banner]

Tampilkan banner yang menyorot satu rilis atau lebih, ideal untuk beranda.

Contoh dasar:

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

Parameter:

Parameter	Default	Deskripsi
label	null	Filter berdasarkan label rekaman
items-page	1	Jumlah rilis yang ditampilkan
item-filter	released	Jenis filter: released atau unreleased
item-order	DESC	Urutan: DESC (terbaru dulu) atau ASC
filter-artists	null	Filter berdasarkan ID artis
exclude	null	Kecualikan ID rilis tertentu

[labelgrid-release-links]

Tampilkan tautan streaming dan toko untuk rilis tertentu. Gunakan ini di dalam templat halaman rilis atau pada halaman mana pun dengan menentukan ID rilis.

Contoh dasar:

[labelgrid-release-links]

Dengan rilis tertentu:

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

Parameter:

Parameter	Default	Deskripsi
release-id	ID post saat ini	ID post rilis
artists	null	Tampilkan informasi artis di samping tautan

[labelgrid-release-detail]

Render halaman detail rilis lengkap, termasuk artwork, metadata, tautan platform, dan pemutar yang disematkan. Shortcode ini menggunakan post saat ini dan tidak menerima parameter.

Contoh (dalam templat rilis):

[labelgrid-release-detail]

Shortcode artis

[labelgrid-artist-list]

Tampilkan artis Anda dalam tata letak grid.

Contoh dasar:

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

Parameter:

Parameter	Default	Deskripsi
show-title	false	Tampilkan nama artis di bawah gambar
category	null	Filter berdasarkan kategori
items-page	12	Jumlah artis per halaman
items-row	4	Jumlah kolom per baris
pagination	null	Aktifkan paginasi
title-below	null	Posisikan judul di bawah gambar

[labelgrid-artist-detail]

Render halaman profil artis lengkap, termasuk biografi, tautan media sosial, dan diskografi. Shortcode ini menggunakan post saat ini dan tidak menerima parameter.

Contoh (dalam templat artis):

[labelgrid-artist-detail]

Shortcode download gate

[labelgrid-gate-button]

Tampilkan tombol download gate. Saat diklik, pengunjung melewati alur gate (pengumpulan email dan follow media sosial opsional) sebelum mendapatkan akses ke unduhan.

Contoh dasar:

[labelgrid-gate-button]

Dengan teks khusus:

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

Parameter:

Parameter	Default	Deskripsi
gate-id	ID post saat ini	ID post download gate
post-id	ID post saat ini	ID post rilis terkait
button-label	null	Teks tombol khusus
custom-class	null	Kelas CSS tambahan
download-text	null	Teks tombol unduh khusus

[labelgrid-gate-download-list]

Tampilkan download gate Anda dalam tata letak grid.

Contoh dasar:

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

Parameter:

Parameter	Default	Deskripsi
show-title	false	Tampilkan judul gate
category	null	Filter berdasarkan kategori gate
items-page	12	Item per halaman
items-row	4	Kolom per baris
pagination	null	Aktifkan paginasi
title-below	null	Posisikan judul di bawah gambar

[labelgrid-gate-download-detail]

Render halaman detail download gate lengkap. Shortcode ini menggunakan post saat ini dan tidak menerima parameter.

Contoh (dalam templat gate):

[labelgrid-gate-download-detail]

Shortcode pre-save

[labelgrid-presave-button]

Tampilkan tombol Spotify pre-save untuk rilis mendatang. Pengunjung dapat melakukan pre-save rilis dan secara opsional follow artis serta playlist di Spotify.

Contoh dasar:

[labelgrid-presave-button]

Untuk rilis tertentu:

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

Parameter:

Parameter	Default	Deskripsi
release-id	ID post saat ini	ID post rilis

Tips

Aktifkan “Pre-save email collection” di tab pengaturan Releases untuk mengumpulkan alamat email selama alur pre-save.

---

Referensi kelas CSS

Plugin menggunakan awalan kelas CSS berikut untuk pengaturan gaya:

Kelas	Elemen
.lgsquarelist	Wadah grid untuk daftar rilis dan artis
.releaseelement	Kartu rilis atau artis individual
.elementrow1 hingga .elementrow8	Tata letak khusus kolom (sesuai pengaturan items-row)
.elementrowx	Varian tata letak fleksibel
.spotify, .twitter, .youtube, .soundcloud, .facebook	Pengaturan gaya khusus layanan pada tautan platform
.banner-*	Elemen banner rilis
.gate, .gateimage, .freedownload	Elemen download gate

Catatan

Plugin tidak menyertakan blok Gutenberg, widget Elementor, atau widget sidebar. Gunakan shortcode untuk menempatkan konten di halaman dan templat Anda.

---

Pemecahan Masalah

Rilis tidak muncul

1. Buka Settings → LabelGrid Tools dan pastikan token API Anda dimasukkan dengan benar
2. Periksa apakah auto-sync diaktifkan di tab General Options
3. Tunggu hingga 6 jam untuk siklus sinkronisasi berikutnya, atau nonaktifkan lalu aktifkan kembali plugin untuk memicu sinkronisasi seketika
4. Pastikan rilis sudah dipublikasikan di LabelGrid (bukan berstatus draf)
5. Buka Settings → LabelGrid Tools → General Options lalu naikkan debug level, kemudian periksa log

Shortcode tampil sebagai teks biasa

1. Pastikan plugin sudah diaktifkan di Plugins
2. Pastikan Anda menggunakan tanda hubung pada nama shortcode (mis. [labelgrid-release-list]), bukan garis bawah
3. Periksa kesalahan ketik pada nama shortcode

Masalah pengaturan gaya

1. Periksa apakah ada konflik CSS dengan tema Anda
2. Gunakan alat pengembang peramban Anda untuk memeriksa kelas elemen
3. Tambahkan penggantian CSS khusus yang menargetkan nama kelas plugin (lihat referensi kelas CSS di atas)
4. Uji dengan tema WordPress default untuk mengisolasi konflik tema

Kesalahan koneksi API

1. Pastikan token API Anda valid dan belum kedaluwarsa
2. Pastikan akun LabelGrid Anda aktif
3. Periksa apakah server Anda dapat membuat permintaan keluar ke gate.labelgrid.com
4. Tinjau log plugin untuk pesan kesalahan spesifik

Entri gate dan ekspor

Entri download gate (alamat email yang dikumpulkan) dapat diekspor sebagai CSV dari admin WordPress. Buka post download gate dan cari opsi ekspor.

---

Pembaruan

Pembaruan otomatis

1. Buka Plugins di admin WordPress Anda
2. Temukan “LabelGrid Tools”
3. Klik Enable auto-updates

Pembaruan manual

1. Unduh versi terbaru dari LabelGrid
2. Buka Plugins → Add New → Upload Plugin
3. Unggah berkas ZIP baru
4. WordPress akan meminta Anda mengganti versi yang ada
5. Klik Replace current with uploaded

---

Terkait

Pelajari lebih lanjut tentang plugin WordPress LabelGrid Tools di situs web kami, mencakup halaman arahan smart-link, kampanye Spotify pre-save, dan unduhan ber-gate.

---

Butuh bantuan?

Jika Anda membutuhkan bantuan terkait plugin WordPress, hubungi tim dukungan kami dengan detail tentang versi WordPress, versi PHP, dan pesan kesalahan apa pun dari log plugin.