Issue Tracking Fedora7에 Mantis 설치하기

각종설정값 수정.

Mantis 는 두개의 설정파일을 가지고 있는데 config_defaults_inc.php 와 config_inc.php 가 그것이다. 이는 Mantis 가 동작하는데 있어 여러가지 환경변수를 가지고 있다. 기본적으로 설치를 하게 되면 config_inc.php 에는 데이터베이스에 연결하기 위한 기본적인 정보(호스트,유저정보,데이터베이스,서버타입)만 기록이 되어 있다.

기본적으로 config_inc.php 에 설정된 값이 적용이 되며 여기에 없는 변수들은 config_defaults_inc.php 에 있는값들로 사용되어 진다. 따라서 그냥 config_default_inc.php 를 직접 수정해서 사용해도 되고 해당 변수들을 config_inc.php 로 이동시켜서 사용해도 무방하다.

친절하게도 confgi_default_inc.php 에는 주석이 달려있다…단지 영어라서 그렇지만. 하지만 뭐 대충 보면 그 뜻을 짐작하기란 어렵지 않을것이다.

         # $Id: config_defaults_inc.php,v 1.364.2.5 2007/10/24 05:35:39 vboctor Exp $

1.1.0 rc2 에 있는 config_defaults_inc.php 의 문서 번호 이다..대체로 변수는 바뀌지는 않겟지만은 이 파일을 토대로 대충 중요하거나 유용하게 쓰일수 있는 몇가지만 알아보기로 한다. 또한 php 를 다룰수 있는 사람이라면 각종 php 스크립트 파일을 해킹하여 좀더 자유롭게 사용할 수는 있을것이다. 물론 이에 따르는 모든 결과는 각자가 지어야 하겟지만은…

40행부터 데이터베이스 설정에 대한 섹션이 이루어져 있다. 관련변수는 6개 이지만 데이터베이스 서버에 따라 달리 쓰이기도 한다.

$g_hostname                     = 'localhost';

         $g_db_username                 = 'root';

         $g_db_password                 = '';

         $g_database_name              = 'bugtracker';

         $g_db_schema                   = ''; // used in the case of db2

         $g_db_type                      = 'mysql';

이내용은 config_inc.php 에 설치되면서 설정값이 저장되어 있다. 변경하고자 할때는 config_inc.php 의 값을 변경한다.

122행에 선언된 변수의 값은 문서-사용자문서 에 링크된 주소이다. 현재는 공식사이트의 온라인 매뉴얼이 걸려 있는데 필요없거나 다른주소로 바꾸고 싶으면 이 값을 수정하면 된다.

         # Used to link to manual for User Documentation.

         $g_manual_url = ';http://manual.mantisbt.org/';

149행부터는 사용자등록과 비밀번호에 관한내용이 시작되는데, 사용자등록을 웹상에서 받지 않거나 비밀번호 찾기를 로그인 화면에서 제외하고자 할 때 관련값을 OFF 하면 된다.

         $g_allow_signup                 = ON;

         $g_lost_password_feature       = ON;

이 두개의 값은 로그인화면에 신규등록 과 비밀번호찾기 링크를 ON/OFF 한다.

$g_send_reset_password        = OFF;

메일인증이 힘들경우 이 값을 OFF 하면 관리자가 직접 사용자의 비번을 바꿀수 있다.

200행 부터는 이메일에 대한 정보 시작된다. 이메일을 보낼 때 사용되는 관리자,웹마스터,From 헤더, 회신받을 이메일주소등을 적절히 수정한다.

         $g_administrator_email           = 'administrator@example.com';

         $g_webmaster_email             = 'webmaster@example.com';

이들 값은 굳이 이메일을 사용하지 않는다고 해도 페이지내에 링크가 걸린다. 필요에 따라 적절한 값으로 수정토록 하자.

         $g_enable_email_notification    = ON;

이값은 신규등록 이나 비밀번호 찾기시 인증메일을 사용하는 설정값이다. OFF 면 당연 보내지 않는단다.

304행부터는 메일서버에 대한 설정이 있다.

Mantis 는 mail() , sendmail, SMTP 를 사용하는데 mail()은 더 이상 지원하지 않는다고 본것 같은 어떤지 모르겟다

         $g_phpMailer_method            = 0;

         $g_smtp_host                    = 'localhost';

         $g_smtp_username = '';

         $g_smtp_password = '';

메일서버타입은 0 은 mail(), 1은 sendmail, 2는 SMTP 다 외부 smtp 서버를 사용한다면 smtp 정보를 설정해주자.

348행 부터는 언어에 관한 섹션인데 auto 는 웹브라우저에서 인식하는 언어로 자동으로 맞추어 준다. 1.1.0 버전인가 1.0.8 인가에는 언어 배열에 utf-8 도 포함되어 있던데 개발버전이라 그런지 안보인다.

