- CK에디터 안에서 링크 프리뷰 카드를 바로 삽입해줍니다.
- CK에디터 안에서 미디어 콘텐츠를 바로 임베드해줍니다.
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
2. 모듈 설정
- 관리자 페이지의 고급 > 설치된 모듈 > 링크 프리뷰로 들어가서 설정값을 입력합니다.
1) 기본 설정
- 모듈 사용 : 아니오를 선택하면 모듈 전체가 실행되지 않습니다.
- 링크 텍스트 남기기 : 프리뷰 카드 및 임베디드 미디어와 함께 링크 텍스트를 남기거나 지울 수 있습니다.
- 링크 텍스트 꾸미기 : 링크 텍스트를 표시할 때 스타일을 줄 수 있습니다. 기본값은 <p>%text%</p>입니다. %text% 앞 뒤로 태그를 붙여 스타일을 꾸며보세요.
- 사용자 스크립트 : 스크립트 구문을 추가할 수 있습니다. script 태그 안에 들어갈 구문만 입력해주세요.
2) 프리뷰 카드 설정
- 프리뷰 카드 사용 : 링크 페이지 미리보기를 카드 형식으로 출력할 수 있습니다.
- 스킨 : 프리뷰 카드의 스킨을 선택합니다. 기본 스킨(default)이 제공됩니다.
- 외부접속 제한 시간 : 프리뷰를 위해 url의 서버와 연결할 최대 시간을 제한합니다.
- 입력된 도메인만 : 특정 도메인에 대해서만 프리뷰 카드 생성을 허용하거나 허용하지 않을 수 있습니다.
- 허용/제외할 도메인 : 프리뷰에서 허용 또는 제외할 도메인을 줄 단위로 입력합니다. (가급적 '허용' 옵션 선택을 권장합니다)
- 이미지 파일 첨부 : 링크 페이지의 대표 이미지를 파일로 저장할 수 있습니다.
- 파일 첨부 예외 도메인 : 이미지 파일 첨부 대상에서 제외할 도메인을 줄 단위로 입력합니다.
- gif를 jpg로 : 링크 페이지의 대표 이미지가 "움직이는 gif" 파일일 경우 "jpg"로 변환하여 저장합니다.
3) 미디어 임베드 설정
- 미디어 임베드 사용 : 주요 미디어 콘텐츠들을 iframe 형태로 바로 삽입할 수 있습니다.
- 미디어 임베드 목록 : iframe으로 삽입할 미디어 콘텐츠들을 선별할 수 있습니다.
- https://dev.aporia.blog/board_fKje48/46714 3번(지원사항) 항목 참고
4) 게시판 공통 설정
- 선택한 모듈에서만 : 특정 모듈에서만 프리뷰와 임베드를 작동 또는 미작동시킬 수 있습니다.
- 모듈 목록 : 작동 또는 미작동시킬 모듈을 선택합니다.
3. 소소한 팁
- ./modules/preview/tpl/css 폴더에 custom.css 파일을 만들어 저장/업로드하면 자신만의 스타일로 프리뷰 카드와 미디어 임베드를 제어할 수 있습니다.
- ./modules/preview/skins 폴더에 프리뷰 카드 스킨 폴더를 만들어보세요. 기본 제공되는 $preview_info 변수를 활용해서 다양한 스타일을 꾸며볼 수 있습니다.
- '프리뷰 카드 설정'에서 '입력된 도메인만' 항목에서는 '허용'을 선택하기를 권장합니다. 작지 않은 확률로 프리뷰를 위한 데이터 수집에 실패할 수 있기 때문입니다.
아래 스샷처럼 STARIS 에디터에서도 잘 작동합니다.
파일 두개를 간단히 수정하면 작동되더군요.
ckeditor 에서 테스트했을때 YouTube 를 임베드하면 썸네일이 첨부 파일로 추가 안되던데.. 원래 그런건가요?
좀 더 테스트해보고 수정 파일만 댓글로 업로드하겠습니다.