WordPress 플러그인 개발 입문 가이드: 제로 베이스에서 전문 기능 모듈 구축까지

워드프레스 플러그인 개발을 위한 기본 지식

첫 번째 코드를 쓰기 전에 WordPress 플러그인의 기본 개념과 필요한 기술 스택을 이해하는 것이 매우 중요합니다. WordPress 플러그인은 기본적으로 특정 구조와 규칙을 따르는 PHP 파일 집합이며, 이는 일련의 단계를 통해 구현됩니다.hook钩子(Hook)는 WordPress 核心과 상호 작용하여 웹사이트의 기능을 확장하거나 수정할 수 있습니다.

필요한 기본 지식은 다음과 같습니다: PHP 언어에 대한 기본적인 이해, 함수, 변수 및 기본 문법을 이해할 수 있어야 합니다. HTML과 CSS에 대한 지식이 있어야 하며, 플러그인의 프론트 엔드 인터페이스를 구축하는 데 도움이 됩니다. JavaScript에 대한 지식이 있어서 대화식 로직을 처리하는 데 도움이 될 것입니다. 또한, WordPress의 핵심 개념에 대한 이해도 필요합니다.action(동작) 그리고filter필터는 플러그인 개발의 핵심입니다. 액션은 특정 시점에 코드를 실행할 수 있게 해주고, 필터는 WordPress나 다른 플러그인에서 생성된 데이터를 수정할 수 있게 해 줍니다.

개발 환경 설정은 첫 번째 단계입니다. 로컬 컴퓨터에 PHP 개발 환경을 설정해야 하며, XAMPP, MAMP 또는 Local by Flywheel을 사용하는 것이 좋습니다. Visual Studio Code 또는 PhpStorm 같은 코드 편집기를 설치하면 코드 하이라이트 및 디버깅에 매우 도움이 됩니다. 마지막으로, 테스트를 위한 WordPress 설치가 되어 있는지 확인하십시오.

추천 읽기 워드프레스 플러그인 개발을 위한 궁극의 가이드: 핵심 원칙과 실용적인 프로젝트 마스터하기。

첫 번째 WordPress 플러그인을 만들어 보세요.

플러그인의 기본 구조와 활성화 프로세스를 이해하는 데 도움이 되는 가장 간단한 “Hello World” 플러그인을 만들어 보자면, 시작하실 수 있을 것입니다.

UltaHost의 WordPress 호스팅 서비스

30일 환불 보장, 무제한 대역폭 및 데이터베이스 이용, 무료 DDoS 보호 서비스 제공. 3년 구매 시 50% 용량이 할인됩니다.

액세스 페이지

먼저, WordPress에서…wp-content/plugins카테고리 아래에서 새 폴더를 만들고 이름을 지정하십시오.my-first-plugin이 폴더 내에, 주요 PHP 파일을 만들어 주세요. 일반적으로 이 파일은 폴더와 같은 이름을 가지고 있으며, 그 이름은my-first-plugin.php。

각 플러그인에는 WordPress에 플러그인의 메타 정보를 제공하기 위한 표준 플러그인 헤더 주석이 있어야 합니다. 열기my-first-plugin.php파일을 열고 아래 코드를 입력하세요:

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

파일을 저장한 후 WordPress 관리자의 “플러그인” 페이지에서 “제 첫 번째 플러그인'이 플러그인 목록에 나타나야 합니다. 이 때 플러그인을 활성화할 수 있지만, 아직 어떠한 기능도 제공하지 않습니다.

다음으로, 플러그인에 간단한 기능을 추가해 보자. 웹사이트의 관리 페이지에 환영 메시지를 표시하는 것이다. 우리는admin_notices이 동작 후크. 플러그인 헤더 주석 아래에 다음 코드를 추가하세요:

추천 읽기 워드프레스 플러그인 개발, 입문서부터 전문가용까지: 첫 번째 기능 플러그인을 만들어보세요.。

function my_first_plugin_admin_notice() {
    echo '<div class="notice notice-success is-dismissible"><p>제 첫 번째 플러그인을 사용해 주셔서 환영합니다!</p></div>';
}
add_action( 'admin_notices', 'my_first_plugin_admin_notice' );

파일을 저장하고 WordPress 관리자를 새로 고치면, 페이지 상단에 녹색 성공 알림 창이 나타납니다. 이제 첫 번째 기능 플러그인을 성공적으로 만들고 활성화했습니다.

워드프레스의 핵심 메커니즘을 이해하기: 후크(hook)와 API(application programming interface)

워드프레스의 유연성과 강력한 확장성은 대부분 후크 시스템과 풍부한 API 덕분입니다. 이 두 가지를 잘 이해하는 것은 전문적인 플러그인 개발의 열쇠입니다.

후크는 두 가지 유형으로 나뉩니다. 동작 후크와 필터입니다. 동작 후크는 게시물을 발행할 때와 같이, 특정 WordPress 核心 이벤트가 발생할 때 트리거됩니다.publish_post또는 관리 백엔드를 로드하십시오.admin_init당신은 ( )을 사용할 수 있습니다.add_action()함수는 이러한 지점에 “당신의 사용자 정의 함수'를 매핑합니다. 예를 들어, 우리는 방금 이곳에 그랬습니다.admin_notices알림을 표시하는 함수가 상단에 설치되어 있습니다.

호스팅닷컴 공유 호스팅

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

액세스 페이지

필터 후크는 데이터를 수정하는 데 사용됩니다. 데이터가 데이터베이스에 저장되거나 브라우저에 출력되기 전에 데이터를 수정할 수 있게 해 줍니다. 사용하려면add_filter()필터를 추가하는 함수. 일반적인 예로는 글의 끝 부분의 내용을 수정하는 것이 있습니다.

function my_content_filter( $content ) {
    if ( is_single() ) {
        $content .= '<p><em>이 글은 제 플러그인에 의해 추가된 서명입니다.</em></p>';
    }
    return $content;
}
add_filter( 'the_content', 'my_content_filter' );

후크 시스템 외에도, 워드프레스는 보안적이고 편리하게 핵심 기능과 상호 작용할 수 있도록 다양한 API를 제공합니다. 예를 들면,
* 옵션 API: 사용하기add_option(), get_option(), update_option()플러그인의 구성 데이터를 안전하게 저장하고 읽을 수 있습니다.
* API 설정: “설정” 페이지나 자신의 플러그인 페이지에서 표준화된 보안 인증이 된 양식 필드를 만들 수 있습니다.
* 데이터베이스 API: 통해서$wpdb글로벌 객체는 사용자 정의 데이터베이스 질의를 안전하게 수행합니다.
* REST API: 외부 애플리케이션에서 사용할 수 있는 플러그인 API 엔드포인트를 만들어 현대적이고 대화식 기능을 구축할 수 있는 기반입니다.

백그라운드 인터페이스가 있는 전문 플러그인을 만들기

완전히 기능적인 플러그인은 일반적으로 웹사이트 관리자가 매개 변수를 설정할 수 있는 구성 페이지가 필요합니다. 우리는 간단한 플러그인 백엔드 페이지를 만들고 설정 옵션을 저장할 것입니다.

추천 읽기 WordPress 웹사이트 성능 최적화 최고 가이드: 로딩 속도와 사용자 경험 향상을 위한 완전한 솔루션。

먼저, 사용하기 위해…add_action()함수를 마운트하려면admin_menu메뉴 항목을 추가하려면 후크를 사용하세요. 그런 다음 두 개의 함수를 만들어야 합니다. 하나는 설정 페이지 양식을 표시하는 함수이고 다른 하나는 양식 제출 및 데이터 유효성 검사를 처리하는 함수입니다.

아래는 최상위 관리 메뉴와 간단한 양식을 만들는 예입니다:

InterServer 공유 호스팅

공유 호스팅 월 $2.50 USD, 첫 달 $0.1 USD 프로모션 코드 tryinterserver, 461개 클라우드 앱 스크립트, 원클릭 설치.

액세스 페이지

메뉴 항목을 관리 후방에 추가하기
function my_plugin_add_menu_page() {
    add_menu_page(
        '내 플러그인 설정',   // 페이지 타이틀
        '내 플러그인',   // 메뉴 타이틀
        'manage_options',   // 필요한 권한
        'my-plugin-settings',   // 메뉴 별명
        'my_plugin_settings_page',   // 표시 페이지의 콜백 함수
        'dashicons-admin-generic',   // 아이콘
        100   // 메뉴 위치
    );
}
add_action( 'admin_menu', 'my_plugin_add_menu_page' );

// 단계 2: 설정 페이지의 내용 정의
function my_plugin_settings_page() {
    // 사용자 권한을 확인합니다
    if ( !current_user_can( 'manage_options' ) ) {
        wp_die( __( '이 페이지에 접근할 권한이 없습니다.' ) );
    }

// 서브미트 처리 (옵션 저장이 아님)
    if (isset( $_POST['my_plugin_greeting'] )) {
        check_admin_referer( 'my_plugin_save_settings' ); // 보안 확인
        $$greeting = sanitize_text_field( $_POST['my_plugin_greeting'] );
        update_option( 'my_plugin_greeting_text', $$greeting );
        echo '<div class="notice notice-success"><p>설정이 저장되었습니다!</p></div>';
    }

// 获取已保存的值
    $saved_greeting = get_option( 'my_plugin_greeting_text', '你好，世界！' );
    ?&gt;
    <div class="wrap">
        <h1>My plugin settings</h1>
        <form method="post" action="">
            \n
            <table class="form-table">
                <tr>
                    <th scope="row"><label for="greeting">인사말</label></th>
                    <td><input name="my_plugin_greeting" type="text" id="greeting" value="<?php echo esc_attr( $saved_greeting ); ?>" class="regular-text"></td>
                </tr>
            </table>
            저장 버튼을 추가하려면 다음 코드를 사용하세요:
        <input type="hidden" name="trp-form-language" value="ko"/></form>
    </div>
    &lt;?php
}

