워드프레스 플러그인: LabelGrid Tools 설정

2026년 9월 업데이트.

LabelGrid Tools는 릴리스 카탈로그, 아티스트 프로필, 다운로드 게이트를 LabelGrid에서 워드프레스 웹사이트로 자동 동기화하는 공식 워드프레스 플러그인입니다. LabelGrid이 원본 데이터의 기준이며, 플러그인이 6시간마다 데이터를 가져오므로 웹사이트에는 항상 최신 카탈로그가 반영됩니다.

모든 요금제에서 사용 가능

LabelGrid Tools는 모든 LabelGrid 계정에서 추가 비용 없이 사용할 수 있으며, API 요금제가 필요하지 않습니다. LabelGrid 스마트 링크 경험을 얻는 두 가지 방법 중 하나가 이 플러그인입니다. 모든 릴리스에는 LabelGrid 도메인에 호스팅되는 랜딩 페이지와 짧은 링크가 이미 제공됩니다(발매작 랜딩 페이지 참고). 이 플러그인은 같은 릴리스별 페이지(스토어 링크, Spotify 프리세이브 버튼, 다운로드 게이트)를 카탈로그 전체·아티스트 프로필과 함께 자체 브랜드 WordPress 도메인에 올려줍니다.

개요

할 수 있는 일

이 기능들은 모두 숏코드로, 네이티브 구텐베르크 블록으로, 또는 Elementor를 통해 사이트에 배치할 수 있습니다. Blocks (Gutenberg)와 Elementor를 참고하세요.

기능	설명
자동 카탈로그 동기화	릴리스, 아티스트, 다운로드 게이트가 6시간마다 LabelGrid에서 동기화됩니다
릴리스 페이지	아트워크와 함께 모든 주요 스트리밍 플랫폼 및 매장 링크를 담은 랜딩 페이지
아티스트 프로필	약력, 소셜 링크, 디스코그래피가 담긴 아티스트 페이지
릴리스 그리드	장르, 레이블, 아티스트별로 필터링되는 카탈로그 그리드
릴리스 배너	최신 또는 추천 릴리스를 보여 주는 홈페이지 배너
Spotify 프리세이브	플레이리스트 및 아티스트 팔로우 기능이 포함된 프리세이브 버튼
사전 주문	iTunes, Apple Music, Beatport, Juno, Amazon 사전 주문 지원
다운로드 게이트	Spotify 팔로우 기능이 포함된 이메일 수집 게이트
Spotify 웹 플레이어	릴리스 페이지에 임베드되는 Spotify 플레이어
보도자료	릴리스 페이지의 전용 보도자료 섹션
iTunes 제휴 링크	사이트를 통한 iTunes 구매로 수수료 수익 창출
Yoast SEO 연동	소셜 공유를 위한 Open Graph 메타데이터

요구 사항

• 워드프레스 7.0 이상
• PHP 8.0 이상
• 활성화된 LabelGrid 계정(API 요금제 불필요)

---

설치

워드프레스 관리자에서 설치

1. Plugins → Add New로 이동합니다
2. “LabelGrid Tools”를 검색합니다
3. Install Now를 클릭합니다
4. Activate를 클릭합니다

수동 설치

1. LabelGrid에서 플러그인을 내려받습니다
2. Plugins → Add New → Upload Plugin으로 이동합니다
3. 내려받은 ZIP 파일을 선택합니다
4. Install Now를 클릭합니다
5. Activate를 클릭합니다

---

설정

API 키 받기

이전 버전용으로 만든 키는 더 이상 동작하지 않습니다

LabelGrid는 이전 버전의 플러그인용으로 만든 API 키를 더 이상 받지 않습니다. 다운로드 게이트, 프리세이브, 카탈로그 동기화가 멈췄다면 아래 단계로 새 키를 만들어 플러그인에 붙여 넣으세요. 다른 것은 바꿀 필요가 없고, 기존 게이트와 프리세이브는 설정을 그대로 유지합니다.

키가 거부되는 동안에는 플러그인 설정에서 Download Gate 탭이 사라집니다. 기능이 없어진 것이 아니라, 유효한 키를 저장하면 탭이 다시 나타납니다.

이 확인은 플러그인이 아니라 LabelGrid에서 이뤄지므로 모든 버전이 영향을 받습니다. 아직 1.5.0이나 1.6.0을 쓰는 사이트도 아무 안내 없이 멈추지는 않습니다. 더 오래되고 덜 구체적인 배너 하나가 표시되며, 문구는 LabelGrid API DISABLED: Verify the API Token is correct and that your account is enabled for LabelGrid API Services. 로 같은 문제를 가리킵니다. 모든 메시지와 그 의미는 문제 해결 섹션에 정리해 두었습니다.

