Impack WordPress – 面向對象方式開發WordPress主題

利于面向對象方式開發 WordPress 主題、插件的 PHP 公共代碼包。

注冊元框/分類法字段

1.一種元框一個類

use Impack\WP\Utils\Metabox;
class Custombox extends Metabox
{
    function render($post)
    {
        echo '自定義內容';
    }
    function save($postid)
    {
        // 保存數據
    }
}

2.在 add_meta_boxes 鉤子執行

Custombox::add('boxid', '標題');

3.注冊字段：創建有 addField/editField/saveField 方法的類后執行 add 方法

SeoField::add('category');

注冊類型/分類法

1.類型配置文件 post.php 填注冊參數

return [
    'news' => [
        // 'class' => News::class,
        'name' => 'news',
        'label' => '新聞',
        'taxonomy' => ['tag'], //分類法配置的鍵名
        'metabox' => [
            //key=元框ID，val=類名和add方法的參數數組
            'boxid' => [Custombox::class, '標題'],
        ],
    ],
];

2.分類法配置文件 taxonomy.php

return [
    'tag' => [
        'field' => [SeoField::class], //字段類名數組
    ],
];

3.init 鉤子內執行

(new Impack\WP\Register\Registrar())->post();

4.配置項有 metabox/taxonomy/field 時，自動注冊這些功能

5.配置項有 class 時，自動以單例形式綁定到容器，數組鍵用作綁定的 ID

異常處理規則

• 簡單錯誤不終止程序運行
• 非調試模式下不輸出任何簡單錯誤
• 調試模式下顯示所有錯誤和詳細信息
• JSON 請求返回 JSON 格式的信息

使用自定義異常響應 AJAX 請求

1.定義異常消息

use Impack\Support\Enum;
class CustomEnum extends Enum
{
    const ERROR = [0, '錯誤消息'];
}

2.定義異常類

class CustomException extends Exception{
    use \Impack\WP\Exceptions\Render;
    protected $enum = CustomEnum::class
}

3.拋出異常，參數支持 WP_Error、Enum

throw new CustomException('ERROR');

數據模型：Post/Comment/Term/User

使用時不需要 new 實例，調用靜態方法 where

• where：返回單例，自動添加基礎參數，支持傳參
• limit/order/in/notin/search/meta/metas：添加查詢參數
• param/merge：鍵值對添加參數/合并參數
• edit：編輯 add/update 常用的參數
• get：讀取數據，參數默認為 null 返回自定義對象數組
• add：新增數據
• update：更新指定 ID 的數據
• delete：靜態方法，刪除數據
• Post 方法：parent/post/tax/taxs
• Term 方法：parent/noChild
• User 方法：user/role/hasPosts/adminStyle
• Comment 方法：parent/comment/status/post/author/subtree
• 新增術語時未提供 slug 會使用名稱代替，中文將轉成拼音
• setSingle：參數支持類名/init，自定義 get 返回的對象。

$post = \Impack\WP\Query\Post::where();
$term = \Impack\WP\Query\Term::where();
$user = \Impack\WP\Query\User::where();
$comment = \Impack\WP\Query\Comment::where();

// 查詢文章
$post->limit(10)->get();

// 刪除數據
$term::delete(1);

// 新增文章
$post->edit('標題', '內容')->add();

// 更新文章
$post->edit('修改標題')->update(1);

// 新增評論
$comment->edit('新評論')->add();

// 更新評論
$comment->edit('修改評論')->update(1);

// 新增術語
$term->edit('名稱')->add();

// 更新術語
$term->parent(1)->update(2);

// 新增用戶
$user->edit('login', 'pass', 'name')->add();

// 更新用戶
$user->edit(null, null, '新名字')->update(1);

WordPress 內置的全局對象參考

• wp、wp_object_cache、wp_embed
• wpdb、wp_query、wp_rewrite
• wp_user、wp_roles、wp_widget_factory
• wp_locale、wp_locale_switcher

工作區目錄建議

• src：所有類存放的目錄
• config：配置信息。放置所有硬編碼參數以便修改
• assets：js/css/fonts/images 等靜態資源目錄
• view：模板文件目錄