Dolibarr 모듈 개발 편집하기 (부분)

== 메뉴 항목 정의 ==
개발한 **PHP 페이지를 돌리바 메뉴를 통해 접근 가능하게 만들 필요가 있을 경우**에 해당됩니다.

**자체 메뉴 항목 정의 방법:**

*   **모듈 설명자 파일 수정:** 자체 메뉴 항목을 정의하려면 모듈 설명자 파일 내의 **`$this->menu` 배열**을 수정해야 합니다. 이 배열은 모듈이 활성화되면 나타날 메뉴 항목들을 선언합니다.
*   **`$this->menu` 배열 구조:** `$this->menu` 배열은 각 메뉴 항목에 대한 정보를 담는 연관 배열로 구성됩니다. 주요 속성은 다음과 같습니다:
    *   **`fk_menu`**: 상위 메뉴의 ID를 지정합니다. 최상위 메뉴인 경우 **`0`** 을 설정합니다. 하위 메뉴인 경우 **`'fk_mainmenu=xxx'`** 또는 **`'fk_mainmenu=xxx,fk_leftmenu=yyy'`** 와 같은 형식으로 상위 메뉴 코드를 지정합니다.
    *   **`type`**: 메뉴 항목의 유형을 지정합니다. 최상위 메뉴는 **`'top'`**, 왼쪽 메뉴는 **`'left'`** 로 설정합니다.
    *   **`titre`**: 메뉴에 표시될 제목입니다. **언어 파일(`langs`)** 에서 번역 키를 사용하여 다국어 지원을 구현하는 것이 좋습니다.
    *   **`mainmenu`**: 최상위 메뉴의 고유 코드입니다.
    *   **`leftmenu`**: 왼쪽 메뉴의 고유 코드입니다. 최상위 메뉴의 경우 `mainmenu` 와 동일한 값을 사용하거나 필요에 따라 다른 값을 설정할 수 있습니다.
    *   **`url`**: 메뉴 항목을 클릭했을 때 이동할 PHP 페이지의 경로입니다. 모듈 디렉토리를 기준으로 하는 상대 경로를 사용합니다 (예: `/mymodule/pagetop.php`).
    *   **`langs`**: 메뉴 제목에 사용될 언어 파일의 이름 (확장자 `.lang` 제외)입니다. 해당 언어 파일은 `langs/code_CODE/` 디렉토리에 위치해야 합니다.
    *   **`position`**: 메뉴 항목의 표시 순서를 결정하는 숫자입니다.
    *   **`enabled`**: 메뉴 항목을 표시할지 여부를 결정하는 조건입니다. `'1'` 로 설정하면 항상 표시됩니다. 모듈 활성화 여부에 따라 표시하려면 **`'$conf->mymodule->enabled'`** 와 같은 설정을 사용할 수 있습니다.
    *   **`perms`**: 메뉴 항목에 접근할 수 있는 권한을 정의합니다. `'1'` 로 설정하면 모든 활성 사용자에게 표시됩니다. 특정 권한이 있는 사용자에게만 표시하려면 **`'perms'=>'$user->rights->mymodule->level1->level2'`** 와 같은 형식으로 권한 규칙을 지정합니다. 권한 정의에 대한 자세한 내용은 출처의 뒷부분을 참고하십시오.
    *   **`target`**: 링크의 타겟 속성입니다 (예: `'_blank'`).
    *   **`user`**: 메뉴 항목이 내부 사용자 (`0`), 외부 사용자 (`1`), 또는 둘 다 (`2`)에게 표시될지 여부를 지정합니다.
*   **메뉴 항목 테스트:** 모듈 설정 페이지에서 모듈을 비활성화했다가 다시 활성화하면 `$this->menu` 배열의 `'enabled'` 속성 설정에 따라 메뉴 항목이 나타나야 합니다.