Plugin WordPress: Penyiapan LabelGrid Tools

Diperbarui September 2026.

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. Plugin ini adalah satu dari dua cara mendapatkan pengalaman smart link LabelGrid: setiap rilisan sudah memiliki halaman arahan terhosting dan tautan pendek di domain LabelGrid (lihat Halaman Arahan Rilisan), dan plugin ini menghadirkan halaman per rilisan yang sama (tautan toko, tombol pre-save Spotify, dan download gate) di domain WordPress Anda sendiri, bersama seluruh katalog dan profil artis Anda.

Gambaran Umum

Yang bisa Anda lakukan

Anda dapat menempatkan salah satu dari fitur-fitur ini di situs Anda sebagai shortcode, sebagai blok Gutenberg native, atau melalui Elementor: lihat Blocks (Gutenberg) dan Elementor.

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 semua platform streaming dan toko besar
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 Spotify
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 7.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

Kunci yang dibuat untuk versi plugin lama tidak lagi berfungsi

LabelGrid tidak lagi menerima kunci API yang dibuat untuk versi plugin sebelumnya. Jika download gate, pre-save, atau sinkronisasi katalog Anda berhenti bekerja, buat kunci baru dengan langkah-langkah di bawah lalu tempelkan ke plugin. Tidak ada lagi yang perlu diubah: gate dan pre-save yang sudah ada tetap mempertahankan konfigurasinya.

Selama kunci ditolak, tab Download Gate hilang dari pengaturan plugin. Fiturnya tidak dihapus: tab itu muncul kembali begitu Anda menyimpan kunci yang valid.

Pemeriksaan ini dilakukan oleh LabelGrid, bukan oleh plugin, sehingga semua versi terpengaruh. Situs yang masih memakai 1.5.0 atau 1.6.0 tidak dibiarkan tanpa kabar: mereka menampilkan satu spanduk lama yang kurang spesifik, LabelGrid API DISABLED: Verify the API Token is correct and that your account is enabled for LabelGrid API Services., yang menjelaskan masalah yang sama. Semua pesan beserta artinya ada di bagian pemecahan masalah.

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 LabelGrid Tools → General Settings di admin WordPress Anda — ini item menu tingkat atas, bukan di bawah Settings WordPress — untuk membuka LabelGrid Tools Settings. Halaman pengaturan memiliki enam tab:

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

Download Gate hanya muncul ketika download gate aktif. Selama plugin belum memiliki kunci API yang valid, tab ini disembunyikan sepenuhnya, jadi jika tab itu tidak ada, lihat bagian pemecahan masalah di bawah.

Connection

Setting	Description
LabelGrid API Token	Tempel token akses yang Anda salin dari LabelGrid. Sejak 1.6.1 kolom ini satu baris saja, sesuai kunci yang lebih pendek yang kini diterbitkan LabelGrid
Automatic LabelGrid API Content Sync	Aktifkan atau nonaktifkan sinkronisasi katalog otomatis

Release Pages

Setting	Description
Show unreleased releases	Tampilkan rilis mendatang di situs Anda
Spotify Pre-Save	Aktifkan tombol Spotify pre-save pada konten yang belum dirilis
Spotify Pre-Save - Collect Email	No / Yes (obligatory) / Yes (optional): kumpulkan email selama proses pre-save
iTunes / Apple Music / Beatport / Juno / Amazon Music Pre-Order	Aktifkan tautan pra-pesan untuk iTunes, Apple Music, Beatport, Juno, dan Amazon
Show Spotify Web Player	Tampilkan pemutar Spotify yang disematkan pada halaman rilis
Show press release	Tampilkan bagian siaran pers
Show featured artists	Tampilkan artis unggulan pada halaman rilis
Show similar releases	Tampilkan rilis serupa
Field below Artwork	Pilih apa yang ditampilkan di bawah artwork: kode rilis atau label rekaman

Artist Pages

Setting	Description
Show Twitter feed	Tampilkan feed Twitter pada halaman artis
Show Bandsintown feed	Tampilkan feed Bandsintown di halaman artis

Links & Services

Setting	Description
Release services / Artist services	Atur urutan serta tampilkan atau sembunyikan tautan streaming dan toko di halaman rilis dan artis
Custom Services	Tambahkan layanan Anda sendiri untuk ditampilkan di halaman rilis dan artis
Apple Performance Partner Program Token	Token afiliasi iTunes Anda untuk mendapatkan komisi atas pembelian

