艾瑞克的沼澤 - 內有個人心得、學習筆記、廢文

不過，就如同我在前面說過的，無論是 WordPress 外掛開發，或者是學習其他任何知識都是，都不會是簡單 30 天就能學會所有知識，例如說光是一個 hook 就可以講得很深，絕對不是像我這樣一言兩語就能說完的！所以這 30 天所學的可能連基礎都稱不上，學習 WordPress 的這條路還要繼續下去，所以，我最後會把這次開發的外掛，整理到這個 repository 上面： https://github.com/eric0324/wp-lotify ，之後也會不定期更新，歡迎大家上來按星星，鞭小弟的 code。

最後…工商一下：

如果你喜歡 WordPress ，歡迎來參加 WordPress 小聚

如果你喜歡 chatbot ，歡迎來參加 chatbot 線下小聚

也歡迎來我的部落格跟我交流，我們明年見。

閱讀全文【第 30 天】總結：WordPress 遇上 Chatbot，像極了愛情

【第 29 天】在這些 WordPress Hooks 放在 LINE Notify

在昨天，我們建立了一個 private function 來發送 LINE Notify 訊息通知。

在【第 26 天】我們會用到哪些 WordPress hooks？，我們也試著找出我們想要用、可能要用的 WordPress hooks。今天我們來試著為這些 hooks 掛上 LINE Notify 訊息通知。

在這之前，先附上昨天寫好的 private function ，方便大家參考：

private function line_send_notify($text) {
    $request_params = array(
        "headers" => "Authorization: Bearer {$this->options['token']}",
        "body"    => array(
            "message" => "{$text}"
        )
    );

    $response = wp_remote_post('https://notify-api.line.me/api/notify', $request_params);
}

如果我們要在建立文章後發送通知，就這樣寫就可以了：

add_action('save_post', 'line_send_notify');

亦或者，我們可以透過外掛提供的 hooks 去做事情，比如說訂單通知：

add_action('woocommerce_checkout_update_order_meta', 'line_send_notify');

保險起見，我們還要來先檢查一下，是否存在這個外掛：

if(is_plugin_active('woocommerce/woocommerce.php'))

會變成這樣：

if(is_plugin_active('woocommerce/woocommerce.php')) {
    add_action('woocommerce_checkout_update_order_meta', 'line_send_notify');
}

為了讓提高程式碼的可維護性，我們把這些 add_action() 放在 __construct 中，會變成這樣


public function __construct()
{
    ...
    add_action('save_post', 'line_send_notify');

    if(is_plugin_active('woocommerce/woocommerce.php')) {
        add_action('woocommerce_checkout_update_order_meta', 'line_send_notify');
    }
    ...    
}

這樣應該就會收到通知囉！

閱讀全文【第 29 天】在這些 WordPress Hooks 放在 LINE Notify

【第 28 天】在 WordPress 建立傳送 LINE Notify 函式

今天我們要來開始試著寫 LINE notify 這段。我們建立一個 private function 叫做 line_send_notify ，這個函式傳入了一參數叫做 $text：

這個函式一開始我們先建立 $request_params ，裡面有我們的 header 和 body。其中 header 包含了我們在【第 27 天】取出 LINE Notify token ，所拿到的 token ，作為 Authorization 的 value。以及在 body 放入一個 key 為 message ，value 為剛剛函式傳入的 $text 。

$request_params = array(
    "headers" => "Authorization: Bearer {$this->options['token']}",
    "body"    => array(
        "message" => "{$text}"
    )
);

還記得我們在【第 15 天】WordPress 的 HTTP API ，了解了 WordPress 提供了許多好用的 HTTP API 讓我們可以對第三方發送 HTTP 請求，這時候就可以派出用場了

LINE 官方文件提到要推送 notify 的位址是 https://notify-api.line.me/api/notify ，並且是 POST 方法，然後要傳入剛剛建立好的 header 和 body：

$response = wp_remote_post('https://notify-api.line.me/api/notify', $request_params);

這樣我們的訊息應該就可以正常送出去了，完整的程式碼如下：

private function line_send_notify($text) {
        $request_params = array(
            "headers" => "Authorization: Bearer {$this->options['token']}",
            "body"    => array(
                "message" => "{$text}"
            )
        );

        $response = wp_remote_post('https://notify-api.line.me/api/notify', $request_params);
    }

順帶一提，如果想要確認一下我們 API 是否有打成功，我們還可以加入：

$response_code = wp_remote_retrieve_response_code($response);

然後用 if…else… 去判斷狀態碼：

if( $response_code == '200' ){
    // Do something...
} else {
    // Do something...
}

閱讀全文【第 28 天】在 WordPress 建立傳送 LINE Notify 函式

【第 27 天】取出 LINE Notify token

現在要給 LINE 的 token 也存好了，想要發送 notify 的地方大概也都有想法了，再來我們要試著取出 token 來做使用。

在前面，我們如果把 token 用成 options 的方式去儲存的話。我們可以複習一下【第 10 天】如何修改 WordPress 的後台設置選項裡面我們聊到，我們如何用 get_option() 函式來取得值。

