1. 필드 등록 (관리자)

1. 관리자 → 게시판 관리
2. 원하는 게시판 행의 보라색 아이콘 클릭
3. 모달에서 + 새 필드 클릭
4. 아래 항목 입력 후 저장

2. 스킨에서 사용하기

중요: 스킨 파일 상단에 아래 한 줄을 추가해야 합니다

require_once DX_ROOT . '/core/BoardFields.php';

3. 글쓰기 / 수정 (write.php)

<?php require_once DX_ROOT . '/core/BoardFields.php'; ?>
<form method="post" ...>
 <!-- 기존 제목, 내용 등 폼 필드 -->
 <input type="text" name="title" ...>
 <!-- 여분 필드 자동 출력 -->
 <?php
 /* 수정 시 기존 값 로드, 신규 시 빈 배열 */
 $savedMeta = array();
 if (!empty($post['id'])) {
 $savedMeta = dx_board_fields()->getMeta($post['id']);
 }
 echo dx_board_fields()->renderWriteForm($board['id'], $savedMeta);
 ?>
 <button type="submit">저장</button>
</form>

renderWriteForm() 이 자동으로 각 필드 타입에 맞는 HTML 입력 요소를 생성합니다.
저장은 extend/top/50_board_fields.php 훅이 자동 처리하므로 별도 저장 코드 불필요.

필드 이름 규칙

필드 키: price → <input name="bf_price">
필드 키: location → <input name="bf_location">

4. 글 상세 보기 (view.php)

<?php require_once DX_ROOT . '/core/BoardFields.php'; ?>
<!-- 글 본문 출력 -->
<div class="content"><?php echo $post['content']; ?></div>
<!-- 여분 필드 자동 출력 (is_view=1 인 필드만 표시) -->
<?php echo dx_board_fields()->renderView($board['id'], $post['id']); ?>

renderView() 출력 예시:
가격 50,000원
지역 서울 강남구
연락처 010-1234-5678

개별 값 직접 꺼내기

<?php
$price = dx_get_post_meta($post['id'], 'price', '0');
$location = dx_get_post_meta($post['id'], 'location', '미입력');
$contact = dx_get_post_meta($post['id'], 'contact', '');
?>
<div class="post-meta">
 <span>가격: <?php echo htmlspecialchars($price, ENT_QUOTES, 'UTF-8'); ?>원</span>
 <span>지역: <?php echo htmlspecialchars($location, ENT_QUOTES, 'UTF-8'); ?></span>
</div>

전체 메타 한 번에 로드

$meta = dx_board_fields()->getMeta($post['id']);
// $meta = array('price' => '50000', 'location' => '서울', ...)

$price    = isset($meta['price'])    ? $meta['price']    : '';
$location = isset($meta['location']) ? $meta['location'] : '';

5. 글 목록 (list.php)

<?php
require_once DX_ROOT . '/core/BoardFields.php';

/* is_list=1 인 필드만 가져오기 */
$listFields = array();
foreach (dx_board_fields()->getFields($board['id']) as $f) {
    if ($f['is_list'] == 1) {
        $listFields[] = $f;
    }
}
?>

<table>
  <thead>
    <tr>
      <th>번호</th>
      <th>제목</th>
      <th>작성자</th>
      <!-- 여분 필드 컬럼 헤더 -->
      <?php foreach ($listFields as $f): ?>
      <th><?php echo htmlspecialchars($f['field_label'], ENT_QUOTES, 'UTF-8'); ?></th>
      <?php endforeach; ?>
      <th>날짜</th>
    </tr>
  </thead>
  <tbody>
    <?php foreach ($posts as $p): ?>
    <?php $meta = dx_board_fields()->getMeta($p['id']); ?>
    <tr>
      <td><?php echo $p['id']; ?></td>
      <td><?php echo htmlspecialchars($p['title'], ENT_QUOTES, 'UTF-8'); ?></td>
      <td><?php echo htmlspecialchars($p['author_name'], ENT_QUOTES, 'UTF-8'); ?></td>
      <!-- 여분 필드 값 -->
      <?php foreach ($listFields as $f): ?>
      <td>
        <?php
        $val = isset($meta[$f['field_key']]) ? $meta[$f['field_key']] : '';
        echo htmlspecialchars($val, ENT_QUOTES, 'UTF-8');
        ?>
      </td>
      <?php endforeach; ?>
      <td><?php echo $p['created_at']; ?></td>
    </tr>
    <?php endforeach; ?>
  </tbody>
</table>

6. 헬퍼 함수 정리

BoardFields 인스턴스 메서드

7. 저장/삭제 자동 처리

글 저장 후 (dx_board_after_save) → POST 데이터에서 bf_ 접두사 필드 자동 추출 후 저장
글 삭제 후 (dx_board_after_delete) → 해당 글의 메타 데이터 자동 삭제

8. 실전 예시 — 중고거래 게시판

필드 설정 (관리자)

write.php

<?php require_once DX_ROOT . '/core/BoardFields.php'; ?>
<form method="post">
  <input type="text" name="title" placeholder="제목">
  <textarea name="content"></textarea>

  <?php
  $savedMeta = !empty($post['id']) ? dx_board_fields()->getMeta($post['id']) : array();
  echo dx_board_fields()->renderWriteForm($board['id'], $savedMeta);
  ?>

  <button type="submit">등록</button>
</form>

view.php

<?php require_once DX_ROOT . '/core/BoardFields.php'; ?>

<h1><?php echo htmlspecialchars($post['title'], ENT_QUOTES, 'UTF-8'); ?></h1>

<!-- 가격을 강조해서 따로 표시 -->
<?php $price = dx_get_post_meta($post['id'], 'price', '0'); ?>
<div class="price"><?php echo number_format((int)$price); ?>원</div>

<!-- 나머지 여분 필드는 자동 렌더링 -->
<?php echo dx_board_fields()->renderView($board['id'], $post['id']); ?>

<div class="content"><?php echo $post['content']; ?></div>

$post['id'] 는 BIGINT 밀리초 타임스탬프입니다. (int) 캐스팅 하지 마세요.

필드 키는 생성 후 변경이 불가합니다. 신중하게 정하세요.

필드 삭제 시 해당 필드에 저장된 모든 게시글의 값이 함께 삭제됩니다.