Download Gate

Setting	Description
Show press release	Pengaturan visibilitas pers
Show featured artists	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
Gate button label	Teks untuk tombol wizard gate

System

Setting	Description
Error log level	Atur tingkat detail pencatatan untuk pemecahan masalah
Log Retention Days	Berapa lama log sistem disimpan
View System Logs	Buka log sistem yang tersimpan
System Information	Detail lingkungan untuk disertakan saat Anda menghubungi dukungan
Uninstall	Hanya informasi, tanpa tombol atau pengaturan. Bagian ini menjelaskan bahwa menghapus plugin dari layar Plugins akan menghapus pengaturannya termasuk token API, beserta tabel log dan entri gate, sementara rilis, artis, download gate, dan bidangnya tetap ada di basis data

---

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. Setiap shortcode juga memiliki blok Gutenberg padanan dengan opsi yang sama: lihat Blocks (Gutenberg).

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 “Spotify Pre-Save - Collect Email” di tab pengaturan Release Pages untuk mengumpulkan alamat email selama alur pre-save.

---

Tindakan gate dan pre-save

Download gate meminta penggemar menghubungkan Spotify dan menyelesaikan satu atau beberapa tindakan sebelum unduhan terbuka. Pre-save selalu menyimpan rilisnya sendiri, dan dapat menambahkan tindakan follow di atasnya.

Tindakan Spotify yang tersedia:

• Menyimpan rilis: selalu termasuk dalam pre-save
• Mengikuti artis
• Mengikuti playlist
• Mengikuti profil Spotify: baru pada 1.6.0

Target follow tidak lagi terbatas pada artis di katalog Anda sendiri, jadi Anda bisa mengarahkan gate ke kolaborator atau artis tamu.

Tindakan SoundCloud dan Twitter sedang dijeda

Sejak versi 1.6.0, tindakan download gate hanya Spotify. Tindakan SoundCloud dan Twitter dijeda selama dibangun ulang: keduanya tidak lagi berjalan dan tidak lagi tampil bagi penggemar, sementara gate tetap bekerja dengan tindakan Spotify-nya.

Jika salah satu gate Anda meminta penggemar menghubungkan lebih dari satu layanan, plugin kini hanya meminta layanan yang masih tersedia, karena kalau tidak gate itu tidak akan pernah bisa diselesaikan. Pengaturan tersimpan Anda tidak diubah dan berlaku lagi begitu layanan lain kembali. Tinjau setiap gate yang dulu mewajibkan lebih dari satu akun dan pastikan tindakan Spotify yang tersisa masih meminta hal yang Anda inginkan.

Gate yang tindakannya hanya SoundCloud atau Twitter tidak punya apa pun lagi untuk diminta, dan sama sekali tidak berjalan sampai Anda menambahkan tindakan Spotify.

Cara batas tindakan dihitung

Gate menerima jauh lebih banyak tindakan Spotify dibanding sebelumnya, dan editor gate menampilkan berapa yang sudah Anda pakai saat menyunting.

Setiap tautan dihitung satu tindakan. Satu baris tindakan yang berisi tiga tautan playlist dihitung tiga, bukan satu. Di sinilah perhitungan sering meleset ketika sebuah gate mendekati batas.

Mencari playlist saat pre-save

Ketika pre-save menawarkan untuk menambahkan rilis ke salah satu playlist penggemar, mereka dapat mencari playlist miliknya alih-alih menggulir seluruh daftar.

---

Blocks (Gutenberg)

Sejak versi 1.5.0, LabelGrid Tools menyertakan blok editor native untuk setiap fitur. Di editor WordPress, klik block inserter (tombol +) dan cari kategori LabelGrid Tools, atau cari blok berdasarkan namanya. Atur opsi setiap blok di sidebar blok: opsi yang sama seperti yang diterima oleh shortcode padanannya.

Ada 11 blok, satu untuk setiap shortcode:

