링크 프리뷰

- CK에디터 안에서 링크 프리뷰 카드를 바로 삽입해줍니다.

- CK에디터 안에서 미디어 콘텐츠를 바로 임베드해줍니다.

0.0.4 업데이트

- 2022.11.30

- [프리뷰 카드]  자기 사이트의 url 링크에 대해서는 라이믹스 내장 함수를 이용하여 권한 체크를 하고 프리뷰 정보 수집 (마트몬님)

 

1. 설치 방법

- 첨부한 압축파일을 압축 해제하고 ./modules/preview 에 설치합니다.

- 파일 업로드 후 다음 페이지에 나오는 '1. 보안 설정', '2. CK에디터 플러그인 설치'를 따라합니다.

 

2. 모듈 설정

- 관리자 페이지의 고급 > 설치된 모듈 > 링크 프리뷰로 들어가서 설정값을 입력합니다.

 

1) 기본 설정

• 모듈 사용 : 아니오를 선택하면 모듈 전체가 실행되지 않습니다.
• 링크 텍스트 남기기 : 프리뷰 카드 및 임베디드 미디어와 함께 링크 텍스트를 남기거나 지울 수 있습니다.
• 링크 텍스트 꾸미기 : 링크 텍스트를 표시할 때 스타일을 줄 수 있습니다. 기본값은 <p>%text%</p>입니다. %text% 앞 뒤로 태그를 붙여 스타일을 꾸며보세요.
• 사용자 스크립트 : 스크립트 구문을 추가할 수 있습니다. script 태그 안에 들어갈 구문만 입력해주세요.

 

2) 프리뷰 카드 설정

• 프리뷰 카드 사용 : 링크 페이지 미리보기를 카드 형식으로 출력할 수 있습니다.
• 스킨 : 프리뷰 카드의 스킨을 선택합니다. 기본 스킨(default)이 제공됩니다.
• 외부접속 제한 시간 : 프리뷰를 위해 url의 서버와 연결할 최대 시간을 제한합니다.
• 입력된 도메인만 : 특정 도메인에 대해서만 프리뷰 카드 생성을 허용하거나 허용하지 않을 수 있습니다.
• 허용/제외할 도메인 : 프리뷰에서 허용 또는 제외할 도메인을 줄 단위로 입력합니다. (가급적 '허용' 옵션 선택을 권장합니다)
• 이미지 파일 첨부 : 링크 페이지의 대표 이미지를 파일로 저장할 수 있습니다.
• 파일 첨부 예외 도메인 : 이미지 파일 첨부 대상에서 제외할 도메인을 줄 단위로 입력합니다.
• gif를 jpg로 : 링크 페이지의 대표 이미지가 "움직이는 gif" 파일일 경우 "jpg"로 변환하여 저장합니다.

 

3) 미디어 임베드 설정

• 미디어 임베드 사용 : 주요 미디어 콘텐츠들을 iframe 형태로 바로 삽입할 수 있습니다.
• 미디어 임베드 목록 : iframe으로 삽입할 미디어 콘텐츠들을 선별할 수 있습니다.

 

4) 게시판 공통 설정

• 선택한 모듈에서만 : 특정 모듈에서만 프리뷰와 임베드를 작동 또는 미작동시킬 수 있습니다.
• 모듈 목록 : 작동 또는 미작동시킬 모듈을 선택합니다.

 

3. 소소한 팁

• ./modules/preview/tpl/css 폴더에 custom.css 파일을 만들어 저장/업로드하면  자신만의 스타일로 프리뷰 카드와 미디어 임베드를 제어할 수 있습니다.
• ./modules/preview/skins 폴더에 프리뷰 카드 스킨 폴더를 만들어보세요. 기본 제공되는 $preview_info 변수를 활용해서 다양한 스타일을 꾸며볼 수 있습니다.
• '프리뷰 카드 설정'에서 '입력된 도메인만' 항목에서는 '허용'을 선택하기를 권장합니다. 작지 않은 확률로 프리뷰를 위한 데이터 수집에 실패할 수 있기 때문입니다.