테크노트 사용자 매뉴얼

외부모듈 연동
테크노트/PHP 자체만으로 처리할 수 없는 몇가지 기능은 외부 서비스업체와 연동되도록 소스수정 작업을 해 주어야 한다.
이것은 옵션 형태로 들어 있는 기능이므로 반드시 사용해야 하는 것은 아니니 필요한 경우에만 연동작업 하도록 한다.
외부 모듈 연동이 필요한 기능은 다음과 같다.

SMS(휴대폰 문자메시지) 전송

실명인증

신용카드 결제, 휴대폰 결제등 유료 결제

 SMS(휴대폰 문자메시지) 서비스 연동하기

    문자메시지 발송 페이지 확인

         관리자 전용
          ㆍ회원전체 대상 SMS:   회원관리 페이지에서 좌측메뉴에 있는 '전체 SMS전송' 를 클릭하면 된다.
          ㆍ특정회원 대상 SMS:   회원관리의 회원목록에서 발송대상 회원들을 체크하고 'SMS 문자메시지 전송'  을 실행시키면 된다.
          ㆍ회원개인 대상 SMS:   회원관리에서 회원 개인의 등록정보창을 열고 등록된 휴대전화 번호를 클릭하면 된다.
          ㆍ보드설정 -[7-40] 새 글 등록시 SMS 문자메시지로 통보받기
          ㆍ회원관리 설정 -[6-40] 회원등록을 SMS 문자메시지로 통보 받기

        회원 전용(회원 상호간 문자전송)
               (ROOT 설정→3. 전체 보드에 대해 제한 적용→회원간 SMS(문자) 기능 사용→[허용] 설정일때만 실행됨)
          ㆍ보드(게시판):  회원로그인한 상태에서 보드의 글등록자 정보를 열고 문자전송 아이콘을 클릭하면 된다.
          ㆍ쪽지            :  받은 쪽지함에서 본문내용 하단부의 문자전송 아이콘을 클릭하면 된다.
          ㆍ친구등록      :  친구등록 목록에서 문자전송 아이콘을 클릭하면 된다.
              회원 자신의 문자전송 내역은 [MY 페이지]→[SMS 내역] 에서 확인할 수 있다.
          ㆍ보드설정-[6-15] 글쓰기 입력양식 구성 - SMS로 답변 통보받기

    수정대상 소스
       technote/include/public_inc/send_sms.php

    소스 기본상태
        KIDC-파워SMS(http://biz.powersms.co.kr) 의 『파워SMS』→ 'SMS-ASP' 서비스와  연동가능한 소스가 들어 있다.

    『파워SMS』연동작업 순서
        1, http://biz.powersms.co.kr 에서 『파워SMS』→ 'SMS-ASP' 서비스를 신청-등록한다.
        2, technote/include/public_inc/send_sms.php 소스에서 별표(★) 표시되어 있는 부분의 코드(아래)를 수정한다.
             $GLOBALS[smsid] =  "smsID";        //  ★ 『파워SMS』 에서 발급받은 아이디를 대입한다.
             $GLOBALS[smspw] = "smsPASS";   // ★『파워SMS』 에서 발급받은 비밀번호를 대입한다.
        3, 문자발송 페이지를 열고 문자메시지가 정상적으로 전송되는지 확인한다.
        4, 작업완료.


    『후이즈SMS』연동작업 순서
        1, http://www.whoisweb.net 에서 SMS 서비스를 신청-등록한다.
        2, technote/include/public_inc/send_sms_whois.php 파일을
           technote/include/public_inc/send_sms.php 로 파일명을 변경한다.
        3, technote/include/public_inc/send_sms.php 소스에서 별표(★) 표시되어 있는 부분의 코드(아래)를 수정한다.
             $GLOBALS[smsid] =  "smsID";        //  ★ 『후이즈』 에서 발급받은 아이디를 대입한다.
             $GLOBALS[smspw] = "smsPASS";   // ★『후이즈』 에서 발급받은 비밀번호를 대입한다.
        4, 문자발송 페이지를 열고 문자메시지가 정상적으로 전송되는지 확인한다.
        5, 작업완료.


    『파워SMS』나 『후이즈SMS』  외의 다른 SMS 서비스업체에 연동하려면
         technote/include/public_inc/send_sms.php 소스의 내용을 전체 삭제하고 아래 4줄의 코드만 남긴다.
           function send_sms_action($dest,$callback,$smsbody,$title,$senddate,$sendtime){
              // 연동 코드 삽입
              return array(1,0);     // (전송성공개수,전송실패개수)
           }
          위 코드를 베이스로 하여 연동코드를 작성하면 된다.
          인수,변수 속성은 소스내의 설명 참조할것.




 실명인증 서비스 연동하기 

    실명인증 페이지 확인
         [회원관리]→[설정]→[2-4: 회원등록폼 출력전 확인단계 설정]→[실명인증] 을 체크 설정한 후
         회원등록폼을 열면 회원등록 과정에서 실명인증 절차가 추가된 것을 확인할 수 있다.

    수정대상 소스
           technote/skin_member/스킨명/realname_form.php

    소스 기본상태
          한국신용평가 정보(http://www.namecheck.co.kr)의 실명인증 서비스에 연동가능한  코드가 들어 있다.

    연동작업 순서
        1. "한국신용평가 정보(http://www.namecheck.co.kr)"에 서비스 신청-등록한다.
        2,  해당 업체에서 제공하는 실명인증 모듈 파일을 받아서 홈페이지내의 임의의 경로에 올린다.(binary 모드로 올릴것)
        3,  technote/skin_member/스킨명/realname_form.php 소스에서 별표(★) 표시되어 있는 부분의 코드(아래)를 수정한다.
             $sSiteID = "namecheck_ID";                   // '한국신용평가정보'에서 발급한 id 를 대입한다.
             $sSitePW = "namecheck_PASS";             // '한국신용평가정보'에서 발급한 비밀번호를 대입한다.
             $cb_encode_path = "./cb_namecheck";  // '한국신용평가정보'에서 받은 모듈 파일의 경로를 대입한다.(Binary 모드로 업로드할것)
        4,  회원등록폼을 열고 실명인증 입력란을 통해 정상동작 여부를 확인한다.

    '한국신용평가 정보'  아닌 다른 실명인증 서비스업체에 연동하려면
            technote/skin_member/스킨명/realname_form.php 소스에서 별표(★) 표시되어 있는 부분의 코드를 지우고
           해당 업체의 서비스방식에 맞는 실명인증 코드를 작성해 넣는다. (소스내에 설명있음)



 신용카드결제,휴대폰결제 ,계좌이체 서비스 연동하기

    포인트 유료충전

        유료충전 페이지 확인
            * 관리자: [회원관리]→[포인트 설정]→[설정1, 포인트 기능 사용여부] 를 "사용함" 으로 지정한다.
            * 회 원 : [회원로그인]→[MY 페이지]→[포인트]→[포인트 충전]→[카드결제충전,휴대폰결제충전]에 접속한다.

        수정 대상 소스
             신용카드 결제: technote/skin_member/스킨명/point_up_card.php
             휴 대 폰 결제: technote/skin_member/스킨명/point_up_phone.php

        소스 기본상태
            포인트 충전을 목적으로 한 유료 결제에 필요한 기초적인 코드가 들어 있다.
            특정 결제 서비스 업체의  완성된 소스가 들어 있는 것이 아니므로 원본 상태에선 결제 역할을 수행하지 않는다.

소스 구성 이해하기
소스를 열어 보면 다음과 같이 여러 5개의 블록으로 구분되어 있는 것을 볼 수 있다.
이 구조를 이해하고 나면 어떤 결제 기능도 쉽게 연결할수 있을 것이다. 신용카드,휴대폰 모두 동일한 구조이다.

소스코드 - 블록	설 명
<? ...... // ... 기본안내 문구 ... $CONFIG['pointcell_num']=32;	php 시작부분이다. $CONFIG['pointcell_num']=32; 는 설정 컬럼을 구분하는 고유번호이다. 수정해야 할 부분은 없다.
// ■ 1, 설정옵션 //$CONFIG['cnf_set_ratio'] = 100; //$CONFIG['cnf_save_now'] = 1; //$CONFIG['cnf_limit_1day'] = 0;	[블록1] "유료 결제 충전" 관련 설정은 기본적으로 [회원관리]→[포인트 설정]→[설정3, 포인트 생성 Value]→[직접충전] 의 설정값이 적용되는데, 만약, 상기 설정항목을 무시하고 소스 내에서 직접 지정코자 한다면 이 변수설정을 사용하면 된다. 주석 처리되어 상태에서는 상기 설정항목의 값이 적용된다. 수정해야 할 부분은 없다.
// ■ 2, 접속자 정보 확인 # 접속정보 확인 코드	[블록2] 페이지 접속 때마다 접속자(회원) 정보를 확인하고, 잘못된 접속인 경우 안내(경고) 메시지를 출력한다. 수정해야 할 부분은 없다.
// ■ 3, 입력폼으로 부터 입력값을 전달 받았을때 if($_POST['is_payform_data']) { # 입력값 검사 # 입력값이 정상이면 다음 동작을 #여기에 작성 }	[블록3] 결제 입력폼(블록5)을 통해 입력된 정보가 들어 왔을때 입력값 유효성 검사후 이상이 없으면 결제서비스 업체의 모듈로 연결한다. 모듈연결 방법은 결제서비스 업체에서 제공하는 매뉴얼을 참조할것. 결제 완료후 [블록4] 로 연결 되도록 리턴 url을 지정한다. 해당 결제 페이지에 대한 전체 URL(http://로 시작되는) 은 직접 작성하거나 $this_page_full_url 변수를 사용하면 된다.
// ■ 4, 신용카드 결제 성공하면 포인트를 DB에 저장 if($pay_success) { $result=point_up_Action("",$pay_price); # 결제DB 저장 결과 메시지 출력 }	[블록4] 결제과정을 총 완료후 외부 연동 모듈로부터 리턴된 값을 받아서 결제 성공여부에 따라 point_up_Action() 함수를 실행시켜 포인트를 증가 시킨다. 결제된 금액이 포인트로 자동 환산되게 하려면 $result=point_up_Action("","$결제된금액"); 형식으로 지정하면 되고 증가될 포인트를 직접 지정하고자 할 때는 $result=point_up_Action("$증가될포인트",""); 형식으로 지정하면 된다. $result 변수에는 포인트 저장결과를 구분하는 번호가 들어 있는데 이를 근거로 포인트 충전 성공여부 메시지를 출력한다.(소스 직접참조)
// ■ 5, 결제 입력폼 HTML <div align=center> # 입력폼 태그 </div>	[블록5] 처음 접속시 출력되는 결제 입력폼 html 태그이다. 결제서비스 업체에 따라 결제입력폼 양식은 다를 것인데 해당 업체에서 제공하는 결제입력폼으로 아예 바꿔 넣거나 또는 원래 있는 것을 그대로 사용하면서 [블록3] 의 코드에서만 변수명을 호환 시켜 주거나 하면 된다. 후자쪽이 편하다.

        결제 진행 과정(단계) 이해
           첫번째, [회원로그인]→[MY 페이지]→[포인트]→[포인트 충전]→[카드,휴대폰 충전] 페이지를 연다.
           두번째, [블록5] 에 해당되는 결제 입력폼이 출력된다.
           세번째, 결제 입력 양식을 채우고 전송한다.
           네번째, [블록3] 의 코드가 실행되고, 외부 모듈로 연결 된다.
           다섯번째, 외부 모듈에 의한 결제 과정(ISP 인증등..)이 진행된다.
           여섯번째, 결제가 완료되면 다시 위 1번에 해당되는 페이지로 연결되고 [블록4] 의 코드가 실행된다.


   쇼핑몰결제 연동
        본 버전에서는 지원되지 않음

기타 의문 사항은 제작사의 Q&A 를 활용하십시오.