================[킴스보드 5.1.0 PERL 정식버젼 - 라이센스 및 사용설명서]=============
kimsboard 의 저작권은 제작자인 김성호에게 있습니다.
kimsboard 를 제작자의 동의없이 상업적인 목적으로 이용할 수 없습니다.
kimsboard 는 배포된 원래 상태로만 재배포 할 수 있습니다.
kimsboard 를 수정, 변경 후 재배포 할 수 없습니다.
kimsboard 사용으로 인해 발생하는 문제에 대해서는 책임을 지지 않습니다.
kimsboard 사용중 건의사항이나 궁금한점은 홈페이지 게시판을 이용해 주시기바랍니다.
kimsboard 는 개인사용자(1~2차도메인 사용자포함)/무료계정사용자에게는 프리웨어입니다.
개인이 아닌 com/net/co.kr 등등을 사용하는 단체나 회사 (학교/공공기관은
제외) 에서 사용하실 경우 마음에 드셔서 주체할 수 없다면? 사용자님께서
생각하시는 소정의 금액을 입급해 주시면 고맙겠습니다. 물론 입금에 대한
문제는 자유인 만큼, 생각이 있으신 분만 입금해 주시면 됩니다..
입급된 소정의 사용료는 야간작업시 자판기 커피값과 애기분유값에 사용하겠습니다.
--------------------------------------------------------------------------------
입금은행 : 농협중앙회
계좌번호 : 304-12-038150
예금주 : 김성호
================================================================================
Copyright (C) 2000 Kim Seogn-ho All rights reserved.
================================================================================
|| 만든사람 : 김성호
|| 홈페이지 : http://www.kimsboard.com
|| 전자우편 : webmaster@kimsboard.com
|| 배포날짜 : v2.0.0 => 2000. 03. 05.
v2.1.8 => 2000. 04. 11.
v2.2.5 => 2000. 05. 02.
v2.4.0 => 2000. 05. 14.
v2.5.5 => 2000. 05. 27.
v2.7.0 => 2000. 06. 10.
v2000 PRO BETA final => 2000. 07. 03.
v2000 PRO 정식 => 2000. 08. 18
v2000 PRO 정식 1차패치 => 08. 24
v2000 PRO 정식 2차패치 => 09. 08
v3.0.0 => 2000. 10. 17.
v4.0.0 => 2000. 11. 20.
v4.5.0 => 2000. 12. 05.
----------------------
v5.0.0 => 2000. 12. 16 ( 이전버젼과 완전히 다름 )
----------------------
|| 킴스보드에 관한 것은 홈페이지 게시판을 이용해 주시기 바랍니다.
Copyright (C) 2000 Kim Seong-ho All rights reserved.
-------------------------------------------------------------------------------
==================[ 목 차 ]================================
[1] kimsboard 5.1.0 정식판 소개
[2] 설치 방법
[3] 설치후 게시판 호출방법
[4] kimsboard 이전버젼 사용자의 패치방법
[5] 공지사항 및 회원가입폼 사용법
[6] 로그인, 로그아웃, 회원정보변경 ,회원탈퇴 , 아이디 및 패스워드검색 폼 삽입
[7] 옵션팩설치 및 활용
================================================================================
[1] kimsboard v 5.1.0 소개
안녕하세요.. 킴스CGI 시리즈를 만들어 가고 있는 김성호입니다.
1999년 처음으로 미약한 코딩실력으로 우수운? 게시판(kimsboard 1.0 beta)를 만
들어 보면서 펄이란 참 재밌는 언어다라는 생각이 들었습니다. C나 JAVA와 같이
변수선언이 까다롭지도 않고 컴파일을 할 필요도 없고.. 역시 웹프로그램을 위해
만들어진 언어라는 생각이 들더군요.. 요즘은 PHP에 눈을 돌리고 있지만 그래도
아직은 PERL은 살아있습니다.
[KIMSBOARD v4.5.0 -> v5.1.0의 보완내용]
=> 기존 판때기에서 치명적인 문제였던 데이터손상에 대한 문제를 근본적으로 뿌리뽑기 위해
처음부터 새로 코딩하였으며 그러한 관계로 상당히 안정성 있는 보드가 되었습니다..
PERL + TEXT FILE 게시판으로서 10만개의 데이터에서 0.5초대의 처리속도를 내며 어떠한
상용 보드프로그램에도 뒤지지 않는 관리자모드,회원관리가 돋보입니다...
기존 버젼의 경우 알고리즘상 최대 회원가입자수를 5000명 이상 넘기기 어려웠으나, 본
버젼에서는 최대 10만명까지 회원가입을 무리없이 받을 수 있습니다.
=> 본 버젼의 목표는 1초를 넘기지 않는 상태에서 10만개까지 사용자의 데이터를 지켜주는
것입니다.
=> kimsboard 5.1.0은 UNIX 계열 perl 5 이상에서 제대로 작동합니다.
=> 유닉스(리눅스)/아파치 에서 가장 안정적으로 작동합니다.
=> NT 계열의 서버에서도 작동하나 다소 불안정하며 에러가 발생할 확률이 큽니다.
-------------------------------------------------------------------------------
[2] 설치 방법
[주의] 본 소스는 초기 패스워드가 있습니다.. path.cgi 에서 $ROOT_PASS 에 지정된
패스워드가 초기 패스워드이며 업로드 이전에 수정하여 올리시면 됩니다.
kimsboard_perl5.zip 파일을 다운 받으셔서 압축을 풀면 아래와 같은
디렉토리 구조를 가집니다.
------------------------[kimsboard 5.1.0 디렉토리구조]-------------------------
* 5.1.0은 디렉토리 구조가 기존버젼과 다릅니다.
kimsboard --------------------------게시판의 최상위디렉토리[777]
|
+- image -- 이미지파일들
+- config -+- path.cgi
| +- badword.txt[자동생성]
|
+- skin -+- 스킨파일들(.pl확장자)
+- members -+- memberfile -+- 회원로그인파일들[자동생성 및 소멸]
| +- regis_members -+- 회원승인자 정보파일들[자동생성]
| +- wait_members -+- 회원보류자 정보파일들[자동생성]
| +- members.cgi[자동생성]
| +- wait_members.cgi[자동생성]
+- zipcode-+- zipcode.cgi
| +- zipcode.db
|
+- db -+- 게시판db -+- data -+- 데이터파일들
| +- list.cgi
| +- layout.cgi
| +- category.cgi
| +- date.cgi
| +- header.cgi
| +- footer.cgi
| +- board_header.cgi
| +- pass.cgi
| +- title.cgi
+- kimsboard.cgi
+- kimsadmin.cgi
+- kimsmember.cgi
+- kimsmail.cgi
+- login.cgi
+- 설명서.TXT
|
+- uload [업로드 가상디렉토리]
|
+- kims_lib 킴스보드 옵션팩 디렉토리[777]
* 퍼미션을 777로 주어야하는 디렉토리 : kimsboard / config / members / memberfile / db / upload(가상디렉토리) / kims_lib
* 퍼미션을 755로 주어야하는 파일 :
kimsboard.cgi / kimsadmin.cgi / kimsmember.cgi / kimsnotice.cgi / zipcode.cgi /login.cgi / kimsmail.cgi
--------------------------------------------------------------------------------
1) 모든디렉토리에서, cgi실행이 가능한 계정일경우의 설치방법
--------------------------------------------------------------------------------
위의 디렉토리와 파일들중 [자동생성]이라고 되어있는 것들은 최초 압축을 해제시에
들어있지 않은 디렉토리와 파일들입니다.
즉.. 올바르게 설치를 하면 자동으로 만들어지는 디렉토리와 파일들입니다.
[중요]위의 파일중 path.pl을 텍스트 편집기(메모장이나 기타 텍스트에디터)로 열
어서 설정을 변경해야 할 부분이 있습니다. path.pl파일은 경로설정파일 이
므로 정확하게 수정해 주셔야 합니다.
path.pl을 열면 아래와 같은 코드가 있습니다.
---------------------------[path.cgi에서 수정해야할 코드]------------------------
## 설명에 따라 알맞게 수정하기 바랍니다.
$SYSTEM = 1; ##윈도우서버는 0 유닉스서버는 1
$ROOT_PASS = "kims"; ## 종합관리자 패스워드
$IMG_URL = "http://홈페이지/kimsboard/image"; ## 이미지디렉토리 URL
$CGI_SELF = "http://홈페이지/kimsboard/kimsboard.cgi"; ## kimsboard.cgi의 웹주소
$ADMIN_HOME = "http://홈페이지"; ## 홈페이지
$ADMIN_EMAIL = 'abc@abc.com'; ## 이메일
$SENDMAIL = '/usr/sbin/sendmail'; ##샌드메일경로
$ADMIN_NAME = "아무개"; ## 관리자 이름
$UPLOAD_DIR = "upload"; ## 업로드할 디렉토리경로(지정한 디렉토리를 만드신후 777 퍼미션을 주세요)
$UPLOAD_URL = "http://홈페이지/kimsboard/upload"; ##( $UPLOAD_DIR 의 URL)
$how_regis = "NO"; ##회원가입옵션 NO면 바로승인 # YES 면 보류후 승인
$regis_page = "http://홈페이지/회원가입후.html"; ## 회원가입후 보여줄 페이지의 URL
$VER = "5.1.0"; ## 버젼(지우지 마세요)
위에서 중요한 것은 $ROOT_PASS를 사용하실 패스워드로 변경한 후 올려 주시고요..
$UPLOAD_DIR 은 업로드 디렉토리이름을 관리자님께서 임의로 정해주신후 그 이름으로 디렉토리를
kimsboard 디렉토리 밑에 만들어 주시고 퍼미션을 반드시 777로 주세요..
--- 일반계정에서의 설치 ---------
$UPLOAD_DIR 을 만약 download 라는 이름으로 지정해 주셨다면 kimsboard디렉토리 밑에 download디렉토
리를 만드시고 퍼미션을 777로 주세요...
만약 $UPLOAD_DIR 을 만약 upfile/cgi 라고 지정해 주셨다면 kimsboard디렉토리 밑에 upfile디렉토리를
만드시고 퍼미션을 777로 주신다음 그 안에 또 upfile이라는 디렉토리를 만들어 주시고 그 디렉토리도
777로 퍼미션을 주면 됩니다..
위와 같은 방법으로 업로드 디렉토리를 임의로 만들어 주시면 됩니다..
--- CGIWRAP 에서의 설치 ---------
CGI-BIN에서만 CGI가 돌아가는 계정(cgiwrap)에서는 반드시 $UPLOAD_DIR 디렉토리
를 cgi-bin밖으로 빼주고 그 절대경로를 지정해 주셔야 업로드,다운로드가 가능합니다.
아울러 cgi-bin설치시에는 $IMG_URL도 cgi-bin밖으로 빼내주신다음 그 웹상의 경로를 지정해 주시기
바랍니다.
$regis_page는 회원가입후 회원에게 보여줄 페이지의 주소를 적어주시면 됩니다..
관리자님께서 임의로 파일을 만든다음 그 파일의 주소를 지정해 주세요..
* cgi-bin 디렉토리에 이미지파일을 올리고 그 그림파일이 웹상에서 뜨면 cgiwrap에 상관없이
그냥 일반계정과 같게 설치하시면 됩니다...
* cgiwrap 인 계정에서만 $IMG_URL 과 $UPLOAD_DIR 을 cgi-bin 밖으로 빼내준 다음
$IMG_URL의 경우 웹상의 주소를 $UPLOAD_DIR 의 경우 계정상의 절대경로,혹은 상대경로
로 지정해 주셔야 자료실로의 사용이 가능합니다.
* cgiwrap인지라 $UPLOAD_DIR을 cgi-bin밖으로 빼냈다면 $UPLOAD_URL에 빼낸 웹상의 URL을
정확히 적어주셔야 다운로드가 가능합니다.
[가정]
CGIWRAP 인 계정에서
kimsboard를 아래와 같이 설치하였으며 kimsboard.cgi의 주소가 아래와 같다고 해 봅니다.
http://홈페이지/cgi-bin/kimsboard/kimsboard.cgi
위와 같다고 할때,
$IMG_URL은
http://홈페이지/임의로 만들어준 이미지디렉토리/image
$UPLOAD_DIR 은
/home/kims/public_html/임의로만들어준 업로드디렉토리[반드시 퍼미션777로 줌]
$UPLOAD_URL 은
http://홈페이지/임의로 만들어준 업로드디렉토리
와 같은 형식이 되어야 합니다...
다시 말씀드리지만 이미지파일이 cgi-bin디렉토리에서 뜨면 cgiwrap 이 아니므로 그냥 일반계정
설치와 같게 설치하시고 이미지파일이 안뜬경우 cgiwrap 설치법에 따라 설치하시기 바랍니다.
-------------------------------------------------------------------------------
[3] 설치후 게시판 호출방법
http://홈페이지/kimsboard/kimsadmin.cgi
위의 주소를 호출하세요.. 로그인 폼이 뜨는데, path.cgi에서 지정해준 $ROOT_PASS 를 입력
하시면 로그인 됩니다... 로그인 후 새 게시판을 만들어 주시면 되며 로그아웃은 브라우져를
닫으면 자동으로 로그아웃 됩니다...
--------------------------------------------------------------------------------
[4] kimsboard 이전버젼 사용자의 패치방법
1) 모든버젼의 업그래이드가 가능하리라 봅니다..
그러나, 테스트는 2000 PRO 이상에서 해 보았으므로 그 이상 버젼에서는 무리없이 업그래이드 될 것입니다.
다음과 같은 과정을 똑같이 따라하세요...
우선.. 기존에 설치된 kimsboard의 게시판db디렉토리들을 모두 백업을 해 놓구요..
다음으로 kimsboard 5.0 버젼을 설치법에 따라 일단은 설치를 합니다..
설치한 5.0 버젼의 kimsboard에서 테스트게시판등을 만들어본후 잘 돌아가면, 그
kimsboard디렉토리 밑에 db라는 디렉토리가 있는데, 그 안으로 백업받아놓았던
기존의 게시판db디렉토리들을 모두 업로드해 준다음 업로드해준 디렉토리 및 파일들의 퍼미션션을
모두 777로 줍니다...
다음으로 회원정보파일인 기존의 members.cgi 파일을 새로설치한 kimsboard/members/디렉토리 밑에
업로드해준후 퍼미션을 777로 줍니다.
이때, kimsboard/members/디렉토리 이하에 memberfile , regis_members , wait_members 디렉토리가
있고 퍼미션이 모두 777로 잡혀있는지 반드시 확인해 주십시오, 만약 앞서의 디렉토리가 없거나, 퍼미션
이 맞지 않으면 회원정보 변환에 에러가 나게 되므로 반드시 확인해 주시기 바랍니다.
이제 모든 변환준비가 끝났습니다..
이제 킴스월드 자료실에서 [킴스보드 4.5 이하 -> 5.0 업그래이드 변환기]를 받으신 후 압축을 풀어서
convert.cgi를 메모장에서 열어보시면 패스워드를 적는 변수가 있습니다...
변환시에 각각의 게시판에 패스워드가 등록되어질때 필요하므로 반드시 패스워드를 지정해 주셔야
에러가 나지 않습니다... 만약 변경없이 사용하실 경우 패스워드는 kims로 설정되니, 변환후
패스워드를 변경해 주셔도 상관이 없습니다...
웹상에서 convert.cgi를 호출하신 다음 구경만 하세요...
http://홈페이지/kimsboard/convert.cgi
변환이 완료되었다는 메세지가 뜨면 convert.cgi는 삭제해 주시기 바랍니다..
이제 관리자 페이지로 들어가 보세요...
--------------------------------------------------------------------------------
[5] 공지사항/회원가입폼 사용법
회원가입폼은 본 버젼부터
http://홈페이지/kimsboard/kimsmember.cgi 를 호출하시면 열리게 됩니다...
----- 아 래 -----------------------------------
1, 같은페이지에 가입폼 열기
<a href="http://홈주소/kimsboard/kimsmember.cgi">
2, 새창을 띠워서 가입폼 열기
해드테그안에(body태그안에 넣어도 상관없음)=>
<script>
<!--
function memberWin(URL) {
window.open(URL,'memberWin','resizable=no,scrollbars=no,status=0,width=650,height=600');
}
-->
</script>
바디태그안에 =>
<a href="javascript:memberWin('http://홈주소/kimsboard/kimsmember.cgi')">회원가입하기</a>
[새창으로 띄우시길 권장합니다.]
---------------------------------------------------------------------------
3) 공지사항 모드 사용법
kimsnotice.cgi파일을 열면 사용자께서 수정을 해야할 부분이 있습니다..
파일을 열어보시면 설명이 있으며 그 설명에 따라 원하시는 옵션으로 수정하여 사용하시면 됩니다.
[iframe사용자]
http://홈페이지/kimsnotice.cgi?db=불러올db
로 호출하면 불러지며 아이프래임을 사용하여 삽입하시면 됩니다..
[SSI 계정사용자]
만약 계정에서 SSI가 지원되면 SSI를 통해 원하시는 위치에 깔끔하게 삽입하여 사용하실 수
있습니다...
메인화면에 공지사항을 넣고 싶을경우 메인화면이 main.html이라면 main.html 안에 공지사
항을 삽입하고 싶은 위치에 다음과 같은 코드를 주석처럼 첨가해 주시면 곧바로 삽입됩니다.
단, 이때 main.html 파일의 확장자를 main.shtml 로 바꿔주셔야 합니다.
<!--#include virtual="kimsnotice.cgi?db=DB이름" -->
물론 위의 코드는 DB이름 만 바꾸어 원하시는 만큼.. 원하시는 위치에 불러올 수 있습니다..
SSI로 불러서 사용하실 경우 kimsnotice.cgi에서 $SSI = "YES"; 로 지정해 주셔야 합니다.
###############################################################################
[6] 로그인, 로그아웃, 회원정보변경 ,회원탈퇴 폼 삽입
로그인 , 로그아웃 폼을 임의의 페이지에 삽입하시고 싶으시다면
http://홈페이지/kimsboard/login.cgi
를 호출하십시오. 로그인,로그아웃폼이 출력되며 iframe을 이용하여 간단히 삽입할 수 있
습니다.. 로그인폼의 배경색은 디폴트값으로 흰색이며 login.cgi를 열어서 처음에 있는
$BGCOLOR 에서 지정해 주시면 됩니다.
login.cgi를 호출하여 출력된 화면에는 로그인전에는
로그인,회원가입 메뉴가 뜨며
로그인 후에는
로그아웃,회원정보변경 메뉴가 출력됩니다.
회원탈퇴폼을 출력하고자 하시면
다음의 html코드를 이용하여 출력하시면 됩니다...
해드테그안에(body태그안에 넣어도 상관없음)=>
<script>
<!--
function passwin(URL) {
window.open(URL,'passwin','resizable=no,scrollbars=no,status=0,width=350,height=120');
}
-->
</script>
바디태그안에 =>
<a href="javascript:passwin('http://홈주소/kimsboard/login.cgi?action=delete')">회원탈퇴</a>
아이디,패스워드검색 폼은
해드테그안에(body태그안에 넣어도 상관없음)=>
<script>
<!--
function passwin(URL) {
window.open(URL,'passwin','resizable=no,scrollbars=no,status=0,width=350,height=120');
}
-->
</script>
바디태그안에 =>
<a href="javascript:passwin('http://홈주소/kimsboard/login.cgi?action=pwsearch')">아이디,패스워드분실</a>
################################################################################
[7] 옵션팩 설치 및 활용
kimsboard에 기존에 볼 수 없었던 kims_lib 디렉토리가 추가되었습니다. kims_lib 디렉토리
는 앞으로 kimsboard의 기능향상을 위해 추가되는 옵션팩이 위치하게 될 디렉토리입니다..
kims_lib디렉토리는 반드시 777 이나 707 퍼미션이어야 하며 옵션팩을 사용하지 않을 경우
삭제하셔도 무방합니다...
새롭게 도입된 킴스보드 옵션팩은 기존의 보드에서 많이 사용되고 있는 "스킨" 과는
다른 개념으로 겉을 바꾸는 것이 아니라, 보드의 기능추가를 위해 추가 프로그램을 패키지의
형태로 선택하여 설치할 수 있도록 한 개념입니다..
앞으로 지원해드릴 옵션팩은 반드시 kims_lib 디렉토리 밑에 설치되며 옵션팩의
관리는 킴스보드 전체관리자페이지에서 할 수가 있습니다..
아울러, 옵션팩 설치를 위한 설명서는 따로 작성되지 않으므로 옵션팩을 다운로드
받으실때, 설치 설명글을 자세히 읽어보신후 설치하시기 바랍니다...
게시판 설치에 비하여 훨씬 간단합니다..
################################################################################
본 킴스보드 펄(perl) 5.1.0 버젼과 더불어 킴스보드 PHP + MYSQL 5.0.0 버젼도 무료로 배포되고
있습니다.
perl버젼의 데이터를 mysql db로 그대로, 이전이 가능하오니 PHP + MYSQL 버젼도 많이 애용해 주시면 고맙겠습니다...
아울러, 쇼핑카트가 필요하신 분들은 kimsmall도 많이 찾아주세요..
- 김성호 -
################################################################################