所以說，我們要取得 token ，可以直接

get_option('token');

為了讓 PHP 代碼可以更簡潔，我們試著改寫成 __construct ：

public function __construct()
{
    $this->options = get_option('notify-for-line');
}

這樣我們可以用 $this->options 去取得屬性。換言之，要取用 token 會變成：

$this->options['token']

在這之前，我們還會檢查一下，是真的有 token 可以使用，我們還會多一個 if 邏輯去判斷，如下：

if (isset($this->options['token']) && $this->options['token'] !== '') {
    // do someting(e.g. get token)
}

兩個條件：

token 不為 null
token 不為空字串

再來，我們需要將取得的 token 組成一個字串：

"Authorization: Bearer {$this->options['token']}"

Bearer 是一種 token 方法，有興趣的話可以參考 OAuth 2.0 (RFC 6749) 裡頭清楚的定義了 client 如何去取得 access token 的方法，我這邊就不贅述了。

太好了，我們取得到之前存好的 token 了，接著我們明天要來送出通知了！

閱讀全文【第 27 天】取出 LINE Notify token

【第 26 天】我們會用到哪些 WordPress Hooks？

今天我們來研究看看，WordPress 核心提供了哪些 hooks 可以拿來用？以及有些時候，我們想對其他外掛做點事情，該怎麼做？

WordPress 核心提供的 hook

WordPress 提供了我們兩個清單，分別是 filter hooks 和 action hooks 了！接著，我們還是找到woocommerce_checkout_update_order_metas ：

Filter Reference
Action Reference

我們可以很輕易快速的直接來這兩個清單找到我們可以使用的 hook 。舉例來說，我希望每次發文的時候送出 notify 通知，那我可能可以找到一個 action hook 叫做 save_post()。

他的下面會附上一段簡介，簡介如下：

Runs whenever a post or page is created or updated, which could be from an import, post/page edit form, xmlrpc, or post by email. Action function arguments: post ID and post object. Runs after the data is saved to the database. Note that post ID may reference a post revision and not the last saved post. Use wp_is_post_revision() to get the ID of the real post.

簡單來說就是，每當創建或更新文章或頁面的時候會運行。太好了，這就是我想找的 hook 。那我們就可以在這個 hook 上面掛上我們的 callback function 。

其他外掛提供的 hook

當然了，有的外掛也會提供 hook 給我們使用，所以我們也可以透過這種方式去插入我們自定義的 callback function 。沒錯！WordPress 的世界就是這麼方便。

舉例來說，我今天想要在 woocommerce 上面做訂單通知。我們可以試著上去外掛的官網上面找文件，於是我們找到了這份文件：Action and Filter Hook Reference，翻一翻可以找到 woocommerce_checkout_update_order_meta()，不過打開文件後，確實有點難理解要怎麼用它。

所以我這邊想分享一個網站： hookr.io。

進去後，我們可以直接打開外掛列表頁，這裡記錄了許許多多在 WordPress 上面提供的外掛，假設我們點了 Woocommerce，裡面就會有這個外掛所提供的所有filter hooks 和 action hooks 了！接著，我們找到 woocommerce_checkout_update_order_meta()。他就會告訴我們 description、他會用到哪些 parameters ，以及他的使用方法。整個很方便好用！

明天我們就要來把這個 hook 放上我們自己定義的 callback function 囉！

閱讀全文【第 26 天】我們會用到哪些 WordPress Hooks？

【第 25 天】在 WordPress 後台取得 LINE Notify token

這幾天實在太忙了，所以文章有點沒時間寫。但是鐵人賽都快結束了，不可以輕易放棄啊！！！

在取得 LINE Notify token 之前，還記得我們在第 22 天的時候說過，使用者的瀏覽器在登入授權後，會透過 redirect_uri 所設定的網址發出 HTTP POST 要求嗎？所以我們要先來搞定取得 LINE 的 POST method 。

這部分要感謝也在參加鐵人賽的 Eric 桓桓為我點通訣竅。

WordPress 接受 post method 的方法非常簡單，我們只需要在外掛的目錄下建立 get_post.php 就可以處理 post method 了，大概是這樣。

<?php 
    require_once('wp-load.php'); // add wordpress functionality
    $post = $_POST;

    if ( $something ) // security check
    // do something...
?>

接著透過 yourdomain.com/plugin_name/get_posts.php ，就可以發送 post 請求。這也意味著我們要去 LINE Notify 修改一下我們的 redirect_uri 到 https://yourdomain.com/plugin_name/get_posts.php。如此一來我們就可以取得一組 token ，所以接著我們需要把它存下來。

如此一來，我們就會有一組 token 清單在資料庫中，以後要發送 Notify 的時候，就找這個清單就可以囉！

至於實作的部分呢，小弟我還在被追殺中．．．．我假日會補啦QQ

閱讀全文【第 25 天】在 WordPress 後台取得 LINE Notify token