주의: 이 애드온은 업그레이드 버전이 있습니다.

(이 애드온의 최신판 업데이트는 XE 공식사이트와 제 블로그의 라이트박스 애드온 포스트 에서 하도록 하겠습니다. ^^)


이 애드온은 현재 Zeroboard XE 0.1.1에서 테스트되었습니다. 현재 이 애드온의 버전은 0.5.7입니다. (하루만에 3번 릴리즈 -_-)

0.5.7: 예기치 않은 비정상 작동으로 페이지/게시판/블로그 편집시 문제가 발생하는 현상을 수정했습니다.
0.5.6: 0.5.5 배포본 안의 실수 약간을 수정. 문제가 생길만한 부분 수정
0.5.5: 0.5의 문제 수정 버전. 스크립트를 LightBox에서 그 Modification인 Lytebox로 교체
0.5.0: 첫 릴리즈

이 애드온은 제로보드 XE로 만든 웹사이트에 포함된 이미지를 자동으로 라이트박스 모듈과 연결시켜줍니다. 아울러 제로보드 XE에 기본적으로 포함된 이미지 자동축소 루틴을 라이트박스 모듈과 연결시키는 루틴으로 교체해줍니다.


라이트 박스란??


라이트 박스는 그림을 팝업형식으로 띄우면서도 윈도우창을 별도로 열거나 하지 않으면서 그림을 예쁘게 출력해주는 가장 인기있는 자바 스크립트중 하나입니다. 최근에는 이 라이브러리 자체의 덩치도 꽤 커져서 그냥 만들어 쓰시는 분들도 계십니다만 전 세계적으로 많이 쓰는 스크립트중 하나이기 때문에 브라우저간 호환성이나 프로젝트 진행속도가 가장 나을것 같아서 이것을 선택하였습니다.

단, 0.5.7 버전은 오리지널 라이트박스의 경량판이면서도 동일한 효과를 가지는 Lytebox 3.2 스크립트를 사용하고 있습니다.

Markus F. Hay씨의 Lytebox 3.2 사이트
Lokesh Dhakar씨의 Lightbox 2.0 사이트

lightbox_addon_sshot.jpg

이 애드온을 설치하시면 XE의 게시물이나 블로그의 사진들이 위처럼 나옵니다.

아울러 이 애드온은 바로 윗 사진처럼 레이아웃을 깨뜨리지 않기 위해 자동으로 축소된 이미지의 출력 방식 역시 제로보드 XE코드를 라이트박스 코드로 갈아치웁니다. (깔아보시면 이해하실 수 있을겁니다... 아마도)

뿐만 아니라 모듈 인스턴스(보통 위젯에서 타겟 모듈이라고 칭하는)간에 선택적으로 적용이 가능하므로 '사진 게시판'이나 기타 그림과 관련된 게시판에만 기능을 적용시킬 수 있습니다.



설치방법


1) 본 문서에 첨부된 파일을 다운로드 받습니다. (삭제되었습니다. 최신버전을 검색해주시기 바랍니다.)
2) 압축을 해제합니다. 압축이 풀린 디렉토리 아래에 'digist_lightbox'라는 디렉토리가 생겨있음을 확인하실 수 있습니다.
3) 서브디렉토리까지 모두 포함하여 digist_lightbox 디렉토리 내용 전부를 제로보드 XE의 Addons 디렉토리에 업로드합니다. 예를 들어 zbxe라는 디렉토리에 제로보드가 설치되어 있다면 경로는 다음과 같습니다. (/zbxe/addons/digist_lightbox)
4) Admin 화면에 들어가서 애드온 메뉴를 누릅니다. 적합하게 설치되었다면 "DIGIST 라이트박스 활성화 애드온"이라는 애드온이 목록에 출력될 것입니다. 애드온을 활성화 시키기 위하여 "사용"상태로 만들어 주십시오.

주의: 만일 이전에 0.5 버전을 설치하셨던 분은 불편하시더라도 이전 버전을 완전히 삭제하신 후에 재설치 해주시기 바랍니다.



세부설정


이 애드온은 부가적인 사용자 설정을 지원하고 있습니다. 좀 더 원활한 사용을 위하여 본 애드온의 설정방법에 대해 숙지하시기 바랍니다. (정 모르시겠다면 설정을 하지 않고 그냥 쓰셔도 되긴 합니다.)

lightbox_addon_option.jpg

XE관리자 메뉴의 애드온 설정화면에서 본 애드온의 "설정" 버튼을 클릭하시면 위와 같은 창이 뜹니다.

