워드프레스 플러그인

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

개요

할 수 있는 일

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

요구 사항

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

설치

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

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

수동 설치

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

설정

API 키 받기

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

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

플러그인 설정

워드프레스 관리자에서 Settings → LabelGrid Tools로 이동합니다. 설정 페이지에는 네 개의 탭이 있습니다.

LabelGrid GATE 탭

설정	설명
API Token	LabelGrid에서 복사한 액세스 토큰을 붙여 넣습니다

General Options 탭

설정	설명
Debug level	문제 진단을 위한 로깅 상세 수준 설정
Log retention	시스템 로그 보관 기간
Auto-sync	자동 카탈로그 동기화 사용 여부
iTunes Affiliate Token	구매 수수료 수익을 위한 iTunes 제휴 토큰

Releases 탭

설정	설명
Show unreleased	발매 예정 릴리스를 사이트에 표시
Spotify pre-save	미발매 콘텐츠에 Spotify 프리세이브 버튼 사용
Pre-save email collection	No / Yes (필수) / Yes (선택): 프리세이브 시 이메일 수집
Pre-orders	iTunes, Apple Music, Beatport, Juno, Amazon 사전 주문 링크 사용
Spotify Web Player	릴리스 페이지에 임베드된 Spotify 플레이어 표시
Press release	보도자료 섹션 표시
Featured artists	릴리스 페이지에 피처링 아티스트 표시
Similar releases	유사 릴리스 표시
Show below artwork	아트워크 아래에 표시할 항목 선택: 릴리스 코드 또는 레이블
Twitter feed on artists	아티스트 페이지에 Twitter 피드 표시

Download Gate 탭

설정	설명
Press	보도 노출 설정
Artists visibility	게이트 페이지의 아티스트 표시 제어
Button label	게이트 버튼의 맞춤 텍스트
Welcome title	게이트 랜딩 페이지에 표시되는 제목
Welcome description	게이트 랜딩 페이지의 설명 텍스트
Wizard button label	게이트 마법사 버튼의 텍스트

카탈로그 동기화

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

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

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

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

숏코드

플러그인은 릴리스, 아티스트, 다운로드 게이트, 프리세이브의 네 가지 범주로 나뉜 11개의 숏코드를 제공합니다.

릴리스 숏코드

[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 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

CSS 클래스 레퍼런스

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

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

문제 해결

릴리스가 표시되지 않을 때

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

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

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

스타일 문제

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

API 연결 오류

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

게이트 항목 및 내보내기

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

업데이트

자동 업데이트

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

수동 업데이트

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

도움이 필요하신가요?

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

아직 LabelGrid를 사용하지 않으세요?

방금 읽으신 내용은 모두 저희 플랫폼에서 이용하실 수 있어요.

LabelGrid로 할 수 있는 일 보기 →

워드프레스 플러그인

개요

할 수 있는 일

요구 사항

설치

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

수동 설치

설정

API 키 받기

플러그인 설정

LabelGrid GATE 탭

General Options 탭

Releases 탭

Download Gate 탭

카탈로그 동기화

숏코드

릴리스 숏코드

[labelgrid-release-list]

[labelgrid-release-list-filter]

[labelgrid-release-banner]

[labelgrid-release-links]

[labelgrid-release-detail]

아티스트 숏코드

[labelgrid-artist-list]

[labelgrid-artist-detail]

다운로드 게이트 숏코드

[labelgrid-gate-button]

[labelgrid-gate-download-list]

[labelgrid-gate-download-detail]

프리세이브 숏코드

[labelgrid-presave-button]

CSS 클래스 레퍼런스

문제 해결

릴리스가 표시되지 않을 때

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

스타일 문제

API 연결 오류

게이트 항목 및 내보내기

업데이트

자동 업데이트

수동 업데이트

관련 문서

도움이 필요하신가요?