* @license GNU General Public License, version 2 (GPL-2.0) * * For full copyright and license information, please see * the docs/CREDITS.txt file. * */ namespace phpbb\textformatter\s9e; /** * Text manipulation utilities */ class utils implements \phpbb\textformatter\utils_interface { /** * Replace BBCodes and other formatting elements with whitespace * * NOTE: preserves smilies as text * * @param string $xml Parsed text * @return string Plain text */ public function clean_formatting($xml) { // Insert a space before and then remove formatting $xml = preg_replace('#<[es]>#', ' $0', $xml); return \s9e\TextFormatter\Utils::removeFormatting($xml); } /** * Return given string between quotes * * Will use either single- or double- quotes depending on whichever requires less escaping. * Quotes and backslashes are escaped with backslashes where necessary * * @param string $str Original string * @return string Escaped string within quotes */ protected function enquote($str) { $singleQuoted = "'" . addcslashes($str, "\\'") . "'"; $doubleQuoted = '"' . addcslashes($str, '\\"') . '"'; return (strlen($singleQuoted) < strlen($doubleQuoted)) ? $singleQuoted : $doubleQuoted; } /** * {@inheritdoc} */ public function generate_quote($text, array $attributes = array()) { $quote = '[quote'; if (isset($attributes['author'])) { // Add the author as the BBCode's default attribute $quote .= '=' . $this->enquote($attributes['author']); unset($attributes['author']); } foreach ($attributes as $name => $value) { $quote .= ' ' . $name . '=' . $this->enquote($value); } $quote .= ']' . $text . '[/quote]'; return $quote; } /** * Get a list of quote authors, limited to the outermost quotes * * @param string $xml Parsed text * @return string[] List of authors */ public function get_outermost_quote_authors($xml) { $authors = array(); if (strpos($xml, 'loadXML($xml); $xpath = new \DOMXPath($dom); foreach ($xpath->query('//QUOTE[not(ancestor::QUOTE)]/@author') as $author) { $authors[] = $author->textContent; } return $authors; } /** * Remove given BBCode and its content, at given nesting depth * * @param string $xml Parsed text * @param string $bbcode_name BBCode's name * @param integer $depth Minimum nesting depth (number of parents of the same name) * @return string Parsed text */ public function remove_bbcode($xml, $bbcode_name, $depth = 0) { return \s9e\TextFormatter\Utils::removeTag($xml, strtoupper($bbcode_name), $depth); } /** * Return a parsed text to its original form * * @param string $xml Parsed text * @return string Original plain text */ public function unparse($xml) { return \s9e\TextFormatter\Unparser::unparse($xml); } }