XE 공식 자료실
- 제작자
- Michael
- 등록일
- 2015-06-09
- 다운로드 수
- 151
- 링크1
- mson0129/XEModuleYouTube
- 링크2
- mson0129/XEModuleYouTube
유튜브 채널 또는 재생목록에 있는 동영상 목록을 게시판 형태로 보여주는 모듈입니다.
*XE 문서로 변환 및 가져오는(Importing) 개념이 아닙니다.
PHP 5 이상, Curl 라이브러리가 사용가능한 환경에서 작동합니다.
Cafe24 호스팅, XE Core 1.8.1 및 XE 체험 서버, XE Core 1.8.3에서 테스트 되었습니다.
- 라이선스
- New BSD License
- 설치경로
- ./modules/youtube
- 최초 등록일
- 2015-06-08
- 전체 다운로드
- 7,710
쉬운설치로 바로 체험할 수 있습니다
상세 설명
유튜브 모듈
유튜브 채널 또는 플레이리스트에 있는 동영상 목록을 가져오는 모듈입니다.
스킨을 만드시려는 경우 YouTube Data API 중 snippet 부분을 참고하세요!
https://developers.google.com/youtube/v3/docs/playlistItems?hl=ko#header_1
변경내역
V 0.1.1.
각종 버그가 수정되었습니다.
페이지 네비게이션
페이지 네비게이션이 제대로 표시되지 않던 문제를 수정하였습니다.
현재 보고 있는 페이지를 기준으로 9개 씩 네비개이션 항목이 표시됩니다.
자동 페이지 찾기
동영상 보기에서 현재 페이지가 인수로 지정되지 않은 경우, 동영상이 있는 페이지를 자동으로 찾습니다.
목록 수
목록 보기에서 화면 당 출력하는 동영상의 개수를 지정할 수 없었던 문제를 수정하였습니다.
사용방법
- 구글 개발자 콘솔(http://code.google.com/apis/console)을 접속합니다.
- [API 및 인증 > 사용자 인증 정보]로 이동합니다.
- [공개 API 액세스]의 [새 키 만들기]버튼을 클릭하고, 아래 화면이 나오면 좌측 끝의 [서버 키]를 클릭합니다.
- [API 및 인증 > API]에서 "YouTube Data API v3"를 검색합니다.
- 상단에 있는 [API 사용 설정] 버튼을 클릭합니다.
- [XE Admin에서 메뉴 추가 > 유튜브]로 추가합니다.
- 방금 추가한 메뉴를 선택한 후 상세 설정으로 들어가 1에서 발급받은 API 키(필수)와 채널 이름 또는 재생목록 아이디를 입력합니다.
문제 해결
사용에 어려움을 겪고 있는 경우 다음 절차를 따라해 보시면 정확한 문제 확인이 가능합니다.
-
채널 아이디 또는 재생목록 아이디가 잘못된 경우
유튜브 모듈은 채널/재생목록 아이디가 비어있어도 정상 작동합니다. 만약 현재 채널 아이디 또는 재생목록 아이디가 입력되어 있는 상태라면 해당란을 빈 칸으로 놓고 사용해보시길 바랍니다. 만약 기본 값인 #YouTube인기동영상한국 채널이 제대로 나온다면 채널 또는 재생목록 아이디가 잘못 경우이므로 확인 후 사용바랍니다. -
서버 시스템 환경에 문제가 있는 경우
유튜브 모듈은 XpressEngine 데모 서버에서도 정상 작동합니다. xpressengine.com으로 가셔서 XE 체험하기 버튼을 눌러 데모 서버 생성 및 유튜브 모듈을 쉬운설치 하시고 본인의 API 키를 입력해 보시길 바랍니다. 정상적으로 작동한다면 서버 시스템에서 구글과의 통신에 필요한 CURL 라이브러리 사용이 제한되는 경우, PHP 버전이 5 이하인 경우이므로 확인 부탁드립니다.
-
구글 개발자 콘솔 설정에 문제가 있는 경우
위의 방법이 모두 되지 않는다면 구글 개발자 콘솔에 문제가 있는 경우입니다. 이 경우 구글 개발자 콘솔로 이동하셔서 확인이 필요합니다. -
API 키가 잘못된 경우
API 키가 잘못 입력된 경우입니다. 먼저 API 키 입력 시 앞 또는 뒤 등에 공백이 삽입되어 있거나, 잘못된 문자가 추가로 입력되었을 수 있습니다. 이 경우 구글 개발자 콘솔에 있는 값을 정확히 복사, 붙여넣기 하시면 되겠습니다. 그리고 다른 키를 입력한 경우도 있을 수 있습니다. 반드시 위의 안내대로 "공개 API 액세스 > 서버 키"를 발급하셔야 제대로 작동이 됩니다. -
YouTube Data API v3를 사용설정하지 않은 경우
YouTube Data API 사용 설정이 되어 있지 않거나, YouTube Data API v3가 아닌 YouTube Analytics API로 사용설정이 되어 있는 것은 아닌지 확인해보시기 바랍니다. "구글 개발자 콘솔 > API 및 인증 > API" 화면에서 "사용 설정된 API" 탭을 통해 간편하게 확인이 가능합니다. -
사용량이 초과된 경우
무료 사용자의 경우 API 사용량에 제한이 있습니다. "구글 개발자 콘솔 > API 및 인증 > API" 화면에서 "사용 설정된 API" 탭을 누르시면 %로 표시되는 할당량을 통해서 자신의 API 사용량을 확인할 수 있습니다.
버그
사용 중 버그를 발견하시면 XpressEngine 공식 홈페이지 포럼란(https://www.xpressengine.com/?mid=download&package_id=22753675#forum-list)에 남겨주시면 반영하겠습니다.
포럼 13
-
2015-06-09 23:42:51 제작자 Michael
@김동재859님
한 페이지당 출력될 갯수는 0.1.1버전으로 업하신 다음에 상세설정에서 "목록 수"에 숫자를 입력하시면 설정할 수 있습니다~
그리고 말씀주신 검색기능도 있으면 좋을 것같긴 한데 일단 API 수준에서 지원을 하고 있지가 않습니다. 물론 맘 먹고 달려들면 구현할 수는 있지만, 그렇게 하면 API 사용량(https://developers.google.com/youtube/v3/determine_quota_cost?hl=ko)이 급격히 증가하여, 유료 계정으로 전환해야 할 수도 있습니다. 이 부분은 제가 성능 등의 문제를 고려하여 반영해보록 하겠습니다.
좋은 피드백 감사합니다 ^^ -
2015-06-09 23:34:45 제작자 Michael
@1052님
기본적으로 재생목록에 동영상을 추가하면 10, 11번 이런식으로 추가가 되는 바람에, 역정렬은 저도 처음엔 있었으면 좋겠다고 생각한 기능이었거든요~ 일단 알고리즘은 생각해 놨으니 시간만 있으면 구현 가능할 것 같습니다.
그리고 원래 구상은 채널 아이디만 입력하면 채널에 있는 재생목록을 불러와서 분류처럼 구분해서 사용하는 방식으로 구현하려고 했는데 (내장된 프레임워크는 이미 기능이 있긴 합니다. ㅠㅠ), 제가 발코딩이어서 미처 구현을 못했네요~
근데 제가 애초에 구상(모듈=채널)한 것보다 1052님 말씀처럼 구현하는 것이 훨씬 유연한 방법인 것 같습니다. 1052님 의견 주신 방향으로 구현할 수 있도록 반영해보겠습니다. ^ㅡ^ (과연..?!) -
2015-06-09 23:16:20 1052
아 한참 모듈에 정렬부분 수정할만한 부분이 있나 보다가 없어서 질문드린건데 유튭에서 간단하게 리스트정렬을 할수가 있었네요~ 이부분은 굳이 기능을 추가할 필요없이 유튜브내에서 다양한 정렬기능이 있으니 모듈냉에 설명만 간단하게 추가하셔도 될것같다는 생각이 듭니다.
ps.혹시 가능하다면 유튜브플레이리스트를 여러개 만들어서 사용하는 사람도있는데
그걸 게시판의 분류형식처럼 구분해서 불러오는건 어떨까요? (채널/플레이리스트 아이디를 다중으로 불러오는식으로해서)
그냥 지금도 충분히 만족스러우나 문득 생각나서 건의해보는것이니 답변이나 업데이트에 고려하지 않으셔도 됩니다. -
2015-06-09 23:01:06 제작자 Michael
@김동재859님
허용된 IP는 API 키가 유출되어서 다른 사람이 악용하는 경우 등을 방지하기 위해서, 자신이 API 키를 사용할 컴퓨터를 IP로 지정해주는 것을 말합니다.
API 키 유출 가능성만 없다면 지정해주지 않아도 되고, 만약 보안이 신경 쓰이신다면 본 모듈을 설치한 서버의 IP를 입력해주시면 됩니다~ -
2015-06-09 22:29:27 제작자 Michael
@김동재859님
아니요. 오래 걸리지 않습니다. 서버간 통신으로 인한 지연만 없을 뿐 Google도 같은 방식을 통해 YouTube.com을 표시하기 때문에 유튜브에 동영상이 있다면 바로 나와야 정상입니다.
1. API 키만 입력 후 조회
일단 API 키만 입력하신 후 조회하셔서 #YouTube인기동영상한국 목록이 나오신다면, 채널 ID 또는 재생목록 ID가 잘못된 경우입니다. 이런 경우에는 ID 부분만 재확인해보실 필요가 있을 것 같습니다.
2. XpressEngine 체험하기를 통해 테스트
API 키만 입력한 상태에서도 작동하지 않는다면 API키 또는 시스템에 문제가 있는 경우입니다. 이런 경우에는 xpressengine.com 메인화면에서 데모서버를 제공하고 있으니, 데모서버에서 같은 API 키로 테스트를 해보시길 권유합니다.
데모 서버에서 API 키 입력후 작동하면 해당 서버의 시스템 문제, 작동하지 않는다면 API 키 또는 구글 개발자 콘솔에서 YouTube Data API v3 사용 설정이 잘못된 경우입니다.
이런 경우에는 구글 개발자 콘솔에서 API 키를 다시 한 번 확인하시거나(공백이 추가로 입력된 경우 등등), YouTube Data API 사용설정이 되었는지 확인을 부탁드립니다.
의견 주셔서 감사합니다~ 잘 해결되었으면 좋겠네요 ㅠㅠ
