模組推薦:快速新增 MENU 至內容類型 (Content Types)

大家都知道新增選單 (MENU) 後,可以到內容類型管理頁面啟用,增加到 NODE 編輯頁面。

數個步驟,當只有兩個內容類型時,還好。若要增加至十個或更多類型中很要命。以下模組正解決了此問題:

Content types per menu
http://drupal.org/project/ct_per_menu

啟用後可在 MENU 管理頁面進行管理

修改 Drupal Views SQL 沒難度![hook_views_query_alter]

Drupal Views 讓你可透過界面設定所需條件,輕鬆抓取特定資料。不過開發者創意無限,Views 架構沒可能完全滿足您的要求。在此時,可以考慮使用 hook_views_query_alter() 修改/增強 Views 預設不能滿足的條件。

引用 Drupal Taiwan 論壇上一問題作例子:

做出一個列表,當使用者登入後,可以看到同一組別的成員

對於 Views,這類列表本是很簡單,但要實現時卻發現問題:Views 只能過濾登入使用者的 ID (User: Current)。要以登入使用者的角色或其他因素似乎有點難度。

在主題中,我提出了使用 Contextual 的方案,問題的確能解決,但你的 URL 將變成:my-group-member/{使用者的組別}。也不太完美。(另外,也提及了 Views PHP,估計也能達成效果,但筆者想更深入地看看萬能的方法)

不能確認原發問者需求,為此教程,筆者定義組員列表規格

  • 列表中只能看到同一組別的成員 (此教學中,我們將要列出 K Team 成員)
  • URL:example.com/my-group-member
  • 透過 Profile 增加一個 Team (field_team) 選擇欄位,包括選項:K Team | Drupal Team

 

修改 Views Query

在此略過寫模組的基本需要。我們來建立一個 View,然後如下圖設置。(為了說的更清晰,筆者去除了多餘的設定)
我們增加了 User: Team (= Drupal Team)。這並不是我們想要的,但沒關係,因為即將下來透過程式碼進行修改。

 

此時,如果你有打開 SQL 預覽,可以對比增加 Filter Criteria 前後的 SQL 變化。沒錯,會寫程式的你應看懂 Views 是在做什麼..
([admin/structure/views/settings] -> Live preview settings ->  Show the SQL query)


Views 將一個資料庫表關連了,並設定了 WHERE 過濾條件。所以,我們最終要改變的將是 WHERE 條件中的 IN('Drupal Team') 為當前使用者的 Team

hook_views_query_alter() 真正登場了

*** 下面程式碼包含了詳細註釋,由上至下細看***
(dpm 是 Drupal Devel 模組的 Debug Function)


/**
 * hook_views_query_alter
 * 模組名_views_query_alter
 */
function alterquery_views_query_alter(&$view, &$query) {
  // 看看有什麼東西
  dpm($view, 'Views 的所有資訊');
  dpm($query, 'Views SQL 查詢');

  if (
    // Views 的 Machine Name
    $view->name == 'my_group_member' 
    // Views 頁面 Machine Name (收藏在設定頁面的 Advanced 裏)
    && $view->current_display == 'page' 
  )
  {
    if(!isset($user)) { // $user 是保存當前使用者資訊的變數。在這裏我們檢查有否載入
      $user = user_load($GLOBALS['user']->uid);
    }
    dpm($user, '當前使用者資訊');

    /**
     * $user_team = $user->field_team['und'][0]['value'];
     * 上面這行較直接,但之前談過,由於 Drupal 是支援多語言,這不是最好的方法。
     * 看:https://notabluescreen.com/field_get_items
     */
    $team = field_get_items('user', $user, 'field_team');
    $user_team = $team[0]['value'];
    dpm($team, '使用者組別資訊');


    /**
     * [K-1]我們需要修改 field_data_field_team.field_team_value 這一項
     */
    foreach ($query->where['1']['conditions'] as $key => $value) {
      if ($query->where['1']['conditions'][$key]['field'] == 'field_data_field_team.field_team_value') {
         $query->where['1']['conditions'][$key]['value'][0] = $user_team;
         break;
      }
    }

    // 看看有沒有正確修改
    dpm($query, '修改後的Views SQL 查詢');
  }
}

清除 Drupal Caches,重新整理網頁,應有其效果了!

( 到此為止,要是看不懂,猜想還沒達到 PHP 基本水平。好好再學學 PHP 。 )

 

上面 [K-1] 處的 我們使用了 FOREACH 語句。只要你掌握到所需的資料表,你還可以取消 Filter Criteria: User: Team (= Drupal Team),及將該處程式碼替代為:


// 增加上面關聯的資料表
    $query->add_table('field_data_field_team');
    
    // 增加 WHERE 條件 (不難看出吧!跟上面 [K-1] 的程式碼是對應的)
    $query->add_where(0, 'field_data_field_team.field_team_value', array($user_team), 'in');

 

除了註釋,實際只有十行左右。附上測試模組。

Drupal 程式員不可不看的模組 – Example

CCK 及 Views 是 Drupal 開發者不可缺少的模組,幫助你完成各種任務。不過獨特有個性的網站,難免要親自操刀寫模組。於是熟讀書籍 『Pro Drupal Development』,書內的範例也熟了,還是什麼不懂。尋遍 Drupal.org,想找一個簡單的模組作範例,可是一無所獲。這時候遇上它真是要感恩!

Examples 模組是什麼?

正如其名,Examples 模組是一個範例模組,包含十數個不同示範,展示常用功能的編寫方法,程式碼簡潔,以實現功能為主,多餘的都不寫,絕對是一個值得學習參考的模組。以正規模組身份發佈在 Drupal.org 上,高手們都來檢閱,出錯機會減少,質素優良。

看看 Examples 模組包含了那些示範:

http://d7.drupalexamples.info

取得 Examples 模組: