目的

WordPress 本身提供了一個基本搜尋框，有點像 Google 一樣，單一搜尋框就可以搜尋任何你想要搜尋的字，簡單明瞭，但是有些情況下希望可以讓使用者作更多方面的搜尋，例如：在某些文章中加入特定屬性，搜尋的時候可以透過這些屬性來進行二次過濾。這樣講可能有點籠統，這邊舉一個實際的例子來運用。

假設現在有一個旅遊景點的網站，小蛙可能會希望除了景點之外還能做其他搜尋，像搜尋臺北，理所當然列出了所有包含「臺北」的內容，但有些時候使用者希望限縮搜尋條件「臺北市裡面的汐止區跟北投區」的結果，或是條件可以自己換「臺北市的名勝古蹟或海水浴場」 … 等，透過兩個外掛的合作就可以做到這件事情。

安裝所需外掛

Toolset Types 外掛

點我開啟外掛連結。

這個外掛小蛙是最近才發現的，他非常方便，可以額外透過 taxonomy 的方式，附加更多屬性(or 分類)到文章上，他還有很多其他功能，但小蛙在這邊只有用到分類的部份，如上面的例子，小蛙想要在「分類」的部份加入臺北市，然後透過 Toolset Types 往下細分臺北市/新北市的各區。

安裝好外掛後，點選 Toolset -> 分類

小蛙新增了一個新的分類叫做地點，新增的時候會有很多選項，除非有特殊需求或是看得懂設定的意思，不然小蛙是直接用預設

新增完之後可以發現，文章的選單下面多了一個「地點」的選項

進入「地點」選項之後可以開始建立自己要增加的選項

建立好地點之後，便可以開始寫文章了，文章的版面也同樣此時出現了「地點」的選項，如此一來就可以讓文章有「臺北市的分類」又可以有「南港的地點(taxonomy)」

到這邊前置作業就完成了，接下來開始設定 Search 部份。

Search & Filter 外掛

點我開啟外掛連結。點我開啟教學文件。

Search & Filter 是一個非常強大的外掛，有免費版本跟付費版本，小蛙這邊只會使用到免費功能，他可以直接透過 shortcode 的方式在自己想要的地方插入搜尋功能，而且這個搜尋功能不只是基本的搜尋框，可以在搜尋框上附加上其他屬性，例如文章類型、文章分類、taxonomy … 等，這些都是 WordPress 預設沒有的，立馬開始吧！

基本語法大概是長這樣

[searchandfilter fields="search,category,post_tag"]

fields 是要產生搜尋的類型，search 是基本搜尋框、category 是分類，post_tag 是文章標籤，這邊可以看到更多其他可用欄位，都是以一段 shortcode 配上一張結果圖片的方式來介紹用法。

還可以將下拉選單 (select) 換成單選 (radio) 或是多選 (checkbox)，真的是一個非常方便且實用的外掛。除非有特殊需求，不然 Search & Filter 的基本功能就已經非常強大了。

測試的方式可以直接把 shortcode 放進文章裡，或者也可以從外觀 -> 小工具 -> 自訂 HTML

[searchandfilter fields="search,category,place"  types=",select,checkbox" headings=",分類,地區" operators=",,or" show_count=",1,1"]

小蛙需要搜尋框、分類(顯示縣市的)以及 place taxonomy(顯示地區的)，分別是用輸入框、下拉選單、跟多選框來呈現，並切加入分類、地區等標籤，重點是後面這個 operators，這個讓你可以選擇要用 and 或是 or 運算，這個的差別在於如果小蛙選擇了「臺北市」，而地區部份為多選，當使用 and 的情況下，選了「信義」跟「南港」就必須有一個地點同時是信義也同時是南港，才會被搜尋出來，這樣子就不太符合小蛙需求，因為不會有一個地方同時在南港，又同時在信義，這時候就必須多一個 operators 來設定成 or，如此一來輸出條件就變成，符合臺北市信義區或是臺北市南港區的景點，這樣才符合小蛙的需求。而 show_count 就是要不要顯示文章數量，1 是顯示 0 是不顯示。

基本上到這邊應該都能正常運作了，不過小蛙收到的需求是希望可以把多選框改成類似標籤 (tag) 的方式呈現。在剛剛的自訂 HTML 小工具中修改一下內容，看看成果，Search & Filter + Toolset Types 真的是非常方便！

WordPress 5.0 系列：

• WordPress 升級 5.0
• WordPress 5.0 區塊基本使用
• WordPress 5.0 相關問題
• 強化 WordPress 搜尋功能 – Search & Filter + Toolset Types
• WordPress 利用鉤子(Hooks)清除頁面快取

這篇文章 強化 WordPress 搜尋功能 – Search & Filter + Toolset Types 最早出現於 記下來。

【安裝 Remote System Explorer 插件】

開啟 Eclipse 後，找到上方選單列的 Help -> Install New Software… -> Work with: Juno – http://download.eclipse.org/releases/juno (這邊要把 juno 換成自己的版本名稱) -> 搜尋 remote -> 勾選下載以下兩個插件

Remote System Explorer End-User Runtime
Remote System Explorer User Actions

【設定 Remote System Explorer 插件】

安裝完成會要求重新啟動 Eclipse，接著點選右上角的 Open Perspective (有一個 + 的)，選擇 Remote System Explorer 之後就可以看到右上角多了一個 Remote System Exploer 的快速切換按鈕了。

切換到 Remote System Explorer perspective 後，看到左邊 Remote Systems 視窗中有一個 Define a connection to remote system 的按鈕。

