wp_text_diff( string $left_string, string $right_string, string|array $args = null )

Displays a human readable HTML representation of the difference between two strings.

Contents

Description Description

The Diff is available for getting the changes between versions. The output is HTML, so the primary use is for displaying the changes. If the two strings are equivalent, then an empty string will be returned.

See also See also

Top ↑

Parameters Parameters

$left_string

(string) (Required) "old" (left) version of string

$right_string

(string) (Required) "new" (right) version of string

$args

(string|array) (Optional) Associative array of options to pass to WP_Text_Diff_Renderer_Table().

  • 'title'
    (string) Titles the diff in a manner compatible with the output. Default empty.
  • 'title_left'
    (string) Change the HTML to the left of the title. Default empty.
  • 'title_right'
    (string) Change the HTML to the right of the title. Default empty.
  • 'show_split_view'
    (bool) True for split view (two columns), false for un-split view (single column). Default true.

Default value: null

Top ↑

Return Return

(string) Empty string if strings are equivalent or HTML with differences.

Top ↑

Source Source

File: wp-includes/pluggable.php 

	function wp_text_diff( $left_string, $right_string, $args = null ) {
		$defaults = array(
			'title'           => '',
			'title_left'      => '',
			'title_right'     => '',
			'show_split_view' => true,
		);
		$args     = wp_parse_args( $args, $defaults );

		if ( ! class_exists( 'WP_Text_Diff_Renderer_Table', false ) ) {
			require( ABSPATH . WPINC . '/wp-diff.php' );
		}

		$left_string  = normalize_whitespace( $left_string );
		$right_string = normalize_whitespace( $right_string );

		$left_lines  = explode( "\n", $left_string );
		$right_lines = explode( "\n", $right_string );
		$text_diff   = new Text_Diff( $left_lines, $right_lines );
		$renderer    = new WP_Text_Diff_Renderer_Table( $args );
		$diff        = $renderer->render( $text_diff );

		if ( ! $diff ) {
			return '';
		}

		$r = "<table class='diff'>\n";

		if ( ! empty( $args['show_split_view'] ) ) {
			$r .= "<col class='content diffsplit left' /><col class='content diffsplit middle' /><col class='content diffsplit right' />";
		} else {
			$r .= "<col class='content' />";
		}

		if ( $args['title'] || $args['title_left'] || $args['title_right'] ) {
			$r .= '<thead>';
		}
		if ( $args['title'] ) {
			$r .= "<tr class='diff-title'><th colspan='4'>$args[title]</th></tr>\n";
		}
		if ( $args['title_left'] || $args['title_right'] ) {
			$r .= "<tr class='diff-sub-title'>\n";
			$r .= "\t<td></td><th>$args[title_left]</th>\n";
			$r .= "\t<td></td><th>$args[title_right]</th>\n";
			$r .= "</tr>\n";
		}
		if ( $args['title'] || $args['title_left'] || $args['title_right'] ) {
			$r .= "</thead>\n";
		}

		$r .= "<tbody>\n$diff\n</tbody>\n";
		$r .= '</table>';

		return $r;
	}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
2.6.0 Introduced.

Top ↑

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    Example

    $left_string = 'This is the original string';

$right_string = 'This is the revised string';

$args = array(
	'title'       => 'Differences',
	'title_left'  => 'Old Version',
	'title_right' => 'New Version'
);

$diff_table = wp_text_diff( $left_string,$right_string, $args );

echo $diff_table;

    Expand full source codeCollapse full source code

    This will output the following html:

    <table class="diff">
	<colgroup>
		<col class="ltype">
		<col class="content">
		<col class="ltype">
		<col class="content">
	</colgroup>
	<thead>
		<tr class="diff-title">
			<th colspan="4">Differences</th>
		</tr>
		<tr class="diff-sub-title">
			<td></td>
			<th>Old Version</th>
			<td></td>
			<th>New version</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>-</td>
			<td class="diff-deletedline">
				This is the <del>original</del> string
			</td>
			<td>+</td>
			<td class="diff-addedline">
				This is the <ins>revised</ins> string
			</td>
		</tr>

	</tbody>
</table>

    Expand full source codeCollapse full source code

You must log in before being able to contribute a note or feedback.