Почему функция, привязанная к хуку the_content, «ломает» функцию the_excerpt()?

Question

[Мария]

В шаблоне страницы есть следующий кусок кода:

<div class="entry-content description clearfix">
				    <?php
					if ( is_singular() )
					    the_content(  );
					else
						the_excerpt();
					?>
			    </div>

Шаблон отвечает за вывод контента на странице как самой новости непосредственно (первая часть кода и the_content()), так и на странице категорий, авторов и тд. - the_excerpt(), соответственно.

Все работает правильно, но как только я пытаюсь к хуку the_content прицепить свою функцию для вывода дополнительной информации после текста новости, то "ломаются" страницы с категориями и авторами - на них выводится полный текст новости вместо except.

Код, который "ломает" все, выглядит следующим образом:

add_filter('the_content', 'myFunc');
function myFunc($content) {
	$content = $content . '<div>Some text</div>';
        echo $content;
}

Answer 1

[Денис Янчевский]

А так?

add_filter('the_content', 'myFunc');
function myFunc($content) {
    $content = $content . '<div>Some text</div>';
    return $content;
}

Comments

[Мария]

Работает! Спасибо большое! А можете в двух словах объяснить, почему так? А то я уже вроде давно занимаюсь, но до сих пор чуть подтормаживаю, когда заходит разговор о return

[Денис Янчевский]

Мария: использование фильтров в WordPress предполагает, что значение будет возвращено (это делает команда return), а не выведено на экран (это делает команда echo).
На WordCamp Moscow в 2015 году был доклад на тему хуков wordpress.tv/2015/08/20/igor-zinoviev-wordpress-ac... . Возможно, он поможет разобраться.