- 대상 모듈은 실제로 모듈 그 자체가 아닌 모듈의 인스턴스를 가리키고 있습니다. 쉽게 말해서 게시판이나 블로그의 아이디를 써주시면 됩니다. (board 모듈로 만든 freeboard 게시판. mid값으로 설정되는 freeboard라는 이름이 바로 이 아이디입니다.)
- 대상 모듈을 공란으로 비우면 제로보드 XE 영향하에 구동되는 모든 모듈의 인스턴스(페이지 포함)가 렌더링될때 이 애드온이구동됩니다.
- 대상 모듈을 한정하고 싶다면 mid값을 차례대로 기록하되 이름끼리 쉼표(,)로 연결하시기 바랍니다.(예: freeboard,myblog) 이렇게 mid가 지정되면 해당 mid값을 가진 블로그나 게시판, 페이지만이 라이트박스를 이용하여 모든 이미지를 볼 수 있게 됩니다.
- 대상 모듈로 지정되지 않은 게시판이나 블로그, 페이지에선 그림을 클릭해도 라이트박스가 뜨지 않습니다. 단, 이미지가 커서 자동으로 축소된 이미지는 라이트박스가 구동되어 원본 이미지를 보여줍니다.
- 만일 작동방법 필드에 "resizedOnly"라고 쓰시면 대상 모듈에 상관없이 무조건 사이트의 이미지 중에 자동으로 축소한 이미지만을 라이트박스를 이용하여 보여주게 됩니다.


※ 제목을 출력시킬수도 있습니다. 그림을 본문에 삽입할 때 에디터에서 "설명입력"을 하시면 그것이 제목으로 나오게 됩니다.



참고


1) 이 애드온은 Lightbox의 경량판으로 Markus F. Hay씨가 작성한 Lytebox 3.2 버전 스크립트를 사용합니다.
2) 이 스크립트는 제로보드 XE 1.0.1과 테스트 되었습니다. 제로보드가 업그레이드되어 정상적인 작동을 하지 않을 수 있음에 유의해주십시오. 만일 이 애드온 때문에 사이트의 작동이 불안하다면 제로보드 XE 설치 디렉토리 아래의 /files/cache/activated_addons.cache.php 파일을 FTP로 삭제후 다시 웹사이트를 로딩하시면 됩니다.
3) 이 애드온의 라이센스는 GPL입니다. 참고로 Lytebox 3.2의 라이센스는 Creative Commons License 3.0입니다.
4) 문의나 건의가 있으시면 답글 달아주십시오. 메일이나 쪽지는 잘 보지 못합니다.
5) /lytebox/lytebos.js 파일의 상단부 몇가지 변수를 고치면 그림이 펼쳐지는 속도를 빠르게 하거나 애니메이션을 꺼버릴 수 있습니다.
31번째 라인: var resizeSpeed = 10;         // 이것을 1~10사이의 값으로 셋팅합니다. 10이 가장 빠릅니다.(라이트박스는 7)
34번째 라인: this.autoResize = false;          // 이것을 true로 하면 창에 비해 너무 거대한 그림을 자동으로 축소합니다. 이 애드온은 오리지널 Lightbox와 동일한 효과를 가지기 위해 기본값이 false로 변경되어 있습니다.
35번째 라인: this.doAnimations = true;   // 이것을 false로 하면 그림이 커지는 효과가 사라집니다.
이 버전은 오페라, 파이어폭스, IE 6 및 IE 7에서 정상 작동됩니다.



적용예 (테스트 사이트가 아니니 부디 테스트글을 올리진 마시기 바랍니다. -_-)
버그리포트나 문의사항은 이쪽으로


몇가지 단점 및 문제점

1) 블로그 같은 경우에 적용시키면 프로필 사진 같은것에 함께 적용되는 아쉬움이 있습니다. 아직 거기까진 어떻게 처리를 못했습니다. (그냥 지금 정도로도 괜찮다고 생각합니다. 갠적으로 블로그는 이 애드온의 타겟 모듈에서 제외시켜 버렸습니다.) 사진을 블로그 자체에 올리시는 분들이라면 프로필 사진을 사용하지 마시거나 스킨에서 <IMG>태그가 아닌 CSS background로 처리해주시면 이런 문제가 생기지 않게 됩니다.

2) 현재로선 정해진 모듈 이외에 제로보드 XE원래의 처리 방법으로 구동하게 만드는 출력방식은 지원하지 않고 있습니다. (귀찮기도 하고 괜히 옵션만 마구잡이로 늘것 같아서...)

3) 이건 이 애드온의 문제가 아니라 제로보드 XE 에디터의 문제입니다만...

현재로선 사진을 삽입한 다음에 그림만 선택하고 문단에 대한 좌측/우측/가운데 정렬을 하게 되면 <IMG>태그 양쪽에 <DIV>가 생기면서 출력시 그림이 리사이즈 되지 못합니다. 큰 그림을 삽입하실때엔 문단 정렬을 따로 누르지 않으시는게 좋습니다.

※ 참고로 문단정렬을 하지 않고 그림 자체의 정렬 방법만 대입하면 오페라에선 정렬된 내용이 보이지 않더군요. :(


사용에 대한 어떤 예기치 않은 '위험'에 대해서도 책임지지 않습니다. (별일 있겠습니까만은.... ^^;;)





부디 도움이 되시기를 바랍니다. =)