유튜브 위젯

유튜브 채널 또는 플레이리스트에 있는 동영상 목록을 보여주는 위젯입니다.

유튜브 모듈과 함께 또는 독립적으로 사용이 가능합니다.

기존 유튜브 모듈을 설치하신 분께서는 유튜브 모듈을 선택만 해주시면 모든 설정이 자동으로 연동됩니다.

스킨을 만드시려는 경우 YouTube Data API 중 snippet 부분을 참고하세요!

https://developers.google.com/youtube/v3/docs/playlistItems?hl=ko#header_1

개발 종료

XE1와 호환되는 본 위젯은 더 이상 개발되지 않습니다.

새로운 기능 등에 대한 의견 남겨주시면, 앞으로 개발할 XE3 버전에 반영할 수 있도록 하겠습니다.

감사합니다.

변경내역

V 1.3.0.

새로운 기능, 오류 수정이 있습니다.

새로운 기능 - 팝업 기능(@flowerrain님)

팝업으로 동영상을 재생할 수 있습니다. 위젯 설정에서 팝업 버튼 값을 나타냄으로 설정하시면, 팝업으로 동영상을 열 수 있습니다.

오류 수정 - 카드 스킨

카드 스킨에서 카드 배경이 투명으로 나오던 것을 흰색 배경으로 수정하였습니다.

V 1.2.0.

새로운 기능, 성능 개선, 오류 수정이 있습니다.

새로운 기능 - 모듈 카테고리 기능 지원

모듈에서 카테고리 기능을 사용하는 경우, 여러 카테고리를 하나로 합쳐서 위젯으로 보여줍니다.

새로운 기능 - 무작위 정렬(@flowerrain님)

설정읕 통해 채널/재생목록에 있는 동영상을 무작위로 정렬해서 보여줍니다.

새로운 기능 - 캐시

이제 유튜브 위젯도 유튜브 모듈처럼 캐시 기능을 지원합니다. (본 캐시 기능은 위젯 캐싱이 아닌, 유튜브 재생목록에 대한 캐시 기능입니다.) 유튜브 모듈과 캐시를 공유하여 효율성을 높였습니다.

성능 개선 - 프레임워크 업데이트

유튜브 서버와 통신할 때 사용하는 프레임워크를 업데이트 하였습니다.

오류 수정 - 모듈 연동시의 링크 문제(@flowerrain님)

모듈과 연동해서 사용할 때, 링크를 모듈로 연결되지 않고 유튜브 서버로 연결하던 문제를 해결하였습니다.

오류 수정 - 위젯 설정 값 문제

위젯에서 API 키와 채널/재생목록 아이디를 설정해도, 그 값을 가져오지 못하던 문제를 수정하였습니다.

오류 수정 - 채널/재생목록 아이디 오류

모듈과 연동해서 사용할 때, 모듈에 채널/재생목록 아이디 값이 없는 경우 - 기본 재생목록이 나타나지 않고 오류가 발생하던 문제를 수정하였습니다.

오류 수정 - 인스타그램 위젯과 충돌

인스타그램 위젯과 함께 사용할 경우 충돌이 발생하던 문제를 수정하였습니다.

V 1.1.0.

성능 개선 및 오류 수정이 있습니다.

성능 개선 - 완전히 새로운 구조(@shyduke님, @빡빡2님)

위젯을 재설계하였습니다. 더 이상 XE XML Query를 통해 저수준으로 모듈 정보를 가져오지 않습니다. 또한, 유튜브 모듈 v 1.0.0.과 연동이 가능합니다. 단, 여러 개의 채널/재생목록 아이디를 사용하는 경우 첫 번째 아이디만을 사용합니다.

오류 수정 - 카드 스킨

카드 스킨에서 이미지 표시할 때 크기가 이상하게 나오던 부분을 수정하였습니다.

사용방법

유튜브 모듈 사용자 분께서는 1~5번은 생략하시고, 6번만 수행하시면 됩니다.

