WordPress. Фильтруем HTML в записях и комментариях

dreamhelg — Wed, 13 Jan 2010 08:03:44 +0000

Я давно уже наблюдаю мучения читателей, которые пытаются оставить примеры html-разметки в комментариях. К сожалению, в прошлом году, долго не находилось времени, для решения этой проблемы. Но сегодня, с радостью хочу объявить о том, что проблема наконец-то решена – теперь вы можете использовать любую html-разметку в комментариях, предварительно заключив ее в теги

, а если вам интересно как это реализовано, то читайте далее.

Описание проблемы
HTML – это структурированный язык разметки, в котором текст заключается внутри тегов с угловыми скобками. Эти тэги сообщает браузеру, каким образом необходимо структурировать/отобразить информацию, содержащуюся между ними. Одни из самых распространенных тегов – это открывающий и закрывающий тег параграфа (, ); они сообщают браузеру, что текст, который находится внутри, является параграфом, в общей структуре документа.

Но что если, вы захотите показать читателям пример html-разметки?

Вы не сможете вывести тэги на экран, просто напечатав их, поскольку браузер решит, что это html-код и не отобразит их. Поэтому, для того чтобы вывести html-код, мы должны использовать специальные угловые скобки. Для вывода таких скобок используется их символьный объект –  специальный код, который выведет нужный символ. Этот код может быть как в форме имени, так и в форме числа, можно использовать то, что больше нравится. Например, прямые кавычки “ можно вывести двумя способами – используя объект-имя " или объект-число ".

Левую угловую скобку можно вывести с помощью < или <. В нашем примере, для вывода угловых скобок, мы будем использовать символьные объекты < и >.

Добавляем HTML-код в текст записи WordPress
Теперь, после того как мы разобрались, как отобразить HTML-код на экране, давайте разберемся как нам это использовать в записях WordPress. На первый взгляд все очень просто – нужно всего лишь заменить левые и правые угловые скобки в их символьные эквиваленты. Это хорошо пока у вас одна-две строчки кода, но что делать, если их значительно больше? Существуют различные плагины для решения этой проблемы, но большинство их них требуют дополнительной разметки в статье.

Поэтому я решил создать WordPress-фильтр, который будет находить определенные секции записи и автоматически конвертировать угловые скобки в их числовой эквивалент.

С помощью специального фильтра WordPress, мы сможем нормально отображать примеры html-кода в статьях и комментариях, внутри тегов .

Фильтры WordPress
Из Кодекса:

Фильтры – это функции, через которые WordPress пропускает данные, в определенные моменты исполнения, до того, как с ними будут произведены какие-то действия (такие как добавление в базу данных или отображение в окне браузера).

Итак, мы создадим специальный фильтр, который будет отыскивать контент, находящийся внутри тэгов , и конвертировать код, прежде чем отображать его на экране.

Специальный WordPress HTML фильтр
Вот так выглядит код фильтра:

[php]
)(.*?)
!ise', " '$1' .  stripslashes( str_replace(array('<','>'),array('<','>'),'$2') )  . '' ", $content_text);
    return $content_text;
    }

add_filter('the_content','mish_code_filter', 1, 1);
?>
[/php]

Теперь, давайте разберем код на части. Сначала мы создаем новую функцию, под названием “mish_code_filter”:

[php]
function mish_code_filter($content_text) {
    
    }
[/php]

Далее, мы описываем, что будет делать функция. В нашем примере, мы используем PHP-функцию preg_replace(), которая будет отыскивать текст внутри тэгов …

[php]
$content_text = preg_replace('!()(.*?)!ise',
[/php]

…и заменять их на зашифрованный текст:

[php]
" '$1' .  stripslashes( str_replace(array('<','>'),array('<','>'),'$2') )  . '' ",
[/php]

Вторая часть функции preg_replace(), использует две PHP-функции: stripslashes() и str_replace().

stripslashes() удаляет обратные слэши (\), которые добавляет WordPress, до того как вставляет запись в базу данных. Обычно, WordPress самостоятельно удаляет эти слэши, до того как вывести контент на экран, но поскольку наш фильтр инициализируется до того как данные будут отображены, эта функция обязательна.

str_replace() – ищет угловые скобки и заменяет их на символьные объекты.

$1 и $2 – это значения выражения, где $1 = () и $2 = (.*?).

Последняя часть функции возвращает значение (результат) функции, чтобы мы могли его использовать:

[php]
return $content_text;
[/php]

Теперь, нам нужно внедрить наш фильтр в WordPress, так, чтобы он срабатывал в определенное время. В нашем случае, мы внедрим фильтр, внутрь фильтра «the_content»:

[php]
add_filter('the_content','mish_code_filter', 1, 1);
[/php]

Фильтр “the_content”, как нетрудно догадаться, используется для фильтрации записей, после того, как они получены из базы данных и до того, как они выведены на экран. Поэтому, в нашем случае, мы сообщаем вордпрессу, о том, что наш фильтр (mish_code_filter) нужно использовать совместно с фильтром “the_content”.

Первая единица в годе, говорит WordPress, о том, что фильтр имеет высокий приоритет и должен быть выполнен раньше любых, других фильтров. Вторая единица говорит WordPress, о том, что мы передаем нашему фильтру только 1 параметр.

Установка Фильтра
Откройте ваш файл functions.php (расположен в папке с вашей темой), и вставьте туда следующий код:

[php]
)(.*?)!ise', " '$1' .  stripslashes( str_replace(array('<','>'),array('<','>'),'$2') )  . '' ", $content_text);
    return $content_text;
    }

