이 글은  whitecatz 님의 개발 플러그인입니다.
출처 https://sir.kr/g5_plugin/3724?page=3 by_banner 배너 관리 플러그인


---

그누보드 5.3에 대응합니다. 하위호환은 고려 하지 않았습니다.

개발 및 테스트 환경은 /plugin/by_banner/readme.txt에 기록되어 있습니다.

= 주요 기능

1. 다중 이미지 업로드(jp(e)g,png,gif,webp 만 지원)
2. 각 배너당 이미지 랜덤 표시 (노출 여부 선택 가능)
3. 고정 및 슬라이드로 이미지 선택 표시 (bxslider사용)
4. Hit Count 확인 (ajax)
5. 노출 Count 확인 (ajax)

설치 및 사용전 /plugin/by_banner/readme.txt를 꼭 확인해 주십시오

bxslider의 설정은 관리자에서 가능하며 해당 기능에 해당 config option은 https://bxslider.com/options/ 에서 확인 바랍니다.

=설치 방법

설치 방법은 압축을 해제한 파일을 그누보드 폴더에 맞게 덮어 씌우기 하시면 됩니다.

extend폴더엔 extend에 plugin은 plugin에 각각 맞게 넣어 주시면 됩니다.

= 발견된 버그 내용

1. 배너 수정 후 노출을 두번째 부터 클릭할 경우 두번쨰 것이 아닌 첫번째 것이 빠짐.

= history

2018-02-12 첫 게시글 VERSION 1.0.0.0

2018-02-14 설치글 작성 및 1번 버그 알림

2018-03-02 ver 1.0.0.1 
    * 이미 등록된 배너 수정시 순서가 밀려서 처리되는 현상 수정
    * load.php파일에서 jquery.bsxslider플러그인 로드 코드 제거
        - 그누보드 5.3에서는 미리 bxslider가 로드 되므로 제거 합니다.

----------------

현재 폴더에 있는 classes.php의 상단에 있는 저작자 정보 그리고 load.php에 있는 버젼 정보만 유지 해주시면  자유롭게 수정 배포하셔도 됩니다.

테스트 및 개발 환경은 아래와 같습니다. 하위 호환은 고려하지 않았습니다.

Linux 4.13.0-32-generic #35~16.04.1-Ubuntu 

PHP 7.0.22

현재 베타버젼인 그누보드 5.3

mysql  Ver 14.14 Distrib 5.7.21

=사용전 주의 사항 및 알림

테이블은 

관리자의 by 배너 관련 메뉴에 들어갈 시 자동으로 생성 됩니다.

데이블에 관한 명세는 /plugin/by_banner/classes.php에서 확인해 주십시오.

data 디렉토리의 by_banner의 디렉토리 생성은 파일 업로드시 자동 생성 됩니다.

BY라는 이름의 namespace를 사용합니다.

관련 함수는 plugin/by_banner 에 있는 lib.php와 load.php 그리고 classes.php를 확인하시기 바랍니다.

jquery를 필수 입니다.

슬라이더는 bxslider를 사용합니다.

bower를 통해 다운하였고 대상 디랙토리는 plugin/by_banner/bower_components/bxslider입니다.

admin.menu100.php의 메뉴 인덱스 값을 100600 대역을 사용하고 있습니다.

이미 사용중이라면 업데이트 전에 각 파일에 대한 변경이 필요합니다.

이미지 저장은 data/by_banner에  들어 갑니다.

지원 이미지 포멧은 jp(e)g,png,gif,webp 입니다.

현재 배포는 초기 버전이므로 1.0.0.0 버젼입니다.

extend디렉토리 안의 by_banner.extend.php에서 버전을 확인합니다.

버그 및 기타 문의는 https://sir.kr이나 https://blog.naver.com/blueyoxi, 혹은 이메일 agcraft@gmail.com로 연락 주시기 바랍니다.

* 이미지 용량제한,서버설정,권한 문제등으로 이미지가 안 올라가는 경우 php나 apache설정을 확인해 보시기 바랍니다.

=사용법

우선 배너를 생성하고 이미지를 등록합니다.

bxslider의 설정의 경우 https://bxslider.com/options/ 를 참고해 주십시오.

설정은 관리자에서 bxSlider설정의 텍스트 란에 아래의 JSON 형식의 코드를 넣어 주시면 됩니다.

{

  auto: true,

  controls:false,

  pager: false,

  slideWidth: 200

}

사용하실 페이지 적당한 곳에 아래의 PHP 코드를 넣습니다.

include_once(BY_BANNER_PATH.'/lib.php');

표시할 위치에 관리자 'by 배너'메뉴에서 생성한 아이디만 바꾼 후 넣으시면 됩니다.

생성시 test로 아이디를 만들었다면 아래와 같습니다.

<?php echo by_banner('test')?>

개별적으로 디자인에 대한 커스터 마이징이 필요할 경우 아래의 selector로 설정 하시면 됩니다.

.by_banner

.by_banner_*

.by_banner_image

.by_banner_image_*

슬라이더의 경우에도 container에 .by_banner_*가 들어가니 아래와 같이 selector를 설정하시면 됩니다.

#by_banner_1{

..

}

각 배너에 대한 접근으로 코딩이 필요할 경우 아래의 함수를 이용합니다.

$obj = by_banner_object('id');

각 property는 데이타 베이스의 필드와 대응합니다.

width를 얻고자 한다면 다음과 같이 사용합니다.

$obj->width;

배너에 연결된 이미지에 대한 width를 얻고자 한다면 아래와 같이 접근 합니다.

$obj->images[0]->width;

.

.

.

$obj->images[4]->width;

=history 

== 1.0.0.1 

* 이미 등록된 배너 수정시 순서가 밀려서 처리되는 현상 수정

* load.php파일에서 jquery.bsxslider플러그인 로드 코드 제거

- 그누보드 5.3에서는 미리 bxslider가 로드 되므로 제거 합니다.