WordPress插件开发从零开始

最近在做项目的时候遇到这个问题，查了不少资料总算搞明白了。把过程记下来，方便以后查阅，也希望能帮到有同样需求的朋友。

先搞清楚原理

要理解WordPress，先得搞清楚模板渲染机制这个机制。直接看代码比看文字描述来得快：

<?php
function custom_meta_description_51() {
    if (is_single()) {
        global $post;
        $excerpt = get_the_excerpt($post);
        $desc = mb_substr(wp_strip_all_tags($excerpt), 0, 155);
        echo '<meta name="description" content="' . esc_attr($desc) . '">' . "\n";
    }
}
add_action('wp_head', 'custom_meta_description_51', 1);

function add_schema_markup_51() {
    if (is_single()) {
        global $post;
        $schema = array(
            '@context' => 'https://schema.org',
            '@type' => 'Article',
            'headline' => get_the_title($post),
            'datePublished' => get_the_date('c', $post),
            'dateModified' => get_the_modified_date('c', $post),
        );
        echo '<script type="application/ld+json">' . wp_json_encode($schema, JSON_UNESCAPED_UNICODE) . '</script>' . "\n";
    }
}
add_action('wp_head', 'add_schema_markup_51', 99);

实际怎么用

写代码的时候，WordPress有几个常见写法。推荐用下面这种方式，代码更清晰，也更容易维护：

<?php
class LoginLimiter_58 {
    private static $max_attempts = 5;
    private static $lockout_time = 900;

    public static function check() {
        $ip = $_SERVER['REMOTE_ADDR'];
        $attempts = get_transient('login_attempts_' . md5($ip));
        if ($attempts !== false && $attempts >= self::$max_attempts) {
            wp_die('登录尝试过多，请15分钟后再试');
        }
    }

    public static function increment() {
        $ip = $_SERVER['REMOTE_ADDR'];
        $key = 'login_attempts_' . md5($ip);
        $attempts = (int) get_transient($key);
        set_transient($key, $attempts + 1, self::$lockout_time);
    }

    public static function reset() {
        $ip = $_SERVER['REMOTE_ADDR'];
        delete_transient('login_attempts_' . md5($ip));
    }
}

add_action('wp_login_failed', array('LoginLimiter_58', 'increment'));
add_action('wp_login', array('LoginLimiter_58', 'reset'));
add_action('login_form', array('LoginLimiter_58', 'check'));

remove_action('wp_head', 'wp_generator');
add_filter('xmlrpc_enabled', '__return_false');

进阶一点的用法

WordPress在复杂场景下的用法和简单场景差别挺大。主要是模板渲染机制这块需要额外处理，代码如下：

容易踩的坑

踩坑经验分享：WordPress在模板渲染机制方面有几个暗坑。最常见的是参数默认值不符合预期，其次是并发场景下的竞态条件。建议加上防御性检查。

写在最后

WordPress这块先整理到这里。权限校验是最重要的部分，务必理解透彻。如果遇到问题，先检查配置和版本，大部分报错都是这两个原因。