핵심 개념과 준비 작업 (Core Concepts and Preparation Work)
WordPress 플러그인 개발이란 WordPress의 기본 기능을 넘어서서 독립적인 PHP 코드 모듈을 작성하여 웹사이트의 기능을 확장하고 향상시키는 것을 의미합니다. 그 작동 원리를 이해하는 것이 성공의 첫걸음입니다. WordPress는 이벤트 기반의 프로그래밍 방식(후크 및 필터)과 객체 지향 프로그래밍 패러다임을 사용합니다. 플러그인은 본질적으로 하나 이상의 PHP 파일로 구성되며, WordPress가 미리 정의한 인터페이스를 통해 코어와 상호작용함으로써 안전하게 기능을 추가할 수 있습니다.
개발을 시작하기 전에, 안정적인 로컬 또는 테스트 서버 환경이 필요합니다. XAMPP, Local by Flywheel, DevKinsta와 같은 로컬 서버 소프트웨어를 설치하는 것을 강력히 권장합니다. 또한, 코드 편집기(예: VS Code 또는 PhpStorm)를 준비하고 WordPress의 디버깅 모드를 활성화해야 합니다. 이 모든 설정은 개발 과정에서 필수적입니다.wp-config.php파일에 몇 가지 상수를 설정합니다:
define( ‘WP_DEBUG’, true );
define( ‘WP_DEBUG_LOG’, true );
define( ‘WP_DEBUG_DISPLAY’, false );활성화WP_DEBUG_LOG그 후, 오류 메시지가 기록됩니다./wp-content/debug.log이 정보는 파일 내에서 문제를 조사하는 데 매우 중요합니다.
추천 읽기 워드프레스 테마 개발 고급 가이드: 입문서부터 전문가용 실용 가이드까지。
첫 번째 플러그인을 만들어 보세요.
플러그인을 만들기 위해서는 먼저 기본적인 개념과 구조를 이해하는 것이 중요합니다. 플러그인은 원래의 소프트웨어(예: 웹 브라우저, 프로그램, 시스템)에 추가 기능을 제공하기 위해 만들어진 작은 모듈입니다. 다음은 플러그인을 만드는 과정을 간단히/wp-content/plugins/디렉터리 내에 전용 폴더를 하나 만드세요. 예를 들어, `my_project`라는 이름의 폴더를 만들 수 있습니다.my-first-plugin이 폴더 안에는 주 PHP 파일을 만들어야 합니다. 파일 이름은 보통 폴더 이름과 동일합니다. 예를 들어,my-first-plugin.php。
플러그인의 헤더 정보를 작성하세요.
모든 WordPress 플러그인에는 표준적인 플러그인 헤더 주석이 필요합니다. 이 주석은 WordPress가 플러그인을 인식하는 데 사용되는 “신분증”과 같은 역할을 합니다. 이 주석은 메인 파일의 시작 부분에 있어야 하며, 특정 형식을 따라야 합니다.Plugin Name기타 정보들, 예를 들어 설명, 버전, 저자 등도 매우 중요합니다.
<?php
/**
* Plugin Name: 我的第一个插件
* Plugin URI: https://example.com/my-first-plugin
* Description: 这是一个用于学习WordPress插件开发的示例插件。
* Version: 1.0.0
* Author: 你的名字
* Author URI: https://example.com
* License: GPL v2 or later
* Text Domain: my-first-plugin
* Domain Path: /languages
*/이 주석을 추가하면 귀하의 플러그인이 WordPress 관리자의 “플러그인” 목록에 표시되며, 위에 언급된 정보도 함께 보여집니다.Text Domain그리고Domain Path이것은 플러그인의 국제화(번역)를 위해 준비된 것입니다.
기본 기능을 구현합니다.
이제 플러그인에 간단한 기능을 추가해 보겠습니다: 글 내용의 하단에 사용자 정의 텍스트를 자동으로 추가하는 기능입니다. 이를 위해서는 WordPress의 “필터”(Filter)를 사용해야 합니다. 필터를 사용하면 데이터가 데이터베이스에 저장되거나 브라우저에 출력되기 전에 그 데이터를 수정할 수 있습니다.
우리는 사용할 것입니다.the_content이 필터에 대해, 주 플러그인 파일의 맨 위에 있는 주석 다음에 다음 코드를 추가하세요:
추천 읽기 워드프레스 플러그인 개발 궁극 가이드: 제로부터 시작해 첫 번째 플러그인 만들기。
// 在文章内容末尾添加自定义文本
function myfp_add_text_to_content( $content ) {
if ( is_single() && in_the_loop() && is_main_query() ) {
$custom_text = ‘<p><em>이 글을 읽어주셔서 감사합니다! “My First Plugin”이 제공하는 지원을 받아 이 글을 작성하였습니다.</em></p>’;
$content .= $custom_text;
}
return $content;
}
add_filter( ‘the_content’, ‘myfp_add_text_to_content’ );파일을 저장한 후, WordPress 관리자에 접속하여 이 플러그인을 활성화하세요. 개별 글을 확인할 때 콘텐츠의 끝부분에 추가된 텍스트를 볼 수 있을 것입니다.myfp_add_text_to_content이것은 우리가 정의한 함수로, 기사의 내용을 입력으로 받습니다.$content조건(단일 기사이며, 메인 루프 내에 있는 경우)이 만족되면 특정 텍스트를 추가한 후, 수정된 내용을 반환합니다.add_filter()함수는 이 사용자 정의 함수를the_content필터 위에.
후크와 필터를 사용하여 상호작용을 구축합니다.
WordPress 플러그인의 강력한 점은 바로 풍부한 훅 시스템에 있습니다. 이 훅 시스템은 액션 훅(Action Hooks)과 필터 훅(Filter Hooks)으로 나뉩니다. 액션 훅을 사용하면 특정 시점에 코드를 실행할 수 있으며, 필터 훅을 사용하면 데이터를 수정할 수 있습니다.
액션 후크를 사용하여 관리 메뉴를 추가합니다.
가정해 보겠습니다. 플러그인에 설정 페이지를 추가하고 싶은데, 이를 위해서는 액션 후크(Action Hook)를 사용해야 합니다.admin_menu이 기능은 WordPress의 백엔드 관리 메뉴가 구성될 때 활성화됩니다.
// 添加插件设置页面到后台菜单
function myfp_add_admin_menu() {
add_menu_page(
‘我的插件设置’, // 页面标题
‘我的插件’, // 菜单标题
‘manage_options’, // 权限要求
‘myfp-settings’, // 菜单slug
‘myfp_settings_page’, // 用于显示页面内容的回调函数
‘dashicons-admin-generic’, // 图标（可选）
80 // 菜单位置
);
}
add_action( ‘admin_menu’, ‘myfp_add_admin_menu’ );
// 定义设置页面的显示内容
function myfp_settings_page() {
?>
<div class="“wrap”">
<h1><?php esc_html_e( ‘我的插件设置’, ‘my-first-plugin’ ); ?></h1>
<p><?php esc_html_e( ‘这是你的第一个插件设置页面。’, ‘my-first-plugin’ ); ?></p>
<form method="“post”" action="/ko/“options.php”/" data-trp-original-action="“options.php”">
<?php
// 后续可以在这里添加设置字段
settings_fields( ‘myfp_settings_group’ );
do_settings_sections( ‘myfp-settings’ );
submit_button();
?>
<input type="hidden" name="trp-form-language" value="ko"/></form>
</div>
<?php
}플러그인을 활성화하면, 백그라운드의 왼쪽에 “내 플러그인”이라는 새로운 메뉴 항목이 나타납니다. 이 메뉴를 클릭하면 사용자 정의 설정 페이지로 이동할 수 있습니다.add_menu_page함수가 핵심적인 역할을 합니다; 이 함수는 최상위 메뉴 페이지를 등록합니다.
단축 코드를 생성하여 페이지 기능을 향상시킵니다.
쇼트코드(Shortcode)는 사용자가 글이나 페이지에서 플러그인 기능을 쉽게 호출할 수 있도록 해주는 강력한 도구입니다. 여러분도 이를 활용할 수 있습니다.add_shortcode()숏코드를 등록하는 함수.
// 创建一个显示当前时间的短代码
function myfp_current_time_shortcode( $atts ) {
// 使用 shortcode_atts 设置默认属性并合并用户输入
$attributes = shortcode_atts( array(
‘format’ => ‘Y-m-d H:i:s’,
), $atts );
// 根据属性格式化当前时间
$current_time = date( $attributes[‘format’] );
// 返回要显示的内容，确保进行转义
return ‘<p>현재 시간은: ’ . esc_html($current_time) . ‘</p>’php
add_shortcode( ‘show_time’, ‘myfp_current_time_shortcode’ );이제 사용자는 기사 편집기에서 내용을 입력할 수 있습니다.[show_time format=“F j, Y”]형식화된 현재 날짜를 표시합니다. 쇼트코드 프로세서를 사용합니다.myfp_current_time_shortcode수신한 속성 배열을 받아, 페이지에 삽입해야 할 HTML 콘텐츠를 반환합니다.
추천 읽기 처음부터 끝까지 워드프레스 플러그인 개발: 개인화된 웹사이트 제작을 위한 완벽한 가이드。
플러그인 보안 및 모범 사례
플러그인을 개발할 때 보안은 가장 우선적으로 고려해야 할 요소입니다. 안전하지 않은 코드는 웹사이트가 공격을 받을 수 있는 원인이 될 수 있습니다. 따라서 다음과 같은 모범 사례를 준수하는 것이 매우 중요합니다.
데이터 검증, 이스케이피(Escape), 및 정리
모든 사용자나 외부 소스에서 제공되는 데이터 (예:$_GET， $_POST， $_COOKIE이 모든 데이터는 신뢰할 수 없습니다. 데이터베이스 쿼리에 사용하거나 브라우저에 출력하기 전에 반드시 처리해야 합니다.
- 브라우저에 데이터를 출력할 때는 이스케이프 함수를 사용해야 합니다. 이를 통해 데이터가 순수 텍스트 형태로 표시되도록 하여 XSS 공격을 방지할 수 있습니다. WordPress는 다양한 상황에 맞게 여러 가지 이스케이프 함수를 제공합니다.
esc_html()(HTML 요소 내에서 사용됨)esc_attr()(HTML 속성 내에서 사용됨)esc_url()(URL용) 그리고wp_kses_post()(안전한 HTML 태그의 사용은 허용됩니다.) - 데이터베이스와 상호작용할 때는 예비 문장(prepared statements)을 사용하세요. 절대로 변수를 SQL 쿼리에 직접 결합하지 마세요. 대신 예비 문장을 사용하는 것이 안전하고 추적 가능한 방법입니다.
$wpdb->prepare()메서드나 더 고급스러운 API들과 같은 것들입니다.WP_Query예를 들어:
global $wpdb;
$user_id = 123;
$safe_query = $wpdb->prepare( “SELECT * FROM {$wpdb->prefix}posts WHERE post_author = %d”, $user_id );
$results = $wpdb->get_results( $safe_query );여기%d이것은 단지 ‘점유자’를 나타내는 임시 표시자(%s)입니다. 실제 내용은 나중에 채워질 예정입니다.$wpdb->prepare()안전하게 처리될 것입니다.$user_id변수.
Implementing option settings and security measures
플러그인에 설정 옵션을 추가할 때는 WordPress Settings API를 사용해야 합니다. 이 API는 Nonce 검증, 권한 확인, 설정 저장 등의 과정을 자동으로 처리해주므로 보안 프로세스를 크게 간소화해줍니다.
먼저, 사용하기 위해…register_setting()등록한 설정 옵션 그룹을 사용하세요.add_settings_section()그리고add_settings_field()필드를 추가하려면, 이전에 생성한 관리 메뉴 콜백 함수를 수정해야 합니다.myfp_settings_page중간에 호출된settings_fields( ‘myfp_settings_group’ )그리고do_settings_sections( ‘myfp-settings’ )모든 필수 보안 정보와 등록 설정이 자동으로 출력됩니다. 이 방식이 수동으로 처리하는 것보다 훨씬 편리합니다.$_POST데이터는 훨씬 더 안전하고 신뢰할 수 있어야 합니다.
요약
간단한 플러그인의 헤더 주석을 작성하는 것부터 시작하여, 액션(Action)과 필터(Filter) 후크를 사용해 WordPress 코어와 상호작용하는 방법을 익히고, 쇼트코드(Shortcode)를 만들고 관리 페이지를 구성하는 과정까지, 플러그인 개발의 핵심 단계들을 모두 거치셨습니다. 항상 보안을 최우선으로 생각하며 데이터에 대한 엄격한 검증, 엔코딩 처리, 그리고 데이터 정리를 실시하세요. 또한 WordPress가 제공하는 Settings API와 같은 보안 도구들을 적극적으로 활용하시기 바랍니다. 플러그인 개발은 지속적인 학습의 과정이므로, 코어 코드를 읽고, 공식 문서를 참고하며, 커뮤니티에 참여함으로써 기능이 풍부하고 안전하며 많은 사람들에게 사랑받는 WordPress 플러그인을 만들 수 있을 것입니다.
자주 묻는 질문
플러그인 개발을 하려면 반드시 PHP에 능통해야 하나요?
네, 탄탄한 PHP 기초는 필수적입니다. 왜냐하면 WordPress 자체가 PHP로 작성되었기 때문입니다. PHP 문법, 함수, 클래스, 네임스페이스 등의 개념을 이해해야 합니다. 또한 HTML, CSS, JavaScript에 대한 기본적인 지식도 프론트엔드 기능을 개발하는 데 매우 도움이 됩니다.
내 플러그인 코드를 어떻게 디버깅하나요?
가장 효과적인 방법은 앞서 언급된 내용을 활성화하는 것입니다.WP_DEBUG、WP_DEBUG_LOG그리고WP_DEBUG_DISPLAY또한, 다음과 같은 방법을 사용할 수 있습니다:error_log()이 함수는 사용자 정의된 디버깅 정보를 로그에 기록하거나, Xdebug와 같은 전문적인 디버깅 도구를 사용하여 코드 편집기와 연동하여 줄별로 디버깅을 수행합니다.
어떻게 하면 제 플러그인에 언어 번역 기능을 추가할 수 있을까요?
먼저, 플러그인의 헤더 부분에 있는 주석에서 설정을 올바르게 해야 합니다.Text Domain(예: ‘my-first-plugin’)와Domain Path(예: ‘/languages’). 그런 다음, 코드 내에서 번역이 필요한 모든 문자열이 있는 곳에 비슷한 방식을 사용하세요.__( ‘Hello World’, ‘my-first-plugin’ )또는esc_html_e( ‘Settings’, ‘my-first-plugin’ )‘의’ 번역 함수입니다. 마지막으로, Poedit와 같은 도구를 사용하여 결과를 생성합니다..pot템플릿 파일을 사용하여 다양한 언어로 콘텐츠를 생성할 수 있습니다..po그리고.mo변환된 파일을 지정된 위치에 저장하세요./languages카테고리 아래에.
개발한 플러그인을 WordPress 공식 디렉터리에 어떻게 게시하나요?
WordPress 공식 플러그인 디렉터리에 플러그인을 제출하려면 해당 페이지에 접속해야 합니다. 제출하기 전에, 코드가 WordPress의 코딩 표준을 준수하고 있으며 상세한 문서와 주석이 포함되어 있는지 확인하십시오. 또한, 제3자의 상업용 라이브러리를 사용했다면 그에 따른 저작권 문제가 없는지도 반드시 확인해야 합니다. 제출 후에는 심사 과정이 진행되며, 심사를 통과하면 해당 플러그인을 전 세계 사용자들이 검색하고 설치할 수 있게 됩니다.
다음 단계는 무엇인가요?
확장된 독서 및 실무 지식
다음은 이 도움말의 주제와 관련이 있으며 더 깊이 있게 읽기에 적합합니다. 현재 문제와 가장 가까운 문서부터 시작하여 점차 주변 주제로 확장하는 것이 우선순위를 정하는 것이 좋습니다.
한국어