- CK에디터 안에서 링크 프리뷰 카드를 바로 삽입해줍니다.
- CK에디터 안에서 미디어 콘텐츠를 바로 임베드해줍니다.
0.1.0 업데이트
- 2024.10.14
: 변경 사항이 꽤 많으므로 구버전 사용자께서는 '보안 설정'에서 iframe 및 HTML class, '모듈 설정'에서 미디어 임베드 목록 등을 잘 검토해주시기 바랍니다.
- [프리뷰 카드]
-
설정에서 '허용/제외할 도메인' 목록의 저장 오류를 수정 (톰캣님)
-
이미지 파일이 업로드되지 않던 문제를 수정
-
설정에서 '허용/제외할 도메인' 및 '파일 첨부 예외 도메인' 목록에 *.xetown.com 형태의 도메인을 활용할 수 있게 함 (에카님)
- [미디어 임베드]
-
AfreecaTV (아프리카TV) : 지원 종료 (숲(SOOP)으로 변경)
-
Airbnb (에어비앤비) : 체험 예약 페이지 지원 종료
-
Amazon Book : 지원 종료
-
Amazon Music (아마존 뮤직)
: 트랙 관련 코드 수정
: 썸네일 추출 방식 수정 -
Audio Clip (오디오 클립) : 큐레이션과 라이브의 프리뷰 카드 보완
-
Chzzk (치지직) : 채널, 라이브, 비디오 등은 프리뷰 카드 출력
-
Code Sandbox : CORS 적용
-
Dailymotion (데일리모션)
: 별도의 공개된 API 활용
: 주소 체계 변경 사항 반영 -
Ellentube : 서비스 폐지에 따라 지원 종료
-
Getty Images
: 짧은 주소 지원 중단
: 동영상 임베드 지원 중단 -
Gfycat : 사업 종료에 따라 지원 종료
-
Giphy : 비디오의 iframe 삽입 주소 수정
-
IMDb
: 반응형 iframe 지원
: 썸네일 추출 방식 간소화 -
Jjalbot (짤봇) : iframe 대신 이미지를 직접 로드
-
JSFiddle : 다크모드 대신 라이트모드로 임베드
-
Kakao TV (다음카카오) : 영화 섹션 제거
-
KTV : 다시보기 서비스 신규 지원
-
Mixcloud : api endpoint url을 encode 처리
-
Naver (네이버)
: 전반적인 재검토. 쇼핑라이브 제거
: 짧은 주소 보완
: 숏폼 영상 지원 -
Pinterest
: 짧은 주소 해제 api 사용
: 일부 수정된 주소 체계 반영 -
Podbbang (팟빵) : iframe 삽입 페이지의 https 보안 이슈를 우회
-
Podcasts (팟캐스트) : 신규 지원
-
Prezi : 정규식 및 정보 추출 방식 수정
-
QQ : 아이프레임 및 썸네일 추출 방식 간소화
-
SBS : 라이브, 다시보기, 클립 모든 영상 콘텐츠 지원
-
Slideshare : 추가된 새로운 주소 체계에도 대응
-
SOOP (숲)
: 라이브, vod, catch 등 미디어 콘텐츠 임베딩 제공
: vod.sooplive.co.kr
: play.sooplive.co.kr -
Spotify (스포티파이) : 팟캐스트 오디오 및 비디오 지원 추가
-
Streamable : 정보 추출을 위한 정규식 수정
-
Tiktok (틱톡) : 정규식 보완
-
Tumblr
: 주소 체계 변경 사항 반영
: message 이벤트에서 반환되는 데이터 형식 변경 사항 반영 -
TV Sohu : 주소 변경에 대응하여 재귀함수 적용
-
Twitch (트위치) : 한국 내 사업 종료에 따라 지원 종료
-
Vlive : 위버스로 통합 후 회원제 운영으로 지원 중단
-
X.com
: 트위터 대신 X로 이름 변경 -> 관리자 페이지에서 X 임베딩을 새로 체크해야 함
: 위젯 js를 불러와서 에디터에 iframe 요소를 바로 삽입하도록 수정
0.0.7 업데이트
- 2024.10.14
- [전체] PHP 8.x에 대응하도록 문법 일부 수정
- [프리뷰 카드] 프리뷰 카드 실패시 동작 개선
: 전역 변수값이 불충분하게 전달됐을 경우 현재까지의 정보만으로 프리뷰 카드 출력
- [미디어 임베드] Apple Music (애플 뮤직) : 애플 뮤직에서 제공하는 oembed api 활용. 뮤직 비디오 자동 삽입 서비스 추가. 라디오 스테이션은 서비스 제외
- [미디어 임베드] Chzzk (치지직) : 신규 추가. 단, 클립 영상만 임베드
- [미디어 임베드] Telegram (텔레그램) : 신규 추가. 단, 채널 메시지만 임베드
- [미디어 임베드] Udio : 신규 추가. 개별 음악만 임베드
0.0.6 업데이트
- 2023.12.24
- [전체] 모듈 첫 설치시 선택 모듈srl을 식별하지 않는 문제 수정 (SimpleCode님) ... /modules/preview/preview.controller.php
- [전체] 링크 텍스트 위치 설정 옵션 제공 (SimpleCode님) . 모두 위로, 프리뷰 카드에서만 아래로, 미디어 임베드에서만 아래로, 모두 아래로 등
... /modules/preview/preview.admin.view.php
... /modules/preview/lang/ko.php
... /modules/preview/preview.controller.php
... /modules/preview/tpl/js/_ckeditor.js
- [프리뷰 카드] amazon.com의 상품 링크가 아마존북의 미디어 임베드로 인식되지 않도록 수정
... /modules/preview/tpl/js/_ckeditor.js
0.0.5 업데이트
- 2023.12.15
- [전체] 프리뷰 카드의 도메인 허용/제외 옵션이 미디어 임베드에도 영향을 주는 문제 수정 (블리스세븐님)
- [전체] 관리자 페이지의 휴지통에서도 프리뷰 카드 출력 적용
- [프리뷰 카드] 클립보드 텍스트 안에 url이 포함됐을 경우 자기 사이트의 프리뷰 카드가 함께 출력되는 문제 수정 (karius님)
- [미디어 임베드] AfreecaTV : 추가된 숏폼 형식(catch) 지원
- [미디어 임베드] Reddit (레딧) : 컨텐츠의 세로사이즈 자동 맞춤. event.origin이 https://embed.reddit.com 으로 변경됨
- [미디어 임베드] Tumblr : 추가된 주소 체계, 앱링크 주소 체계에 대응 + 공개된 api를 이용하여 포스트의 type을 식별하고 그에 따라 썸네일을 가져옴
- [미디어 임베드] Twitter : x.com 주소 반영(블랙그라운님)
- [미디어 임베드] Vimeo : 추가된 주소 체계 대응
- [미디어 임베드] Youtube : 글 제목이 비어 있을 때 영상 제목을 자동으로 입력 옵션 추가
0.0.4 업데이트
- 2022.11.30
- [프리뷰 카드] 자기 사이트의 url 링크에 대해서는 라이믹스 내장 함수를 이용하여 권한 체크를 하고 프리뷰 정보 수집 (마트몬님)
1. 설치 방법
- 첨부한 압축파일을 압축 해제하고 ./modules/preview 에 설치합니다.
- 파일 업로드 후 다음 페이지에 나오는 '1. 보안 설정', '2. CK에디터 플러그인 설치'를 따라합니다.
- https://dev.aporia.blog/board_fKje48/46714#user_content_chapter_1
2. 모듈 설정
- 관리자 페이지의 고급 > 설치된 모듈 > 링크 프리뷰로 들어가서 설정값을 입력합니다.
1) 기본 설정
- 모듈 사용 : 아니오를 선택하면 모듈 전체가 실행되지 않습니다.
- 링크 텍스트 남기기 : 프리뷰 카드 및 임베디드 미디어와 함께 링크 텍스트를 남기거나 지울 수 있습니다.
- 링크 텍스트 꾸미기 : 링크 텍스트를 표시할 때 스타일을 줄 수 있습니다. 기본값은 <p>%text%</p>입니다. %text% 앞 뒤로 태그를 붙여 스타일을 꾸며보세요.
- 사용자 스크립트 : 스크립트 구문을 추가할 수 있습니다. script 태그 안에 들어갈 구문만 입력해주세요.
2) 프리뷰 카드 설정
- 프리뷰 카드 사용 : 링크 페이지 미리보기를 카드 형식으로 출력할 수 있습니다.
- 스킨 : 프리뷰 카드의 스킨을 선택합니다. 기본 스킨(default)이 제공됩니다.
- 외부접속 제한 시간 : 프리뷰를 위해 url의 서버와 연결할 최대 시간을 제한합니다.
- 입력된 도메인만 : 특정 도메인에 대해서만 프리뷰 카드 생성을 허용하거나 허용하지 않을 수 있습니다.
- 허용/제외할 도메인 : 프리뷰에서 허용 또는 제외할 도메인을 줄 단위로 입력합니다. (가급적 '허용' 옵션 선택을 권장합니다)
- 이미지 파일 첨부 : 링크 페이지의 대표 이미지를 파일로 저장할 수 있습니다.
- 파일 첨부 예외 도메인 : 이미지 파일 첨부 대상에서 제외할 도메인을 줄 단위로 입력합니다.
- gif를 jpg로 : 링크 페이지의 대표 이미지가 "움직이는 gif" 파일일 경우 "jpg"로 변환하여 저장합니다.
3) 미디어 임베드 설정
- 미디어 임베드 사용 : 주요 미디어 콘텐츠들을 iframe 형태로 바로 삽입할 수 있습니다.
- 미디어 임베드 목록 : iframe으로 삽입할 미디어 콘텐츠들을 선별할 수 있습니다.
- https://dev.aporia.blog/board_fKje48/46714#user_content_chapter_3 3번(지원사항) 항목 참고
4) 게시판 공통 설정
- 선택한 모듈에서만 : 특정 모듈에서만 프리뷰와 임베드를 작동 또는 미작동시킬 수 있습니다.
- 모듈 목록 : 작동 또는 미작동시킬 모듈을 선택합니다.
3. 소소한 팁
- ./modules/preview/tpl/css 폴더에 custom.css 파일을 만들어 저장/업로드하면 자신만의 스타일로 프리뷰 카드와 미디어 임베드를 제어할 수 있습니다.
- ./modules/preview/skins 폴더에 프리뷰 카드 스킨 폴더를 만들어보세요. 기본 제공되는 $preview_info 변수를 활용해서 다양한 스타일을 꾸며볼 수 있습니다.
- '프리뷰 카드 설정'에서 '입력된 도메인만' 항목에서는 '허용'을 선택하기를 권장합니다. 작지 않은 확률로 프리뷰를 위한 데이터 수집에 실패할 수 있기 때문입니다.
[-1] 보안정책상 허용하지않습니다라는 alert 창이 뜨는데 추가설정이 더 필요할까요!?