무화과 시작/지식 관련/워드프레스/콘텐츠 세부 정보

WordPress 플러그인 개발 완전 가이드: 입문부터 실전까지 상세 설명

3분 읽기
2026-03-15
2026-06-03
2,772
아래 링크를 통해 쇼핑하면 추가 비용 없이 수수료를 받을 수 있습니다.

왜 WordPress 플러그인 개발을 배워야 할까요?

WordPress는 전 세계에서 가장 인기 있는 콘텐츠 관리 시스템(CMS)으로, 그 강력한 확장성은 주로 플러그인 메커니즘 덕분입니다. 플러그인 개발을 배우면 기존 플러그인의 기능에 제한받지 않고 프로젝트의 요구에 맞게 맞춤형 솔루션을 만들 수 있습니다. 이는 고객에게 독특한 기능을 제공하는 것은 물론, 훌륭한 아이디어를 제품화하여 커뮤니티와 공유하는 데에도 유용합니다. 이 기술을 숙달하면 개발 효율성과 시장 경쟁력을 크게 향상시킬 수 있습니다.

표준적인 WordPress 플러그인은 독립적인 PHP 파일이거나 여러 파일을 포함하는 디렉터리로, 일련의 사전 정의된 인터페이스를 통해 WordPress 코어와 상호작용합니다. 개발 과정은 주로 WordPress의 구조와 기능을 이해하는 데 중점을 둡니다.Hooks(후크) 시스템은 해당 코딩 표준과 보안 관행을 준수해야 합니다.

자신의 첫 번째 플러그인을 만들어 보세요.

코드를 작성하기 시작하기 전에, 로컬 개발 환경이 필요합니다. XAMPP, MAMP 또는 Local by Flywheel을 사용하는 것을 추천합니다. 환경이 준비되면 바로 코딩을 시작할 수 있습니다.wp-content/plugins디렉터리에 첫 번째 플러그인을 생성했습니다.

추천 읽기 WordPress 플러그인 개발을 처음부터 마스터하는 방법: 완전한 가이드와 실전 연습。

메인 플러그인 파일을 생성합니다.

모든 플러그인은 반드시 주 PHP 파일을 가지고 있어야 하며, 파일의 맨 위에 표준적인 플러그인 정보 주석을 포함해야 합니다. 이 파일은 플러그인의 시작점이며, 그 이름은 보통 플러그인 디렉터리의 이름과 일치합니다. 예를 들어, ‘my-plugin’이라는 이름의 플러그인을 만들 경우, 해당 플러그인의 주 PHP 파일은 ‘my-plugin.php’가 됩니다.my-first-plugin해당 디렉터리의 내용을 확인하고, 그 안에 동일한 이름의 파일을 생성하세요.my-first-plugin.php파일.

UltaHost의 WordPress 호스팅 서비스
30일 환불 보장, 무제한 대역폭 및 데이터베이스 이용, 무료 DDoS 보호 서비스 제공. 3년 구매 시 50% 용량이 할인됩니다.
울타호스트(ULTAHost) 로고 액세스 페이지

파일의 시작 부분에 있는 주석은 매우 중요합니다. WordPress는 이 주석을 통해 플러그인의 기본 정보를 인식합니다.

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于学习插件开发的简单示例插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

파일을 저장한 후에는 WordPress 관리자에 로그인하고 “플러그인” 페이지로 이동하세요. 그러면 새로 추가된 플러그인이 플러그인 목록에 표시되며, 활성화할 수 있습니다. 현재 이 플러그인에는 아직 어떠한 기능도 없습니다.

첫 번째 기능을 추가하세요.

이제 이 플러그인에 간단한 기능을 추가해 보겠습니다: 글 내용의 끝에 자동으로 사용자 정의 텍스트를 추가하는 기능입니다. 이를 위해서는 WordPress의 기능들을 활용해야 합니다.the_content필터 후크(Filter Hook).

플러그인의 메인 파일에, 주석 정보 아래에 다음 코드를 추가하세요:

추천 읽기 워드프레스 플러그인 개발 완전 가이드: 처음부터 첫 번째 기능 플러그인을 만들기。

