WordPress 플러그인 개발 환경 준비
코드를 작성하기 시작하기 전에, 적합한 로컬 개발 환경을 준비해야 합니다. 온라인 상의 프로덕션 서버에서 플러그인을 직접 개발하는 것은 강력히 권장하지 않습니다. 일반적인 WordPress 개발 환경에는 로컬 서버 소프트웨어(XAMPP, MAMP, Local by Flywheel 또는 Docker), 코드 편집기(VS Code, PHPStorm), 그리고 새로 설치한 WordPress가 포함됩니다.
PHP 버전을 대상 WordPress 버전의 요구 사항에 맞게 업데이트해야 합니다. 일반적으로 WordPress 코어는 여러 PHP 버전과 호환됩니다. 플러그인 개발을 위해서는 더 현대적인 문법과 기능을 사용할 수 있도록 PHP 7.4 이상을 사용하는 것이 권장됩니다. 또한, WordPress 관리자 페이지에서 관련 설정을 활성화해야 합니다.WP_DEBUG이 패턴은 개발 과정에서 오류를 빠르게 찾아내는 데 도움이 됩니다.wp-config.php파일에서 다음 상수를 찾아서 설정하세요:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );이렇게 설정하면 오류 메시지가 기록됩니다./wp-content/debug.log파일의 내용은 페이지에 직접 표시되지 않고 파일 내에 저장되어 있으며, 이는 프론트엔드 사용자 경험에 영향을 미치지 않습니다. 이것이 바로 최선의 관행입니다.
추천 읽기 제로에서 원까지: WordPress 플러그인 개발을 위한 권위 있는 가이드와 실습 튜토리얼。
첫 번째 플러그인 파일을 만드세요.
所有WordPress插件都存放在/wp-content/plugins/디렉터리 안에 있습니다. 각 플러그인은 보통 별도의 폴더를 가지고 있으며, 폴더 이름은 간결하고 플러그인의 기능을 반영할 수 있어야 합니다. 이제 첫 번째 플러그인을 만들어 보겠습니다.
플러그인의 메인 파일을 작성하세요.
플러그인 폴더 내에 메인 PHP 파일을 생성해야 합니다. 이 파일의 이름은 보통 폴더 이름과 동일합니다. 예를 들어,my-first-plugin.php이 파일은 플러그인의 시작점이며, 반드시 특정한 플러그인 헤더 주석을 포함해야 합니다. WordPress는 이러한 메타정보를 읽어서 백엔드 플러그인 관리 페이지에 해당 플러그인을 표시합니다.
<?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국제화 및 현지화를 위해 사용되며, 플러그인이 향후 출시될 때를 대비한 준비 작업입니다.
플러그인의 기본 보안 및 구조
보안은 플러그인 개발에서 가장 우선시해야 할 사항입니다. 가장 기본적인 방법 중 하나는 사용자가 플러그인 파일에 직접 접근하는 것을 방지하는 것입니다. 이를 위해 파일의 맨 위에 직접 접근을 검사하는 코드를 추가할 수 있습니다. 주 파일을 수정하고, 플러그인 헤더 주석 다음에 다음 코드를 추가하세요:
// 防止直接文件访问
if ( ! defined( 'ABSPATH' ) ) {
exit;
}이 코드는 상수(constant)를 검사합니다.ABSPATH이 PHP 파일이 정의되어 있는지 확인해야 합니다. 만약 정의되어 있지 않다면(즉, 누군가가 URL을 통해 직접 이 파일에 접근하려고 한 경우), 스크립트 실행을 즉시 중단해야 합니다. 이는 모든 고품질의 WordPress 플러그인에 반드시 포함되어야 할 보안 조치입니다.
추천 읽기 WordPress 플러그인 개발 완전 가이드: 초보자부터 실제 서비스로 배포하기까지의 실전 튜토리얼。
플러그인에 핵심 기능 추가하기
플러그인의 역할은 WordPress의 기능을 확장하는 데 있습니다. 두 가지 간단한 예를 통해 기능을 추가하는 방법을 배워보겠습니다: 관리 페이지를 생성하는 방법과 프론트엔드에 콘텐츠를 추가하는 방법입니다.
간단한 관리 메뉴를 추가하세요.
먼저, 후방 관리자 인터페이스에 자신이 만든 플러그인에 속하는 메뉴 페이지를 추가하는 방법을 배워보겠습니다. 이를 위해서는 WordPress의 “후크(Hook)” 시스템을 사용해야 합니다. 특히…admin_menu액션 후크(Action Hook).
우리는 플러그인의 메인 파일에 함수를 추가할 것입니다. 예를 들어…mfp_add_admin_menu그런 다음 이것을 사용하세요.add_action함수는 그것을 매핑합니다.admin_menu훅에 걸려 있어요.
function mfp_add_admin_menu() {
add_menu_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 权限要求
'my-first-plugin', // 菜单Slug
'mfp_admin_page_html', // 用于渲染页面内容的回调函数
'dashicons-admin-generic', // 图标（使用Dashicons）
30 // 菜单位置
);
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );다음으로, 위에서 사용된 콜백 함수를 정의해야 합니다.mfp_admin_page_html다음은 페이지의 HTML 콘텐츠입니다. 이것은 가장 간단한 예시입니다:
function mfp_admin_page_html() {
// 再次检查用户权限
if ( ! current_user_can( 'manage_options' ) ) {
return;
}
?>
<div class="wrap">
<h1></h1>
<p>안녕하세요, 세상! 이곳은 제 첫 번째 플러그인 관리 페이지입니다.</p>
</div>
<?php
}이제 WordPress 관리자 페이지를 새로고침해 보세요. 왼쪽 네비게이션 바에 “내 플러그인”이라는 새로운 메뉴 항목이 표시되어 있을 것입니다.
프론트엔드 페이지의 하단에 텍스트를 추가하세요.
백엔드 관리 외에도, 프론트엔드를 수정하는 경우가 더 흔합니다. 예를 들어, 모든 글과 페이지의 하단에 저작권 정보를 추가하고 싶을 수 있습니다. 이번에는 다음과 같은 방법을 사용할 예정입니다:the_content필터 후크(Filter Hook).
추천 읽기 WordPress 플러그인 개발 입문 가이드: 제0단계에서 첫 번째 기능 확장을 만들어보세요。
필터 후크(Filter Hook)를 사용하면 함수에 전달되는 데이터를 수정할 수 있습니다. 이제 우리는 그러한 함수를 만들어 보겠습니다.mfp_add_footer_text이 시스템은 기사의 내용을 매개변수로 받아들이고, 그 뒤에 우리가 작성한 텍스트를 추가합니다.
function mfp_add_footer_text( $content ) {
// 仅对主循环中的单篇文章和页面生效
if ( is_single() && in_the_loop() && is_main_query() ) {
$footer_text = '<p><em>이 글은 제가 만든 첫 번째 플러그인의 지원을 받아 작성되었습니다.</em></p>';
$content .= $footer_text;
}
return $content;
}
add_filter( 'the_content', 'mfp_add_footer_text' );이 코드는 먼저 현재 환경이 단일 기사 또는 페이지인지, 그리고 메인 쿼리 루프 내에 있는지를 확인합니다. 이는 툴팁이나 요약과 같은 다른 곳에서 동일한 텍스트가 중복으로 추가되는 것을 방지하기 위함입니다. 그런 다음 저작권 정보가 포함된 HTML 단락을 원본 콘텐츠 뒤에 추가한 후 결과를 반환합니다.
플러그인 개발의 고급 실습 (Advanced Practices in Plugin Development)
기초를 익힌 후에 몇 가지 고급 실습 내용을 배우면 여러분의 플러그인을 더 전문적이고 안정적으로 만들 수 있습니다.
구성 가능한 플러그인 옵션을 구현합니다.
성숙한 플러그인은 일반적으로 사용자가 설정을 할 수 있도록 해야 합니다. WordPress는 옵션 페이지를 생성하는 과정을 간소화하기 위해 설정 API를 제공합니다. 이 과정에는 설정 등록, 설정 필드 추가, 설정 구역 설정이 포함됩니다. 직접 메뉴 페이지를 추가하는 것보다는 복잡하지만, Nonce 검증과 같은 보안 기능 및 폼 데이터 저장을 자동으로 처리해 줍니다.
보통, 플러그인 옵션들을 배열의 형태로 WordPress에 저장합니다.wp_options표 안에서 사용할 수 있습니다.add_option()、get_option()그리고update_option()이 함수는 플러그인 데이터를 조작하는 데 사용됩니다.
플러그인 코드를 조직화하기 위해 클래스를 사용하세요.
플러그인의 기능이 증가함에 따라, 모든 함수를 전역 네임스페이스에 넣으면 함수 이름의 충돌이 발생하기 쉽습니다. 가장 좋은 방법은 PHP 클래스를 사용하여 플러그인의 기능을 캡슐화하는 것입니다. 이렇게 하면 코드를 더 잘 구성할 수 있을 뿐만 아니라, 자동 로딩, 네임스페이스(PHP 5.3 이상을 사용하는 경우)와 같은 객체 지향적인 기능들을 활용할 수 있으며, 더 나은 캡슐화도 이루어집니다.
클래스 기반의 플러그인 주 파일은 다음과 같은 형태로 보일 수 있습니다:
if ( ! defined( 'ABSPATH' ) ) exit;
class My_First_Plugin {
public function __construct() {
// 在构造函数中挂载所有钩子
add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
add_filter( 'the_content', array( $this, 'add_footer_text' ) );
}
public function add_admin_menu() { /* ... */ }
public function add_footer_text( $content ) { /* ... */ }
}
// 初始化插件
new My_First_Plugin();이러한 방식은 모든 관련 메서드들을 하나의 클래스에 모아두어 코드의 유지보수성을 크게 향상시킵니다.
요약
이 가이드를 통해 WordPress용 커스텀 플러그인을 처음부터 만드는 전체 과정을 완료하셨습니다. 환경을 설정하는 방법, 안전한 플러그인 파일 구조를 만드는 방법, 액션 후크(Action Hooks)와 필터 후크(Filter Hooks)를 사용하여 백엔드 관리와 프론트엔드 표시 기능을 확장하는 방법을 배웠으며, 객체 지향적 프로그래밍 및 API 설정과 같은 고급 개발 패턴에 대해서도 이해하셨습니다. 플러그인 개발의 핵심은 WordPress의 후크 시스템을 이해하는 데 있습니다. 이 시스템은 코어 코드를 수정하지 않고도 플랫폼의 동작을 변경할 수 있는 수많은 기회를 제공합니다. 작은 기능부터 시작하여 점차 더 복잡한 플러그인을 구축해 나가는 것이 이 기술을 마스터하는 가장 좋은 방법입니다.
자주 묻는 질문
### 플러그인을 개발하기 위해서는 어떤 수준의 PHP 기술이 필요한가요?
PHP의 기본 문법을 숙달해야 합니다. 여기에는 변수, 배열, 함수, 조건문, 반복문이 포함됩니다. 무엇보다도 WordPress의 API와 어떻게 상호작용하는지 이해하는 것이 중요합니다. 예를 들어, 훅(hook)을 어떻게 사용하는지 알아야 합니다.add_action, add_filter) 및 일반적인 WordPress 함수들을 사용합니다. 객체 지향 프로그래밍(OOP) 지식은 복잡한 플러그인을 개발할 때 매우 유용합니다.
자신이 개발한 플러그인을 어떻게 디버깅하나요?
활성화WP_DEBUG‘패턴(Pattern)’은 가장 중요한 단계입니다. 자세히 살펴보세요.wp-content/debug.log파일 내에 오류 로그가 포함되어 있습니다. 또한, 코드 내에서 이 오류 로그를 활용할 수 있습니다.var_dump()또는error_log()함수가 디버깅 정보를 출력합니다. 예를 들어,error_log( print_r( $variable, true ) );어떤 변수의 내용이든 debug.log 파일에 기록할 수 있습니다. Query Monitor와 같은 전문적인 디버깅 플러그인을 사용하면 효율성을 크게 향상시킬 수 있습니다.
플러그인에서 제3자 PHP 라이브러리를 사용할 수 있습니까?
물론 가능하지만, 반드시 신중하게 처리해야 합니다. 다른 플러그인이나 테마에서 사용하는 라이브러리와의 버전 충돌을 피하기 위해 PHP 의존 관리 도구인 Composer를 사용하는 것이 좋으며, Composer의 자동 로딩 기능을 활용하는 것이 추천됩니다. 플러그인을 패키징하여 배포할 때는 라이브러리 파일을 플러그인에 포함시킬 수도 있고(라이브러리의 라이선스를 준수해야 함), 아니면 사용자가 서버에서 직접 해당 의존성을 설치하도록 요구할 수도 있습니다.
개발이 완료된 후 플러그인을 WordPress 공식 디렉터리에 어떻게 게시할 수 있을까요?
WordPress.org에 접속하여 귀하의 플러그인을 제출하여 심사를 받아야 합니다. 귀하의 플러그인 코드는 공식적인 코딩 표준과 지침을 준수해야 하며, 보안성을 확보하고 국제화(i18n)를 지원해야 합니다.__()그리고_e()함수들을 포함하고 있으며, 상세한 설명도 함께 제공됩니다.readme.txt파일입니다. 심사를 통과하면 귀하의 플러그인이 전 세계 사용자들에 의해 검색되고 설치될 수 있게 됩니다.
다음 단계는 무엇인가요?
확장된 독서 및 실무 지식
다음은 이 도움말의 주제와 관련이 있으며 더 깊이 있게 읽기에 적합합니다. 현재 문제와 가장 가까운 문서부터 시작하여 점차 주변 주제로 확장하는 것이 우선순위를 정하는 것이 좋습니다.
한국어