選擇 SSH Only，如果要用其他的協定也可以在這邊使用自己要用的協定。

輸入遠端主機相關資訊，Parent profile 系統會自動產生，Host name 輸入遠端位址，填寫完畢後按下 Finish。

在 Remote Systems 可以看到剛剛新增的 remote_moodle 資訊，點進遠端資料夾後會提示登入資訊，登入成功後就可以瀏覽遠端資料夾了。

【讓 Remote System Explorer 插件支援 PHP】

Remote System Explorer 剛安裝完成的時候，開啟 PHP 檔案時，自動完成的功能會有問題，從參考資料2中發現解法(裡面也包含了很多更詳細的設定)，需要做一些設定檔的修改才可以正常使用，首先設定讓所有的檔案都不隱藏(設定檔是隱藏檔)，Eclipse -> Window -> Preferences。

找到 Remote Systems -> Files -> 把 Show hidden files 打勾 -> OK。

找到 Eclipse 的 workspace 路徑，以 XP 為例，Eclipse 預設在 「C:\Documents and Settings\User\workspace」(User 換成自己登入用的那個)，找到 workspace 下 RemoteSystemsTempFiles 資料夾，裡面有個 .project 檔案。

開啟後加入以下兩行(參考資料2)

<nature>org.eclipse.wst.jsdt.core.jsNature</nature>
<nature>org.eclipse.php.core.PHPNature</nature>

存檔後重新啟動 Eclipse，開啟 PHP 檔案試試看，自動完成的功能可以使用囉！

 
補充：小蛙發現這邊頂多做到自動完成，但其實有一個最最重要的功能並沒有辦法達到，就是 ctrl + click 點選 function 或變數名稱的時候沒辦法直接跳到該 function 或變數所在位置，後來在參考資料2中的問答中找到答案，難怪小蛙昨天試的時候還可以，今天再試就不行了，因為把昨天測試的 project 砍掉了 ><，做法就是 import 一份遠端的檔案到 PHP perspective 中，這樣在 Remote System Explorer 就可以直接有上述功能了！
補充：要讓 RSE 可以直接透過 click + function 就跳到 function 所在的檔案，主要是該檔案必須要開啟過，也就是說如果有用到 get_username(); 這個 function，而這個 function 存在在 fun_lib.php 的話，那麼在開啟過 fun_lib.php 後，custom function 的自動完成以及 click to function 的功能就會自動跑出來囉！試了好久才發現這件事情，為什麼”開啟過”就會自動 link 呢？原因在於開啟之後，會在 RemoteSystemsTempFiles 下面放置下載下來的檔案(開啟的時候 Eclipse 就做下載動作了)，最後一個有趣的事情來了，小蛙在編輯 moodle 頁面的時候，裡面有一大堆一大堆看都沒看過的 function，自然也就不知道要去開啟哪些檔案來讓 Eclipse link，後來找到一個方法，在 Remote System Explorer  perspective 下，在要編輯的資料夾上點選滑鼠右鍵 -> Synchronize Cache，這樣就可以把該資料夾下的所有檔案先抓一份回來，剩下的就不說囉(這邊如果檔案數量很大的話，可以透過 Monitor (或 Show in Table 都可以)，在要抓回來的資料夾上點選滑鼠右鍵 -> Synchronize Cache 也可以喔！

【Remote System Explorer 將遠端專案匯入成本機專案(補充)】

Remote System Explorer 也可以直接匯入遠端 Project 到本機中，但是這樣在本機修改之後就要自己想辦法”放”回遠端，之前已經做過一些設定，也一併記錄在這邊。
先切換到 PHP perspective。

新增一個 Project。

選擇 General -> Project (一般專案)

輸入專案名稱後點選 Finish。

切換到 Remote System Explorer perspective 在要匯入的專案上點選滑鼠右鍵，選擇 Import To Project。

這邊卡了非常非常久，因為小蛙要匯入的專案很大，到這個頁面的時候，一直出現 Enter or select a source folder. 的錯誤，導致 Finish 無法成功按下，後來才發現右下角有一個 Querying All 的進度條在跑，大一點的專案甚至可能要等超過十分鐘，Into folder: 這邊選擇要匯入的專案中(這邊例子是剛剛建立的 test)。

完成後切回 PHP perspective，就可以看到剛剛匯入的專案在這邊了(因為要抓太久，小蛙拿之前抓好的圖來替代)，在專案上點選滑鼠右鍵 -> Configure -> Add PHP Support … 讓專案變成 PHP 專案，大功告成！

參考資料：

1. 在 Eclipse 上開發 PHP 程式(以 Moodle、EGit、PDT 為例) @ 蛙齋
   
   http://wazai.net/2539/%E5%9C%A8eclipse%E4%B8%8A%E9%96%8B%E7%99%BCphp%E7%A8%8B%E5%BC%8F%E4%BB%A5moodle%E3%80%81egit%E3%80%81pdt%E7%82%BA%E4%BE%8B
2. How to setup Eclipse with PHP PDT, Remote System Explorer, Theme Manager, and Drupal Plugins @ Patrick J Waters
   
   http://www.patrickjwaters.com/blog/2011-07-24/how-setup-eclipse-php-pdt-remote-system-explorer-theme-manager-and-drupal-plugins/35
3. Code Completion not working with remote file (with RSE) @ stackoverflow
   
   http://stackoverflow.com/questions/5896909/code-completion-not-working-with-remote-file-with-rse

這篇文章 Eclipse SSH 匯入遠端專案(RSE: Remote System Explorer) 最早出現於 記下來。