Como adicionar um módulo à página admin / config?

27

Estou trabalhando em um módulo no Drupal 7. Adicionei uma implementação hook_menu:

$items['admin/config/content/mymodule'] = [
  'title'            => 'MyModule',
  'description'      => 'Configure MyModule settings.',
  'page callback'    => 'mymodule_get_form',
  'page arguments'   => ['mymodule_admin_settings'],
  'file'             => 'mymodule.admin.inc',
  'access arguments' => ['administer mymodule'],
  'menu_name'        => 'mymodule',
];

... e uma linha de configuração para mymodule.info:

configure = admin/config/content/mymodule

Um link Configure para MyModule agora aparece na página admin / modules , mas como também posso listar o módulo na página admin / config ? Ou a página admin / config está reservada apenas para os módulos principais?

Matt V.
fonte

Respostas:

9

Observando o código de system_admin_config_page () , que é o retorno de chamada da página para admin / config, percebo que ele contém as seguintes linhas:

if ($admin = db_query("SELECT menu_name, mlid FROM {menu_links} WHERE link_path = 'admin/config' AND module = 'system'")->fetchAssoc()) {
  $result = db_query("
    SELECT m.*, ml.*
    FROM {menu_links} ml
    INNER JOIN {menu_router} m ON ml.router_path = m.path
    WHERE ml.link_path != 'admin/help' AND menu_name = :menu_name AND ml.plid = :mlid AND hidden = 0", $admin, array('fetch' => PDO::FETCH_ASSOC));
  foreach ($result as $item) {
    _menu_link_translate($item);
    if (!$item['access']) {
      continue;
    }
    // ...
  }
  // ...
}

A primeira consulta selecione o campo menu_name para o menu associado ao caminho admin / config, que por padrão é management; a segunda consulta seleciona todos os menus que têm o mesmo valor para menu_name e cujo pai é admin / config.

Como seu menu usa um valor diferente para menu_name, ele não é selecionado na segunda consulta e não é exibido na página admin / config.

kiamlaluno
fonte
24

Se você fizer assim, com o retorno de chamada system.module para o item pai, você obtém a boa página de listagem ao visitar 'admin / config / mymodule'

/**
 * Implements hook_menu().
 */
function MYMODULE_menu() {

  $items = [];

  $items['admin/config/mymodule'] = [
    'title'            => 'My configuration section',
    'description'      => 'This is the parent item',
    'position'         => 'left',
    'weight'           => -100,
    'page callback'    => 'system_admin_menu_block_page',
    'access arguments' => ['administer site configuration'],
    'file'             => 'system.admin.inc',
    'file path'        => drupal_get_path('module', 'system'),
  ];

  // Need at least one child item before your section will appear.
  $items['admin/config/mymodule/item'] = [
    'title'            => 'First item',
    'description'      => 'This is the first child item in the section',
    'page callback'    => 'mymodule_item_callback',
    'access arguments' => ['administer site configuration'],
  ];

  return $items;
}
wynz
fonte
3
Não esqueça que você precisará desativar e ativar o módulo para que as alterações no menu entrem em vigor.
Jevon
5
@ jevon: limpar o cache (do menu) é adequado para ver as alterações.
Bart
o cache do menu pode ser limpo usando drush na linha de comando usando drush cc menu- ref: drupal.stackexchange.com/a/58621/1082
therobyouknow
3

Remova a parte 'menu_name', isso não é necessário.

Berdir
fonte
1

Eu também tive problemas com isso na página de configuração. A única maneira de adicionar o link à página de configuração foi declarar dois itens de menu, com o link pai em 'admin / config / module' e um link filho em 'admin / config / module / manage' .

  $items['admin/config/whh-maps'] = array(
    'title' => 'World Hiphop configuration',
    'description' => 'Allows administrators to configure maps for WHH.',
    'position' => 'left',
    'weight' => -30,
    'page callback' => 'drupal_get_form',
    'page arguments' => array('whh_maps_form'),
    'access arguments' => array('administer whh maps'),
    'file' => 'whh_maps.admin.inc',
  );
  $items['admin/config/whh-maps/manage'] = array(
    'title' => 'Manage countries',
    'description' => 'Allows admins to edit country information',
    'page callback' => 'drupal_get_form',
    'page arguments' => array('whh_maps_form'),
    'access arguments' => array('administer whh maps'),
    'file' => 'whh_maps.admin.inc',
    'weight' => -10,
  ); 
chhay
fonte
1
$items['admin/config/user-interface/mymodule'] = array(
    'title' => 'My Module',
    'description' => 'description',
    'page callback' => 'drupal_get_form',
    'page arguments' => array('my_admin_function'),
    'access arguments' => array('administer site configuration'),
);

$items['admin/config/user-interface/mymodule/manage'] = array(
    'title' => 'My Module',
    'type' => MENU_DEFAULT_LOCAL_TASK,
    'description' => 'description',
    'weight' => -10,
);
return $items;

isso funcionou para mim.
Na verdade, eu estava lutando por cerca de meia hora até perceber que não estava devolvendo itens ... ... sempre pareço fazer isso.

2pha
fonte
0
/**
 * Implements hook_menu().
 */
function notification_menu() {

  $items = [];

  $items['admin/customize'] = [
    'title'            => 'Send Comment notifications',
    'discription'      => 'Admin will send notification to user about updates',
    'type'             => MENU_NORMAL_ITEM,
    'page callback'    => 'drupal_get_form',
    'page arguments'   => ['notification_form'],
    'access arguments' => ['access adminstration page'],
    'access callback'  => TRUE,
  ];

  return $items;
}

/**
 * Custom form.
 */
function notification_form($form, &$form_state) {

  $form['send_mail_to'] = [
    '#title'         => 'Send Mail To',
    '#discription'   => 'To whom you want to send form',
    '#size'          => 40,
    '#type'          => 'textfield',
    '#required'      => TRUE,
    '#default_value' => variable_get('send_mail_to'),
  ];

  //here the admin can wite subject for the mail.
  $form['mail_subject'] = [
    '#title'         => 'Subject',
    '#discription'   => 'the purpous of this mail',
    '#type'          => 'textfield',
    '#size'          => 40,
    '#maxlenght'     => 120,
    '#required'      => TRUE,
    '#default_value' => variable_get('mail_subject'),
  ];

  $form['mail_body'] = [
    '#title'         => 'Body',
    '#discription'   => 'the body of your mail.',
    '#type'          => 'textarea',
    '#row'           => 10,
    '#columns'       => 40,
    '#required'      => TRUE,
    '#default_value' => variable_get('mail_body'),
  ];

  $form['mail_bcc'] = [
    '#title' => 'BCC this mail to all',
    '#type'  => 'checkbox',

  ];

  return system_settings_form($form);
}
Nikhil Anant
fonte
11
Isso não responde à pergunta, pois não diz por que o OP não está vendo o módulo listado na página de administração; além disso, respostas somente de código não são muito úteis. (Verifique o código: Você tem alguns erros de digitação.)
kiamlaluno