​

過年時收到一張對我意義重大的賀卡。

一直覺得以接案者而言，WordPress 真的是一套很棒的接案工具，除了生態系很豐富以外，對工程師來說也很友善，如果碰到有遵循官方 API 開發的案件時，要接手很容易就可以銜接上，尤其是串接 WooCommerce 的金物流更是可以套用相同的架構下去開發，只要把心力花在第三方 API 的欄位處理就好。

但也許是我太天真了，很多知識早已內化卻不自知，以為將開發的工作交給有心學習的初學者，只要稍微指點他們就能輕易上手，畢竟對我來說這些工作都大同小異，抱持著這樣的傲慢讓我跌過很大一跤…

事情是這樣的：那幾個月身上卡了兩個很複雜的大專案，然後又碰上早已安排為期兩週的年度旅行，因為專案時程滿緊迫的，我必須在出發前把進度完成一個段落，算算日子知道自己完全來不及，於是就想起之前在某次小聚認識的 Eddie。

他原本從事行政工作，後來學習了 WordPress 後決定出來接案，他是我認識非常有企圖心的接案者，只要有任何的接案機會他都會極力爭取，縱使這個案子可能超出他的能力非常多，他覺得困難的案子就是他成長的機會，也因為這樣不畏挑戰的人格特質，讓我在這緊急時刻想到了他。

我當初需要請他幫忙的地方是手刻 WordPress 佈景主題，由於當時 Eddie 還沒有學習過任何的前端，也沒有寫過程式碼，我就跟他一起約出來教他怎麼寫，從最基本的 HTML 開始，一行一行把我腦中的知識輸出給他。

就這樣，在我出發前我覺得他已經可以掌握完成這個工作所需的知識了，然後希冀等我回來後他就能幫我把前端的進度完成。我當時還不了解對新手來說「知道」跟「會做」中間的鴻溝有多大，當我上工後看到他完成的進度，我就深深覺得自己不是位合格的指導者 Orz

我看到的是完全無法用的程式碼，在誇獎與肯定他的付出的當下，我知道我又要熬夜了，我接手後全部打掉重練，然後跟客戶歹勢重新約定交件時間，我付出了自己先掏腰包墊給 Eddie 的開發費用與指導他的時間，以及無數個熬夜趕工的夜晚與因為專案延誤而導致的損失，我得到的教訓是不該把不適合的專案交付給不合適的人選。

首先案子都已經火燒屁股了，我還找完全沒有程式經驗的人來幫忙，算上指導的時間我可能都能自己完成一部分了。其次是指導者的自我感覺良好，因為自己講很多好像很厲害，卻忽略了學習者是否有確實吸收，最後是破壞與客戶的約定，發覺自己越忙的時候越不會去仔細計算時程的合理性，只想先把案子拿下來再說，最後損失的是彼此。

有了這次的教訓之後，對於發包案件我變得異常保守，很害怕歷史再度重演，直到轉換成敏捷式接案的工作方法後，我又累積了許多代辦事項，才開始又有找人幫忙的念頭，但這一次我希望不要再重蹈覆轍。

首先，我寫了一篇徵才文章，具體說明合作模式以及所需技能，收到來信後我們就約線上面談，我會先了解他的背景以及過往作品，再請他開編輯器解釋他的程式碼邏輯，我也會開我的程式碼請他解釋這段的作用，並且詢問他是否有更好的寫法。

有了初步認識後，我會先發包一個對我來說 1~2 時內就能完成的功能，藉此測試實際工作起來合作溝通是否順暢，也可以觀察他對於 WordPress 的理解程度以及工作效率。時薪制的好處就是如果不適合，我付出的成本就是這個幾小時的時薪，而他也能得到相對應的酬勞。

而我就是這樣開始跟東霖的合作，他自己有在經營 WordPress 教學頻道，同時也是台南小聚的共同籌辦人，第一次合作就被他的效率給驚艷到，他比我預期的更快完成任務，也讓我願意交辦給他更多工作。

當然也不是每一個工作都能順利完成，我們也常遇到我倆都不知道該怎麼辦的狀況，這時候我們就會開始腦力激盪，這條路不通就換條路走，去研究更多資料看要怎麼解，也因此總是可以想出更多更好的解法，我很享受這樣的過程，像是有一位可以彼此互相學習共同成長的夥伴。

我跟他合作了近一年的時間，雖然由於我的工作型態改變而沒有再繼續發案給他，但這是一段對我意義很重大的合作經驗，他幫助我從發包失敗的教訓中走出來，讓我相信只要用對的模式找到對的人，合作接案會比一個人單打獨鬥來得更強大！

一、請 ChatGPT 教我開發 WordPress 區塊

因為之前開發的 WooCommerce 推播通知外掛有提供 LINE 登入的功能，有客戶反應說希望可以自行決定登入按鈕的擺放位置，關於這需求我目前是用短代碼來處理，雖然上一個版本我有整合區塊讓使用者設定按鈕，但那是用 ACF 設計的，礙於檔案尺寸的緣故，這支外掛並沒有採用 ACF，因此想要用區塊設定 LINE 登入按鈕勢必要自己刻了。

