l(t('the views help page'), 'admin/help/views_ui'))); case 'export': return t('You may cut & paste this view into an import function on another system. The view will only work if all modules required by the view are installed on the target location.'); } } } /* * Because the add/edit page is kind of complicated. */ function _views_ui_help_add() { $output = t('
A view retrieves some number of nodes from the database and displays them in a variety of formats.
'); $output .= t("When using List or Table view, it is necessary to choose which fields will be displayed to the user.
Arguments can be passed to the View through the URL, in order to create views that are configurable by the user. This is very useful to create views for taxonomy, or to sort by user. When using arguments, substitution is performed on the title. %1 will represent argument 1, %2 will represent argument 2. Each argument has a title field; this title is used if providing a summary view (which can matter because the argument is missing which could result in confusing phrases such as 'view for')
Views may be filtered to restrict the view on a number of criteria.
The result set may be sorted on any of the following criteria.
No views have currently been defined.
'); } $result = db_query("SELECT name FROM {view_view}"); while ($view = db_fetch_object($result)) { $used[$view->name] = true; } $output .= t('Below are system default views; if you edit one of these, a view will be created that will override any system use of the view.
'); $items = array(); $default_views = _views_get_default_views(); $views_status = variable_get('views_defaults', array()); foreach ($default_views as $view) { $url = ($view->page ? l($view->url, $view->url) : t('No Page View')); if ($used[$view->name]) { $status = t('Overridden'); } else if (isset($views_status[$view->name])) { if ($views_status[$view->name] == 'enabled') { $status = t('Enabled'); } else { $status = t('Disabled'); } } else if ($view->disabled) { $status = t('Disabled'); } else { $status = t('Enabled'); } $provides = array(); if ($view->page) { $provides[] = t('Page'); } if ($view->block) { $provides[] = t('Block'); } if ($view->menu) { $provides[] = t('Menu'); } $links = array(l(t('add'), "admin/views/add/$view->name")); if ($status == t('Enabled')) { $links[] = l(t('disable'), "admin/views/disable/$view->name"); } else if ($status == t('Disabled')) { $links[] = l(t('enable'), "admin/views/enable/$view->name"); } $items[] = array($view->name, views_get_title($view, 'menu'), $view->description, implode(', ', $provides), $url, $status, theme('links', $links)); } if ($items) { $output .= theme('table', array(t('Default View'), t('Title'), t('Description'), t('Provides'), t('URL'), t('Status'), t('Actions')), $items, array("cellpadding" => "4"), t('Default Views')); } else { $output .= t('No views have currently been defined.
'); } return $output; } /* * Page to enable a disabled default view */ function views_ui_admin_enable_page($view = '') { if ($view) { $views_status = variable_get('views_defaults', array()); $views_status[$view] = 'enabled'; variable_set('views_defaults', $views_status); menu_rebuild(); } drupal_goto('admin/views'); } /* * Page to disable an enabled default view */ function views_ui_admin_disable_page($view = '') { if ($view) { $views_status = variable_get('views_defaults', array()); $views_status[$view] = 'disabled'; variable_set('views_defaults', $views_status); menu_rebuild(); } drupal_goto('admin/views'); } /* * Provide a textarea to paste a view export into. */ function views_ui_admin_import_page() { $op = $_POST['edit']['name']; if ($op) { return views_ui_admin_add_page(); } drupal_set_title("Import a View"); $form['view'] = array( '#type' => 'textarea', '#title' => t('Import View Code'), '#cols' => 60, '#rows' => 6, '#description' => t('Cut and paste the results of an Export View here.'), ); $form['submit'] = array( '#type' => 'submit', '#value' => t("Submit"), ); return drupal_get_form('views_import_view', $form); } /* * Handle the submit button on importing a view. */ function views_import_view_submit($formid, $form) { ob_start(); eval($form['view']); ob_end_clean(); $tables = array_keys(_views_get_tables()); if ($view) { if (!is_array($view->requires) || !array_diff($view->requires, $tables)) { views_sanitize_view($view); drupal_set_title(t('Add a View')); $output = _views_view_form($view, NULL); print theme('page', $output); exit; } else { drupal_set_message(t("You don't seem to have the following requirements: ") . implode(', ', array_diff($view->requires, $tables))); } } else { drupal_set_message(t('Unable to get a view out of that.')); } } /* * Export a view for cut & paste. */ function views_ui_admin_export_page($vid = '') { $code = views_create_view_code($vid); $lines = substr_count($code, "\n"); $form['code'] = array( '#type' => 'textarea', '#title' => $view->name, '#default_value' => $code, '#rows' => $lines); return drupal_get_form('views_export', $form); } /* * Provide a form to add a view. Allow adding a view from default templates. */ function views_ui_admin_add_page($template = NULL) { $op = $_POST['op']; if ($op == t('Cancel')) { return 'admin/views'; } $view = _views_get_default_view($template); drupal_set_title(t('Add a View')); return _views_view_form($view, $op); } /* * Provide a form to clone a view. */ function views_ui_admin_clone_page($viewname) { $op = $_POST['op']; if ($op == t('Cancel')) { return 'admin/views'; } $view = views_load_view($viewname); if (!$view) { return drupal_not_found(); } unset($view->vid); drupal_set_title(t('Add a View')); return _views_view_form($view, $op); } /* * Provide a form to edit a view. */ function views_ui_admin_edit_page($vid = '') { $op = $_POST['op']; if ($op == t('Cancel')) { drupal_goto('admin/views'); } if ($op == t('Delete')) { drupal_goto("admin/views/delete/$vid"); } if (!($view = _views_load_view($vid))) { drupal_goto('admin/views'); } drupal_set_title(t('Edit view %n', array('%n' => $view->name))); return _views_view_form($view, $op); } /* * Provide a form to confirm deletion of a view. */ function views_ui_admin_delete_page($vid = '') { $view = _views_load_view($vid); if (!$view) { return 'admin/views'; } $form['vid'] = array('#type' => 'value', '#value' => $view->vid); return confirm_form('views_delete_confirm', $form, t('Are you sure you want to delete %title?', array('%title' => $view->name)), $_GET['destination'] ? $_GET['destination'] : 'admin/views', t('This action cannot be undone.'), t('Delete'), t('Cancel') ); } /* * Handle the submit button to delete a view. */ function views_delete_confirm_submit($formid, $form) { if ($form['confirm']) { _views_delete_view((object) $form); menu_rebuild(); return 'admin/views'; } } /* * Get an empty view with basic defaults. */ function _views_get_default_view($template = '') { if ($template) { $default_views = _views_get_default_views(); if (isset($default_views[$template])) { $view = $default_views[$template]; } } if (!$view) { $view = new stdClass(); $view->use_pager = true; $view->nodes_per_page = variable_get('default_nodes_main', 10); $view->page_header_format = variable_get('filter_default_format', 1); $view->page_footer_format = variable_get('filter_default_format', 1); $view->page_header_format = variable_get('filter_default_format', 1); $view->block_header_format = variable_get('filter_default_format', 1); $view->block_footer_format = variable_get('filter_default_format', 1); $view->block_header_format = variable_get('filter_default_format', 1); $view->vid = 0; } return _views_check_arrays($view); } // --------------------------------------------------------------------------- // Select Box Definitions // These should probably have string array keys that are easier to identify. /** * Select box entries for argument defaults. */ function _views_get_arguments_default() { return array( 1 => t('Return Page Not Found'), 2 => t('Display All Values'), 3 => t('Summary, unsorted'), 4 => t('Summary, sorted ascending'), 5 => t('Summary, sorted descending'), 6 => t('Summary, sorted as view'), 7 => t('Use Empty Text'), ); } /** * Select box entries for sort ordering. */ function _views_sortorders() { return array( 'ASC' => t('Ascending'), 'DESC' => t('Descending') ); } /** * Swap two items in an array. */ function _views_swap(&$arr, $a, $b) { $temp = $arr[$a]; $arr[$a] = $arr[$b]; $arr[$b] = $temp; } /** * Move an item up in an array. */ function _views_move_up(&$arr, $i) { if ($i <= 0 || $i >= count($arr)) { return; // can't do it. } _views_swap($arr, $i - 1, $i); } /** * Move an item down in an array. */ function _views_move_down(&$arr, $i) { if ($i >= count($arr) - 1 || $i < 0) { return; // can't do it. } _views_swap($arr, $i + 1, $i); } /** * Move an item to the front of an array. */ function _views_move_top(&$arr, $i) { if ($i <= 0 || $i >= count($arr)) { return; // can't do it. } $temp = $arr[$i]; for ($x = $i; $x > 0; $x--) $arr[$x] = $arr[$x - 1]; $arr[0] = $temp; } /** * Move an item to the end of an array. */ function _views_move_bottom(&$arr, $i) { $end = count($arr) - 1; if ($i >= $end || $i < 0) { return; // can't do it. } $temp = $arr[$i]; for ($x = $i; $x < $end; $x++) $arr[$x] = $arr[$x + 1]; $arr[$end] = $temp; } /** * Figure out which of the many, many buttons on a form were clicked and * handle it. */ function _views_check_sub_ops(&$form, &$order, $i) { if ($form['delete']['#value']) { unset($form['delete']['#value']); unset($order[$i]); $order = array_values($order); // reindex $form['delete']['#printed'] = true; $form['up']['#printed'] = true; $form['down']['#printed'] = true; $form['top']['#printed'] = true; $form['bottom']['#printed'] = true; return 'delete'; } else foreach (array('up', 'down', 'top', 'bottom') as $dir) { if ($form[$dir]['#value']) { unset ($form[$dir]['#value']); $func = "_views_move_$dir"; $func($order, $i); return true; } } return false; } /** * Figure out if one of the add buttons on a form were clicked, and handle it. */ function _views_check_ops(&$view, $op, $form) { if ($op == t('Add Filter')) { $view->new_filter['id'] = $form['filter']['add']['id']['#value']; return 'filter'; } else if ($op == t('Add Criteria')) { $view->new_sort['id'] = $form['sort']['add']['id']['#value']; return 'sort'; } else if ($op == t('Add Argument')) { $view->new_argument['id'] = $form['argument']['add']['id']['#value']; return 'argument'; } else if ($op == t('Add Field')) { $fieldbits = explode('.', $form['field']['add']['id']['#value']); $view->new_field['id'] = $form['field']['add']['id']['#value']; $view->new_field['tablename'] = $fieldbits[0]; $view->new_field['field'] = $fieldbits[1]; $view->new_field['label'] = $fieldnames[$form['field']['add']['id']['#value']]; $view->new_field['queryname'] = "$fieldbits[0]_$fieldbits[1]"; return 'field'; } else if ($op == t('Expose Filter')) { $view->new_exposed_filter['id'] = $form['exposed_filter']['add']['id']['#value']; return 'filter'; } } /** * Custom form element to do our nice images. */ function views_elements() { $type['views_imagebutton'] = array('#input' => TRUE, '#button_type' => 'submit',); return $type; } function theme_views_imagebutton($element) { return '\n"; } function views_imagebutton_value() { // null function guarantees default_value doesn't get moved to #value. } /** * Set up the dynamic #options on a widget */ function views_ui_setup_widget($widget, $default_value, $argument = NULL) { if (!$argument) { $argument = $widget; } if (is_string($widget['#options']) && function_exists($widget['#options'])) { $widget['#options'] = $widget['#options']('option', $argument); } if ($widget['#multiple'] && is_array($widget['#options'])) { $widget['#size'] = min(count($widget['#options']), 8); } $widget['#default_value'] = $default_value; return $widget; } /** * Display all the guts of a view in a form for editing. */ function _views_view_form($view, $op = '') { _views_check_arrays($view); // make sure arrays that might be empty get set // Put in all our add buttons, then process them to see if they've been hit. views_ui_add_add_button($form, 'field', _views_get_fields(true), t('Add Field')); views_ui_add_add_button($form, 'argument', _views_get_arguments(true), t('Add Argument')); views_ui_add_add_button($form, 'filter', _views_get_filters(true), t('Add Filter')); views_ui_add_add_button($form, 'sort', _views_get_sorts(true), t('Add Criteria')); $allbut = _views_check_ops($view, $op, $form); if ($_POST['edit'] && $op != t('Save')) { drupal_set_message(t('You have modified this view; changes will not be recorded until you Save the form.')); } $form['exposed_filter'] = array(); foreach (array('field', 'argument', 'filter', 'exposed_filter', 'sort') as $section) { if (views_ui_add_section($form[$section], $view, $section)) { $allbut = $section; } } $form['vid'] = array( '#type' => 'value', '#value' => $view->vid, ); $form['allbut'] = array( '#type' => 'value', '#value' => $allbut, ); $form['changed'] = array( '#type' => 'hidden', '#value' => $view->changed, ); $form['basic-info'] = array( '#type' => 'fieldset', '#collapsible' => true, '#collapsed' => ($allbut != NULL), '#title' => t('Basic Information'), ); $form['basic-info']['name'] = array( '#type' => 'textfield', '#title' => t('Name'), '#default_value' => $view->name, '#size' => 20, '#maxlength' => 32, '#description' => t('The unique identifier of the view; it is only important for overridden views and views that modules or themes will need to use. Only alphanumeric and _ allowed here'), '#required' => true, ); $form['basic-info']['access'] = array( '#type' => 'checkboxes', '#title' => t('Access'), '#default_value' => $view->access, '#options' => views_handler_filter_role(), '#description' => t('Only the checked roles will be able to see this view in any form; if no roles are checked, access will not be restricted.'), ); $form['basic-info']['description'] = array( '#type' => 'textfield', '#title' => t('Description'), '#default_value' => $view->description, '#size' => 60, '#maxlength' => 255, '#description' => t('A description of the view for the admin list.'), ); // page info $form['page-info'] = array( '#type' => 'fieldset', '#collapsible' => true, '#collapsed' => ($allbut != NULL || !$view->page), '#title' => t('Page'), ); $form['page-info']['page'] = array( '#type' => 'checkbox', '#title' => t('Provide Page View'), '#return_value' => 1, '#default_value' => $view->page, '#description' => t('If checked this view will be provided as a page. If not checked, the fields in this group will be ignored.'), ); $form['page-info']['url'] = array( '#type' => 'textfield', '#title' => t('URL'), '#default_value' => $view->url, '#size' => 60, '#maxlength' => 255, '#description' => t('Enter the URL to use for this view in the form of \'dir/dir\'. Do not begin or end the URL with a /. Example: \'view/tracker\'. This is required if providing a page view. You can also add $arg as a placeholder for arguments passed in the URL, for example \'user/$arg/tracker\' or \'view/taxonomy/$arg\'. Note that any arguments listed here will be required, even if they are listed as optional below. You do not need to list arguments at the end of the path.'), ); $form['page-info']['page_type'] = array( '#type' => 'select', '#title' => t('View Type'), '#default_value' => $view->page_type, '#options' => _views_get_style_plugins(true), '#description' => t('How the nodes should be displayed to the user.'), ); $form['page-info']['page_title'] = array( '#type' => 'textfield', '#title' => t('Title'), '#default_value' => $view->page_title, '#size' => 60, '#maxlength' => 255, '#description' => t('The title that be shown at the top of the view. May be blank. This title ignores arguments; if you want your title to take arguments into account, use the "title" field in the arguments section.'), ); $form['page-info']['use_pager'] = array( '#type' => 'checkbox', '#title' => t('Use Pager'), '#return_value' => 1, '#default_value' => $view->use_pager, '#description' => t('If checked this query may be multiple pages. If not checked this query will be one page.'), ); $form['page-info']['breadcrumb_no_home'] = array( '#type' => 'checkbox', '#title' => t('Breadcrumb trail should not include "Home"'), '#return_value' => 1, '#default_value' => $view->breadcrumb_no_home, '#description' => t('If checked the breadcrumb trail for this page will discard "Home". Usually you will not set this, but this is used for the Front Page View, where it IS Home and should not leave a trail to itself.'), ); $form['page-info']['nodes_per_page'] = array( '#type' => 'textfield', '#title' => t('Nodes per Page'), '#default_value' => $view->nodes_per_page, '#size' => 5, '#maxlength' => 5, '#description' => t('The number of nodes to display per page. If 0, all nodes will be displayed. If not using a pager, this will be the maximum number of nodes in the list.'), '#attributes' => NULL, ); $form['page-info']['page_header_fieldset'] = array( '#type' => 'fieldset', '#collapsible' => TRUE, '#collapsed' => TRUE, '#title' => t('Header'), ); $form['page-info']['page_header_fieldset']['page_header'] = array( '#type' => 'textarea', '#default_value' => $view->page_header, '#cols' => 60, '#rows' => 6, '#description' => t('Text to display at the top of the view. May contain an explanation or links or whatever you like. Optional.'), ); $form['page-info']['page_header_fieldset']['page_header_format'] = filter_form($view->page_header_format, 1, array('page_header_format')); $form['page-info']['page_footer_fieldset'] = array( '#type' => 'fieldset', '#collapsible' => TRUE, '#collapsed' => TRUE, '#title' => t('Footer'), ); $form['page-info']['page_footer_fieldset']['page_footer'] = array( '#type' => 'textarea', '#default_value' => $view->page_footer, '#cols' => 60, '#rows' => 6, '#description' => t('Text to display at the bottom of the view. May contain an explanation or links or whatever you like. Optional.'), ); $form['page-info']['page_footer_fieldset']['page_footer_format'] = filter_form($view->page_footer_format, 1, array('page_footer_format')); $form['page-info']['page_empty_fieldset'] = array( '#type' => 'fieldset', '#collapsible' => TRUE, '#collapsed' => TRUE, '#title' => t('Empty Text'), ); $form['page-info']['page_empty_fieldset']['page_empty'] = array( '#type' => 'textarea', '#default_value' => $view->page_empty, '#cols' => 60, '#rows' => 6, '#description' => t('Text to display if a view returns no nodes. Optional.'), ); $form['page-info']['page_empty_fieldset']['page_empty_format'] = filter_form($view->page_empty_format, 1, array('page_empty_format')); $form['page-info']['menu-info'] = array( '#type' => 'fieldset', '#collapsible' => TRUE, '#collapsed' => TRUE, '#title' => t('Menu'), ); $form['page-info']['menu-info']['menu'] = array( '#type' => 'checkbox', '#title' => t('Provide Menu'), '#return_value' => 1, '#default_value' => $view->menu, '#description' => t('If checked this view be given a menu entry in the Drupal menu system. If not checked the data in this group will be ignored.'), ); $form['page-info']['menu-info']['menu_tab'] = array( '#type' => 'checkbox', '#title' => t('Provide Menu as Tab'), '#return_value' => 1, '#default_value' => $view->menu_tab, '#description' => t("If checked this view's menu entry will be provided as a tab rather than in the main menu system."), ); $form['page-info']['menu-info']['menu_tab_default'] = array( '#type' => 'checkbox', '#title' => t('Make Default Menu Tab'), '#return_value' => 1, '#default_value' => $view->menu_tab_default, '#description' => t("If checked this view's menu entry will be provided as a tab, and will be the default tab for that URL path. For example, if the URL is 'tracker/all' and it is set as the default menu tab, it will be put into the menu as 'tracker' and 'tracker/all' will be the default tab. For tabs to work properly, one tab in the group must be set as the default."), ); $form['page-info']['menu-info']['menu_tab_weight'] = array( '#type' => 'textfield', '#title' => t('Tab Weight'), '#default_value' => $view->menu_tab_weight, '#width' => 10, '#description' => t('If this is a menu tab, select the weight; lower numbers will be further to the left.'), ); $form['page-info']['menu-info']['menu_title'] = array( '#type' => 'textfield', '#title' => t('Menu Title'), '#default_value' => $view->menu_title, '#size' => 60, '#maxlength' => 255, '#description' => t('Enter the title to use for the menu entry or tab. If blank, the page title will be used.'), ); // block info $form['block-info'] = array( '#type' => 'fieldset', '#collapsible' => true, '#collapsed' => ($allbut != NULL || !$view->block), '#title' => t('Block'), ); $form['block-info']['block'] = array( '#type' => 'checkbox', '#title' => t('Provide Block'), '#return_value' => 1, '#default_value' => $view->block, '#description' => t('If checked this view will be provided as a block. If checked title may not be blank.'), ); $form['block-info']['block_type'] = array( '#type' => 'select', '#title' => t('View Type'), '#default_value' => $view->block_type, '#options' => _views_get_style_plugins(true), '#description' => t('How the nodes should be displayed to the user.'), ); $form['block-info']['block_title'] = array( '#type' => 'textfield', '#title' => t('Title'), '#default_value' => $view->block_title, '#size' => 60, '#maxlength' => 255, '#description' => t('The title that will be shown at the top of the block. May be blank.'), ); $form['block-info']['nodes_per_block'] = array( '#type' => 'textfield', '#title' => t('Nodes per Block'), '#default_value' => $view->nodes_per_block, '#size' => 2, '#maxlength' => 2, '#description' => t('If using a block, the maximum number of items to display in the block. Pagers are not used in blocks.'), '#attributes' => NULL, ); $form['block-info']['block_more'] = array( '#type' => 'checkbox', '#title' => t('[More] Link?'), '#return_value' => 1, '#default_value' => $view->block_more, '#description' => t('If using a view as both a page and a block, display a more link in the block that links to the view URL?'), ); $form['block-info']['block_header_fieldset'] = array( '#type' => 'fieldset', '#collapsible' => TRUE, '#collapsed' => TRUE, '#title' => t('Header'), ); $form['block-info']['block_header_fieldset']['block_use_page_header'] = array( '#type' => 'checkbox', '#title' => t('Use Page Header'), '#return_value' => 1, '#default_value' => $view->block_use_page_header, '#description' => t('If checked, use the Page Header for block view instead. If so, you should leave the Block Header blank.'), ); $form['block-info']['block_header_fieldset']['block_header'] = array( '#type' => 'textarea', '#title' => t('Header'), '#default_value' => $view->block_header, '#cols' => 60, '#rows' => 6, '#description' => t('Text to display at the top of the view. May contain an explanation or links or whatever you like. Optional.'), ); $form['block-info']['block_header_fieldset']['block_header_format'] = filter_form($view->block_header_format, 1, array( 'block_header_format')); $form['block-info']['block_footer_fieldset'] = array( '#type' => 'fieldset', '#collapsible' => TRUE, '#collapsed' => TRUE, '#title' => t('Footer'), ); $form['block-info']['block_footer_fieldset']['block_use_page_footer'] = array( '#type' => 'checkbox', '#title' => t('Use Page Footer'), '#return_value' => 1, '#default_value' => $view->block_use_page_footer, '#description' => t('If checked, use the page footer for block view instead. If so, you should leave the block footer blank.'), ); $form['block-info']['block_footer_fieldset']['block_footer'] = array( '#type' => 'textarea', '#title' => t('Footer'), '#default_value' => $view->block_footer, '#cols' => 60, '#rows' => 6, '#description' => t('Text to display at the bottom of the view. May contain an explanation or links or whatever you like. Optional.'), ); $form['block-info']['block_footer_fieldset']['block_footer_format'] = filter_form($view->block_footer_format, 1, array( 'block_footer_format')); $form['block-info']['block_empty_fieldset'] = array( '#type' => 'fieldset', '#collapsible' => TRUE, '#collapsed' => TRUE, '#title' => t('Empty text'), ); $form['block-info']['block_empty_fieldset']['block_use_page_empty'] = array( '#type' => 'checkbox', '#title' => t('Use Page empty'), '#return_value' => 1, '#default_value' => $view->block_use_page_empty, '#description' => t('If checked, use the Page Empty Text for block view instead. If so, you should leave the block empty text blank.'), ); $form['block-info']['block_empty_fieldset']['block_empty'] = array( '#type' => 'textarea', '#title' => t('Empty text'), '#default_value' => $view->block_empty, '#cols' => 60, '#rows' => 6, '#description' => t('Text to display if a view results in no nodes. Optional.'), ); $form['block-info']['block_empty_fieldset']['block_empty_format'] = filter_form($view->block_empty_format, 1, array( 'block_empty_format')); $access = user_access('use PHP for block visibility'); if ($access) { $form['view_args_php_fieldset'] = array( '#type' => 'fieldset', '#collapsible' => TRUE, '#collapsed' => empty($view->view_args_php) ? TRUE : FALSE, '#title' => t('Argument Handling Code'), ); $form['view_args_php_fieldset']['view_args_php'] = array( '#type' => 'textarea', '#title' => t('Argument Code'), '#default_value' => $view->view_args_php, '#cols' => 60, '#rows' => 6, '#description' => ''. t('Advanced Usage Only: PHP code that returns a custom array of arguments for the view. Should not include <?php ?> delimiters.') .'
' . ''. t('For more information, please see the Argument Handling Code documentation in the Drupal handbook.', array('%arg' => 'http://drupal.org/node/70145')) .'
', ); } else { $form['view_args_php_fieldset']['view_args_php'] = array( '#type' => 'value', '#value' => $view->view_args_php, ); } $form['save'] = array( '#type' => 'submit', '#value' => t('Save'), ); if ($view->vid) { $form['delete'] = array( '#type' => 'submit', '#value' => t('Delete'), ); } $form['cancel'] = array( '#type' => 'submit', '#value' => t('Cancel'), ); return drupal_get_form('views_edit_view', $form); } /** * separately build a piece of the form */ function views_ui_build_form(&$form) { $form = form_builder('views_edit_view', $form); } /** * Add the 'add' button for a section into the form */ function views_ui_add_add_button(&$form, $section, $options, $label) { $form[$section]['add'] = array('#tree' => true, '#parents' => array($section, 'add')); $form[$section]['add']['id'] = array( '#type' => 'select', '#options' => $options, ); $form[$section]['add']['button'] = array( '#type' => 'button', '#value' => $label, ); views_ui_build_form($form[$section]['add']); } /** * Add one of the list sections to the form. */ function views_ui_add_section(&$form, &$view, $section) { // add fields to the form. $form += array('#tree' => true, '#parents' => array($section)); $view_section = &$view->$section; $num_items = count($view_section); // Populate the form with fields we need to check to track // changes through the form's life. $form['count'] = array('#type' => 'hidden', '#default_value' => $num_items); $form['order'] = array( '#type' => 'hidden', '#default_value' => $num_items ? implode(',', range(0, $num_items - 1)) : '', ); // Run the builder to get the value on the form. views_ui_build_form($form); $order = $form['order']['#value'] != '' ? explode(',', $form['order']['#value']) : array(); // Shortcut because operator precedence gets sticky if using $foo->$bar[] for ($i = $num_items; $i < $form['count']['#value']; $i++) { $view_section[] = array(); } $new_section = "new_$section"; // instantiate the new field if one was added. if ($view->$new_section) { $view_section[] = $view->$new_section; $order[] = $form['count']['#value']; $form['count']['#value']++; } $func = "views_ui_add_$section"; if ($order) { foreach ($order as $key => $i) { $form[$i] = array('#tree' => true, '#parents' => array($section, $i)); $form[$i]['id'] = array( '#type' => 'hidden', '#default_value' => $view_section[$i]['id'], ); views_ui_add_buttons($form[$i]); views_ui_build_form($form[$i]); $retval = _views_check_sub_ops($form[$i], $order, $key); if ($retval !== 'delete') { $retval2 = $func($form[$i], $view_section[$i], $order, $key, $i, $view); } if ($retval || $retval2) { $allbut = $section; } } $form['order']['#value'] = implode(',', $order); } return $allbut; } /** * Add all the info for a single field into the form. */ function views_ui_add_field(&$form, $field, &$order, $key, $i) { $fields = _views_get_fields(); $fieldname = $form['id']['#value']; // combined table & fieldname $fieldinfo = $fields[$fieldname]; // laziness + readability $form['fullname'] = array( '#type' => 'hidden', '#default_value' => $field['id'], ); $form['name'] = array( '#type' => 'markup', '#value' => $fieldinfo['name'], // combined table & fieldname ); $form['queryname'] = array( '#type' => 'hidden', '#default_value' => $field['queryname'], ); $form['tablename'] = array( '#type' => 'hidden', '#default_value' => $field['tablename'], ); $form['field'] = array( '#type' => 'hidden', '#default_value' => $field['field'], ); $form['label'] = array( '#type' => 'textfield', '#default_value' => $field['label'], '#size' => 15, '#maxlength' => 255, ); if (is_array($fieldinfo['handler'])) { $form['handler'] = array( '#type' => 'select', '#default_value' => $field['handler'], '#options' => $fieldinfo['handler'], ); } if (isset($fieldinfo['option'])) { $form['options'] = views_ui_setup_widget($fieldinfo['option'], $field['options']); } if ($fieldinfo['sortable']) { $form['sortable'] = array( '#type' => 'select', '#default_value' => $field['sortable'], '#options' => array('0' => t('No'), '1' => t('Yes')), ); $form['defaultsort'] = array( '#type' => 'select', '#default_value' => $field['defaultsort'], '#options' => array('0' => t('None'), 'ASC' => t('Ascending'), 'DESC' => t('Descending')), ); } if (isset($fieldinfo['help'])) { $form['help'] = array( '#type' => 'markup', '#value' => ''. t('Fields are only meaningful with List view and Table View; they allow you to choose which fields are presented and in what order.') .'
'; $output .= theme('fieldset', array('#title' => t('Fields'), '#children' => $group, '#collapsible' => true, '#collapsed' => $collapsed,)); // arguments $collapsed = $allbut && $allbut != 'argument'; $group = views_ui_render_section($form['argument'], array('name', 'argdefault', 'title', 'options', 'wildcard', 'wildcard_substitution'), array(t('Argument Type'), t('Default'), t('Title'), t('Option'), t('Wildcard'), t('Wildcard Sub')), 'arguments', $collapsed); $group .= views_ui_render_section_add($form['argument']['add'], array('id', 'button'), t('Add Argument')); $group .= form_render($form['view_args_php_fieldset']); $group .= ''. t('Arguments are parsed directly from the URL. They are not necessary to any given view, but allow flexibility.') .'
'; $output .= theme('fieldset', array('#title' => t('Arguments'), '#children' => $group, '#collapsible' => true, '#collapsed' => $collapsed,)); // filter $collapsed = $allbut && $allbut != 'filter'; $group = views_ui_render_section($form['filter'], array('name', 'operator', 'value', 'options', 'expose'), array(t('Field'), t('Operator'), t('Value'), t('Option'), ''), 'filters', $collapsed); $group .= views_ui_render_section_add($form['filter']['add'], array('id', 'button'), t('Add Filter')); $group .= ''. t('Filters allow you to select a subset of all the nodes to display. All Filters are ANDed together.') .'
'; $output .= theme('fieldset', array('#title' => t('Filters'), '#children' => $group, '#collapsible' => true, '#collapsed' => $collapsed,)); $group = ''; // exposed exposed_filter $collapsed = $allbut && $allbut != 'exposed_filter'; $group = views_ui_render_section($form['exposed_filter'], array('name', 'label', 'optional', 'is_default', 'single', 'operator'), array(t('Field'), t('Label'), t('Optional'), t('Filter settings Default'), t('Force Single'), t('Lock Operator')), 'exposed_filters', $collapsed); // $group .= views_ui_render_section_add($form['exposed_filter']['add'], array('id', 'button'), t('Expose Filter')); $group .= ''. t('Exposed filters will be presented to the viewer. If not set required, then filters will include a "<None>" Value if possible. If set default, filters will default as set here, otherwise filter settings will be ignored. If Lock Operator is set, no operator will be made available to the user.') .'
'; $output .= theme('fieldset', array('#title' => t('Exposed Filters'), '#children' => $group, '#collapsible' => true, '#collapsed' => $collapsed,)); $group = ''; // sort $collapsed = $allbut && $allbut != 'sort'; $group = views_ui_render_section($form['sort'], array('name', 'sortorder', 'options'), array(t('Field'), t('Order'), t('Option')), 'sort criteria', $collapsed); $group .= views_ui_render_section_add($form['sort']['add'], array('id', 'button'), t('Add criteria')); $output .= theme('fieldset', array('#title' => t('Sort Criteria'), '#children' => $group, '#collapsible' => true, '#collapsed' => $collapsed,)); $output .= form_render($form, false); return $output; } /** * Render one of the dynamic sections on our form. */ function views_ui_render_section(&$form, $items, $header, $section, &$collapsed) { // always do the buttons $items = array_merge($items, array('delete', 'top', 'up', 'down', 'bottom')); $num_items = count($items); $order = ($form['order']['#value'] != '' ? explode(',', $form['order']['#value']) : array()); $count = count($order) - 1; foreach ($order as $key => $i) { $row = array(); foreach ($items as $item) { if (($key == 0 && ($item == 'up' || $item == 'top')) || ($key == $count && ($item == 'down' || $item == 'bottom'))) { $form[$i][$item]['#printed'] = true; $row[] = ' '; // array('data' => ' ', 'width' => 16); } else { $row[] = form_render($form[$i][$item], false); } } $rows[] = $row; if (isset($form[$i]['help'])) { $rows[] = array(array('data' => form_render($form[$i]['help']), 'colspan' => $num_items)); } } if (!$rows) { $rows[] = array(array('data' => t('This view currently has no %s defined.', array('%s' => $section)), 'colspan' => $num_items)); $collapsed = true; } $header[] = array('data' => t('Ops'), 'colspan' => 5); return theme('table', $header, $rows) . "