X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/11be15bd505d66a91e2c80062190b13e315a04a9..a7cd4c052013b423c6301153f68c7fdbaa2a447b:/wp-includes/wp-diff.php diff --git a/wp-includes/wp-diff.php b/wp-includes/wp-diff.php index 62f4162f..77efd455 100644 --- a/wp-includes/wp-diff.php +++ b/wp-includes/wp-diff.php @@ -28,18 +28,18 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { /** * @see Text_Diff_Renderer::_leading_context_lines * @var int - * @access protected + * @access public * @since 2.6.0 */ - var $_leading_context_lines = 10000; + public $_leading_context_lines = 10000; /** * @see Text_Diff_Renderer::_trailing_context_lines * @var int - * @access protected + * @access public * @since 2.6.0 */ - var $_trailing_context_lines = 10000; + public $_trailing_context_lines = 10000; /** * {@internal Missing Description}} @@ -48,7 +48,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * @access protected * @since 2.6.0 */ - var $_diff_threshold = 0.6; + protected $_diff_threshold = 0.6; /** * Inline display helper object name. @@ -57,7 +57,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * @access protected * @since 2.6.0 */ - var $inline_diff_renderer = 'WP_Text_Diff_Renderer_inline'; + protected $inline_diff_renderer = 'WP_Text_Diff_Renderer_inline'; /** * Should we show the split view or not @@ -66,7 +66,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * @access protected * @since 3.6.0 */ - var $_show_split_view = true; + protected $_show_split_view = true; /** * Constructor - Call parent constructor with params array. @@ -77,7 +77,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * * @param array $params */ - function __construct( $params = array() ) { + public function __construct( $params = array() ) { parent::__construct( $params ); if ( isset( $params[ 'show_split_view' ] ) ) $this->_show_split_view = $params[ 'show_split_view' ]; @@ -89,7 +89,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * @param string $header * @return string */ - function _startBlock( $header ) { + public function _startBlock( $header ) { return ''; } @@ -99,7 +99,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * @param array $lines * @param string $prefix */ - function _lines( $lines, $prefix=' ' ) { + public function _lines( $lines, $prefix=' ' ) { } /** @@ -108,7 +108,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * @param string $line HTML-escape the value. * @return string */ - function addedLine( $line ) { + public function addedLine( $line ) { return "{$line}"; } @@ -119,7 +119,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * @param string $line HTML-escape the value. * @return string */ - function deletedLine( $line ) { + public function deletedLine( $line ) { return "{$line}"; } @@ -129,7 +129,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * @param string $line HTML-escape the value. * @return string */ - function contextLine( $line ) { + public function contextLine( $line ) { return "{$line}"; } @@ -138,23 +138,40 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * * @return string */ - function emptyLine() { + public function emptyLine() { return ' '; } /** * @ignore - * @access private + * @access public * * @param array $lines * @param bool $encode * @return string */ - function _added( $lines, $encode = true ) { + public function _added( $lines, $encode = true ) { $r = ''; foreach ($lines as $line) { - if ( $encode ) - $line = htmlspecialchars( $line ); + if ( $encode ) { + $processed_line = htmlspecialchars( $line ); + + /** + * Contextually filter a diffed line. + * + * Filters TextDiff processing of diffed line. By default, diffs are processed with + * htmlspecialchars. Use this filter to remove or change the processing. Passes a context + * indicating if the line is added, deleted or unchanged. + * + * @since 4.1.0 + * + * @param String $processed_line The processed diffed line. + * @param String $line The unprocessed diffed line. + * @param string null The line context. Values are 'added', 'deleted' or 'unchanged'. + */ + $line = apply_filters( 'process_text_diff_html', $processed_line, $line, 'added' ); + } + if ( $this->_show_split_view ) { $r .= '' . $this->emptyLine() . $this->emptyLine() . $this->addedLine( $line ) . "\n"; } else { @@ -166,17 +183,21 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { /** * @ignore - * @access private + * @access public * * @param array $lines * @param bool $encode * @return string */ - function _deleted( $lines, $encode = true ) { + public function _deleted( $lines, $encode = true ) { $r = ''; foreach ($lines as $line) { - if ( $encode ) - $line = htmlspecialchars( $line ); + if ( $encode ) { + $processed_line = htmlspecialchars( $line ); + + /** This filter is documented in wp-includes/wp-diff.php */ + $line = apply_filters( 'process_text_diff_html', $processed_line, $line, 'deleted' ); + } if ( $this->_show_split_view ) { $r .= '' . $this->deletedLine( $line ) . $this->emptyLine() . $this->emptyLine() . "\n"; } else { @@ -189,17 +210,21 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { /** * @ignore - * @access private + * @access public * * @param array $lines * @param bool $encode * @return string */ - function _context( $lines, $encode = true ) { + public function _context( $lines, $encode = true ) { $r = ''; foreach ($lines as $line) { - if ( $encode ) - $line = htmlspecialchars( $line ); + if ( $encode ) { + $processed_line = htmlspecialchars( $line ); + + /** This filter is documented in wp-includes/wp-diff.php */ + $line = apply_filters( 'process_text_diff_html', $processed_line, $line, 'unchanged' ); + } if ( $this->_show_split_view ) { $r .= '' . $this->contextLine( $line ) . $this->emptyLine() . $this->contextLine( $line ) . "\n"; } else { @@ -215,14 +240,14 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * (TRAC style) sometimes these lines can actually be deleted or added rows. * We do additional processing to figure that out * - * @access private + * @access public * @since 2.6.0 * * @param array $orig * @param array $final * @return string */ - function _changed( $orig, $final ) { + public function _changed( $orig, $final ) { $r = ''; // Does the aforementioned additional processing @@ -309,11 +334,11 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * * @since 2.6.0 * - * @param unknown_type $orig - * @param unknown_type $final - * @return unknown + * @param array $orig + * @param array $final + * @return array */ - function interleave_changed_lines( $orig, $final ) { + public function interleave_changed_lines( $orig, $final ) { // Contains all pairwise string comparisons. Keys are such that this need only be a one dimensional array. $matches = array(); @@ -391,48 +416,6 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { } return array($orig_matches, $final_matches, $orig_rows, $final_rows); - -/* - // Debug - echo "\n\n\n\n\n"; - - echo "-- DEBUG Matches: Orig -> Final --"; - - foreach ( $orig_matches as $o => $f ) { - echo "\n\n\n\n\n"; - echo "ORIG: $o, FINAL: $f\n"; - var_dump($orig[$o],$final[$f]); - } - echo "\n\n\n\n\n"; - - echo "-- DEBUG Matches: Final -> Orig --"; - - foreach ( $final_matches as $f => $o ) { - echo "\n\n\n\n\n"; - echo "FINAL: $f, ORIG: $o\n"; - var_dump($final[$f],$orig[$o]); - } - echo "\n\n\n\n\n"; - - echo "-- DEBUG Rows: Orig -- Final --"; - - echo "\n\n\n\n\n"; - foreach ( $orig_rows as $row => $o ) { - if ( $o < 0 ) - $o = 'X'; - $f = $final_rows[$row]; - if ( $f < 0 ) - $f = 'X'; - echo "$o -- $f\n"; - } - echo "\n\n\n\n\n"; - - echo "-- END DEBUG --"; - - echo "\n\n\n\n\n"; - - return array($orig_matches, $final_matches, $orig_rows, $final_rows); -*/ } /** @@ -444,7 +427,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * @param string $string2 * @return int */ - function compute_string_distance( $string1, $string2 ) { + public function compute_string_distance( $string1, $string2 ) { // Vectors containing character frequency for all chars in each string $chars1 = count_chars($string1); $chars2 = count_chars($string2); @@ -456,7 +439,7 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { if ( !$string1 ) return $difference; - // Return distance per charcter (of string1) + // Return distance per character (of string1). return $difference / strlen($string1); } @@ -468,10 +451,75 @@ class WP_Text_Diff_Renderer_Table extends Text_Diff_Renderer { * @param int $b * @return int */ - function difference( $a, $b ) { + public function difference( $a, $b ) { return abs( $a - $b ); } + /** + * Make private properties readable for backwards compatibility. + * + * @since 4.0.0 + * @access public + * + * @param string $name Property to get. + * @return mixed Property. + */ + public function __get( $name ) { + return $this->$name; + } + + /** + * Make private properties settable for backwards compatibility. + * + * @since 4.0.0 + * @access public + * + * @param string $name Property to check if set. + * @param mixed $value Property value. + * @return mixed Newly-set property. + */ + public function __set( $name, $value ) { + return $this->$name = $value; + } + + /** + * Make private properties checkable for backwards compatibility. + * + * @since 4.0.0 + * @access public + * + * @param string $name Property to check if set. + * @return bool Whether the property is set. + */ + public function __isset( $name ) { + return isset( $this->$name ); + } + + /** + * Make private properties un-settable for backwards compatibility. + * + * @since 4.0.0 + * @access public + * + * @param string $name Property to unset. + */ + public function __unset( $name ) { + unset( $this->$name ); + } + + /** + * Make private/protected methods readable for backwards compatibility. + * + * @since 4.0.0 + * @access public + * + * @param callable $name Method to call. + * @param array $arguments Arguments to pass when calling. + * @return mixed|bool Return value of the callback, false otherwise. + */ + public function __call( $name, $arguments ) { + return call_user_func_array( array( $this, $name ), $arguments ); + } } /** @@ -490,7 +538,7 @@ class WP_Text_Diff_Renderer_inline extends Text_Diff_Renderer_inline { * @param string $newlineEscape * @return string */ - function _splitOnWords($string, $newlineEscape = "\n") { + public function _splitOnWords($string, $newlineEscape = "\n") { $string = str_replace("\0", '', $string); $words = preg_split( '/([^\w])/u', $string, -1, PREG_SPLIT_DELIM_CAPTURE ); $words = str_replace( "\n", $newlineEscape, $words );