Blok	Shortcode padanan	Fungsinya
LabelGrid Release List	[labelgrid-release-list]	Grid responsif berisi rilis Anda (kolom, item per halaman, label, paginasi, opsi judul)
LabelGrid Release List Filter	[labelgrid-release-list-filter]	Filter genre (plus filter label rekaman bila sebuah label dikonfigurasi); pasangkan dengan daftar rilis pada tampilan yang sama
LabelGrid Release Banner	[labelgrid-release-banner]	Banner selebar penuh yang menampilkan satu rilis, ideal untuk beranda
LabelGrid Release Links	[labelgrid-release-links]	Tautan streaming dan toko untuk rilis saat ini
LabelGrid Release Detail	[labelgrid-release-detail]	Isi lengkap halaman rilis; gunakan pada templat single Releases
LabelGrid Artist List	[labelgrid-artist-list]	Grid responsif berisi artis Anda
LabelGrid Artist Detail	[labelgrid-artist-detail]	Isi lengkap halaman artis; gunakan pada templat single Artists
LabelGrid Gate Button	[labelgrid-gate-button]	Tombol download gate; hanya tampil saat koneksi LabelGrid aktif
LabelGrid Gate Download List	[labelgrid-gate-download-list]	Grid unduhan ber-gate; hanya saat koneksi aktif
LabelGrid Gate Download Detail	[labelgrid-gate-download-detail]	Isi lengkap halaman download gate; hanya saat koneksi aktif
LabelGrid Presave Button	[labelgrid-presave-button]	Tombol pre-save Spotify; hanya tampil saat koneksi aktif dan tanggal rilis belum lewat

Blok dan shortcode dapat saling dipertukarkan

Setiap blok membungkus renderer yang sama dengan shortcode padanannya, sehingga halaman yang dibangun dengan blok dan halaman yang dibangun dengan shortcode menghasilkan output yang identik. Blok bersifat murni aditif: menambahkan blok tidak pernah mengubah halaman yang belum Anda tambahkan bloknya, dan templat rilis serta artis yang sudah ada tetap tidak berubah saat Anda memperbarui plugin. Lebih suka shortcode? Shortcode tetap didukung sepenuhnya dan berfungsi di tema apa pun.

Hindari merender detail dua kali

Pada templat satu-item di Site Editor (tema blok), gunakan salah satu blok Release Detail / Artist Detail atau blok Post Content (“Content”) milik WordPress, bukan keduanya. Menggunakan keduanya akan merender detail rilis atau artis dua kali.

Catatan

Blok Gate Button, Gate Download List, Gate Download Detail, dan Presave Button hanya tampil di situs yang terhubung ke akun LabelGrid dengan paket aktif.

---

Elementor

Setiap fitur LabelGrid Tools juga tersedia sebagai shortcode, dan widget Shortcode bawaan Elementor — bagian dari Elementor versi gratis — menempatkan salah satunya ke sebuah halaman tanpa add-on tambahan. Resep Theme Builder di bawah ini berbeda: templat Single, kondisi tampilan, dan widget Post Content adalah fitur Elementor Pro. Dengan Elementor versi gratis, gunakan saja widget Shortcode di halaman mana pun — dan halaman rilis serta artis bawaan plugin sudah dirender dengan sendirinya, tanpa templat Elementor sama sekali.

Untuk membangun halaman rilis dan artis dengan Theme Builder milik Elementor Pro:

1. Buat templat Theme Builder → Single dan atur kondisi tampilannya ke Releases (dan/atau Artists).
2. Untuk isi halaman rilis atau artis, gunakan widget Shortcode berisi [labelgrid-release-detail] / [labelgrid-artist-detail] — cara ini selalu merender detailnya. Widget Post Content juga merendernya pada sebagian besar penyiapan. Pilih salah satu, jangan pernah keduanya, atau detailnya akan dirender dua kali.
3. Tambahkan grid rilis, banner, daftar artis, tombol smart-link, pre-save, dan download gate di bagian lain tata letak Anda dengan widget Shortcode.

Catatan

Fitur download gate dan pre-save hanya tampil di situs yang terhubung ke akun LabelGrid dengan paket aktif.

---

Menggunakan templat tema Anda sendiri untuk halaman rilis dan artis

Secara default, plugin merender halaman single rilis dan artis dengan menyisipkan tata letaknya sendiri ke dalam konten halaman, sehingga berfungsi tanpa perubahan tema apa pun. Jika Anda lebih suka membangun halaman ini di tema Anda, plugin dapat mundur dan membiarkan templat PHP klasik yang merendernya.