add_filter('the_content','mish_code_filter', 1, 1);
?>
[/php]

Фильтр для Комментариев

Наш фильтр также можно использовать для фильтрации html, в тексте комментариев, для этого понадобятся совсем небольшие изменения. Первое, что нам нужно сделать – это заменить фильтр «the_content», на фильтр «comment_text», который выполняет ту же функцию, только для текста комментариев.

Ну и второе, необязательное изменение – теги

 мы заменим на теги , так как они чаще используются в тексте комментариев. В результате у нас получится вот такой фильтр:

[php]
function mish_code_filter($content_text) {
    $content_text = preg_replace('!()(.*?)!ise', " '$1' .  stripslashes( str_replace(array('<','>'),array('<','>'),'$2') )  . '' ", $content_text);
    return $content_text;
    }

add_filter('comment_text','mish_code_filter', 1, 1);
[/php]

Устанавливается он точно так же, как фильтр контента. Вот и все, можете проверить – наш фильтр работает.

Плагины с похожей функциональностью

	Raw HTML
	WP No Format
	Clean WordPress

Перевод статьи "Adding and Filtering Raw HTML in WordPress Posts", автор Martin

WordPress. Создаем запись только для подписчиков RSS

dreamhelg — Tue, 03 Nov 2009 07:30:41 +0000

Для поощрения своих постоянных читателей, владельцам блогов иногда нужно создавать записи только для своих RSS-подписчиков. В сегодняшней статье вы узнаете, как это сделать с помощью WordPress. Первое, что вам нужно сделать – это создать специальную рубрику, записи которой будут доступны только для RSS-подписчиков. Предположим, вы создали новую рубрику «Только по RSS». После создания рубрики, вам нужно будет узнать ее ID. Это определяется очень просто, зайдите на страницу редактирования рубрики, и ее ID отобразится в адресной строке браузера. Теперь, откройте файл вашей темы functions.php в любом редакторе. Если в вашей теме нет такого файла, создайте его. Добавьте следующий код в файл functions.php. [php] is_home | $query->is_archive ) $query->set('cat','-3'); return $query; } add_filter('pre_get_posts', 'excludeCategory'); ?> [/php] pre_get_post - это специальный фильтр WordPress, который запускается до получения записей из базы данных. С помощью этого фильтра, мы исключаем, указанную выше рубрику со всех страниц кроме RSS-ленты. Обратите внимание, что для исключения рубрики, используется знак минус, перед ID. Так что теперь, когда вы добавите запись в рубрику «Только по RSS», она не отобразится на главной странице, странице рубрики, в тегах или архивах; эта запись будет доступна только вашим RSS-подписчикам. И наконец, если вы используете в своей теме функцию wp_list_categories(), для отображения рубрик, вам необходимо передать параметр, исключающий нашу rss-рубрику из общего вывода. [php] wp_list_categories('exclude=3'); [/php] А если вдруг функция wp_list_categories, уже имеет какие-то параметры, то добавить еще один, можно с помощью знака &. [php] wp_list_categories('show_count=1&exclude=3'); [/php] Вот так довольно просто, можно создавать статьи только для читателей RSS-ленты. Если вы знаете еще какие-то способы реализации такой задачи, расскажите о них. Перевод статьи "Create Post Only For Your RSS Subscribers in WordPress"

WordPress. Обзор фреймворков

dreamhelg — Tue, 11 Aug 2009 04:18:31 +0000

WordPress-фреймворк это обычная WordPress-тема, разработанная в качестве гибкой основы, служащая родительской темой, для создания дочерней темы. Хотя еще не все оценили фреймворки по достоинству, они все равно приносят большую пользу [...]

Очередной блог фрилансера » filter

WordPress. Фильтруем HTML в записях и комментариях

Описание проблемы

Добавляем HTML-код в текст записи WordPress

Фильтры WordPress

Специальный WordPress HTML фильтр

Установка Фильтра

Фильтр для Комментариев

Плагины с похожей функциональностью

WordPress. Создаем запись только для подписчиков RSS

WordPress. Обзор фреймворков