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(); $links[] = array('title' => t('Add'), 'href' => "admin/build/views/add/$view->name"); if ($status == t('Enabled')) { $links[] = array('title' => t('Disable'), 'href' => "admin/build/views/disable/$view->name"); } else if ($status == t('Disabled')) { $links[] = array('title' => t('Enable'), 'href' => "admin/build/views/enable/$view->name"); } $items[] = array( $view->name, filter_xss_admin(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; } function views_ui_admin_tools() { $form['markup'] = array( '#value' => t('Occasionally, something or other can cause the Views cache to contain stale data; this is particularly true after module updates and sometimes true after taxonomy and profile updates. If you are having problems with Views creating malformed queries, the first thing you should always do is clear the Views cache to see if that is the problem.
'), ); $form['clear'] = array( '#type' => 'submit', '#value' => t('Clear views cache'), ); return $form; } function views_ui_admin_tools_submit($form_id, $form) { if ($_POST['op'] == t('Clear views cache')) { views_invalidate_cache(); drupal_set_message("The Views cache has been cleared."); } } /* * Page to enable a disabled default view */ function views_ui_admin_enable_page($view = '') { views_load_cache(); if ($view) { $views_status = variable_get('views_defaults', array()); $views_status[$view] = 'enabled'; variable_set('views_defaults', $views_status); menu_rebuild(); } drupal_goto('admin/build/views'); } /* * Page to disable an enabled default view */ function views_ui_admin_disable_page($view = '') { views_load_cache(); if ($view) { $views_status = variable_get('views_defaults', array()); $views_status[$view] = 'disabled'; variable_set('views_defaults', $views_status); menu_rebuild(); } drupal_goto('admin/build/views'); } /* * Provide a textarea to paste a view export into. */ function views_ui_admin_import_page() { views_load_cache(); if ($_POST['form_id'] == 'views_edit_view') { return views_ui_admin_add_page(); } drupal_set_title("Import a View"); return drupal_get_form('views_ui_admin_import', $form); } function views_ui_admin_import() { $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"), ); $form['#redirect'] = NULL; return $form; } /* * Handle the submit button on importing a view. */ function views_ui_admin_import_submit($formid, $form) { views_load_cache(); ob_start(); eval($form['view']); ob_end_clean(); $tables = array_keys(_views_get_tables()); if (isset($view)) { if (!is_array($view->requires) || !array_diff($view->requires, $tables)) { views_sanitize_view($view); drupal_set_title(t('Add a View')); $output = drupal_get_form('views_edit_view', $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 = '') { views_load_cache(); $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 $form; } /* * Provide a form to add a view. Allow adding a view from default templates. */ function views_ui_admin_add_page($template = NULL) { views_load_cache(); $op = $_POST['op']; if ($op == t('Cancel')) { drupal_goto('admin/build/views'); } $view = _views_get_default_view($template); drupal_set_title(t('Add a View')); return drupal_get_form('views_edit_view', $view, $op); } /* * Provide a form to clone a view. */ function views_ui_admin_clone_page($viewname) { views_load_cache(); $op = $_POST['op']; if ($op == t('Cancel')) { drupal_goto('admin/build/views'); } $view = views_get_view($viewname); if (!$view) { return drupal_not_found(); } unset($view->vid); drupal_set_title(t('Add a View')); return drupal_get_form('views_edit_view', $view, $op); } /* * Provide a form to edit a view. */ function views_ui_admin_edit_page($vid = '') { views_load_cache(); $op = $_POST['op']; if ($op == t('Cancel')) { drupal_goto('admin/build/views'); } if ($op == t('Delete')) { drupal_goto("admin/build/views/delete/$vid"); } if (!($view = _views_load_view($vid))) { drupal_goto('admin/build/views'); } drupal_set_title(t('Edit view %n', array('%n' => $view->name))); return drupal_get_form('views_edit_view', $view, $op); } /* * Provide a form to confirm deletion of a view. */ function views_ui_admin_delete_confirm($vid = '') { $view = _views_load_view($vid); if (!$view) { return drupal_goto('admin/build/views'); } $form['vid'] = array('#type' => 'value', '#value' => $view->vid); // bdragon note: Did you mean to drop the above line on the floor with this? $form = confirm_form($form, t('Are you sure you want to delete %title?', array('%title' => $view->name)), $_GET['destination'] ? $_GET['destination'] : 'admin/build/views', t('This action cannot be undone.'), t('Delete'), t('Cancel') ); return $form; } /* * Handle the submit button to delete a view. */ function views_ui_admin_delete_confirm_submit($form_id, $form) { _views_delete_view((object) $form); menu_rebuild(); drupal_goto('admin/build/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['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_edit_view($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. $form = array(); 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' => intval($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_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.'), ); $form['page-info']['menu-info']['default-tab'] = array( '#type' => 'fieldset', '#collapsible' => TRUE, '#collapsed' => TRUE, '#title' => t('Default Menu Tab'), ); $form['page-info']['menu-info']['default-tab']['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. The following settings allow you to customize the parent item, for example 'tracker'. For tabs to work properly, one tab in the group must be set as the default."), ); $form['page-info']['menu-info']['default-tab']['menu_tab_default_parent_type'] = array( '#type' => 'select', '#title' => t('Parent Menu Item Type'), '#default_value' => $view->menu_tab_default_parent_type, '#options' => array( 'tab' => t("Tab"), 'normal' => t("Normal menu item"), 'existing' => t("Already exists (don't create)"), ), '#description' => t("Select type of parent item to use for this default menu tab. You can either specify the parent should be a tab (the default), a normal menu item, or to use the menu item that already exists at the specified URL. For example, if the URL for the default tab is 'tracker/all', then 'tracker' would already have to be a valid menu item to use this final choice."), ); $form['page-info']['menu-info']['default-tab']['menu_parent_tab_weight'] = array( '#type' => 'textfield', '#title' => t('Tab Weight'), '#default_value' => $view->menu_parent_tab_weight, '#width' => 10, '#description' => t('If the parent menu item is a tab, select the weight; lower numbers will be further to the left.'), ); $form['page-info']['menu-info']['default-tab']['menu_parent_title'] = array( '#type' => 'textfield', '#title' => t('Parent Menu Item Title'), '#default_value' => $view->menu_parent_title, '#size' => 60, '#maxlength' => 255, '#description' => t('If the Parent Menu Item is being defined by this view (if you set the %type_field to either %tab or %menu), you can specify its title here. If blank, the menu title will be used if that is defined, or the page title if not.', array('%type_field' => t('Parent Menu Item Type'), '%tab' => t('Tab'), '%menu' => t('Normal menu item'))), ); // 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' => 3, '#maxlength' => 3, '#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'), ); $form['save_and_edit'] = array( '#type' => 'submit', '#value' => t('Save and edit'), ); if ($view->vid) { $form['delete'] = array( '#type' => 'submit', '#value' => t('Delete'), ); } $form['cancel'] = array( '#type' => 'submit', '#value' => t('Cancel'), ); // Add the css file for form display. drupal_add_css(drupal_get_path('module', 'views_ui') . '/views_ui.css'); return $form; } /** * separately build a piece of the form */ function views_ui_build_form(&$form) { // NOT REALLY SURE WHY THIS SORT OF WORKS. IT'S MAGIC THAT CHX POINTED ME TO // IN THE POLL MODULE. $form['#post'] = $_POST; $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 .= drupal_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 .= drupal_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) { // Hide the delete button on exposed filters. if ($item == 'delete' && $section == 'filters' && empty($form[$i]['expose'])) { $form[$i][$item]['#printed'] = true; } 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[] = drupal_render($form[$i][$item], false); } } $rows[] = $row; if (isset($form[$i]['help'])) { $rows[] = array(array('data' => drupal_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) . "