WordPress 플러그인 사용법

Madoake의 세미나·이벤트를 회사의 WordPress 사이트에 표시하는 플러그인입니다. 목록과 상세 페이지는 사이트의 페이지로 출력되므로 검색 엔진이 사이트의 내용으로 읽습니다. 신청·예약·문의 접수는 Madoake가 처리합니다.

플러그인 다운로드(zip)v0.3.2

할 수 있는 것

원하는 페이지에 세미나 목록 표시(리스트·카드·텍스트만의 3종류, 1~3열)
세미나별 상세 페이지를 사이트에 생성(고지 이미지는 대표 이미지가 되고 Event 구조화 데이터도 붙습니다)
Madoake의 폼·예약 페이지를 사이트 페이지에 삽입(버튼으로 팝업 열기도 가능)
테마의 이벤트 목록이나 홈 화면에 테마 디자인 그대로 섞어서 표시
모든 페이지에 측정 태그를 넣어 사이트 방문과 신청·문의를 같은 사람으로 기록
Contact Form 7 제출을 Madoake 리드로 등록

세미나의 내용·일정·정원·참가비는 Madoake 관리 화면에서 바꿉니다. 플러그인이 Madoake에서 정기적으로 다시 가져와 사이트에 반영합니다(목록은 기본 10분마다).

설치하기

위 버튼으로 zip을 다운로드합니다(압축은 풀지 않습니다).
WordPress 관리 화면에서 ‘플러그인’ → ‘새로 추가’ → ‘플러그인 업로드’를 열고 zip을 선택해 ‘지금 설치’를 누릅니다.
‘플러그인 활성화’를 누릅니다. ‘설정’ 메뉴에 ‘Madoake’가 추가됩니다.

새 버전으로 바꿀 때도 같은 순서입니다. 도중에 ‘업로드한 것으로 현재 것을 교체’를 눌러 주세요. 설정은 그대로 남습니다.

필요한 환경: WordPress 6.0 이상, PHP 7.4 이상.

처음 설정

WordPress의 ‘설정’ → ‘Madoake’에서 다음을 정하고 저장합니다.

URL 이름: Madoake 공개 페이지 URL(https://madoake.com/여기/s/...)의 부분입니다. 브랜드 명의로 세미나를 공개할 때는 브랜드의 URL 이름을 입력합니다.
측정 태그: 켜면 모든 페이지에 Madoake 측정 태그(lt.js)가 들어갑니다. 로그인한 관리자에게는 표시되지 않습니다.

저장하면 화면 위쪽 연결 상태에 가져온 건수와 시각이 표시됩니다. 표시되지 않으면 지금 가져오기·동기화 버튼을 누릅니다.

세미나 목록 표시하기

목록을 표시할 페이지에 숏코드 [madoake_seminars]를 붙여 넣습니다. 예정된 세미나가 날짜순으로, 그 뒤에 끝난 세미나가 표시됩니다.

속성	의미
`layout`	`list`(기본, 왼쪽에 이미지)／`card`(이미지를 크게)／`compact`(텍스트만, 날짜를 크게)
`cols`	1~3열. 기본은 list·compact가 1열, card가 3열. 스마트폰에서는 항상 1열
`limit`	예정된 세미나 건수(1~50, 기본 20)
`past`	끝난 세미나 건수(0~12, 기본 3. 0이면 표시하지 않음)

[madoake_seminars layout="card" cols="2" past="0"]

사이트에 세미나 상세 페이지 만들기

세미나별로 사이트 안에 상세 페이지(예: https://example.com/seminar/세미나-URL/)를 만들 수 있습니다. 목록의 링크도 이 페이지가 되고, 신청 버튼으로 Madoake 신청 페이지로 이동합니다.

WordPress에서 설정

‘설정’ → ‘Madoake’에서 세미나별 상세 페이지 만들기를 켭니다.
URL 중간 부분(예: seminar)을 정하고 저장합니다.
상세 페이지 URL 패턴(예: https://example.com/seminar/{slug}/)이 표시되면 복사합니다.

Madoake에서 설정

Madoake 관리 화면의 ‘회사’ → ‘회사 설정’을 엽니다. 브랜드 명의로 세미나를 공개할 때는 같은 화면에서 브랜드 편집을 엽니다.
‘세미나 상세 페이지 URL’에 복사한 패턴을 붙여 넣고 저장합니다.

그러면 Madoake 신청 페이지는 사이트의 상세 페이지가 대표 페이지라고 검색 엔진에 알립니다(canonical). 같은 내용의 페이지가 둘이 되어 검색 평가가 나뉘는 것을 막고 평가를 회사 사이트에 모읍니다. Madoake 신청 페이지는 신청 접수와 광고·SNS의 입구로 계속 사용할 수 있습니다.

Madoake 신청 페이지를 검색에 노출하고 싶은 세미나(온라인 웨비나 등)는 세미나 편집 화면에서 ‘웹사이트의 상세 페이지로 검색 평가를 모으기’를 끕니다. 그 세미나는 상세 페이지를 만들지 않고 목록에서 Madoake 신청 페이지로 바로 이동합니다.

폼·예약 페이지 삽입하기

Madoake에서 만든 폼·예약 페이지를 사이트 페이지 안에 표시합니다. 입력 확인·봇 대책·알림·확인 메일은 Madoake 설정이 그대로 적용됩니다.

[madoake_form slug="contact"]: 폼. thanks="/thanks/"를 붙이면 제출 후 그 페이지로 이동합니다
[madoake_booking slug="consult"]: 예약 페이지. mode="button" label="일정 선택"으로 버튼을 눌렀을 때 팝업으로 엽니다

slug는 Madoake 공개 URL의 마지막 부분입니다. 폼은 https://madoake.com/URL이름/f/여기, 예약 페이지는 https://madoake.com/URL이름/여기입니다.

테마 디자인 그대로 표시하기

상세 페이지를 만들고 있다면, 플러그인이 세미나 게시물(게시물 유형 madoake_seminar)에 테마의 이벤트 게시물과 같은 필드 이름으로 개최일·요일·참가비·신청 링크를 기록합니다. ‘설정’ → ‘Madoake’에서 필드 이름을 입력하고, 테마 목록 쿼리의 게시물 유형에 madoake_seminar를 추가하면 개최일순으로 섞여 표시됩니다.

'post_type' => array( 'events', 'madoake_seminar' ),

템플릿에서는 madoake_get_seminars()와 madoake_merge_events() 함수도 사용할 수 있습니다. 호출 전에 function_exists로 확인해 주세요.

Contact Form 7 제출을 리드로 기록하기

Contact Form 7 연동의 리드 등록을 켜면 제출한 사람을 Madoake 리스트에 등록합니다. 측정 태그가 켜져 있을 때 작동합니다.

잘 표시되지 않을 때

목록이 비어 있음: 연결 상태를 확인하세요. 오류가 있으면 URL 이름을 확인합니다. Madoake에서 세미나가 공개 상태인지도 확인하세요.
Madoake에서 바꾼 내용이 바로 나오지 않음: 플러그인은 정해진 간격(목록은 기본 10분, 상세 페이지는 15분)으로 다시 가져옵니다. 급할 때는 지금 가져오기·동기화를 누릅니다.
상세 페이지가 ‘페이지를 찾을 수 없음’: WordPress의 ‘설정’ → ‘고유주소’를 열고 아무것도 바꾸지 말고 저장해 주세요.

모르는 점은 관리 화면 오른쪽 아래의 ‘의견·요청’ 버튼으로 알려 주세요.