mp-wp_genesis 1 <?php
mp-wp_genesis 2 /**
mp-wp_genesis 3 * Main Wordpress Formatting API.
mp-wp_genesis 4 *
mp-wp_genesis 5 * Handles many functions for formatting output.
mp-wp_genesis 6 *
mp-wp_genesis 7 * @package WordPress
mp-wp_genesis 8 **/
mp-wp_genesis 9
mp-wp_genesis 10 /**
mp-wp_genesis 11 * Accepts matches array from preg_replace_callback in wpautop() or a string.
mp-wp_genesis 12 *
mp-wp_genesis 13 * Ensures that the contents of a <<pre>>...<</pre>> HTML block are not
mp-wp_genesis 14 * converted into paragraphs or line-breaks.
mp-wp_genesis 15 *
mp-wp_genesis 16 * @since 1.2.0
mp-wp_genesis 17 *
mp-wp_genesis 18 * @param array|string $matches The array or string
mp-wp_genesis 19 * @return string The pre block without paragraph/line-break conversion.
mp-wp_genesis 20 */
mp-wp_genesis 21 function clean_pre($matches) {
mp-wp_genesis 22 if ( is_array($matches) )
mp-wp_genesis 23 $text = $matches[1] . $matches[2] . "</pre>";
mp-wp_genesis 24 else
mp-wp_genesis 25 $text = $matches;
mp-wp_genesis 26
mp-wp_genesis 27 $text = str_replace('<br />', '', $text);
mp-wp_genesis 28 $text = str_replace('<p>', "\n", $text);
mp-wp_genesis 29 $text = str_replace('</p>', '', $text);
mp-wp_genesis 30
mp-wp_genesis 31 return $text;
mp-wp_genesis 32 }
mp-wp_genesis 33
mp-wp_genesis 34 /**
mp-wp_genesis 35 * Replaces double line-breaks with paragraph elements.
mp-wp_genesis 36 *
mp-wp_genesis 37 * A group of regex replaces used to identify text formatted with newlines and
mp-wp_genesis 38 * replace double line-breaks with HTML paragraph tags. The remaining
mp-wp_genesis 39 * line-breaks after conversion become <<br />> tags, unless $br is set to '0'
mp-wp_genesis 40 * or 'false'.
mp-wp_genesis 41 *
mp-wp_genesis 42 * @since 0.71
mp-wp_genesis 43 *
mp-wp_genesis 44 * @param string $pee The text which has to be formatted.
mp-wp_genesis 45 * @param int|bool $br Optional. If set, this will convert all remaining line-breaks after paragraphing. Default true.
mp-wp_genesis 46 * @return string Text which has been converted into correct paragraph tags.
mp-wp_genesis 47 */
mp-wp_genesis 48 function wpautop($pee, $br = 1) {
mp-wp_genesis 49 $pee = $pee . "\n"; // just to make things a little easier, pad the end
mp-wp_genesis 50 $pee = preg_replace('|<br />\s*<br />|', "\n\n", $pee);
mp-wp_genesis 51 // Space things out a little
mp-wp_genesis 52 $allblocks = '(?:table|thead|tfoot|caption|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)';
mp-wp_genesis 53 $pee = preg_replace('!(<' . $allblocks . '[^>]*>)!', "\n$1", $pee);
mp-wp_genesis 54 $pee = preg_replace('!(</' . $allblocks . '>)!', "$1\n\n", $pee);
mp-wp_genesis 55 $pee = str_replace(array("\r\n", "\r"), "\n", $pee); // cross-platform newlines
mp-wp_genesis 56 if ( strpos($pee, '<object') !== false ) {
mp-wp_genesis 57 $pee = preg_replace('|\s*<param([^>]*)>\s*|', "<param$1>", $pee); // no pee inside object/embed
mp-wp_genesis 58 $pee = preg_replace('|\s*</embed>\s*|', '</embed>', $pee);
mp-wp_genesis 59 }
mp-wp_genesis 60 $pee = preg_replace("/\n\n+/", "\n\n", $pee); // take care of duplicates
mp-wp_genesis 61 // make paragraphs, including one at the end
mp-wp_genesis 62 $pees = preg_split('/\n\s*\n/', $pee, -1, PREG_SPLIT_NO_EMPTY);
mp-wp_genesis 63 $pee = '';
mp-wp_genesis 64 foreach ( $pees as $tinkle )
mp-wp_genesis 65 $pee .= '<p>' . trim($tinkle, "\n") . "</p>\n";
mp-wp_genesis 66 $pee = preg_replace('|<p>\s*?</p>|', '', $pee); // under certain strange conditions it could create a P of entirely whitespace
mp-wp_genesis 67 $pee = preg_replace('!<p>([^<]+)\s*?(</(?:div|address|form)[^>]*>)!', "<p>$1</p>$2", $pee);
mp-wp_genesis 68 $pee = preg_replace( '|<p>|', "$1<p>", $pee );
mp-wp_genesis 69 $pee = preg_replace('!<p>\s*(</?' . $allblocks . '[^>]*>)\s*</p>!', "$1", $pee); // don't pee all over a tag
mp-wp_genesis 70 $pee = preg_replace("|<p>(<li.+?)</p>|", "$1", $pee); // problem with nested lists
mp-wp_genesis 71 $pee = preg_replace('|<p><blockquote([^>]*)>|i', "<blockquote$1><p>", $pee);
mp-wp_genesis 72 $pee = str_replace('</blockquote></p>', '</p></blockquote>', $pee);
mp-wp_genesis 73 $pee = preg_replace('!<p>\s*(</?' . $allblocks . '[^>]*>)!', "$1", $pee);
mp-wp_genesis 74 $pee = preg_replace('!(</?' . $allblocks . '[^>]*>)\s*</p>!', "$1", $pee);
mp-wp_genesis 75 if ($br) {
mp-wp_genesis 76 $pee = preg_replace_callback('/<(script|style).*?<\/\\1>/s', create_function('$matches', 'return str_replace("\n", "<WPPreserveNewline />", $matches[0]);'), $pee);
mp-wp_genesis 77 $pee = preg_replace('|(?<!<br />)\s*\n|', "<br />\n", $pee); // optionally make line breaks
mp-wp_genesis 78 $pee = str_replace('<WPPreserveNewline />', "\n", $pee);
mp-wp_genesis 79 }
mp-wp_genesis 80 $pee = preg_replace('!(</?' . $allblocks . '[^>]*>)\s*<br />!', "$1", $pee);
mp-wp_genesis 81 $pee = preg_replace('!<br />(\s*</?(?:p|li|div|dl|dd|dt|th|pre|td|ul|ol)[^>]*>)!', '$1', $pee);
mp-wp_genesis 82 if (strpos($pee, '<pre') !== false)
mp-wp_genesis 83 $pee = preg_replace_callback('!(<pre.*?>)(.*?)</pre>!is', 'clean_pre', $pee );
mp-wp_genesis 84 $pee = preg_replace( "|\n</p>$|", '</p>', $pee );
mp-wp_genesis 85 $pee = preg_replace('/<p>\s*?(' . get_shortcode_regex() . ')\s*<\/p>/s', '$1', $pee); // don't auto-p wrap shortcodes that stand alone
mp-wp_genesis 86
mp-wp_genesis 87 return $pee;
mp-wp_genesis 88 }
mp-wp_genesis 89
mp-wp_genesis 90 /**
mp-wp_genesis 91 * Checks to see if a string is utf8 encoded.
mp-wp_genesis 92 *
mp-wp_genesis 93 * @author bmorel at ssi dot fr
mp-wp_genesis 94 *
mp-wp_genesis 95 * @since 1.2.1
mp-wp_genesis 96 *
mp-wp_genesis 97 * @param string $Str The string to be checked
mp-wp_genesis 98 * @return bool True if $Str fits a UTF-8 model, false otherwise.
mp-wp_genesis 99 */
mp-wp_genesis 100 function seems_utf8($Str) { # by bmorel at ssi dot fr
mp-wp_genesis 101 $length = strlen($Str);
mp-wp_genesis 102 for ($i=0; $i < $length; $i++) {
mp-wp_genesis 103 if (ord($Str[$i]) < 0x80) continue; # 0bbbbbbb
mp-wp_genesis 104 elseif ((ord($Str[$i]) & 0xE0) == 0xC0) $n=1; # 110bbbbb
mp-wp_genesis 105 elseif ((ord($Str[$i]) & 0xF0) == 0xE0) $n=2; # 1110bbbb
mp-wp_genesis 106 elseif ((ord($Str[$i]) & 0xF8) == 0xF0) $n=3; # 11110bbb
mp-wp_genesis 107 elseif ((ord($Str[$i]) & 0xFC) == 0xF8) $n=4; # 111110bb
mp-wp_genesis 108 elseif ((ord($Str[$i]) & 0xFE) == 0xFC) $n=5; # 1111110b
mp-wp_genesis 109 else return false; # Does not match any model
mp-wp_genesis 110 for ($j=0; $j<$n; $j++) { # n bytes matching 10bbbbbb follow ?
mp-wp_genesis 111 if ((++$i == $length) || ((ord($Str[$i]) & 0xC0) != 0x80))
mp-wp_genesis 112 return false;
mp-wp_genesis 113 }
mp-wp_genesis 114 }
mp-wp_genesis 115 return true;
mp-wp_genesis 116 }
mp-wp_genesis 117
mp-wp_genesis 118 /**
mp-wp_genesis 119 * Converts a number of special characters into their HTML entities.
mp-wp_genesis 120 *
mp-wp_genesis 121 * Differs from htmlspecialchars as existing HTML entities will not be encoded.
mp-wp_genesis 122 * Specifically changes: & to &, < to < and > to >.
mp-wp_genesis 123 *
mp-wp_genesis 124 * $quotes can be set to 'single' to encode ' to ', 'double' to encode " to
mp-wp_genesis 125 * ", or '1' to do both. Default is 0 where no quotes are encoded.
mp-wp_genesis 126 *
mp-wp_genesis 127 * @since 1.2.2
mp-wp_genesis 128 *
mp-wp_genesis 129 * @param string $text The text which is to be encoded.
mp-wp_genesis 130 * @param mixed $quotes Optional. Converts single quotes if set to 'single', double if set to 'double' or both if otherwise set. Default 0.
mp-wp_genesis 131 * @return string The encoded text with HTML entities.
mp-wp_genesis 132 */
mp-wp_genesis 133 function wp_specialchars( $text, $quotes = 0 ) {
mp-wp_genesis 134 // Like htmlspecialchars except don't double-encode HTML entities
mp-wp_genesis 135 $text = str_replace('&&', '&&', $text);
mp-wp_genesis 136 $text = str_replace('&&', '&&', $text);
mp-wp_genesis 137 $text = preg_replace('/&(?:$|([^#])(?![a-z1-4]{1,8};))/', '&$1', $text);
mp-wp_genesis 138 $text = str_replace('<', '<', $text);
mp-wp_genesis 139 $text = str_replace('>', '>', $text);
mp-wp_genesis 140 if ( 'double' === $quotes ) {
mp-wp_genesis 141 $text = str_replace('"', '"', $text);
mp-wp_genesis 142 } elseif ( 'single' === $quotes ) {
mp-wp_genesis 143 $text = str_replace("'", ''', $text);
mp-wp_genesis 144 } elseif ( $quotes ) {
mp-wp_genesis 145 $text = str_replace('"', '"', $text);
mp-wp_genesis 146 $text = str_replace("'", ''', $text);
mp-wp_genesis 147 }
mp-wp_genesis 148 return $text;
mp-wp_genesis 149 }
mp-wp_genesis 150
mp-wp_genesis 151 /**
mp-wp_genesis 152 * Encode the Unicode values to be used in the URI.
mp-wp_genesis 153 *
mp-wp_genesis 154 * @since 1.5.0
mp-wp_genesis 155 *
mp-wp_genesis 156 * @param string $utf8_string
mp-wp_genesis 157 * @param int $length Max length of the string
mp-wp_genesis 158 * @return string String with Unicode encoded for URI.
mp-wp_genesis 159 */
mp-wp_genesis 160 function utf8_uri_encode( $utf8_string, $length = 0 ) {
mp-wp_genesis 161 $unicode = '';
mp-wp_genesis 162 $values = array();
mp-wp_genesis 163 $num_octets = 1;
mp-wp_genesis 164 $unicode_length = 0;
mp-wp_genesis 165
mp-wp_genesis 166 $string_length = strlen( $utf8_string );
mp-wp_genesis 167 for ($i = 0; $i < $string_length; $i++ ) {
mp-wp_genesis 168
mp-wp_genesis 169 $value = ord( $utf8_string[ $i ] );
mp-wp_genesis 170
mp-wp_genesis 171 if ( $value < 128 ) {
mp-wp_genesis 172 if ( $length && ( $unicode_length >= $length ) )
mp-wp_genesis 173 break;
mp-wp_genesis 174 $unicode .= chr($value);
mp-wp_genesis 175 $unicode_length++;
mp-wp_genesis 176 } else {
mp-wp_genesis 177 if ( count( $values ) == 0 ) $num_octets = ( $value < 224 ) ? 2 : 3;
mp-wp_genesis 178
mp-wp_genesis 179 $values[] = $value;
mp-wp_genesis 180
mp-wp_genesis 181 if ( $length && ( $unicode_length + ($num_octets * 3) ) > $length )
mp-wp_genesis 182 break;
mp-wp_genesis 183 if ( count( $values ) == $num_octets ) {
mp-wp_genesis 184 if ($num_octets == 3) {
mp-wp_genesis 185 $unicode .= '%' . dechex($values[0]) . '%' . dechex($values[1]) . '%' . dechex($values[2]);
mp-wp_genesis 186 $unicode_length += 9;
mp-wp_genesis 187 } else {
mp-wp_genesis 188 $unicode .= '%' . dechex($values[0]) . '%' . dechex($values[1]);
mp-wp_genesis 189 $unicode_length += 6;
mp-wp_genesis 190 }
mp-wp_genesis 191
mp-wp_genesis 192 $values = array();
mp-wp_genesis 193 $num_octets = 1;
mp-wp_genesis 194 }
mp-wp_genesis 195 }
mp-wp_genesis 196 }
mp-wp_genesis 197
mp-wp_genesis 198 return $unicode;
mp-wp_genesis 199 }
mp-wp_genesis 200
mp-wp_genesis 201 /**
mp-wp_genesis 202 * Converts all accent characters to ASCII characters.
mp-wp_genesis 203 *
mp-wp_genesis 204 * If there are no accent characters, then the string given is just returned.
mp-wp_genesis 205 *
mp-wp_genesis 206 * @since 1.2.1
mp-wp_genesis 207 *
mp-wp_genesis 208 * @param string $string Text that might have accent characters
mp-wp_genesis 209 * @return string Filtered string with replaced "nice" characters.
mp-wp_genesis 210 */
mp-wp_genesis 211 function remove_accents($string) {
mp-wp_genesis 212 if ( !preg_match('/[\x80-\xff]/', $string) )
mp-wp_genesis 213 return $string;
mp-wp_genesis 214
mp-wp_genesis 215 if (seems_utf8($string)) {
mp-wp_genesis 216 $chars = array(
mp-wp_genesis 217 // Decompositions for Latin-1 Supplement
mp-wp_genesis 218 chr(195).chr(128) => 'A', chr(195).chr(129) => 'A',
mp-wp_genesis 219 chr(195).chr(130) => 'A', chr(195).chr(131) => 'A',
mp-wp_genesis 220 chr(195).chr(132) => 'A', chr(195).chr(133) => 'A',
mp-wp_genesis 221 chr(195).chr(135) => 'C', chr(195).chr(136) => 'E',
mp-wp_genesis 222 chr(195).chr(137) => 'E', chr(195).chr(138) => 'E',
mp-wp_genesis 223 chr(195).chr(139) => 'E', chr(195).chr(140) => 'I',
mp-wp_genesis 224 chr(195).chr(141) => 'I', chr(195).chr(142) => 'I',
mp-wp_genesis 225 chr(195).chr(143) => 'I', chr(195).chr(145) => 'N',
mp-wp_genesis 226 chr(195).chr(146) => 'O', chr(195).chr(147) => 'O',
mp-wp_genesis 227 chr(195).chr(148) => 'O', chr(195).chr(149) => 'O',
mp-wp_genesis 228 chr(195).chr(150) => 'O', chr(195).chr(153) => 'U',
mp-wp_genesis 229 chr(195).chr(154) => 'U', chr(195).chr(155) => 'U',
mp-wp_genesis 230 chr(195).chr(156) => 'U', chr(195).chr(157) => 'Y',
mp-wp_genesis 231 chr(195).chr(159) => 's', chr(195).chr(160) => 'a',
mp-wp_genesis 232 chr(195).chr(161) => 'a', chr(195).chr(162) => 'a',
mp-wp_genesis 233 chr(195).chr(163) => 'a', chr(195).chr(164) => 'a',
mp-wp_genesis 234 chr(195).chr(165) => 'a', chr(195).chr(167) => 'c',
mp-wp_genesis 235 chr(195).chr(168) => 'e', chr(195).chr(169) => 'e',
mp-wp_genesis 236 chr(195).chr(170) => 'e', chr(195).chr(171) => 'e',
mp-wp_genesis 237 chr(195).chr(172) => 'i', chr(195).chr(173) => 'i',
mp-wp_genesis 238 chr(195).chr(174) => 'i', chr(195).chr(175) => 'i',
mp-wp_genesis 239 chr(195).chr(177) => 'n', chr(195).chr(178) => 'o',
mp-wp_genesis 240 chr(195).chr(179) => 'o', chr(195).chr(180) => 'o',
mp-wp_genesis 241 chr(195).chr(181) => 'o', chr(195).chr(182) => 'o',
mp-wp_genesis 242 chr(195).chr(182) => 'o', chr(195).chr(185) => 'u',
mp-wp_genesis 243 chr(195).chr(186) => 'u', chr(195).chr(187) => 'u',
mp-wp_genesis 244 chr(195).chr(188) => 'u', chr(195).chr(189) => 'y',
mp-wp_genesis 245 chr(195).chr(191) => 'y',
mp-wp_genesis 246 // Decompositions for Latin Extended-A
mp-wp_genesis 247 chr(196).chr(128) => 'A', chr(196).chr(129) => 'a',
mp-wp_genesis 248 chr(196).chr(130) => 'A', chr(196).chr(131) => 'a',
mp-wp_genesis 249 chr(196).chr(132) => 'A', chr(196).chr(133) => 'a',
mp-wp_genesis 250 chr(196).chr(134) => 'C', chr(196).chr(135) => 'c',
mp-wp_genesis 251 chr(196).chr(136) => 'C', chr(196).chr(137) => 'c',
mp-wp_genesis 252 chr(196).chr(138) => 'C', chr(196).chr(139) => 'c',
mp-wp_genesis 253 chr(196).chr(140) => 'C', chr(196).chr(141) => 'c',
mp-wp_genesis 254 chr(196).chr(142) => 'D', chr(196).chr(143) => 'd',
mp-wp_genesis 255 chr(196).chr(144) => 'D', chr(196).chr(145) => 'd',
mp-wp_genesis 256 chr(196).chr(146) => 'E', chr(196).chr(147) => 'e',
mp-wp_genesis 257 chr(196).chr(148) => 'E', chr(196).chr(149) => 'e',
mp-wp_genesis 258 chr(196).chr(150) => 'E', chr(196).chr(151) => 'e',
mp-wp_genesis 259 chr(196).chr(152) => 'E', chr(196).chr(153) => 'e',
mp-wp_genesis 260 chr(196).chr(154) => 'E', chr(196).chr(155) => 'e',
mp-wp_genesis 261 chr(196).chr(156) => 'G', chr(196).chr(157) => 'g',
mp-wp_genesis 262 chr(196).chr(158) => 'G', chr(196).chr(159) => 'g',
mp-wp_genesis 263 chr(196).chr(160) => 'G', chr(196).chr(161) => 'g',
mp-wp_genesis 264 chr(196).chr(162) => 'G', chr(196).chr(163) => 'g',
mp-wp_genesis 265 chr(196).chr(164) => 'H', chr(196).chr(165) => 'h',
mp-wp_genesis 266 chr(196).chr(166) => 'H', chr(196).chr(167) => 'h',
mp-wp_genesis 267 chr(196).chr(168) => 'I', chr(196).chr(169) => 'i',
mp-wp_genesis 268 chr(196).chr(170) => 'I', chr(196).chr(171) => 'i',
mp-wp_genesis 269 chr(196).chr(172) => 'I', chr(196).chr(173) => 'i',
mp-wp_genesis 270 chr(196).chr(174) => 'I', chr(196).chr(175) => 'i',
mp-wp_genesis 271 chr(196).chr(176) => 'I', chr(196).chr(177) => 'i',
mp-wp_genesis 272 chr(196).chr(178) => 'IJ',chr(196).chr(179) => 'ij',
mp-wp_genesis 273 chr(196).chr(180) => 'J', chr(196).chr(181) => 'j',
mp-wp_genesis 274 chr(196).chr(182) => 'K', chr(196).chr(183) => 'k',
mp-wp_genesis 275 chr(196).chr(184) => 'k', chr(196).chr(185) => 'L',
mp-wp_genesis 276 chr(196).chr(186) => 'l', chr(196).chr(187) => 'L',
mp-wp_genesis 277 chr(196).chr(188) => 'l', chr(196).chr(189) => 'L',
mp-wp_genesis 278 chr(196).chr(190) => 'l', chr(196).chr(191) => 'L',
mp-wp_genesis 279 chr(197).chr(128) => 'l', chr(197).chr(129) => 'L',
mp-wp_genesis 280 chr(197).chr(130) => 'l', chr(197).chr(131) => 'N',
mp-wp_genesis 281 chr(197).chr(132) => 'n', chr(197).chr(133) => 'N',
mp-wp_genesis 282 chr(197).chr(134) => 'n', chr(197).chr(135) => 'N',
mp-wp_genesis 283 chr(197).chr(136) => 'n', chr(197).chr(137) => 'N',
mp-wp_genesis 284 chr(197).chr(138) => 'n', chr(197).chr(139) => 'N',
mp-wp_genesis 285 chr(197).chr(140) => 'O', chr(197).chr(141) => 'o',
mp-wp_genesis 286 chr(197).chr(142) => 'O', chr(197).chr(143) => 'o',
mp-wp_genesis 287 chr(197).chr(144) => 'O', chr(197).chr(145) => 'o',
mp-wp_genesis 288 chr(197).chr(146) => 'OE',chr(197).chr(147) => 'oe',
mp-wp_genesis 289 chr(197).chr(148) => 'R',chr(197).chr(149) => 'r',
mp-wp_genesis 290 chr(197).chr(150) => 'R',chr(197).chr(151) => 'r',
mp-wp_genesis 291 chr(197).chr(152) => 'R',chr(197).chr(153) => 'r',
mp-wp_genesis 292 chr(197).chr(154) => 'S',chr(197).chr(155) => 's',
mp-wp_genesis 293 chr(197).chr(156) => 'S',chr(197).chr(157) => 's',
mp-wp_genesis 294 chr(197).chr(158) => 'S',chr(197).chr(159) => 's',
mp-wp_genesis 295 chr(197).chr(160) => 'S', chr(197).chr(161) => 's',
mp-wp_genesis 296 chr(197).chr(162) => 'T', chr(197).chr(163) => 't',
mp-wp_genesis 297 chr(197).chr(164) => 'T', chr(197).chr(165) => 't',
mp-wp_genesis 298 chr(197).chr(166) => 'T', chr(197).chr(167) => 't',
mp-wp_genesis 299 chr(197).chr(168) => 'U', chr(197).chr(169) => 'u',
mp-wp_genesis 300 chr(197).chr(170) => 'U', chr(197).chr(171) => 'u',
mp-wp_genesis 301 chr(197).chr(172) => 'U', chr(197).chr(173) => 'u',
mp-wp_genesis 302 chr(197).chr(174) => 'U', chr(197).chr(175) => 'u',
mp-wp_genesis 303 chr(197).chr(176) => 'U', chr(197).chr(177) => 'u',
mp-wp_genesis 304 chr(197).chr(178) => 'U', chr(197).chr(179) => 'u',
mp-wp_genesis 305 chr(197).chr(180) => 'W', chr(197).chr(181) => 'w',
mp-wp_genesis 306 chr(197).chr(182) => 'Y', chr(197).chr(183) => 'y',
mp-wp_genesis 307 chr(197).chr(184) => 'Y', chr(197).chr(185) => 'Z',
mp-wp_genesis 308 chr(197).chr(186) => 'z', chr(197).chr(187) => 'Z',
mp-wp_genesis 309 chr(197).chr(188) => 'z', chr(197).chr(189) => 'Z',
mp-wp_genesis 310 chr(197).chr(190) => 'z', chr(197).chr(191) => 's',
mp-wp_genesis 311 // Euro Sign
mp-wp_genesis 312 chr(226).chr(130).chr(172) => 'E',
mp-wp_genesis 313 // GBP (Pound) Sign
mp-wp_genesis 314 chr(194).chr(163) => '');
mp-wp_genesis 315
mp-wp_genesis 316 $string = strtr($string, $chars);
mp-wp_genesis 317 } else {
mp-wp_genesis 318 // Assume ISO-8859-1 if not UTF-8
mp-wp_genesis 319 $chars['in'] = chr(128).chr(131).chr(138).chr(142).chr(154).chr(158)
mp-wp_genesis 320 .chr(159).chr(162).chr(165).chr(181).chr(192).chr(193).chr(194)
mp-wp_genesis 321 .chr(195).chr(196).chr(197).chr(199).chr(200).chr(201).chr(202)
mp-wp_genesis 322 .chr(203).chr(204).chr(205).chr(206).chr(207).chr(209).chr(210)
mp-wp_genesis 323 .chr(211).chr(212).chr(213).chr(214).chr(216).chr(217).chr(218)
mp-wp_genesis 324 .chr(219).chr(220).chr(221).chr(224).chr(225).chr(226).chr(227)
mp-wp_genesis 325 .chr(228).chr(229).chr(231).chr(232).chr(233).chr(234).chr(235)
mp-wp_genesis 326 .chr(236).chr(237).chr(238).chr(239).chr(241).chr(242).chr(243)
mp-wp_genesis 327 .chr(244).chr(245).chr(246).chr(248).chr(249).chr(250).chr(251)
mp-wp_genesis 328 .chr(252).chr(253).chr(255);
mp-wp_genesis 329
mp-wp_genesis 330 $chars['out'] = "EfSZszYcYuAAAAAACEEEEIIIINOOOOOOUUUUYaaaaaaceeeeiiiinoooooouuuuyy";
mp-wp_genesis 331
mp-wp_genesis 332 $string = strtr($string, $chars['in'], $chars['out']);
mp-wp_genesis 333 $double_chars['in'] = array(chr(140), chr(156), chr(198), chr(208), chr(222), chr(223), chr(230), chr(240), chr(254));
mp-wp_genesis 334 $double_chars['out'] = array('OE', 'oe', 'AE', 'DH', 'TH', 'ss', 'ae', 'dh', 'th');
mp-wp_genesis 335 $string = str_replace($double_chars['in'], $double_chars['out'], $string);
mp-wp_genesis 336 }
mp-wp_genesis 337
mp-wp_genesis 338 return $string;
mp-wp_genesis 339 }
mp-wp_genesis 340
mp-wp_genesis 341 /**
mp-wp_genesis 342 * Filters certain characters from the file name.
mp-wp_genesis 343 *
mp-wp_genesis 344 * Turns all strings to lowercase removing most characters except alphanumeric
mp-wp_genesis 345 * with spaces, dashes and periods. All spaces and underscores are converted to
mp-wp_genesis 346 * dashes. Multiple dashes are converted to a single dash. Finally, if the file
mp-wp_genesis 347 * name ends with a dash, it is removed.
mp-wp_genesis 348 *
mp-wp_genesis 349 * @since 2.1.0
mp-wp_genesis 350 *
mp-wp_genesis 351 * @param string $name The file name
mp-wp_genesis 352 * @return string Sanitized file name
mp-wp_genesis 353 */
mp-wp_genesis 354 function sanitize_file_name( $name ) { // Like sanitize_title, but with periods
mp-wp_genesis 355 $name = strtolower( $name );
mp-wp_genesis 356 $name = preg_replace('/&.+?;/', '', $name); // kill entities
mp-wp_genesis 357 $name = str_replace( '_', '-', $name );
mp-wp_genesis 358 $name = preg_replace('/[^a-z0-9\s-.]/', '', $name);
mp-wp_genesis 359 $name = preg_replace('/\s+/', '-', $name);
mp-wp_genesis 360 $name = preg_replace('|-+|', '-', $name);
mp-wp_genesis 361 $name = trim($name, '-');
mp-wp_genesis 362 return $name;
mp-wp_genesis 363 }
mp-wp_genesis 364
mp-wp_genesis 365 /**
mp-wp_genesis 366 * Sanitize username stripping out unsafe characters.
mp-wp_genesis 367 *
mp-wp_genesis 368 * If $strict is true, only alphanumeric characters (as well as _, space, ., -,
mp-wp_genesis 369 * @) are returned.
mp-wp_genesis 370 * Removes tags, octets, entities, and if strict is enabled, will remove all
mp-wp_genesis 371 * non-ASCII characters. After sanitizing, it passes the username, raw username
mp-wp_genesis 372 * (the username in the parameter), and the strict parameter as parameters for
mp-wp_genesis 373 * the filter.
mp-wp_genesis 374 *
mp-wp_genesis 375 * @since 2.0.0
mp-wp_genesis 376 * @uses apply_filters() Calls 'sanitize_user' hook on username, raw username,
mp-wp_genesis 377 * and $strict parameter.
mp-wp_genesis 378 *
mp-wp_genesis 379 * @param string $username The username to be sanitized.
mp-wp_genesis 380 * @param bool $strict If set limits $username to specific characters. Default false.
mp-wp_genesis 381 * @return string The sanitized username, after passing through filters.
mp-wp_genesis 382 */
mp-wp_genesis 383 function sanitize_user( $username, $strict = false ) {
mp-wp_genesis 384 $raw_username = $username;
mp-wp_genesis 385 $username = strip_tags($username);
mp-wp_genesis 386 // Kill octets
mp-wp_genesis 387 $username = preg_replace('|%([a-fA-F0-9][a-fA-F0-9])|', '', $username);
mp-wp_genesis 388 $username = preg_replace('/&.+?;/', '', $username); // Kill entities
mp-wp_genesis 389
mp-wp_genesis 390 // If strict, reduce to ASCII for max portability.
mp-wp_genesis 391 if ( $strict )
mp-wp_genesis 392 $username = preg_replace('|[^a-z0-9 _.\-@]|i', '', $username);
mp-wp_genesis 393
mp-wp_genesis 394 // Consolidate contiguous whitespace
mp-wp_genesis 395 $username = preg_replace('|\s+|', ' ', $username);
mp-wp_genesis 396
mp-wp_genesis 397 return apply_filters('sanitize_user', $username, $raw_username, $strict);
mp-wp_genesis 398 }
mp-wp_genesis 399
mp-wp_genesis 400 /**
mp-wp_genesis 401 * Sanitizes title or use fallback title.
mp-wp_genesis 402 *
mp-wp_genesis 403 * Specifically, HTML and PHP tags are stripped. Further actions can be added
mp-wp_genesis 404 * via the plugin API. If $title is empty and $fallback_title is set, the latter
mp-wp_genesis 405 * will be used.
mp-wp_genesis 406 *
mp-wp_genesis 407 * @since 1.0.0
mp-wp_genesis 408 *
mp-wp_genesis 409 * @param string $title The string to be sanitized.
mp-wp_genesis 410 * @param string $fallback_title Optional. A title to use if $title is empty.
mp-wp_genesis 411 * @return string The sanitized string.
mp-wp_genesis 412 */
mp-wp_genesis 413 function sanitize_title($title, $fallback_title = '') {
mp-wp_genesis 414 $title = strip_tags($title);
mp-wp_genesis 415 $title = apply_filters('sanitize_title', $title);
mp-wp_genesis 416
mp-wp_genesis 417 if ( '' === $title || false === $title )
mp-wp_genesis 418 $title = $fallback_title;
mp-wp_genesis 419
mp-wp_genesis 420 return $title;
mp-wp_genesis 421 }
mp-wp_genesis 422
mp-wp_genesis 423 /**
mp-wp_genesis 424 * Sanitizes title, replacing whitespace with dashes.
mp-wp_genesis 425 *
mp-wp_genesis 426 * Limits the output to alphanumeric characters, underscore (_) and dash (-).
mp-wp_genesis 427 * Whitespace becomes a dash.
mp-wp_genesis 428 *
mp-wp_genesis 429 * @since 1.2.0
mp-wp_genesis 430 *
mp-wp_genesis 431 * @param string $title The title to be sanitized.
mp-wp_genesis 432 * @return string The sanitized title.
mp-wp_genesis 433 */
mp-wp_genesis 434 function sanitize_title_with_dashes($title) {
mp-wp_genesis 435 $title = strip_tags($title);
mp-wp_genesis 436 // Preserve escaped octets.
mp-wp_genesis 437 $title = preg_replace('|%([a-fA-F0-9][a-fA-F0-9])|', '---$1---', $title);
mp-wp_genesis 438 // Remove percent signs that are not part of an octet.
mp-wp_genesis 439 $title = str_replace('%', '', $title);
mp-wp_genesis 440 // Restore octets.
mp-wp_genesis 441 $title = preg_replace('|---([a-fA-F0-9][a-fA-F0-9])---|', '%$1', $title);
mp-wp_genesis 442
mp-wp_genesis 443 $title = remove_accents($title);
mp-wp_genesis 444 if (seems_utf8($title)) {
mp-wp_genesis 445 if (function_exists('mb_strtolower')) {
mp-wp_genesis 446 $title = mb_strtolower($title, 'UTF-8');
mp-wp_genesis 447 }
mp-wp_genesis 448 $title = utf8_uri_encode($title, 200);
mp-wp_genesis 449 }
mp-wp_genesis 450
mp-wp_genesis 451 $title = strtolower($title);
mp-wp_genesis 452 $title = preg_replace('/&.+?;/', '', $title); // kill entities
mp-wp_genesis 453 $title = preg_replace('/[^%a-z0-9 _-]/', '', $title);
mp-wp_genesis 454 $title = preg_replace('/\s+/', '-', $title);
mp-wp_genesis 455 $title = preg_replace('|-+|', '-', $title);
mp-wp_genesis 456 $title = trim($title, '-');
mp-wp_genesis 457
mp-wp_genesis 458 return $title;
mp-wp_genesis 459 }
mp-wp_genesis 460
mp-wp_genesis 461 /**
mp-wp_genesis 462 * Ensures a string is a valid SQL order by clause.
mp-wp_genesis 463 *
mp-wp_genesis 464 * Accepts one or more columns, with or without ASC/DESC, and also accepts
mp-wp_genesis 465 * RAND().
mp-wp_genesis 466 *
mp-wp_genesis 467 * @since 2.5.1
mp-wp_genesis 468 *
mp-wp_genesis 469 * @param string $orderby Order by string to be checked.
mp-wp_genesis 470 * @return string|false Returns the order by clause if it is a match, false otherwise.
mp-wp_genesis 471 */
mp-wp_genesis 472 function sanitize_sql_orderby( $orderby ){
mp-wp_genesis 473 preg_match('/^\s*([a-z0-9_]+(\s+(ASC|DESC))?(\s*,\s*|\s*$))+|^\s*RAND\(\s*\)\s*$/i', $orderby, $obmatches);
mp-wp_genesis 474 if ( !$obmatches )
mp-wp_genesis 475 return false;
mp-wp_genesis 476 return $orderby;
mp-wp_genesis 477 }
mp-wp_genesis 478
mp-wp_genesis 479 /**
mp-wp_genesis 480 * Converts a number of characters from a string.
mp-wp_genesis 481 *
mp-wp_genesis 482 * Metadata tags <<title>> and <<category>> are removed, <<br>> and <<hr>> are
mp-wp_genesis 483 * converted into correct XHTML and Unicode characters are converted to the
mp-wp_genesis 484 * valid range.
mp-wp_genesis 485 *
mp-wp_genesis 486 * @since 0.71
mp-wp_genesis 487 *
mp-wp_genesis 488 * @param string $content String of characters to be converted.
mp-wp_genesis 489 * @param string $deprecated Not used.
mp-wp_genesis 490 * @return string Converted string.
mp-wp_genesis 491 */
mp-wp_genesis 492 function convert_chars($content, $deprecated = '') {
mp-wp_genesis 493 // Translation of invalid Unicode references range to valid range
mp-wp_genesis 494 $wp_htmltranswinuni = array(
mp-wp_genesis 495 '€' => '€', // the Euro sign
mp-wp_genesis 496 '' => '',
mp-wp_genesis 497 '‚' => '‚', // these are Windows CP1252 specific characters
mp-wp_genesis 498 'ƒ' => 'ƒ', // they would look weird on non-Windows browsers
mp-wp_genesis 499 '„' => '„',
mp-wp_genesis 500 '…' => '…',
mp-wp_genesis 501 '†' => '†',
mp-wp_genesis 502 '‡' => '‡',
mp-wp_genesis 503 'ˆ' => 'ˆ',
mp-wp_genesis 504 '‰' => '‰',
mp-wp_genesis 505 'Š' => 'Š',
mp-wp_genesis 506 '‹' => '‹',
mp-wp_genesis 507 'Œ' => 'Œ',
mp-wp_genesis 508 '' => '',
mp-wp_genesis 509 'Ž' => 'ž',
mp-wp_genesis 510 '' => '',
mp-wp_genesis 511 '' => '',
mp-wp_genesis 512 '‘' => '‘',
mp-wp_genesis 513 '’' => '’',
mp-wp_genesis 514 '“' => '“',
mp-wp_genesis 515 '”' => '”',
mp-wp_genesis 516 '•' => '•',
mp-wp_genesis 517 '–' => '–',
mp-wp_genesis 518 '—' => '—',
mp-wp_genesis 519 '˜' => '˜',
mp-wp_genesis 520 '™' => '™',
mp-wp_genesis 521 'š' => 'š',
mp-wp_genesis 522 '›' => '›',
mp-wp_genesis 523 'œ' => 'œ',
mp-wp_genesis 524 '' => '',
mp-wp_genesis 525 'ž' => '',
mp-wp_genesis 526 'Ÿ' => 'Ÿ'
mp-wp_genesis 527 );
mp-wp_genesis 528
mp-wp_genesis 529 // Remove metadata tags
mp-wp_genesis 530 $content = preg_replace('/<title>(.+?)<\/title>/','',$content);
mp-wp_genesis 531 $content = preg_replace('/<category>(.+?)<\/category>/','',$content);
mp-wp_genesis 532
mp-wp_genesis 533 // Converts lone & characters into & (a.k.a. &)
mp-wp_genesis 534 $content = preg_replace('/&([^#])(?![a-z1-4]{1,8};)/i', '&$1', $content);
mp-wp_genesis 535
mp-wp_genesis 536 // Fix Word pasting
mp-wp_genesis 537 $content = strtr($content, $wp_htmltranswinuni);
mp-wp_genesis 538
mp-wp_genesis 539 // Just a little XHTML help
mp-wp_genesis 540 $content = str_replace('<br>', '<br />', $content);
mp-wp_genesis 541 $content = str_replace('<hr>', '<hr />', $content);
mp-wp_genesis 542
mp-wp_genesis 543 return $content;
mp-wp_genesis 544 }
mp-wp_genesis 545
mp-wp_genesis 546 /**
mp-wp_genesis 547 * Fixes javascript bugs in browsers.
mp-wp_genesis 548 *
mp-wp_genesis 549 * Converts unicode characters to HTML numbered entities.
mp-wp_genesis 550 *
mp-wp_genesis 551 * @since 1.5.0
mp-wp_genesis 552 * @uses $is_macIE
mp-wp_genesis 553 * @uses $is_winIE
mp-wp_genesis 554 *
mp-wp_genesis 555 * @param string $text Text to be made safe.
mp-wp_genesis 556 * @return string Fixed text.
mp-wp_genesis 557 */
mp-wp_genesis 558 function funky_javascript_fix($text) {
mp-wp_genesis 559 // Fixes for browsers' javascript bugs
mp-wp_genesis 560 global $is_macIE, $is_winIE;
mp-wp_genesis 561
mp-wp_genesis 562 /** @todo use preg_replace_callback() instead */
mp-wp_genesis 563 if ( $is_winIE || $is_macIE )
mp-wp_genesis 564 $text = preg_replace("/\%u([0-9A-F]{4,4})/e", "'&#'.base_convert('\\1',16,10).';'", $text);
mp-wp_genesis 565
mp-wp_genesis 566 return $text;
mp-wp_genesis 567 }
mp-wp_genesis 568
mp-wp_genesis 569 /**
mp-wp_genesis 570 * Will only balance the tags if forced to and the option is set to balance tags.
mp-wp_genesis 571 *
mp-wp_genesis 572 * The option 'use_balanceTags' is used for whether the tags will be balanced.
mp-wp_genesis 573 * Both the $force parameter and 'use_balanceTags' option will have to be true
mp-wp_genesis 574 * before the tags will be balanced.
mp-wp_genesis 575 *
mp-wp_genesis 576 * @since 0.71
mp-wp_genesis 577 *
mp-wp_genesis 578 * @param string $text Text to be balanced
mp-wp_genesis 579 * @param bool $force Forces balancing, ignoring the value of the option. Default false.
mp-wp_genesis 580 * @return string Balanced text
mp-wp_genesis 581 */
mp-wp_genesis 582 function balanceTags( $text, $force = false ) {
mp-wp_genesis 583 if ( !$force && get_option('use_balanceTags') == 0 )
mp-wp_genesis 584 return $text;
mp-wp_genesis 585 return force_balance_tags( $text );
mp-wp_genesis 586 }
mp-wp_genesis 587
mp-wp_genesis 588 /**
mp-wp_genesis 589 * Balances tags of string using a modified stack.
mp-wp_genesis 590 *
mp-wp_genesis 591 * @since 2.0.4
mp-wp_genesis 592 *
mp-wp_genesis 593 * @author Leonard Lin <leonard@acm.org>
mp-wp_genesis 594 * @license GPL v2.0
mp-wp_genesis 595 * @copyright November 4, 2001
mp-wp_genesis 596 * @version 1.1
mp-wp_genesis 597 * @todo Make better - change loop condition to $text in 1.2
mp-wp_genesis 598 * @internal Modified by Scott Reilly (coffee2code) 02 Aug 2004
mp-wp_genesis 599 * 1.1 Fixed handling of append/stack pop order of end text
mp-wp_genesis 600 * Added Cleaning Hooks
mp-wp_genesis 601 * 1.0 First Version
mp-wp_genesis 602 *
mp-wp_genesis 603 * @param string $text Text to be balanced.
mp-wp_genesis 604 * @return string Balanced text.
mp-wp_genesis 605 */
mp-wp_genesis 606 function force_balance_tags( $text ) {
mp-wp_genesis 607 $tagstack = array(); $stacksize = 0; $tagqueue = ''; $newtext = '';
mp-wp_genesis 608 $single_tags = array('br', 'hr', 'img', 'input'); //Known single-entity/self-closing tags
mp-wp_genesis 609 $nestable_tags = array('blockquote', 'div', 'span'); //Tags that can be immediately nested within themselves
mp-wp_genesis 610
mp-wp_genesis 611 # WP bug fix for comments - in case you REALLY meant to type '< !--'
mp-wp_genesis 612 $text = str_replace('< !--', '< !--', $text);
mp-wp_genesis 613 # WP bug fix for LOVE <3 (and other situations with '<' before a number)
mp-wp_genesis 614 $text = preg_replace('#<([0-9]{1})#', '<$1', $text);
mp-wp_genesis 615
mp-wp_genesis 616 while (preg_match("/<(\/?\w*)\s*([^>]*)>/",$text,$regex)) {
mp-wp_genesis 617 $newtext .= $tagqueue;
mp-wp_genesis 618
mp-wp_genesis 619 $i = strpos($text,$regex[0]);
mp-wp_genesis 620 $l = strlen($regex[0]);
mp-wp_genesis 621
mp-wp_genesis 622 // clear the shifter
mp-wp_genesis 623 $tagqueue = '';
mp-wp_genesis 624 // Pop or Push
mp-wp_genesis 625 if ($regex[1][0] == "/") { // End Tag
mp-wp_genesis 626 $tag = strtolower(substr($regex[1],1));
mp-wp_genesis 627 // if too many closing tags
mp-wp_genesis 628 if($stacksize <= 0) {
mp-wp_genesis 629 $tag = '';
mp-wp_genesis 630 //or close to be safe $tag = '/' . $tag;
mp-wp_genesis 631 }
mp-wp_genesis 632 // if stacktop value = tag close value then pop
mp-wp_genesis 633 else if ($tagstack[$stacksize - 1] == $tag) { // found closing tag
mp-wp_genesis 634 $tag = '</' . $tag . '>'; // Close Tag
mp-wp_genesis 635 // Pop
mp-wp_genesis 636 array_pop ($tagstack);
mp-wp_genesis 637 $stacksize--;
mp-wp_genesis 638 } else { // closing tag not at top, search for it
mp-wp_genesis 639 for ($j=$stacksize-1;$j>=0;$j--) {
mp-wp_genesis 640 if ($tagstack[$j] == $tag) {
mp-wp_genesis 641 // add tag to tagqueue
mp-wp_genesis 642 for ($k=$stacksize-1;$k>=$j;$k--){
mp-wp_genesis 643 $tagqueue .= '</' . array_pop ($tagstack) . '>';
mp-wp_genesis 644 $stacksize--;
mp-wp_genesis 645 }
mp-wp_genesis 646 break;
mp-wp_genesis 647 }
mp-wp_genesis 648 }
mp-wp_genesis 649 $tag = '';
mp-wp_genesis 650 }
mp-wp_genesis 651 } else { // Begin Tag
mp-wp_genesis 652 $tag = strtolower($regex[1]);
mp-wp_genesis 653
mp-wp_genesis 654 // Tag Cleaning
mp-wp_genesis 655
mp-wp_genesis 656 // If self-closing or '', don't do anything.
mp-wp_genesis 657 if((substr($regex[2],-1) == '/') || ($tag == '')) {
mp-wp_genesis 658 }
mp-wp_genesis 659 // ElseIf it's a known single-entity tag but it doesn't close itself, do so
mp-wp_genesis 660 elseif ( in_array($tag, $single_tags) ) {
mp-wp_genesis 661 $regex[2] .= '/';
mp-wp_genesis 662 } else { // Push the tag onto the stack
mp-wp_genesis 663 // If the top of the stack is the same as the tag we want to push, close previous tag
mp-wp_genesis 664 if (($stacksize > 0) && !in_array($tag, $nestable_tags) && ($tagstack[$stacksize - 1] == $tag)) {
mp-wp_genesis 665 $tagqueue = '</' . array_pop ($tagstack) . '>';
mp-wp_genesis 666 $stacksize--;
mp-wp_genesis 667 }
mp-wp_genesis 668 $stacksize = array_push ($tagstack, $tag);
mp-wp_genesis 669 }
mp-wp_genesis 670
mp-wp_genesis 671 // Attributes
mp-wp_genesis 672 $attributes = $regex[2];
mp-wp_genesis 673 if($attributes) {
mp-wp_genesis 674 $attributes = ' '.$attributes;
mp-wp_genesis 675 }
mp-wp_genesis 676 $tag = '<'.$tag.$attributes.'>';
mp-wp_genesis 677 //If already queuing a close tag, then put this tag on, too
mp-wp_genesis 678 if ($tagqueue) {
mp-wp_genesis 679 $tagqueue .= $tag;
mp-wp_genesis 680 $tag = '';
mp-wp_genesis 681 }
mp-wp_genesis 682 }
mp-wp_genesis 683 $newtext .= substr($text,0,$i) . $tag;
mp-wp_genesis 684 $text = substr($text,$i+$l);
mp-wp_genesis 685 }
mp-wp_genesis 686
mp-wp_genesis 687 // Clear Tag Queue
mp-wp_genesis 688 $newtext .= $tagqueue;
mp-wp_genesis 689
mp-wp_genesis 690 // Add Remaining text
mp-wp_genesis 691 $newtext .= $text;
mp-wp_genesis 692
mp-wp_genesis 693 // Empty Stack
mp-wp_genesis 694 while($x = array_pop($tagstack)) {
mp-wp_genesis 695 $newtext .= '</' . $x . '>'; // Add remaining tags to close
mp-wp_genesis 696 }
mp-wp_genesis 697
mp-wp_genesis 698 // WP fix for the bug with HTML comments
mp-wp_genesis 699 $newtext = str_replace("< !--","<!--",$newtext);
mp-wp_genesis 700 $newtext = str_replace("< !--","< !--",$newtext);
mp-wp_genesis 701
mp-wp_genesis 702 return $newtext;
mp-wp_genesis 703 }
mp-wp_genesis 704
mp-wp_genesis 705 /**
mp-wp_genesis 706 * Acts on text which is about to be edited.
mp-wp_genesis 707 *
mp-wp_apply-htmls... 708 * Holder for the 'format_to_edit' filter.
mp-wp_genesis 709 *
mp-wp_genesis 710 * @since 0.71
mp-wp_genesis 711 *
mp-wp_genesis 712 * @param string $content The text about to be edited.
mp-wp_apply-htmls... 713 * @return string The text after the filter and htmlspecialchars() has been run.
mp-wp_genesis 714 */
mp-wp_remove-tiny... 715 function format_to_edit($content) {
mp-wp_genesis 716 $content = apply_filters('format_to_edit', $content);
mp-wp_apply-htmls... 717 return htmlspecialchars($content);
mp-wp_genesis 718 }
mp-wp_genesis 719
mp-wp_genesis 720 /**
mp-wp_genesis 721 * Holder for the 'format_to_post' filter.
mp-wp_genesis 722 *
mp-wp_genesis 723 * @since 0.71
mp-wp_genesis 724 *
mp-wp_genesis 725 * @param string $content The text to pass through the filter.
mp-wp_genesis 726 * @return string Text returned from the 'format_to_post' filter.
mp-wp_genesis 727 */
mp-wp_genesis 728 function format_to_post($content) {
mp-wp_genesis 729 $content = apply_filters('format_to_post', $content);
mp-wp_genesis 730 return $content;
mp-wp_genesis 731 }
mp-wp_genesis 732
mp-wp_genesis 733 /**
mp-wp_genesis 734 * Add leading zeros when necessary.
mp-wp_genesis 735 *
mp-wp_genesis 736 * If you set the threshold to '4' and the number is '10', then you will get
mp-wp_genesis 737 * back '0010'. If you set the number to '4' and the number is '5000', then you
mp-wp_genesis 738 * will get back '5000'.
mp-wp_genesis 739 *
mp-wp_genesis 740 * Uses sprintf to append the amount of zeros based on the $threshold parameter
mp-wp_genesis 741 * and the size of the number. If the number is large enough, then no zeros will
mp-wp_genesis 742 * be appended.
mp-wp_genesis 743 *
mp-wp_genesis 744 * @since 0.71
mp-wp_genesis 745 *
mp-wp_genesis 746 * @param mixed $number Number to append zeros to if not greater than threshold.
mp-wp_genesis 747 * @param int $threshold Digit places number needs to be to not have zeros added.
mp-wp_genesis 748 * @return string Adds leading zeros to number if needed.
mp-wp_genesis 749 */
mp-wp_genesis 750 function zeroise($number, $threshold) {
mp-wp_genesis 751 return sprintf('%0'.$threshold.'s', $number);
mp-wp_genesis 752 }
mp-wp_genesis 753
mp-wp_genesis 754 /**
mp-wp_genesis 755 * Adds backslashes before letters and before a number at the start of a string.
mp-wp_genesis 756 *
mp-wp_genesis 757 * @since 0.71
mp-wp_genesis 758 *
mp-wp_genesis 759 * @param string $string Value to which backslashes will be added.
mp-wp_genesis 760 * @return string String with backslashes inserted.
mp-wp_genesis 761 */
mp-wp_genesis 762 function backslashit($string) {
mp-wp_genesis 763 $string = preg_replace('/^([0-9])/', '\\\\\\\\\1', $string);
mp-wp_genesis 764 $string = preg_replace('/([a-z])/i', '\\\\\1', $string);
mp-wp_genesis 765 return $string;
mp-wp_genesis 766 }
mp-wp_genesis 767
mp-wp_genesis 768 /**
mp-wp_genesis 769 * Appends a trailing slash.
mp-wp_genesis 770 *
mp-wp_genesis 771 * Will remove trailing slash if it exists already before adding a trailing
mp-wp_genesis 772 * slash. This prevents double slashing a string or path.
mp-wp_genesis 773 *
mp-wp_genesis 774 * The primary use of this is for paths and thus should be used for paths. It is
mp-wp_genesis 775 * not restricted to paths and offers no specific path support.
mp-wp_genesis 776 *
mp-wp_genesis 777 * @since 1.2.0
mp-wp_genesis 778 * @uses untrailingslashit() Unslashes string if it was slashed already.
mp-wp_genesis 779 *
mp-wp_genesis 780 * @param string $string What to add the trailing slash to.
mp-wp_genesis 781 * @return string String with trailing slash added.
mp-wp_genesis 782 */
mp-wp_genesis 783 function trailingslashit($string) {
mp-wp_genesis 784 return untrailingslashit($string) . '/';
mp-wp_genesis 785 }
mp-wp_genesis 786
mp-wp_genesis 787 /**
mp-wp_genesis 788 * Removes trailing slash if it exists.
mp-wp_genesis 789 *
mp-wp_genesis 790 * The primary use of this is for paths and thus should be used for paths. It is
mp-wp_genesis 791 * not restricted to paths and offers no specific path support.
mp-wp_genesis 792 *
mp-wp_genesis 793 * @since 2.2.0
mp-wp_genesis 794 *
mp-wp_genesis 795 * @param string $string What to remove the trailing slash from.
mp-wp_genesis 796 * @return string String without the trailing slash.
mp-wp_genesis 797 */
mp-wp_genesis 798 function untrailingslashit($string) {
mp-wp_genesis 799 return rtrim($string, '/');
mp-wp_genesis 800 }
mp-wp_genesis 801
mp-wp_genesis 802 /**
mp-wp_genesis 803 * Adds slashes to escape strings.
mp-wp_genesis 804 *
mp-wp_genesis 805 * Slashes will first be removed if magic_quotes_gpc is set, see {@link
mp-wp_genesis 806 * http://www.php.net/magic_quotes} for more details.
mp-wp_genesis 807 *
mp-wp_genesis 808 * @since 0.71
mp-wp_genesis 809 *
mp-wp_genesis 810 * @param string $gpc The string returned from HTTP request data.
mp-wp_genesis 811 * @return string Returns a string escaped with slashes.
mp-wp_genesis 812 */
mp-wp_genesis 813 function addslashes_gpc($gpc) {
mp-wp_genesis 814 global $wpdb;
mp-wp_genesis 815
mp-wp_genesis 816 if (get_magic_quotes_gpc()) {
mp-wp_genesis 817 $gpc = stripslashes($gpc);
mp-wp_genesis 818 }
mp-wp_genesis 819
mp-wp_genesis 820 return $wpdb->escape($gpc);
mp-wp_genesis 821 }
mp-wp_genesis 822
mp-wp_genesis 823 /**
mp-wp_genesis 824 * Navigates through an array and removes slashes from the values.
mp-wp_genesis 825 *
mp-wp_genesis 826 * If an array is passed, the array_map() function causes a callback to pass the
mp-wp_genesis 827 * value back to the function. The slashes from this value will removed.
mp-wp_genesis 828 *
mp-wp_genesis 829 * @since 2.0.0
mp-wp_genesis 830 *
mp-wp_genesis 831 * @param array|string $value The array or string to be striped.
mp-wp_genesis 832 * @return array|string Stripped array (or string in the callback).
mp-wp_genesis 833 */
mp-wp_genesis 834 function stripslashes_deep($value) {
mp-wp_genesis 835 $value = is_array($value) ? array_map('stripslashes_deep', $value) : stripslashes($value);
mp-wp_genesis 836 return $value;
mp-wp_genesis 837 }
mp-wp_genesis 838
mp-wp_genesis 839 /**
mp-wp_genesis 840 * Navigates through an array and encodes the values to be used in a URL.
mp-wp_genesis 841 *
mp-wp_genesis 842 * Uses a callback to pass the value of the array back to the function as a
mp-wp_genesis 843 * string.
mp-wp_genesis 844 *
mp-wp_genesis 845 * @since 2.2.0
mp-wp_genesis 846 *
mp-wp_genesis 847 * @param array|string $value The array or string to be encoded.
mp-wp_genesis 848 * @return array|string $value The encoded array (or string from the callback).
mp-wp_genesis 849 */
mp-wp_genesis 850 function urlencode_deep($value) {
mp-wp_genesis 851 $value = is_array($value) ? array_map('urlencode_deep', $value) : urlencode($value);
mp-wp_genesis 852 return $value;
mp-wp_genesis 853 }
mp-wp_genesis 854
mp-wp_genesis 855 /**
mp-wp_genesis 856 * Converts email addresses characters to HTML entities to block spam bots.
mp-wp_genesis 857 *
mp-wp_genesis 858 * @since 0.71
mp-wp_genesis 859 *
mp-wp_genesis 860 * @param string $emailaddy Email address.
mp-wp_genesis 861 * @param int $mailto Optional. Range from 0 to 1. Used for encoding.
mp-wp_genesis 862 * @return string Converted email address.
mp-wp_genesis 863 */
mp-wp_genesis 864 function antispambot($emailaddy, $mailto=0) {
mp-wp_genesis 865 $emailNOSPAMaddy = '';
mp-wp_genesis 866 srand ((float) microtime() * 1000000);
mp-wp_genesis 867 for ($i = 0; $i < strlen($emailaddy); $i = $i + 1) {
mp-wp_genesis 868 $j = floor(rand(0, 1+$mailto));
mp-wp_genesis 869 if ($j==0) {
mp-wp_genesis 870 $emailNOSPAMaddy .= '&#'.ord(substr($emailaddy,$i,1)).';';
mp-wp_genesis 871 } elseif ($j==1) {
mp-wp_genesis 872 $emailNOSPAMaddy .= substr($emailaddy,$i,1);
mp-wp_genesis 873 } elseif ($j==2) {
mp-wp_genesis 874 $emailNOSPAMaddy .= '%'.zeroise(dechex(ord(substr($emailaddy, $i, 1))), 2);
mp-wp_genesis 875 }
mp-wp_genesis 876 }
mp-wp_genesis 877 $emailNOSPAMaddy = str_replace('@','@',$emailNOSPAMaddy);
mp-wp_genesis 878 return $emailNOSPAMaddy;
mp-wp_genesis 879 }
mp-wp_genesis 880
mp-wp_genesis 881 /**
mp-wp_genesis 882 * Callback to convert URI match to HTML A element.
mp-wp_genesis 883 *
mp-wp_genesis 884 * This function was backported from 2.5.0 to 2.3.2. Regex callback for {@link
mp-wp_genesis 885 * make_clickable()}.
mp-wp_genesis 886 *
mp-wp_genesis 887 * @since 2.3.2
mp-wp_genesis 888 * @access private
mp-wp_genesis 889 *
mp-wp_genesis 890 * @param array $matches Single Regex Match.
mp-wp_genesis 891 * @return string HTML A element with URI address.
mp-wp_genesis 892 */
mp-wp_genesis 893 function _make_url_clickable_cb($matches) {
mp-wp_genesis 894 $ret = '';
mp-wp_genesis 895 $url = $matches[2];
mp-wp_genesis 896 $url = clean_url($url);
mp-wp_genesis 897 if ( empty($url) )
mp-wp_genesis 898 return $matches[0];
mp-wp_genesis 899 // removed trailing [.,;:] from URL
mp-wp_genesis 900 if ( in_array(substr($url, -1), array('.', ',', ';', ':')) === true ) {
mp-wp_genesis 901 $ret = substr($url, -1);
mp-wp_genesis 902 $url = substr($url, 0, strlen($url)-1);
mp-wp_genesis 903 }
mp-wp_genesis 904 return $matches[1] . "<a href=\"$url\" rel=\"nofollow\">$url</a>" . $ret;
mp-wp_genesis 905 }
mp-wp_genesis 906
mp-wp_genesis 907 /**
mp-wp_genesis 908 * Callback to convert URL match to HTML A element.
mp-wp_genesis 909 *
mp-wp_genesis 910 * This function was backported from 2.5.0 to 2.3.2. Regex callback for {@link
mp-wp_genesis 911 * make_clickable()}.
mp-wp_genesis 912 *
mp-wp_genesis 913 * @since 2.3.2
mp-wp_genesis 914 * @access private
mp-wp_genesis 915 *
mp-wp_genesis 916 * @param array $matches Single Regex Match.
mp-wp_genesis 917 * @return string HTML A element with URL address.
mp-wp_genesis 918 */
mp-wp_genesis 919 function _make_web_ftp_clickable_cb($matches) {
mp-wp_genesis 920 $ret = '';
mp-wp_genesis 921 $dest = $matches[2];
mp-wp_genesis 922 $dest = 'http://' . $dest;
mp-wp_genesis 923 $dest = clean_url($dest);
mp-wp_genesis 924 if ( empty($dest) )
mp-wp_genesis 925 return $matches[0];
mp-wp_genesis 926 // removed trailing [,;:] from URL
mp-wp_genesis 927 if ( in_array(substr($dest, -1), array('.', ',', ';', ':')) === true ) {
mp-wp_genesis 928 $ret = substr($dest, -1);
mp-wp_genesis 929 $dest = substr($dest, 0, strlen($dest)-1);
mp-wp_genesis 930 }
mp-wp_genesis 931 return $matches[1] . "<a href=\"$dest\" rel=\"nofollow\">$dest</a>" . $ret;
mp-wp_genesis 932 }
mp-wp_genesis 933
mp-wp_genesis 934 /**
mp-wp_genesis 935 * Callback to convert email address match to HTML A element.
mp-wp_genesis 936 *
mp-wp_genesis 937 * This function was backported from 2.5.0 to 2.3.2. Regex callback for {@link
mp-wp_genesis 938 * make_clickable()}.
mp-wp_genesis 939 *
mp-wp_genesis 940 * @since 2.3.2
mp-wp_genesis 941 * @access private
mp-wp_genesis 942 *
mp-wp_genesis 943 * @param array $matches Single Regex Match.
mp-wp_genesis 944 * @return string HTML A element with email address.
mp-wp_genesis 945 */
mp-wp_genesis 946 function _make_email_clickable_cb($matches) {
mp-wp_genesis 947 $email = $matches[2] . '@' . $matches[3];
mp-wp_genesis 948 return $matches[1] . "<a href=\"mailto:$email\">$email</a>";
mp-wp_genesis 949 }
mp-wp_genesis 950
mp-wp_genesis 951 /**
mp-wp_genesis 952 * Convert plaintext URI to HTML links.
mp-wp_genesis 953 *
mp-wp_genesis 954 * Converts URI, www and ftp, and email addresses. Finishes by fixing links
mp-wp_genesis 955 * within links.
mp-wp_genesis 956 *
mp-wp_genesis 957 * @since 0.71
mp-wp_genesis 958 *
mp-wp_genesis 959 * @param string $ret Content to convert URIs.
mp-wp_genesis 960 * @return string Content with converted URIs.
mp-wp_genesis 961 */
mp-wp_genesis 962 function make_clickable($ret) {
mp-wp_genesis 963 $ret = ' ' . $ret;
mp-wp_genesis 964 // in testing, using arrays here was found to be faster
mp-wp_genesis 965 $ret = preg_replace_callback('#([\s>])([\w]+?://[\w\\x80-\\xff\#$%&~/.\-;:=,?@\[\]+]*)#is', '_make_url_clickable_cb', $ret);
mp-wp_genesis 966 $ret = preg_replace_callback('#([\s>])((www|ftp)\.[\w\\x80-\\xff\#$%&~/.\-;:=,?@\[\]+]*)#is', '_make_web_ftp_clickable_cb', $ret);
mp-wp_genesis 967 $ret = preg_replace_callback('#([\s>])([.0-9a-z_+-]+)@(([0-9a-z-]+\.)+[0-9a-z]{2,})#i', '_make_email_clickable_cb', $ret);
mp-wp_genesis 968 // this one is not in an array because we need it to run last, for cleanup of accidental links within links
mp-wp_genesis 969 $ret = preg_replace("#(<a( [^>]+?>|>))<a [^>]+?>([^>]+?)</a></a>#i", "$1$3</a>", $ret);
mp-wp_genesis 970 $ret = trim($ret);
mp-wp_genesis 971 return $ret;
mp-wp_genesis 972 }
mp-wp_genesis 973
mp-wp_genesis 974 /**
mp-wp_genesis 975 * Adds rel nofollow string to all HTML A elements in content.
mp-wp_genesis 976 *
mp-wp_genesis 977 * @since 1.5.0
mp-wp_genesis 978 *
mp-wp_genesis 979 * @param string $text Content that may contain HTML A elements.
mp-wp_genesis 980 * @return string Converted content.
mp-wp_genesis 981 */
mp-wp_genesis 982 function wp_rel_nofollow( $text ) {
mp-wp_genesis 983 global $wpdb;
mp-wp_genesis 984 // This is a pre save filter, so text is already escaped.
mp-wp_genesis 985 $text = stripslashes($text);
mp-wp_genesis 986 $text = preg_replace_callback('|<a (.+?)>|i', 'wp_rel_nofollow_callback', $text);
mp-wp_genesis 987 $text = $wpdb->escape($text);
mp-wp_genesis 988 return $text;
mp-wp_genesis 989 }
mp-wp_genesis 990
mp-wp_genesis 991 /**
mp-wp_genesis 992 * Callback to used to add rel=nofollow string to HTML A element.
mp-wp_genesis 993 *
mp-wp_genesis 994 * Will remove already existing rel="nofollow" and rel='nofollow' from the
mp-wp_genesis 995 * string to prevent from invalidating (X)HTML.
mp-wp_genesis 996 *
mp-wp_genesis 997 * @since 2.3.0
mp-wp_genesis 998 *
mp-wp_genesis 999 * @param array $matches Single Match
mp-wp_genesis 1000 * @return string HTML A Element with rel nofollow.
mp-wp_genesis 1001 */
mp-wp_genesis 1002 function wp_rel_nofollow_callback( $matches ) {
mp-wp_genesis 1003 $text = $matches[1];
mp-wp_genesis 1004 $text = str_replace(array(' rel="nofollow"', " rel='nofollow'"), '', $text);
mp-wp_genesis 1005 return "<a $text rel=\"nofollow\">";
mp-wp_genesis 1006 }
mp-wp_genesis 1007
mp-wp_genesis 1008 /**
mp-wp_genesis 1009 * Convert text equivalent of smilies to images.
mp-wp_genesis 1010 *
mp-wp_genesis 1011 * Will only convert smilies if the option 'use_smilies' is true and the globals
mp-wp_genesis 1012 * used in the function aren't empty.
mp-wp_genesis 1013 *
mp-wp_genesis 1014 * @since 0.71
mp-wp_genesis 1015 * @uses $wp_smiliessearch, $wp_smiliesreplace Smiley replacement arrays.
mp-wp_genesis 1016 *
mp-wp_genesis 1017 * @param string $text Content to convert smilies from text.
mp-wp_genesis 1018 * @return string Converted content with text smilies replaced with images.
mp-wp_genesis 1019 */
mp-wp_genesis 1020 function convert_smilies($text) {
mp-wp_genesis 1021 global $wp_smiliessearch, $wp_smiliesreplace;
mp-wp_genesis 1022 $output = '';
mp-wp_genesis 1023 if ( get_option('use_smilies') && !empty($wp_smiliessearch) && !empty($wp_smiliesreplace) ) {
mp-wp_genesis 1024 // HTML loop taken from texturize function, could possible be consolidated
mp-wp_genesis 1025 $textarr = preg_split("/(<.*>)/U", $text, -1, PREG_SPLIT_DELIM_CAPTURE); // capture the tags as well as in between
mp-wp_genesis 1026 $stop = count($textarr);// loop stuff
mp-wp_genesis 1027 for ($i = 0; $i < $stop; $i++) {
mp-wp_genesis 1028 $content = $textarr[$i];
mp-wp_genesis 1029 if ((strlen($content) > 0) && ('<' != $content{0})) { // If it's not a tag
mp-wp_genesis 1030 $content = preg_replace($wp_smiliessearch, $wp_smiliesreplace, $content);
mp-wp_genesis 1031 }
mp-wp_genesis 1032 $output .= $content;
mp-wp_genesis 1033 }
mp-wp_genesis 1034 } else {
mp-wp_genesis 1035 // return default text.
mp-wp_genesis 1036 $output = $text;
mp-wp_genesis 1037 }
mp-wp_genesis 1038 return $output;
mp-wp_genesis 1039 }
mp-wp_genesis 1040
mp-wp_genesis 1041 /**
mp-wp_genesis 1042 * Checks to see if the text is a valid email address.
mp-wp_genesis 1043 *
mp-wp_genesis 1044 * @since 0.71
mp-wp_genesis 1045 *
mp-wp_genesis 1046 * @param string $user_email The email address to be checked.
mp-wp_genesis 1047 * @return bool Returns true if valid, otherwise false.
mp-wp_genesis 1048 */
mp-wp_genesis 1049 function is_email($user_email) {
mp-wp_genesis 1050 $chars = "/^([a-z0-9+_]|\\-|\\.)+@(([a-z0-9_]|\\-)+\\.)+[a-z]{2,6}\$/i";
mp-wp_genesis 1051 if (strpos($user_email, '@') !== false && strpos($user_email, '.') !== false) {
mp-wp_genesis 1052 if (preg_match($chars, $user_email)) {
mp-wp_genesis 1053 return true;
mp-wp_genesis 1054 } else {
mp-wp_genesis 1055 return false;
mp-wp_genesis 1056 }
mp-wp_genesis 1057 } else {
mp-wp_genesis 1058 return false;
mp-wp_genesis 1059 }
mp-wp_genesis 1060 }
mp-wp_genesis 1061
mp-wp_genesis 1062 /**
mp-wp_genesis 1063 * Convert to ASCII from email subjects.
mp-wp_genesis 1064 *
mp-wp_genesis 1065 * @since 1.2.0
mp-wp_genesis 1066 * @usedby wp_mail() handles charsets in email subjects
mp-wp_genesis 1067 *
mp-wp_genesis 1068 * @param string $string Subject line
mp-wp_genesis 1069 * @return string Converted string to ASCII
mp-wp_genesis 1070 */
mp-wp_genesis 1071 function wp_iso_descrambler($string) {
mp-wp_genesis 1072 /* this may only work with iso-8859-1, I'm afraid */
mp-wp_genesis 1073 if (!preg_match('#\=\?(.+)\?Q\?(.+)\?\=#i', $string, $matches)) {
mp-wp_genesis 1074 return $string;
mp-wp_genesis 1075 } else {
mp-wp_genesis 1076 $subject = str_replace('_', ' ', $matches[2]);
mp-wp_genesis 1077 /** @todo use preg_replace_callback() */
mp-wp_genesis 1078 $subject = preg_replace('#\=([0-9a-f]{2})#ei', "chr(hexdec(strtolower('$1')))", $subject);
mp-wp_genesis 1079 return $subject;
mp-wp_genesis 1080 }
mp-wp_genesis 1081 }
mp-wp_genesis 1082
mp-wp_genesis 1083 /**
mp-wp_genesis 1084 * Returns a date in the GMT equivalent.
mp-wp_genesis 1085 *
mp-wp_genesis 1086 * Requires and returns a date in the Y-m-d H:i:s format. Simply subtracts the
mp-wp_genesis 1087 * value of gmt_offset.
mp-wp_genesis 1088 *
mp-wp_genesis 1089 * @since 1.2.0
mp-wp_genesis 1090 *
mp-wp_genesis 1091 * @param string $string The date to be converted.
mp-wp_genesis 1092 * @return string GMT version of the date provided.
mp-wp_genesis 1093 */
mp-wp_genesis 1094 function get_gmt_from_date($string) {
mp-wp_genesis 1095 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);
mp-wp_genesis 1096 $string_time = gmmktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
mp-wp_genesis 1097 $string_gmt = gmdate('Y-m-d H:i:s', $string_time - get_option('gmt_offset') * 3600);
mp-wp_genesis 1098 return $string_gmt;
mp-wp_genesis 1099 }
mp-wp_genesis 1100
mp-wp_genesis 1101 /**
mp-wp_genesis 1102 * Converts a GMT date into the correct format for the blog.
mp-wp_genesis 1103 *
mp-wp_genesis 1104 * Requires and returns in the Y-m-d H:i:s format. Simply adds the value of
mp-wp_genesis 1105 * gmt_offset.
mp-wp_genesis 1106 *
mp-wp_genesis 1107 * @since 1.2.0
mp-wp_genesis 1108 *
mp-wp_genesis 1109 * @param string $string The date to be converted.
mp-wp_genesis 1110 * @return string Formatted date relative to the GMT offset.
mp-wp_genesis 1111 */
mp-wp_genesis 1112 function get_date_from_gmt($string) {
mp-wp_genesis 1113 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);
mp-wp_genesis 1114 $string_time = gmmktime($matches[4], $matches[5], $matches[6], $matches[2], $matches[3], $matches[1]);
mp-wp_genesis 1115 $string_localtime = gmdate('Y-m-d H:i:s', $string_time + get_option('gmt_offset')*3600);
mp-wp_genesis 1116 return $string_localtime;
mp-wp_genesis 1117 }
mp-wp_genesis 1118
mp-wp_genesis 1119 /**
mp-wp_genesis 1120 * Computes an offset in seconds from an iso8601 timezone.
mp-wp_genesis 1121 *
mp-wp_genesis 1122 * @since 1.5.0
mp-wp_genesis 1123 *
mp-wp_genesis 1124 * @param string $timezone Either 'Z' for 0 offset or 'hhmm'.
mp-wp_genesis 1125 * @return int|float The offset in seconds.
mp-wp_genesis 1126 */
mp-wp_genesis 1127 function iso8601_timezone_to_offset($timezone) {
mp-wp_genesis 1128 // $timezone is either 'Z' or '[+|-]hhmm'
mp-wp_genesis 1129 if ($timezone == 'Z') {
mp-wp_genesis 1130 $offset = 0;
mp-wp_genesis 1131 } else {
mp-wp_genesis 1132 $sign = (substr($timezone, 0, 1) == '+') ? 1 : -1;
mp-wp_genesis 1133 $hours = intval(substr($timezone, 1, 2));
mp-wp_genesis 1134 $minutes = intval(substr($timezone, 3, 4)) / 60;
mp-wp_genesis 1135 $offset = $sign * 3600 * ($hours + $minutes);
mp-wp_genesis 1136 }
mp-wp_genesis 1137 return $offset;
mp-wp_genesis 1138 }
mp-wp_genesis 1139
mp-wp_genesis 1140 /**
mp-wp_genesis 1141 * Converts an iso8601 date to MySQL DateTime format used by post_date[_gmt].
mp-wp_genesis 1142 *
mp-wp_genesis 1143 * @since 1.5.0
mp-wp_genesis 1144 *
mp-wp_genesis 1145 * @param string $date_string Date and time in ISO 8601 format {@link http://en.wikipedia.org/wiki/ISO_8601}.
mp-wp_genesis 1146 * @param string $timezone Optional. If set to GMT returns the time minus gmt_offset. Default is 'user'.
mp-wp_genesis 1147 * @return string The date and time in MySQL DateTime format - Y-m-d H:i:s.
mp-wp_genesis 1148 */
mp-wp_genesis 1149 function iso8601_to_datetime($date_string, $timezone = 'user') {
mp-wp_genesis 1150 $timezone = strtolower($timezone);
mp-wp_genesis 1151
mp-wp_genesis 1152 if ($timezone == 'gmt') {
mp-wp_genesis 1153
mp-wp_genesis 1154 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);
mp-wp_genesis 1155
mp-wp_genesis 1156 if (!empty($date_bits[7])) { // we have a timezone, so let's compute an offset
mp-wp_genesis 1157 $offset = iso8601_timezone_to_offset($date_bits[7]);
mp-wp_genesis 1158 } else { // we don't have a timezone, so we assume user local timezone (not server's!)
mp-wp_genesis 1159 $offset = 3600 * get_option('gmt_offset');
mp-wp_genesis 1160 }
mp-wp_genesis 1161
mp-wp_genesis 1162 $timestamp = gmmktime($date_bits[4], $date_bits[5], $date_bits[6], $date_bits[2], $date_bits[3], $date_bits[1]);
mp-wp_genesis 1163 $timestamp -= $offset;
mp-wp_genesis 1164
mp-wp_genesis 1165 return gmdate('Y-m-d H:i:s', $timestamp);
mp-wp_genesis 1166
mp-wp_genesis 1167 } else if ($timezone == 'user') {
mp-wp_genesis 1168 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);
mp-wp_genesis 1169 }
mp-wp_genesis 1170 }
mp-wp_genesis 1171
mp-wp_genesis 1172 /**
mp-wp_genesis 1173 * Adds a element attributes to open links in new windows.
mp-wp_genesis 1174 *
mp-wp_genesis 1175 * Comment text in popup windows should be filtered through this. Right now it's
mp-wp_genesis 1176 * a moderately dumb function, ideally it would detect whether a target or rel
mp-wp_genesis 1177 * attribute was already there and adjust its actions accordingly.
mp-wp_genesis 1178 *
mp-wp_genesis 1179 * @since 0.71
mp-wp_genesis 1180 *
mp-wp_genesis 1181 * @param string $text Content to replace links to open in a new window.
mp-wp_genesis 1182 * @return string Content that has filtered links.
mp-wp_genesis 1183 */
mp-wp_genesis 1184 function popuplinks($text) {
mp-wp_genesis 1185 $text = preg_replace('/<a (.+?)>/i', "<a $1 target='_blank' rel='external'>", $text);
mp-wp_genesis 1186 return $text;
mp-wp_genesis 1187 }
mp-wp_genesis 1188
mp-wp_genesis 1189 /**
mp-wp_genesis 1190 * Strips out all characters that are not allowable in an email.
mp-wp_genesis 1191 *
mp-wp_genesis 1192 * @since 1.5.0
mp-wp_genesis 1193 *
mp-wp_genesis 1194 * @param string $email Email address to filter.
mp-wp_genesis 1195 * @return string Filtered email address.
mp-wp_genesis 1196 */
mp-wp_genesis 1197 function sanitize_email($email) {
mp-wp_genesis 1198 return preg_replace('/[^a-z0-9+_.@-]/i', '', $email);
mp-wp_genesis 1199 }
mp-wp_genesis 1200
mp-wp_genesis 1201 /**
mp-wp_genesis 1202 * Determines the difference between two timestamps.
mp-wp_genesis 1203 *
mp-wp_genesis 1204 * The difference is returned in a human readable format such as "1 hour",
mp-wp_genesis 1205 * "5 mins", "2 days".
mp-wp_genesis 1206 *
mp-wp_genesis 1207 * @since 1.5.0
mp-wp_genesis 1208 *
mp-wp_genesis 1209 * @param int $from Unix timestamp from which the difference begins.
mp-wp_genesis 1210 * @param int $to Optional. Unix timestamp to end the time difference. Default becomes time() if not set.
mp-wp_genesis 1211 * @return string Human readable time difference.
mp-wp_genesis 1212 */
mp-wp_genesis 1213 function human_time_diff( $from, $to = '' ) {
mp-wp_genesis 1214 if ( empty($to) )
mp-wp_genesis 1215 $to = time();
mp-wp_genesis 1216 $diff = (int) abs($to - $from);
mp-wp_genesis 1217 if ($diff <= 3600) {
mp-wp_genesis 1218 $mins = round($diff / 60);
mp-wp_genesis 1219 if ($mins <= 1) {
mp-wp_genesis 1220 $mins = 1;
mp-wp_genesis 1221 }
mp-wp_genesis 1222 $since = sprintf(__ngettext('%s min', '%s mins', $mins), $mins);
mp-wp_genesis 1223 } else if (($diff <= 86400) && ($diff > 3600)) {
mp-wp_genesis 1224 $hours = round($diff / 3600);
mp-wp_genesis 1225 if ($hours <= 1) {
mp-wp_genesis 1226 $hours = 1;
mp-wp_genesis 1227 }
mp-wp_genesis 1228 $since = sprintf(__ngettext('%s hour', '%s hours', $hours), $hours);
mp-wp_genesis 1229 } elseif ($diff >= 86400) {
mp-wp_genesis 1230 $days = round($diff / 86400);
mp-wp_genesis 1231 if ($days <= 1) {
mp-wp_genesis 1232 $days = 1;
mp-wp_genesis 1233 }
mp-wp_genesis 1234 $since = sprintf(__ngettext('%s day', '%s days', $days), $days);
mp-wp_genesis 1235 }
mp-wp_genesis 1236 return $since;
mp-wp_genesis 1237 }
mp-wp_genesis 1238
mp-wp_genesis 1239 /**
mp-wp_genesis 1240 * Generates an excerpt from the content, if needed.
mp-wp_genesis 1241 *
mp-wp_genesis 1242 * The excerpt word amount will be 55 words and if the amount is greater than
mp-wp_genesis 1243 * that, then the string '[...]' will be appended to the excerpt. If the string
mp-wp_genesis 1244 * is less than 55 words, then the content will be returned as is.
mp-wp_genesis 1245 *
mp-wp_genesis 1246 * @since 1.5.0
mp-wp_genesis 1247 *
mp-wp_genesis 1248 * @param string $text The exerpt. If set to empty an excerpt is generated.
mp-wp_genesis 1249 * @return string The excerpt.
mp-wp_genesis 1250 */
mp-wp_genesis 1251 function wp_trim_excerpt($text) {
mp-wp_genesis 1252 if ( '' == $text ) {
mp-wp_genesis 1253 $text = get_the_content('');
mp-wp_genesis 1254
mp-wp_genesis 1255 $text = strip_shortcodes( $text );
mp-wp_genesis 1256
mp-wp_genesis 1257 $text = apply_filters('the_content', $text);
mp-wp_genesis 1258 $text = str_replace(']]>', ']]>', $text);
mp-wp_genesis 1259 $text = strip_tags($text);
mp-wp_genesis 1260 $excerpt_length = apply_filters('excerpt_length', 55);
mp-wp_genesis 1261 $words = explode(' ', $text, $excerpt_length + 1);
mp-wp_genesis 1262 if (count($words) > $excerpt_length) {
mp-wp_genesis 1263 array_pop($words);
mp-wp_genesis 1264 array_push($words, '[...]');
mp-wp_genesis 1265 $text = implode(' ', $words);
mp-wp_genesis 1266 }
mp-wp_genesis 1267 }
mp-wp_genesis 1268 return $text;
mp-wp_genesis 1269 }
mp-wp_genesis 1270
mp-wp_genesis 1271 /**
mp-wp_genesis 1272 * Converts named entities into numbered entities.
mp-wp_genesis 1273 *
mp-wp_genesis 1274 * @since 1.5.1
mp-wp_genesis 1275 *
mp-wp_genesis 1276 * @param string $text The text within which entities will be converted.
mp-wp_genesis 1277 * @return string Text with converted entities.
mp-wp_genesis 1278 */
mp-wp_genesis 1279 function ent2ncr($text) {
mp-wp_genesis 1280 $to_ncr = array(
mp-wp_genesis 1281 '"' => '"',
mp-wp_genesis 1282 '&' => '&',
mp-wp_genesis 1283 '⁄' => '/',
mp-wp_genesis 1284 '<' => '<',
mp-wp_genesis 1285 '>' => '>',
mp-wp_genesis 1286 '|' => '|',
mp-wp_genesis 1287 ' ' => ' ',
mp-wp_genesis 1288 '¡' => '¡',
mp-wp_genesis 1289 '¢' => '¢',
mp-wp_genesis 1290 '£' => '£',
mp-wp_genesis 1291 '¤' => '¤',
mp-wp_genesis 1292 '¥' => '¥',
mp-wp_genesis 1293 '¦' => '¦',
mp-wp_genesis 1294 '&brkbar;' => '¦',
mp-wp_genesis 1295 '§' => '§',
mp-wp_genesis 1296 '¨' => '¨',
mp-wp_genesis 1297 '¨' => '¨',
mp-wp_genesis 1298 '©' => '©',
mp-wp_genesis 1299 'ª' => 'ª',
mp-wp_genesis 1300 '«' => '«',
mp-wp_genesis 1301 '¬' => '¬',
mp-wp_genesis 1302 '­' => '­',
mp-wp_genesis 1303 '®' => '®',
mp-wp_genesis 1304 '¯' => '¯',
mp-wp_genesis 1305 '&hibar;' => '¯',
mp-wp_genesis 1306 '°' => '°',
mp-wp_genesis 1307 '±' => '±',
mp-wp_genesis 1308 '²' => '²',
mp-wp_genesis 1309 '³' => '³',
mp-wp_genesis 1310 '´' => '´',
mp-wp_genesis 1311 'µ' => 'µ',
mp-wp_genesis 1312 '¶' => '¶',
mp-wp_genesis 1313 '·' => '·',
mp-wp_genesis 1314 '¸' => '¸',
mp-wp_genesis 1315 '¹' => '¹',
mp-wp_genesis 1316 'º' => 'º',
mp-wp_genesis 1317 '»' => '»',
mp-wp_genesis 1318 '¼' => '¼',
mp-wp_genesis 1319 '½' => '½',
mp-wp_genesis 1320 '¾' => '¾',
mp-wp_genesis 1321 '¿' => '¿',
mp-wp_genesis 1322 'À' => 'À',
mp-wp_genesis 1323 'Á' => 'Á',
mp-wp_genesis 1324 'Â' => 'Â',
mp-wp_genesis 1325 'Ã' => 'Ã',
mp-wp_genesis 1326 'Ä' => 'Ä',
mp-wp_genesis 1327 'Å' => 'Å',
mp-wp_genesis 1328 'Æ' => 'Æ',
mp-wp_genesis 1329 'Ç' => 'Ç',
mp-wp_genesis 1330 'È' => 'È',
mp-wp_genesis 1331 'É' => 'É',
mp-wp_genesis 1332 'Ê' => 'Ê',
mp-wp_genesis 1333 'Ë' => 'Ë',
mp-wp_genesis 1334 'Ì' => 'Ì',
mp-wp_genesis 1335 'Í' => 'Í',
mp-wp_genesis 1336 'Î' => 'Î',
mp-wp_genesis 1337 'Ï' => 'Ï',
mp-wp_genesis 1338 'Ð' => 'Ð',
mp-wp_genesis 1339 'Ñ' => 'Ñ',
mp-wp_genesis 1340 'Ò' => 'Ò',
mp-wp_genesis 1341 'Ó' => 'Ó',
mp-wp_genesis 1342 'Ô' => 'Ô',
mp-wp_genesis 1343 'Õ' => 'Õ',
mp-wp_genesis 1344 'Ö' => 'Ö',
mp-wp_genesis 1345 '×' => '×',
mp-wp_genesis 1346 'Ø' => 'Ø',
mp-wp_genesis 1347 'Ù' => 'Ù',
mp-wp_genesis 1348 'Ú' => 'Ú',
mp-wp_genesis 1349 'Û' => 'Û',
mp-wp_genesis 1350 'Ü' => 'Ü',
mp-wp_genesis 1351 'Ý' => 'Ý',
mp-wp_genesis 1352 'Þ' => 'Þ',
mp-wp_genesis 1353 'ß' => 'ß',
mp-wp_genesis 1354 'à' => 'à',
mp-wp_genesis 1355 'á' => 'á',
mp-wp_genesis 1356 'â' => 'â',
mp-wp_genesis 1357 'ã' => 'ã',
mp-wp_genesis 1358 'ä' => 'ä',
mp-wp_genesis 1359 'å' => 'å',
mp-wp_genesis 1360 'æ' => 'æ',
mp-wp_genesis 1361 'ç' => 'ç',
mp-wp_genesis 1362 'è' => 'è',
mp-wp_genesis 1363 'é' => 'é',
mp-wp_genesis 1364 'ê' => 'ê',
mp-wp_genesis 1365 'ë' => 'ë',
mp-wp_genesis 1366 'ì' => 'ì',
mp-wp_genesis 1367 'í' => 'í',
mp-wp_genesis 1368 'î' => 'î',
mp-wp_genesis 1369 'ï' => 'ï',
mp-wp_genesis 1370 'ð' => 'ð',
mp-wp_genesis 1371 'ñ' => 'ñ',
mp-wp_genesis 1372 'ò' => 'ò',
mp-wp_genesis 1373 'ó' => 'ó',
mp-wp_genesis 1374 'ô' => 'ô',
mp-wp_genesis 1375 'õ' => 'õ',
mp-wp_genesis 1376 'ö' => 'ö',
mp-wp_genesis 1377 '÷' => '÷',
mp-wp_genesis 1378 'ø' => 'ø',
mp-wp_genesis 1379 'ù' => 'ù',
mp-wp_genesis 1380 'ú' => 'ú',
mp-wp_genesis 1381 'û' => 'û',
mp-wp_genesis 1382 'ü' => 'ü',
mp-wp_genesis 1383 'ý' => 'ý',
mp-wp_genesis 1384 'þ' => 'þ',
mp-wp_genesis 1385 'ÿ' => 'ÿ',
mp-wp_genesis 1386 'Œ' => 'Œ',
mp-wp_genesis 1387 'œ' => 'œ',
mp-wp_genesis 1388 'Š' => 'Š',
mp-wp_genesis 1389 'š' => 'š',
mp-wp_genesis 1390 'Ÿ' => 'Ÿ',
mp-wp_genesis 1391 'ƒ' => 'ƒ',
mp-wp_genesis 1392 'ˆ' => 'ˆ',
mp-wp_genesis 1393 '˜' => '˜',
mp-wp_genesis 1394 'Α' => 'Α',
mp-wp_genesis 1395 'Β' => 'Β',
mp-wp_genesis 1396 'Γ' => 'Γ',
mp-wp_genesis 1397 'Δ' => 'Δ',
mp-wp_genesis 1398 'Ε' => 'Ε',
mp-wp_genesis 1399 'Ζ' => 'Ζ',
mp-wp_genesis 1400 'Η' => 'Η',
mp-wp_genesis 1401 'Θ' => 'Θ',
mp-wp_genesis 1402 'Ι' => 'Ι',
mp-wp_genesis 1403 'Κ' => 'Κ',
mp-wp_genesis 1404 'Λ' => 'Λ',
mp-wp_genesis 1405 'Μ' => 'Μ',
mp-wp_genesis 1406 'Ν' => 'Ν',
mp-wp_genesis 1407 'Ξ' => 'Ξ',
mp-wp_genesis 1408 'Ο' => 'Ο',
mp-wp_genesis 1409 'Π' => 'Π',
mp-wp_genesis 1410 'Ρ' => 'Ρ',
mp-wp_genesis 1411 'Σ' => 'Σ',
mp-wp_genesis 1412 'Τ' => 'Τ',
mp-wp_genesis 1413 'Υ' => 'Υ',
mp-wp_genesis 1414 'Φ' => 'Φ',
mp-wp_genesis 1415 'Χ' => 'Χ',
mp-wp_genesis 1416 'Ψ' => 'Ψ',
mp-wp_genesis 1417 'Ω' => 'Ω',
mp-wp_genesis 1418 'α' => 'α',
mp-wp_genesis 1419 'β' => 'β',
mp-wp_genesis 1420 'γ' => 'γ',
mp-wp_genesis 1421 'δ' => 'δ',
mp-wp_genesis 1422 'ε' => 'ε',
mp-wp_genesis 1423 'ζ' => 'ζ',
mp-wp_genesis 1424 'η' => 'η',
mp-wp_genesis 1425 'θ' => 'θ',
mp-wp_genesis 1426 'ι' => 'ι',
mp-wp_genesis 1427 'κ' => 'κ',
mp-wp_genesis 1428 'λ' => 'λ',
mp-wp_genesis 1429 'μ' => 'μ',
mp-wp_genesis 1430 'ν' => 'ν',
mp-wp_genesis 1431 'ξ' => 'ξ',
mp-wp_genesis 1432 'ο' => 'ο',
mp-wp_genesis 1433 'π' => 'π',
mp-wp_genesis 1434 'ρ' => 'ρ',
mp-wp_genesis 1435 'ς' => 'ς',
mp-wp_genesis 1436 'σ' => 'σ',
mp-wp_genesis 1437 'τ' => 'τ',
mp-wp_genesis 1438 'υ' => 'υ',
mp-wp_genesis 1439 'φ' => 'φ',
mp-wp_genesis 1440 'χ' => 'χ',
mp-wp_genesis 1441 'ψ' => 'ψ',
mp-wp_genesis 1442 'ω' => 'ω',
mp-wp_genesis 1443 'ϑ' => 'ϑ',
mp-wp_genesis 1444 'ϒ' => 'ϒ',
mp-wp_genesis 1445 'ϖ' => 'ϖ',
mp-wp_genesis 1446 ' ' => ' ',
mp-wp_genesis 1447 ' ' => ' ',
mp-wp_genesis 1448 ' ' => ' ',
mp-wp_genesis 1449 '‌' => '‌',
mp-wp_genesis 1450 '‍' => '‍',
mp-wp_genesis 1451 '‎' => '‎',
mp-wp_genesis 1452 '‏' => '‏',
mp-wp_genesis 1453 '–' => '–',
mp-wp_genesis 1454 '—' => '—',
mp-wp_genesis 1455 '‘' => '‘',
mp-wp_genesis 1456 '’' => '’',
mp-wp_genesis 1457 '‚' => '‚',
mp-wp_genesis 1458 '“' => '“',
mp-wp_genesis 1459 '”' => '”',
mp-wp_genesis 1460 '„' => '„',
mp-wp_genesis 1461 '†' => '†',
mp-wp_genesis 1462 '‡' => '‡',
mp-wp_genesis 1463 '•' => '•',
mp-wp_genesis 1464 '…' => '…',
mp-wp_genesis 1465 '‰' => '‰',
mp-wp_genesis 1466 '′' => '′',
mp-wp_genesis 1467 '″' => '″',
mp-wp_genesis 1468 '‹' => '‹',
mp-wp_genesis 1469 '›' => '›',
mp-wp_genesis 1470 '‾' => '‾',
mp-wp_genesis 1471 '⁄' => '⁄',
mp-wp_genesis 1472 '€' => '€',
mp-wp_genesis 1473 'ℑ' => 'ℑ',
mp-wp_genesis 1474 '℘' => '℘',
mp-wp_genesis 1475 'ℜ' => 'ℜ',
mp-wp_genesis 1476 '™' => '™',
mp-wp_genesis 1477 'ℵ' => 'ℵ',
mp-wp_genesis 1478 '↵' => '↵',
mp-wp_genesis 1479 '⇐' => '⇐',
mp-wp_genesis 1480 '⇑' => '⇑',
mp-wp_genesis 1481 '⇒' => '⇒',
mp-wp_genesis 1482 '⇓' => '⇓',
mp-wp_genesis 1483 '⇔' => '⇔',
mp-wp_genesis 1484 '∀' => '∀',
mp-wp_genesis 1485 '∂' => '∂',
mp-wp_genesis 1486 '∃' => '∃',
mp-wp_genesis 1487 '∅' => '∅',
mp-wp_genesis 1488 '∇' => '∇',
mp-wp_genesis 1489 '∈' => '∈',
mp-wp_genesis 1490 '∉' => '∉',
mp-wp_genesis 1491 '∋' => '∋',
mp-wp_genesis 1492 '∏' => '∏',
mp-wp_genesis 1493 '∑' => '∑',
mp-wp_genesis 1494 '−' => '−',
mp-wp_genesis 1495 '∗' => '∗',
mp-wp_genesis 1496 '√' => '√',
mp-wp_genesis 1497 '∝' => '∝',
mp-wp_genesis 1498 '∞' => '∞',
mp-wp_genesis 1499 '∠' => '∠',
mp-wp_genesis 1500 '∧' => '∧',
mp-wp_genesis 1501 '∨' => '∨',
mp-wp_genesis 1502 '∩' => '∩',
mp-wp_genesis 1503 '∪' => '∪',
mp-wp_genesis 1504 '∫' => '∫',
mp-wp_genesis 1505 '∴' => '∴',
mp-wp_genesis 1506 '∼' => '∼',
mp-wp_genesis 1507 '≅' => '≅',
mp-wp_genesis 1508 '≈' => '≈',
mp-wp_genesis 1509 '≠' => '≠',
mp-wp_genesis 1510 '≡' => '≡',
mp-wp_genesis 1511 '≤' => '≤',
mp-wp_genesis 1512 '≥' => '≥',
mp-wp_genesis 1513 '⊂' => '⊂',
mp-wp_genesis 1514 '⊃' => '⊃',
mp-wp_genesis 1515 '⊄' => '⊄',
mp-wp_genesis 1516 '⊆' => '⊆',
mp-wp_genesis 1517 '⊇' => '⊇',
mp-wp_genesis 1518 '⊕' => '⊕',
mp-wp_genesis 1519 '⊗' => '⊗',
mp-wp_genesis 1520 '⊥' => '⊥',
mp-wp_genesis 1521 '⋅' => '⋅',
mp-wp_genesis 1522 '⌈' => '⌈',
mp-wp_genesis 1523 '⌉' => '⌉',
mp-wp_genesis 1524 '⌊' => '⌊',
mp-wp_genesis 1525 '⌋' => '⌋',
mp-wp_genesis 1526 '⟨' => '〈',
mp-wp_genesis 1527 '⟩' => '〉',
mp-wp_genesis 1528 '←' => '←',
mp-wp_genesis 1529 '↑' => '↑',
mp-wp_genesis 1530 '→' => '→',
mp-wp_genesis 1531 '↓' => '↓',
mp-wp_genesis 1532 '↔' => '↔',
mp-wp_genesis 1533 '◊' => '◊',
mp-wp_genesis 1534 '♠' => '♠',
mp-wp_genesis 1535 '♣' => '♣',
mp-wp_genesis 1536 '♥' => '♥',
mp-wp_genesis 1537 '♦' => '♦'
mp-wp_genesis 1538 );
mp-wp_genesis 1539
mp-wp_genesis 1540 return str_replace( array_keys($to_ncr), array_values($to_ncr), $text );
mp-wp_genesis 1541 }
mp-wp_genesis 1542
mp-wp_genesis 1543 /**
mp-wp_genesis 1544 * Formats text for the HTML editor.
mp-wp_genesis 1545 *
mp-wp_genesis 1546 * Unless $output is empty it will pass through htmlspecialchars before the
mp-wp_genesis 1547 * 'htmledit_pre' filter is applied.
mp-wp_genesis 1548 *
mp-wp_genesis 1549 * @since 2.5.0
mp-wp_genesis 1550 *
mp-wp_genesis 1551 * @param string $output The text to be formatted.
mp-wp_genesis 1552 * @return string Formatted text after filter applied.
mp-wp_genesis 1553 */
mp-wp_genesis 1554 function wp_htmledit_pre($output) {
mp-wp_genesis 1555 if ( !empty($output) )
mp-wp_genesis 1556 $output = htmlspecialchars($output, ENT_NOQUOTES); // convert only < > &
mp-wp_genesis 1557
mp-wp_genesis 1558 return apply_filters('htmledit_pre', $output);
mp-wp_genesis 1559 }
mp-wp_genesis 1560
mp-wp_genesis 1561 /**
mp-wp_genesis 1562 * Checks and cleans a URL.
mp-wp_genesis 1563 *
mp-wp_genesis 1564 * A number of characters are removed from the URL. If the URL is for displaying
mp-wp_genesis 1565 * (the default behaviour) amperstands are also replaced. The 'clean_url' filter
mp-wp_genesis 1566 * is applied to the returned cleaned URL.
mp-wp_genesis 1567 *
mp-wp_genesis 1568 * @since 1.2.0
mp-wp_genesis 1569 * @uses wp_kses_bad_protocol() To only permit protocols in the URL set
mp-wp_genesis 1570 * via $protocols or the common ones set in the function.
mp-wp_genesis 1571 *
mp-wp_genesis 1572 * @param string $url The URL to be cleaned.
mp-wp_genesis 1573 * @param array $protocols Optional. An array of acceptable protocols.
mp-wp_genesis 1574 * Defaults to 'http', 'https', 'ftp', 'ftps', 'mailto', 'news', 'irc', 'gopher', 'nntp', 'feed', 'telnet' if not set.
mp-wp_genesis 1575 * @param string $context Optional. How the URL will be used. Default is 'display'.
mp-wp_genesis 1576 * @return string The cleaned $url after the 'cleaned_url' filter is applied.
mp-wp_genesis 1577 */
mp-wp_genesis 1578 function clean_url( $url, $protocols = null, $context = 'display' ) {
mp-wp_genesis 1579 $original_url = $url;
mp-wp_genesis 1580
mp-wp_genesis 1581 if ('' == $url) return $url;
mp-wp_genesis 1582 $url = preg_replace('|[^a-z0-9-~+_.?#=!&;,/:%@$*\'()\\x80-\\xff]|i', '', $url);
mp-wp_genesis 1583 $strip = array('%0d', '%0a');
mp-wp_genesis 1584 $url = str_replace($strip, '', $url);
mp-wp_genesis 1585 $url = str_replace(';//', '://', $url);
mp-wp_genesis 1586 /* If the URL doesn't appear to contain a scheme, we
mp-wp_genesis 1587 * presume it needs http:// appended (unless a relative
mp-wp_genesis 1588 * link starting with / or a php file).
mp-wp_genesis 1589 */
mp-wp_genesis 1590 if ( strpos($url, ':') === false &&
mp-wp_genesis 1591 substr( $url, 0, 1 ) != '/' && !preg_match('/^[a-z0-9-]+?\.php/i', $url) )
mp-wp_genesis 1592 $url = 'http://' . $url;
mp-wp_genesis 1593
mp-wp_genesis 1594 // Replace ampersands and single quotes only when displaying.
mp-wp_genesis 1595 if ( 'display' == $context ) {
mp-wp_genesis 1596 $url = preg_replace('/&([^#])(?![a-z]{2,8};)/', '&$1', $url);
mp-wp_genesis 1597 $url = str_replace( "'", ''', $url );
mp-wp_genesis 1598 }
mp-wp_genesis 1599
mp-wp_genesis 1600 if ( !is_array($protocols) )
mp-wp_genesis 1601 $protocols = array('http', 'https', 'ftp', 'ftps', 'mailto', 'news', 'irc', 'gopher', 'nntp', 'feed', 'telnet');
mp-wp_genesis 1602 if ( wp_kses_bad_protocol( $url, $protocols ) != $url )
mp-wp_genesis 1603 return '';
mp-wp_genesis 1604
mp-wp_genesis 1605 return apply_filters('clean_url', $url, $original_url, $context);
mp-wp_genesis 1606 }
mp-wp_genesis 1607
mp-wp_genesis 1608 /**
mp-wp_genesis 1609 * Performs clean_url() for database usage.
mp-wp_genesis 1610 *
mp-wp_genesis 1611 * @see clean_url()
mp-wp_genesis 1612 *
mp-wp_genesis 1613 * @since 2.3.1
mp-wp_genesis 1614 *
mp-wp_genesis 1615 * @param string $url The URL to be cleaned.
mp-wp_genesis 1616 * @param array $protocols An array of acceptable protocols.
mp-wp_genesis 1617 * @return string The cleaned URL.
mp-wp_genesis 1618 */
mp-wp_genesis 1619 function sanitize_url( $url, $protocols = null ) {
mp-wp_genesis 1620 return clean_url( $url, $protocols, 'db' );
mp-wp_genesis 1621 }
mp-wp_genesis 1622
mp-wp_genesis 1623 /**
mp-wp_genesis 1624 * Convert entities, while preserving already-encoded entities.
mp-wp_genesis 1625 *
mp-wp_genesis 1626 * @link http://www.php.net/htmlentities Borrowed from the PHP Manual user notes.
mp-wp_genesis 1627 *
mp-wp_genesis 1628 * @since 1.2.2
mp-wp_genesis 1629 *
mp-wp_genesis 1630 * @param string $myHTML The text to be converted.
mp-wp_genesis 1631 * @return string Converted text.
mp-wp_genesis 1632 */
mp-wp_genesis 1633 function htmlentities2($myHTML) {
mp-wp_genesis 1634 $translation_table = get_html_translation_table( HTML_ENTITIES, ENT_QUOTES );
mp-wp_genesis 1635 $translation_table[chr(38)] = '&';
mp-wp_genesis 1636 return preg_replace( "/&(?![A-Za-z]{0,4}\w{2,3};|#[0-9]{2,3};)/", "&", strtr($myHTML, $translation_table) );
mp-wp_genesis 1637 }
mp-wp_genesis 1638
mp-wp_genesis 1639 /**
mp-wp_genesis 1640 * Escape single quotes, specialchar double quotes, and fix line endings.
mp-wp_genesis 1641 *
mp-wp_genesis 1642 * The filter 'js_escape' is also applied here.
mp-wp_genesis 1643 *
mp-wp_genesis 1644 * @since 2.0.4
mp-wp_genesis 1645 *
mp-wp_genesis 1646 * @param string $text The text to be escaped.
mp-wp_genesis 1647 * @return string Escaped text.
mp-wp_genesis 1648 */
mp-wp_genesis 1649 function js_escape($text) {
mp-wp_genesis 1650 $safe_text = wp_specialchars($text, 'double');
mp-wp_genesis 1651 $safe_text = preg_replace('/&#(x)?0*(?(1)27|39);?/i', "'", stripslashes($safe_text));
mp-wp_genesis 1652 $safe_text = preg_replace("/\r?\n/", "\\n", addslashes($safe_text));
mp-wp_genesis 1653 return apply_filters('js_escape', $safe_text, $text);
mp-wp_genesis 1654 }
mp-wp_genesis 1655
mp-wp_genesis 1656 /**
mp-wp_genesis 1657 * Escaping for HTML attributes.
mp-wp_genesis 1658 *
mp-wp_genesis 1659 * @since 2.0.6
mp-wp_genesis 1660 *
mp-wp_genesis 1661 * @param string $text
mp-wp_genesis 1662 * @return string
mp-wp_genesis 1663 */
mp-wp_genesis 1664 function attribute_escape($text) {
mp-wp_genesis 1665 $safe_text = wp_specialchars($text, true);
mp-wp_genesis 1666 return apply_filters('attribute_escape', $safe_text, $text);
mp-wp_genesis 1667 }
mp-wp_genesis 1668
mp-wp_genesis 1669 /**
mp-wp_genesis 1670 * Escape a HTML tag name.
mp-wp_genesis 1671 *
mp-wp_genesis 1672 * @since 2.5.0
mp-wp_genesis 1673 *
mp-wp_genesis 1674 * @param string $tag_name
mp-wp_genesis 1675 * @return string
mp-wp_genesis 1676 */
mp-wp_genesis 1677 function tag_escape($tag_name) {
mp-wp_genesis 1678 $safe_tag = strtolower( preg_replace('[^a-zA-Z_:]', '', $tag_name) );
mp-wp_genesis 1679 return apply_filters('tag_escape', $safe_tag, $tag_name);
mp-wp_genesis 1680 }
mp-wp_genesis 1681
mp-wp_genesis 1682 /**
mp-wp_genesis 1683 * Escapes text for SQL LIKE special characters % and _.
mp-wp_genesis 1684 *
mp-wp_genesis 1685 * @since 2.5.0
mp-wp_genesis 1686 *
mp-wp_genesis 1687 * @param string $text The text to be escaped.
mp-wp_genesis 1688 * @return string text, safe for inclusion in LIKE query.
mp-wp_genesis 1689 */
mp-wp_genesis 1690 function like_escape($text) {
mp-wp_genesis 1691 return str_replace(array("%", "_"), array("\\%", "\\_"), $text);
mp-wp_genesis 1692 }
mp-wp_genesis 1693
mp-wp_genesis 1694 /**
mp-wp_genesis 1695 * Convert full URL paths to absolute paths.
mp-wp_genesis 1696 *
mp-wp_genesis 1697 * Removes the http or https protocols and the domain. Keeps the path '/' at the
mp-wp_genesis 1698 * beginning, so it isn't a true relative link, but from the web root base.
mp-wp_genesis 1699 *
mp-wp_genesis 1700 * @since 2.1.0
mp-wp_genesis 1701 *
mp-wp_genesis 1702 * @param string $link Full URL path.
mp-wp_genesis 1703 * @return string Absolute path.
mp-wp_genesis 1704 */
mp-wp_genesis 1705 function wp_make_link_relative( $link ) {
mp-wp_genesis 1706 return preg_replace( '|https?://[^/]+(/.*)|i', '$1', $link );
mp-wp_genesis 1707 }
mp-wp_genesis 1708
mp-wp_genesis 1709 /**
mp-wp_genesis 1710 * Sanitises various option values based on the nature of the option.
mp-wp_genesis 1711 *
mp-wp_genesis 1712 * This is basically a switch statement which will pass $value through a number
mp-wp_genesis 1713 * of functions depending on the $option.
mp-wp_genesis 1714 *
mp-wp_genesis 1715 * @since 2.0.5
mp-wp_genesis 1716 *
mp-wp_genesis 1717 * @param string $option The name of the option.
mp-wp_genesis 1718 * @param string $value The unsanitised value.
mp-wp_genesis 1719 * @return string Sanitized value.
mp-wp_genesis 1720 */
mp-wp_genesis 1721 function sanitize_option($option, $value) {
mp-wp_genesis 1722
mp-wp_genesis 1723 switch ($option) {
mp-wp_genesis 1724 case 'admin_email':
mp-wp_genesis 1725 $value = sanitize_email($value);
mp-wp_genesis 1726 break;
mp-wp_genesis 1727
mp-wp_genesis 1728 case 'thumbnail_size_w':
mp-wp_genesis 1729 case 'thumbnail_size_h':
mp-wp_genesis 1730 case 'medium_size_w':
mp-wp_genesis 1731 case 'medium_size_h':
mp-wp_genesis 1732 case 'large_size_w':
mp-wp_genesis 1733 case 'large_size_h':
mp-wp_genesis 1734 case 'default_post_edit_rows':
mp-wp_genesis 1735 case 'mailserver_port':
mp-wp_genesis 1736 case 'comment_max_links':
mp-wp_genesis 1737 case 'page_on_front':
mp-wp_genesis 1738 case 'rss_excerpt_length':
mp-wp_genesis 1739 case 'default_category':
mp-wp_genesis 1740 case 'default_email_category':
mp-wp_genesis 1741 case 'default_link_category':
mp-wp_genesis 1742 case 'close_comments_days_old':
mp-wp_genesis 1743 case 'comments_per_page':
mp-wp_genesis 1744 case 'thread_comments_depth':
mp-wp_genesis 1745 $value = abs((int) $value);
mp-wp_genesis 1746 break;
mp-wp_genesis 1747
mp-wp_genesis 1748 case 'posts_per_page':
mp-wp_genesis 1749 case 'posts_per_rss':
mp-wp_genesis 1750 $value = (int) $value;
mp-wp_genesis 1751 if ( empty($value) ) $value = 1;
mp-wp_genesis 1752 if ( $value < -1 ) $value = abs($value);
mp-wp_genesis 1753 break;
mp-wp_genesis 1754
mp-wp_genesis 1755 case 'default_ping_status':
mp-wp_genesis 1756 case 'default_comment_status':
mp-wp_genesis 1757 // Options that if not there have 0 value but need to be something like "closed"
mp-wp_genesis 1758 if ( $value == '0' || $value == '')
mp-wp_genesis 1759 $value = 'closed';
mp-wp_genesis 1760 break;
mp-wp_genesis 1761
mp-wp_genesis 1762 case 'blogdescription':
mp-wp_genesis 1763 case 'blogname':
mp-wp_genesis 1764 $value = addslashes($value);
mp-wp_genesis 1765 $value = wp_filter_post_kses( $value ); // calls stripslashes then addslashes
mp-wp_genesis 1766 $value = stripslashes($value);
mp-wp_genesis 1767 $value = wp_specialchars( $value );
mp-wp_genesis 1768 break;
mp-wp_genesis 1769
mp-wp_genesis 1770 case 'blog_charset':
mp-wp_genesis 1771 $value = preg_replace('/[^a-zA-Z0-9_-]/', '', $value); // strips slashes
mp-wp_genesis 1772 break;
mp-wp_genesis 1773
mp-wp_genesis 1774 case 'date_format':
mp-wp_genesis 1775 case 'time_format':
mp-wp_genesis 1776 case 'mailserver_url':
mp-wp_genesis 1777 case 'mailserver_login':
mp-wp_genesis 1778 case 'mailserver_pass':
mp-wp_genesis 1779 case 'ping_sites':
mp-wp_genesis 1780 case 'upload_path':
mp-wp_genesis 1781 $value = strip_tags($value);
mp-wp_genesis 1782 $value = addslashes($value);
mp-wp_genesis 1783 $value = wp_filter_kses($value); // calls stripslashes then addslashes
mp-wp_genesis 1784 $value = stripslashes($value);
mp-wp_genesis 1785 break;
mp-wp_genesis 1786
mp-wp_genesis 1787 case 'gmt_offset':
mp-wp_genesis 1788 $value = preg_replace('/[^0-9:.-]/', '', $value); // strips slashes
mp-wp_genesis 1789 break;
mp-wp_genesis 1790
mp-wp_genesis 1791 case 'siteurl':
mp-wp_genesis 1792 case 'home':
mp-wp_genesis 1793 $value = stripslashes($value);
mp-wp_genesis 1794 $value = clean_url($value);
mp-wp_genesis 1795 break;
mp-wp_genesis 1796 default :
mp-wp_genesis 1797 $value = apply_filters("sanitize_option_{$option}", $value, $option);
mp-wp_genesis 1798 break;
mp-wp_genesis 1799 }
mp-wp_genesis 1800
mp-wp_genesis 1801 return $value;
mp-wp_genesis 1802 }
mp-wp_genesis 1803
mp-wp_genesis 1804 /**
mp-wp_genesis 1805 * Parses a string into variables to be stored in an array.
mp-wp_genesis 1806 *
mp-wp_genesis 1807 * Uses {@link http://www.php.net/parse_str parse_str()} and stripslashes if
mp-wp_genesis 1808 * {@link http://www.php.net/magic_quotes magic_quotes_gpc} is on.
mp-wp_genesis 1809 *
mp-wp_genesis 1810 * @since 2.2.1
mp-wp_genesis 1811 * @uses apply_filters() for the 'wp_parse_str' filter.
mp-wp_genesis 1812 *
mp-wp_genesis 1813 * @param string $string The string to be parsed.
mp-wp_genesis 1814 * @param array $array Variables will be stored in this array.
mp-wp_genesis 1815 */
mp-wp_genesis 1816 function wp_parse_str( $string, &$array ) {
mp-wp_genesis 1817 parse_str( $string, $array );
mp-wp_genesis 1818 if ( get_magic_quotes_gpc() )
mp-wp_genesis 1819 $array = stripslashes_deep( $array );
mp-wp_genesis 1820 $array = apply_filters( 'wp_parse_str', $array );
mp-wp_genesis 1821 }
mp-wp_genesis 1822
mp-wp_genesis 1823 /**
mp-wp_genesis 1824 * Convert lone less than signs.
mp-wp_genesis 1825 *
mp-wp_genesis 1826 * KSES already converts lone greater than signs.
mp-wp_genesis 1827 *
mp-wp_genesis 1828 * @uses wp_pre_kses_less_than_callback in the callback function.
mp-wp_genesis 1829 * @since 2.3.0
mp-wp_genesis 1830 *
mp-wp_genesis 1831 * @param string $text Text to be converted.
mp-wp_genesis 1832 * @return string Converted text.
mp-wp_genesis 1833 */
mp-wp_genesis 1834 function wp_pre_kses_less_than( $text ) {
mp-wp_genesis 1835 return preg_replace_callback('%<[^>]*?((?=<)|>|$)%', 'wp_pre_kses_less_than_callback', $text);
mp-wp_genesis 1836 }
mp-wp_genesis 1837
mp-wp_genesis 1838 /**
mp-wp_genesis 1839 * Callback function used by preg_replace.
mp-wp_genesis 1840 *
mp-wp_genesis 1841 * @uses wp_specialchars to format the $matches text.
mp-wp_genesis 1842 * @since 2.3.0
mp-wp_genesis 1843 *
mp-wp_genesis 1844 * @param array $matches Populated by matches to preg_replace.
mp-wp_genesis 1845 * @return string The text returned after wp_specialchars if needed.
mp-wp_genesis 1846 */
mp-wp_genesis 1847 function wp_pre_kses_less_than_callback( $matches ) {
mp-wp_genesis 1848 if ( false === strpos($matches[0], '>') )
mp-wp_genesis 1849 return wp_specialchars($matches[0]);
mp-wp_genesis 1850 return $matches[0];
mp-wp_genesis 1851 }
mp-wp_genesis 1852
mp-wp_genesis 1853 /**
mp-wp_genesis 1854 * WordPress implementation of PHP sprintf() with filters.
mp-wp_genesis 1855 *
mp-wp_genesis 1856 * @since 2.5.0
mp-wp_genesis 1857 * @link http://www.php.net/sprintf
mp-wp_genesis 1858 *
mp-wp_genesis 1859 * @param string $pattern The string which formatted args are inserted.
mp-wp_genesis 1860 * @param mixed $args,... Arguments to be formatted into the $pattern string.
mp-wp_genesis 1861 * @return string The formatted string.
mp-wp_genesis 1862 */
mp-wp_genesis 1863 function wp_sprintf( $pattern ) {
mp-wp_genesis 1864 $args = func_get_args( );
mp-wp_genesis 1865 $len = strlen($pattern);
mp-wp_genesis 1866 $start = 0;
mp-wp_genesis 1867 $result = '';
mp-wp_genesis 1868 $arg_index = 0;
mp-wp_genesis 1869 while ( $len > $start ) {
mp-wp_genesis 1870 // Last character: append and break
mp-wp_genesis 1871 if ( strlen($pattern) - 1 == $start ) {
mp-wp_genesis 1872 $result .= substr($pattern, -1);
mp-wp_genesis 1873 break;
mp-wp_genesis 1874 }
mp-wp_genesis 1875
mp-wp_genesis 1876 // Literal %: append and continue
mp-wp_genesis 1877 if ( substr($pattern, $start, 2) == '%%' ) {
mp-wp_genesis 1878 $start += 2;
mp-wp_genesis 1879 $result .= '%';
mp-wp_genesis 1880 continue;
mp-wp_genesis 1881 }
mp-wp_genesis 1882
mp-wp_genesis 1883 // Get fragment before next %
mp-wp_genesis 1884 $end = strpos($pattern, '%', $start + 1);
mp-wp_genesis 1885 if ( false === $end )
mp-wp_genesis 1886 $end = $len;
mp-wp_genesis 1887 $fragment = substr($pattern, $start, $end - $start);
mp-wp_genesis 1888
mp-wp_genesis 1889 // Fragment has a specifier
mp-wp_genesis 1890 if ( $pattern{$start} == '%' ) {
mp-wp_genesis 1891 // Find numbered arguments or take the next one in order
mp-wp_genesis 1892 if ( preg_match('/^%(\d+)\$/', $fragment, $matches) ) {
mp-wp_genesis 1893 $arg = isset($args[$matches[1]]) ? $args[$matches[1]] : '';
mp-wp_genesis 1894 $fragment = str_replace("%{$matches[1]}$", '%', $fragment);
mp-wp_genesis 1895 } else {
mp-wp_genesis 1896 ++$arg_index;
mp-wp_genesis 1897 $arg = isset($args[$arg_index]) ? $args[$arg_index] : '';
mp-wp_genesis 1898 }
mp-wp_genesis 1899
mp-wp_genesis 1900 // Apply filters OR sprintf
mp-wp_genesis 1901 $_fragment = apply_filters( 'wp_sprintf', $fragment, $arg );
mp-wp_genesis 1902 if ( $_fragment != $fragment )
mp-wp_genesis 1903 $fragment = $_fragment;
mp-wp_genesis 1904 else
mp-wp_genesis 1905 $fragment = sprintf($fragment, strval($arg) );
mp-wp_genesis 1906 }
mp-wp_genesis 1907
mp-wp_genesis 1908 // Append to result and move to next fragment
mp-wp_genesis 1909 $result .= $fragment;
mp-wp_genesis 1910 $start = $end;
mp-wp_genesis 1911 }
mp-wp_genesis 1912 return $result;
mp-wp_genesis 1913 }
mp-wp_genesis 1914
mp-wp_genesis 1915 /**
mp-wp_genesis 1916 * Localize list items before the rest of the content.
mp-wp_genesis 1917 *
mp-wp_genesis 1918 * The '%l' must be at the first characters can then contain the rest of the
mp-wp_genesis 1919 * content. The list items will have ', ', ', and', and ' and ' added depending
mp-wp_genesis 1920 * on the amount of list items in the $args parameter.
mp-wp_genesis 1921 *
mp-wp_genesis 1922 * @since 2.5.0
mp-wp_genesis 1923 *
mp-wp_genesis 1924 * @param string $pattern Content containing '%l' at the beginning.
mp-wp_genesis 1925 * @param array $args List items to prepend to the content and replace '%l'.
mp-wp_genesis 1926 * @return string Localized list items and rest of the content.
mp-wp_genesis 1927 */
mp-wp_genesis 1928 function wp_sprintf_l($pattern, $args) {
mp-wp_genesis 1929 // Not a match
mp-wp_genesis 1930 if ( substr($pattern, 0, 2) != '%l' )
mp-wp_genesis 1931 return $pattern;
mp-wp_genesis 1932
mp-wp_genesis 1933 // Nothing to work with
mp-wp_genesis 1934 if ( empty($args) )
mp-wp_genesis 1935 return '';
mp-wp_genesis 1936
mp-wp_genesis 1937 // Translate and filter the delimiter set (avoid ampersands and entities here)
mp-wp_genesis 1938 $l = apply_filters('wp_sprintf_l', array(
mp-wp_genesis 1939 'between' => _c(', |between list items'),
mp-wp_genesis 1940 'between_last_two' => _c(', and |between last two list items'),
mp-wp_genesis 1941 'between_only_two' => _c(' and |between only two list items'),
mp-wp_genesis 1942 ));
mp-wp_genesis 1943
mp-wp_genesis 1944 $args = (array) $args;
mp-wp_genesis 1945 $result = array_shift($args);
mp-wp_genesis 1946 if ( count($args) == 1 )
mp-wp_genesis 1947 $result .= $l['between_only_two'] . array_shift($args);
mp-wp_genesis 1948 // Loop when more than two args
mp-wp_genesis 1949 $i = count($args);
mp-wp_genesis 1950 while ( $i ) {
mp-wp_genesis 1951 $arg = array_shift($args);
mp-wp_genesis 1952 $i--;
mp-wp_genesis 1953 if ( $i == 1 )
mp-wp_genesis 1954 $result .= $l['between_last_two'] . $arg;
mp-wp_genesis 1955 else
mp-wp_genesis 1956 $result .= $l['between'] . $arg;
mp-wp_genesis 1957 }
mp-wp_genesis 1958 return $result . substr($pattern, 2);
mp-wp_genesis 1959 }
mp-wp_genesis 1960
mp-wp_genesis 1961 /**
mp-wp_genesis 1962 * Safely extracts not more than the first $count characters from html string.
mp-wp_genesis 1963 *
mp-wp_genesis 1964 * UTF-8, tags and entities safe prefix extraction. Entities inside will *NOT*
mp-wp_genesis 1965 * be counted as one character. For example & will be counted as 4, < as
mp-wp_genesis 1966 * 3, etc.
mp-wp_genesis 1967 *
mp-wp_genesis 1968 * @since 2.5.0
mp-wp_genesis 1969 *
mp-wp_genesis 1970 * @param integer $str String to get the excerpt from.
mp-wp_genesis 1971 * @param integer $count Maximum number of characters to take.
mp-wp_genesis 1972 * @return string The excerpt.
mp-wp_genesis 1973 */
mp-wp_genesis 1974 function wp_html_excerpt( $str, $count ) {
mp-wp_genesis 1975 $str = strip_tags( $str );
mp-wp_genesis 1976 $str = mb_strcut( $str, 0, $count );
mp-wp_genesis 1977 // remove part of an entity at the end
mp-wp_genesis 1978 $str = preg_replace( '/&[^;\s]{0,6}$/', '', $str );
mp-wp_genesis 1979 return $str;
mp-wp_genesis 1980 }
mp-wp_genesis 1981
mp-wp_genesis 1982 /**
mp-wp_genesis 1983 * Add a Base url to relative links in passed content.
mp-wp_genesis 1984 *
mp-wp_genesis 1985 * By default it supports the 'src' and 'href' attributes. However this can be
mp-wp_genesis 1986 * changed via the 3rd param.
mp-wp_genesis 1987 *
mp-wp_genesis 1988 * @since 2.7.0
mp-wp_genesis 1989 *
mp-wp_genesis 1990 * @param string $content String to search for links in.
mp-wp_genesis 1991 * @param string $base The base URL to prefix to links.
mp-wp_genesis 1992 * @param array $attrs The attributes which should be processed.
mp-wp_genesis 1993 * @return string The processed content.
mp-wp_genesis 1994 */
mp-wp_genesis 1995 function links_add_base_url( $content, $base, $attrs = array('src', 'href') ) {
mp-wp_genesis 1996 $attrs = implode('|', (array)$attrs);
mp-wp_genesis 1997 return preg_replace_callback("!($attrs)=(['\"])(.+?)\\2!i",
mp-wp_genesis 1998 create_function('$m', 'return _links_add_base($m, "' . $base . '");'),
mp-wp_genesis 1999 $content);
mp-wp_genesis 2000 }
mp-wp_genesis 2001
mp-wp_genesis 2002 /**
mp-wp_genesis 2003 * Callback to add a base url to relative links in passed content.
mp-wp_genesis 2004 *
mp-wp_genesis 2005 * @since 2.7.0
mp-wp_genesis 2006 * @access private
mp-wp_genesis 2007 *
mp-wp_genesis 2008 * @param string $m The matched link.
mp-wp_genesis 2009 * @param string $base The base URL to prefix to links.
mp-wp_genesis 2010 * @return string The processed link.
mp-wp_genesis 2011 */
mp-wp_genesis 2012 function _links_add_base($m, $base) {
mp-wp_genesis 2013 //1 = attribute name 2 = quotation mark 3 = URL
mp-wp_genesis 2014 return $m[1] . '=' . $m[2] .
mp-wp_genesis 2015 (strpos($m[3], 'http://') === false ?
mp-wp_genesis 2016 path_join($base, $m[3]) :
mp-wp_genesis 2017 $m[3])
mp-wp_genesis 2018 . $m[2];
mp-wp_genesis 2019 }
mp-wp_genesis 2020
mp-wp_genesis 2021 /**
mp-wp_genesis 2022 * Adds a Target attribute to all links in passed content.
mp-wp_genesis 2023 *
mp-wp_genesis 2024 * This function by default only applies to <a> tags, however this can be
mp-wp_genesis 2025 * modified by the 3rd param.
mp-wp_genesis 2026 *
mp-wp_genesis 2027 * <b>NOTE:</b> Any current target attributed will be striped and replaced.
mp-wp_genesis 2028 *
mp-wp_genesis 2029 * @since 2.7.0
mp-wp_genesis 2030 *
mp-wp_genesis 2031 * @param string $content String to search for links in.
mp-wp_genesis 2032 * @param string $target The Target to add to the links.
mp-wp_genesis 2033 * @param array $tags An array of tags to apply to.
mp-wp_genesis 2034 * @return string The processed content.
mp-wp_genesis 2035 */
mp-wp_genesis 2036 function links_add_target( $content, $target = '_blank', $tags = array('a') ) {
mp-wp_genesis 2037 $tags = implode('|', (array)$tags);
mp-wp_genesis 2038 return preg_replace_callback("!<($tags)(.+?)>!i",
mp-wp_genesis 2039 create_function('$m', 'return _links_add_target($m, "' . $target . '");'),
mp-wp_genesis 2040 $content);
mp-wp_genesis 2041 }
mp-wp_genesis 2042 /**
mp-wp_genesis 2043 * Callback to add a target attribute to all links in passed content.
mp-wp_genesis 2044 *
mp-wp_genesis 2045 * @since 2.7.0
mp-wp_genesis 2046 * @access private
mp-wp_genesis 2047 *
mp-wp_genesis 2048 * @param string $m The matched link.
mp-wp_genesis 2049 * @param string $target The Target to add to the links.
mp-wp_genesis 2050 * @return string The processed link.
mp-wp_genesis 2051 */
mp-wp_genesis 2052 function _links_add_target( $m, $target ) {
mp-wp_genesis 2053 $tag = $m[1];
mp-wp_genesis 2054 $link = preg_replace('|(target=[\'"](.*?)[\'"])|i', '', $m[2]);
mp-wp_genesis 2055 return '<' . $tag . $link . ' target="' . $target . '">';
mp-wp_genesis 2056 }
mp-wp_genesis 2057
mp-wp_genesis 2058 // normalize EOL characters and strip duplicate whitespace
mp-wp_genesis 2059 function normalize_whitespace( $str ) {
mp-wp_genesis 2060 $str = trim($str);
mp-wp_genesis 2061 $str = str_replace("\r", "\n", $str);
mp-wp_genesis 2062 $str = preg_replace( array( '/\n+/', '/[ \t]+/' ), array( "\n", ' ' ), $str );
mp-wp_genesis 2063 return $str;
mp-wp_genesis 2064 }
mp-wp_genesis 2065
mp-wp_genesis 2066 ?>