You must add some additional fields to this display before using this field. These fields may be marked as Exclude from display if you prefer. Note that due to rendering order, you cannot use fields that come after this field; if you need a field not listed here, rearrange your fields.
'); + // We have some options, so make a list. + if (!empty($options)) { + $output = t('The following substitution patterns are available for this display. Use the pattern shown on the left to display the value indicated on the right. Note that due to rendering order, you cannot use fields that come after this field; if you need a field not listed here, rearrange your fields.
'); + foreach (array_keys($options) as $type) { + if (!empty($options[$type])) { + $items = array(); + $title = t(ucwords($type)); + foreach ($options[$type] as $key => $value) { + $items[] = $key .' == '. $value; + } + $output .= theme('item_list', $items, $title); + } + } + } + // This construct uses 'hidden' and not markup because process doesn't + // run. It also has an extra div because the dependency wants to hide + // the parent in situations like this, so we need a second div to + // make this work. + $form['alter']['help'] = array( + '#type' => 'hidden', + '#id' => 'views-tokens-help', + '#prefix' => '', + '#process' => array('views_process_dependency'), + '#dependency' => array( + 'edit-options-alter-make-link' => array(1), + 'edit-options-alter-alter-text' => array(1), + ), + ); + } } /** @@ -185,6 +308,109 @@ class views_handler_field extends views_ } /** + * Render a field using advanced settings. + * + * This renders a field normally, then decides if render-as-link and + * text-replacement rendering is necessary. + */ + function advanced_render($values) { + $this->last_render = $value = $this->render($values); + + $tokens = NULL; + if (!empty($this->options['alter']['alter_text']) && !empty($this->options['alter']['text'])) { + $tokens = $this->get_render_tokens(); + $value = $this->render_altered($tokens); + } + + if (!empty($this->options['alter']['make_link']) && !empty($this->options['alter']['text'])) { + if (!isset($tokens)) { + $tokens = $this->get_render_tokens(); + } + $value = $this->render_as_link($value, $tokens); + } + + // This happens here so that render_link can get the unaltered value of + // this field as a token rather than the altered value. + $this->last_render = $value; + + return $this->last_render; + } + + /** + * Render this field as altered text, from a fieldset set by the user. + */ + function render_altered($tokens) { + // Filter this right away as our substitutions are already sanitized. + $value = filter_xss_admin($this->options['alter']['text']); + $value = strtr($value, $tokens); + + return $value; + } + + /** + * Render this field as a link, with the info from a fieldset set by + * the user. + */ + function render_as_link($text, $tokens) { + $path = filter_xss_admin($this->options['alter']['path']); + $path = strtr($path, $tokens); + + $value = ''; + + if (!empty($this->options['alter']['prefix'])) { + $value .= filter_xss_admin($this->options['alter']['prefix']); + } + + // @todo do we need options for 'query' and 'fragment' here? Can we + // successfully parse those from the given path instead? + $value .= l($text, $path, array('html' => TRUE)); + + if (!empty($this->options['alter']['suffix'])) { + $value .= filter_xss_admin($this->options['alter']['suffix']); + } + + return $value; + } + + /** + * Get the 'render' tokens to use for advanced rendering. + * + * This runs through all of the fields and arguments that + * are available and gets their values. This will then be + * used in one giant str_replace(). + */ + function get_render_tokens() { + $tokens = array(); + if (!empty($this->view->build_info['substitutions'])) { + $tokens = $this->view->build_info['substitutions']; + } + $count = 0; + foreach ($this->view->display_handler->get_handlers('argument') as $arg => $handler) { + $token = '%' . ++$count; + if (!isset($tokens[$token])) { + $tokens[$token] = ''; + } + } + + // Now add replacements for our fields. + $options = array(); + foreach ($this->view->display_handler->get_handlers('field') as $field => $handler) { + if (isset($handler->last_render)) { + $tokens["[$field]"] = $handler->last_render; + } + else { + $tokens["[$field]"] = ''; + } + // We only use fields up to (and including) this one. + if ($field == $this->options['id']) { + break; + } + } + + return $tokens; + } + + /** * Call out to the theme() function, which probably just calls render() but * allows sites to override output fairly easily. */ Index: includes/view.inc =================================================================== RCS file: /cvs/drupal-contrib/contributions/modules/views/includes/view.inc,v retrieving revision 1.148 diff -u -p -r1.148 view.inc --- includes/view.inc 27 Jan 2009 21:32:46 -0000 1.148 +++ includes/view.inc 28 Jan 2009 02:42:41 -0000 @@ -504,6 +504,9 @@ class view extends views_db_object { $this->build_info['title'] = str_replace(array_keys($substitutions), $substitutions, $title); } + // Store the arguments for later use. + $this->build_info['substitutions'] = $substitutions; + return $status; } @@ -793,6 +796,15 @@ class view extends views_db_object { } /** + * Render a specific field via the field ID and the row #. + */ + function render_field($field, $row) { + if (isset($this->field[$field]) && isset($this->result[$row])) { + return $this->field[$field]->advanced_render($this->result[$row]); + } + } + + /** * Execute the given display, with the given arguments. * To be called externally by whatever mechanism invokes the view, * such as a page callback, hook_block, etc. Index: modules/node.views.inc =================================================================== RCS file: /cvs/drupal-contrib/contributions/modules/views/modules/node.views.inc,v retrieving revision 1.91 diff -u -p -r1.91 node.views.inc --- modules/node.views.inc 2 Dec 2008 22:17:41 -0000 1.91 +++ modules/node.views.inc 28 Jan 2009 02:42:41 -0000 @@ -90,6 +90,7 @@ function node_views_data() { 'group' => t('Node'), // The group it appears in on the UI. Could be left out. 'handler' => 'views_handler_field_node', 'click sortable' => TRUE, + 'allow advanced render' => TRUE, ), 'sort' => array( 'handler' => 'views_handler_sort', Index: theme/theme.inc =================================================================== RCS file: /cvs/drupal-contrib/contributions/modules/views/theme/theme.inc,v retrieving revision 1.68 diff -u -p -r1.68 theme.inc --- theme/theme.inc 28 Jan 2009 00:43:43 -0000 1.68 +++ theme/theme.inc 28 Jan 2009 02:42:44 -0000 @@ -201,7 +201,7 @@ function template_preprocess_views_view_ * this: @code { $row->{$field->field_alias} @endcode */ function theme_views_view_field($view, $field, $row) { - return $field->render($row); + return $field->advanced_render($row); } /** @@ -209,10 +209,10 @@ function theme_views_view_field($view, $ * * This preprocess function isn't normally run, as a function is used by * default, for performance. However, by creating a template, this - * preprocess should get pickedup. + * preprocess should get picked up. */ function template_preprocess_views_view_field(&$vars) { - $vars['output'] = $vars['field']->render($vars['row']); + $vars['output'] = $vars['field']->advanced_render($vars['row']); } /**