1. 구글 개발자 콘솔(http://code.google.com/apis/console)을 접속합니다.
   
2. [API 및 인증 > 사용자 인증 정보]로 이동합니다.
   
3. [공개 API 액세스]의 [새 키 만들기]버튼을 클릭하고, 아래 화면이 나오면 좌측 끝의 [서버 키]를 클릭합니다.
   
4. [API 및 인증 > API]에서 "YouTube Data API v3"를 검색합니다.
   
5. 상단에 있는 [API 사용 설정] 버튼을 클릭합니다.
   
6. 페이지에 위젯 추가를 합니다. 기존 유튜브 모듈을 선택하여 연동하거나, 위에서 발급받은 API 키를 입력하여 사용할 수 있습니다.
   

문제 해결

사용에 어려움을 겪고 있는 경우 다음 절차를 따라해 보시면 정확한 문제 확인이 가능합니다.

1. 채널 아이디 또는 재생목록 아이디가 잘못된 경우

   유튜브 모듈은 채널/재생목록 아이디가 비어있어도 정상 작동합니다. 만약 현재 채널 아이디 또는 재생목록 아이디가 입력되어 있는 상태라면 해당란을 빈 칸으로 놓고 사용해보시길 바랍니다. 만약 기본 값인 #YouTube인기동영상한국 채널이 제대로 나온다면 채널 또는 재생목록 아이디가 잘못 경우이므로 확인 후 사용바랍니다.

2. 서버 시스템 환경에 문제가 있는 경우

   유튜브 모듈은 XpressEngine 데모 서버에서도 정상 작동합니다. xpressengine.com으로 가셔서 XE 체험하기 버튼을 눌러 데모 서버 생성 및 유튜브 모듈을 쉬운설치 하시고 본인의 API 키를 입력해 보시길 바랍니다. 정상적으로 작동한다면 서버 시스템에서 구글과의 통신에 필요한 CURL 라이브러리 사용이 제한되는 경우, PHP 버전이 5 이하인 경우이므로 확인 부탁드립니다.
   

3. 구글 개발자 콘솔 설정에 문제가 있는 경우

   위의 방법이 모두 되지 않는다면 구글 개발자 콘솔에 문제가 있는 경우입니다. 이 경우 구글 개발자 콘솔로 이동하셔서 확인이 필요합니다.

1. API 키가 잘못된 경우

   API 키가 잘못 입력된 경우입니다. 먼저 API 키 입력 시 앞 또는 뒤 등에 공백이 삽입되어 있거나, 잘못된 문자가 추가로 입력되었을 수 있습니다. 이 경우 구글 개발자 콘솔에 있는 값을 정확히 복사, 붙여넣기 하시면 되겠습니다. 그리고 다른 키를 입력한 경우도 있을 수 있습니다. 반드시 위의 안내대로 "공개 API 액세스 > 서버 키"를 발급하셔야 제대로 작동이 됩니다.

2. YouTube Data API v3를 사용설정하지 않은 경우

   YouTube Data API 사용 설정이 되어 있지 않거나, YouTube Data API v3가 아닌 YouTube Analytics API로 사용설정이 되어 있는 것은 아닌지 확인해보시기 바랍니다. "구글 개발자 콘솔 > API 및 인증 > API" 화면에서 "사용 설정된 API" 탭을 통해 간편하게 확인이 가능합니다.

3. 사용량이 초과된 경우

   무료 사용자의 경우 API 사용량에 제한이 있습니다. "구글 개발자 콘솔 > API 및 인증 > API" 화면에서 "사용 설정된 API" 탭을 누르시면 %로 표시되는 할당량을 통해서 자신의 API 사용량을 확인할 수 있습니다.
   

버그

사용 중 버그를 발견하시면 XpressEngine 공식 홈페이지 포럼란(https://www.xpressengine.com/index.php?mid=download&package_id=22753678#forum-list)에 남겨주세요. 적극 반영하겠습니다.