$g_default_language             = 'english';

당연 Korean 으로 해놓으면 자동으로 한국어로 설정된다.

         $g_fallback_language   = 'english';

auto 로 설정했을경우 자동으로 언어를 찾는데 실패 했을경우 사용할 언어를 지정한다.

442행 부터는 웹브라우저 타이틀이나 로고등 특정메뉴를 감추거나 보이는 설정값들이 시작된다.

         $g_window_title                 = 'Mantis';

         $g_page_title                    = '';

웹브라우저 타이틀 과 페이지의 중앙에 표시될 문자등을 쓴다.

         $g_enable_project_documentation        = ON;

메뉴중 문서 메뉴 링크를 활성화 시킨다.

         $g_show_footer_menu          = OFF;

상단의 메인메뉴들을 하단에도 출력여부를 설정한다.

         $g_show_project_menu_bar = ON;

상단 메인메뉴 위에 프로젝트 링크를 출력한다.

         $g_show_extended_project_browser = OFF;

상단 오른쪽에 위치한 프로젝트 이동에 서브 프로젝트를 선택할수 있는 콤보박스를 출력한다.

         $g_show_priority_text  = OFF;

이슈들을 보여줄 때 우선순위를 아이콘으로 보여줄지 텍스트로 보여줄지 결정한다.

$g_view_issues_page_columns = array ( 'selection', 'edit', 'priority', 'id', 'sponsorship_total', 'bugnotes_count', 'attachment', 'category', 'severity', 'status', 'last_updated', 'summary' );

$g_print_issues_page_columns = array ( 'selection', 'priority', 'id', 'sponsorship_total', 'bugnotes_count', 'attachment', 'category', 'severity', 'status', 'last_updated', 'summary' );

$g_csv_columns = array ( 'id', 'project_id', 'reporter_id', 'handler_id', 'priority', 'severity', 'reproducibility', 'version', 'projection', 'category', 'date_submitted', 'eta', 'os', 'os_build', 'platform', 'view_state', 'last_updated', 'summary', 'status', 'resolution', 'fixed_in_version', 'duplicate_id' );

각각 이슈보기시 이슈목록을 화면에 출력하거나 프린트, cvs 로 내보낼 때 컬럼을 정의할수 있다. 위치변경은 물론 더하거나 뺄수도 있다.

자세한 것은 주석문을 참고하도록 한다.

쿠키에대한 설정이 필요다면 587 행을…날자 형식을 변경하고자 한다면 603행을 참고하도록…

758행을 보면 후원 를 지원하는 옵션이 있다. 이옵션을 켜면 해당 이슈에 대해서 후원자를 받을수 있다. 뭐 직접 후원긍을 처리되는 것 같아 보이지는 않지만, 뭐 여튼 그런것이다. -.-;

788행 부터는 파일 업로드에 대한 부분인데 파일을 업로드는 DISK, Database, FTP 를 지원한다. 기본값으로는 데이터베이스 이고 다른 곳으로 변경하고자 할때는 적절히 수정한다.

838행 부터는 HTML 출력에 대한 옵션을 설정할수 있다. 이슈노트등을 작성할 때 웹주소등을 자동으로 링크걸고 허용하는 싱글 html 태그를 설정한다. 파라미터 는 지원하지 않는다.

875행 부터는 LDAP 와 연동을 위한 섹션이다.

939행부터는 첨부파일에 대한 섹션인데, 미리보기를 할수 있는 텍스트 파일이나 이미지 파일의 설정등을 할수 있다.

그외 여러가지 가 있으며 대충 보면 알수 있을 것 같은것도 있고 Mantis 의 관리화면에서 설정할수 있는것들도 있다.

환경변수를 수정할때는 필요한것들만 config_inc.php 로 옮겨서 적용토록 하고 반드시 백업본을 만들어두도록 하자.

페이지 상단과 하단에 출력되는 로고이미지나 링크를 바꿀려면은 다음 파일을 수정하면 된다.

/core/html_api.php

html_top_banner, html_footer 함수에서 적절하게 수정하면 된다.

1241 행에 보면 다음과 같은 변수가 있다.

$g_user_login_valid_regex = '/^[w -]+$/';

사용자명의 유효성을 체크하는 정규표현식이다. /core/user_api.php 에서 user_is_name_valid 함수에서 사용자명을 확인하는데 길이는 32자 그리고 저 표현식으로 유효성을 검사한다. 현재 한글사용자명은 안된다. 정규표현식을 잘 아시는분은 적당히 수정해서 사용하거나 아니면 다음과 같은 표현식으로 처리해보자.

'/^[w W -]+$/';

중간에 W 하나가 더 들어갔다..솔직히 정규표현식은 걍 구경만 했을뿐 잘 모른다. -.-; 뭐 일단 저렇게 값을 변경해주면 한글사용자명을 사용할 수가 있다.