Untuk mengambil alih rendering di tema klasik:

1. Tambahkan add_theme_support( 'labelgrid-tools-templates' ); ke functions.php tema Anda.
2. Tambahkan templat klasik single-release.php dan/atau single-artist.php ke tema Anda.

Ketika sebuah tema melakukan opt-in dan menyediakan templat yang sesuai, plugin mendeteksi bahwa templat Anda telah mengambil alih dan menonaktifkan penyisipan kontennya sendiri, sehingga halaman dirender satu kali dari templat Anda tanpa tata letak ganda. Tempatkan isi halaman rilis atau artis di mana pun Anda mau dengan blok Release Detail / Artist Detail atau shortcode [labelgrid-release-detail] / [labelgrid-artist-detail] di dalam templat Anda.

Anda juga dapat mengaktifkan atau menonaktifkan opt-in ini per permintaan dengan filter lgt_use_theme_templates. Filter ini menerima nilai opt-in saat ini dan post saat ini, lalu mengembalikan true atau false, sehingga Anda dapat mengaktifkan templat tema Anda hanya untuk sebagian rilis atau artis.

Catatan

Override ini hanya berlaku untuk templat PHP klasik. Mengambil alih halaman rilis dan artis dari Site Editor pada tema blok belum didukung dan merupakan penambahan yang direncanakan. Situs yang tidak melakukan opt-in tidak terpengaruh: tata letak bawaan tetap dirender persis seperti sebelumnya.

---

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

Shortcode berfungsi di tema dan page builder apa pun. Fitur yang sama juga tersedia sebagai blok Gutenberg native dan melalui Elementor: lihat Blocks (Gutenberg) dan Elementor di atas.

---

Pemecahan Masalah

Gate, pre-save, dan sinkronisasi katalog berhenti bekerja

LabelGrid tidak lagi menerima kunci API yang dibuat untuk versi plugin sebelumnya. Jika download gate, pre-save Spotify, atau sinkronisasi katalog berhenti tanpa Anda mengubah apa pun, hampir selalu inilah penyebabnya.

Solusinya: buat kunci baru lalu tempelkan ke plugin. Langkahnya sama seperti pertama kali dan ada di bagian konfigurasi di atas. Gate dan pre-save yang sudah ada tetap mempertahankan konfigurasinya, jadi tidak ada yang perlu dibangun ulang.

Tanda-tandanya:

• Download gate, pre-save, dan sinkronisasi katalog berhenti bekerja.
• Tab Download Gate tidak ada di pengaturan plugin. Fiturnya tidak dihapus: tab itu disembunyikan selama belum ada kunci yang valid, dan muncul lagi begitu Anda menyimpan kunci baru.
• Versi 1.6.1 menampilkan salah satu dari tiga pemberitahuan spesifik di admin WordPress. Versi sebelumnya, termasuk 1.5.0 dan 1.6.0, hanya menampilkan satu pemberitahuan lama yang kurang spesifik — LabelGrid API DISABLED: Verify the API Token is correct and that your account is enabled for LabelGrid API Services., dengan tautan Set API in General Settings — tetapi terpengaruh dengan cara yang persis sama, karena pemeriksaan terjadi di LabelGrid dan bukan di plugin.

Arti pemberitahuan plugin

Versi 1.6.1 menampilkan salah satu dari tiga pesan berikut. Dua di antaranya diawali LabelGrid API DISABLED:, jadi bacalah seluruh kalimatnya sebelum bertindak. Pesan-pesan ini dikutip dalam bahasa Inggris karena saat ini plugin belum menerjemahkannya.

Kunci Anda perlu diganti:

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.

Buat kunci baru dengan langkah-langkah di bagian konfigurasi, lalu tempelkan ke plugin.

Belum ada kunci yang disimpan:

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

Buat kunci lalu tempelkan ke pengaturan plugin.

Masalah koneksi sementara, bukan masalah kunci:

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.