前些年看 Handbook 學區塊開發碰到很大的挫折，我看不懂文件在寫什麼，也找不到一個具體的範例可以直接拿來修改套用，這禮拜看過後覺得有好一些，但還是非常不習慣區塊 JS 的寫法，為了要習慣它我還先去 K 了 React.js 文件，結果區塊的寫法跟原生的又不太一樣，反而更不習慣了 > <

於是想說算了，改請機器人教我寫，我花了三個多鐘頭跟它請益，並且不停修改它提供的程式碼，把噴出的錯誤訊息丟給它叫它修，直到最後，我終於，還是沒有完成區塊開發 Orz…

它給的寫法跟 Handbook 不太一樣，像是它還是在 PHP 中註冊 attributes，現在官方的建議方法是要用 block.json，雖然可以請它用這個方法改寫，但如果我沒看過 Handbook 就不知道該怎麼修改。

我目前卡在找不到一套適合的 CLI，可以編譯 JSX 並且支援 HMR 的開發環境，本想用之前社群很推的 Vite，但實作起來問題很多，然後官方提供的 CLI 要整合在既有的外掛之中又有難度，總結下來開發區塊我目前卡在以下幾個點：

• 沒有好用的 CLI
• 沒有開箱即用的範例
• 變化太快很多過時資料
• ChatGPT 很厲害，但自己本身也要有基礎才行

目前我查到寫的比較好的教學有：

• Kinsta 的文章：https://kinsta.com/blog/gutenberg-blocks/​
• Tom 大大的文章：https://tommcfarlin.com/learning-to-build-block-editor-blocks-1/​
• Handbook 先看這邊：https://developer.wordpress.org/block-editor/how-to-guides/block-tutorial/writing-your-first-block-type/​

然後 CLI 可以參考 vite-gutenberg，只是還沒實現 HMR，如果你有區塊的開發經驗還懇請賜教啊～

​

二、WooCommerce 註冊 Action Schedule 的單次排程任務

之前做過一個需求是要讓訂單建立的 N 天後，去執行一些任務，這邊先以增加訂單備註為範例，我當時不知道是怎麼想的，我是設計成每天午夜十二點的重複排程，時間一到就會去撈出所有訂單，然後去拿今天的時間跟訂單建立時間做比較，也就是今天時間 - 訂單時間 > 5，就會寫入該訂單的備註。

這樣的寫法很複雜，因為要去做時間的計算，而且萬一訂單量非常龐大，每晚撈出所有訂單對於資料庫是不小的負擔，後來轉念才想通，我只要在訂單建立的時候建立只屬於該訂單的排程，然後把執行時間設為五天後不就解決了？

但還有一個問題是如果每張訂單都有屬於自己的排程，那麼我該如何分辨這個排程是屬於哪張訂單？一開始我想的是以訂單編號當作排程名稱，然後在執行後去抓出排程名稱的 ID，但這樣在註冊排程時又會變得太繁雜，好在 Action Schedule 有提供參數的功能，可以在註冊時就一併把訂單 ID 紀錄起來，之後就能拿到這個參數做處理，實際作法如下：

我們先在訂單成立時使用as_schedule_single_action 註冊單次排程，並且以現在時間的五天後作為觸發時間，同時以 order_note_cron 作為排程名稱，而最後就是要傳給排程的參數，用陣列的方式存放訂單 ID，接下來就可以把新增訂單備註的函式掛在這個排程上。

完整程式碼如下：https://oberonlai.blog/woocommerce-action-schedule/​

三、21 世紀的終端機 Warp

之前我用的是 iTerm，Warp 比他強八百倍，它可以：

跟 VSCode 一樣的游標移動&選取方式

每次用 iTerm 最不習慣的地方是我都會用跟 VSCode 一樣的游標移動方式來操作，也就是 cmd + 方向鍵將游標移到開頭或結尾、option + 方向鍵在段落移動、搭配 shitft 直接做選取，用了這功能在 Warp 裡面用 vi 跟用 VSCode 沒兩樣，超方便！

自動提示曾經打過的指令

以往的自動提示好像要另外裝工具才可以使用，但我沒那麼常使用終端機所以就沒特別研究，而 Warp 直接內建了，就不需要再花時間去找其他工具了。

內建&AI 提示指令

也由於我不常打指令，每次要用的時候總是要去查，Warp 內建多種情境的指令，輸入關鍵字就會自動提示，最棒的是還有 AI 可以輔助，像我這禮拜忘記修改檔案權限該怎麼寫，我就直接請 AI 教我，一方面除了可以複習，另一方面還可以偷懶直接拿來用XD

個人使用免費

這麼多強大的功能個人使用是完全免費的，光是這一點就超值得一試了！

對於 Warp 它已經滿足我八成的需求，私心希望它還可以紀錄 SSH 的登入帳密就更棒了～

-

從年假過到現在感覺還沒收心，每天都想出去放風耍廢，有在思考是不是應該趁夏天天氣熱躲在家認真工作就好，在這麼麼涼爽的春冬應該要出門去環島才對？想想而已，因為我還有下禮拜的電子報要寫XD，我們下週見！