// 글 내용 뒤에 사용자 정의 텍스트 추가
function myfp_add_footer_text($content) {
    // 메인 루프의 단일 게시물에서만 표시되도록 보장
    if (is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query()) {
        $custom_text = '<p><em>읽어주셔서 감사합니다! 이 글은 “My First Plugin”의 지원을 받아 작성되었습니다.</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
// ‘the_content' 필터에 함수 연결
add_filter('the_content', 'myfp_add_footer_text');

이 코드는 함수를 정의합니다.myfp_add_footer_text그것은 기사의 내용을 받아들입니다.$content매개변수로 전달됩니다. 함수 내부에서는 조건 판단을 통해 해당 기능이 오직 개별 기사 페이지에서만, 그리고 주 쿼리의 주循环 내에서만 적용되도록 합니다. 그런 다음 사용자 정의 HTML 텍스트를 추가하여 결합합니다. 마지막으로, 이를 사용합니다.add_filter()이 함수는 이 사용자 정의 함수를 WordPress에 마운트합니다.the_content필터에 적용되어 있습니다. 플러그인을 활성화한 후에는 어떤 기사든 확인해 보세요; 기사 내용의 하단에서 추가된 텍스트를 볼 수 있을 것입니다.

핵심을 알아보세요: 후크와 애플리케이션 프로그래밍 인터페이스(API)

WordPress 플러그인 개발의 핵심은 WordPress의 훅(Hooks) 시스템과 풍부한 API를 이해하고 숙련되게 사용하는 데 있습니다. 이러한 요소들은 플러그인이 WordPress 코어와 안전하고 표준에 맞게 통신할 수 있도록 하는 중요한 기반입니다.

동작과 필터 후크에 대해 이해하세요.

후크(hook)는 주로 두 가지 유형으로 나뉩니다: 액션(Action)과 필터(Filter)입니다. 액션 후크를 사용하면 특정 시점에 사용자 정의 코드를 “실행”할 수 있습니다. 예를 들어,wp_footer동작은 페이지 하단의 태그 앞에서 실행됩니다. 이를 활용하려면…add_action('wp_footer', 'your_function')여기에 추적 코드나 사용자 정의 HTML을 삽입하세요.

호스팅닷컴 공유 호스팅
AMD EPYC CPU, NVMe SSD 스토리지 및 LiteSpeed를 통한 고성능, 연중무휴 24시간 전문가 사내 지원, SSL, 무차별 공격, 멀웨어 및 DDoS 보호를 포함한 고급 보안 조치, 최대 73%의 비용 절감.
호스팅닷컴 로고 액세스 페이지

필터 후크(filter hook)를 사용하면 데이터를 “수정”할 수 있습니다. 필터 후크는 데이터를 받아서 사용자가 정의한 함수에서 처리한 후 다시 반환합니다. 앞서 언급한 페이지 하단 텍스트를 추가하는 예시가 바로 필터의 전형적인 사용 사례입니다. 또 다른 흔한 예시는…excerpt_length필터는 기사 요약의 길이를 수정하는 데 사용됩니다.

// 修改摘要长度为20个单词
function myfp_custom_excerpt_length($length) {
    return 20;
}
add_filter('excerpt_length', 'myfp_custom_excerpt_length');

WordPress 데이터베이스 API를 사용하기

플러그인들은 종종 데이터를 저장하고 읽어올 필요가 있습니다. 워드프레스는 이러한 기능을 제공합니다.wpdb이 클래스를 사용하면 데이터베이스와 안전하게 상호작용할 수 있습니다. 간단한 키-값 쌍 데이터의 경우, Options API를 사용하는 것을 강력히 권장합니다.

예를 들어, 사용자가 이전에 추가한 푸터 텍스트를 자유롭게 수정할 수 있도록 하기 위해 옵션을 만들 수 있습니다.

추천 읽기 WordPress 플러그인 개발 완전 가이드: 초보자부터 전문가급 확장 기능 구축까지。

// 1. 创建可配置的页脚文本
function myfp_add_footer_text_v2($content) {
    if (is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query()) {
        // 从数据库获取选项值，如果不存在则使用默认值
        $footer_text = get_option('myfp_footer_text', '感谢阅读！本文由“我的第一个插件”提供支持。');
        $custom_text = '<p><em>'`. esc_html($footer_text)`.'</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
add_filter('the_content', 'myfp_add_footer_text_v2');

이제, 해당 텍스트를 통해…get_option()함수는 데이터베이스에서 값을 읽어옵니다. 다음으로, 사용자가 이 값을 수정할 수 있도록 관리 페이지가 필요합니다.

플러그인 관리 페이지를 만들기

플러그인을 더 전문적이고 사용하기 쉽게 만들기 위해서는 설정 페이지를 추가하는 것이 필요합니다. 이는 일반적으로 WordPress의 관리 메뉴 API를 통해 구현됩니다.

InterServer 공유 호스팅
공유 호스팅 월 $2.50 USD, 첫 달 $0.1 USD 프로모션 코드 tryinterserver, 461개 클라우드 앱 스크립트, 원클릭 설치.
인터서버(InterServer) 로고 액세스 페이지

관리 메뉴와 하위 페이지를 추가하세요.

플러그인에 독립적인 상위 메뉴를 추가하거나, “설정” 또는 “도구” 메뉴의 하위 메뉴로 포함시킬 수 있습니다. 여기서는 “설정” 메뉴에 추가하도록 하겠습니다.

먼저, 사용하기 위해…add_action()함수를 마운트하려면admin_menu이 함수 내에 메뉴 항목을 추가하세요.

// 添加管理菜单
function myfp_add_admin_menu() {
    add_options_page(
        '我的第一个插件设置', // 页面标题
        '我的插件设置',       // 菜单标题
        'manage_options',     // 所需权限
        'my-first-plugin',    // 菜单slug
        'myfp_options_page_html' // 用于渲染页面的回调函数
    );
}
add_action('admin_menu', 'myfp_add_admin_menu');

add_options_page()이 함수는 “설정” 메뉴 아래에 하위 페이지를 생성합니다. 사용자가 이 메뉴를 클릭하면, WordPress는 우리가 지정한 콜백 함수를 호출합니다.myfp_options_page_htmlPlease output the page content.

구성 설정 페이지 양식을 만들어보세요.

다음으로, 간단한 설정 양식을 렌더링하기 위한 콜백 함수를 정의합니다. 이 양식은 제출될 예정입니다.options.php이것은 WordPress가 설정을 처리하는 표준 방식입니다.

// 설정 페이지 렌더링
function myfp_options_page_html() {
    // 사용자 권한 확인
    if (!current_user_can('manage_options')) {
        return;
    }
    ?&gt;
    <div class="wrap">
        <h1><?php echo esc_html(get_admin_page_title()); ?></h1>
        <form action="/ko/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出必要的安全字段
            settings_fields('myfp_settings');
            // 输出设置章节和字段
            do_settings_sections('my-first-plugin');
            // 提交按钮
            submit_button('保存设置');
            ?>
        <input type="hidden" name="trp-form-language" value="ko"/></form>
    </div>
    &lt;?php
}

등록 설정, 챕터, 필드

단순한 폼만으로는 충분하지 않습니다. 우리는 그것을 사용해야 합니다.register_setting(), add_settings_section()그리고add_settings_field()등의 함수를 사용하여 WordPress에 어떤 설정 항목들이 있는지 알려줍니다.

// 플러그인 설정 초기화
function myfp_settings_init() {
    // ‘myfp_settings’ 설정 그룹에 ‘myfp_footer_text’ 필드 등록
    register_setting('myfp_settings', 'myfp_footer_text');

// ‘my-first-plugin' 페이지에 설정 섹션 추가
    add_settings_section(
        'myfp_section',
        '푸터 텍스트 설정',
        null, // 섹션 설명 콜백 함수, 여기서는 필요 없음
        'my-first-plugin'
    );

// 위 섹션에 필드 추가
    add_settings_field(
        'myfp_field_footer_text',
        '사용자 정의 푸터 텍스트',
        'myfp_field_footer_text_html', // 필드 HTML 렌더링 콜백 함수
        'my-first-plugin',
        'myfp_section',
        ['label_for' =&gt; 'myfp_footer_text']
    );
}
add_action('admin_init', 'myfp_settings_init');

// 텍스트 입력 필드 렌더링
function myfp_field_footer_text_html() {
    // 데이터베이스에 저장된 값 가져오기
    $value = get_option('myfp_footer_text');
    ?&gt;
    <input type="text" id="myfp_footer_text" name="myfp_footer_text" value="<?php echo esc_attr($value); ?>" class="regular-text">
    <p class="description">이 내용은 모든 기사의 끝에 표시될 것입니다.</p>
    &lt;?php
}

이제 WordPress 관리자 페이지를 새로고침하면 “설정” 메뉴에서 “내 플러그인 설정”을 찾을 수 있습니다. 해당 페이지로 이동하면 사용자 정의된 푸터 텍스트를 수정하고 저장할 수 있으며, 이 변경 사항은 홈페이지의 글 내용에도 자동으로 반영됩니다.

요약

이 가이드는 WordPress 플러그인 개발의 핵심 단계들을 안내합니다. 기본적인 헤더 정보를 포함하는 플러그인 파일을 생성하는 것부터, 액션(Action)과 필터(Filter) 핸들러를 사용하여 WordPress에 새로운 기능을 추가하는 방법, 옵션 API를 활용한 데이터 저장, 그리고 완성된 관리자 인터페이스 제작에 이르기까지의 전 과정을 다룹니다. 이 모든 과정은 WordPress의 모듈화된 개발 철학과 핸들러 기반의 구조를 잘 보여줍니다. 이러한 기초 지식을 익힌 후에는 사용자 정의 글 유형(Custom Post Types), 쇼트코드(Shortcodes), REST API 통합, AJAX 처리, 플러그인의 국제화(Internationalization)와 같은 보다 고급된 주제들을 탐구할 수 있습니다. 좋은 코드 구조, 안전한 데이터 처리, 그리고 명확한 사용자 인터페이스가 우수한 플러그인을 만드는 데 있어 핵심적인 요소라는 점을 기억하세요.

자주 묻는 질문

플러그인을 개발하기 위해서는 어떤 사전 지식이 필요한가요?

PHP 프로그래밍 언어에 대한 기본 지식이 필요합니다. 여기에는 변수, 함수, 조건문, 반복문과 같은 개념이 포함됩니다. 또한, HTML과 CSS에 대한 기본적인 이해가 있어야 전면적인 출력과 스타일을 처리할 수 있습니다. MySQL의 기본적인 작업 방법을 알면 데이터 저장을 이해하는 데 도움이 되지만, WordPress의 API가 대부분의 데이터베이스 인터랙션을 처리해 주기 때문에 반드시 필요한 것은 아닙니다.

개발 중인 플러그인을 어떻게 디버그할 수 있는가?

가장 효과적인 방법은 WordPress의 디버깅 모드를 활성화하는 것입니다.wp-config.php파일 내에서, 해당 내용을 처리할 것입니다.WP_DEBUG상수는 다음과 같이 정의됩니다:true이 설정을 통해 모든 PHP 오류, 경고, 및 알림이 화면에 표시됩니다. 또한, 필요에 따라 해당 정보를 사용할 수 있습니다.error_log()이 함수는 디버깅 정보를 서버의 오류 로그에 기록하거나, 브라우저의 개발자 도구(Developer Tools)에 있는 Console 및 Network 패널을 사용하여 프론트엔드를 디버깅합니다.

플러그인은 어떻게 다국어 지원을 구현할 수 있을까요?

WordPress는 다국어를 지원하기 위해 “국제화(i18n)” 및 “현지화(l10n)” 프로세스를 사용합니다. 플러그인 코드 내에서 번역이 필요한 모든 텍스트 문자열은 반드시 특정 규칙에 따라 표시되어야 합니다.__()또는_e()이러한 번역 함수들을 래핑 처리한 후, Poedit와 같은 도구를 사용하여 소스 코드에서 해당 문자열들을 추출하여 생성합니다..pot템플릿 파일을 사용하여 다양한 언어로 콘텐츠를 생성할 수 있습니다.zh_CN.po마지막으로, 플러그인의 메인 파일 상단에 있는 “Text Domain” 섹션에 자신의 텍스트 도메인을 선언하고, 초기화 과정에서 이를 사용해야 합니다.load_plugin_textdomain()Function loading.

개발한 플러그인을 공식 디렉터리에 어떻게 게시할 수 있을까요?

먼저, 플러그인이 WordPress 공식의 코딩 표준, 개인정보 보호 정책, 그리고 GPL 호환성 요구사항을 완전히 준수하고 있는지 확인해야 합니다. 그런 다음 WordPress.org에서 SVN 저장소를 신청하세요. 플러그인 코드(메인 파일, 리소스 파일, 번역 파일 포함)를 이 SVN 저장소에 업로드하시기 바랍니다./trunk목차. 새 버전은 SVN 태그를 사용하여 배포됩니다. 공식 목록은 사용자의 SVN 저장소에서 코드를 자동으로 동기화한 후, 사람의 검토를 거쳐 게시됩니다.

다음 단계는 무엇인가요?

만약 당신이 WordPress 웹사이트를 구축하거나 최적화하고 있다면, 성능 최적화, 플러그인 구성, 테마 사용자 정의와 관련된 내용을 계속 읽는 것이 좋습니다.

확장된 독서 및 실무 지식

다음은 이 도움말의 주제와 관련이 있으며 더 깊이 있게 읽기에 적합합니다. 현재 문제와 가장 가까운 문서부터 시작하여 점차 주변 주제로 확장하는 것이 우선순위를 정하는 것이 좋습니다.

태그.