drupal-7 - 如何以及在哪里编写 Webform 提交钩子(Hook)？

Question

我是 Drupal(7) 的新手，因此在以下情况下需要一些帮助。

我已经创建了一个 Webform(我也有其他 Webform)，现在我希望将此 webfrom 插入到 myTable 中，而不是插入默认的 webform_subscribed_data 表中。根据我的发现，我需要为此编写一个钩子(Hook)。事实上，我对编写这个钩子(Hook)的方式感到困惑。我有以下问题。

1. 在哪里编写这个钩子(Hook)(在哪个文件中)。
2. 如何仅为一个 Web 表单编写此 Hook 。

如果您需要更多信息，请帮助并告诉我。

Answer 1

首先，在你开始扭转 Drupal 的 ARM 以使事情以不同于预期的方式工作之前，请务必确定。重新路由 Webform 的数据可能会导致 Webform 的工作方式出现问题，这可能会在以后给您带来麻烦。它可能仍然希望将数据保存在自己的簿记表中，但如果您覆盖其行为，稍后将无法在那里找到它。

话虽如此，如果您希望更改其他模块(例如 Webform)的行为，则必须编写自己的小模块。其中一些钩子(Hook)也可以通过模板层(使用模板 template.php 文件)受到影响，但在我看来，这是改变这种行为的错误位置。

Drupal 7 模块基本上由至少两个文件组成，一个 *.info文件和 *.module文件。前者包含 Drupal 对模块进行分类和计算可能的依赖关系所需的一些元数据。后者包含实际的 PHP 代码。

这些文件必须保存在(最好)与您命名为 info 相同的目录中。和module文件。为了让 Drupal 找到您的模块，您可以将其放在 sites/all/modules 下.

例如，如果您将模块命名为 changemyform，则这些是所需的最少文件:

• changemyform.info
• changemyform.module

两者都应位于:sites/all/modules/changemyform。

我建议你检查Drupal's developer's manual有关编写模块的更详细说明，包括许可、单元测试……。但对于这个例子，提到的两个文件就可以了。

在您的 info 中在文件中，您至少必须写下模块的名称、一个简短的描述、它适用于哪个核心版本以及它具有哪些依赖项。对于我们的例子来说，这样的东西就足够了:

name = Change my form
description = Changes the submission behavior of my form.
core = 7.x
dependencies[] = webform

接下来我们应该编写 module 的逻辑文件本身。拦截任何表单提交(包括 Webform)的一般钩子(Hook)是:

function mymodule_form_alter( &$form, &$form_state,$form_id ){
  ...
}

使用这个钩子(Hook)，顾名思义，您可以更改使用 Drupal 呈现的所有表单。不仅是提交处理程序，还包括添加/删除字段、添加标记……。将 mymodule 替换为模块的实际名称，在我们的示例中 changemyform。接下来，您需要缩小范围以仅影响您想要的形式:

function changemyform_form_alter( &$form, &$form_state,$form_id ){
  if ($form_id == 'my_desired_webform_form_id') {
    $form['#submit'][] = 'changemyform_submit_handler';
  }
}

请注意，我现在替换了 mymodule与 changemyform 。您还可以看到，我已将自定义处理程序添加到表单的提交属性中。您必须将此处理程序编写为函数，然后该函数将包含您想要的所有逻辑。因此总计module文件现在变成(减去 <?php ?> 标签):

function changemyform_form_alter( &$form, &$form_state,$form_id ){
  if ($form_id == 'my_desired_webform_form_id') {
    $form['#submit'][] = 'changemyform_submit_handler';
  }
}

function changemyform_submit_handler($form, &$form_state) {
  ... your submission logic ...
}

现在您已准备好编写捕获提交数据所需的所有逻辑并按照您的意愿进行操作。

由于这是一个模块，因此您当然应该在管理模块概述屏幕中启用它才能正常工作。

另外(作为一个挑剔的人)在编写自己的模块时，请使用文档标题来装饰每个函数，这些文档标题描述每个函数的作用以及每个参数可以包含什么。即使对于微小、琐碎的功能也是如此。