WordPress 플러그인은 웹사이트 기능을 확장하는 데 핵심적인 역할을 합니다. 플러그인을 사용하면 모듈화된 방식으로 새로운 기능을 추가할 수 있으며, WordPress의 핵심 코드를 수정할 필요가 없습니다. 자신만의 플러그인을 개발함으로써 특정 요구사항에 맞게 완전히 맞춤화된 기능을 구현할 수 있으며, 다른 테마 및 플러그인과의 호환성도 유지할 수 있습니다. 이 가이드는 기능이 완전하고 구조가 규격에 맞는 WordPress 플러그인을 만드는 전 과정을 안내해 줄 것입니다.
WordPress 플러그인의 기본 구조와 규격
표준적인 WordPress 플러그인은 특정 파일 구조와 규칙을 준수해야 합니다. 이를 통해 WordPress 시스템에 의해 올바르게 인식되고, 안전하게 작동하며, 유지보수가 용이해집니다.
플러그인의 메인 파일을 생성합니다.
모든 플러그인은 반드시 하나의 주 PHP 파일을 가지고 있어야 하며, 이 파일의 이름은 일반적으로 플러그인 디렉터리의 이름과 동일합니다. 이 파일의 시작 부분에는 특정한 플러그인 정보를 담은 헤더 주석이 포함되어야 합니다. WordPress는 이 주석을 통해 플러그인을 인식합니다.
추천 읽기 워드프레스 플러그인 개발에 대한 심층 분석: 입문서부터 효율적인 사용자 정화까지。
플러그인 디렉터리 내에 ‘’라는 이름의 파일을 생성하세요. my-first-plugin.php 해당 파일에 다음과 같은 헤더 정보를 추가하세요:
<?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
*/보안 모범 사례를 준수하세요.
모든 플러그인 코드는 직접적인 접근을 방지하기 위해 보안 검사에 포함되어야 합니다. 또한, 모든 함수, 클래스, 상수에는 고유한 접두사를 사용하여 테마나 다른 플러그인과의 충돌을 피해야 합니다.
플러그인의 메인 파일에서는 헤더 부분의 주석 바로 뒤에 보안 보호 코드를 추가해야 하며, 고유한 접두사(예: `security_`)를 사용해야 합니다. mfp_이 함수의 이름을 다음과 같이 지정하세요:
// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
// 使用唯一前缀定义一个函数
function mfp_display_greeting() {
echo '<p>안녕하세요, 제 첫 번째 플러그인을 사용해 주셔서 감사합니다!</p>';
}Implement the core functions: actions and filters.
WordPress의 핵심 확장 메커니즘은 ‘후크(Hooks)’에 기반을 두고 있으며, 이 후크는 ‘액션(Action)’과 ‘필터(Filter)’로 나뉩니다. 이러한 후크들을 이해하고 올바르게 사용하는 것이 플러그인 개발의 핵심입니다.
액션 훅을 사용하여 기능을 추가합니다.
액션 훅(Action Hook)을 사용하면 특정 시점이나 이벤트가 발생할 때 자신의 코드를 실행할 수 있습니다. 예를 들어, 페이지 하단에 텍스트를 추가하려면 이 기능을 활용할 수 있습니다. wp_footer 액션.
추천 읽기 워드프레스 플러그인 개발: 기능 개발부터 완성까지의 단계별 가이드。
이전에 정의한 함수를 해당 위치에 마운트하세요. wp_footer 훅에 걸려 있어요:
// 将函数挂载到 wp_footer 动作钩子
add_action( 'wp_footer', 'mfp_display_greeting' );이렇게 하면 WordPress가 페이지의 푸터(footer) 부분을 처리할 때 해당 함수가 호출됩니다. mfp_display_greeting 함수: 인사말을 출력합니다.
필터 후크를 사용하여 콘텐츠를 수정합니다.
필터 후크는 데이터를 수정하는 데 사용됩니다. 이 후크들은 하나의 값을 받아 처리한 후 다시 반환합니다. 예를 들어, 기사 제목의 기본 접미사를 수정하려면 이 후크를 사용할 수 있습니다. the_title 필터.
기사 제목을 수정하는 함수를 만들고, 그 함수를 필터에 추가하세요:
// 定义一个函数来修改文章标题
function mfp_modify_title( $title, $id = null ) {
// 仅在前端修改非管理员页面的标题
if ( ! is_admin() && in_the_loop() ) {
$title .= ' - 来自我的插件';
}
return $title;
}
// 将函数挂载到 the_title 过滤器钩子，参数3是优先级，参数4是接受的参数个数
add_filter( 'the_title', 'mfp_modify_title', 10, 2 );플러그인 관리 인터페이스를 구축합니다.
대부분의 플러그인은 웹사이트 관리자가 플러그인 설정을 구성할 수 있도록 백엔드 설정 페이지가 필요합니다. WordPress는 표준적인 관리 메뉴와 양식을 생성하기 위한 다양한 API를 제공합니다.
플러그인 설정 페이지를 생성하세요.
활용 add_menu_page() 또는 add_options_page() 이 함수를 사용하면 플러그인에 관리 페이지를 추가할 수 있습니다. 일반적으로 이 페이지는 “설정” 메뉴 내에 위치합니다.
추천 읽기 워드프레스 플러그인 개발을 처음부터 배우기: 원리, 실습 및 고급 기술。
Create a function to register and manage menus, and then mount them to... admin_menu Action:
// 添加插件设置页面到后台菜单
function mfp_add_admin_menu() {
add_options_page(
'我的第一个插件设置', // 页面标题
'我的插件设置', // 菜单标题
'manage_options', // 权限要求
'my-first-plugin', // 菜单slug
'mfp_render_settings_page' // 用于渲染页面的回调函数
);
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );
// 渲染设置页面的回调函数
function mfp_render_settings_page() {
?>
<div class="wrap">
<h1>제 첫 번째 플러그인 설정입니다.</h1>
<form action="/ko/options.php/" method="post" data-trp-original-action="options.php">
<?php
settings_fields( 'mfp_settings_group' );
do_settings_sections( 'my-first-plugin' );
submit_button();
?>
<input type="hidden" name="trp-form-language" value="ko"/></form>
</div>
<?php
}등록 및 설정 옵션 처리
WordPress의 설정 API를 사용하면 옵션의 등록, 검증, 저장을 안전하게 처리할 수 있습니다. 설정 필드와 섹션을 정의한 후, 데이터를 저장하기 위한 처리 함수를 사용해야 합니다.
플러그인의 메인 파일에 다음 코드를 추가하여 설정을 등록하세요:
// 初始化插件设置
function mfp_settings_init() {
// 注册一个新的设置组和选项
register_setting( 'mfp_settings_group', 'mfp_settings', 'mfp_sanitize_settings' );
// 在插件设置页面添加一个节
add_settings_section(
'mfp_section_basic',
'基本设置',
null,
'my-first-plugin'
);
// 向节中添加一个字段
add_settings_field(
'mfp_greeting_text',
'问候语文本',
'mfp_greeting_text_render',
'my-first-plugin',
'mfp_section_basic'
);
}
add_action( 'admin_init', 'mfp_settings_init' );
// 渲染问候语文本输入字段
function mfp_greeting_text_render() {
$options = get_option( 'mfp_settings' );
$value = isset( $options['greeting_text'] ) ? $options['greeting_text'] : '你好，世界！';
echo '<input type="text" name="mfp_settings[greeting_text]" value="' . esc_attr( $value ) . '" class="regular-text">';
}
// 清理和验证设置输入
function mfp_sanitize_settings( $input ) {
$sanitized = [];
if ( isset( $input['greeting_text'] ) ) {
$sanitized['greeting_text'] = sanitize_text_field( $input['greeting_text'] );
}
return $sanitized;
}플러그인의 국제화 및 배포 준비
플러그인을 전 세계 사용자들이 사용할 수 있도록 하고 최종적으로 출시하기 위해서는 국제화 작업과 코드 최적화가 필요합니다.
텍스트의 국제화를 구현하는 방법입니다.
WordPress를 사용하는 경우 __()、_e() 등의 함수를 사용하여 모든 번역이 필요한 텍스트 문자열을 래핑하고, 텍스트 필드를 올바르게 로드합니다.
당신의 출력 함수를 수정하여 번역 기능을 지원하도록 만드세요.
function mfp_display_greeting() {
$options = get_option( ‘mfp_settings’ );
$greeting = isset( $options[‘greeting_text’] ) ? $options[‘greeting_text’] : __( ‘你好，世界！’, ‘my-first-plugin’ );
echo ‘<p>’ . esc_html( $greeting ) . ‘</p>’;
}
// 在插件加载时加载翻译文件
function mfp_load_textdomain() {
load_plugin_textdomain( ‘my-first-plugin’, false, dirname( plugin_basename( __FILE__ ) ) . ‘/languages/’ );
}
add_action( ‘plugins_loaded’, ‘mfp_load_textdomain’ );코드를 최적화하고 배포 패키지를 만드는 것입니다.
개발을 완료한 후에는 디버깅 코드를 삭제해야 하며, 모든 함수에 고유한 접두사가 붙어 있는지 확인해야 합니다. 그런 다음 플러그인 디렉터리 전체를 ZIP 파일로 압축하면, 이 파일을 WordPress 관리자 페이지를 통해 업로드하여 설치할 수 있습니다.
주 파일에는 사용자가 플러그인을 삭제할 때 데이터베이스 설정을 정리하는 데 사용되는 표준 제거 프로세서가 반드시 포함되어 있어야 합니다. 이는 제거 후크(uninstallation hook)를 등록함으로써 구현됩니다.
// 插件卸载时的清理操作
register_uninstall_hook( __FILE__, ‘mfp_uninstall’ );
function mfp_uninstall() {
delete_option( ‘mfp_settings’ );
}요약
이 글에서는 WordPress 사용자 정의 플러그인을 처음부터 만드는 전체 과정을 상세히 설명합니다. 우리는 플러그인의 기본 구조와 보안 규칙을 이해하는 것부터 시작하여, WordPress의 핵심인 훅 시스템(액션과 필터)에 대해 자세히 알아보았으며, 설정 페이지가 포함된 백엔드 관리 인터페이스를 구축하는 방법도 배웠습니다. 마지막으로, 플러그인의 국제화, 코드 최적화, 그리고 최종 배포를 위한 준비 단계에 대해서도 논의했습니다.
잊지 마세요. 우수한 플러그인 개발은 단순히 기능 구현에 그치지 않으며, 코드의 보안성, 유지보수성, 그리고 WordPress 표준을 준수하는 것에도 크게 관련이 있습니다. WordPress 공식 플러그인 매뉴얼을 깊이 있게 공부하고 코드 규범을 준수하며, 실제 프로젝트에서 지속적으로 실습하는 것을 권장합니다.
자주 묻는 질문
WordPress 플러그인을 개발하려면 어떤 사전 지식이 필요한가요?
PHP 프로그래밍의 기초 지식이 필요하며, 변수, 함수, 배열, 조건문에 대한 이해가 필수적입니다. HTML과 CSS에 대한 기본 지식도 있어야 하며, WordPress의 기본적인 사용법과 백엔드 구조에 대한 이해도 도움이 됩니다. 객체 지향 프로그래밍(OOP)에 대한 지식은 고급 개발을 위한 플러스 요소입니다.
我必须使用类（Class）来编写插件吗？
꼭 그런 것은 아닙니다. 간단한 플러그인의 경우, 프로시저형 프로그래밍(함수들의 집합)을 사용하는 것도 충분히 가능하며, 이 글의 예제에서도 그런 방식을 사용했습니다. 하지만 더 복잡하고 기능이 많은 대형 플러그인의 경우에는 객체지향 프로그래밍(OOP)을 사용하여 코드를 클래스의 형태로 구성하는 것이 더 나은 선택입니다. 이렇게 하면 코드를 더 효율적으로 관리할 수 있으며, 이름 충돌을 피하고 유지보수성을 향상시킬 수 있습니다.
WordPress 플러그인 코드를 어떻게 디버깅하나요?
WordPress의 디버깅 모드를 활성화하는 것이 첫 번째 단계입니다. 웹사이트의… wp-config.php 파일 내에서, 해당 내용을 처리할 것입니다. WP_DEBUG 상수를 다음과 같이 설정합니다: true이 기능을 사용하면 페이지에 PHP 오류, 알림, 경고 메시지가 표시됩니다. 또한, 다음과 같은 작업도 가능합니다: error_log() 이 함수는 디버깅 정보를 서버의 오류 로그에 기록하거나, Query Monitor와 같은 전문적인 디버깅 플러그인을 사용하여 데이터베이스 쿼리, 후크(hook)의 실행 과정, 그리고 성능 문제를 확인합니다.
플러그인 개발 중에 보안을 어떻게 보장할 수 있을까요?
보안을 확보하기 위한 핵심 조치에는 사용자가 입력한 데이터를 항상 검증하고 정리하는 것이 포함됩니다(이를 위해 적절한 검증 및 정리 기술을 사용해야 합니다). sanitize_text_field(), esc_html(), wp_kses_post() (등 함수); 모든 데이터베이스 쿼리에 사용됩니다. $wpdb 클래스의 메서드를 사용하고, `prepare` 문을 활용하여 SQL 인젝션을 방지하세요. 브라우저에 출력되는 모든 동적 콘텐츠는 반드시 이스케이프 처리되어야 합니다. 또한 WordPress가 제공하는 내장 기능인 무작위 값(`nonce`)과 권한 검사도 반드시 사용해야 합니다.current_user_can()）를 사용하여 폼과 AJAX 요청을 보호합니다.
다음 단계는 무엇인가요?
확장된 독서 및 실무 지식
다음은 이 도움말의 주제와 관련이 있으며 더 깊이 있게 읽기에 적합합니다. 현재 문제와 가장 가까운 문서부터 시작하여 점차 주변 주제로 확장하는 것이 우선순위를 정하는 것이 좋습니다.
- 어떻게 자신에게 가장 잘 맞는 완벽한 WordPress 테마를 선택하고 커스터마이징할 수 있을까요?
- WordPress 플러그인 개발 가이드: 제로에서 시작하여 첫 번째 커스텀 플러그인을 만들어보세요.
- WordPress 서브테마(Subtheme)란 기존의 WordPress 테마(Theme)를 기반으로 만들어진 추가적인 디자인 및 기능 모듈입니다. 서브테마를 사용하면 기존 테마의 디자인을 그대로 유지한 채 새로운 색상, 글꼴, 레이아웃, 기능 등을 추가하거나 기존 기능을 수정할 수 있습니다. 이를 통
- WordPress 플러그인 개발자가 되기: 제로에서 원까지의 완전한 가이드
- 제로에서 원까지: WordPress를 사용하여 전문 웹사이트를 구축하는 완벽한 가이드와 실전 기술
한국어