https://codex.wordpress.org/Writing_a_Plugin
https://developer.wordpress.org/plugins/plugin-basics/

WordPress 的 plugin (外掛) 放在 wp-content/plugins, 官方文件提到，開發 plugin 第一件事情就是想名稱，plugin 的名稱要有獨一性。即使你的 plugin 沒上架，也要考慮 plugin 名稱的獨一性，如果名稱跟其他 plugin 有重複時，會造成升級時的混淆。

官方建議名稱可以取 mycompanyname-fabulous-functionality (前置你的公司名稱，用 dash 分隔)。每個 plugin 至少要有一支 php, 官方建議檔名跟資料夾一致，也就是 mycompanyname-fabulous-functionality.php

但實務上不一定要加公司名 (很多官方出的外掛也沒有冠 Automattic, 裡面的 PHP 檔名也沒有跟資料夾一致）

plugin 裡每支 php 應該第一行是 defined('ABSPATH') or die();
以確保你的每支 php 是在 WordPress core system 裡面。

plugin 裡的其中一支 (而且只能有一支) PHP 要加上 header, 其中只有 plugin name 是 required.
https://developer.wordpress.org/plugins/the-basics/header-requirements/

基本上有三個 action hook 是一定要的，在這支有 header 的 PHP 加上

register_activation_hook( __FILE__, 'your_activation_function')
register_deactivation_hook( __FILE__, 'your_deactivation_function')
register_uninstall_hook( __FILE__, 'your_uninstall_function')

可以很直覺的看出來，分別是啟用時調用、停用時調用，和解除安裝時調用。通常這三個 action hook 是寫在這支 PHP 裡 (暫稱之為 main plugin file), 但是也可以寫在其他 PHP 裡。如果寫在其他 PHP，記得 __FILE__ 要換成 main plugin file 的路徑。

https://developer.wordpress.org/plugins/the-basics/uninstall-methods/
deactivate 跟 uninstall hooks 官方文件特別提了，deactivation hook 處理的是移除 temp files/folders, flush permalinks 等，uninstall hook 處理的是移除你新加的 options, DB tables, 也就是復原系統。不要把 deactivate 跟 uninstall hooks 搞混了。

https://developer.wordpress.org/plugins/the-basics/best-practices/
多個外掛時，很有可能變數名, 函數名, class名稱可能會衝到。官方文件提供了一些好的 coding practice, 分析的很漂亮，相信很多有工程背景的朋友也會覺得這篇官方文件很讚。

1. Procedural

– 所有變數, 函數, class名稱加上 prefix
– check for existence, 尤其是 functions
Variables: isset() (includes arrays, objects, etc.)
Functions: function_exists()
Classes: class_exists()
Constants: defined()

2. OOP

將外掛子模組的 code 包成 class.

3. File Organization

外掛裡的檔案要有檔案結構，而不是都擺在同一層。

4. Plugin Architecture

– Conditional Loading, 把 admin code 跟 public code 分開，調用時用 is_admin() 來區分。
– Architecture Patterns.

5. Boilerplate Starting Points

上方文件建議開發者「不要」每次都從 0 開始寫 plugin，而是要建立自己的樣板，這樣你所有開發的 plugin 才會有一致性 (consistency)。上方文件並提供一些 template 可以參考。

除了 activation, deactivation, uninstall 三個 action, 整個 WP 其實是 action (用軟體工程比較通用的說法是 event) 驅動的一個框架，底下是 WP 的 action reference, 包含前後台每次 request 的 action 順序
https://codex.wordpress.org/Plugin_API/Action_Reference

提一下 form submission 的部分…
https://codex.wordpress.org/Plugin_API/Action_Reference/admin_post_(action)
在 WP 寫表單時，首先要定義一個 hidden field

<input type="hidden" name="action" value="your_post_action_name">

your_post_action_name 請自行選擇，注意這個 action 跟 <form> action 無關。<form> 一般是

<form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">

然後註冊你的 handler

add_action( 'admin_post_your_post_action_name', your_handler_function );

這個 action 就是你的 your_post_action_name 前面直接黏上 admin_post_

如果你是給前台沒登入的用戶 submit form

add_action( 'admin_post_nopriv_your_post_action_name', your_handler_function );

就是 admin_post_ 改成 admin_post_nopriv_, 後面一樣黏 your_post_action_name

結論

WP 的開發眉眉角角很多，而且很多是實務的經驗 (其實 larry 不是很建議初學 web 的工程師以 WP 當做第一個學習框架)。以上只是就大的框架走過一遍，後續有空再跟大家分享吧 ~

https://developer.wordpress.org/themes/advanced-topics/child-themes/
https://docs.woocommerce.com/document/set-up-and-use-a-child-theme/

一個 child theme (子主題) 至少要加三部分

1. child theme 的資料夾

如官方文件所述，如果你想要幫
wp-content/themes/twentyfifteen 加 child theme, 則資料夾是
wp-content/themes/twentyfifteen-child

加上 -child, 把它當做 coding convention.

2. style.css

以 twentyfifteen-child 來說，就是 wp-content/themes/twentyfifteen-child/style.css
一樣要加上 stylesheet header, 注意新增一個 Template 欄位，例如
Template: twentyfifteen 指定你的 parent 是 twentyfifteen

3. functions.php

子主題的 functions.php 會「先於」父主題的 functions.php 被執行 (兩者都會執行)

接著要引用 parent 的 style.css, 官方文件提到在 child theme 使用 @import 是「以前」方法了，目前建議的方法是在子主題的 functions.php 加上

<?php
function my_theme_enqueue_styles() {

    $parent_style = 'parent-style';

    wp_enqueue_style( $parent_style, get_template_directory_uri() . '/style.css' );
    wp_enqueue_style( 'child-style',
        get_stylesheet_directory_uri() . '/style.css',
        array( $parent_style ),
        wp_get_theme()->get('Version')
    );
}
add_action( 'wp_enqueue_scripts', 'my_theme_enqueue_styles' );
?>

注意

a. 去父主題的 functions.php 找到 wp_enqueue_style, 一般來說，主題需要告訴 WP 核心去引用 css, wp_enqueue_style 的第一個參數就是識別字串 (官方文件叫 $handle), 把這個識別字串記住，上方的 $parent_style 改成這個識別字串。

b. 檢查父主題 functions.php 是否已有幫子主題 wp_enqueue_style 的 code, 檢查 wp_enqueue_style 和 is_child_theme. 如果有的話，子主題連 functions.php 都不用加 (當然如果你要客製化 functions.php 的話還是要加)

c. 承 b, 如果父主題「沒有」幫子主題 wp_enqueue_style 的 code, 則需要上方附的程式碼，否則父主題的 style.css 不會被引用到 html head.

d. 如果你的 child theme 不只有 style.css, 要 review 所有 css 檔案的相依性，照順序 wp_enqueue_style

到目前為止，你的後台主題面板應該已經看得到你的 child theme, 並可以啟用。如果你想換的不只是 css, 還需要換 template. 那直接在 child theme 新增一樣檔名的 template php 即可。

官方文件有提到，要改 functions.php 時，建議新增 child theme, 在 child theme functions.php 裡 orverwrite 你要改的 function, 因為當主題升級時，functions.php 會被覆寫掉。要注意的是，你的父主題的 function 要 “pluggable” (用 function_exists 包住)

官方文件附了一個寫 <link> 的範例，程式上沒有特殊之處，但概念上 WordPress 有點像是在 functions.php 裡做 templating.

最後有 child theme 時，get_template_directory() return 的是父主題的資料夾，要拿到子主題的路徑，請用 get_stylesheet_directory()