Drupal 7

ctools：深入研究Drupal 7

>中的自定義插件創建

ctools是必不可少的Drupal 7模塊，為眾多其他模塊（如視圖和麵板）構成了基礎。 其廣泛的API和功能通過提供對象緩存，配置導出性，表單嚮導，對話框和強大的插件系統等功能來簡化模塊的開發。 本文探討了CTools插件，重點是創建自定義插件。我們將構建一個簡化Drupal 7塊定義的模塊，鏡像Drupal 8的更簡化方法

密鑰概念：

• > ctools的角色：插件定義：
創建自定義插件涉及使用
• >定義插件類型，用指定插件目錄並創建單個插件文件。 > hook_ctools_plugin_type()塊系統轉換：本教程演示瞭如何利用Ctools插件來創建用於Drupal 7塊的基於插件的系統，以取代傳統的基於掛鉤的方法。 hook_ctools_plugin_directory()>
• >簡化的塊定義：自定義插件系統通過消除重複和
實現的需求來簡化塊創建。 >
• 構建hook_block_info()模塊：hook_block_view()>
>我們將創建一個模塊，該模塊將Drupal 7的塊系統轉換為基於插件的體系結構。 首先創建

>文件：

block_plugin接下來，在>內，我們使用

>

定義插件類型 block_plugin.info

<code>name = Block Plugin
description = Simplifies Drupal 7 block definition using cTools plugins.
core = 7.x
dependencies[] = ctools</code>

回調，block_plugin.module，準備插件數據：> hook_ctools_plugin_type()

我們還需要

function block_plugin_ctools_plugin_type() {
  return array(
    'block' => array(
      'label' => 'Block',
      'use hooks' => FALSE,
      'process' => 'block_plugin_process_plugin'
    )
  );
}

>告訴ctools在哪裡可以找到我們的插件：>

與Drupal Block系統集成：processblock_plugin_process_plugin()：

function block_plugin_process_plugin(&$plugin, $info) {
  // ... (Code to generate admin title, set 'show title', and define view/configure/save callbacks as shown in the original example) ...
}

現在，我們將插件系統連接到Drupal的塊系統。

將我們的插件註冊為塊：hook_ctools_plugin_directory()

在

function block_plugin_ctools_plugin_directory($module, $plugin) {
  if ($module == 'block_plugin' && in_array($plugin, array_keys(block_plugin_ctools_plugin_type()))) {
    return 'plugins/' . $plugin;
  }
}

創建一個塊插件：

>

在hook_block_info()>目錄中創建一個文件（例如，

）：

function block_plugin_block_info() {
  $blocks = array();
  $plugins = block_plugin_get_all_plugins(); // Helper function to fetch all plugins
  foreach ($plugins as $plugin) {
    $blocks[DELTA_PREFIX . $plugin['name']] = array(
      'info' => $plugin['admin title'],
    );
  }
  return $blocks;
}

// Helper function to get all plugins
function block_plugin_get_all_plugins() {
  return ctools_get_plugins('block_plugin', 'block');
}

define('DELTA_PREFIX', 'block_plugin_');

hook_block_view()清除Drupal的緩存後，您的自定義塊將出現在塊管理接口中。

function block_plugin_block_view($delta = '') {
  $plugin = block_plugin_plugin_from_delta($delta); // Helper to get plugin from delta
  if (!$plugin) { return; }
  $block = array();
  if (isset($plugin['title']) && $plugin['show title'] !== FALSE) {
    $block['subject'] = $plugin['title'];
  }
  $block['content'] = $plugin['view']($delta);
  return $block;
}

// Helper function to get plugin from delta
function block_plugin_plugin_from_delta($delta) {
  $prefix_length = strlen(DELTA_PREFIX);
  $name = substr($delta, $prefix_length);
  $plugin = block_plugin_get_plugin($name);
  return $plugin ? $plugin : FALSE;
}

// Helper function to get a single plugin
function block_plugin_get_plugin($name) {
  return ctools_get_plugins('block_plugin', 'block', $name);
}

結論：

>這種增強的解釋提供了對在Drupal 7中創建自定義ctools插件的更全面的理解，特別是在簡化了Drupal Block Management中的應用。 請記住，請諮詢CTOOLS文檔以獲取更多詳細信息和高級功能。

以上是Drupal 7的詳細內容。更多資訊請關注PHP中文網其他相關文章！