커스터마이징 준비

1. 망보드 기본 스킨 "bbs_basic" 을 동일한 skins 폴더에 다른 이름 "bbs_hometory"으로 복사합니다.

2. 복사한 스킨 폴더에 스킨 템플릿 파일("/wp-content/plugins/mangboard/skins/bbs_hometory/includes/skin-template.php")을 새로 생성합니다
  - 스킨 템플릿 파일은 템플릿 폴더의 파일을 수정하지 않고 템플릿을 수정하기 위해 제공되는 방식으로 
    템플릿 폴더(/wp-content/plugins/mangboard/templates)에 있는 템플릿 코드 보다 우선해서 실행되기 때문에 
    템플릿 폴더에서 수정이 필요한 템플릿 함수를 찾아 스킨 템플릿 파일에 복사해서 수정하시면 됩니다.

3. 템플릿 수정이 어려우신 분들은 게시판 템플릿 파일(/wp-content/plugins/mangboard/templates/tpl.board.php)의 내용을 
  스킨 템플릿 파일에 그대로 복사해서 수정하는 방법을 추천해 드립니다.
  (게시판 템플릿 파일은 목록, 글작성, 글보기, 댓글에 대한 기본적인 템플릿 함수가 들어있습니다) 

4. 자주 사용하는 템플릿 기능은 아래의 내용을 참고해서 사용자 템플릿 파일을 등록해서 사용합니다.

5. 워드프레스에서 제공하는 플러그인 업데이트 기능을 이용할 경우 새로 추가된 파일이 삭제되는 문제가 있어
  업데이트는 반드시 망보드 대시보드에 있는 업데이트 기능을 이용하고 수정된 파일에 대해서는 백업 파일을 만듭니다.
  (망보드 버젼업이 되면 대시보드에 자동으로 업데이트 버튼이 나타납니다)

6. 커스터마이징 동영상 강의 : https://www.mangboard.com/video/?vid=9

사용자 템플릿 파일 제작하기

1. 사용자 템플릿에 사용할 이름을 정합니다.
  – 템플릿 이름은 모델에서 사용하는 타입의 접두사로 사용됩니다

2. 템플릿 이름이 hometory일 경우 템플릿 폴더(/wp-content/plugins/mangboard/templates)에 "mtpl.hometory.php" 템플릿 파일을 생성하고 아래의 템플릿 샘플 코드를 복사합니다.
  템플릿 폴더(/wp-content/plugins/mangboard/templates)에 복사된 파일은 자동으로 등록되기 때문에 추가적인 등록은 필요하지 않습니다

  ※ 특정 스킨에만 템플릿을 적용할 경우에는 스킨 템플릿 파일(/wp-content/plugins/mangboard/skins/스킨이름/includes/skin-template.php)을 생성하고 아래의 샘플 코드를 복사합니다.

3. 템플릿 샘플 코드에 있는 hometory 이름을 사용자가 정한 이름으로 전부 수정합니다

4. 모델에서 Type 설정에 사용자 템플릿 타입(hometory_name)을 설정합니다.
 – {"field":"fn_user_name","name":"이름","width":"200px","type":"hometory_name"},

5. 템플릿 함수(mbw_get_hometory_template)에서 "hometory_name" 타입으로 출력할 내용을 원하는 스타일로 수정합니다
  – 아래의 템플릿 함수는 hometory_name 타입일 경우 이름 뒤에 "님"을 붙여서 출력합니다.

6. 사용자 템플릿에서 사용할 수 있는 유용한 함수
  – 게시판 데이터 가져오는 함수: mbw_get_board_item("필드명")
    게시판 데이터에서 사용 가능한 필드: https://www.mangboard.com/tip/?vid=6
    ex) 게시물 제목 가져오기: mbw_get_board_item("fn_title")
    ex) 게시물 작성자 이름 가져오기: mbw_get_board_item("fn_reg_date",false)
  – 회원 데이터 가져오는 함수 mbw_get_user("필드명")
    회원 데이터에서 사용 가능한 필드: https://www.mangboard.com/tip/?vid=8
    ex) 로그인한 회원 이름 가져오기 : mbw_get_user("fn_user_name")
    ex) 로그인한 회원 레벨 가져오기 : mbw_get_user("fn_user_level")
    ex) 로그인한 회원 포인트 가져오기 : mbw_get_user("fn_user_point")

  [ 템플릿 샘플 코드 ]
<?php
//템플릿 함수 등록(템플릿 타입의 접두사, 템플릿 함수명)
//"hometory_"로 시작하는 타입은 mbw_get_hometory_template 템플릿 함수를 통해 파싱
mbw_add_template("hometory","mbw_get_hometory_template"); 

if(!function_exists('mbw_get_hometory_template')){
    function mbw_get_hometory_template($mode, $data){
        global $mdb,$mstore,$mb_languages;
        $template_start     = '';
        $item_type          = $data["type"];

        if($item_type=='hometory_name'){
            $template_start    = $data["value"].'님';
        }else if($item_type=='hometory_name2'){
            $template_start    = mbw_get_board_item("fn_user_name").'님';
        }else if($item_type=='hometory_text'){
            $template_start    = 'Hometory text';
        }
        return $template_start;
    }
}
?>

스킨 필터 파일 추가하기

1. 망보드 코어 필터 파일(/wp-content/plugins/mangboard/includes/skin-filters.php)을 스킨 폴더(스킨이름/includes/skin-filters.php)로 복사합니다

2. 스킨 폴더에 스킨 필터 파일이 존재하면 망보드 코어 필터 파일을 실행하지 않습니다

3. 필터 파일은 데이터를 보여줄 때 특정 문자나 이미지를 추가할 때 사용합니다
  – 사용자 이름에 프로필 사진, 레벨표시 등
  – 검색 키워드에 하이라이트 효과 표시

스킨 API 추가하기

1. 망보드 API(/wp-content/plugins/mangboard/api) 폴더를 스킨 API(스킨이름/api) 폴더에 복사합니다

2. 스킨 폴더에 API 파일이 존재하면 우선적으로 실행됩니다

3. 망보드 코어 API를 수정하기 위한 방법으로 수정에 필요한 최소한의 API 파일만 복사해서 사용합니다

스킨 Language 파일 추가하기

1. /wp-content/plugins/mangboard/includes/languages/mb-languages.php 파일의 내용과 이름을 수정해서 아래 스킨 폴더에 복사합니다 

  – 다국어 Language 파일 

    파일 : "/wp-content/plugins/mangboard/skins/스킨이름/includes/languages/skin-languages-ko_KR.php"

             (ko_KR 부분을 해당 나라에 맞는 코드로 수정해서 사용)  

  – 기본 Language 파일 (나라별 언어 파일이 없을 경우 사용될 언어파일)

    파일 : "/wp-content/plugins/mangboard/skins/스킨이름/includes/languages/skin-languages.php"

2. 스킨 Language 파일은 기본 언어 파일(/wp-content/plugins/mangboard/includes/languages/mb-languages.php)을 읽어온 다음에 추가로 읽어오도록 설정되어 있습니다.

3. 스킨 Language 파일은 /wp-content/plugins/mangboard/includes/languages/mb-languages.php 파일에 없는 내용 위주로 추가해서 사용합니다.

※ 한국어가 아닌 다른 언어로 사용하실 경우 mb-languages.php 파일과 모델파일 언어를 모두 수정해서 사용하셔야 합니다.

스킨의 기본 실행 순서

1. "_header.php" 파일

2. 게시판 추가시 설정한 상단내용

3. 게시판 상단 액션으로 설정한 내용 : do_action('mbw_board_header')

4. 게시판 mode 파일 
  – 글목록(list.php), 글보기(view.php), 글작성(write.php), 댓글(comment.php) : 모델 및 템플릿을 이용해 태그 생성함
  – mode=list로 설정되어 있으면 글목록 파일이 실행됨
  – URL 주소에 list_type=calendar 파라미터가 있으면 list.php 파일 대신에 calendar.php 파일을 불러옴
   (write_type, view_type 도 동일함)
5. 게시판 하단 액션으로 설정한 내용 : do_action('mbw_board_footer')

6. 게시판 추가시 설정한 하단내용

7. "_footer.php" 파일