이 예제는 간단한 설정 페이지를 만드는 방법을 보여줍니다.update_option그리고get_option데이터를 저장하고 읽기 위해 그리고 사용되었습니다.sanitize_text_field그리고wp_nonce_field보안을 위해 이 코드를 사용하십시오. 더 복잡한 설정의 경우, WordPress의 Settings API를 사용하는 것이 좋습니다. Settings API는 자동으로 보안 인증과 필드 렌더링을 처리할 수 있습니다.

요약

워드프레스 플러그인 개발은 核心 개념(예: 후크 및 API)을 이해하는 것으로 시작하여, 기능 모듈을 구축하는 과정입니다. 간단한 “Hello World” 플러그인부터 시작하여, 플러그인 구조에 대한 기본 지식을 습득할 것입니다. 액션 및 필터에 대한 이해가 깊어지면서, 워드프레스 라이프사이클의 각 단계에 사용자 정의 기능을 정확하게 추가할 수 있게 됩니다. 마지막으로, 백엔드 관리 인터페이스를 만들고 옵션 API, 설정 API 등 도구를 사용하여, 플러그인은 전문적인 수준의 구성 가능성과 보안성을 갖게 됩니다. 지속적인 학습과 실습이 이 기술을 마스터하는 열쇠이며, 각 코드 작성은 워드프레스의 방대한 생태계에 대한 더 깊은 탐색입니다.

자주 묻는 질문

WordPress 플러그인을 개발하려면 PHP에 대한 전문 지식이 필요한가요?

당신은 처음부터 PHP 전문가가 되는 필요는 없지만, 변수, 함수, 배열, 조건문 및 루프를 이해하는 등 단牢한 PHP 기반 지식이 필요합니다. 개발을 진행함에 따라 객체 지향 프로그래밍 및 WordPress 전용 PHP 함수에 자연스럽게 노출되게 됩니다. 플러그인 개발을 배우는 동안 PHP 지식을 동시에 강화시키는 것이 좋습니다.

어떻게 하면 제가 개발한 플러그인이 안전하다고 확신할 수 있을까요?

플러그인의 보안이 매우 중요합니다. 항상 사용자 입력을 검증하고 정리하며, 다음과 같은 방법을 사용하십시오.sanitize_text_field()、esc_html()、esc_url()함수 등. 데이터베이스에 대한 사용자 정의 쿼리를 실행할 때 사용합니다.$wpdb->prepare()SQL 인젝션을 방지하기 위해서는 서식 제출이나 AJAX 요청을 처리할 때 꼭 이 방법을 사용해야 합니다.wp_nonce인증을 위한 (안전한 난수). “최소 권한 원칙'을 준수하며 사용하십시오.current_user_can()사용자 권한을 확인하세요.

플러그인을 디버그하고 테스트하려면 어떻게 해야 하나요?

우선 로컬 개발 환경이나 스테이징(테스트) 사이트에서 테스트를 실시하고, 생산 환경에서 직접 디버깅을 하지 마십시오. 활성화하세요.WP_DEBUG패턴은 여기에서 찾을 수 있습니다.wp-config.php파일에 설정 내용이 저장되어 있습니다.define( ‘WP_DEBUG’, true );그러면 오류와 경고가 화면에 표시됩니다. 사용하세요.error_log()함수는 서버의 오류 로그에 디버그 정보를 기록합니다. 복잡한 로직의 경우에는 Xdebug 같은 전문 디버그 도구를 사용할 수 있습니다.

내 플러그인을 공식 WordPress 플러그인 디렉토리에 제출하는 방법은 무엇입니까?

당신의 플러그인 코드는 GPL v2 또는 그 이상의 라이센스를 준수해야 합니다. 코드의 품질, 보안 및 주석이 표준에 준수되어야 합니다. WordPress.org에 방문하여 계정을 생성한 후 플러그인을 제출하여 검토를 받아야 합니다. 검토 과정에서는 코드 표준, 보안, 부적합한 내용 등이 확인됩니다. 승인되면, 전 세계의 사용자들이 다운로드할 수 있도록 SVN 도구를 통해 공식 디렉토리에 코드를 호스팅해야 합니다.