Mantis : 환경설정의 비밀~

Mantis를 처음 설치하게 되면,
설치폴더에는 각종 php 파일과 몇개의 폴더가 생기게 된다.
인터넷에서 Mantis에 관한 설치 방법을 검색해보면, 메일 통지를 위해서~
“config_inc.php” 파일에 ~ 이런 저런 설정을 입력하라고 한다.
왜? 이 파일에다가 설정을 하지?
파일 이름을 보아하니 환경설정 값을 가지고 있긴 한데… 사실 궁금했다.

조금만 프로그래밍을 한 사람이면,
여기서 힌트를 얻어서 config_defaults_inc.php 파일까지 알아차려 버린다.
그렇다~!! Mantis는 기본적인 환경 설정값을 config_default_inc.php에서 관리한다.
그럼… config_inc.php는 뭐고 config_defaults_inc.php는 뭐지?

말 그대로 config_defaults_inc.php는 디폴트 환경 설정값을 가지고 있고,
뭔가 변경을 시킬 필요가 있을 경우에는 config_inc.php에 설정을 한다.
즉, config_defaults_inc.php 파일을 직접 수정해도 상관은 없지만,
디폴트 환경설정값을 변경할 필요가 있을 경우에는 config_inc.php 파일에
원하는 값을 설정하여 사용하기를 권장한다.

여기서, 또 한가지 궁금증이 생긴다.
프로젝트를 관리하다 보면, 이 프로젝트에서는 이렇게, 다른 프로젝트에서는
다른 값으로 관리를 하고 싶은데, config_inc.php 로 설정값을 변경하니깐
모든 프로젝트에 동일한 환경이 설정이 되어 버리던데, 좋은 방법이 없을까:??

이런 면에서, Mantis는 open source이면서도 너무 편리하게 되어 있다.
Mantis (한글 기준) -> ‘관리’ 메뉴 -> [설정사항관리] 를 클릭하게 되면,
[configuration_report] 라는 메뉴가 보인다.
바로 이 화면을 이용하면 config_defaults_inc.php 혹은 config_inc.php에서
설정하던 거의 모든 환경값을 파일을 직접 손대지 않고 수정할 수 있다.
(일부 보안관련 항목은 여기서 설정할 수 없고, 반드시 파일에서 해야 한다.)
그것도, 환경값을 프로젝트별로 적용하거나, 심지어 유저별로 설정도 가능하다.

예를 들어, 다음과 같이 설정을 했다고 하자.
– 사용자 ID : honggildong
– 프로젝트 : 잘먹고잘살자 프로젝트
– Configuration Option : show_realname
– Type : integer
– Value : 1

위 설정을 해석을 하면 ‘honggildong’이라는 사용자가 로그인을 해서,
‘잘먹고잘살자 프로젝트’를 선택했을 때는 사용자ID를 사용자ID가 아니라,
실제 이름으로 표시를 해라~ 라는 설정입니다. 물론, 다른 사용자이면 ID로만
표시가 될 것이고, honggildong이라는 사용자라 하더라도, 다른 프로젝트를
선택했을 경우, 화면상의 사용자ID는 모두 사용자ID로만 표시가 될 것 입니다.

각 항목별로 조금 더 자세히 설명을 하면,
Configuration Option에 입력하는 항목은, config_defaults_inc.php 파일에
설정된 수많은 환경 변수의 이름인데, 변수명에서 ‘g_’만 제외하고 입력하면 된다.

Type은 일반적인 integer, string을 얘기하는데,
배열과 같이 복잡한 형식은 complex 타입으로 선언을 하게 된다.
config_defaults_inc.php에 각종 상수로 정의된 값들은(ON, OFF 등),
Value에 상수를 그대로 입력하면 인식이 안되기 때문에,
mantis폴더/core/contant_inc.php 에서 상수값을 확인한 후,
정의된 상수값을 Value에 설정해 주어야 제대로 인식이 된다. 꼭! 명심하길.

이렇듯, 환경 설정은 여러 곳에서 할 수 있는데,
마지막으로 정리하는 의미에서 적용되는 우선 순위를 정리하면,
1순위 : Configuration Option
2순위 : config_inc.php
3순위 : config_defaults_inc.php 입니다.
즉, Mantis는 1순위에 설정되어 있으면 1순위를 없으면 2순위를 찾고,
그다음 3순위를 찾는 순서로 적용이 된다.

설치 상태 그대로의 밋밋한 Mantis를 사용하고 있다면,
위의 규칙을 이용해 Mantis를 보다 편리하게 Customize 해 보실 것을 권한다.

여기서 보통 Mantis 설치 후, 적용하게 되는 유용한 환경 설정값을 소개한다.
# “이슈 보기” 화면에, 하단에만 나타난 범례를 화면 상단에도 표시하도록 한다.
# — Position of the status colour legend, can be: STATUS_LEGEND_POSITION_*
# — see constant_inc.php. (*: TOP , BOTTOM , or BOTH)
$g_status_legend_position = STATUS_LEGEND_POSITION_BOTH;

# 이슈의 상태별 비율을 표시한다. (예, 새로운 이슈-20%, 할당된 이슈-15% … 등)
# — Show a legend with percentage of bug status
# — x% of all bugs are new, y% of all bugs are assigned and so on.
# — If set to ON it will printed below the status colour legend.
$g_status_percentage_legend = ON;

# Mantis 화면의 유저를 실명으로 표시한다. 로그온 아이디는 구별하기가 어렵기에 이 옵션을 추천함
# — show users with their real name or not
$g_show_realname = ON;

##[20121101 추가] 타임존 한국으로 설정. 기본값은 US로 되어 있음.
date_default_timezone_set(“Asia/Seoul”);