materio-base-legacy/simplemenu.admin.inc
Alexis Wilke 5109e619cc Changes to support a fixed position (i.e. does not scroll with the page.)
Put the menu inside a <div> block (so fixed position works.)
Added support to switch between versions of superfish.
Added support for z-index parameter in admin screen.
2010-05-15 10:47:59 +00:00

230 lines
9.5 KiB
PHP

<?php
// $Id$
/**
* @file
* Settings of the simplemenu.
*/
/**
* SimpleMenu settings page.
*/
function simplemenu_admin_settings() {
// menu selection
$form['default_menu'] = array(
'#type' => 'fieldset',
'#title' => t('Menu settings'),
'#collapsible' => TRUE,
'#collapsed' => FALSE,
);
if (module_exists('menu')) {
$form['default_menu']['simplemenu_menu'] = array(
'#type' => 'select',
'#title' => t('Menu'),
'#options' => menu_parent_options(menu_get_menus(), array( 'mlid' => 0 )), // return complete tree;
'#default_value' => variable_get('simplemenu_menu', 'navigation:0'),
'#description' => t('Select the menu to display.'),
);
}
if (module_exists('devel')) {
$form['default_menu']['simplemenu_devel'] = array(
'#type' => 'checkbox',
'#title' => t('Add devel module links'),
'#default_value' => variable_get('simplemenu_devel', 0),
'#description' => t('Add devel module links for those users that can access the devel module.'),
);
}
$form['default_menu']['simplemenu_theme'] = array(
'#type' => 'select',
'#title' => t('Theme'),
'#options' => array(
'original' => t('original'),
'blackblue' => t('black & blue'),
'custom' => t('custom'),
),
'#default_value' => variable_get('simplemenu_theme', 'original'),
'#description' => t('Select which theme to use. If you specify custom, you need to define CSS in your theme.'),
);
// standard settings
$form['settings'] = array(
'#type' => 'fieldset',
'#title' => t('Simplemenu settings'),
'#collapsible' => TRUE,
'#collapsed' => TRUE,
);
$fix_options = array(
'scroll' => t('Scroll with page'),
'top' => t('Fix at the Top (Forces Body, Prepend)'),
//'bottom' => t('Fix at the Bottom (Forces Body, Append)'), -- this requires another CSS... hmmm...
);
$form['settings']['simplemenu_fix'] = array(
'#type' => 'radios',
'#title' => t('Scroll or fix menu'),
'#options' => $fix_options,
'#default_value' => variable_get('simplemenu_fix', 'scroll'),
'#description' => t('Select the mode to use. The default is to let the menu scroll with the page.<br /><span style="color: red;">WARNING:</span> The At the Top/Bottom options prevent you from ever seeing the bottom of your drop-down menus. In other words, if you have many modules installed, it is not unlikely that your <em>Site configuration</em> menu will not fit the screen and the last few entries won\'t be accessible via Simplemenu.'),
);
$form['settings']['simplemenu_hide_delay'] = array(
'#type' => 'textfield',
'#title' => t('Hide delay'),
'#size' => 4,
'#default_value' => variable_get('simplemenu_hide_delay', 800),
'#description' => t('How long (in milliseconds) should a menu still appear after losing focus.'),
);
$form['settings']['simplemenu_effect'] = array(
'#type' => 'radios',
'#title' => t('Show effect'),
'#options' => array(
'opacity' => t('Fade'),
'height' => t('Slide'),
'none' => t('None')
),
'#default_value' => variable_get('simplemenu_effect', 'opacity'),
'#description' => t('The effect used when displaying a menu.'),
);
$form['settings']['simplemenu_effect_speed'] = array(
'#type' => 'radios',
'#title' => t('Show speed'),
'#options' => array('slow' => t('Slow'), 'medium' => t('Medium'), 'fast' => t('Fast')),
'#default_value' => variable_get('simplemenu_effect_speed', 'fast'),
'#description' => t('The speed of the effect, not used when "none" is set to show effect.'),
);
// advanced options
$form['advanced'] = array(
'#type' => 'fieldset',
'#title' => t('Advanced settings'),
'#collapsible' => TRUE,
'#collapsed' => TRUE,
);
$form['advanced']['simplemenu_uid1'] = array(
'#type' => 'checkbox',
'#title' => t('Show to User ID 1'),
'#description' => t('Check this option to enable simplemenu for user 1 (superuser/administration). This is useful if you want to use a different menu (such as admin_menu) for the superuser/admin and simplemenu for others.'),
'#default_value' => variable_get('simplemenu_uid1', 1),
);
$simplemenu_path = drupal_get_path('module', 'simplemenu');
$superfish = file_scan_directory($simplemenu_path, '^superfish-[0-9.]*\.js$',
array('.', '..', 'CVS', '.svn'), 0, FALSE, 'basename');
foreach ($superfish as $name => $ignore) {
$superfish[$name] = $name;
}
$form['advanced']['simplemenu_superfish_version'] = array(
'#type' => 'select',
'#title' => t('SuperFish Version'),
'#options' => $superfish,
'#description' => t('Select which version of SuperFish you prefer using.') .$simplemenu_path,
'#default_value' => variable_get('simplemenu_superfish_version', 'superfish-1.4.1.js'),
);
$form['advanced']['simplemenu_menubar_zindex'] = array(
'#type' => 'textfield',
'#title' => t('Menubar CSS z-index value'),
'#description' => t('By default, the menubar CSS z-index is set to 1. Some themes or other modules may require you to change this value. Use -1 to completely disable the z-index in the menubar.'),
'#default_value' => variable_get('simplemenu_menubar_zindex', 9999),
);
$form['advanced']['simplemenu_dropdown_zindex'] = array(
'#type' => 'textfield',
'#title' => t('Dropdown CSS z-index value'),
'#description' => t('By default, the dropdown CSS z-index is set to 9999. However, some themes and modules use an even larger z-index. For instance, the AddThis overlay is put at z-index 100,000 (although from my tests, it seems that they use a much higher z-index...). So if you want the Simplemenu to appear over the AddThis pop-up, you want to use a z-index which is even larger (i.e. 2,000,000 [do not enter the commas!].) On the other hand, 9999 may be too large for your site. You can use a smaller number if that works better for you. Use -1 to not remove the z-index from your dropdown.'),
'#default_value' => variable_get('simplemenu_dropdown_zindex', 9999),
);
$form['advanced']['simplemenu_element'] = array(
'#type' => 'textfield',
'#title' => t('CSS selector to attach menu to'),
'#default_value' => variable_get('simplemenu_element', 'body'),
'#description' => t('A valid CSS selector to attach the menu to. <em>Example: body, #primary, div.my-class</em>'),
'#required' => TRUE,
);
$form['advanced']['simplemenu_element_method'] = array(
'#type' => 'radios',
'#title' => t('Attach method'),
'#options' => array(
'prepend' => t('Prepend'),
'append' => t('Append'),
'replace' => t('Replace'),
),
'#default_value' => variable_get('simplemenu_element_method', 'prepend'),
'#description' => t('Choose how the menu should be attached to the above selector.<br /><span style="color: red;">WARNING:</span> The Replace option should only be used with a specialized theme that offers a tag that is to be replaced by the simple menu. Make sure you don\'t use that option with your body!'),
'#required' => TRUE,
);
// when someone has many themes, this list grows big!
$themes = list_themes();
$use_list = count($themes) > 15;
$form['advanced']['simplemenu_exclusions'] = array(
'#type' => $use_list ? 'select' : 'checkboxes',
'#title' => t('Theme exclusions'),
'#options' => drupal_map_assoc(array_keys($themes)),
'#multiple' => $use_list,
'#default_value' => variable_get('simplemenu_exclusions', array()),
'#description' => t('Select which themes to <strong>not</strong> display the menu. Use this when you have a theme that displays its own admin navigation.'),
);
$form['advanced']['simplemenu_detect_popup'] = array(
'#type' => 'checkbox',
'#title' => t('Detect pop-up windows'),
'#default_value' => variable_get('simplemenu_detect_popup', 1),
'#description' => t("Choose whether SimpleMenu should attempt to detect if it is inside of a pop-up window. If enabled, SimpleMenu will not display if it is inside of a pop-up window."),
);
$form['advanced']['simplemenu_visibility_operator'] = array(
'#type' => 'radios',
'#title' => t('Show block on specific pages'),
'#default_value' => variable_get('simplemenu_visibility_operator', 0),
'#options' => array(
0 => t('Show on every page except the listed pages.'),
1 => t('Show on only the listed pages.'),
),
);
$form['advanced']['simplemenu_visibility_pages'] = array(
'#type' => 'textarea',
'#title' => t('Pages'),
'#default_value' => variable_get('simplemenu_visibility_pages', ''),
'#description' => t("Enter one page per line as Drupal paths. The '*' character is a wildcard. Example paths are %blog for the blog page and %blog-wildcard for every personal blog. %front is the front page.",
array('%blog' => 'blog', '%blog-wildcard' => 'blog/*', '%front' => '<front>')),
'#wysiwyg' => FALSE,
);
$form['#validate'][] = 'simplemenu_admin_settings_validate';
$form['#submit'][] = 'simplemenu_admin_settings_submit';
return system_settings_form($form);
}
/**
* Verify that we have settings that are sensical.
*/
function simplemenu_admin_settings_validate($form, &$form_state) {
$values = &$form_state['values'];
if ($values['simplemenu_fix'] != 'scroll' && $values['simplemenu_menubar_zindex'] < 1) {
form_set_error('simplemenu_menubar_zindex', t('In order to use a Fix mode, you want to increase the menubar z-index value to 1 or more.'));
}
}
/**
* Handle some special cases.
*/
function simplemenu_admin_settings_submit($form, $form_state) {
// make sure we regenerate the CSS file
variable_set('simplemenu_css_filename', '');
}
// vim: ts=2 sw=2 et syntax=php