워드프레스 메타 인프라 구축: ACF Pro와 Woody Snippets 활용 가이드

low : 🟢 초급 (Beginner)
medium : 🔵 중급 (Intermediate)
high : 🔴 고급 (Advanced)
expert : ⚡ 전문가 (Expert)

docker : 🐳 Docker Compose
baremetal : 🖥️ Bare Metal
synology : 💾 Synology Package
vm : 💻 Virtual Machine
kubernetes : ☸️ Kubernetes

function agibop_render_tech_meta_card() {
    $id = get_the_ID();
    if ( ! $id ) return '';

    /* ── ACF 필드 수집 ─────────────────────────── */
    $series    = get_field('post_series',      $id);
    $updated   = get_field('post_update_date', $id);
    $version   = get_field('post_version',     $id);
    $level     = get_field('post_level',       $id);
    $read_time = get_field('post_read_time',   $id);
    $env       = get_field('post_env',         $id);
    $ai_engine    = get_field('ai_engine',       $id);
    $deploy_type  = get_field('deployment_type', $id);
    $base_os      = get_field('base_os',         $id);
    $target_sys   = get_field('target_system',   $id);
    $data_tool    = get_field('data_tool',       $id);

    /* ── 값이 하나도 없으면 출력하지 않음 ────── */
    $has_data = $series || $updated || $version || $level || $read_time
             || $env || $ai_engine || $deploy_type || $base_os
             || $target_sys || $data_tool;
    if ( ! $has_data ) return '';

    /* ── 배포 방식 라벨 변환 ─────────────────── */
    $deploy_labels = [
        'docker'     => '🐳 Docker Compose',
        'baremetal'  => '🖥️ Bare Metal',
        'synology'   => '💾 Synology Package',
        'vm'         => '💻 Virtual Machine',
        'kubernetes' => '☸️ Kubernetes',
    ];
    $deploy_label = $deploy_labels[ $deploy_type ] ?? $deploy_type;

    /* ── 난이도 배지 색상 ────────────────────── */
    $level_map = [
        'low'    => ['label' => '🟢 초급',   'color' => '#4ade80', 'bg' => 'rgba(34,197,94,.15)',   'border' => 'rgba(34,197,94,.3)'],
        'medium' => ['label' => '🔵 중급',   'color' => '#60a5fa', 'bg' => 'rgba(96,165,250,.15)',  'border' => 'rgba(96,165,250,.3)'],
        'high'   => ['label' => '🔴 고급',   'color' => '#f87171', 'bg' => 'rgba(248,113,113,.15)', 'border' => 'rgba(248,113,113,.3)'],
        'expert' => ['label' => '⚡ 전문가', 'color' => '#fbbf24', 'bg' => 'rgba(251,191,36,.15)',  'border' => 'rgba(251,191,36,.3)'],
    ];
    $lv = $level_map[ $level ] ?? null;

    /* ── CSS (인라인 — 외부 의존 없음) ──────── */
    $css = '
    ';

    /* ── HTML 조립 ───────────────────────────── */
    $html = $css . '
';

    if ( $series )
        $html .= '
SERIES📌 ' . esc_html($series) . '
';
    if ( $updated )
        $html .= '
UPDATED📅 ' . esc_html($updated) . '
';
    if ( $version )
        $html .= '
VERSION💿 ' . esc_html($version) . '
';
    if ( $deploy_type )
        $html .= '
DEPLOY' . esc_html($deploy_label) . '
';
    if ( $base_os )
        $html .= '
BASE OS🐧 ' . esc_html($base_os) . '
';
    if ( $ai_engine )
        $html .= '
ENGINE🤖 ' . esc_html($ai_engine) . '
';
    if ( $target_sys )
        $html .= '
TARGET⚙️ ' . esc_html($target_sys) . '
';
    if ( $data_tool )
        $html .= '
TOOL🛠 ' . esc_html($data_tool) . '
';
    if ( $env )
        $html .= '
ENV🖥️ ' . esc_html($env) . '
';
    if ( $read_time )
        $html .= '
READ⏱ ' . esc_html($read_time) . '분 읽기
';
    if ( $lv )
        $html .= '
LEVEL'
               . ''
               . esc_html($lv['label']) . '
';

    $html .= '
';
    return $html;
}
add_shortcode( 'agibop_meta', 'agibop_render_tech_meta_card' );

