- CK에디터 안에서 링크 프리뷰 카드를 바로 삽입해줍니다.
- CK에디터 안에서 미디어 콘텐츠를 바로 임베드해줍니다.
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 변수를 활용해서 다양한 스타일을 꾸며볼 수 있습니다.
- '프리뷰 카드 설정'에서 '입력된 도메인만' 항목에서는 '허용'을 선택하기를 권장합니다. 작지 않은 확률로 프리뷰를 위한 데이터 수집에 실패할 수 있기 때문입니다.
윤삼님!!!!!
문의사항이 있어서 메시지 남기게 되었습니다
만들어주신 모듈 너무나도 잘사용하고 있습니다!!!
다시 한번 감사드립니다
다름이 아니라
링크 프리뷰 모듈 사용한 게시 글에
뉴스 기사 주소를 넣고 본문에 첨부 후 글 작성이 완료되고나서
해당 글을 카카오톡에 링크로 공유하면 기존에는 썸네일과 정보들이
작성하고나서도 바로 카톡 내부에서 썸네일이 만들어지고 프리브 모듈 처럼
미리보기가 이쁘게 꾸며서 나왔거든요
근데 오늘 이상한 현상이 발견되었는데
프리뷰 모듈이 등록된 글 작성 직후 작성된 글 주소를 카톡에 올려서 공유를 해보면
미리보기가 출력이 안되서요.
반대로 프리뷰 모듈이 본문에 안들어간 글의 경우에는 작성 후
카톡에 글 링크 공유시 바로 미리보기가 만들어지는 반면
프리브 모듈이 본문에 들어간 글의 경우 작성 후 카톡에 글 공유를 하면
미리보기가 안만들어지고, 반복해서 여러번 링크를 올리거나 일정 시간이 지나서야
미리보기가 만들어지는 문제가 발생되고 있어서요
이렇게 글을 쓰고보니 ^^;; 저만 그런가???? 싶기도하네요
카톡에 문제인지, 프리뷰 모듈 오류인지 모르겠어요 ㅜㅜ
읽어봐주셔서 감사합니다