플러그인을 설정하기 전에 LabelGrid에서 인증 키를 만드세요.

1. LabelGrid에 로그인합니다
2. 사용자 메뉴(오른쪽 위 모서리의 이름/아바타)를 클릭합니다
3. 드롭다운 메뉴에서 Wordpress를 클릭합니다
4. Configure Plugin 버튼을 클릭합니다
5. Step 1: Create Key에서 포함할 레이블을 선택합니다.
   • 전체 카탈로그를 동기화하려면 All My Labels를 선택합니다
   • 또는 특정 레이블만 선택해 웹사이트에 표시되는 범위를 제한합니다
6. Create New Key를 클릭합니다
7. 워드프레스 웹사이트 도메인을 입력합니다(예: https://yoursite.com)
8. OK를 클릭해 키를 생성합니다
9. 액세스 토큰을 복사합니다. 워드프레스에 입력할 때 필요합니다

주의

각 키는 특정 도메인에 연결됩니다. 워드프레스 사이트가 여러 개라면 사이트마다 별도의 키를 만드세요.

플러그인 설정

워드프레스 관리자에서 LabelGrid Tools → General Settings를 엽니다. 워드프레스 Settings 아래가 아니라 최상위 메뉴 항목입니다. 여기서 LabelGrid Tools Settings로 이동합니다. 설정 페이지에는 여섯 개의 탭이 있습니다.

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

Download Gate는 다운로드 게이트가 활성일 때만 표시됩니다. 플러그인에 유효한 API 키가 없는 동안에는 탭이 완전히 숨겨지므로, 탭이 보이지 않으면 아래의 문제 해결 항목을 참고하세요.

Connection

Setting	Description
LabelGrid API Token	LabelGrid에서 복사한 액세스 토큰을 붙여 넣습니다. 1.6.1부터는 한 줄 입력란이며, LabelGrid가 지금 발급하는 짧은 키에 맞춰졌습니다
Automatic LabelGrid API Content Sync	자동 카탈로그 동기화 사용 여부

Release Pages

Setting	Description
Show unreleased releases	발매 예정 릴리스를 사이트에 표시
Spotify Pre-Save	미발매 콘텐츠에 Spotify 프리세이브 버튼 사용
Spotify Pre-Save - Collect Email	No / Yes (필수) / Yes (선택): 프리세이브 시 이메일 수집
iTunes / Apple Music / Beatport / Juno / Amazon Music Pre-Order	iTunes, Apple Music, Beatport, Juno, Amazon 사전 주문 링크 사용
Show Spotify Web Player	릴리스 페이지에 임베드된 Spotify 플레이어 표시
Show press release	보도자료 섹션 표시
Show featured artists	릴리스 페이지에 피처링 아티스트 표시
Show similar releases	유사 릴리스 표시
Field below Artwork	아트워크 아래에 표시할 항목 선택: 릴리스 코드 또는 레이블

Artist Pages

Setting	Description
Show Twitter feed	아티스트 페이지에 Twitter 피드 표시
Show Bandsintown feed	아티스트 페이지에 Bandsintown 피드를 표시합니다

Links & Services

Setting	Description
Release services / Artist services	릴리스와 아티스트 페이지에 표시되는 스트리밍·스토어 링크의 순서와 표시 여부를 설정합니다
Custom Services	릴리스와 아티스트 페이지에 표시할 나만의 서비스를 추가합니다
Apple Performance Partner Program Token	구매 수수료 수익을 위한 iTunes 제휴 토큰

Download Gate

Setting	Description
Show press release	보도 노출 설정
Show featured artists	게이트 페이지의 아티스트 표시 제어
Button Label	게이트 버튼의 맞춤 텍스트
Welcome title	게이트 랜딩 페이지에 표시되는 제목
Welcome description	게이트 랜딩 페이지의 설명 텍스트
Gate button label	게이트 마법사 버튼의 텍스트

System

Setting	Description
Error log level	문제 진단을 위한 로깅 상세 수준 설정
Log Retention Days	시스템 로그 보관 기간
View System Logs	저장된 시스템 로그를 엽니다
System Information	지원팀에 문의할 때 함께 보낼 환경 정보입니다
Uninstall	버튼이나 설정이 아니라 안내문입니다. 플러그인 화면에서 플러그인을 삭제하면 API 토큰을 포함한 설정과 로그 및 게이트 등록 테이블이 지워지지만, 릴리스와 아티스트, 다운로드 게이트와 그 항목들은 데이터베이스에 그대로 남는다고 설명합니다

---

카탈로그 동기화

플러그인은 6시간마다 LabelGrid에서 카탈로그를 자동으로 동기화합니다. 여기에는 릴리스, 아티스트, 다운로드 게이트가 포함됩니다.

플러그인은 워드프레스에 세 가지 사용자 정의 글 유형(custom post type)을 만듭니다.

글 유형	설명	URL 구조
Release	아트워크, 메타데이터, 플랫폼 링크가 포함된 음악 릴리스	/release/release-name/
Artist	약력과 소셜 링크가 포함된 아티스트 프로필	/artist/artist-name/
Gate Download	이메일을 수집하는 다운로드 게이트	/free-download/gate-name/

다운로드 게이트는 게이트를 그룹으로 정리할 수 있는 Gate Category 분류(taxonomy)도 지원합니다.

참고

LabelGrid이 원본 데이터의 기준입니다. 워드프레스에서 릴리스나 아티스트 글을 수정하더라도 다음 동기화 때 덮어쓰입니다. 카탈로그 변경은 모두 LabelGrid에서 하세요.

---

숏코드

플러그인은 릴리스, 아티스트, 다운로드 게이트, 프리세이브의 네 가지 범주로 나뉜 11개의 숏코드를 제공합니다. 각 숏코드에는 동일한 옵션을 제공하는 구텐베르크 블록도 대응됩니다. Blocks (Gutenberg)를 참고하세요.

릴리스 숏코드

[labelgrid-release-list]

릴리스를 필터링 가능한 그리드로 표시합니다.

기본 예시:

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

매개변수:

매개변수	기본값	설명
show-title	null	릴리스 제목 표시
label	null	레이블로 필터링
items-page	12	페이지당 릴리스 수
items-row	4	한 줄당 열 수
pagination	null	페이지 매김 사용
showcase-last	null	쇼케이스 모드 사용
item-filter	released	필터 유형: released 또는 unreleased
title-below	null	제목을 아트워크 아래에 배치
filter-artists	null	아티스트 ID로 필터링
exclude	null	특정 릴리스 ID 제외
image-quality	lgt_artwork_medium	이미지 크기 프리셋

발매 예정 릴리스 표시:

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

[labelgrid-release-list-filter]

릴리스 그리드 위에 드롭다운 필터를 추가합니다. 같은 페이지에서 [labelgrid-release-list] 앞에 이 숏코드를 배치하세요.

기본 예시:

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

매개변수:

매개변수	기본값	설명
record_label	null	레이블 필터 드롭다운 표시

[labelgrid-release-banner]

하나 이상의 릴리스를 강조하는 배너를 표시합니다. 홈페이지에 적합합니다.

기본 예시:

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

매개변수:

매개변수	기본값	설명
label	null	레이블로 필터링
items-page	1	표시할 릴리스 수
item-filter	released	필터 유형: released 또는 unreleased
item-order	DESC	정렬 순서: DESC(최신순) 또는 ASC
filter-artists	null	아티스트 ID로 필터링
exclude	null	특정 릴리스 ID 제외

[labelgrid-release-links]

특정 릴리스의 스트리밍 및 매장 링크를 표시합니다. 릴리스 페이지 템플릿 안에서 사용하거나, 릴리스 ID를 지정해 어떤 페이지에서든 사용할 수 있습니다.

기본 예시:

[labelgrid-release-links]

특정 릴리스 지정:

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

매개변수:

매개변수	기본값	설명
release-id	현재 글 ID	릴리스 글 ID
artists	null	링크와 함께 아티스트 정보 표시

[labelgrid-release-detail]

아트워크, 메타데이터, 플랫폼 링크, 임베드된 플레이어를 포함한 전체 릴리스 상세 페이지를 렌더링합니다. 이 숏코드는 현재 글을 사용하며 매개변수를 받지 않습니다.

예시(릴리스 템플릿 안):

[labelgrid-release-detail]

아티스트 숏코드

[labelgrid-artist-list]

아티스트를 그리드 레이아웃으로 표시합니다.

기본 예시:

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

매개변수:

매개변수	기본값	설명
show-title	false	이미지 아래에 아티스트 이름 표시
category	null	카테고리로 필터링
items-page	12	페이지당 아티스트 수
items-row	4	한 줄당 열 수
pagination	null	페이지 매김 사용
title-below	null	제목을 이미지 아래에 배치

[labelgrid-artist-detail]

약력, 소셜 링크, 디스코그래피를 포함한 전체 아티스트 프로필 페이지를 렌더링합니다. 이 숏코드는 현재 글을 사용하며 매개변수를 받지 않습니다.

예시(아티스트 템플릿 안):

[labelgrid-artist-detail]

다운로드 게이트 숏코드

[labelgrid-gate-button]

다운로드 게이트 버튼을 표시합니다. 클릭하면 방문자가 게이트 흐름(이메일 수집 및 선택적 소셜 팔로우)을 거친 뒤 다운로드에 접근하게 됩니다.

기본 예시:

[labelgrid-gate-button]

맞춤 텍스트 지정:

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

매개변수:

매개변수	기본값	설명
gate-id	현재 글 ID	게이트 다운로드 글 ID
post-id	현재 글 ID	연결된 릴리스 글 ID
button-label	null	맞춤 버튼 텍스트
custom-class	null	추가 CSS 클래스
download-text	null	맞춤 다운로드 버튼 텍스트

[labelgrid-gate-download-list]

다운로드 게이트를 그리드 레이아웃으로 표시합니다.

기본 예시:

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

매개변수:

매개변수	기본값	설명
show-title	false	게이트 제목 표시
category	null	게이트 카테고리로 필터링
items-page	12	페이지당 항목 수
items-row	4	한 줄당 열 수
pagination	null	페이지 매김 사용
title-below	null	제목을 이미지 아래에 배치

[labelgrid-gate-download-detail]

전체 다운로드 게이트 상세 페이지를 렌더링합니다. 이 숏코드는 현재 글을 사용하며 매개변수를 받지 않습니다.

예시(게이트 템플릿 안):

[labelgrid-gate-download-detail]

프리세이브 숏코드

[labelgrid-presave-button]

발매 예정 릴리스를 위한 Spotify 프리세이브 버튼을 표시합니다. 방문자는 릴리스를 프리세이브하고, 선택적으로 Spotify에서 아티스트와 플레이리스트를 팔로우할 수 있습니다.

기본 예시:

[labelgrid-presave-button]

특정 릴리스 지정:

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

매개변수:

매개변수	기본값	설명
release-id	현재 글 ID	릴리스 글 ID

팁

Release Pages 설정 탭에서 “Spotify Pre-Save - Collect Email”을 활성화하면 프리세이브 과정에서 이메일 주소를 수집할 수 있습니다.

---

게이트와 프리세이브 동작

다운로드 게이트는 다운로드가 열리기 전에 팬이 Spotify를 연결하고 한 가지 이상의 동작을 완료하도록 요청합니다. 프리세이브는 항상 릴리스 자체를 저장하며, 그 위에 팔로우 동작을 더할 수 있습니다.

사용할 수 있는 Spotify 동작은 다음과 같습니다.

• 릴리스 저장: 프리세이브에는 항상 포함됩니다
• 아티스트 팔로우
• 플레이리스트 팔로우
• Spotify 프로필 팔로우: 1.6.0에서 추가

팔로우 대상이 내 카탈로그의 아티스트로 제한되지 않으므로, 협업 아티스트나 피처링 아티스트를 지정할 수도 있습니다.

SoundCloud와 Twitter 동작은 중단된 상태입니다

1.6.0부터 다운로드 게이트 동작은 Spotify 전용입니다. SoundCloud와 Twitter 동작은 다시 만드는 동안 중단되어 실행되지 않고 팬에게도 보이지 않으며, 게이트는 Spotify 동작으로 계속 작동합니다.

게이트가 두 개 이상의 서비스 연결을 요구했다면, 이제 플러그인은 남아 있는 서비스만 요청합니다. 그렇지 않으면 게이트를 끝낼 수 없기 때문입니다. 저장된 설정은 그대로이며 다른 서비스가 돌아오면 다시 적용됩니다. 계정을 두 개 이상 요구하던 게이트를 모두 점검해 남은 Spotify 동작이 여전히 원하는 내용을 요청하는지 확인하세요.

동작이 SoundCloud나 Twitter뿐이던 게이트는 요청할 것이 남지 않아, Spotify 동작을 추가하기 전까지 전혀 작동하지 않습니다.

동작 한도를 세는 방식

게이트는 이전보다 훨씬 많은 Spotify 동작을 받아들이며, 게이트 편집기는 편집하는 동안 사용한 개수를 보여줍니다.

링크 하나가 동작 하나입니다. 플레이리스트 링크 세 개가 담긴 동작 행은 하나가 아니라 셋으로 셉니다. 게이트가 한도에 가까워질 때 계산이 어긋나는 지점이 대개 여기입니다.

프리세이브에서 플레이리스트 검색하기

프리세이브가 릴리스를 팬의 플레이리스트에 추가하겠다고 제안할 때, 팬은 목록 전체를 스크롤하지 않고 자기 플레이리스트를 검색할 수 있습니다.

---

Blocks (Gutenberg)

버전 1.5.0부터 LabelGrid Tools는 모든 기능에 대해 네이티브 블록 에디터 블록을 제공합니다. 워드프레스 에디터에서 블록 삽입기(+ 버튼)를 클릭한 뒤 LabelGrid Tools 카테고리를 찾거나 블록 이름으로 검색하세요. 각 블록의 옵션은 블록 사이드바에서 설정하며, 대응하는 숏코드가 받는 옵션과 동일합니다.

숏코드마다 하나씩, 총 11개의 블록이 있습니다.

블록	대응 숏코드	기능
LabelGrid Release List	[labelgrid-release-list]	릴리스의 반응형 그리드(열 수, 페이지당 항목 수, 레이블, 페이지 매김, 제목 옵션)
LabelGrid Release List Filter	[labelgrid-release-list-filter]	장르 필터(레이블이 설정된 경우 레코드 레이블 필터 추가). 같은 화면의 릴리스 목록과 함께 사용하세요
LabelGrid Release Banner	[labelgrid-release-banner]	릴리스를 강조하는 전체 너비 배너. 홈페이지에 적합합니다
LabelGrid Release Links	[labelgrid-release-links]	현재 릴리스의 스트리밍 및 매장 링크
LabelGrid Release Detail	[labelgrid-release-detail]	전체 릴리스 본문. Releases 단일 템플릿에서 사용하세요
LabelGrid Artist List	[labelgrid-artist-list]	아티스트의 반응형 그리드
LabelGrid Artist Detail	[labelgrid-artist-detail]	전체 아티스트 본문. Artists 단일 템플릿에서 사용하세요
LabelGrid Gate Button	[labelgrid-gate-button]	다운로드 게이트 버튼. LabelGrid 연결이 활성 상태일 때만 렌더링됩니다
LabelGrid Gate Download List	[labelgrid-gate-download-list]	게이트 다운로드 그리드. 연결이 활성 상태일 때만 표시됩니다
LabelGrid Gate Download Detail	[labelgrid-gate-download-detail]	전체 게이트 다운로드 본문. 연결이 활성 상태일 때만 표시됩니다
LabelGrid Presave Button	[labelgrid-presave-button]	Spotify 프리세이브 버튼. 연결이 활성 상태이고 발매일이 지나지 않았을 때만 렌더링됩니다

블록과 숏코드는 서로 바꿔 사용할 수 있습니다

각 블록은 대응하는 숏코드와 동일한 렌더러를 사용하므로, 블록으로 만든 페이지와 숏코드로 만든 페이지는 동일한 결과물을 만들어냅니다. 블록은 순수하게 추가되는 방식이라 블록을 추가하지 않은 페이지는 전혀 변경되지 않으며, 플러그인을 업데이트해도 기존 릴리스 및 아티스트 템플릿은 그대로 유지됩니다. 숏코드를 선호하시나요? 숏코드는 여전히 완전히 지원되며 모든 테마에서 작동합니다.

상세 정보 중복 렌더링 방지

사이트 에디터(블록 테마)의 단일 항목 템플릿에서는 Release Detail / Artist Detail 블록과 워드프레스의 Post Content(“Content”) 블록 중 하나만 사용하세요. 둘 다 사용하면 릴리스 또는 아티스트 상세 정보가 두 번 렌더링됩니다.

참고

Gate Button, Gate Download List, Gate Download Detail, Presave Button 블록은 활성 요금제의 LabelGrid 계정에 연결된 사이트에서만 렌더링됩니다.

---

Elementor

모든 LabelGrid Tools 기능은 숏코드로도 제공되며, Elementor 기본 제공 Shortcode 위젯(Elementor 무료 버전에 포함)을 사용하면 별도 애드온 없이 어떤 기능이든 페이지에 넣을 수 있습니다. 아래에서 설명하는 Theme Builder 방식은 이와 다릅니다. 단일 템플릿, 표시 조건, Post Content 위젯은 Elementor Pro 기능입니다. 무료 버전 Elementor에서는 대신 어떤 페이지에서든 Shortcode 위젯을 사용하세요. 플러그인에 내장된 릴리스 및 아티스트 페이지는 Elementor 템플릿 없이도 자체적으로 렌더링됩니다.

Elementor Pro의 Theme Builder로 릴리스 및 아티스트 페이지를 만들려면 다음과 같이 하세요.

1. Theme Builder → Single 템플릿을 만들고 표시 조건을 Releases(및/또는 Artists)로 설정하세요.
2. 릴리스나 아티스트 본문에는 [labelgrid-release-detail] / [labelgrid-artist-detail]을 담은 Shortcode 위젯을 사용하세요. 이 방식은 항상 상세 정보를 렌더링합니다. Post Content 위젯도 대부분의 구성에서 상세 정보를 렌더링합니다. 둘 중 하나만 사용하고 둘 다 사용하지 마세요. 그렇지 않으면 상세 정보가 두 번 렌더링됩니다.
3. 그 외 레이아웃 어디에나 릴리스 그리드, 배너, 아티스트 목록, 스마트 링크 버튼, 프리세이브, 다운로드 게이트를 Elementor의 Shortcode 위젯으로 추가할 수 있습니다.

참고

다운로드 게이트 및 프리세이브 기능은 활성 요금제의 LabelGrid 계정에 연결된 사이트에서만 렌더링됩니다.

---

릴리스 및 아티스트 페이지에 자체 테마 템플릿 사용하기

기본적으로 플러그인은 릴리스 및 아티스트 단일 페이지를 페이지 콘텐츠에 자체 레이아웃을 삽입하는 방식으로 렌더링하므로, 테마를 전혀 변경하지 않아도 작동합니다. 이 페이지들을 직접 테마에서 만들고 싶다면, 플러그인이 물러나고 클래식 PHP 템플릿이 렌더링하도록 할 수 있습니다.

클래식 테마에서 렌더링을 직접 담당하려면 다음과 같이 하세요.

1. 테마의 functions.php에 add_theme_support( 'labelgrid-tools-templates' );를 추가하세요.
2. 테마에 클래식 single-release.php 및/또는 single-artist.php 템플릿을 추가하세요.

테마가 옵트인하고 대응하는 템플릿을 함께 제공하면, 플러그인은 해당 템플릿이 렌더링을 대신 맡았다는 것을 감지하고 자체 콘텐츠 삽입을 중단합니다. 그 결과 페이지는 템플릿에서 한 번만 렌더링되며 레이아웃이 중복되지 않습니다. 템플릿 안에서 Release Detail / Artist Detail 블록이나 [labelgrid-release-detail] / [labelgrid-artist-detail] 숏코드를 사용해 릴리스나 아티스트 본문을 원하는 위치에 배치하세요.

lgt_use_theme_templates 필터로 요청마다 옵트인 여부를 전환할 수도 있습니다. 이 필터는 현재 옵트인 값과 현재 글을 받아 true 또는 false를 반환하므로, 일부 릴리스나 아티스트에 대해서만 테마 템플릿을 사용하도록 설정할 수 있습니다.

참고

이 재정의는 클래식 PHP 템플릿에만 적용됩니다. 블록 테마의 사이트 에디터에서 릴리스 및 아티스트 페이지를 직접 담당하는 기능은 아직 지원되지 않으며, 추가될 예정입니다. 옵트인하지 않은 사이트는 영향을 받지 않습니다. 기본 제공 레이아웃이 이전과 동일하게 렌더링됩니다.

---

CSS 클래스 레퍼런스

플러그인은 스타일 지정에 다음 CSS 클래스 접두사를 사용합니다.

클래스	요소
.lgsquarelist	릴리스 및 아티스트 목록의 그리드 컨테이너
.releaseelement	개별 릴리스 또는 아티스트 카드
.elementrow1 ~ .elementrow8	열 수별 레이아웃(items-row 설정과 일치)
.elementrowx	유연한 레이아웃 변형
.spotify, .twitter, .youtube, .soundcloud, .facebook	플랫폼 링크의 서비스별 스타일
.banner-*	릴리스 배너 요소
.gate, .gateimage, .freedownload	다운로드 게이트 요소

참고

숏코드는 모든 테마와 페이지 빌더에서 작동합니다. 동일한 기능은 네이티브 구텐베르크 블록으로도, Elementor를 통해서도 사용할 수 있습니다. 위의 Blocks (Gutenberg)와 Elementor를 참고하세요.

---

문제 해결

게이트, 프리세이브, 카탈로그 동기화가 멈췄을 때

LabelGrid는 이전 버전의 플러그인용으로 만든 API 키를 더 이상 받지 않습니다. 아무것도 바꾸지 않았는데 다운로드 게이트, Spotify 프리세이브, 카탈로그 동기화가 멈췄다면 거의 이 문제입니다.

해결 방법: 새 키를 만들어 플러그인에 붙여 넣으세요. 절차는 처음과 같고 위의 설정 섹션에 있습니다. 기존 게이트와 프리세이브는 설정을 그대로 유지하므로 다시 만들 필요가 없습니다.

이렇게 나타납니다.

• 다운로드 게이트, 프리세이브, 카탈로그 동기화가 동작하지 않습니다.
• 플러그인 설정에 Download Gate 탭이 보이지 않습니다. 기능이 없어진 것이 아니라, 유효한 키가 없는 동안만 탭이 숨겨지고 새 키를 저장하면 다시 나타납니다.
• 1.6.1은 워드프레스 관리자에 세 가지 구체적인 알림 중 하나를 표시합니다. 1.5.0과 1.6.0을 포함한 그 이전 버전은 대신 더 오래되고 덜 구체적인 알림 하나만 표시합니다 — LabelGrid API DISABLED: Verify the API Token is correct and that your account is enabled for LabelGrid API Services. 와 Set API in General Settings 링크입니다. 확인이 플러그인이 아니라 LabelGrid에서 이뤄지므로 영향은 똑같습니다.

플러그인 알림의 의미

1.6.1은 다음 세 가지 메시지 중 하나를 표시합니다. 이 중 두 개는 LabelGrid API DISABLED:로 시작하므로 조치하기 전에 문장 전체를 읽으세요. 메시지는 영어 원문 그대로 인용했습니다. 현재 플러그인이 이 문구들을 번역하지 않기 때문입니다.

키를 교체해야 할 때:

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.

설정 섹션의 절차대로 새 키를 만들어 플러그인에 붙여 넣으세요.

아직 키를 저장하지 않았을 때:

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

키를 만들어 플러그인 설정에 붙여 넣으세요.

키 문제가 아니라 일시적인 연결 문제일 때:

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.

어떤 버전에서든 바로 다시 확인하려면 무언가를 변경해야 합니다. Save Settings 버튼은 설정이 실제로 바뀌기 전까지 비활성화되어 있고, 같은 키를 다시 붙여넣는 것은 변경으로 간주되지 않습니다. 아무 설정이나 바꿔서 저장한 다음, 원래대로 되돌리고 다시 저장하세요. System 탭의 Log Retention Days는 다른 데 영향을 주지 않아 쓰기 좋습니다. 저장할 때마다 연결 점검이 새로 실행되고, 사이트는 원래 상태 그대로 유지됩니다.

1.6.2 버전부터는 키가 저장되어 있으면 매일 실행되는 백그라운드 점검도 스스로 다시 실행됩니다. 장애나 요청 제한이 풀린 사이트는 아무도 손대지 않아도 정상으로 돌아옵니다. 1.5.0, 1.6.0, 1.6.1에서는 그렇지 않았습니다. 플러그인이 스스로 꺼지고 나면 누군가 설정을 직접 저장할 때까지 매일 실행되는 점검이 연결 테스트를 건너뛰었습니다.

이는 연결 문제에만 해당합니다. 거부된 키는 어떤 버전에서도 저절로 해결되지 않으니 위의 ‘키를 교체해야 할 때’를 참고하세요. 문제가 계속된다면 아래의 API 연결 오류를 참고하세요.

릴리스가 표시되지 않을 때

1. LabelGrid Tools → General Settings(워드프레스 Settings 아래가 아닌 최상위 메뉴)로 이동해 API 토큰이 올바르게 입력되었는지 확인합니다
2. Connection 탭에서 자동 동기화가 활성화되어 있는지 확인합니다
3. 다음 동기화 주기까지 최대 6시간을 기다리거나, 플러그인을 비활성화했다가 다시 활성화해 즉시 동기화를 실행합니다
4. 릴리스가 LabelGrid에서 발행 상태인지(초안 상태가 아닌지) 확인합니다
5. LabelGrid Tools → General Settings → System에서 디버그 수준을 높인 뒤 로그를 확인합니다

숏코드가 일반 텍스트로 보일 때

1. Plugins에서 플러그인이 활성화되어 있는지 확인합니다
2. 숏코드 이름에 밑줄이 아니라 하이픈을 사용했는지 확인합니다(예: [labelgrid-release-list])
3. 숏코드 이름에 오타가 없는지 확인합니다

스타일 문제

1. 테마와의 CSS 충돌이 있는지 확인합니다
2. 브라우저 개발자 도구로 요소의 클래스를 검사합니다
3. 플러그인 클래스 이름을 대상으로 한 맞춤 CSS 재정의를 추가합니다(위의 CSS 클래스 레퍼런스 참고)
4. 기본 워드프레스 테마로 테스트해 테마 충돌을 분리합니다

API 연결 오류

1. API 토큰이 유효하고 만료되지 않았는지 확인합니다
2. LabelGrid 계정이 활성 상태인지 확인합니다
3. 서버가 api.labelgrid.com으로 외부 요청을 보낼 수 있는지 확인합니다
4. 구체적인 오류 메시지를 확인하려면 플러그인 로그를 검토합니다

게이트 항목 및 내보내기

다운로드 게이트 항목(수집된 이메일 주소)은 워드프레스 관리자에서 CSV로 내보낼 수 있습니다. 게이트 다운로드 글로 이동해 내보내기 옵션을 찾으세요.

---

업데이트

자동 업데이트

1. 워드프레스 관리자에서 Plugins로 이동합니다
2. “LabelGrid Tools”를 찾습니다
3. Enable auto-updates를 클릭합니다

수동 업데이트

1. LabelGrid에서 최신 버전을 내려받습니다
2. Plugins → Add New → Upload Plugin으로 이동합니다
3. 새 ZIP 파일을 업로드합니다
4. 워드프레스가 기존 버전을 교체할지 묻습니다
5. Replace current with uploaded를 클릭합니다

---

FAQ

”LabelGrid Tools 워드프레스 플러그인은 무엇인가요?”

LabelGrid Tools는 LabelGrid 공식 워드프레스 플러그인입니다. 릴리스 카탈로그, 아티스트 프로필, 다운로드 게이트를 LabelGrid에서 워드프레스 사이트로 6시간마다 자동 동기화하고, 스마트 링크 릴리스 페이지, Spotify 프리세이브 버튼, 게이트 다운로드를 추가합니다. 워드프레스 플러그인 디렉터리에서 받을 수 있습니다.

”워드프레스 플러그인을 쓰려면 유료 요금제나 API 요금제가 필요한가요?”

아니요. LabelGrid Tools는 모든 LabelGrid 계정에서 추가 비용 없이 사용할 수 있으며 API 요금제가 필요하지 않습니다. 플러그인이 제공하는 Gate 기능은 모든 표준 요금제와 API 요금제에 포함되어 있고, 유통 없이 워드프레스 연동만 원하는 사용자를 위한 단독 Gate 요금제도 있습니다.

”플러그인은 어떻게 설치하고 연결하나요?”

워드프레스에서 플러그인, 새로 추가 순으로 이동해 LabelGrid Tools를 설치하고 활성화하세요. LabelGrid에서는 사용자 메뉴, Wordpress, Configure Plugin 순으로 열어 도메인용 인증 키를 만든 다음, 발급된 액세스 토큰을 플러그인의 Connection 설정 탭에 붙여 넣으세요. 키 하나는 도메인 하나에만 연결됩니다.

”플러그인은 카탈로그를 얼마나 자주 동기화하나요?”

플러그인은 릴리스, 아티스트, 다운로드 게이트를 LabelGrid에서 6시간마다 동기화합니다. LabelGrid가 원본 데이터의 기준이므로 카탈로그 수정은 모두 LabelGrid에서 하세요. 동기화된 워드프레스 게시물을 직접 고치면 다음 동기화 때 덮어써집니다.

”플러그인으로 사이트에 Spotify 프리세이브를 추가할 수 있나요?”

네. Release Pages 설정 탭에서 Spotify 프리세이브를 활성화하고 발매 예정 릴리스에 [labelgrid-presave-button] 숏코드를 넣으세요. 방문자는 릴리스를 프리세이브하면서 아티스트와 플레이리스트를 함께 팔로우할 수 있고, 프리세이브 과정에서 이메일도 수집할 수 있습니다.

”구텐베르크 블록이나 Elementor를 사용할 수 있나요, 아니면 숏코드만 사용할 수 있나요?”

세 가지 모두 가능합니다. 버전 1.5.0부터는 모든 기능을 숏코드로, 네이티브 구텐베르크 블록으로(블록 삽입기의 LabelGrid Tools 카테고리에서 찾을 수 있습니다), Elementor의 Shortcode 위젯을 통해서도 사용할 수 있습니다. 각 블록은 대응하는 숏코드와 동일한 결과물을 렌더링하며, 숏코드는 여전히 모든 테마에서 작동합니다.

---

관련 문서

LabelGrid Tools 워드프레스 플러그인에 관해서는 스마트 링크 랜딩 페이지, Spotify 프리세이브 캠페인, 게이트 다운로드 등을 다룬 저희 웹사이트에서 더 알아보세요. 프리세이브 캠페인 설정하기도 함께 참고하세요.

---

도움이 필요하신가요?

워드프레스 플러그인 관련 도움이 필요하면 워드프레스 버전, PHP 버전, 플러그인 로그의 오류 메시지를 함께 담아 지원팀에 문의하세요.