Tudor Sitaru

Ever needed to add extra tabs or categories in CTool’s Page Manager module interface ? Well, I had this need and finding the proper hooks to use was not an easy task. However with help from @merlinofchaos, I have learned about the hook_page_manager_variant_operations_alter and the hook_page_manager_operations_alter hooks.

hook_page_manager_variant_operations_alter allows you to add more operations to the variant menu. A simple example would be:

function example_page_manager_variant_operations_alter(&$operations, $handler) {
  if ($handler->task == 'site_template') {
    return;
  }

  // Use this obnoxious construct to safely insert our item.
  reset($operations['children']);
  $new = array();
  while (list($key, $value) = each($operations['children'])) {
    $new[$key] = $value;
    if ($key == 'preview') {
      $new['new_tab'] = array(
        'title' => t('New Tab'),
        'description' => t('New tab.'),
        'form' => 'new_tab_edit',
      );
    }
  }
  $operations['children'] = $new;
}

using the hook_page_manager_operations_alter you can add more categories/tabs to the Page Manager interface:

function example_page_manager_operations_alter(&$operations, $handler) {
  if ($handler->task == 'site_template') {
    return;
  }
  $operations['example_module'] = array(
      'title' => 'Example Module',
      'description' => 'Example module section',
      'type' => 'group',
      'class' => 'operations-settings',
      'children' => array(
        'embed' => array(
                    'title' => t('Example tab'),
                    'description' => t('An example tab.'),
                    'form' => 'example_tab_form',
                    )
        )
  );
}

Hope this helps!