0
306
2018-09-15

WordPress - Как вставить содержимое .html файла в страницу или запись

Часто для реализации трудных решений связанных с разработкой сайтов под управлением CMS WordPress необходимо применение верстки или же других элементов страницы в отдельном файле. Поговорим о данной реализации при помощи плагина include-me.
Понравилась страница? Поставь свою оценку!
PLUGIN_STAR_RATINGS.SCORE_TEXTPLUGIN_STAR_RATINGS.VOTES_TEXT

Вступление

Плагин Include Me поможет Вам подключить в записи или страницы сайта отдельные файлы, обычно разделяемые между разными страницами или записями, и содержащие PHP, HTML или иной код, который может быть испорчен визуальным редактором WordPress.

Загрузить плагин можно здесь:

https://ru.wordpress.org/plugins/include-me/

Правильное написание шорт кода плагина

На практике, и я в свое время отказался от использования данного плагина в связи с тем что при подключении отдельного файла WP издавал множество ошибок, а (найденные на просторах инета) решения (которые обязывали переписывать часть кода плагина) не совсем являлись адекватными. Ведь после очередного обновления все примененные настройки тупо слетят. Как оказалось все намного проще, в шорт коде плагина необходимо указывать путь к встраиваемому (отдельному) файлу без слеша в начале строки, то есть как указано ниже:

Пример вставки пути в шорт код плагина include-me :

[includeme file="wp-content/themes/Cool/_Apartment_Interactiv/ApartmentImageA.html"]

Именно без слеша в начале ссылки

Документация плагина:

Include Me - мощный плагин, который позволяет включать в контент сайта внешний HTML или PHP-файл или содержимое другой публикации / страницы. Когда вы включаете файлы PHP, они будут исполняться и подключаться в основной вывод, поэтому вы можете создавать независимые скрипты, которые могут быть доступны практически из любой части сайта.

Официальная страница документации плагина:

https://www.satollo.net/plugins/include-me

Пример №1

Вы хотите опубликовать отчет, сгенерированный некоторыми запросами в базе данных. Просто создайте такой скрипт и создайте для его вывода файл.html. Затем подключите данный файл на странице используя шорткод Include Me.

Пример №2

Вам нужна специальная страница с вашим виджетами Facebook Fan Page (которая состоит из Javascript). Просто создайте *.js файл с кодом виджета Facebook и подключите его в любом удобном для Вас месте при помощи Include Me шорт кода.

Включение может быть сделано и в IFRAME если потребуется создать элемент показывающий внешнюю веб страницу.

Основные методы применения плагина

В любом сообщении или странице вы можете использовать Include Me с коротким кодом:

[includeseme file="filename"]

где атрибут «file» содержит имя файла, которое должно быть включено. Любой текстовый файл может быть включен, и, если он является файлом PHP (с расширением «.php»), он будет выполнен и включен его вывод.

Имя файла может быть относительным (не начинаться с «/»), поэтому его будут искать, начиная с корневой папки блога (для техников ABSPATH будет добавлен в начале). Если имя файла является абсолютным (начиная с «/»), оно будет использоваться как есть (поэтому вы можете включать файлы, даже внешние из корневой папки сайта).

Подключение других записей или страниц

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

[includeseme post_id = "post id"]

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

Подключение iframe

Второй синтаксис доступен и вместо этого генерирует iframe для включения файла. Синтаксис iframe:

[includeseme src = "url"]

«url» — это сторонний веб-адрес. Любой другой атрибут, добавленный в короткий тег, будет использоваться как атрибут iframe. Например, если вы пишете:

[includeseme src = "http://www.example.com" frameborder = "0" width = "500"
height = "400"]

результат будет:

<iframe src = "http://www.example.com" frameborder = "0" width = "500" height = "400"> </ iframe>

Передача переменных

Если вы подключите скрипт PHP, он может получить доступ к атрибутам короткого кода, используя синтаксис $attrs['attribute name']. Например, вызов:

[includeseme file = "out.php" value = "Меня зовут Stefano"]

При содержимом файла out.php

<?php
echo $attrs['value'];
?>

Вывод будет, конечно:

«Меня зовут Стефано».

Таким образом, вы можете создать общий скрипт и сделать его доступным другим скриптам, используя атрибуты shortcode.

Я широко использовал этот плагин как в своих блогах, так и в сторонних проектах.