Меняем символы ХТМЛ (< >) на спецсимволы при комментировании

Недавно писал о том, как вставлять код в текст статьи. Сегодня хочу поделится способом удобной вставки кода в тело комментария.

Задача такая - в комментариях, найти теги <pre> и <code> и внутри них  заменить все символы < и > на соответствующие им спецсимволы: < и >. При такой замене важно определится, когда делать эту замену. К примеру, некоторые плагины делают такую замену во время генерации страницы, т.е. всегда при открытии страницы к каждому комментарию применяется функция преобразования и измененный комментарий выводится на экран, причем я еще не видел плагина, который бы делал такую замену перед публикацией комментария, т.е. чтобы код уже с замененными символами записывался в Базу Данных, а потом просто от туда извлекался, без каких либо преобразований. По моему это логичнее и не требует лишних операций при генерации страницы. Почему авторы плагинов не используют этот подход мне не понятно.

А теперь к делу. (см. обновление)

/* Преобразуем хтмл символы  < > в спецсимволы при отправке комментария */
function kama_html_replace_char_pre ($matches){
	$out = str_replace (array ('<'   ,'>'),	array ('&lt;','&gt;'),	$matches[2]	);
    return "<pre{$matches[1]}>".$out."</pre>";
}
function kama_html_replace_char_code ($matches){
	$out = str_replace (array ('<'   ,'>'),	array ('&lt;','&gt;'),	$matches[2]	);
    return "<code{$matches[1]}>".$out."</code>";
}
function kama_convert_html ($comment_text){ // подготавливает контент комментатора
	$comment_text = preg_replace_callback ('!<pre([^>]*)>(?:\r\n|\n|\r|)(.*?)(?:\r\n|\n|\r|)</pre>!ims', 'kama_html_replace_char_pre', $comment_text);
	$comment_text = preg_replace_callback ('!<code([^>]*)>(?:\r\n|\n|\r|)(.*?)(?:\r\n|\n|\r|)</code>!ims', 'kama_html_replace_char_code', $comment_text);
	return $comment_text;
}
add_filter ('pre_comment_content','kama_convert_html');

Эту функцию поместите в файл functions.php вашего шаблона (вашей темы).

Что делает функция?

При публикации комментария, функция находит текст внутри тегов <pre> и/или <code> и в найденном тексте заменяет символы < и > на < и >. Замена происходит перед тем, как текст комментария записывается в Базу Данных.

Как проверить что все работает правильно?

После того, как функция была успешно помещена в файл function.php, попробуем оставить комментарий с, к примеру, таким текстом:

Проверка преобразования символов в комментариях. <div></div>
<code>Здесь будет код <div> </code>
Первый промежуточный текст <span></span>
<pre>Здесь будет код 2 <span> </pre>
Промежуточный текст <strong></strong>
<code>Здесь будет еще немного кода <div> </code>
Еще немного простого текста <b></b>
<pre>Здесь будет код <span> </pre>
В заключении еще немного текста <div></div>

В результате в Базу Данных запишется следующий текст:

Проверка преобразования символов в комментариях. <div></div>
<code>Здесь будет код &lt;div&gt; </code>
Первый промежуточный текст <span></span>
<pre>Здесь будет код 2 &lt;span&gt; </pre>
Промежуточный текст <strong></strong>
<code>Здесь будет еще немного кода &lt;div&gt; </code>
Еще немного простого текста <b></b>
<pre>Здесь будет код &lt;span&gt; </pre>
В заключении еще немного текста <div></div>

Как видим, все изменения были проведены правильно.

Такой же трюк можно сделать и с контентом статьи. Для этого внизу функции допишите еще один фильтр:

...
add_filter ('pre_comment_content','kama_convert_html');
add_filter ('content_save_pre', 'kama_convert_html'); //При обновлении поста в админке

Обновление 19.04.2010

Придумал как записать короче. Функция работает так же, как и предыдущая.

<?php
/* Преобразуем хтмл символы  < > в спецсимволы при отправке комментария */
function kama_html_replace_char_code_pre ($matches){
	$out = str_replace (array ('<'   ,'>'),	array ('&lt;','&gt;'),	$matches[3]	);
    return "<{$matches[1]}{$matches[2]}>".$out."</{$matches[1]}>";
}
function kama_convert_html ($comment_text){ // подготавливает контент комментатора
	$comment_text = preg_replace_callback ('!<(pre|code)([^>]*)>(?:\r\n|\n|\r|)(.*?)(?:\r\n|\n|\r|)</\\1>!ims', 'kama_html_replace_char_code_pre', $comment_text);
	return $comment_text;
}
add_filter ('pre_comment_content','kama_convert_html');
 ?>