Подключение PHP файла в контенте с помощью [shortcode]

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

Оригинальный код принадлежит amberpanther.com, и, как оказалось, они также сделали из этого плагин.

//создаем шорткод [include], который принимает путь к файлу и query-строку
//эта функция была модифицирована из статьи на www.amberpanther.com, которую можно найти по ссылке ниже:
//http://www.amberpanther.com/knowledge-base/using-the-wordpress-shortcode-api-to-include-an-external-file-in-the-post-content/
//НАЧАЛО кода от amberpanther.com
function include_file($atts) {
     //если указан путь к файлу
     extract(
          shortcode_atts(
               array(
                    'filepath' => 'NULL'
               ), $atts
          )
     );

     //НАЧАЛО модифицированной части кода для поддержки query-строк
     //проверяем наличие query-строки переменных после пути к файлу
     if(strpos($filepath,"?")) {
          $query_string_pos = strpos($filepath,"?");
          //создаем глобальную переменную для query-строки, чтобы мы могли получить к ней доступ в подключаемых файлах, если нужно
          //также выделяем ее из чистого имени файла, которое сохраним в новой переменной для подключения
          global $query_string;
          $query_string = substr($filepath,$query_string_pos + 1);
          $clean_file_path = substr($filepath,0,$query_string_pos);     
          //если query-строка отсутствует
     } else {
          $clean_file_path = $filepath;
     }
     //КОНЕЦ модифицированной части кода

     //проверяем, указан ли путь к файлу и существует ли файл
     if ($filepath != 'NULL' && file_exists(get_stylesheet_directory_uri() . "/" . $clean_file_path)){
          //включаем буферизацию вывода для захвата вывода скрипта
          ob_start();
          //подключаем указанный файл
          include(TEMPLATEPATH.$clean_file_path);
          //присваиваем вывод файла переменной $content и очищаем буфер
          $content = ob_get_clean();
          //возвращаем $content
          //возврат важен для того, чтобы вывод появился в правильном месте
          //в контенте
          return $content;
     }
}
//регистрируем обработчик шорткода
add_shortcode('include', 'include_file');
//КОНЕЦ кода от amberpanther.com
//пример шорткода с query-строкой:
//[include filepath="/get-posts.php?format=grid&taxonomy=testing&term=stuff&posttype=work"]

Я настроил свой код на работу с URI стилей (чтобы он работал с дочерними темами и подобным), но вы можете легко изменить этот код для работы с любым другим местом (включая директории плагинов) или вообще удалить эту проверку и использовать полный путь при подключении файла. Вы даже можете добавить условие с триггерным символом в начале, который указывает на использование определенного пути в зависимости от первого символа имени файла, например, использование "#" для директории шаблона и т. д.

Я использую это для подключения файла get-posts.php, который находится в директории моего шаблона и форматирует вывод различных записей на основе ряда параметров, переданных в query-строке. Это избавляет меня от необходимости создавать специальные шаблоны, так как я могу подключить файл, передать ему формат, и он выведет записи с разметкой, указанной в файле get-posts.php.

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

Дайте мне знать, если вам что-то нужно уточнить.