/source/mydroid/external/webkit/WebKitSite/blog/wp-includes/formatting.php

https://bitbucket.org/thejeshgn/kindle-fire · PHP · 2679 lines · 1591 code · 205 blank · 883 comment · 208 complexity · 004286e364dd12eebb41c7bbb48b0da1 MD5 · raw file 

    

  1. <?php
    2. 

  2. /**
    3. 

  3.  * Main Wordpress Formatting API.
    4. 

  4.  *
    5. 

  5.  * Handles many functions for formatting output.
    6. 

  6.  *
    7. 

  7.  * @package WordPress
    8. 

  8.  **/
    9. 

  9. 

  10. /**
    11. 

  11.  * Replaces common plain text characters into formatted entities
    12. 

  12.  *
    13. 

  13.  * As an example,
    14. 

  14.  * <code>
    15. 

  15.  * 'cause today's effort makes it worth tomorrow's "holiday"...
    16. 

  16.  * </code>
    17. 

  17.  * Becomes:
    18. 

  18.  * <code>
    19. 

  19.  * &#8217;cause today&#8217;s effort makes it worth tomorrow&#8217;s &#8220;holiday&#8221;&#8230;
    20. 

  20.  * </code>
    21. 

  21.  * Code within certain html blocks are skipped.
    22. 

  22.  *
    23. 

  23.  * @since 0.71
    24. 

  24.  * @uses $wp_cockneyreplace Array of formatted entities for certain common phrases
    25. 

  25.  *
    26. 

  26.  * @param string $text The text to be formatted
    27. 

  27.  * @return string The string replaced with html entities
    28. 

  28.  */
    29. 

  29. function wptexturize($text) {
    30. 

  30. 	global $wp_cockneyreplace;
    31. 

  31. 	$output = '';
    32. 

  32. 	$curl = '';
    33. 

  33. 	$textarr = preg_split('/(<.*>|\[.*\])/Us', $text, -1, PREG_SPLIT_DELIM_CAPTURE);
    34. 

  34. 	$stop = count($textarr);
    35. 

  35. 	
    36. 

  36. 	/* translators: opening curly quote */
    37. 

  37. 	$opening_quote = _x('&#8220;', 'opening curly quote');
    38. 

  38. 	/* translators: closing curly quote */
    39. 

  39. 	$closing_quote = _x('&#8221;', 'closing curly quote');
    40. 

  40. 	
    41. 

  41. 	$no_texturize_tags = apply_filters('no_texturize_tags', array('pre', 'code', 'kbd', 'style', 'script', 'tt'));
    42. 

  42. 	$no_texturize_shortcodes = apply_filters('no_texturize_shortcodes', array('code'));
    43. 

  43. 	$no_texturize_tags_stack = array();
    44. 

  44. 	$no_texturize_shortcodes_stack = array();
    45. 

  45. 

  46. 	// if a plugin has provided an autocorrect array, use it
    47. 

  47. 	if ( isset($wp_cockneyreplace) ) {
    48. 

  48. 		$cockney = array_keys($wp_cockneyreplace);
    49. 

  49. 		$cockneyreplace = array_values($wp_cockneyreplace);
    50. 

  50. 	} else {
    51. 

  51. 		$cockney = array("'tain't","'twere","'twas","'tis","'twill","'til","'bout","'nuff","'round","'cause");
    52. 

  52. 		$cockneyreplace = array("&#8217;tain&#8217;t","&#8217;twere","&#8217;twas","&#8217;tis","&#8217;twill","&#8217;til","&#8217;bout","&#8217;nuff","&#8217;round","&#8217;cause");
    53. 

  53. 	}
    54. 

  54. 

  55. 	$static_characters = array_merge(array('---', ' -- ', '--', ' - ', 'xn&#8211;', '...', '``', '\'s', '\'\'', ' (tm)'), $cockney);
    56. 

  56. 	$static_replacements = array_merge(array('&#8212;', ' &#8212; ', '&#8211;', ' &#8211; ', 'xn--', '&#8230;', $opening_quote, '&#8217;s', $closing_quote, ' &#8482;'), $cockneyreplace);
    57. 

  57. 

  58. 	$dynamic_characters = array('/\'(\d\d(?:&#8217;|\')?s)/', '/(\s|\A|")\'/', '/(\d+)"/', '/(\d+)\'/', '/(\S)\'([^\'\s])/', '/(\s|\A)"(?!\s)/', '/"(\s|\S|\Z)/', '/\'([\s.]|\Z)/', '/(\d+)x(\d+)/');
    59. 

  59. 	$dynamic_replacements = array('&#8217;$1','$1&#8216;', '$1&#8243;', '$1&#8242;', '$1&#8217;$2', '$1' . $opening_quote . '$2', $closing_quote . '$1', '&#8217;$1', '$1&#215;$2');
    60. 

  60. 

  61. 	for ( $i = 0; $i < $stop; $i++ ) {
    62. 

  62. 		$curl = $textarr[$i];
    63. 

  63. 

  64. 		if ( !empty($curl) && '<' != $curl{0} && '[' != $curl{0}
    65. 

  65. 				&& empty($no_texturize_shortcodes_stack) && empty($no_texturize_tags_stack)) { // If it's not a tag
    66. 

  66. 			// static strings
    67. 

  67. 			$curl = str_replace($static_characters, $static_replacements, $curl);
    68. 

  68. 			// regular expressions
    69. 

  69. 			$curl = preg_replace($dynamic_characters, $dynamic_replacements, $curl);
    70. 

  70. 		} else {
    71. 

  71. 			wptexturize_pushpop_element($curl, $no_texturize_tags_stack, $no_texturize_tags, '<', '>');
    72. 

  72. 			wptexturize_pushpop_element($curl, $no_texturize_shortcodes_stack, $no_texturize_shortcodes, '[', ']');
    73. 

  73. 		}
    74. 

  74. 

  75. 		$curl = preg_replace('/&([^#])(?![a-zA-Z1-4]{1,8};)/', '&#038;$1', $curl);
    76. 

  76. 		$output .= $curl;
    77. 

  77. 	}
    78. 

  78. 

  79. 	return $output;
    80. 

  80. }
    81. 

  81. 

  82. function wptexturize_pushpop_element($text, &$stack, $disabled_elements, $opening = '<', $closing = '>') {
    83. 

  83. 	$o = preg_quote($opening, '/');
    84. 

  84. 	$c = preg_quote($closing, '/');
    85. 

  85. 	foreach($disabled_elements as $element) {
    86. 

  86. 		if (preg_match('/^'.$o.$element.'\b/', $text)) array_push($stack, $element);
    87. 

  87. 		if (preg_match('/^'.$o.'\/'.$element.$c.'/', $text)) {
    88. 

  88. 			$last = array_pop($stack);
    89. 

  89. 			// disable texturize until we find a closing tag of our type (e.g. <pre>)
    90. 

  90. 			// even if there was invalid nesting before that
    91. 

  91. 			// Example: in the case <pre>sadsadasd</code>"baba"</pre> "baba" won't be texturized
    92. 

  92. 			if ($last != $element) array_push($stack, $last);
    93. 

  93. 		}
    94. 

  94. 	}
    95. 

  95. }
    96. 

  96. 

  97. /**
    98. 

  98.  * Accepts matches array from preg_replace_callback in wpautop() or a string.
    99. 

  99.  *
    100. 

  100.  * Ensures that the contents of a <<pre>>...<</pre>> HTML block are not
    101. 

  101.  * converted into paragraphs or line-breaks.
    102. 

  102.  *
    103. 

  103.  * @since 1.2.0
    104. 

  104.  *
    105. 

  105.  * @param array|string $matches The array or string
    106. 

  106.  * @return string The pre block without paragraph/line-break conversion.
    107. 

  107.  */
    108. 

  108. function clean_pre($matches) {
    109. 

  109. 	if ( is_array($matches) )
    110. 

  110. 		$text = $matches[1] . $matches[2] . "</pre>";
    111. 

  111. 	else
    112. 

  112. 		$text = $matches;
    113. 

  113. 

  114. 	$text = str_replace('<br />', '', $text);
    115. 

  115. 	$text = str_replace('<p>', "\n", $text);
    116. 

  116. 	$text = str_replace('</p>', '', $text);
    117. 

  117. 

  118. 	return $text;
    119. 

  119. }
    120. 

  120. 

  121. /**
    122. 

  122.  * Replaces double line-breaks with paragraph elements.
    123. 

  123.  *
    124. 

  124.  * A group of regex replaces used to identify text formatted with newlines and
    125. 

  125.  * replace double line-breaks with HTML paragraph tags. The remaining
    126. 

  126.  * line-breaks after conversion become <<br />> tags, unless $br is set to '0'
    127. 

  127.  * or 'false'.
    128. 

  128.  *
    129. 

  129.  * @since 0.71
    130. 

  130.  *
    131. 

  131.  * @param string $pee The text which has to be formatted.
    132. 

  132.  * @param int|bool $br Optional. If set, this will convert all remaining line-breaks after paragraphing. Default true.
    133. 

  133.  * @return string Text which has been converted into correct paragraph tags.
    134. 

  134.  */
    135. 

  135. function wpautop($pee, $br = 1) {
    136. 

  136. 	if ( trim($pee) === '' )
    137. 

  137. 		return '';
    138. 

  138. 	$pee = $pee . "\n"; // just to make things a little easier, pad the end
    139. 

  139. 	$pee = preg_replace('|<br />\s*<br />|', "\n\n", $pee);
    140. 

  140. 	// Space things out a little
    141. 

  141. 	$allblocks = '(?:table|thead|tfoot|caption|col|colgroup|tbody|tr|td|th|div|dl|dd|dt|ul|ol|li|pre|select|form|map|area|blockquote|address|math|style|input|p|h[1-6]|hr)';
    142. 

  142. 	$pee = preg_replace('!(<' . $allblocks . '[^>]*>)!', "\n$1", $pee);
    143. 

  143. 	$pee = preg_replace('!(</' . $allblocks . '>)!', "$1\n\n", $pee);
    144. 

  144. 	$pee = str_replace(array("\r\n", "\r"), "\n", $pee); // cross-platform newlines
    145. 

  145. 	if ( strpos($pee, '<object') !== false ) {
    146. 

  146. 		$pee = preg_replace('|\s*<param([^>]*)>\s*|', "<param$1>", $pee); // no pee inside object/embed
    147. 

  147. 		$pee = preg_replace('|\s*</embed>\s*|', '</embed>', $pee);
    148. 

  148. 	}
    149. 

  149. 	$pee = preg_replace("/\n\n+/", "\n\n", $pee); // take care of duplicates
    150. 

  150. 	// make paragraphs, including one at the end
    151. 

  151. 	$pees = preg_split('/\n\s*\n/', $pee, -1, PREG_SPLIT_NO_EMPTY);
    152. 

  152. 	$pee = '';
    153. 

  153. 	foreach ( $pees as $tinkle )
    154. 

  154. 		$pee .= '<p>' . trim($tinkle, "\n") . "</p>\n";
    155. 

  155. 	$pee = preg_replace('|<p>\s*</p>|', '', $pee); // under certain strange conditions it could create a P of entirely whitespace
    156. 

  156. 	$pee = preg_replace('!<p>([^<]+)</(div|address|form)>!', "<p>$1</p></$2>", $pee);
    157. 

  157. 	$pee = preg_replace('!<p>\s*(</?' . $allblocks . '[^>]*>)\s*</p>!', "$1", $pee); // don't pee all over a tag
    158. 

  158. 	$pee = preg_replace("|<p>(<li.+?)</p>|", "$1", $pee); // problem with nested lists
    159. 

  159. 	$pee = preg_replace('|<p><blockquote([^>]*)>|i', "<blockquote$1><p>", $pee);
    160. 

  160. 	$pee = str_replace('</blockquote></p>', '</p></blockquote>', $pee);
    161. 

  161. 	$pee = preg_replace('!<p>\s*(</?' . $allblocks . '[^>]*>)!', "$1", $pee);
    162. 

  162. 	$pee = preg_replace('!(</?' . $allblocks . '[^>]*>)\s*</p>!', "$1", $pee);
    163. 

  163. 	if ($br) {
    164. 

  164. 		$pee = preg_replace_callback('/<(script|style).*?<\/\\1>/s', create_function('$matches', 'return str_replace("\n", "<WPPreserveNewline />", $matches[0]);'), $pee);
    165. 

  165. 		$pee = preg_replace('|(?<!<br />)\s*\n|', "<br />\n", $pee); // optionally make line breaks
    166. 

  166. 		$pee = str_replace('<WPPreserveNewline />', "\n", $pee);
    167. 

  167. 	}
    168. 

  168. 	$pee = preg_replace('!(</?' . $allblocks . '[^>]*>)\s*<br />!', "$1", $pee);
    169. 

  169. 	$pee = preg_replace('!<br />(\s*</?(?:p|li|div|dl|dd|dt|th|pre|td|ul|ol)[^>]*>)!', '$1', $pee);
    170. 

  170. 	if (strpos($pee, '<pre') !== false)
    171. 

  171. 		$pee = preg_replace_callback('!(<pre[^>]*>)(.*?)</pre>!is', 'clean_pre', $pee );
    172. 

  172. 	$pee = preg_replace( "|\n</p>$|", '</p>', $pee );
    173. 

  173. 	$pee = preg_replace('/<p>\s*?(' . get_shortcode_regex() . ')\s*<\/p>/s', '$1', $pee); // don't auto-p wrap shortcodes that stand alone
    174. 

  174. 

  175. 	return $pee;
    176. 

  176. }
    177. 

  177. 

  178. /**
    179. 

  179.  * Checks to see if a string is utf8 encoded.
    180. 

  180.  *
    181. 

  181.  * NOTE: This function checks for 5-Byte sequences, UTF8
    182. 

  182.  *       has Bytes Sequences with a maximum length of 4.
    183. 

  183.  *
    184. 

  184.  * @author bmorel at ssi dot fr (modified)
    185. 

  185.  * @since 1.2.1
    186. 

  186.  *
    187. 

  187.  * @param string $str The string to be checked
    188. 

  188.  * @return bool True if $str fits a UTF-8 model, false otherwise.
    189. 

  189.  */
    190. 

  190. function seems_utf8($str) {
    191. 

  191. 	$length = strlen($str);
    192. 

  192. 	for ($i=0; $i < $length; $i++) {
    193. 

  193. 		$c = ord($str[$i]);
    194. 

  194. 		if ($c < 0x80) $n = 0; # 0bbbbbbb
    195. 

  195. 		elseif (($c & 0xE0) == 0xC0) $n=1; # 110bbbbb
    196. 

  196. 		elseif (($c & 0xF0) == 0xE0) $n=2; # 1110bbbb
    197. 

  197. 		elseif (($c & 0xF8) == 0xF0) $n=3; # 11110bbb
    198. 

  198. 		elseif (($c & 0xFC) == 0xF8) $n=4; # 111110bb
    199. 

  199. 		elseif (($c & 0xFE) == 0xFC) $n=5; # 1111110b
    200. 

  200. 		else return false; # Does not match any model
    201. 

  201. 		for ($j=0; $j<$n; $j++) { # n bytes matching 10bbbbbb follow ?
    202. 

  202. 			if ((++$i == $length) || ((ord($str[$i]) & 0xC0) != 0x80))
    203. 

  203. 				return false;
    204. 

  204. 		}
    205. 

  205. 	}
    206. 

  206. 	return true;
    207. 

  207. }
    208. 

  208. 

  209. /**
    210. 

  210.  * Converts a number of special characters into their HTML entities.
    211. 

  211.  *
    212. 

  212.  * Specifically deals with: &, <, >, ", and '.
    213. 

  213.  *
    214. 

  214.  * $quote_style can be set to ENT_COMPAT to encode " to
    215. 

  215.  * &quot;, or ENT_QUOTES to do both. Default is ENT_NOQUOTES where no quotes are encoded.
    216. 

  216.  *
    217. 

  217.  * @since 1.2.2
    218. 

  218.  *
    219. 

  219.  * @param string $string The text which is to be encoded.
    220. 

  220.  * @param mixed $quote_style Optional. Converts double quotes if set to ENT_COMPAT, both single and double if set to ENT_QUOTES or none if set to ENT_NOQUOTES. Also compatible with old values; converting single quotes if set to 'single', double if set to 'double' or both if otherwise set. Default is ENT_NOQUOTES.
    221. 

  221.  * @param string $charset Optional. The character encoding of the string. Default is false.
    222. 

  222.  * @param boolean $double_encode Optional. Whether or not to encode existing html entities. Default is false.
    223. 

  223.  * @return string The encoded text with HTML entities.
    224. 

  224.  */
    225. 

  225. function _wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) {
    226. 

  226. 	$string = (string) $string;
    227. 

  227. 

  228. 	if ( 0 === strlen( $string ) ) {
    229. 

  229. 		return '';
    230. 

  230. 	}
    231. 

  231. 

  232. 	// Don't bother if there are no specialchars - saves some processing
    233. 

  233. 	if ( !preg_match( '/[&<>"\']/', $string ) ) {
    234. 

  234. 		return $string;
    235. 

  235. 	}
    236. 

  236. 

  237. 	// Account for the previous behaviour of the function when the $quote_style is not an accepted value
    238. 

  238. 	if ( empty( $quote_style ) ) {
    239. 

  239. 		$quote_style = ENT_NOQUOTES;
    240. 

  240. 	} elseif ( !in_array( $quote_style, array( 0, 2, 3, 'single', 'double' ), true ) ) {
    241. 

  241. 		$quote_style = ENT_QUOTES;
    242. 

  242. 	}
    243. 

  243. 

  244. 	// Store the site charset as a static to avoid multiple calls to wp_load_alloptions()
    245. 

  245. 	if ( !$charset ) {
    246. 

  246. 		static $_charset;
    247. 

  247. 		if ( !isset( $_charset ) ) {
    248. 

  248. 			$alloptions = wp_load_alloptions();
    249. 

  249. 			$_charset = isset( $alloptions['blog_charset'] ) ? $alloptions['blog_charset'] : '';
    250. 

  250. 		}
    251. 

  251. 		$charset = $_charset;
    252. 

  252. 	}
    253. 

  253. 	if ( in_array( $charset, array( 'utf8', 'utf-8', 'UTF8' ) ) ) {
    254. 

  254. 		$charset = 'UTF-8';
    255. 

  255. 	}
    256. 

  256. 

  257. 	$_quote_style = $quote_style;
    258. 

  258. 

  259. 	if ( $quote_style === 'double' ) {
    260. 

  260. 		$quote_style = ENT_COMPAT;
    261. 

  261. 		$_quote_style = ENT_COMPAT;
    262. 

  262. 	} elseif ( $quote_style === 'single' ) {
    263. 

  263. 		$quote_style = ENT_NOQUOTES;
    264. 

  264. 	}
    265. 

  265. 

  266. 	// Handle double encoding ourselves
    267. 

  267. 	if ( !$double_encode ) {
    268. 

  268. 		$string = wp_specialchars_decode( $string, $_quote_style );
    269. 

  269. 		$string = preg_replace( '/&(#?x?[0-9a-z]+);/i', '|wp_entity|$1|/wp_entity|', $string );
    270. 

  270. 	}
    271. 

  271. 

  272. 	$string = @htmlspecialchars( $string, $quote_style, $charset );
    273. 

  273. 

  274. 	// Handle double encoding ourselves
    275. 

  275. 	if ( !$double_encode ) {
    276. 

  276. 		$string = str_replace( array( '|wp_entity|', '|/wp_entity|' ), array( '&', ';' ), $string );
    277. 

  277. 	}
    278. 

  278. 

  279. 	// Backwards compatibility
    280. 

  280. 	if ( 'single' === $_quote_style ) {
    281. 

  281. 		$string = str_replace( "'", '&#039;', $string );
    282. 

  282. 	}
    283. 

  283. 

  284. 	return $string;
    285. 

  285. }
    286. 

  286. 

  287. /**
    288. 

  288.  * Converts a number of HTML entities into their special characters.
    289. 

  289.  *
    290. 

  290.  * Specifically deals with: &, <, >, ", and '.
    291. 

  291.  *
    292. 

  292.  * $quote_style can be set to ENT_COMPAT to decode " entities,
    293. 

  293.  * or ENT_QUOTES to do both " and '. Default is ENT_NOQUOTES where no quotes are decoded.
    294. 

  294.  *
    295. 

  295.  * @since 2.8
    296. 

  296.  *
    297. 

  297.  * @param string $string The text which is to be decoded.
    298. 

  298.  * @param mixed $quote_style Optional. Converts double quotes if set to ENT_COMPAT, both single and double if set to ENT_QUOTES or none if set to ENT_NOQUOTES. Also compatible with old _wp_specialchars() values; converting single quotes if set to 'single', double if set to 'double' or both if otherwise set. Default is ENT_NOQUOTES.
    299. 

  299.  * @return string The decoded text without HTML entities.
    300. 

  300.  */
    301. 

  301. function wp_specialchars_decode( $string, $quote_style = ENT_NOQUOTES ) {
    302. 

  302. 	$string = (string) $string;
    303. 

  303. 

  304. 	if ( 0 === strlen( $string ) ) {
    305. 

  305. 		return '';
    306. 

  306. 	}
    307. 

  307. 

  308. 	// Don't bother if there are no entities - saves a lot of processing
    309. 

  309. 	if ( strpos( $string, '&' ) === false ) {
    310. 

  310. 		return $string;
    311. 

  311. 	}
    312. 

  312. 

  313. 	// Match the previous behaviour of _wp_specialchars() when the $quote_style is not an accepted value
    314. 

  314. 	if ( empty( $quote_style ) ) {
    315. 

  315. 		$quote_style = ENT_NOQUOTES;
    316. 

  316. 	} elseif ( !in_array( $quote_style, array( 0, 2, 3, 'single', 'double' ), true ) ) {
    317. 

  317. 		$quote_style = ENT_QUOTES;
    318. 

  318. 	}
    319. 

  319. 

  320. 	// More complete than get_html_translation_table( HTML_SPECIALCHARS )
    321. 

  321. 	$single = array( '&#039;'  => '\'', '&#x27;' => '\'' );
    322. 

  322. 	$single_preg = array( '/&#0*39;/'  => '&#039;', '/&#x0*27;/i' => '&#x27;' );
    323. 

  323. 	$double = array( '&quot;' => '"', '&#034;'  => '"', '&#x22;' => '"' );
    324. 

  324. 	$double_preg = array( '/&#0*34;/'  => '&#034;', '/&#x0*22;/i' => '&#x22;' );
    325. 

  325. 	$others = array( '&lt;'   => '<', '&#060;'  => '<', '&gt;'   => '>', '&#062;'  => '>', '&amp;'  => '&', '&#038;'  => '&', '&#x26;' => '&' );
    326. 

  326. 	$others_preg = array( '/&#0*60;/'  => '&#060;', '/&#0*62;/'  => '&#062;', '/&#0*38;/'  => '&#038;', '/&#x0*26;/i' => '&#x26;' );
    327. 

  327. 

  328. 	if ( $quote_style === ENT_QUOTES ) {
    329. 

  329. 		$translation = array_merge( $single, $double, $others );
    330. 

  330. 		$translation_preg = array_merge( $single_preg, $double_preg, $others_preg );
    331. 

  331. 	} elseif ( $quote_style === ENT_COMPAT || $quote_style === 'double' ) {
    332. 

  332. 		$translation = array_merge( $double, $others );
    333. 

  333. 		$translation_preg = array_merge( $double_preg, $others_preg );
    334. 

  334. 	} elseif ( $quote_style === 'single' ) {
    335. 

  335. 		$translation = array_merge( $single, $others );
    336. 

  336. 		$translation_preg = array_merge( $single_preg, $others_preg );
    337. 

  337. 	} elseif ( $quote_style === ENT_NOQUOTES ) {
    338. 

  338. 		$translation = $others;
    339. 

  339. 		$translation_preg = $others_preg;
    340. 

  340. 	}
    341. 

  341. 

  342. 	// Remove zero padding on numeric entities
    343. 

  343. 	$string = preg_replace( array_keys( $translation_preg ), array_values( $translation_preg ), $string );
    344. 

  344. 

  345. 	// Replace characters according to translation table
    346. 

  346. 	return strtr( $string, $translation );
    347. 

  347. }
    348. 

  348. 

  349. /**
    350. 

  350.  * Checks for invalid UTF8 in a string.
    351. 

  351.  *
    352. 

  352.  * @since 2.8
    353. 

  353.  *
    354. 

  354.  * @param string $string The text which is to be checked.
    355. 

  355.  * @param boolean $strip Optional. Whether to attempt to strip out invalid UTF8. Default is false.
    356. 

  356.  * @return string The checked text.
    357. 

  357.  */
    358. 

  358. function wp_check_invalid_utf8( $string, $strip = false ) {
    359. 

  359. 	$string = (string) $string;
    360. 

  360. 

  361. 	if ( 0 === strlen( $string ) ) {
    362. 

  362. 		return '';
    363. 

  363. 	}
    364. 

  364. 

  365. 	// Store the site charset as a static to avoid multiple calls to get_option()
    366. 

  366. 	static $is_utf8;
    367. 

  367. 	if ( !isset( $is_utf8 ) ) {
    368. 

  368. 		$is_utf8 = in_array( get_option( 'blog_charset' ), array( 'utf8', 'utf-8', 'UTF8', 'UTF-8' ) );
    369. 

  369. 	}
    370. 

  370. 	if ( !$is_utf8 ) {
    371. 

  371. 		return $string;
    372. 

  372. 	}
    373. 

  373. 

  374. 	// Check for support for utf8 in the installed PCRE library once and store the result in a static
    375. 

  375. 	static $utf8_pcre;
    376. 

  376. 	if ( !isset( $utf8_pcre ) ) {
    377. 

  377. 		$utf8_pcre = @preg_match( '/^./u', 'a' );
    378. 

  378. 	}
    379. 

  379. 	// We can't demand utf8 in the PCRE installation, so just return the string in those cases
    380. 

  380. 	if ( !$utf8_pcre ) {
    381. 

  381. 		return $string;
    382. 

  382. 	}
    383. 

  383. 

  384. 	// preg_match fails when it encounters invalid UTF8 in $string
    385. 

  385. 	if ( 1 === @preg_match( '/^./us', $string ) ) {
    386. 

  386. 		return $string;
    387. 

  387. 	}
    388. 

  388. 

  389. 	// Attempt to strip the bad chars if requested (not recommended)
    390. 

  390. 	if ( $strip && function_exists( 'iconv' ) ) {
    391. 

  391. 		return iconv( 'utf-8', 'utf-8', $string );
    392. 

  392. 	}
    393. 

  393. 

  394. 	return '';
    395. 

  395. }
    396. 

  396. 

  397. /**
    398. 

  398.  * Encode the Unicode values to be used in the URI.
    399. 

  399.  *
    400. 

  400.  * @since 1.5.0
    401. 

  401.  *
    402. 

  402.  * @param string $utf8_string
    403. 

  403.  * @param int $length Max length of the string
    404. 

  404.  * @return string String with Unicode encoded for URI.
    405. 

  405.  */
    406. 

  406. function utf8_uri_encode( $utf8_string, $length = 0 ) {
    407. 

  407. 	$unicode = '';
    408. 

  408. 	$values = array();
    409. 

  409. 	$num_octets = 1;
    410. 

  410. 	$unicode_length = 0;
    411. 

  411. 

  412. 	$string_length = strlen( $utf8_string );
    413. 

  413. 	for ($i = 0; $i < $string_length; $i++ ) {
    414. 

  414. 

  415. 		$value = ord( $utf8_string[ $i ] );
    416. 

  416. 

  417. 		if ( $value < 128 ) {
    418. 

  418. 			if ( $length && ( $unicode_length >= $length ) )
    419. 

  419. 				break;
    420. 

  420. 			$unicode .= chr($value);
    421. 

  421. 			$unicode_length++;
    422. 

  422. 		} else {
    423. 

  423. 			if ( count( $values ) == 0 ) $num_octets = ( $value < 224 ) ? 2 : 3;
    424. 

  424. 

  425. 			$values[] = $value;
    426. 

  426. 

  427. 			if ( $length && ( $unicode_length + ($num_octets * 3) ) > $length )
    428. 

  428. 				break;
    429. 

  429. 			if ( count( $values ) == $num_octets ) {
    430. 

  430. 				if ($num_octets == 3) {
    431. 

  431. 					$unicode .= '%' . dechex($values[0]) . '%' . dechex($values[1]) . '%' . dechex($values[2]);
    432. 

  432. 					$unicode_length += 9;
    433. 

  433. 				} else {
    434. 

  434. 					$unicode .= '%' . dechex($values[0]) . '%' . dechex($values[1]);
    435. 

  435. 					$unicode_length += 6;
    436. 

  436. 				}
    437. 

  437. 

  438. 				$values = array();
    439. 

  439. 				$num_octets = 1;
    440. 

  440. 			}
    441. 

  441. 		}
    442. 

  442. 	}
    443. 

  443. 

  444. 	return $unicode;
    445. 

  445. }
    446. 

  446. 

  447. /**
    448. 

  448.  * Converts all accent characters to ASCII characters.
    449. 

  449.  *
    450. 

  450.  * If there are no accent characters, then the string given is just returned.
    451. 

  451.  *
    452. 

  452.  * @since 1.2.1
    453. 

  453.  *
    454. 

  454.  * @param string $string Text that might have accent characters
    455. 

  455.  * @return string Filtered string with replaced "nice" characters.
    456. 

  456.  */
    457. 

  457. function remove_accents($string) {
    458. 

  458. 	if ( !preg_match('/[\x80-\xff]/', $string) )
    459. 

  459. 		return $string;
    460. 

  460. 

  461. 	if (seems_utf8($string)) {
    462. 

  462. 		$chars = array(
    463. 

  463. 		// Decompositions for Latin-1 Supplement
    464. 

  464. 		chr(195).chr(128) => 'A', chr(195).chr(129) => 'A',
    465. 

  465. 		chr(195).chr(130) => 'A', chr(195).chr(131) => 'A',
    466. 

  466. 		chr(195).chr(132) => 'A', chr(195).chr(133) => 'A',
    467. 

  467. 		chr(195).chr(135) => 'C', chr(195).chr(136) => 'E',
    468. 

  468. 		chr(195).chr(137) => 'E', chr(195).chr(138) => 'E',
    469. 

  469. 		chr(195).chr(139) => 'E', chr(195).chr(140) => 'I',
    470. 

  470. 		chr(195).chr(141) => 'I', chr(195).chr(142) => 'I',
    471. 

  471. 		chr(195).chr(143) => 'I', chr(195).chr(145) => 'N',
    472. 

  472. 		chr(195).chr(146) => 'O', chr(195).chr(147) => 'O',
    473. 

  473. 		chr(195).chr(148) => 'O', chr(195).chr(149) => 'O',
    474. 

  474. 		chr(195).chr(150) => 'O', chr(195).chr(153) => 'U',
    475. 

  475. 		chr(195).chr(154) => 'U', chr(195).chr(155) => 'U',
    476. 

  476. 		chr(195).chr(156) => 'U', chr(195).chr(157) => 'Y',
    477. 

  477. 		chr(195).chr(159) => 's', chr(195).chr(160) => 'a',
    478. 

  478. 		chr(195).chr(161) => 'a', chr(195).chr(162) => 'a',
    479. 

  479. 		chr(195).chr(163) => 'a', chr(195).chr(164) => 'a',
    480. 

  480. 		chr(195).chr(165) => 'a', chr(195).chr(167) => 'c',
    481. 

  481. 		chr(195).chr(168) => 'e', chr(195).chr(169) => 'e',
    482. 

  482. 		chr(195).chr(170) => 'e', chr(195).chr(171) => 'e',
    483. 

  483. 		chr(195).chr(172) => 'i', chr(195).chr(173) => 'i',
    484. 

  484. 		chr(195).chr(174) => 'i', chr(195).chr(175) => 'i',
    485. 

  485. 		chr(195).chr(177) => 'n', chr(195).chr(178) => 'o',
    486. 

  486. 		chr(195).chr(179) => 'o', chr(195).chr(180) => 'o',
    487. 

  487. 		chr(195).chr(181) => 'o', chr(195).chr(182) => 'o',
    488. 

  488. 		chr(195).chr(182) => 'o', chr(195).chr(185) => 'u',
    489. 

  489. 		chr(195).chr(186) => 'u', chr(195).chr(187) => 'u',
    490. 

  490. 		chr(195).chr(188) => 'u', chr(195).chr(189) => 'y',
    491. 

  491. 		chr(195).chr(191) => 'y',
    492. 

  492. 		// Decompositions for Latin Extended-A
    493. 

  493. 		chr(196).chr(128) => 'A', chr(196).chr(129) => 'a',
    494. 

  494. 		chr(196).chr(130) => 'A', chr(196).chr(131) => 'a',
    495. 

  495. 		chr(196).chr(132) => 'A', chr(196).chr(133) => 'a',
    496. 

  496. 		chr(196).chr(134) => 'C', chr(196).chr(135) => 'c',
    497. 

  497. 		chr(196).chr(136) => 'C', chr(196).chr(137) => 'c',
    498. 

  498. 		chr(196).chr(138) => 'C', chr(196).chr(139) => 'c',
    499. 

  499. 		chr(196).chr(140) => 'C', chr(196).chr(141) => 'c',
    500. 

  500. 		chr(196).chr(142) => 'D', chr(196).chr(143) => 'd',
    501. 

  501. 		chr(196).chr(144) => 'D', chr(196).chr(145) => 'd',
    502. 

  502. 		chr(196).chr(146) => 'E', chr(196).chr(147) => 'e',
    503. 

  503. 		chr(196).chr(148) => 'E', chr(196).chr(149) => 'e',
    504. 

  504. 		chr(196).chr(150) => 'E', chr(196).chr(151) => 'e',
    505. 

  505. 		chr(196).chr(152) => 'E', chr(196).chr(153) => 'e',
    506. 

  506. 		chr(196).chr(154) => 'E', chr(196).chr(155) => 'e',
    507. 

  507. 		chr(196).chr(156) => 'G', chr(196).chr(157) => 'g',
    508. 

  508. 		chr(196).chr(158) => 'G', chr(196).chr(159) => 'g',
    509. 

  509. 		chr(196).chr(160) => 'G', chr(196).chr(161) => 'g',
    510. 

  510. 		chr(196).chr(162) => 'G', chr(196).chr(163) => 'g',
    511. 

  511. 		chr(196).chr(164) => 'H', chr(196).chr(165) => 'h',
    512. 

  512. 		chr(196).chr(166) => 'H', chr(196).chr(167) => 'h',
    513. 

  513. 		chr(196).chr(168) => 'I', chr(196).chr(169) => 'i',
    514. 

  514. 		chr(196).chr(170) => 'I', chr(196).chr(171) => 'i',
    515. 

  515. 		chr(196).chr(172) => 'I', chr(196).chr(173) => 'i',
    516. 

  516. 		chr(196).chr(174) => 'I', chr(196).chr(175) => 'i',
    517. 

  517. 		chr(196).chr(176) => 'I', chr(196).chr(177) => 'i',
    518. 

  518. 		chr(196).chr(178) => 'IJ',chr(196).chr(179) => 'ij',
    519. 

  519. 		chr(196).chr(180) => 'J', chr(196).chr(181) => 'j',
    520. 

  520. 		chr(196).chr(182) => 'K', chr(196).chr(183) => 'k',
    521. 

  521. 		chr(196).chr(184) => 'k', chr(196).chr(185) => 'L',
    522. 

  522. 		chr(196).chr(186) => 'l', chr(196).chr(187) => 'L',
    523. 

  523. 		chr(196).chr(188) => 'l', chr(196).chr(189) => 'L',
    524. 

  524. 		chr(196).chr(190) => 'l', chr(196).chr(191) => 'L',
    525. 

  525. 		chr(197).chr(128) => 'l', chr(197).chr(129) => 'L',
    526. 

  526. 		chr(197).chr(130) => 'l', chr(197).chr(131) => 'N',
    527. 

  527. 		chr(197).chr(132) => 'n', chr(197).chr(133) => 'N',
    528. 

  528. 		chr(197).chr(134) => 'n', chr(197).chr(135) => 'N',
    529. 

  529. 		chr(197).chr(136) => 'n', chr(197).chr(137) => 'N',
    530. 

  530. 		chr(197).chr(138) => 'n', chr(197).chr(139) => 'N',
    531. 

  531. 		chr(197).chr(140) => 'O', chr(197).chr(141) => 'o',
    532. 

  532. 		chr(197).chr(142) => 'O', chr(197).chr(143) => 'o',
    533. 

  533. 		chr(197).chr(144) => 'O', chr(197).chr(145) => 'o',
    534. 

  534. 		chr(197).chr(146) => 'OE',chr(197).chr(147) => 'oe',
    535. 

  535. 		chr(197).chr(148) => 'R',chr(197).chr(149) => 'r',
    536. 

  536. 		chr(197).chr(150) => 'R',chr(197).chr(151) => 'r',
    537. 

  537. 		chr(197).chr(152) => 'R',chr(197).chr(153) => 'r',
    538. 

  538. 		chr(197).chr(154) => 'S',chr(197).chr(155) => 's',
    539. 

  539. 		chr(197).chr(156) => 'S',chr(197).chr(157) => 's',
    540. 

  540. 		chr(197).chr(158) => 'S',chr(197).chr(159) => 's',
    541. 

  541. 		chr(197).chr(160) => 'S', chr(197).chr(161) => 's',
    542. 

  542. 		chr(197).chr(162) => 'T', chr(197).chr(163) => 't',
    543. 

  543. 		chr(197).chr(164) => 'T', chr(197).chr(165) => 't',
    544. 

  544. 		chr(197).chr(166) => 'T', chr(197).chr(167) => 't',
    545. 

  545. 		chr(197).chr(168) => 'U', chr(197).chr(169) => 'u',
    546. 

  546. 		chr(197).chr(170) => 'U', chr(197).chr(171) => 'u',
    547. 

  547. 		chr(197).chr(172) => 'U', chr(197).chr(173) => 'u',
    548. 

  548. 		chr(197).chr(174) => 'U', chr(197).chr(175) => 'u',
    549. 

  549. 		chr(197).chr(176) => 'U', chr(197).chr(177) => 'u',
    550. 

  550. 		chr(197).chr(178) => 'U', chr(197).chr(179) => 'u',
    551. 

  551. 		chr(197).chr(180) => 'W', chr(197).chr(181) => 'w',
    552. 

  552. 		chr(197).chr(182) => 'Y', chr(197).chr(183) => 'y',
    553. 

  553. 		chr(197).chr(184) => 'Y', chr(197).chr(185) => 'Z',
    554. 

  554. 		chr(197).chr(186) => 'z', chr(197).chr(187) => 'Z',
    555. 

  555. 		chr(197).chr(188) => 'z', chr(197).chr(189) => 'Z',
    556. 

  556. 		chr(197).chr(190) => 'z', chr(197).chr(191) => 's',
    557. 

  557. 		// Euro Sign
    558. 

  558. 		chr(226).chr(130).chr(172) => 'E',
    559. 

  559. 		// GBP (Pound) Sign
    560. 

  560. 		chr(194).chr(163) => '');
    561. 

  561. 

  562. 		$string = strtr($string, $chars);
    563. 

  563. 	} else {
    564. 

  564. 		// Assume ISO-8859-1 if not UTF-8
    565. 

  565. 		$chars['in'] = chr(128).chr(131).chr(138).chr(142).chr(154).chr(158)
    566. 

  566. 			.chr(159).chr(162).chr(165).chr(181).chr(192).chr(193).chr(194)
    567. 

  567. 			.chr(195).chr(196).chr(197).chr(199).chr(200).chr(201).chr(202)
    568. 

  568. 			.chr(203).chr(204).chr(205).chr(206).chr(207).chr(209).chr(210)
    569. 

  569. 			.chr(211).chr(212).chr(213).chr(214).chr(216).chr(217).chr(218)
    570. 

  570. 			.chr(219).chr(220).chr(221).chr(224).chr(225).chr(226).chr(227)
    571. 

  571. 			.chr(228).chr(229).chr(231).chr(232).chr(233).chr(234).chr(235)
    572. 

  572. 			.chr(236).chr(237).chr(238).chr(239).chr(241).chr(242).chr(243)
    573. 

  573. 			.chr(244).chr(245).chr(246).chr(248).chr(249).chr(250).chr(251)
    574. 

  574. 			.chr(252).chr(253).chr(255);
    575. 

  575. 

  576. 		$chars['out'] = "EfSZszYcYuAAAAAACEEEEIIIINOOOOOOUUUUYaaaaaaceeeeiiiinoooooouuuuyy";
    577. 

  577. 

  578. 		$string = strtr($string, $chars['in'], $chars['out']);
    579. 

  579. 		$double_chars['in'] = array(chr(140), chr(156), chr(198), chr(208), chr(222), chr(223), chr(230), chr(240), chr(254));
    580. 

  580. 		$double_chars['out'] = array('OE', 'oe', 'AE', 'DH', 'TH', 'ss', 'ae', 'dh', 'th');
    581. 

  581. 		$string = str_replace($double_chars['in'], $double_chars['out'], $string);
    582. 

  582. 	}
    583. 

  583. 

  584. 	return $string;
    585. 

  585. }
    586. 

  586. 

  587. /**
    588. 

  588.  * Sanitizes a filename replacing whitespace with dashes
    589. 

  589.  *
    590. 

  590.  * Removes special characters that are illegal in filenames on certain
    591. 

  591.  * operating systems and special characters requiring special escaping
    592. 

  592.  * to manipulate at the command line. Replaces spaces and consecutive
    593. 

  593.  * dashes with a single dash. Trim period, dash and underscore from beginning
    594. 

  594.  * and end of filename.
    595. 

  595.  *
    596. 

  596.  * @since 2.1.0
    597. 

  597.  *
    598. 

  598.  * @param string $filename The filename to be sanitized
    599. 

  599.  * @return string The sanitized filename
    600. 

  600.  */
    601. 

  601. function sanitize_file_name( $filename ) {
    602. 

  602. 	$filename_raw = $filename;
    603. 

  603. 	$special_chars = array("?", "[", "]", "/", "\\", "=", "<", ">", ":", ";", ",", "'", "\"", "&", "$", "#", "*", "(", ")", "|", "~", "`", "!", "{", "}", chr(0));
    604. 

  604. 	$special_chars = apply_filters('sanitize_file_name_chars', $special_chars, $filename_raw);
    605. 

  605. 	$filename = str_replace($special_chars, '', $filename);
    606. 

  606. 	$filename = preg_replace('/[\s-]+/', '-', $filename);
    607. 

  607. 	$filename = trim($filename, '.-_');
    608. 

  608. 	return apply_filters('sanitize_file_name', $filename, $filename_raw);
    609. 

  609. }
    610. 

  610. 

  611. /**
    612. 

  612.  * Sanitize username stripping out unsafe characters.
    613. 

  613.  *
    614. 

  614.  * If $strict is true, only alphanumeric characters (as well as _, space, ., -,
    615. 

  615.  * @) are returned.
    616. 

  616.  * Removes tags, octets, entities, and if strict is enabled, will remove all
    617. 

  617.  * non-ASCII characters. After sanitizing, it passes the username, raw username
    618. 

  618.  * (the username in the parameter), and the strict parameter as parameters for
    619. 

  619.  * the filter.
    620. 

  620.  *
    621. 

  621.  * @since 2.0.0
    622. 

  622.  * @uses apply_filters() Calls 'sanitize_user' hook on username, raw username,
    623. 

  623.  *		and $strict parameter.
    624. 

  624.  *
    625. 

  625.  * @param string $username The username to be sanitized.
    626. 

  626.  * @param bool $strict If set limits $username to specific characters. Default false.
    627. 

  627.  * @return string The sanitized username, after passing through filters.
    628. 

  628.  */
    629. 

  629. function sanitize_user( $username, $strict = false ) {
    630. 

  630. 	$raw_username = $username;
    631. 

  631. 	$username = strip_tags($username);
    632. 

  632. 	// Kill octets
    633. 

  633. 	$username = preg_replace('|%([a-fA-F0-9][a-fA-F0-9])|', '', $username);
    634. 

  634. 	$username = preg_replace('/&.+?;/', '', $username); // Kill entities
    635. 

  635. 

  636. 	// If strict, reduce to ASCII for max portability.
    637. 

  637. 	if ( $strict )
    638. 

  638. 		$username = preg_replace('|[^a-z0-9 _.\-@]|i', '', $username);
    639. 

  639. 

  640. 	// Consolidate contiguous whitespace
    641. 

  641. 	$username = preg_replace('|\s+|', ' ', $username);
    642. 

  642. 

  643. 	return apply_filters('sanitize_user', $username, $raw_username, $strict);
    644. 

  644. }
    645. 

  645. 

  646. /**
    647. 

  647.  * Sanitizes title or use fallback title.
    648. 

  648.  *
    649. 

  649.  * Specifically, HTML and PHP tags are stripped. Further actions can be added
    650. 

  650.  * via the plugin API. If $title is empty and $fallback_title is set, the latter
    651. 

  651.  * will be used.
    652. 

  652.  *
    653. 

  653.  * @since 1.0.0
    654. 

  654.  *
    655. 

  655.  * @param string $title The string to be sanitized.
    656. 

  656.  * @param string $fallback_title Optional. A title to use if $title is empty.
    657. 

  657.  * @return string The sanitized string.
    658. 

  658.  */
    659. 

  659. function sanitize_title($title, $fallback_title = '') {
    660. 

  660. 	$raw_title = $title;
    661. 

  661. 	$title = strip_tags($title);
    662. 

  662. 	$title = apply_filters('sanitize_title', $title, $raw_title);
    663. 

  663. 

  664. 	if ( '' === $title || false === $title )
    665. 

  665. 		$title = $fallback_title;
    666. 

  666. 

  667. 	return $title;
    668. 

  668. }
    669. 

  669. 

  670. /**
    671. 

  671.  * Sanitizes title, replacing whitespace with dashes.
    672. 

  672.  *
    673. 

  673.  * Limits the output to alphanumeric characters, underscore (_) and dash (-).
    674. 

  674.  * Whitespace becomes a dash.
    675. 

  675.  *
    676. 

  676.  * @since 1.2.0
    677. 

  677.  *
    678. 

  678.  * @param string $title The title to be sanitized.
    679. 

  679.  * @return string The sanitized title.
    680. 

  680.  */
    681. 

  681. function sanitize_title_with_dashes($title) {
    682. 

  682. 	$title = strip_tags($title);
    683. 

  683. 	// Preserve escaped octets.
    684. 

  684. 	$title = preg_replace('|%([a-fA-F0-9][a-fA-F0-9])|', '---$1---', $title);
    685. 

  685. 	// Remove percent signs that are not part of an octet.
    686. 

  686. 	$title = str_replace('%', '', $title);
    687. 

  687. 	// Restore octets.
    688. 

  688. 	$title = preg_replace('|---([a-fA-F0-9][a-fA-F0-9])---|', '%$1', $title);
    689. 

  689. 

  690. 	$title = remove_accents($title);
    691. 

  691. 	if (seems_utf8($title)) {
    692. 

  692. 		if (function_exists('mb_strtolower')) {
    693. 

  693. 			$title = mb_strtolower($title, 'UTF-8');
    694. 

  694. 		}
    695. 

  695. 		$title = utf8_uri_encode($title, 200);
    696. 

  696. 	}
    697. 

  697. 

  698. 	$title = strtolower($title);
    699. 

  699. 	$title = preg_replace('/&.+?;/', '', $title); // kill entities
    700. 

  700. 	$title = str_replace('.', '-', $title);
    701. 

  701. 	$title = preg_replace('/[^%a-z0-9 _-]/', '', $title);
    702. 

  702. 	$title = preg_replace('/\s+/', '-', $title);
    703. 

  703. 	$title = preg_replace('|-+|', '-', $title);
    704. 

  704. 	$title = trim($title, '-');
    705. 

  705. 

  706. 	return $title;
    707. 

  707. }
    708. 

  708. 

  709. /**
    710. 

  710.  * Ensures a string is a valid SQL order by clause.
    711. 

  711.  *
    712. 

  712.  * Accepts one or more columns, with or without ASC/DESC, and also accepts
    713. 

  713.  * RAND().
    714. 

  714.  *
    715. 

  715.  * @since 2.5.1
    716. 

  716.  *
    717. 

  717.  * @param string $orderby Order by string to be checked.
    718. 

  718.  * @return string|false Returns the order by clause if it is a match, false otherwise.
    719. 

  719.  */
    720. 

  720. function sanitize_sql_orderby( $orderby ){
    721. 

  721. 	preg_match('/^\s*([a-z0-9_]+(\s+(ASC|DESC))?(\s*,\s*|\s*$))+|^\s*RAND\(\s*\)\s*$/i', $orderby, $obmatches);
    722. 

  722. 	if ( !$obmatches )
    723. 

  723. 		return false;
    724. 

  724. 	return $orderby;
    725. 

  725. }
    726. 

  726. 

  727. /**
    728. 

  728.  * Santizes a html classname to ensure it only contains valid characters
    729. 

  729.  *
    730. 

  730.  * Strips the string down to A-Z,a-z,0-9,'-' if this results in an empty
    731. 

  731.  * string then it will return the alternative value supplied.
    732. 

  732.  *
    733. 

  733.  * @todo Expand to support the full range of CDATA that a class attribute can contain.
    734. 

  734.  *
    735. 

  735.  * @since 2.8.0
    736. 

  736.  *
    737. 

  737.  * @param string $class The classname to be sanitized
    738. 

  738.  * @param string $fallback The value to return if the sanitization end's up as an empty string.
    739. 

  739.  * @return string The sanitized value
    740. 

  740.  */
    741. 

  741. function sanitize_html_class($class, $fallback){
    742. 

  742. 	//Strip out any % encoded octets
    743. 

  743. 	$sanitized = preg_replace('|%[a-fA-F0-9][a-fA-F0-9]|', '', $class);
    744. 

  744. 

  745. 	//Limit to A-Z,a-z,0-9,'-'
    746. 

  746. 	$sanitized = preg_replace('/[^A-Za-z0-9-]/', '', $sanitized);
    747. 

  747. 

  748. 	if ('' == $sanitized)
    749. 

  749. 		$sanitized = $fallback;
    750. 

  750. 

  751. 	return apply_filters('sanitize_html_class',$sanitized, $class, $fallback);
    752. 

  752. }
    753. 

  753. 

  754. /**
    755. 

  755.  * Converts a number of characters from a string.
    756. 

  756.  *
    757. 

  757.  * Metadata tags <<title>> and <<category>> are removed, <<br>> and <<hr>> are
    758. 

  758.  * converted into correct XHTML and Unicode characters are converted to the
    759. 

  759.  * valid range.
    760. 

  760.  *
    761. 

  761.  * @since 0.71
    762. 

  762.  *
    763. 

  763.  * @param string $content String of characters to be converted.
    764. 

  764.  * @param string $deprecated Not used.
    765. 

  765.  * @return string Converted string.
    766. 

  766.  */
    767. 

  767. function convert_chars($content, $deprecated = '') {
    768. 

  768. 	// Translation of invalid Unicode references range to valid range
    769. 

  769. 	$wp_htmltranswinuni = array(
    770. 

  770. 	'&#128;' => '&#8364;', // the Euro sign
    771. 

  771. 	'&#129;' => '',
    772. 

  772. 	'&#130;' => '&#8218;', // these are Windows CP1252 specific characters
    773. 

  773. 	'&#131;' => '&#402;',  // they would look weird on non-Windows browsers
    774. 

  774. 	'&#132;' => '&#8222;',
    775. 

  775. 	'&#133;' => '&#8230;',
    776. 

  776. 	'&#134;' => '&#8224;',
    777. 

  777. 	'&#135;' => '&#8225;',
    778. 

  778. 	'&#136;' => '&#710;',
    779. 

  779. 	'&#137;' => '&#8240;',
    780. 

  780. 	'&#138;' => '&#352;',
    781. 

  781. 	'&#139;' => '&#8249;',
    782. 

  782. 	'&#140;' => '&#338;',
    783. 

  783. 	'&#141;' => '',
    784. 

  784. 	'&#142;' => '&#382;',
    785. 

  785. 	'&#143;' => '',
    786. 

  786. 	'&#144;' => '',
    787. 

  787. 	'&#145;' => '&#8216;',
    788. 

  788. 	'&#146;' => '&#8217;',
    789. 

  789. 	'&#147;' => '&#8220;',
    790. 

  790. 	'&#148;' => '&#8221;',
    791. 

  791. 	'&#149;' => '&#8226;',
    792. 

  792. 	'&#150;' => '&#8211;',
    793. 

  793. 	'&#151;' => '&#8212;',
    794. 

  794. 	'&#152;' => '&#732;',
    795. 

  795. 	'&#153;' => '&#8482;',
    796. 

  796. 	'&#154;' => '&#353;',
    797. 

  797. 	'&#155;' => '&#8250;',
    798. 

  798. 	'&#156;' => '&#339;',
    799. 

  799. 	'&#157;' => '',
    800. 

  800. 	'&#158;' => '',
    801. 

  801. 	'&#159;' => '&#376;'
    802. 

  802. 	);
    803. 

  803. 

  804. 	// Remove metadata tags
    805. 

  805. 	$content = preg_replace('/<title>(.+?)<\/title>/','',$content);
    806. 

  806. 	$content = preg_replace('/<category>(.+?)<\/category>/','',$content);
    807. 

  807. 

  808. 	// Converts lone & characters into &#38; (a.k.a. &amp;)
    809. 

  809. 	$content = preg_replace('/&([^#])(?![a-z1-4]{1,8};)/i', '&#038;$1', $content);
    810. 

  810. 

  811. 	// Fix Word pasting
    812. 

  812. 	$content = strtr($content, $wp_htmltranswinuni);
    813. 

  813. 

  814. 	// Just a little XHTML help
    815. 

  815. 	$content = str_replace('<br>', '<br />', $content);
    816. 

  816. 	$content = str_replace('<hr>', '<hr />', $content);
    817. 

  817. 

  818. 	return $content;
    819. 

  819. }
    820. 

  820. 

  821. /**
    822. 

  822.  * Callback used to change %uXXXX to &#YYY; syntax
    823. 

  823.  *
    824. 

  824.  * @since 2.8?
    825. 

  825.  *
    826. 

  826.  * @param array $matches Single Match
    827. 

  827.  * @return string An HTML entity
    828. 

  828.  */
    829. 

  829. function funky_javascript_callback($matches) {
    830. 

  830. 	return "&#".base_convert($matches[1],16,10).";";
    831. 

  831. }
    832. 

  832. 

  833. /**
    834. 

  834.  * Fixes javascript bugs in browsers.
    835. 

  835.  *
    836. 

  836.  * Converts unicode characters to HTML numbered entities.
    837. 

  837.  *
    838. 

  838.  * @since 1.5.0
    839. 

  839.  * @uses $is_macIE
    840. 

  840.  * @uses $is_winIE
    841. 

  841.  *
    842. 

  842.  * @param string $text Text to be made safe.
    843. 

  843.  * @return string Fixed text.
    844. 

  844.  */
    845. 

  845. function funky_javascript_fix($text) {
    846. 

  846. 	// Fixes for browsers' javascript bugs
    847. 

  847. 	global $is_macIE, $is_winIE;
    848. 

  848. 

  849. 	if ( $is_winIE || $is_macIE )
    850. 

  850. 		$text =  preg_replace_callback("/\%u([0-9A-F]{4,4})/",
    851. 

  851. 					       "funky_javascript_callback",
    852. 

  852. 					       $text);
    853. 

  853. 

  854. 	return $text;
    855. 

  855. }
    856. 

  856. 

  857. /**
    858. 

  858.  * Will only balance the tags if forced to and the option is set to balance tags.
    859. 

  859.  *
    860. 

  860.  * The option 'use_balanceTags' is used for whether the tags will be balanced.
    861. 

  861.  * Both the $force parameter and 'use_balanceTags' option will have to be true
    862. 

  862.  * before the tags will be balanced.
    863. 

  863.  *
    864. 

  864.  * @since 0.71
    865. 

  865.  *
    866. 

  866.  * @param string $text Text to be balanced
    867. 

  867.  * @param bool $force Forces balancing, ignoring the value of the option. Default false.
    868. 

  868.  * @return string Balanced text
    869. 

  869.  */
    870. 

  870. function balanceTags( $text, $force = false ) {
    871. 

  871. 	if ( !$force && get_option('use_balanceTags') == 0 )
    872. 

  872. 		return $text;
    873. 

  873. 	return force_balance_tags( $text );
    874. 

  874. }
    875. 

  875. 

  876. /**
    877. 

  877.  * Balances tags of string using a modified stack.
    878. 

  878.  *
    879. 

  879.  * @since 2.0.4
    880. 

  880.  *
    881. 

  881.  * @author Leonard Lin <leonard@acm.org>
    882. 

  882.  * @license GPL v2.0
    883. 

  883.  * @copyright November 4, 2001
    884. 

  884.  * @version 1.1
    885. 

  885.  * @todo Make better - change loop condition to $text in 1.2
    886. 

  886.  * @internal Modified by Scott Reilly (coffee2code) 02 Aug 2004
    887. 

  887.  *		1.1  Fixed handling of append/stack pop order of end text
    888. 

  888.  *			 Added Cleaning Hooks
    889. 

  889.  *		1.0  First Version
    890. 

  890.  *
    891. 

  891.  * @param string $text Text to be balanced.
    892. 

  892.  * @return string Balanced text.
    893. 

  893.  */
    894. 

  894. function force_balance_tags( $text ) {
    895. 

  895. 	$tagstack = array(); $stacksize = 0; $tagqueue = ''; $newtext = '';
    896. 

  896. 	$single_tags = array('br', 'hr', 'img', 'input'); //Known single-entity/self-closing tags
    897. 

  897. 	$nestable_tags = array('blockquote', 'div', 'span'); //Tags that can be immediately nested within themselves
    898. 

  898. 

  899. 	# WP bug fix for comments - in case you REALLY meant to type '< !--'
    900. 

  900. 	$text = str_replace('< !--', '<    !--', $text);
    901. 

  901. 	# WP bug fix for LOVE <3 (and other situations with '<' before a number)
    902. 

  902. 	$text = preg_replace('#<([0-9]{1})#', '&lt;$1', $text);
    903. 

  903. 

  904. 	while (preg_match("/<(\/?\w*)\s*([^>]*)>/",$text,$regex)) {
    905. 

  905. 		$newtext .= $tagqueue;
    906. 

  906. 

  907. 		$i = strpos($text,$regex[0]);
    908. 

  908. 		$l = strlen($regex[0]);
    909. 

  909. 

  910. 		// clear the shifter
    911. 

  911. 		$tagqueue = '';
    912. 

  912. 		// Pop or Push
    913. 

  913. 		if ( isset($regex[1][0]) && '/' == $regex[1][0] ) { // End Tag
    914. 

  914. 			$tag = strtolower(substr($regex[1],1));
    915. 

  915. 			// if too many closing tags
    916. 

  916. 			if($stacksize <= 0) {
    917. 

  917. 				$tag = '';
    918. 

  918. 				//or close to be safe $tag = '/' . $tag;
    919. 

  919. 			}
    920. 

  920. 			// if stacktop value = tag close value then pop
    921. 

  921. 			else if ($tagstack[$stacksize - 1] == $tag) { // found closing tag
    922. 

  922. 				$tag = '</' . $tag . '>'; // Close Tag
    923. 

  923. 				// Pop
    924. 

  924. 				array_pop ($tagstack);
    925. 

  925. 				$stacksize--;
    926. 

  926. 			} else { // closing tag not at top, search for it
    927. 

  927. 				for ($j=$stacksize-1;$j>=0;$j--) {
    928. 

  928. 					if ($tagstack[$j] == $tag) {
    929. 

  929. 					// add tag to tagqueue
    930. 

  930. 						for ($k=$stacksize-1;$k>=$j;$k--){
    931. 

  931. 							$tagqueue .= '</' . array_pop ($tagstack) . '>';
    932. 

  932. 							$stacksize--;
    933. 

  933. 						}
    934. 

  934. 						break;
    935. 

  935. 					}
    936. 

  936. 				}
    937. 

  937. 				$tag = '';
    938. 

  938. 			}
    939. 

  939. 		} else { // Begin Tag
    940. 

  940. 			$tag = strtolower($regex[1]);
    941. 

  941. 

  942. 			// Tag Cleaning
    943. 

  943. 

  944. 			// If self-closing or '', don't do anything.
    945. 

  945. 			if((substr($regex[2],-1) == '/') || ($tag == '')) {
    946. 

  946. 			}
    947. 

  947. 			// ElseIf it's a known single-entity tag but it doesn't close itself, do so
    948. 

  948. 			elseif ( in_array($tag, $single_tags) ) {
    949. 

  949. 				$regex[2] .= '/';
    950. 

  950. 			} else {	// Push the tag onto the stack
    951. 

  951. 				// If the top of the stack is the same as the tag we want to push, close previous tag
    952. 

  952. 				if (($stacksize > 0) && !in_array($tag, $nestable_tags) && ($tagstack[$stacksize - 1] == $tag)) {
    953. 

  953. 					$tagqueue = '</' . array_pop ($tagstack) . '>';
    954. 

  954. 					$stacksize--;
    955. 

  955. 				}
    956. 

  956. 				$stacksize = array_push ($tagstack, $tag);
    957. 

  957. 			}
    958. 

  958. 

  959. 			// Attributes
    960. 

  960. 			$attributes = $regex[2];
    961. 

  961. 			if($attributes) {
    962. 

  962. 				$attributes = ' '.$attributes;
    963. 

  963. 			}
    964. 

  964. 			$tag = '<'.$tag.$attributes.'>';
    965. 

  965. 			//If already queuing a close tag, then put this tag on, too
    966. 

  966. 			if ($tagqueue) {
    967. 

  967. 				$tagqueue .= $tag;
    968. 

  968. 				$tag = '';
    969. 

  969. 			}
    970. 

  970. 		}
    971. 

  971. 		$newtext .= substr($text,0,$i) . $tag;
    972. 

  972. 		$text = substr($text,$i+$l);
    973. 

  973. 	}
    974. 

  974. 

  975. 	// Clear Tag Queue
    976. 

  976. 	$newtext .= $tagqueue;
    977. 

  977. 

  978. 	// Add Remaining text
    979. 

  979. 	$newtext .= $text;
    980. 

  980. 

  981. 	// Empty Stack
    982. 

  982. 	while($x = array_pop($tagstack)) {
    983. 

  983. 		$newtext .= '</' . $x . '>'; // Add remaining tags to close
    984. 

  984. 	}
    985. 

  985. 

  986. 	// WP fix for the bug with HTML comments
    987. 

  987. 	$newtext = str_replace("< !--","<!--",$newtext);
    988. 

  988. 	$newtext = str_replace("<    !--","< !--",$newtext);
    989. 

  989. 

  990. 	return $newtext;
    991. 

  991. }
    992. 

  992. 

  993. /**
    994. 

  994.  * Acts on text which is about to be edited.
    995. 

  995.  *
    996. 

  996.  * Unless $richedit is set, it is simply a holder for the 'format_to_edit'
    997. 

  997.  * filter. If $richedit is set true htmlspecialchars() will be run on the
    998. 

  998.  * content, converting special characters to HTMl entities.
    999. 

  999.  *
    1000. 

  1000.  * @since 0.71
    1001. 

  1001.  *
    1002. 

  1002.  * @param string $content The text about to be edited.
    1003. 

  1003.  * @param bool $richedit Whether or not the $content should pass through htmlspecialchars(). Default false.
    1004. 

  1004.  * @return string The text after the filter (and possibly htmlspecialchars()) has been run.
    1005. 

  1005.  */
    1006. 

  1006. function format_to_edit($content, $richedit = false) {
    1007. 

  1007. 	$content = apply_filters('format_to_edit', $content);
    1008. 

  1008. 	if (! $richedit )
    1009. 

  1009. 		$content = htmlspecialchars($content);
    1010. 

  1010. 	return $content;
    1011. 

  1011. }
    1012. 

  1012. 

  1013. /**
    1014. 

  1014.  * Holder for the 'format_to_post' filter.
    1015. 

  1015.  *
    1016. 

  1016.  * @since 0.71
    1017. 

  1017.  *
    1018. 

  1018.  * @param string $content The text to pass through the filter.
    1019. 

  1019.  * @return string Text returned from the 'format_to_post' filter.
    1020. 

  1020.  */
    1021. 

  1021. function format_to_post($content) {
    1022. 

  1022. 	$content = apply_filters('format_to_post', $content);
    1023. 

  1023. 	return $content;
    1024. 

  1024. }
    1025. 

  1025. 

  1026. /**
    1027. 

  1027.  * Add leading zeros when necessary.
    1028. 

  1028.  *
    1029. 

  1029.  * If you set the threshold to '4' and the number is '10', then you will get
    1030. 

  1030.  * back '0010'. If you set the number to '4' and the number is '5000', then you
    1031. 

  1031.  * will get back '5000'.
    1032. 

  1032.  *
    1033. 

  1033.  * Uses sprintf to append the amount of zeros based on the $threshold parameter
    1034. 

  1034.  * and the size of the number. If the number is large enough, then no zeros will
    1035. 

  1035.  * be appended.
    1036. 

  1036.  *
    1037. 

  1037.  * @since 0.71
    1038. 

  1038.  *
    1039. 

  1039.  * @param mixed $number Number to append zeros to if not greater than threshold.
    1040. 

  1040.  * @param int $threshold Digit places number needs to be to not have zeros added.
    1041. 

  1041.  * @return string Adds leading zeros to number if needed.
    1042. 

  1042.  */
    1043. 

  1043. function zeroise($number, $threshold) {
    1044. 

  1044. 	return sprintf('%0'.$threshold.'s', $number);
    1045. 

  1045. }
    1046. 

  1046. 

  1047. /**
    1048. 

  1048.  * Adds backslashes before letters and before a number at the start of a string.
    1049. 

  1049.  *
    1050. 

  1050.  * @since 0.71
    1051. 

  1051.  *
    1052. 

  1052.  * @param string $string Value to which backslashes will be added.
    1053. 

  1053.  * @return string String with backslashes inserted.
    1054. 

  1054.  */
    1055. 

  1055. function backslashit($string) {
    1056. 

  1056. 	$string = preg_replace('/^([0-9])/', '\\\\\\\\\1', $string);
    1057. 

  1057. 	$string = preg_replace('/([a-z])/i', '\\\\\1', $string);
    1058. 

  1058. 	return $string;
    1059. 

  1059. }
    1060. 

  1060. 

  1061. /**
    1062. 

  1062.  * Appends a trailing slash.
    1063. 

  1063.  *
    1064. 

  1064.  * Will remove trailing slash if it exists already before adding a trailing
    1065. 

  1065.  * slash. This prevents double slashing a string or path.
    1066. 

  1066.  *
    1067. 

  1067.  * The primary use of this is for paths and thus should be used for paths. It is
    1068. 

  1068.  * not restricted to paths and offers no specific path support.
    1069. 

  1069.  *
    1070. 

  1070.  * @since 1.2.0
    1071. 

  1071.  * @uses untrailingslashit() Unslashes string if it was slashed already.
    1072. 

  1072.  *
    1073. 

  1073.  * @param string $string What to add the trailing slash to.
    1074. 

  1074.  * @return string String with trailing slash added.
    1075. 

  1075.  */
    1076. 

  1076. function trailingslashit($string) {
    1077. 

  1077. 	return untrailingslashit($string) . '/';
    1078. 

  1078. }
    1079. 

  1079. 

  1080. /**
    1081. 

  1081.  * Removes trailing slash if it exists.
    1082. 

  1082.  *
    1083. 

  1083.  * The primary use of this is for paths and thus should be used for paths. It is
    1084. 

  1084.  * not restricted to paths and offers no specific path support.
    1085. 

  1085.  *
    1086. 

  1086.  * @since 2.2.0
    1087. 

  1087.  *
    1088. 

  1088.  * @param string $string What to remove the trailing slash from.
    1089. 

  1089.  * @return string String without the trailing slash.
    1090. 

  1090.  */
    1091. 

  1091. function untrailingslashit($string) {
    1092. 

  1092. 	return rtrim($string, '/');
    1093. 

  1093. }
    1094. 

  1094. 

  1095. /**
    1096. 

  1096.  * Adds slashes to escape strings.
    1097. 

  1097.  *
    1098. 

  1098.  * Slashes will first be removed if magic_quotes_gpc is set, see {@link
    1099. 

  1099.  * http://www.php.net/magic_quotes} for more details.
    1100. 

  1100.  *
    1101. 

  1101.  * @since 0.71
    1102. 

  1102.  *
    1103. 

  1103.  * @param string $gpc The string returned from HTTP request data.
    1104. 

  1104.  * @return string Returns a string escaped with slashes.
    1105. 

  1105.  */
    1106. 

  1106. function addslashes_gpc($gpc) {
    1107. 

  1107. 	global $wpdb;
    1108. 

  1108. 

  1109. 	if (get_magic_quotes_gpc()) {
    1110. 

  1110. 		$gpc = stripslashes($gpc);
    1111. 

  1111. 	}
    1112. 

  1112. 

  1113. 	return $wpdb->escape($gpc);
    1114. 

  1114. }
    1115. 

  1115. 

  1116. /**
    1117. 

  1117.  * Navigates through an array and removes slashes from the values.
    1118. 

  1118.  *
    1119. 

  1119.  * If an array is passed, the array_map() function causes a callback to pass the
    1120. 

  1120.  * value back to the function. The slashes from this value will removed.
    1121. 

  1121.  *
    1122. 

  1122.  * @since 2.0.0
    1123. 

  1123.  *
    1124. 

  1124.  * @param array|string $value The array or string to be striped.
    1125. 

  1125.  * @return array|string Stripped array (or string in the callback).
    1126. 

  1126.  */
    1127. 

  1127. function stripslashes_deep($value) {
    1128. 

  1128. 	$value = is_array($value) ? array_map('stripslashes_deep', $value) : stripslashes($value);
    1129. 

  1129. 	return $value;
    1130. 

  1130. }
    1131. 

  1131. 

  1132. /**
    1133. 

  1133.  * Navigates through an array and encodes the values to be used in a URL.
    1134. 

  1134.  *
    1135. 

  1135.  * Uses a callback to pass the value of the array back to the function as a
    1136. 

  1136.  * string.
    1137. 

  1137.  *
    1138. 

  1138.  * @since 2.2.0
    1139. 

  1139.  *
    1140. 

  1140.  * @param array|string $value The array or string to be encoded.
    1141. 

  1141.  * @return array|string $value The encoded array (or string from the callback).
    1142. 

  1142.  */
    1143. 

  1143. function urlencode_deep($value) {
    1144. 

  1144. 	$value = is_array($value) ? array_map('urlencode_deep', $value) : urlencode($value);
    1145. 

  1145. 	return $value;
    1146. 

  1146. }
    1147. 

  1147. 

  1148. /**
    1149. 

  1149.  * Converts email addresses characters to HTML entities to block spam bots.
    1150. 

  1150.  *
    1151. 

  1151.  * @since 0.71
    1152. 

  1152.  *
    1153. 

  1153.  * @param string $emailaddy Email address.
    1154. 

  1154.  * @param int $mailto Optional. Range from 0 to 1. Used for encoding.
    1155. 

  1155.  * @return string Converted email address.
    1156. 

  1156.  */
    1157. 

  1157. function antispambot($emailaddy, $mailto=0) {
    1158. 

  1158. 	$emailNOSPAMaddy = '';
    1159. 

  1159. 	srand ((float) microtime() * 1000000);
    1160. 

  1160. 	for ($i = 0; $i < strlen($emailaddy); $i = $i + 1) {
    1161. 

  1161. 		$j = floor(rand(0, 1+$mailto));
    1162. 

  1162. 		if ($j==0) {
    1163. 

  1163. 			$emailNOSPAMaddy .= '&#'.ord(substr($emailaddy,$i,1)).';';
    1164. 

  1164. 		} elseif ($j==1) {
    1165. 

  1165. 			$emailNOSPAMaddy .= substr($emailaddy,$i,1);
    1166. 

  1166. 		} elseif ($j==2) {
    1167. 

  1167. 			$emailNOSPAMaddy .= '%'.zeroise(dechex(ord(substr($emailaddy, $i, 1))), 2);
    1168. 

  1168. 		}
    1169. 

  1169. 	}
    1170. 

  1170. 	$emailNOSPAMaddy = str_replace('@','&#64;',$emailNOSPAMaddy);
    1171. 

  1171. 	return $emailNOSPAMaddy;
    1172. 

  1172. }
    1173. 

  1173. 

  1174. /**
    1175. 

  1175.  * Callback to convert URI match to HTML A element.
    1176. 

  1176.  *
    1177. 

  1177.  * This function was backported from 2.5.0 to 2.3.2. Regex callback for {@link
    1178. 

  1178.  * make_clickable()}.
    1179. 

  1179.  *
    1180. 

  1180.  * @since 2.3.2
    1181. 

  1181.  * @access private
    1182. 

  1182.  *
    1183. 

  1183.  * @param array $matches Single Regex Match.
    1184. 

  1184.  * @return string HTML A element with URI address.
    1185. 

  1185.  */
    1186. 

  1186. function _make_url_clickable_cb($matches) {
    1187. 

  1187. 	$url = $matches[2];
    1188. 

  1188. 	$url = esc_url($url);
    1189. 

  1189. 	if ( empty($url) )
    1190. 

  1190. 		return $matches[0];
    1191. 

  1191. 	return $matches[1] . "<a href=\"$url\" rel=\"nofollow\">$url</a>";
    1192. 

  1192. }
    1193. 

  1193. 

  1194. /**
    1195. 

  1195.  * Callback to convert URL match to HTML A element.
    1196. 

  1196.  *
    1197. 

  1197.  * This function was backported from 2.5.0 to 2.3.2. Regex callback for {@link
    1198. 

  1198.  * make_clickable()}.
    1199. 

  1199.  *
    1200. 

  1200.  * @since 2.3.2
    1201. 

  1201.  * @access private
    1202. 

  1202.  *
    1203. 

  1203.  * @param array $matches Single Regex Match.
    1204. 

  1204.  * @return string HTML A element with URL address.
    1205. 

  1205.  */
    1206. 

  1206. function _make_web_ftp_clickable_cb($matches) {
    1207. 

  1207. 	$ret = '';
    1208. 

  1208. 	$dest = $matches[2];
    1209. 

  1209. 	$dest = 'http://' . $dest;
    1210. 

  1210. 	$dest = esc_url($dest);
    1211. 

  1211. 	if ( empty($dest) )
    1212. 

  1212. 		return $matches[0];
    1213. 

  1213. 	// removed trailing [,;:] from URL
    1214. 

  1214. 	if ( in_array(substr($dest, -1), array('.', ',', ';', ':')) === true ) {
    1215. 

  1215. 		$ret = substr($dest, -1);
    1216. 

  1216. 		$dest = substr($dest, 0, strlen($dest)-1);
    1217. 

  1217. 	}
    1218. 

  1218. 	return $matches[1] . "<a href=\"$dest\" rel=\"nofollow\">$dest</a>" . $ret;
    1219. 

  1219. }
    1220. 

  1220. 

  1221. /**
    1222. 

  1222.  * Callback to convert email address match to HTML A element.
    1223. 

  1223.  *
    1224. 

  1224.  * This function was backported from 2.5.0 to 2.3.2. Regex callback for {@link
    1225. 

  1225.  * make_clickable()}.
    1226. 

  1226.  *
    1227. 

  1227.  * @since 2.3.2
    1228. 

  1228.  * @access private
    1229. 

  1229.  *
    1230. 

  1230.  * @param array $matches Single Regex Match.
    1231. 

  1231.  * @return string HTML A element with email address.
    1232. 

  1232.  */
    1233. 

  1233. function _make_email_clickable_cb($matches) {
    1234. 

  1234. 	$email = $matches[2] . '@' . $matches[3];
    1235. 

  1235. 	return $matches[1] . "<a href=\"mailto:$email\">$email</a>";
    1236. 

  1236. }
    1237. 

  1237. 

  1238. /**
    1239. 

  1239.  * Convert plaintext URI to HTML links.
    1240. 

  1240.  *
    1241. 

  1241.  * Converts URI, www and ftp, and email addresses. Finishes by fixing links
    1242. 

  1242.  * within links.
    1243. 

  1243.  *
    1244. 

  1244.  * @since 0.71
    1245. 

  1245.  *
    1246. 

  1246.  * @param string $ret Content to convert URIs.
    1247. 

  1247.  * @return string Content with converted URIs.
    1248. 

  1248.  */
    1249. 

  1249. function make_clickable($ret) {
    1250. 

  1250. 	$ret = ' ' . $ret;
    1251. 

  1251. 	// in testing, using arrays here was found to be faster
    1252. 

  1252. 	$ret = preg_replace_callback('#(?<=[\s>])(\()?([\w]+?://(?:[\w\\x80-\\xff\#$%&~/\-=?@\[\](+]|[.,;:](?![\s<])|(?(1)\)(?![\s<])|\)))+)#is', '_make_url_clickable_cb', $ret);
    1253. 

  1253. 	$ret = preg_replace_callback('#([\s>])((www|ftp)\.[\w\\x80-\\xff\#$%&~/.\-;:=,?@\[\]+]+)#is', '_make_web_ftp_clickable_cb', $ret);
    1254. 

  1254. 	$ret = preg_replace_callback('#([\s>])([.0-9a-z_+-]+)@(([0-9a-z-]+\.)+[0-9a-z]{2,})#i', '_make_email_clickable_cb', $ret);
    1255. 

  1255. 	// this one is not in an array because we need it to run last, for cleanup of accidental links within links
    1256. 

  1256. 	$ret = preg_replace("#(<a( [^>]+?>|>))<a [^>]+?>([^>]+?)</a></a>#i", "$1$3</a>", $ret);
    1257. 

  1257. 	$ret = trim($ret);
    1258. 

  1258. 	return $ret;
    1259. 

  1259. }
    1260. 

  1260. 

  1261. /**
    1262. 

  1262.  * Adds rel nofollow string to all HTML A elements in content.
    1263. 

  1263.  *
    1264. 

  1264.  * @since 1.5.0
    1265. 

  1265.  *
    1266. 

  1266.  * @param string $text Content that may contain HTML A elements.
    1267. 

  1267.  * @return string Converted content.
    1268. 

  1268.  */
    1269. 

  1269. function wp_rel_nofollow( $text ) {
    1270. 

  1270. 	global $wpdb;
    1271. 

  1271. 	// This is a pre save filter, so text is already escaped.
    1272. 

  1272. 	$text = stripslashes($text);
    1273. 

  1273. 	$text = preg_replace_callback('|<a (.+?)>|i', 'wp_rel_nofollow_callback', $text);
    1274. 

  1274. 	$text = $wpdb->escape($text);
    1275. 

  1275. 	return $text;
    1276. 

  1276. }
    1277. 

  1277. 

  1278. /**
    1279. 

  1279.  * Callback to used to add rel=nofollow string to HTML A element.
    1280. 

  1280.  *
    1281. 

  1281.  * Will remove already existing rel="nofollow" and rel='nofollow' from the
    1282. 

  1282.  * string to prevent from invalidating (X)HTML.
    1283. 

  1283.  *
    1284. 

  1284.  * @since 2.3.0
    1285. 

  1285.  *
    1286. 

  1286.  * @param array $matches Single Match
    1287. 

  1287.  * @return string HTML A Element with rel nofollow.
    1288. 

  1288.  */
    1289. 

  1289. function wp_rel_nofollow_callback( $matches ) {
    1290. 

  1290. 	$text = $matches[1];
    1291. 

  1291. 	$text = str_replace(array(' rel="nofollow"', " rel='nofollow'"), '', $text);
    1292. 

  1292. 	return "<a $text rel=\"nofollow\">";
    1293. 

  1293. }
    1294. 

  1294. 

  1295. 

  1296. /**
    1297. 

  1297.  * Convert one smiley code to the icon graphic file equivalent.
    1298. 

  1298.  *
    1299. 

  1299.  * Looks up one smiley code in the $wpsmiliestrans global array and returns an
    1300. 

  1300.  * <img> string for that smiley.
    1301. 

  1301.  *
    1302. 

  1302.  * @global array $wpsmiliestrans
    1303. 

  1303.  * @since 2.8.0
    1304. 

  1304.  *
    1305. 

  1305.  * @param string $smiley Smiley code to convert to image.
    1306. 

  1306.  * @return string Image string for smiley.
    1307. 

  1307.  */
    1308. 

  1308. function translate_smiley($smiley) {
    1309. 

  1309. 	global $wpsmiliestrans;
    1310. 

  1310. 

  1311. 	if (count($smiley) == 0) {
    1312. 

  1312. 		return '';
    1313. 

  1313. 	}
    1314. 

  1314. 

  1315. 	$siteurl = get_option( 'siteurl' );
    1316. 

  1316. 

  1317. 	$smiley = trim(reset($smiley));
    1318. 

  1318. 	$img = $wpsmiliestrans[$smiley];
    1319. 

  1319. 	$smiley_masked = esc_attr($smiley);
    1320. 

  1320. 

  1321. 	return " <img src='$siteurl/wp-includes/images/smilies/$img' alt='$smiley_masked' class='wp-smiley' /> ";
    1322. 

  1322. }
    1323. 

  1323. 

  1324. 

  1325. /**
    1326. 

  1326.  * Convert text equivalent of smilies to images.
    1327. 

  1327.  *
    1328. 

  1328.  * Will only convert smilies if the option 'use_smilies' is true and the global
    1329. 

  1329.  * used in the function isn't empty.
    1330. 

  1330.  *
    1331. 

  1331.  * @since 0.71
    1332. 

  1332.  * @uses $wp_smiliessearch
    1333. 

  1333.  *
    1334. 

  1334.  * @param string $text Content to convert smilies from text.
    1335. 

  1335.  * @return string Converted content with text smilies replaced with images.
    1336. 

  1336.  */
    1337. 

  1337. function convert_smilies($text) {
    1338. 

  1338. 	global $wp_smiliessearch;
    1339. 

  1339. 	$output = '';
    1340. 

  1340. 	if ( get_option('use_smilies') && !empty($wp_smiliessearch) ) {
    1341. 

  1341. 		// HTML loop taken from texturize function, could possible be consolidated
    1342. 

  1342. 		$textarr = preg_split("/(<.*>)/U", $text, -1, PREG_SPLIT_DELIM_CAPTURE); // capture the tags as well as in between
    1343. 

  1343. 		$stop = count($textarr);// loop stuff
    1344. 

  1344. 		for ($i = 0; $i < $stop; $i++) {
    1345. 

  1345. 			$content = $textarr[$i];
    1346. 

  1346. 			if ((strlen($content) > 0) && ('<' != $content{0})) { // If it's not a tag
    1347. 

  1347. 				$content = preg_replace_callback($wp_smiliessearch, 'translate_smiley', $content);
    1348. 

  1348. 			}
    1349. 

  1349. 			$output .= $content;
    1350. 

  1350. 		}
    1351. 

  1351. 	} else {
    1352. 

  1352. 		// return default text.
    1353. 

  1353. 		$output = $text;
    1354. 

  1354. 	}
    1355. 

  1355. 	return $output;
    1356. 

  1356. }
    1357. 

  1357. 

  1358. /**
    1359. 

  1359.  * Verifies that an email is valid.
    1360. 

  1360.  *
    1361. 

  1361.  * Does not grok i18n domains. Not RFC compliant.
    1362. 

  1362.  *
    1363. 

  1363.  * @since 0.71
    1364. 

  1364.  *
    1365. 

  1365.  * @param string $email Email address to verify.
    1366. 

  1366.  * @param boolean $check_dns Whether to check the DNS for the domain using checkdnsrr().
    1367. 

  1367.  * @return string|bool Either false or the valid email address.
    1368. 

  1368.  */
    1369. 

  1369. function is_email( $email, $check_dns = false ) {
    1370. 

  1370. 	// Test for the minimum length the email can be
    1371. 

  1371. 	if ( strlen( $email ) < 3 ) {
    1372. 

  1372. 		return apply_filters( 'is_email', false, $email, 'email_too_short' );
    1373. 

  1373. 	}
    1374. 

  1374. 

  1375. 	// Test for an @ character after the first position
    1376. 

  1376. 	if ( strpos( $email, '@', 1 ) === false ) {
    1377. 

  1377. 		return apply_filters( 'is_email', false, $email, 'email_no_at' );
    1378. 

  1378. 	}
    1379. 

  1379. 

  1380. 	// Split out the local and domain parts
    1381. 

  1381. 	list( $local, $domain ) = explode( '@', $email, 2 );
    1382. 

  1382. 

  1383. 	// LOCAL PART
    1384. 

  1384. 	// Test for invalid characters
    1385. 

  1385. 	if ( !preg_match( '/^[a-zA-Z0-9!#$%&\'*+\/=?^_`{|}~\.-]+$/', $local ) ) {
    1386. 

  1386. 		return apply_filters( 'is_email', false, $email, 'local_invalid_chars' );
    1387. 

  1387. 	}
    1388. 

  1388. 

  1389. 	// DOMAIN PART
    1390. 

  1390. 	// Test for sequences of periods
    1391. 

  1391. 	if ( preg_match( '/\.{2,}/', $domain ) ) {
    1392. 

  1392. 		return apply_filters( 'is_email', false, $email, 'domain_period_sequence' );
    1393. 

  1393. 	}
    1394. 

  1394. 

  1395. 	// Test for leading and trailing periods and whitespace
    1396. 

  1396. 	if ( trim( $domain, " \t\n\r\0\x0B." ) !== $domain ) {
    1397. 

  1397. 		return apply_filters( 'is_email', false, $email, 'domain_period_limits' );
    1398. 

  1398. 	}
    1399. 

  1399. 

  1400. 	// Split the domain into subs
    1401. 

  1401. 	$subs = explode( '.', $domain );
    1402. 

  1402. 

  1403. 	// Assume the domain will have at least two subs
    1404. 

  1404. 	if ( 2 > count( $subs ) ) {
    1405. 

  1405. 		return apply_filters( 'is_email', false, $email, 'domain_no_periods' );
    1406. 

  1406. 	}
    1407. 

  1407. 

  1408. 	// Loop through each sub
    1409. 

  1409. 	foreach ( $subs as $sub ) {
    1410. 

  1410. 		// Test for leading and trailing hyphens and whitespace
    1411. 

  1411. 		if ( trim( $sub, " \t\n\r\0\x0B-" ) !== $sub ) {
    1412. 

  1412. 			return apply_filters( 'is_email', false, $email, 'sub_hyphen_limits' );
    1413. 

  1413. 		}
    1414. 

  1414. 

  1415. 		// Test for invalid characters
    1416. 

  1416. 		if ( !preg_match('/^[a-z0-9-]+$/i', $sub ) ) {
    1417. 

  1417. 			return apply_filters( 'is_email', false, $email, 'sub_invalid_chars' );
    1418. 

  1418. 		}
    1419. 

  1419. 	}
    1420. 

  1420. 

  1421. 	// DNS
    1422. 

  1422. 	// Check the domain has a valid MX and A resource record
    1423. 

  1423. 	if ( $check_dns && function_exists( 'checkdnsrr' ) && !( checkdnsrr( $domain . '.', 'MX' ) || checkdnsrr( $domain . '.', 'A' ) ) ) {
    1424. 

  1424. 		return apply_filters( 'is_email', false, $email, 'dns_no_rr' );
    1425. 

  1425. 	}
    1426. 

  1426. 

  1427. 	// Congratulations your email made it!
    1428. 

  1428. 	return apply_filters( 'is_email', $email, $email, null );
    1429. 

  1429. }
    1430. 

  1430. 

  1431. /**
    1432. 

  1432.  * Convert to ASCII from email subjects.
    1433. 

  1433.  *
    1434. 

  1434.  * @since 1.2.0
    1435. 

  1435.  * @usedby wp_mail() handles charsets in email subjects
    1436. 

  1436.  *
    1437. 

  1437.  * @param string $string Subject line
    1438. 

  1438.  * @return string Converted string to ASCII
    1439. 

  1439.  */
    1440. 

  1440. function wp_iso_descrambler($string) {
    1441. 

  1441. 	/* this may only work with iso-8859-1, I'm afraid */
    1442. 

  1442. 	if (!preg_match('#\=\?(.+)\?Q\?(.+)\?\=#i', $string, $matches)) {
    1443. 

  1443. 		return $string;
    1444. 

  1444. 	} else {
    1445. 

  1445. 		$subject = str_replace('_', ' ', $matches[2]);
    1446. 

  1446. 		$subject = preg_replace_callback('#\=([0-9a-f]{2})#i', create_function('$match', 'return chr(hexdec(strtolower($match[1])));'), $subject);
    1447. 

  1447. 		return $subject;
    1448. 

  1448. 	}
    1449. 

  1449. }
    1450. 

  1450. 

  1451. /**
    1452. 

  1452.  * Returns a date in the GMT equivalent.
    1453. 

  1453.  *
    1454. 

  1454.  * Requires and returns a date in the Y-m-d H:i:s format. Simply subtracts the
    1455. 

  1455.  * value of the 'gmt_offset' option. Return format can be overridden using the
    1456. 

  1456.  * $format parameter
    1457. 

  1457.  *
    1458. 

  1458.  * @since 1.2.0
    1459. 

  1459.  *
    1460. 

  1460.  * @uses get_option() to retrieve the the value of 'gmt_offset'.
    1461. 

  1461.  * @param string $string The date to be converted.
    1462. 

  1462.  * @param string $format The format string for the returned date (default is Y-m-d H:i:s)
    1463. 

  1463.  * @return string GMT version of the date provided.
    1464. 

  1464.  */
    1465. 

  1465. function get_gmt_from_date($string, $format = 'Y-m-d H:i:s') {
    1466. 

  1466. 	preg_match('#([0-9]{1,4})-([0-9]{1,2})-([0-9]{1,2}) ([0-9]{1,2}):([0-9]{1,2}):([0-9]{1,2})#', $string, $matches);
    1467. 

  1467. 	$string_time = gmmktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
    1468. 

  1468. 	$string_gmt = gmdate($format, $string_time - get_option('gmt_offset') * 3600);
    1469. 

  1469. 	return $string_gmt;
    1470. 

  1470. }
    1471. 

  1471. 

  1472. /**
    1473. 

  1473.  * Converts a GMT date into the correct format for the blog.
    1474. 

  1474.  *
    1475. 

  1475.  * Requires and returns in the Y-m-d H:i:s format. Simply adds the value of
    1476. 

  1476.  * gmt_offset.Return format can be overridden using the $format parameter
    1477. 

  1477.  *
    1478. 

  1478.  * @since 1.2.0
    1479. 

  1479.  *
    1480. 

  1480.  * @param string $string The date to be converted.
    1481. 

  1481.  * @param string $format The format string for the returned date (default is Y-m-d H:i:s)
    1482. 

  1482.  * @return string Formatted date relative to the GMT offset.
    1483. 

  1483.  */
    1484. 

  1484. function get_date_from_gmt($string, $format = 'Y-m-d H:i:s') {
    1485. 

  1485. 	preg_match('#([0-9]{1,4})-([0-9]{1,2})-([0-9]{1,2}) ([0-9]{1,2}):([0-9]{1,2}):([0-9]{1,2})#', $string, $matches);
    1486. 

  1486. 	$string_time = gmmktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
    1487. 

  1487. 	$string_localtime = gmdate($format, $string_time + get_option('gmt_offset')*3600);
    1488. 

  1488. 	return $string_localtime;
    1489. 

  1489. }
    1490. 

  1490. 

  1491. /**
    1492. 

  1492.  * Computes an offset in seconds from an iso8601 timezone.
    1493. 

  1493.  *
    1494. 

  1494.  * @since 1.5.0
    1495. 

  1495.  *
    1496. 

  1496.  * @param string $timezone Either 'Z' for 0 offset or 'Âąhhmm'.
    1497. 

  1497.  * @return int|float The offset in seconds.
    1498. 

  1498.  */
    1499. 

  1499. function iso8601_timezone_to_offset($timezone) {
    1500. 

  1500. 	// $timezone is either 'Z' or '[+|-]hhmm'
    1501. 

  1501. 	if ($timezone == 'Z') {
    1502. 

  1502. 		$offset = 0;
    1503. 

  1503. 	} else {
    1504. 

  1504. 		$sign    = (substr($timezone, 0, 1) == '+') ? 1 : -1;
    1505. 

  1505. 		$hours   = intval(substr($timezone, 1, 2));
    1506. 

  1506. 		$minutes = intval(substr($timezone, 3, 4)) / 60;
    1507. 

  1507. 		$offset  = $sign * 3600 * ($hours + $minutes);
    1508. 

  1508. 	}
    1509. 

  1509. 	return $offset;
    1510. 

  1510. }
    1511. 

  1511. 

  1512. /**
    1513. 

  1513.  * Converts an iso8601 date to MySQL DateTime format used by post_date[_gmt].
    1514. 

  1514.  *
    1515. 

  1515.  * @since 1.5.0
    1516. 

  1516.  *
    1517. 

  1517.  * @param string $date_string Date and time in ISO 8601 format {@link http://en.wikipedia.org/wiki/ISO_8601}.
    1518. 

  1518.  * @param string $timezone Optional. If set to GMT returns the time minus gmt_offset. Default is 'user'.
    1519. 

  1519.  * @return string The date and time in MySQL DateTime format - Y-m-d H:i:s.
    1520. 

  1520.  */
    1521. 

  1521. function iso8601_to_datetime($date_string, $timezone = 'user') {
    1522. 

  1522. 	$timezone = strtolower($timezone);
    1523. 

  1523. 

  1524. 	if ($timezone == 'gmt') {
    1525. 

  1525. 

  1526. 		preg_match('#([0-9]{4})([0-9]{2})([0-9]{2})T([0-9]{2}):([0-9]{2}):([0-9]{2})(Z|[\+|\-][0-9]{2,4}){0,1}#', $date_string, $date_bits);
    1527. 

  1527. 

  1528. 		if (!empty($date_bits[7])) { // we have a timezone, so let's compute an offset
    1529. 

  1529. 			$offset = iso8601_timezone_to_offset($date_bits[7]);
    1530. 

  1530. 		} else { // we don't have a timezone, so we assume user local timezone (not server's!)
    1531. 

  1531. 			$offset = 3600 * get_option('gmt_offset');
    1532. 

  1532. 		}
    1533. 

  1533. 

  1534. 		$timestamp = gmmktime($date_bits[4], $date_bits[5], $date_bits[6], $date_bits[2], $date_bits[3], $date_bits[1]);
    1535. 

  1535. 		$timestamp -= $offset;
    1536. 

  1536. 

  1537. 		return gmdate('Y-m-d H:i:s', $timestamp);
    1538. 

  1538. 

  1539. 	} else if ($timezone == 'user') {
    1540. 

  1540. 		return preg_replace('#([0-9]{4})([0-9]{2})([0-9]{2})T([0-9]{2}):([0-9]{2}):([0-9]{2})(Z|[\+|\-][0-9]{2,4}){0,1}#', '$1-$2-$3 $4:$5:$6', $date_string);
    1541. 

  1541. 	}
    1542. 

  1542. }
    1543. 

  1543. 

  1544. /**
    1545. 

  1545.  * Adds a element attributes to open links in new windows.
    1546. 

  1546.  *
    1547. 

  1547.  * Comment text in popup windows should be filtered through this. Right now it's
    1548. 

  1548.  * a moderately dumb function, ideally it would detect whether a target or rel
    1549. 

  1549.  * attribute was already there and adjust its actions accordingly.
    1550. 

  1550.  *
    1551. 

  1551.  * @since 0.71
    1552. 

  1552.  *
    1553. 

  1553.  * @param string $text Content to replace links to open in a new window.
    1554. 

  1554.  * @return string Content that has filtered links.
    1555. 

  1555.  */
    1556. 

  1556. function popuplinks($text) {
    1557. 

  1557. 	$text = preg_replace('/<a (.+?)>/i', "<a $1 target='_blank' rel='external'>", $text);
    1558. 

  1558. 	return $text;
    1559. 

  1559. }
    1560. 

  1560. 

  1561. /**
    1562. 

  1562.  * Strips out all characters that are not allowable in an email.
    1563. 

  1563.  *
    1564. 

  1564.  * @since 1.5.0
    1565. 

  1565.  *
    1566. 

  1566.  * @param string $email Email address to filter.
    1567. 

  1567.  * @return string Filtered email address.
    1568. 

  1568.  */
    1569. 

  1569. function sanitize_email( $email ) {
    1570. 

  1570. 	// Test for the minimum length the email can be
    1571. 

  1571. 	if ( strlen( $email ) < 3 ) {
    1572. 

  1572. 		return apply_filters( 'sanitize_email', '', $email, 'email_too_short' );
    1573. 

  1573. 	}
    1574. 

  1574. 

  1575. 	// Test for an @ character after the first position
    1576. 

  1576. 	if ( strpos( $email, '@', 1 ) === false ) {
    1577. 

  1577. 		return apply_filters( 'sanitize_email', '', $email, 'email_no_at' );
    1578. 

  1578. 	}
    1579. 

  1579. 

  1580. 	// Split out the local and domain parts
    1581. 

  1581. 	list( $local, $domain ) = explode( '@', $email, 2 );
    1582. 

  1582. 

  1583. 	// LOCAL PART
    1584. 

  1584. 	// Test for invalid characters
    1585. 

  1585. 	$local = preg_replace( '/[^a-zA-Z0-9!#$%&\'*+\/=?^_`{|}~\.-]/', '', $local );
    1586. 

  1586. 	if ( '' === $local ) {
    1587. 

  1587. 		return apply_filters( 'sanitize_email', '', $email, 'local_invalid_chars' );
    1588. 

  1588. 	}
    1589. 

  1589. 

  1590. 	// DOMAIN PART
    1591. 

  1591. 	// Test for sequences of periods
    1592. 

  1592. 	$domain = preg_replace( '/\.{2,}/', '', $domain );
    1593. 

  1593. 	if ( '' === $domain ) {
    1594. 

  1594. 		return apply_filters( 'sanitize_email', '', $email, 'domain_period_sequence' );
    1595. 

  1595. 	}
    1596. 

  1596. 

  1597. 	// Test for leading and trailing periods and whitespace
    1598. 

  1598. 	$domain = trim( $domain, " \t\n\r\0\x0B." );
    1599. 

  1599. 	if ( '' === $domain ) {
    1600. 

  1600. 		return apply_filters( 'sanitize_email', '', $email, 'domain_period_limits' );
    1601. 

  1601. 	}
    1602. 

  1602. 

  1603. 	// Split the domain into subs
    1604. 

  1604. 	$subs = explode( '.', $domain );
    1605. 

  1605. 

  1606. 	// Assume the domain will have at least two subs
    1607. 

  1607. 	if ( 2 > count( $subs ) ) {
    1608. 

  1608. 		return apply_filters( 'sanitize_email', '', $email, 'domain_no_periods' );
    1609. 

  1609. 	}
    1610. 

  1610. 

  1611. 	// Create an array that will contain valid subs
    1612. 

  1612. 	$new_subs = array();
    1613. 

  1613. 

  1614. 	// Loop through each sub
    1615. 

  1615. 	foreach ( $subs as $sub ) {
    1616. 

  1616. 		// Test for leading and trailing hyphens
    1617. 

  1617. 		$sub = trim( $sub, " \t\n\r\0\x0B-" );
    1618. 

  1618. 

  1619. 		// Test for invalid characters
    1620. 

  1620. 		$sub = preg_replace( '/^[^a-z0-9-]+$/i', '', $sub );
    1621. 

  1621. 

  1622. 		// If there's anything left, add it to the valid subs
    1623. 

  1623. 		if ( '' !== $sub ) {
    1624. 

  1624. 			$new_subs[] = $sub;
    1625. 

  1625. 		}
    1626. 

  1626. 	}
    1627. 

  1627. 

  1628. 	// If there aren't 2 or more valid subs
    1629. 

  1629. 	if ( 2 > count( $new_subs ) ) {
    1630. 

  1630. 		return apply_filters( 'sanitize_email', '', $email, 'domain_no_valid_subs' );
    1631. 

  1631. 	}
    1632. 

  1632. 

  1633. 	// Join valid subs into the new domain
    1634. 

  1634. 	$domain = join( '.', $new_subs );
    1635. 

  1635. 

  1636. 	// Put the email back together
    1637. 

  1637. 	$email = $local . '@' . $domain;
    1638. 

  1638. 

  1639. 	// Congratulations your email made it!
    1640. 

  1640. 	return apply_filters( 'sanitize_email', $email, $email, null );
    1641. 

  1641. }
    1642. 

  1642. 

  1643. /**
    1644. 

  1644.  * Determines the difference between two timestamps.
    1645. 

  1645.  *
    1646. 

  1646.  * The difference is returned in a human readable format such as "1 hour",
    1647. 

  1647.  * "5 mins", "2 days".
    1648. 

  1648.  *
    1649. 

  1649.  * @since 1.5.0
    1650. 

  1650.  *
    1651. 

  1651.  * @param int $from Unix timestamp from which the difference begins.
    1652. 

  1652.  * @param int $to Optional. Unix timestamp to end the time difference. Default becomes time() if not set.
    1653. 

  1653.  * @return string Human readable time difference.
    1654. 

  1654.  */
    1655. 

  1655. function human_time_diff( $from, $to = '' ) {
    1656. 

  1656. 	if ( empty($to) )
    1657. 

  1657. 		$to = time();
    1658. 

  1658. 	$diff = (int) abs($to - $from);
    1659. 

  1659. 	if ($diff <= 3600) {
    1660. 

  1660. 		$mins = round($diff / 60);
    1661. 

  1661. 		if ($mins <= 1) {
    1662. 

  1662. 			$mins = 1;
    1663. 

  1663. 		}
    1664. 

  1664. 		$since = sprintf(_n('%s min', '%s mins', $mins), $mins);
    1665. 

  1665. 	} else if (($diff <= 86400) && ($diff > 3600)) {
    1666. 

  1666. 		$hours = round($diff / 3600);
    1667. 

  1667. 		if ($hours <= 1) {
    1668. 

  1668. 			$hours = 1;
    1669. 

  1669. 		}
    1670. 

  1670. 		$since = sprintf(_n('%s hour', '%s hours', $hours), $hours);
    1671. 

  1671. 	} elseif ($diff >= 86400) {
    1672. 

  1672. 		$days = round($diff / 86400);
    1673. 

  1673. 		if ($days <= 1) {
    1674. 

  1674. 			$days = 1;
    1675. 

  1675. 		}
    1676. 

  1676. 		$since = sprintf(_n('%s day', '%s days', $days), $days);
    1677. 

  1677. 	}
    1678. 

  1678. 	return $since;
    1679. 

  1679. }
    1680. 

  1680. 

  1681. /**
    1682. 

  1682.  * Generates an excerpt from the content, if needed.
    1683. 

  1683.  *
    1684. 

  1684.  * The excerpt word amount will be 55 words and if the amount is greater than
    1685. 

  1685.  * that, then the string '[...]' will be appended to the excerpt. If the string
    1686. 

  1686.  * is less than 55 words, then the content will be returned as is.
    1687. 

  1687.  *
    1688. 

  1688.  * @since 1.5.0
    1689. 

  1689.  *
    1690. 

  1690.  * @param string $text The exerpt. If set to empty an excerpt is generated.
    1691. 

  1691.  * @return string The excerpt.
    1692. 

  1692.  */
    1693. 

  1693. function wp_trim_excerpt($text) {
    1694. 

  1694. 	$raw_excerpt = $text;
    1695. 

  1695. 	if ( '' == $text ) {
    1696. 

  1696. 		$text = get_the_content('');
    1697. 

  1697. 

  1698. 		$text = strip_shortcodes( $text );
    1699. 

  1699. 

  1700. 		$text = apply_filters('the_content', $text);
    1701. 

  1701. 		$text = str_replace(']]>', ']]&gt;', $text);
    1702. 

  1702. 		$text = strip_tags($text);
    1703. 

  1703. 		$excerpt_length = apply_filters('excerpt_length', 55);
    1704. 

  1704. 		$words = explode(' ', $text, $excerpt_length + 1);
    1705. 

  1705. 		if (count($words) > $excerpt_length) {
    1706. 

  1706. 			array_pop($words);
    1707. 

  1707. 			array_push($words, '[...]');
    1708. 

  1708. 			$text = implode(' ', $words);
    1709. 

  1709. 		}
    1710. 

  1710. 	}
    1711. 

  1711. 	return apply_filters('wp_trim_excerpt', $text, $raw_excerpt);
    1712. 

  1712. }
    1713. 

  1713. 

  1714. /**
    1715. 

  1715.  * Converts named entities into numbered entities.
    1716. 

  1716.  *
    1717. 

  1717.  * @since 1.5.1
    1718. 

  1718.  *
    1719. 

  1719.  * @param string $text The text within which entities will be converted.
    1720. 

  1720.  * @return string Text with converted entities.
    1721. 

  1721.  */
    1722. 

  1722. function ent2ncr($text) {
    1723. 

  1723. 	$to_ncr = array(
    1724. 

  1724. 		'&quot;' => '&#34;',
    1725. 

  1725. 		'&amp;' => '&#38;',
    1726. 

  1726. 		'&frasl;' => '&#47;',
    1727. 

  1727. 		'&lt;' => '&#60;',
    1728. 

  1728. 		'&gt;' => '&#62;',
    1729. 

  1729. 		'|' => '&#124;',
    1730. 

  1730. 		'&nbsp;' => '&#160;',
    1731. 

  1731. 		'&iexcl;' => '&#161;',
    1732. 

  1732. 		'&cent;' => '&#162;',
    1733. 

  1733. 		'&pound;' => '&#163;',
    1734. 

  1734. 		'&curren;' => '&#164;',
    1735. 

  1735. 		'&yen;' => '&#165;',
    1736. 

  1736. 		'&brvbar;' => '&#166;',
    1737. 

  1737. 		'&brkbar;' => '&#166;',
    1738. 

  1738. 		'&sect;' => '&#167;',
    1739. 

  1739. 		'&uml;' => '&#168;',
    1740. 

  1740. 		'&die;' => '&#168;',
    1741. 

  1741. 		'&copy;' => '&#169;',
    1742. 

  1742. 		'&ordf;' => '&#170;',
    1743. 

  1743. 		'&laquo;' => '&#171;',
    1744. 

  1744. 		'&not;' => '&#172;',
    1745. 

  1745. 		'&shy;' => '&#173;',
    1746. 

  1746. 		'&reg;' => '&#174;',
    1747. 

  1747. 		'&macr;' => '&#175;',
    1748. 

  1748. 		'&hibar;' => '&#175;',
    1749. 

  1749. 		'&deg;' => '&#176;',
    1750. 

  1750. 		'&plusmn;' => '&#177;',
    1751. 

  1751. 		'&sup2;' => '&#178;',
    1752. 

  1752. 		'&sup3;' => '&#179;',
    1753. 

  1753. 		'&acute;' => '&#180;',
    1754. 

  1754. 		'&micro;' => '&#181;',
    1755. 

  1755. 		'&para;' => '&#182;',
    1756. 

  1756. 		'&middot;' => '&#183;',
    1757. 

  1757. 		'&cedil;' => '&#184;',
    1758. 

  1758. 		'&sup1;' => '&#185;',
    1759. 

  1759. 		'&ordm;' => '&#186;',
    1760. 

  1760. 		'&raquo;' => '&#187;',
    1761. 

  1761. 		'&frac14;' => '&#188;',
    1762. 

  1762. 		'&frac12;' => '&#189;',
    1763. 

  1763. 		'&frac34;' => '&#190;',
    1764. 

  1764. 		'&iquest;' => '&#191;',
    1765. 

  1765. 		'&Agrave;' => '&#192;',
    1766. 

  1766. 		'&Aacute;' => '&#193;',
    1767. 

  1767. 		'&Acirc;' => '&#194;',
    1768. 

  1768. 		'&Atilde;' => '&#195;',
    1769. 

  1769. 		'&Auml;' => '&#196;',
    1770. 

  1770. 		'&Aring;' => '&#197;',
    1771. 

  1771. 		'&AElig;' => '&#198;',
    1772. 

  1772. 		'&Ccedil;' => '&#199;',
    1773. 

  1773. 		'&Egrave;' => '&#200;',
    1774. 

  1774. 		'&Eacute;' => '&#201;',
    1775. 

  1775. 		'&Ecirc;' => '&#202;',
    1776. 

  1776. 		'&Euml;' => '&#203;',
    1777. 

  1777. 		'&Igrave;' => '&#204;',
    1778. 

  1778. 		'&Iacute;' => '&#205;',
    1779. 

  1779. 		'&Icirc;' => '&#206;',
    1780. 

  1780. 		'&Iuml;' => '&#207;',
    1781. 

  1781. 		'&ETH;' => '&#208;',
    1782. 

  1782. 		'&Ntilde;' => '&#209;',
    1783. 

  1783. 		'&Ograve;' => '&#210;',
    1784. 

  1784. 		'&Oacute;' => '&#211;',
    1785. 

  1785. 		'&Ocirc;' => '&#212;',
    1786. 

  1786. 		'&Otilde;' => '&#213;',
    1787. 

  1787. 		'&Ouml;' => '&#214;',
    1788. 

  1788. 		'&times;' => '&#215;',
    1789. 

  1789. 		'&Oslash;' => '&#216;',
    1790. 

  1790. 		'&Ugrave;' => '&#217;',
    1791. 

  1791. 		'&Uacute;' => '&#218;',
    1792. 

  1792. 		'&Ucirc;' => '&#219;',
    1793. 

  1793. 		'&Uuml;' => '&#220;',
    1794. 

  1794. 		'&Yacute;' => '&#221;',
    1795. 

  1795. 		'&THORN;' => '&#222;',
    1796. 

  1796. 		'&szlig;' => '&#223;',
    1797. 

  1797. 		'&agrave;' => '&#224;',
    1798. 

  1798. 		'&aacute;' => '&#225;',
    1799. 

  1799. 		'&acirc;' => '&#226;',
    1800. 

  1800. 		'&atilde;' => '&#227;',
    1801. 

  1801. 		'&auml;' => '&#228;',
    1802. 

  1802. 		'&aring;' => '&#229;',
    1803. 

  1803. 		'&aelig;' => '&#230;',
    1804. 

  1804. 		'&ccedil;' => '&#231;',
    1805. 

  1805. 		'&egrave;' => '&#232;',
    1806. 

  1806. 		'&eacute;' => '&#233;',
    1807. 

  1807. 		'&ecirc;' => '&#234;',
    1808. 

  1808. 		'&euml;' => '&#235;',
    1809. 

  1809. 		'&igrave;' => '&#236;',
    1810. 

  1810. 		'&iacute;' => '&#237;',
    1811. 

  1811. 		'&icirc;' => '&#238;',
    1812. 

  1812. 		'&iuml;' => '&#239;',
    1813. 

  1813. 		'&eth;' => '&#240;',
    1814. 

  1814. 		'&ntilde;' => '&#241;',
    1815. 

  1815. 		'&ograve;' => '&#242;',
    1816. 

  1816. 		'&oacute;' => '&#243;',
    1817. 

  1817. 		'&ocirc;' => '&#244;',
    1818. 

  1818. 		'&otilde;' => '&#245;',
    1819. 

  1819. 		'&ouml;' => '&#246;',
    1820. 

  1820. 		'&divide;' => '&#247;',
    1821. 

  1821. 		'&oslash;' => '&#248;',
    1822. 

  1822. 		'&ugrave;' => '&#249;',
    1823. 

  1823. 		'&uacute;' => '&#250;',
    1824. 

  1824. 		'&ucirc;' => '&#251;',
    1825. 

  1825. 		'&uuml;' => '&#252;',
    1826. 

  1826. 		'&yacute;' => '&#253;',
    1827. 

  1827. 		'&thorn;' => '&#254;',
    1828. 

  1828. 		'&yuml;' => '&#255;',
    1829. 

  1829. 		'&OElig;' => '&#338;',
    1830. 

  1830. 		'&oelig;' => '&#339;',
    1831. 

  1831. 		'&Scaron;' => '&#352;',
    1832. 

  1832. 		'&scaron;' => '&#353;',
    1833. 

  1833. 		'&Yuml;' => '&#376;',
    1834. 

  1834. 		'&fnof;' => '&#402;',
    1835. 

  1835. 		'&circ;' => '&#710;',
    1836. 

  1836. 		'&tilde;' => '&#732;',
    1837. 

  1837. 		'&Alpha;' => '&#913;',
    1838. 

  1838. 		'&Beta;' => '&#914;',
    1839. 

  1839. 		'&Gamma;' => '&#915;',
    1840. 

  1840. 		'&Delta;' => '&#916;',
    1841. 

  1841. 		'&Epsilon;' => '&#917;',
    1842. 

  1842. 		'&Zeta;' => '&#918;',
    1843. 

  1843. 		'&Eta;' => '&#919;',
    1844. 

  1844. 		'&Theta;' => '&#920;',
    1845. 

  1845. 		'&Iota;' => '&#921;',
    1846. 

  1846. 		'&Kappa;' => '&#922;',
    1847. 

  1847. 		'&Lambda;' => '&#923;',
    1848. 

  1848. 		'&Mu;' => '&#924;',
    1849. 

  1849. 		'&Nu;' => '&#925;',
    1850. 

  1850. 		'&Xi;' => '&#926;',
    1851. 

  1851. 		'&Omicron;' => '&#927;',
    1852. 

  1852. 		'&Pi;' => '&#928;',
    1853. 

  1853. 		'&Rho;' => '&#929;',
    1854. 

  1854. 		'&Sigma;' => '&#931;',
    1855. 

  1855. 		'&Tau;' => '&#932;',
    1856. 

  1856. 		'&Upsilon;' => '&#933;',
    1857. 

  1857. 		'&Phi;' => '&#934;',
    1858. 

  1858. 		'&Chi;' => '&#935;',
    1859. 

  1859. 		'&Psi;' => '&#936;',
    1860. 

  1860. 		'&Omega;' => '&#937;',
    1861. 

  1861. 		'&alpha;' => '&#945;',
    1862. 

  1862. 		'&beta;' => '&#946;',
    1863. 

  1863. 		'&gamma;' => '&#947;',
    1864. 

  1864. 		'&delta;' => '&#948;',
    1865. 

  1865. 		'&epsilon;' => '&#949;',
    1866. 

  1866. 		'&zeta;' => '&#950;',
    1867. 

  1867. 		'&eta;' => '&#951;',
    1868. 

  1868. 		'&theta;' => '&#952;',
    1869. 

  1869. 		'&iota;' => '&#953;',
    1870. 

  1870. 		'&kappa;' => '&#954;',
    1871. 

  1871. 		'&lambda;' => '&#955;',
    1872. 

  1872. 		'&mu;' => '&#956;',
    1873. 

  1873. 		'&nu;' => '&#957;',
    1874. 

  1874. 		'&xi;' => '&#958;',
    1875. 

  1875. 		'&omicron;' => '&#959;',
    1876. 

  1876. 		'&pi;' => '&#960;',
    1877. 

  1877. 		'&rho;' => '&#961;',
    1878. 

  1878. 		'&sigmaf;' => '&#962;',
    1879. 

  1879. 		'&sigma;' => '&#963;',
    1880. 

  1880. 		'&tau;' => '&#964;',
    1881. 

  1881. 		'&upsilon;' => '&#965;',
    1882. 

  1882. 		'&phi;' => '&#966;',
    1883. 

  1883. 		'&chi;' => '&#967;',
    1884. 

  1884. 		'&psi;' => '&#968;',
    1885. 

  1885. 		'&omega;' => '&#969;',
    1886. 

  1886. 		'&thetasym;' => '&#977;',
    1887. 

  1887. 		'&upsih;' => '&#978;',
    1888. 

  1888. 		'&piv;' => '&#982;',
    1889. 

  1889. 		'&ensp;' => '&#8194;',
    1890. 

  1890. 		'&emsp;' => '&#8195;',
    1891. 

  1891. 		'&thinsp;' => '&#8201;',
    1892. 

  1892. 		'&zwnj;' => '&#8204;',
    1893. 

  1893. 		'&zwj;' => '&#8205;',
    1894. 

  1894. 		'&lrm;' => '&#8206;',
    1895. 

  1895. 		'&rlm;' => '&#8207;',
    1896. 

  1896. 		'&ndash;' => '&#8211;',
    1897. 

  1897. 		'&mdash;' => '&#8212;',
    1898. 

  1898. 		'&lsquo;' => '&#8216;',
    1899. 

  1899. 		'&rsquo;' => '&#8217;',
    1900. 

  1900. 		'&sbquo;' => '&#8218;',
    1901. 

  1901. 		'&ldquo;' => '&#8220;',
    1902. 

  1902. 		'&rdquo;' => '&#8221;',
    1903. 

  1903. 		'&bdquo;' => '&#8222;',
    1904. 

  1904. 		'&dagger;' => '&#8224;',
    1905. 

  1905. 		'&Dagger;' => '&#8225;',
    1906. 

  1906. 		'&bull;' => '&#8226;',
    1907. 

  1907. 		'&hellip;' => '&#8230;',
    1908. 

  1908. 		'&permil;' => '&#8240;',
    1909. 

  1909. 		'&prime;' => '&#8242;',
    1910. 

  1910. 		'&Prime;' => '&#8243;',
    1911. 

  1911. 		'&lsaquo;' => '&#8249;',
    1912. 

  1912. 		'&rsaquo;' => '&#8250;',
    1913. 

  1913. 		'&oline;' => '&#8254;',
    1914. 

  1914. 		'&frasl;' => '&#8260;',
    1915. 

  1915. 		'&euro;' => '&#8364;',
    1916. 

  1916. 		'&image;' => '&#8465;',
    1917. 

  1917. 		'&weierp;' => '&#8472;',
    1918. 

  1918. 		'&real;' => '&#8476;',
    1919. 

  1919. 		'&trade;' => '&#8482;',
    1920. 

  1920. 		'&alefsym;' => '&#8501;',
    1921. 

  1921. 		'&crarr;' => '&#8629;',
    1922. 

  1922. 		'&lArr;' => '&#8656;',
    1923. 

  1923. 		'&uArr;' => '&#8657;',
    1924. 

  1924. 		'&rArr;' => '&#8658;',
    1925. 

  1925. 		'&dArr;' => '&#8659;',
    1926. 

  1926. 		'&hArr;' => '&#8660;',
    1927. 

  1927. 		'&forall;' => '&#8704;',
    1928. 

  1928. 		'&part;' => '&#8706;',
    1929. 

  1929. 		'&exist;' => '&#8707;',
    1930. 

  1930. 		'&empty;' => '&#8709;',
    1931. 

  1931. 		'&nabla;' => '&#8711;',
    1932. 

  1932. 		'&isin;' => '&#8712;',
    1933. 

  1933. 		'&notin;' => '&#8713;',
    1934. 

  1934. 		'&ni;' => '&#8715;',
    1935. 

  1935. 		'&prod;' => '&#8719;',
    1936. 

  1936. 		'&sum;' => '&#8721;',
    1937. 

  1937. 		'&minus;' => '&#8722;',
    1938. 

  1938. 		'&lowast;' => '&#8727;',
    1939. 

  1939. 		'&radic;' => '&#8730;',
    1940. 

  1940. 		'&prop;' => '&#8733;',
    1941. 

  1941. 		'&infin;' => '&#8734;',
    1942. 

  1942. 		'&ang;' => '&#8736;',
    1943. 

  1943. 		'&and;' => '&#8743;',
    1944. 

  1944. 		'&or;' => '&#8744;',
    1945. 

  1945. 		'&cap;' => '&#8745;',
    1946. 

  1946. 		'&cup;' => '&#8746;',
    1947. 

  1947. 		'&int;' => '&#8747;',
    1948. 

  1948. 		'&there4;' => '&#8756;',
    1949. 

  1949. 		'&sim;' => '&#8764;',
    1950. 

  1950. 		'&cong;' => '&#8773;',
    1951. 

  1951. 		'&asymp;' => '&#8776;',
    1952. 

  1952. 		'&ne;' => '&#8800;',
    1953. 

  1953. 		'&equiv;' => '&#8801;',
    1954. 

  1954. 		'&le;' => '&#8804;',
    1955. 

  1955. 		'&ge;' => '&#8805;',
    1956. 

  1956. 		'&sub;' => '&#8834;',
    1957. 

  1957. 		'&sup;' => '&#8835;',
    1958. 

  1958. 		'&nsub;' => '&#8836;',
    1959. 

  1959. 		'&sube;' => '&#8838;',
    1960. 

  1960. 		'&supe;' => '&#8839;',
    1961. 

  1961. 		'&oplus;' => '&#8853;',
    1962. 

  1962. 		'&otimes;' => '&#8855;',
    1963. 

  1963. 		'&perp;' => '&#8869;',
    1964. 

  1964. 		'&sdot;' => '&#8901;',
    1965. 

  1965. 		'&lceil;' => '&#8968;',
    1966. 

  1966. 		'&rceil;' => '&#8969;',
    1967. 

  1967. 		'&lfloor;' => '&#8970;',
    1968. 

  1968. 		'&rfloor;' => '&#8971;',
    1969. 

  1969. 		'&lang;' => '&#9001;',
    1970. 

  1970. 		'&rang;' => '&#9002;',
    1971. 

  1971. 		'&larr;' => '&#8592;',
    1972. 

  1972. 		'&uarr;' => '&#8593;',
    1973. 

  1973. 		'&rarr;' => '&#8594;',
    1974. 

  1974. 		'&darr;' => '&#8595;',
    1975. 

  1975. 		'&harr;' => '&#8596;',
    1976. 

  1976. 		'&loz;' => '&#9674;',
    1977. 

  1977. 		'&spades;' => '&#9824;',
    1978. 

  1978. 		'&clubs;' => '&#9827;',
    1979. 

  1979. 		'&hearts;' => '&#9829;',
    1980. 

  1980. 		'&diams;' => '&#9830;'
    1981. 

  1981. 	);
    1982. 

  1982. 

  1983. 	return str_replace( array_keys($to_ncr), array_values($to_ncr), $text );
    1984. 

  1984. }
    1985. 

  1985. 

  1986. /**
    1987. 

  1987.  * Formats text for the rich text editor.
    1988. 

  1988.  *
    1989. 

  1989.  * The filter 'richedit_pre' is applied here. If $text is empty the filter will
    1990. 

  1990.  * be applied to an empty string.
    1991. 

  1991.  *
    1992. 

  1992.  * @since 2.0.0
    1993. 

  1993.  *
    1994. 

  1994.  * @param string $text The text to be formatted.
    1995. 

  1995.  * @return string The formatted text after filter is applied.
    1996. 

  1996.  */
    1997. 

  1997. function wp_richedit_pre($text) {
    1998. 

  1998. 	// Filtering a blank results in an annoying <br />\n
    1999. 

  1999. 	if ( empty($text) ) return apply_filters('richedit_pre', '');
    2000. 

  2000. 

  2001. 	$output = convert_chars($text);
    2002. 

  2002. 	$output = wpautop($output);
    2003. 

  2003. 	$output = htmlspecialchars($output, ENT_NOQUOTES);
    2004. 

  2004. 

  2005. 	return apply_filters('richedit_pre', $output);
    2006. 

  2006. }
    2007. 

  2007. 

  2008. /**
    2009. 

  2009.  * Formats text for the HTML editor.
    2010. 

  2010.  *
    2011. 

  2011.  * Unless $output is empty it will pass through htmlspecialchars before the
    2012. 

  2012.  * 'htmledit_pre' filter is applied.
    2013. 

  2013.  *
    2014. 

  2014.  * @since 2.5.0
    2015. 

  2015.  *
    2016. 

  2016.  * @param string $output The text to be formatted.
    2017. 

  2017.  * @return string Formatted text after filter applied.
    2018. 

  2018.  */
    2019. 

  2019. function wp_htmledit_pre($output) {
    2020. 

  2020. 	if ( !empty($output) )
    2021. 

  2021. 		$output = htmlspecialchars($output, ENT_NOQUOTES); // convert only < > &
    2022. 

  2022. 

  2023. 	return apply_filters('htmledit_pre', $output);
    2024. 

  2024. }
    2025. 

  2025. 

  2026. /**
    2027. 

  2027.  * Checks and cleans a URL.
    2028. 

  2028.  *
    2029. 

  2029.  * A number of characters are removed from the URL. If the URL is for displaying
    2030. 

  2030.  * (the default behaviour) amperstands are also replaced. The 'esc_url' filter
    2031. 

  2031.  * is applied to the returned cleaned URL.
    2032. 

  2032.  *
    2033. 

  2033.  * @since 1.2.0
    2034. 

  2034.  * @uses wp_kses_bad_protocol() To only permit protocols in the URL set
    2035. 

  2035.  *		via $protocols or the common ones set in the function.
    2036. 

  2036.  *
    2037. 

  2037.  * @param string $url The URL to be cleaned.
    2038. 

  2038.  * @param array $protocols Optional. An array of acceptable protocols.
    2039. 

  2039.  *		Defaults to 'http', 'https', 'ftp', 'ftps', 'mailto', 'news', 'irc', 'gopher', 'nntp', 'feed', 'telnet' if not set.
    2040. 

  2040.  * @param string $context Optional. How the URL will be used. Default is 'display'.
    2041. 

  2041.  * @return string The cleaned $url after the 'cleaned_url' filter is applied.
    2042. 

  2042.  */
    2043. 

  2043. function clean_url( $url, $protocols = null, $context = 'display' ) {
    2044. 

  2044. 	$original_url = $url;
    2045. 

  2045. 

  2046. 	if ('' == $url) return $url;
    2047. 

  2047. 	$url = preg_replace('|[^a-z0-9-~+_.?#=!&;,/:%@$\|*\'()\\x80-\\xff]|i', '', $url);
    2048. 

  2048. 	$strip = array('%0d', '%0a', '%0D', '%0A');
    2049. 

  2049. 	$url = _deep_replace($strip, $url);
    2050. 

  2050. 	$url = str_replace(';//', '://', $url);
    2051. 

  2051. 	/* If the URL doesn't appear to contain a scheme, we
    2052. 

  2052. 	 * presume it needs http:// appended (unless a relative
    2053. 

  2053. 	 * link starting with / or a php file).
    2054. 

  2054. 	 */
    2055. 

  2055. 	if ( strpos($url, ':') === false &&
    2056. 

  2056. 		substr( $url, 0, 1 ) != '/' && substr( $url, 0, 1 ) != '#' && !preg_match('/^[a-z0-9-]+?\.php/i', $url) )
    2057. 

  2057. 		$url = 'http://' . $url;
    2058. 

  2058. 

  2059. 	// Replace ampersands and single quotes only when displaying.
    2060. 

  2060. 	if ( 'display' == $context ) {
    2061. 

  2061. 		$url = preg_replace('/&([^#])(?![a-z]{2,8};)/', '&#038;$1', $url);
    2062. 

  2062. 		$url = str_replace( "'", '&#039;', $url );
    2063. 

  2063. 	}
    2064. 

  2064. 

  2065. 	if ( !is_array($protocols) )
    2066. 

  2066. 		$protocols = array('http', 'https', 'ftp', 'ftps', 'mailto', 'news', 'irc', 'gopher', 'nntp', 'feed', 'telnet');
    2067. 

  2067. 	if ( wp_kses_bad_protocol( $url, $protocols ) != $url )
    2068. 

  2068. 		return '';
    2069. 

  2069. 

  2070. 	return apply_filters('clean_url', $url, $original_url, $context);
    2071. 

  2071. }
    2072. 

  2072. 

  2073. /**
    2074. 

  2074.  * Perform a deep string replace operation to ensure the values in $search are no longer present
    2075. 

  2075.  * 
    2076. 

  2076.  * Repeats the replacement operation until it no longer replaces anything so as to remove "nested" values
    2077. 

  2077.  * e.g. $subject = '%0%0%0DDD', $search ='%0D', $result ='' rather than the '%0%0DD' that
    2078. 

  2078.  * str_replace would return
    2079. 

  2079.  * 
    2080. 

  2080.  * @since 2.8.1
    2081. 

  2081.  * @access private
    2082. 

  2082.  * 
    2083. 

  2083.  * @param string|array $search
    2084. 

  2084.  * @param string $subject
    2085. 

  2085.  * @return string The processed string
    2086. 

  2086.  */
    2087. 

  2087. function _deep_replace($search, $subject){
    2088. 

  2088. 	$found = true;
    2089. 

  2089. 	while($found) {
    2090. 

  2090. 		$found = false;
    2091. 

  2091. 		foreach( (array) $search as $val ) {
    2092. 

  2092. 			while(strpos($subject, $val) !== false) {
    2093. 

  2093. 				$found = true;
    2094. 

  2094. 				$subject = str_replace($val, '', $subject);
    2095. 

  2095. 			}
    2096. 

  2096. 		}
    2097. 

  2097. 	}
    2098. 

  2098. 	
    2099. 

  2099. 	return $subject;
    2100. 

  2100. }
    2101. 

  2101. 

  2102. /**
    2103. 

  2103.  * Escapes data for use in a MySQL query
    2104. 

  2104.  *
    2105. 

  2105.  * This is just a handy shortcut for $wpdb->escape(), for completeness' sake
    2106. 

  2106.  *
    2107. 

  2107.  * @since 2.8.0
    2108. 

  2108.  * @param string $sql Unescaped SQL data
    2109. 

  2109.  * @return string The cleaned $sql
    2110. 

  2110.  */
    2111. 

  2111. function esc_sql( $sql ) {
    2112. 

  2112. 	global $wpdb;
    2113. 

  2113. 	return $wpdb->escape( $sql );
    2114. 

  2114. }
    2115. 

  2115. 

  2116. 

  2117. /**
    2118. 

  2118.  * Checks and cleans a URL.
    2119. 

  2119.  *
    2120. 

  2120.  * A number of characters are removed from the URL. If the URL is for displaying
    2121. 

  2121.  * (the default behaviour) amperstands are also replaced. The 'esc_url' filter
    2122. 

  2122.  * is applied to the returned cleaned URL.
    2123. 

  2123.  *
    2124. 

  2124.  * @since 2.8.0
    2125. 

  2125.  * @uses esc_url()
    2126. 

  2126.  * @uses wp_kses_bad_protocol() To only permit protocols in the URL set
    2127. 

  2127.  *		via $protocols or the common ones set in the function.
    2128. 

  2128.  *
    2129. 

  2129.  * @param string $url The URL to be cleaned.
    2130. 

  2130.  * @param array $protocols Optional. An array of acceptable protocols.
    2131. 

  2131.  *		Defaults to 'http', 'https', 'ftp', 'ftps', 'mailto', 'news', 'irc', 'gopher', 'nntp', 'feed', 'telnet' if not set.
    2132. 

  2132.  * @return string The cleaned $url after the 'cleaned_url' filter is applied.
    2133. 

  2133.  */
    2134. 

  2134. function esc_url( $url, $protocols = null ) {
    2135. 

  2135. 	return clean_url( $url, $protocols, 'display' );
    2136. 

  2136. }
    2137. 

  2137. 

  2138. /**
    2139. 

  2139.  * Performs esc_url() for database usage.
    2140. 

  2140.  *
    2141. 

  2141.  * @see esc_url()
    2142. 

  2142.  * @see esc_url()
    2143. 

  2143.  *
    2144. 

  2144.  * @since 2.8.0
    2145. 

  2145.  *
    2146. 

  2146.  * @param string $url The URL to be cleaned.
    2147. 

  2147.  * @param array $protocols An array of acceptable protocols.
    2148. 

  2148.  * @return string The cleaned URL.
    2149. 

  2149.  */
    2150. 

  2150. function esc_url_raw( $url, $protocols = null ) {
    2151. 

  2151. 	return clean_url( $url, $protocols, 'db' );
    2152. 

  2152. }
    2153. 

  2153. 

  2154. /**
    2155. 

  2155.  * Performs esc_url() for database or redirect usage.
    2156. 

  2156.  *
    2157. 

  2157.  * @see esc_url()
    2158. 

  2158.  * @deprecated 2.8.0
    2159. 

  2159.  *
    2160. 

  2160.  * @since 2.3.1
    2161. 

  2161.  *
    2162. 

  2162.  * @param string $url The URL to be cleaned.
    2163. 

  2163.  * @param array $protocols An array of acceptable protocols.
    2164. 

  2164.  * @return string The cleaned URL.
    2165. 

  2165.  */
    2166. 

  2166. function sanitize_url( $url, $protocols = null ) {
    2167. 

  2167. 	return clean_url( $url, $protocols, 'db' );
    2168. 

  2168. }
    2169. 

  2169. 

  2170. /**
    2171. 

  2171.  * Convert entities, while preserving already-encoded entities.
    2172. 

  2172.  *
    2173. 

  2173.  * @link http://www.php.net/htmlentities Borrowed from the PHP Manual user notes.
    2174. 

  2174.  *
    2175. 

  2175.  * @since 1.2.2
    2176. 

  2176.  *
    2177. 

  2177.  * @param string $myHTML The text to be converted.
    2178. 

  2178.  * @return string Converted text.
    2179. 

  2179.  */
    2180. 

  2180. function htmlentities2($myHTML) {
    2181. 

  2181. 	$translation_table = get_html_translation_table( HTML_ENTITIES, ENT_QUOTES );
    2182. 

  2182. 	$translation_table[chr(38)] = '&';
    2183. 

  2183. 	return preg_replace( "/&(?![A-Za-z]{0,4}\w{2,3};|#[0-9]{2,3};)/", "&amp;", strtr($myHTML, $translation_table) );
    2184. 

  2184. }
    2185. 

  2185. 

  2186. /**
    2187. 

  2187.  * Escape single quotes, specialchar double quotes, and fix line endings.
    2188. 

  2188.  *
    2189. 

  2189.  * The filter 'js_escape' is also applied here.
    2190. 

  2190.  *
    2191. 

  2191.  * @since 2.8.0
    2192. 

  2192.  *
    2193. 

  2193.  * @param string $text The text to be escaped.
    2194. 

  2194.  * @return string Escaped text.
    2195. 

  2195.  */
    2196. 

  2196. function esc_js( $text ) {
    2197. 

  2197. 	$safe_text = wp_check_invalid_utf8( $text );
    2198. 

  2198. 	$safe_text = _wp_specialchars( $safe_text, ENT_COMPAT );
    2199. 

  2199. 	$safe_text = preg_replace( '/&#(x)?0*(?(1)27|39);?/i', "'", stripslashes( $safe_text ) );
    2200. 

  2200. 	$safe_text = preg_replace( "/\r?\n/", "\\n", addslashes( $safe_text ) );
    2201. 

  2201. 	return apply_filters( 'js_escape', $safe_text, $text );
    2202. 

  2202. }
    2203. 

  2203. 

  2204. /**
    2205. 

  2205.  * Escape single quotes, specialchar double quotes, and fix line endings.
    2206. 

  2206.  *
    2207. 

  2207.  * The filter 'js_escape' is also applied by esc_js()
    2208. 

  2208.  *
    2209. 

  2209.  * @since 2.0.4
    2210. 

  2210.  *
    2211. 

  2211.  * @deprecated 2.8.0
    2212. 

  2212.  * @see esc_js()
    2213. 

  2213.  *
    2214. 

  2214.  * @param string $text The text to be escaped.
    2215. 

  2215.  * @return string Escaped text.
    2216. 

  2216.  */
    2217. 

  2217. function js_escape( $text ) {
    2218. 

  2218. 	return esc_js( $text );
    2219. 

  2219. }
    2220. 

  2220. 

  2221. /**
    2222. 

  2222.  * Escaping for HTML blocks.
    2223. 

  2223.  *
    2224. 

  2224.  * @since 2.8.0
    2225. 

  2225.  *
    2226. 

  2226.  * @param string $text
    2227. 

  2227.  * @return string
    2228. 

  2228.  */
    2229. 

  2229. function esc_html( $text ) {
    2230. 

  2230. 	$safe_text = wp_check_invalid_utf8( $text );
    2231. 

  2231. 	$safe_text = _wp_specialchars( $safe_text, ENT_QUOTES );
    2232. 

  2232. 	return apply_filters( 'esc_html', $safe_text, $text );
    2233. 

  2233. 	return $text;
    2234. 

  2234. }
    2235. 

  2235. 

  2236. /**
    2237. 

  2237.  * Escaping for HTML blocks
    2238. 

  2238.  * @deprecated 2.8.0
    2239. 

  2239.  * @see esc_html()
    2240. 

  2240.  */
    2241. 

  2241. function wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) {
    2242. 

  2242. 	if ( func_num_args() > 1 ) { // Maintain backwards compat for people passing additional args
    2243. 

  2243. 		$args = func_get_args();
    2244. 

  2244. 		return call_user_func_array( '_wp_specialchars', $args );
    2245. 

  2245. 	} else {
    2246. 

  2246. 		return esc_html( $string );
    2247. 

  2247. 	}
    2248. 

  2248. }
    2249. 

  2249. 

  2250. /**
    2251. 

  2251.  * Escaping for HTML attributes.
    2252. 

  2252.  *
    2253. 

  2253.  * @since 2.8.0
    2254. 

  2254.  *
    2255. 

  2255.  * @param string $text
    2256. 

  2256.  * @return string
    2257. 

  2257.  */
    2258. 

  2258. function esc_attr( $text ) {
    2259. 

  2259. 	$safe_text = wp_check_invalid_utf8( $text );
    2260. 

  2260. 	$safe_text = _wp_specialchars( $safe_text, ENT_QUOTES );
    2261. 

  2261. 	return apply_filters( 'attribute_escape', $safe_text, $text );
    2262. 

  2262. }
    2263. 

  2263. 

  2264. /**
    2265. 

  2265.  * Escaping for HTML attributes.
    2266. 

  2266.  *
    2267. 

  2267.  * @since 2.0.6
    2268. 

  2268.  *
    2269. 

  2269.  * @deprecated 2.8.0
    2270. 

  2270.  * @see esc_attr()
    2271. 

  2271.  *
    2272. 

  2272.  * @param string $text
    2273. 

  2273.  * @return string
    2274. 

  2274.  */
    2275. 

  2275. function attribute_escape( $text ) {
    2276. 

  2276. 	return esc_attr( $text );
    2277. 

  2277. }
    2278. 

  2278. 

  2279. /**
    2280. 

  2280.  * Escape a HTML tag name.
    2281. 

  2281.  *
    2282. 

  2282.  * @since 2.5.0
    2283. 

  2283.  *
    2284. 

  2284.  * @param string $tag_name
    2285. 

  2285.  * @return string
    2286. 

  2286.  */
    2287. 

  2287. function tag_escape($tag_name) {
    2288. 

  2288. 	$safe_tag = strtolower( preg_replace('/[^a-zA-Z_:]/', '', $tag_name) );
    2289. 

  2289. 	return apply_filters('tag_escape', $safe_tag, $tag_name);
    2290. 

  2290. }
    2291. 

  2291. 

  2292. /**
    2293. 

  2293.  * Escapes text for SQL LIKE special characters % and _.
    2294. 

  2294.  *
    2295. 

  2295.  * @since 2.5.0
    2296. 

  2296.  *
    2297. 

  2297.  * @param string $text The text to be escaped.
    2298. 

  2298.  * @return string text, safe for inclusion in LIKE query.
    2299. 

  2299.  */
    2300. 

  2300. function like_escape($text) {
    2301. 

  2301. 	return str_replace(array("%", "_"), array("\\%", "\\_"), $text);
    2302. 

  2302. }
    2303. 

  2303. 

  2304. /**
    2305. 

  2305.  * Convert full URL paths to absolute paths.
    2306. 

  2306.  *
    2307. 

  2307.  * Removes the http or https protocols and the domain. Keeps the path '/' at the
    2308. 

  2308.  * beginning, so it isn't a true relative link, but from the web root base.
    2309. 

  2309.  *
    2310. 

  2310.  * @since 2.1.0
    2311. 

  2311.  *
    2312. 

  2312.  * @param string $link Full URL path.
    2313. 

  2313.  * @return string Absolute path.
    2314. 

  2314.  */
    2315. 

  2315. function wp_make_link_relative( $link ) {
    2316. 

  2316. 	return preg_replace( '|https?://[^/]+(/.*)|i', '$1', $link );
    2317. 

  2317. }
    2318. 

  2318. 

  2319. /**
    2320. 

  2320.  * Sanitises various option values based on the nature of the option.
    2321. 

  2321.  *
    2322. 

  2322.  * This is basically a switch statement which will pass $value through a number
    2323. 

  2323.  * of functions depending on the $option.
    2324. 

  2324.  *
    2325. 

  2325.  * @since 2.0.5
    2326. 

  2326.  *
    2327. 

  2327.  * @param string $option The name of the option.
    2328. 

  2328.  * @param string $value The unsanitised value.
    2329. 

  2329.  * @return string Sanitized value.
    2330. 

  2330.  */
    2331. 

  2331. function sanitize_option($option, $value) {
    2332. 

  2332. 

  2333. 	switch ($option) {
    2334. 

  2334. 		case 'admin_email':
    2335. 

  2335. 			$value = sanitize_email($value);
    2336. 

  2336. 			break;
    2337. 

  2337. 

  2338. 		case 'thumbnail_size_w':
    2339. 

  2339. 		case 'thumbnail_size_h':
    2340. 

  2340. 		case 'medium_size_w':
    2341. 

  2341. 		case 'medium_size_h':
    2342. 

  2342. 		case 'large_size_w':
    2343. 

  2343. 		case 'large_size_h':
    2344. 

  2344. 		case 'default_post_edit_rows':
    2345. 

  2345. 		case 'mailserver_port':
    2346. 

  2346. 		case 'comment_max_links':
    2347. 

  2347. 		case 'page_on_front':
    2348. 

  2348. 		case 'rss_excerpt_length':
    2349. 

  2349. 		case 'default_category':
    2350. 

  2350. 		case 'default_email_category':
    2351. 

  2351. 		case 'default_link_category':
    2352. 

  2352. 		case 'close_comments_days_old':
    2353. 

  2353. 		case 'comments_per_page':
    2354. 

  2354. 		case 'thread_comments_depth':
    2355. 

  2355. 			$value = abs((int) $value);
    2356. 

  2356. 			break;
    2357. 

  2357. 

  2358. 		case 'posts_per_page':
    2359. 

  2359. 		case 'posts_per_rss':
    2360. 

  2360. 			$value = (int) $value;
    2361. 

  2361. 			if ( empty($value) ) $value = 1;
    2362. 

  2362. 			if ( $value < -1 ) $value = abs($value);
    2363. 

  2363. 			break;
    2364. 

  2364. 

  2365. 		case 'default_ping_status':
    2366. 

  2366. 		case 'default_comment_status':
    2367. 

  2367. 			// Options that if not there have 0 value but need to be something like "closed"
    2368. 

  2368. 			if ( $value == '0' || $value == '')
    2369. 

  2369. 				$value = 'closed';
    2370. 

  2370. 			break;
    2371. 

  2371. 

  2372. 		case 'blogdescription':
    2373. 

  2373. 		case 'blogname':
    2374. 

  2374. 			$value = addslashes($value);
    2375. 

  2375. 			$value = wp_filter_post_kses( $value ); // calls stripslashes then addslashes
    2376. 

  2376. 			$value = stripslashes($value);
    2377. 

  2377. 			$value = esc_html( $value );
    2378. 

  2378. 			break;
    2379. 

  2379. 

  2380. 		case 'blog_charset':
    2381. 

  2381. 			$value = preg_replace('/[^a-zA-Z0-9_-]/', '', $value); // strips slashes
    2382. 

  2382. 			break;
    2383. 

  2383. 

  2384. 		case 'date_format':
    2385. 

  2385. 		case 'time_format':
    2386. 

  2386. 		case 'mailserver_url':
    2387. 

  2387. 		case 'mailserver_login':
    2388. 

  2388. 		case 'mailserver_pass':
    2389. 

  2389. 		case 'ping_sites':
    2390. 

  2390. 		case 'upload_path':
    2391. 

  2391. 			$value = strip_tags($value);
    2392. 

  2392. 			$value = addslashes($value);
    2393. 

  2393. 			$value = wp_filter_kses($value); // calls stripslashes then addslashes
    2394. 

  2394. 			$value = stripslashes($value);
    2395. 

  2395. 			break;
    2396. 

  2396. 

  2397. 		case 'gmt_offset':
    2398. 

  2398. 			$value = preg_replace('/[^0-9:.-]/', '', $value); // strips slashes
    2399. 

  2399. 			break;
    2400. 

  2400. 

  2401. 		case 'siteurl':
    2402. 

  2402. 		case 'home':
    2403. 

  2403. 			$value = stripslashes($value);
    2404. 

  2404. 			$value = esc_url($value);
    2405. 

  2405. 			break;
    2406. 

  2406. 		default :
    2407. 

  2407. 			$value = apply_filters("sanitize_option_{$option}", $value, $option);
    2408. 

  2408. 			break;
    2409. 

  2409. 	}
    2410. 

  2410. 

  2411. 	return $value;
    2412. 

  2412. }
    2413. 

  2413. 

  2414. /**
    2415. 

  2415.  * Parses a string into variables to be stored in an array.
    2416. 

  2416.  *
    2417. 

  2417.  * Uses {@link http://www.php.net/parse_str parse_str()} and stripslashes if
    2418. 

  2418.  * {@link http://www.php.net/magic_quotes magic_quotes_gpc} is on.
    2419. 

  2419.  *
    2420. 

  2420.  * @since 2.2.1
    2421. 

  2421.  * @uses apply_filters() for the 'wp_parse_str' filter.
    2422. 

  2422.  *
    2423. 

  2423.  * @param string $string The string to be parsed.
    2424. 

  2424.  * @param array $array Variables will be stored in this array.
    2425. 

  2425.  */
    2426. 

  2426. function wp_parse_str( $string, &$array ) {
    2427. 

  2427. 	parse_str( $string, $array );
    2428. 

  2428. 	if ( get_magic_quotes_gpc() )
    2429. 

  2429. 		$array = stripslashes_deep( $array );
    2430. 

  2430. 	$array = apply_filters( 'wp_parse_str', $array );
    2431. 

  2431. }
    2432. 

  2432. 

  2433. /**
    2434. 

  2434.  * Convert lone less than signs.
    2435. 

  2435.  *
    2436. 

  2436.  * KSES already converts lone greater than signs.
    2437. 

  2437.  *
    2438. 

  2438.  * @uses wp_pre_kses_less_than_callback in the callback function.
    2439. 

  2439.  * @since 2.3.0
    2440. 

  2440.  *
    2441. 

  2441.  * @param string $text Text to be converted.
    2442. 

  2442.  * @return string Converted text.
    2443. 

  2443.  */
    2444. 

  2444. function wp_pre_kses_less_than( $text ) {
    2445. 

  2445. 	return preg_replace_callback('%<[^>]*?((?=<)|>|$)%', 'wp_pre_kses_less_than_callback', $text);
    2446. 

  2446. }
    2447. 

  2447. 

  2448. /**
    2449. 

  2449.  * Callback function used by preg_replace.
    2450. 

  2450.  *
    2451. 

  2451.  * @uses esc_html to format the $matches text.
    2452. 

  2452.  * @since 2.3.0
    2453. 

  2453.  *
    2454. 

  2454.  * @param array $matches Populated by matches to preg_replace.
    2455. 

  2455.  * @return string The text returned after esc_html if needed.
    2456. 

  2456.  */
    2457. 

  2457. function wp_pre_kses_less_than_callback( $matches ) {
    2458. 

  2458. 	if ( false === strpos($matches[0], '>') )
    2459. 

  2459. 		return esc_html($matches[0]);
    2460. 

  2460. 	return $matches[0];
    2461. 

  2461. }
    2462. 

  2462. 

  2463. /**
    2464. 

  2464.  * WordPress implementation of PHP sprintf() with filters.
    2465. 

  2465.  *
    2466. 

  2466.  * @since 2.5.0
    2467. 

  2467.  * @link http://www.php.net/sprintf
    2468. 

  2468.  *
    2469. 

  2469.  * @param string $pattern The string which formatted args are inserted.
    2470. 

  2470.  * @param mixed $args,... Arguments to be formatted into the $pattern string.
    2471. 

  2471.  * @return string The formatted string.
    2472. 

  2472.  */
    2473. 

  2473. function wp_sprintf( $pattern ) {
    2474. 

  2474. 	$args = func_get_args( );
    2475. 

  2475. 	$len = strlen($pattern);
    2476. 

  2476. 	$start = 0;
    2477. 

  2477. 	$result = '';
    2478. 

  2478. 	$arg_index = 0;
    2479. 

  2479. 	while ( $len > $start ) {
    2480. 

  2480. 		// Last character: append and break
    2481. 

  2481. 		if ( strlen($pattern) - 1 == $start ) {
    2482. 

  2482. 			$result .= substr($pattern, -1);
    2483. 

  2483. 			break;
    2484. 

  2484. 		}
    2485. 

  2485. 

  2486. 		// Literal %: append and continue
    2487. 

  2487. 		if ( substr($pattern, $start, 2) == '%%' ) {
    2488. 

  2488. 			$start += 2;
    2489. 

  2489. 			$result .= '%';
    2490. 

  2490. 			continue;
    2491. 

  2491. 		}
    2492. 

  2492. 

  2493. 		// Get fragment before next %
    2494. 

  2494. 		$end = strpos($pattern, '%', $start + 1);
    2495. 

  2495. 		if ( false === $end )
    2496. 

  2496. 			$end = $len;
    2497. 

  2497. 		$fragment = substr($pattern, $start, $end - $start);
    2498. 

  2498. 

  2499. 		// Fragment has a specifier
    2500. 

  2500. 		if ( $pattern{$start} == '%' ) {
    2501. 

  2501. 			// Find numbered arguments or take the next one in order
    2502. 

  2502. 			if ( preg_match('/^%(\d+)\$/', $fragment, $matches) ) {
    2503. 

  2503. 				$arg = isset($args[$matches[1]]) ? $args[$matches[1]] : '';
    2504. 

  2504. 				$fragment = str_replace("%{$matches[1]}$", '%', $fragment);
    2505. 

  2505. 			} else {
    2506. 

  2506. 				++$arg_index;
    2507. 

  2507. 				$arg = isset($args[$arg_index]) ? $args[$arg_index] : '';
    2508. 

  2508. 			}
    2509. 

  2509. 

  2510. 			// Apply filters OR sprintf
    2511. 

  2511. 			$_fragment = apply_filters( 'wp_sprintf', $fragment, $arg );
    2512. 

  2512. 			if ( $_fragment != $fragment )
    2513. 

  2513. 				$fragment = $_fragment;
    2514. 

  2514. 			else
    2515. 

  2515. 				$fragment = sprintf($fragment, strval($arg) );
    2516. 

  2516. 		}
    2517. 

  2517. 

  2518. 		// Append to result and move to next fragment
    2519. 

  2519. 		$result .= $fragment;
    2520. 

  2520. 		$start = $end;
    2521. 

  2521. 	}
    2522. 

  2522. 	return $result;
    2523. 

  2523. }
    2524. 

  2524. 

  2525. /**
    2526. 

  2526.  * Localize list items before the rest of the content.
    2527. 

  2527.  *
    2528. 

  2528.  * The '%l' must be at the first characters can then contain the rest of the
    2529. 

  2529.  * content. The list items will have ', ', ', and', and ' and ' added depending
    2530. 

  2530.  * on the amount of list items in the $args parameter.
    2531. 

  2531.  *
    2532. 

  2532.  * @since 2.5.0
    2533. 

  2533.  *
    2534. 

  2534.  * @param string $pattern Content containing '%l' at the beginning.
    2535. 

  2535.  * @param array $args List items to prepend to the content and replace '%l'.
    2536. 

  2536.  * @return string Localized list items and rest of the content.
    2537. 

  2537.  */
    2538. 

  2538. function wp_sprintf_l($pattern, $args) {
    2539. 

  2539. 	// Not a match
    2540. 

  2540. 	if ( substr($pattern, 0, 2) != '%l' )
    2541. 

  2541. 		return $pattern;
    2542. 

  2542. 

  2543. 	// Nothing to work with
    2544. 

  2544. 	if ( empty($args) )
    2545. 

  2545. 		return '';
    2546. 

  2546. 

  2547. 	// Translate and filter the delimiter set (avoid ampersands and entities here)
    2548. 

  2548. 	$l = apply_filters('wp_sprintf_l', array(
    2549. 

  2549. 		/* translators: used between list items, there is a space after the coma */
    2550. 

  2550. 		'between'          => __(', '),
    2551. 

  2551. 		/* translators: used between list items, there is a space after the and */
    2552. 

  2552. 		'between_last_two' => __(', and '),
    2553. 

  2553. 		/* translators: used between only two list items, there is a space after the and */
    2554. 

  2554. 		'between_only_two' => __(' and '),
    2555. 

  2555. 		));
    2556. 

  2556. 

  2557. 	$args = (array) $args;
    2558. 

  2558. 	$result = array_shift($args);
    2559. 

  2559. 	if ( count($args) == 1 )
    2560. 

  2560. 		$result .= $l['between_only_two'] . array_shift($args);
    2561. 

  2561. 	// Loop when more than two args
    2562. 

  2562. 	$i = count($args);
    2563. 

  2563. 	while ( $i ) {
    2564. 

  2564. 		$arg = array_shift($args);
    2565. 

  2565. 		$i--;
    2566. 

  2566. 		if ( 0 == $i )
    2567. 

  2567. 			$result .= $l['between_last_two'] . $arg;
    2568. 

  2568. 		else
    2569. 

  2569. 			$result .= $l['between'] . $arg;
    2570. 

  2570. 	}
    2571. 

  2571. 	return $result . substr($pattern, 2);
    2572. 

  2572. }
    2573. 

  2573. 

  2574. /**
    2575. 

  2575.  * Safely extracts not more than the first $count characters from html string.
    2576. 

  2576.  *
    2577. 

  2577.  * UTF-8, tags and entities safe prefix extraction. Entities inside will *NOT*
    2578. 

  2578.  * be counted as one character. For example &amp; will be counted as 4, &lt; as
    2579. 

  2579.  * 3, etc.
    2580. 

  2580.  *
    2581. 

  2581.  * @since 2.5.0
    2582. 

  2582.  *
    2583. 

  2583.  * @param integer $str String to get the excerpt from.
    2584. 

  2584.  * @param integer $count Maximum number of characters to take.
    2585. 

  2585.  * @return string The excerpt.
    2586. 

  2586.  */
    2587. 

  2587. function wp_html_excerpt( $str, $count ) {
    2588. 

  2588. 	$str = strip_tags( $str );
    2589. 

  2589. 	$str = mb_substr( $str, 0, $count );
    2590. 

  2590. 	// remove part of an entity at the end
    2591. 

  2591. 	$str = preg_replace( '/&[^;\s]{0,6}$/', '', $str );
    2592. 

  2592. 	return $str;
    2593. 

  2593. }
    2594. 

  2594. 

  2595. /**
    2596. 

  2596.  * Add a Base url to relative links in passed content.
    2597. 

  2597.  *
    2598. 

  2598.  * By default it supports the 'src' and 'href' attributes. However this can be
    2599. 

  2599.  * changed via the 3rd param.
    2600. 

  2600.  *
    2601. 

  2601.  * @since 2.7.0
    2602. 

  2602.  *
    2603. 

  2603.  * @param string $content String to search for links in.
    2604. 

  2604.  * @param string $base The base URL to prefix to links.
    2605. 

  2605.  * @param array $attrs The attributes which should be processed.
    2606. 

  2606.  * @return string The processed content.
    2607. 

  2607.  */
    2608. 

  2608. function links_add_base_url( $content, $base, $attrs = array('src', 'href') ) {
    2609. 

  2609. 	$attrs = implode('|', (array)$attrs);
    2610. 

  2610. 	return preg_replace_callback("!($attrs)=(['\"])(.+?)\\2!i",
    2611. 

  2611. 			create_function('$m', 'return _links_add_base($m, "' . $base . '");'),
    2612. 

  2612. 			$content);
    2613. 

  2613. }
    2614. 

  2614. 

  2615. /**
    2616. 

  2616.  * Callback to add a base url to relative links in passed content.
    2617. 

  2617.  *
    2618. 

  2618.  * @since 2.7.0
    2619. 

  2619.  * @access private
    2620. 

  2620.  *
    2621. 

  2621.  * @param string $m The matched link.
    2622. 

  2622.  * @param string $base The base URL to prefix to links.
    2623. 

  2623.  * @return string The processed link.
    2624. 

  2624.  */
    2625. 

  2625. function _links_add_base($m, $base) {
    2626. 

  2626. 	//1 = attribute name  2 = quotation mark  3 = URL
    2627. 

  2627. 	return $m[1] . '=' . $m[2] .
    2628. 

  2628. 		(strpos($m[3], 'http://') === false ?
    2629. 

  2629. 			path_join($base, $m[3]) :
    2630. 

  2630. 			$m[3])
    2631. 

  2631. 		. $m[2];
    2632. 

  2632. }
    2633. 

  2633. 

  2634. /**
    2635. 

  2635.  * Adds a Target attribute to all links in passed content.
    2636. 

  2636.  *
    2637. 

  2637.  * This function by default only applies to <a> tags, however this can be
    2638. 

  2638.  * modified by the 3rd param.
    2639. 

  2639.  *
    2640. 

  2640.  * <b>NOTE:</b> Any current target attributed will be striped and replaced.
    2641. 

  2641.  *
    2642. 

  2642.  * @since 2.7.0
    2643. 

  2643.  *
    2644. 

  2644.  * @param string $content String to search for links in.
    2645. 

  2645.  * @param string $target The Target to add to the links.
    2646. 

  2646.  * @param array $tags An array of tags to apply to.
    2647. 

  2647.  * @return string The processed content.
    2648. 

  2648.  */
    2649. 

  2649. function links_add_target( $content, $target = '_blank', $tags = array('a') ) {
    2650. 

  2650. 	$tags = implode('|', (array)$tags);
    2651. 

  2651. 	return preg_replace_callback("!<($tags)(.+?)>!i",
    2652. 

  2652. 			create_function('$m', 'return _links_add_target($m, "' . $target . '");'),
    2653. 

  2653. 			$content);
    2654. 

  2654. }
    2655. 

  2655. /**
    2656. 

  2656.  * Callback to add a target attribute to all links in passed content.
    2657. 

  2657.  *
    2658. 

  2658.  * @since 2.7.0
    2659. 

  2659.  * @access private
    2660. 

  2660.  *
    2661. 

  2661.  * @param string $m The matched link.
    2662. 

  2662.  * @param string $target The Target to add to the links.
    2663. 

  2663.  * @return string The processed link.
    2664. 

  2664.  */
    2665. 

  2665. function _links_add_target( $m, $target ) {
    2666. 

  2666. 	$tag = $m[1];
    2667. 

  2667. 	$link = preg_replace('|(target=[\'"](.*?)[\'"])|i', '', $m[2]);
    2668. 

  2668. 	return '<' . $tag . $link . ' target="' . $target . '">';
    2669. 

  2669. }
    2670. 

  2670. 

  2671. // normalize EOL characters and strip duplicate whitespace
    2672. 

  2672. function normalize_whitespace( $str ) {
    2673. 

  2673. 	$str  = trim($str);
    2674. 

  2674. 	$str  = str_replace("\r", "\n", $str);
    2675. 

  2675. 	$str  = preg_replace( array( '/\n+/', '/[ \t]+/' ), array( "\n", ' ' ), $str );
    2676. 

  2676. 	return $str;
    2677. 

  2677. }
    2678. 

  2678. 

  2679. ?>
    2680.