Untuk memeriksa ulang saat itu juga di versi mana pun, Anda harus mengubah sesuatu. Tombol Save Settings tetap nonaktif sampai ada pengaturan yang benar-benar berubah, dan menempelkan kunci yang sama tidak dihitung sebagai perubahan. Jadi ubah pengaturan apa pun, simpan, kembalikan seperti semula, lalu simpan lagi. Log Retention Days di tab System cocok untuk ini karena tidak memengaruhi apa pun yang lain. Setiap kali Anda menyimpan, pemeriksaan koneksi dijalankan ulang, dan situs Anda kembali persis seperti semula.

Mulai versi 1.6.2, pemeriksaan harian di latar belakang juga dijalankan ulang dengan sendirinya selama ada kunci yang tersimpan, sehingga situs yang gangguan atau batas permintaannya sudah berlalu akan pulih sendiri tanpa perlu disentuh siapa pun. Pada 1.5.0, 1.6.0, dan 1.6.1 hal itu tidak pernah terjadi: begitu plugin menonaktifkan dirinya, pemeriksaan harian melewati uji koneksi sampai ada yang menyimpan pengaturan secara manual.

Ini hanya berlaku untuk masalah koneksi. Kunci yang ditolak tidak pernah pulih sendiri di versi mana pun; lihat “Kunci Anda perlu diganti” di atas. Jika masalahnya berlanjut, lihat bagian kesalahan koneksi API di bawah.

Rilis tidak muncul

1. Buka LabelGrid Tools → General Settings — menu tingkat atas, bukan di bawah Settings WordPress — dan pastikan token API Anda dimasukkan dengan benar
2. Periksa apakah auto-sync diaktifkan di tab Connection
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 LabelGrid Tools → General Settings → System 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 api.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

---

FAQ

”Apa itu plugin WordPress LabelGrid Tools?”

LabelGrid Tools adalah plugin WordPress resmi dari LabelGrid. Plugin ini otomatis menyinkronkan katalog rilis, profil artis, dan download gate Anda dari LabelGrid ke situs WordPress Anda setiap 6 jam, serta menambahkan halaman rilis smart-link, tombol pre-save Spotify, dan download gate. Plugin ini tersedia di Direktori Plugin WordPress.

”Apakah saya perlu paket berbayar atau paket API untuk memakai plugin WordPress?”

Tidak. LabelGrid Tools tersedia untuk semua akun LabelGrid tanpa biaya tambahan, dan paket API tidak diperlukan. Fitur Gate yang disediakannya sudah termasuk dalam semua paket standar maupun API, dan ada paket Gate mandiri bagi pengguna yang hanya ingin integrasi WordPress tanpa distribusi.

”Bagaimana cara memasang dan menghubungkan plugin ini?”

Pasang LabelGrid Tools lewat menu Plugins lalu Add New di WordPress, kemudian aktifkan. Di LabelGrid, buka menu pengguna Anda, pilih Wordpress, lalu Configure Plugin, buat kunci otorisasi untuk domain Anda, dan tempelkan token aksesnya ke tab pengaturan Connection pada plugin. Setiap kunci terikat pada satu domain.

”Seberapa sering plugin menyinkronkan katalog saya?”

Plugin menyinkronkan rilis, artis, dan download gate Anda dari LabelGrid setiap 6 jam. LabelGrid adalah sumber kebenaran, jadi lakukan semua penyuntingan katalog di LabelGrid; perubahan yang dibuat langsung pada postingan WordPress hasil sinkronisasi akan tertimpa pada sinkronisasi berikutnya.

”Bisakah saya menambahkan pre-save Spotify ke situs saya dengan plugin ini?”

Ya. Aktifkan pre-save Spotify di tab pengaturan Release Pages dan tempatkan shortcode [labelgrid-presave-button] pada rilis mendatang. Pengunjung dapat melakukan pre-save dan, bila mau, mengikuti artis serta satu playlist; Anda juga dapat mengumpulkan email selama alur pre-save.

”Bisakah saya menggunakan blok Gutenberg atau Elementor, atau hanya shortcode saja?”

Ketiganya. Sejak versi 1.5.0, setiap fitur tersedia sebagai shortcode, sebagai blok Gutenberg native (temukan di block inserter dalam kategori LabelGrid Tools), dan melalui Elementor lewat widget Shortcode-nya. Setiap blok merender output yang sama dengan shortcode padanannya, dan shortcode tetap berfungsi di tema apa pun.

---

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. Lihat juga Kampanye Pre-Save.

---

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.