如何在 ExpressionEngine 2.x 中的发布表单上添加新选项卡

Question

我正在编写一个在提交条目时调用的扩展。
现在我想在发布中添加一个包含几个字段的选项卡？

我可以从扩展中执行此操作吗？

我知道有 EE1.x 挂钩 - publish_form_new_tabs、publish_form_new_tabs_block ....
但我需要这个用于 EE 2.x

Answer 1

2.x 模块 API 允许这样做。此处的文档：http://expressionengine.com/user_guide/development/modules.html

可以将相同类型的模块和扩展与如下结构组合起来：

/system/expressionengine/third_party/addon_name/
    ext.addon_name.php
    language/
        english/
            lang.addon_name.php
    mcp.addon_name.php
    mod.addon_name.php
    tab.addon_name.php # Add fields to tab here, per API spec
    upd.addon_name.php # Add/remove tab here, per API spec

当用户安装扩展或模块时，系统会自动询问他们是否要同时安装两者。显然，如果目的只是向发布者添加选项卡/字段，则您的 mcp 和 mod 类可能只是成功安装模块所需的最低限度。

希望这是一个好的起点。

Answer 2

要补充第一个答案，

我经常遇到的问题是没有在模块的更新文件中的任何位置调用 add_layout_tabs 方法（即以 upd.< 开头的文件）。 /code>）

所以假设您的更新文件名为：upd.addon_name.php。然后在 install 中看起来像这样（注意：以下函数都是更新文件中 Addon_name_upd 类的一部分：

function install () {

  // ... create databases or any necessary code for your module

  $this->EE->load->library('layout');
  $this->EE->layout->add_layout_tabs($this->tabs(), 'addon_name');

  return TRUE;
}

注意对 $this-> 的调用;tabs() 方法：该方法看起来像这样：

function tabs() {
  $tabs['addon_name'] = array(
    'field_1_inside_publish_form' => array(
    'visible'   => 'true',
    'collapse'=> 'false',
    'htmlbuttons'   => 'true',
    'width' => '100%'
    )
  );

  return $tabs;
}

其中 field_1_inside_publish_form 是在模块的相应选项卡文件中定义的字段（即 tab.addon_name. 。

安装方法实际上会将新选项卡保存到包含模块选项卡配置的现有发布布局中，

但是，您必须通过调用在更新文件的卸载方法中添加一个方法来删除配置 delete_layout_tabs 方法如下：

function uninstall() {

  // necessary code to drop your database tables or whatever

 $this->EE->load->library('layout');
 $this->EE->layout->delete_layout_tabs($this->tabs(), 'addon_name');

 return TRUE;

} 

还有一件事，如果你像我一样开发：在这里做一点更改，测试你的更改，返回并编写更多代码，然后你会发现如果有新字段启用模块后添加到选项卡文件 tab.addon_name.php 的内容不会出现在发布页面上的新选项卡中，原因是 add_layout_tabs 方法。您调用需要运行的更新文件的安装方法。

但是，只有当您启用模块时才会执行此方法。因此，这意味着您必须禁用您的模块，如果您的模块添加了数据库表，这将是一个拖累。幸运的是，您可以使更新文件的更新方法加载新的选项卡配置（除了添加或删除任何新的数据库表作为模块更新的一部分之外）。

其想法是删除以前的配置并添加配置，其中，调用您的 tabs 方法，该方法具有模块选项卡部分的新字段的名称。

因此，假设您的 tabs 方法有一个名为 'field_2_inside_publish_form' 的新字段，如下所示：

function tabs() {
 $tabs['addon_name'] = array(
    'field_1_inside_publish_form' => array(
    'visible'   => 'true',
    'collapse'=> 'false',
    'htmlbuttons'   => 'true',
    'width' => '100%'
   ),
   'field_2_inside_publish_form' => array(
    'visible'   => 'true',
    'collapse'=> 'false',
    'htmlbuttons'   => 'true',
    'width' => '100%'
   )
 );   
}

那么您的更新方法可以像这样更新布局（假设您已更新了 $this->version 属性udpate 文件从“1.0”更改为“1.5”。

function update($current='') {
  // don't do anything if the version hasn't changed
  if($current == $this->version) {  
    return FALSE;
  }

  // the version property has  a version higher than current version in db
  // this means the module is being updated.
  if($current < $this->version) {
    // update the tab layout

    // delete old layout
    $this->EE->load->library('layout');
    $this->EE->layout->delete_layout_tabs($this->tabs(), 'addon_name');

    // add new tab layout which calls tabs method with updated code
    $this->EE->load->library('layout');
    $this->EE->layout->add_layout_tabs($this->tabs(), 'addon_name');

  }
  return TRUE;
}   

请记住，每次进入模块控制面板页面时，模块更新文件的更新方法都会在模块控制面板页面中定义。 mcp.addon_name.php ）。您的模块的主控制面板页面可能对应于您的控制面板页面文件的 Addon_name_mcp 类的索引方法。

文件（即 对应于这样的链接 uri： admin.php?S=0&D=cp&C=addons_modules&M=show_module_cp&module=addon_name&method=index

希望这有点长。啰嗦，但我写它更多的是为了我自己的利益而不是为了其他人（因为我浪费了大约 3 个小时试图让我的模块工作。）