// ACF 설정: Field Name = version_history (Repeater)
// Sub-fields: ver_num (Text), ver_date (Date), ver_status (Select)

if ( have_rows('version_history') ) :
    echo '<ul class="version-list">';
    while ( the_row() ) :
        $num    = get_sub_field('ver_num');
        $date   = get_sub_field('ver_date');
        $status = get_sub_field('ver_status'); // stable / beta / deprecated
        echo '<li>' . esc_html($num) . ' (' . esc_html($date) . ') - ' . esc_html($status) . '</li>';
    endwhile;
    echo '</ul>';
endif;

// functions.php 또는 Woody Snippet에 추가
if ( function_exists('acf_add_options_page') ) {
    acf_add_options_page([
        'page_title' => '블로그 전역 설정',
        'menu_title' => 'Site Options',
        'menu_slug'  => 'site-options',
        'capability' => 'manage_options',
        'redirect'   => false,
    ]);
}

// 조회 시 두 번째 인자로 'option' 전달
$disclaimer = get_field('global_disclaimer', 'option');
$site_env   = get_field('default_test_env',  'option');

// child-theme/functions.php 또는 Woody Snippet에 추가
// ACF JSON 파일을 테마 폴더 내 acf-json/ 에 저장
add_filter('acf/settings/save_json', function() {
    return get_stylesheet_directory() . '/acf-json';
});

add_filter('acf/settings/load_json', function($paths) {
    $paths[] = get_stylesheet_directory() . '/acf-json';
    return $paths;
});

// 개별 get_field() 대신 get_fields()로 한 번에 로드
// 쿼리 수: 6회 → 1회로 감소
$all_fields = get_fields( get_the_ID() );

$series    = $all_fields['post_series']      ?? '';
$version   = $all_fields['post_version']     ?? '';
$level     = $all_fields['post_level']       ?? '';
$deploy    = $all_fields['deployment_type']  ?? '';

// 추가: Transient 캐싱으로 반복 조회 방지
function agibop_get_meta_cached( $post_id ) {
    $key  = 'agibop_meta_' . $post_id;
    $data = get_transient( $key );
    if ( false === $data ) {
        $data = get_fields( $post_id ) ?: [];
        set_transient( $key, $data, HOUR_IN_SECONDS );
    }
    return $data;
}

// ACF 필드 저장 시 해당 포스트의 캐시 자동 삭제
add_action('acf/save_post', function( $post_id ) {
    delete_transient( 'agibop_meta_' . $post_id );
    // Redis 사용 시
    if ( function_exists('wp_cache_delete') ) {
        wp_cache_delete( 'agibop_meta_' . $post_id, 'acf_cache' );
    }
}, 20);

# 포스트 ID 123의 ACF 필드 전체 조회
curl https://your-blog.com/wp-json/wp/v2/posts/123?_fields=id,title,acf

# 응답 예시
{
  "id": 123,
  "title": { "rendered": "Docker 완벽 가이드" },
  "acf": {
    "post_series": "Docker 마스터 시리즈",
    "post_version": "v26.1.4",
    "post_level": "medium",
    "deployment_type": "docker"
  }
}

Method: POST
URL: https://your-blog.com/wp-json/wp/v2/posts
Headers:
  Authorization: Basic [base64(user:app_password)]
  Content-Type: application/json

Body:
{
  "title": "Docker Swarm 완전 정복",
  "content": "본문 내용...",
  "status": "publish",
  "categories": [15],
  "acf": {
    "post_series": "Docker 마스터 시리즈",
    "post_version": "v26.1.4",
    "post_update_date": "2026-05-24",
    "post_level": "high",
    "deployment_type": "docker",
    "post_env": "Ubuntu 24.04 + Docker 26.x"
  }
}