Для WordPress одним из решений для создания мультиязычного сайта является плагин PolyLang. Однако данный плагин не решает задачу локализации надписей/полей в шаблонах WordPress которые не являются полями страниц или записей, которые заполняются в административной части.

Знакомьтесь *.po и *.mo

Уверен что большинство разработчиков сталкивались с файлами с расширением *.po и *.mo — именно эти файлы и позволяют локализовать строки вашего сайта очень простым путем. Они содержат в себе инструкции в формате «ключ = значение», где ключ — идентификатор строки, а значение — ее перевод.

Если вы с ними не знакомы, то можете открыть папку wp-content/languages, или папку с языками вашей темы, которая может находится в папке с самой темой и познакомиться с ними поближе, открыв их, например, NotePad или любым другим текстовым редактором.

Обратите внимание: имя каждого файла состоит из названия плагина или темы (или любой другой идентификационной информации), а также кода языка, перевод которого содержит данный файл локализации. Таким образом для каждого языка создается по одному файлу *.po и *.mo.

Если вы откроете *.mo файл при помощи текстового редактора, то вы наверняка увидите абракадабру и ничего не поймете, ведь это и есть скомпилированный языковый файл для системы, который генерируется из файла *.po. Если проводить аналогию с редактированием изображений, то *.psd = *.po, а *.jpg = *.mo.

Файл *.po имеет уже более понятную структуру и можно разобраться в нем. Если разобрать данный файл, то вы увидите что строки идут парами «ключ-значение», о чем мы и говорили в начале статьи. Выглядит это примерно так:

#: views/start.php:59
msgid "Sign up with a different email address"
msgstr "Войти с другим адресом электронной почты"

Как видите символ «#«, как и в многих C-подобных языках программирования, обозначает комментарий, в котором в данном случае указан путь к файлу в котором была обнаружена строка с «msgid» (message ID — идентификатор сообщения). Далее следует значение для данного ключа с указанием «msgstr» (message string — строка сообщения), которую необходимо вывести в случае если в шаблоне встретится данный идентификатор.

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

Локализуем шаблон WordPress

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

load_theme_textdomain('your_translation_ID', 'path_to_mo_files');

где your_translation_ID — это идентификатор вашего перевода (можно занести название темы или плагина например), он будет использоваться далее при вызове строки перевода. А path_to_mo_files — естественно путь к вашим файлам локализации (*.mo и *.po).

По идее: в случае использования стандартной папки для переводов (т.к. параметр path_to_mo_files является необязательным) your_translation_ID используется как идентификатор файла, т.к. там расположены переводы разных плагинов и тем. То есть файл должен иметь имя your_translation_ID-en_GB.mo, например для стандартной темы файл называет так: twentysixteen-en_GB.mo.

Обратите внимание: по-умолчанию файлы хранятся в папке wp-content/languages и далее либо в папке themes или plugins. Также путь к файлам указывается БЕЗ слеша в конце. Для того чтобы указать путь к языкам, которые находятся в папке с темой можно использовать следующую конструкцию:

load_theme_textdomain('your_translation_ID', get_template_directory().'/languages');

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

_e("404 error", "your_translation_ID");

или

__("404 error", "your_translation_ID");

Данные строки и являются местами вызова локализационных файлов. Эти функции отличаются лишь тем, что одна (_e()) выводит строку на экран (выполняется функция php «echo»), а другая (__()) просто возвращает локализованую строку. Данные функции принимают два параметра: идентификатор строки (по которому будет идти поиск соответствующего msgid) и идентификатор перевода, откуда будет браться данная строка.

Теперь нам необходимо «пройтись» по всем файлам нашей темы или плагина и заменить все строки на подобные конструкции. После этого мы будем их парсить (просматривать программным обеспечением) и переводить строки, создавая файлы *.po и *.mo.

Создаем файл локализации *.po и *.mo

Для работы с файлами локализации шаблона на WordPress *.po *.mo понадобится программа Poedit, которая позволит работать с файлами переводов (*.po) и генерировать непосредственно файл, который использует WordPress (*.mo). Для примера, я создам файл test.php, который будет содержать два примера строк: с переменными и обычную, а идентификатором выступит ключ «nikita-spivak».

<p>Тут может быть любой текст или верстка<p>
<?php _e("This text will be shown", "nikita-spivak"); ?>
<p>Также он может быть тут</p>
<p><?php printf(__('See full lesson %s here %s', 'nikita-spivak'), '<a href="http://nikita-sp.com.ua">', '</a>'); ?>
или тут. Где угодно!</p>;

Теперь откроем программу Poedit и создадим новый файл (Файл — создать). Указываем язык, на который мы будем переводить строки, в нашем случае русский, и приступаем к настройке парсера. Для этого переходим во вкладку Каталог — Свойства. Заполняем всю информацию (по желанию) на первой вкладке «Свойства перевода», переходим к последней вкладке «Ключевые слова исходных файлов» и добавляем ключевые слова для парсера (__ и _e). Сохраняем файл в нужной нам директории шаблона или плагина.

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

• папки которые включены в поиск;
• исключенные папки, например, папки с css, js или sass файлами.

Используя кнопки добавления, редактирования и удаления элементов в списке добавляем нужные папки, после чего нажимаем «ОК» и нажимаем на кнопку «Обновить». Когда редактор скажет что нужно сохранить файл — соглашаемся и сохраняем файл. После сканирования папок вы увидите найденные в ваших файлах строки для перевода. Теперь остается их только перевести и снова сохранить в файл.

После сохранения файлов вы увидите, что в папке куда вы сохранили *.po файл будет сгенерирован также и файл с расширением *.mo. В случае если файл находится в папке с темой или плагином, название файла должно содержать только код языка, перевод которого содержится в файле, если же файл расположен в общей папке wp-content/languages то нужно перед кодом файла указать идентификатор перевода.

Если вам необходимо добавить новую строку в вашу тему или плагин, достаточно просто добавить ее в исходные файлы, открыть файл локализации *.po при помощи Poedit и нажать на кнопку «Обновить». Обратите внимание что структура папок должна оставаться той же! Если вы переместили файл(ы) — укажите новый путь в свойствах перевода.

Итог

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

Не забывайте ставить лайки или оценку голосованием звездами, чтобы показать насколько была полезна данная статья. Если возникли вопросы — пишите в комментариях.

Данный плагин является частично бесплатным — вы можете приобрести Premium версию, которая даст вам больше возможностей, среди прочих будет возможность использования шаблонов. Однако, ваш покорный слуга, нашел способ изменять шаблон вывода отзывов плагина WP Customer Reviews без приобретения лицензии.

Начнем, пожалуй, с того, что я не являюсь сторонником пиратства и с уважением отношусь к чужому труду, однако, по моему скромному мнению, уж если ты решился распространять модуль бесплатно — то дай возможность настроить его вид! Обрежь функционал, запрети добавлять дополнительные поля к отзывам, да что угодно, но дай возможность настроить вывод соответственно дизайну сайта.

Данная статья является ознакомительной и я настоятельно рекомендую приобретать лицензии на Premium версии плагина WP Customer Reviews.

Итак, вышло обновление плагина WP Customer Reviews и в новой (3.x) версии почему-то внезапно настройка внешнего вида попала под Premium лицензию, хотя в предыдущих версиях 2.x настроить вывод отзывов данного плагина было можно, изменяя файлы в директории самого дополнения (wp-content/plugins/wp-customer-reviews).

Шаблон WP Customer Reviews 3.x

Чтобы изменить вид отзывов в плагине WP Cusomer Reviews 3.x, придется модифицировать и исполнимые файлы модуля, чтобы заставить его использовать шаблоны в соответствующей папке wp-content/plugins/wp-customer-reviews/include/templates. Сами шаблоны для бесплатной лицензии хранятся в базе данных в таблице wp_options с ключом option_name = wpcr3_options, и выглядят как показано на рис. 1. Но хранение и редактирование шаблона в БД, в моем понимании, крайняя степень мазохизма.

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

В связи с этим я решил разобраться, как же все-таки работает данный механизм, и оказалось все предельно просто: в плагине используется шаблонизатор именуемый Goatee, который и подставляет все переменные в HTML, который передается в виде аргумента функции.

wpcr_Goatee::fill($this->options['templates']['frontend_review_item'], $data)

Таким образом, в функцию передается HTML шаблон из базы данных, а также данные из массива $data. Наша же с вами задача просто заменить источник HTML кода с базы данных на файл шаблона.

Используем шаблон WP Customer Reviews

Для того чтобы использовать непосредственно файлы шаблонов, которые расположены в директории самого плагина в папке include/templates, нам необходимо установить источник HTML кода, передаваемого в функцию wpcr_Goatee::fill на эти файлы. Для этого ищем строчки, содержащие следующий код:

wpcr_Goatee::fill($this->options['templates']

Таких строчек мы должны найти 9 штук. И каждую из них необходимо модифицировать путем замены переменной $this->options[‘templates’][‘TEMPLATE_NAME’] на file_get_contents($this->getplugindir() . ‘include/templates/TEMPLATE_NAME.html’). Таким образом из строчки:

wpcr_Goatee::fill($this->options['templates']['frontend_review_pagination'], $pagination);

мы получаем:

wpcr_Goatee::fill(file_get_contents($this->getplugindir() . 'include/templates/frontend_review_pagination.html'), $pagination);

И так далее все девять строчек, где встречается wpcr_Goatee::fill($this->options[‘templates’]. Таким образом мы заменяем HTML из базы данных HTML-кодом из файлов. Также вы можете использовать любой другой файл, который вам удобно — вы можете вынести эти файлы в папку вашей темы WordPress и хранить их там, чтобы предотвратить из перезапись.

Итог

Теперь вы можете редактировать HTML-код в файлах, хранящихся в папке шаблонов include/templates и внешний вид ваших отзывов будет изменен согласно вашим правкам. Но не забудьте, что данная модификация будет работать до следующего обновления плагина WP Customer Reviews, когда файлы перезапишутся (а карета превратится обратно в тыкву )!

Вот таким простым способом вы можете настроить вид отзывов на WordPress сайте, использующем плагин WP Customer Reviews. Лично я считаю что такая возможность как изменение внешнего вида плагина не должна попадать под список «привилегированных функций» для Premium лицензии, поэтому собственно и решил поделиться этой маленькой инструкцией. А что думаете вы по этому поводу?

Данный плагин очень удобный и имеет достаточно настроек, но к сожалению, в нем отсутствует опция блокирования всего контента страницы/статьи, о чем и пойдет речь.

OnePress Social Locker — это один из популярных бесплатных (если не единственный бесплатный) социальных локеров контента для WordPress. Он позволяет блокировать определенный контент на странице при помощи shortcode (шорткодов/тегов, см. изображение). Вы можете создать несколько типов блокировки (текст, оформление блокирующего блока) и использовать для разных кусков контента. Например:

1. Чтобы скачать с сайта — создадим блокировщик с текстом «Ссылка скрыта, подпишитесь на группу чтобы скачать» и ссылка на группу;
2. Чтобы просмотреть отдельную часть статьи — создадим блокировщик с текстом «Контент защищен, поставьте лайк чтобы увидеть» и кнопочки для лайков;

Также, плагин позволяет автоматически закрыть нужный контент в уже существующих записях: вы можете закрыть весь контент или только часть статьи, используя следующие правила:

• количество абзацев после которых дальнейший контент будет заблокирован;
• скрывать контент после тега «Далее» (<!— more —>);

и еще множество других. Но! Если мы скроем контент таким образом, то при необходимости убрать блокировку необходимо будет перелопатить потом вручную все записи, удаляя шорткод. Чтобы не прибегать к такому неудобному способу, было разработано следующее решение: заменить в файле single.php стандартный вывод контента на следующий код:

	 	 
$content = get_the_content();
$content = apply_filters('the_content', $content);
echo do_shortcode('[sociallocker]'.$content.'[/sociallocker]');

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

Создание темы для WordPress’a достаточно простая задача, ведь принцип работы WordPress достаточно простой и ясный: присутствуют сущности (post и page), и соответственно циклы для вывода ленты постов. Дальше — дело вашей фантазии. И я никогда не понимал людей, которые используют чужие шаблоны и имеют много неудобств с этим, ведь проще сделать самому!

Структура и основные файлы шаблона

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

Как видно на схеме, представленной в предыдущей статье, существует 7 основных типов вывода контента:

1. страница архива;
2. одиночная запись;
3. главная страница;
4. главная страница блога;
5. всплывающие комментарии;
6. страница 404 ошибки;
7. страница поиска.

Все эти типы страниц могут иметь свой вывод (шаблон) согласно иерархии шаблонов WordPress, и основным файлом (шаблоном) темы является файл index.php, к которому будет произведено обращение, в случае отсутствия иных файлов в теме, или будет использован стандартный вывод (шаблон): если к примеру у вас нет в файлах темы шаблона для вывода комментариев (comments.php), то будет использован шаблон по-умолчанию, встроенный в WordPress.

Каждый шаблон в WordPress имеет свое название, описание, имя автора, версию и иные параметры, которые выводятся в административной части и указываются во втором по значению файле style.css, который, если не ошибаюсь, автоматически подключается при его наличии в папке с темой.

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

/*

Theme Name: Nikita_Sp Blog
Theme URI: http://nikita-sp.com.ua/
Description: Nikita_Sp Blog Theme
Author: Nikita_Sp
Author URI: http://nikita-sp.com.ua
*/

Как видно на изображении, в моих данных не указана версия шаблона, и выводится только надпись «версия». Также я не писал описание и прочие данные, которые вы можете добавить к данным темы, т.к. они мне не особо нужны. Ниже представлен полный список данных, которые вы можете использовать при описании темы:

/*

Theme Name: Имя вашего шаблона
Theme URI: http://адрес-где-можно-ознакомиться.com/скачать-тему.html
Author: Собственно Автор
Author URI: http://адрес-автора.com
Description: Тут описание.
Version: 1.0
License: GNU General Public License v2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Tags: black, brown, orange, tan, white, yellow, light, one-column, two-columns, right-sidebar, flexible-width, custom-header, custom-menu, editor-style, featured-images, microformats, post-formats, rtl-language-support, sticky-post, translation-ready
Text Domain: twentythirteen

This theme, like WordPress, is licensed under the GPL.
Use it to make something cool, have fun, and share what you've learned with others.

*/

Таким образом, имея минимум два файла index.php и style.css, мы можем смело заявить о созданном WordPress шаблоне. Однако на этом мы не можем останавливаться, т.к. нам нужен очень красивый шаблон, который будет хоть как-то кастомизирован под нас.

Второстепенные файлы WordPress шаблона

Следующим этапом необходимо выделить следующие блоки нашей темы:

• comments.php
• comments-popup.php
• footer.php
• header.php
• sidebar.php

Разбор начнем, как и положено с нашей «шапки», т.е. с файла header.php. В данном файле вы создаете «шапку» сайта, т.е. начинаете свой документ. У данного файла есть определенные «правила хорошего тона»:

• Открывающий тег <html> должен содержать вызов функции language_attributes().
• Тег кодировки <meta> должен находится перед остальными тегами, включая тег <title>.
• Вызывайте функцию bloginfo() чтобы вывести <meta> теги кодировки и описаний.
• Используйте wp_title() чтобы установить заголовок <title>.
• Вызывайте get_stylesheet_uri() чтобы подключить файл style.css текущей темы.
• Добавьте вызов wp_head() перед закрывающимся тегом </head>, для того чтобы плагины могли подключать свои стили, скрипты и т.п.

Пример простого файла header.php приведен ниже:

<!DOCTYPE html>
<html <?php language_attributes(); ?>>
    <head>
        <meta charset="<?php bloginfo( 'charset' ); ?>" />
        <title><?php wp_title(); ?></title>
        <link rel="profile" href="http://gmpg.org/xfn/11" />
        <link rel="stylesheet" href="<?php echo get_stylesheet_uri(); ?>" type="text/css" media="screen" />
        <link rel="pingback" href="<?php bloginfo( 'pingback_url' ); ?>" />
        <?php if ( is_singular() && get_option( 'thread_comments' ) ) wp_enqueue_script( 'comment-reply' ); ?>
        <?php wp_head(); ?>
    </head>
    <body>

Также сюда добавляете начало вашего сайта, а именно основной контейнер, «шапочку», верхнее меню и любой другой контент, который вы считаете необходимым.

Для вызова файла header.php в (давайте их назовем, «теловых») файлах, файлах, которые выводят непосредственно сам контент страницы, вам необходимо использовать функцию get_header().

В файле footer.php также нет ничего сложного, тут мы закрываем все наши открытые контейнеры в файле header.php и добавляем вызов <?php wp_footer(); ?> для вывода администраторского меню при посещении сайта в соответствующем статусе, для работы плагинов и пр.

Пример простого кода файла footer.php приведен ниже:

<?php wp_footer(); ?>
</body>
</html>

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

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

Внимание! Для того чтобы пользоваться динамическим сайдбаром его необходимо еще зарегистрировать в файле functions.php!

Ниже вы можете ознакомиться с примером кода файла шаблона сайдбара с пояснениями:

<aside class="sidebar" role="complementary">
<?php if(!function_exists('dynamic_sidebar') || !dynamic_sidebar('sidebar')){ ?>
<p>Тут контент, на случай если мы не добавили виджетов в наш сайдбар или просто пустота</p>
<?php } ?>
</aside>

Сайдбар подключается также как и файлы header.php и footer.php с помощью функции get_sidebar(). в каждом файле, где это необходимо. Регистрацию динамического сайдбара и подключение разных сайдбаров на разные страницы мы рассмотрим в следующей статье.

Теперь у нас есть вполне себе полноценный каркас нашего будущего шаблона под WordPress и мы смело можем приступать к верстке основных частей нашего сайта — шапки и футера. Дальше — интересней, подписывайтесь и следите за новыми статьями!

Одними из популярных мест для размещения рекламных блоков является шапка сайта (начало статьи, страницы), но разместить там код рекламного баннера достаточно просто, а как разместить код того же Google Adsense в тексте записи сайта на WordPress без плагинов?

Итак, для того чтобы разместить код рекламного блока Google Adsense или других рекламных площадок, вам необходимо будет отредактировать файл functions.php в папке с вашей темой.

Добавим в код вашего файла (можно в конец файла) следующую функцию:

function prefix_insert_after_paragraph( $insertion, $paragraph_id, $content ) {
	$closing_p = '</p>';
	$paragraphs = explode( $closing_p, $content ); // разбиваем текст статьи по параграфам
	foreach ($paragraphs as $index => $paragraph) { // пробегаемся по параграфам
		if ( trim( $paragraph ) ) {
			$paragraphs[$index] .= $closing_p; // добавляем вырезанные на 3 строке закрывающие теги параграфа
		}
		if ( $paragraph_id == $index + 1 ) { // если номер текущего параграфа = номеру требуемого - добавляем код блока
			$paragraphs[$index] .= $insertion;
		}
	}

	return implode( '', $paragraphs ); // совмещаем все параграфы вместе и отдаем
}

Данная функция позволяет разбивать текст ($content) ваших записей/постов блога на блоки по параграфам и вставляет после определенного номера ($paragraph_id) параграфа код, передаваемый в функцию в переменной $insertion.

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

add_filter( 'the_content', 'prefix_insert_post_ads' ); // Добавляем обработку текста статьи
function prefix_insert_post_ads( $content ) { // В функцию передаем текст статьи
	$ad_code = 'Тут код вашего рекламного блока'; // Указываем код рекламного блока для вставки
	if ( is_single() && ! is_admin() ) { // вызываем функцию для одиночной записи и не вызываем функцию если мы в администраторской панели
		return prefix_insert_after_paragraph( $ad_code, 2, $content ); // Если были соблюдены все правила возвращаем обработанный функцией исходный код статьи уже с кодом рекламного блока
		// передаются параметры: код рекламного блока, номер параграфа, после которого будет блок размещен, контент
	}
	return $content; // в противном случае возвращаем просто текст статьи
}

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

add_filter( 'the_content', 'prefix_insert_post_ads' );
function prefix_insert_post_ads( $content ) {
	$ad_code = 'Тут код вашего рекламного блока';
	if ( is_single() && ! is_admin() ) {
		$closing_p = '</p>';
		$paragraphs = explode( $closing_p, $content );
		foreach ($paragraphs as $index => $paragraph) {
			if ( trim( $paragraph ) ) {
				$paragraphs[$index] .= $closing_p;
			}
			if ( X == ($index + 1) ) { // X = номер параграфа
				$paragraphs[$index] .= $ad_code;
			}
		}
		return implode( '', $paragraphs ); // совмещаем все параграфы вместе и отдаем
	}
	return $content;
}

Если вы хотите добавить несколько рекламных баннеров в текст вашей статьи, то вам необходимо добавить просто еще одно условие, например такое:

add_filter( 'the_content', 'prefix_insert_post_ads' );
function prefix_insert_post_ads( $content ) {
	$ad_code = 'Тут код вашего рекламного блока';
	/* Добавляем второй рекламный блок */
	$ad_code = 'Тут код вашего второго рекламного блока';
	/* Добавили второй рекламный блок */
	if ( is_single() && ! is_admin() ) {
		$closing_p = '</p>';
		$paragraphs = explode( $closing_p, $content );
		foreach ($paragraphs as $index => $paragraph) {
			if ( trim( $paragraph ) ) {
				$paragraphs[$index] .= $closing_p;
			}
			if ( X == ($index + 1) ) { // X = номер параграфа
				$paragraphs[$index] .= $ad_code;
			}
			/* Добавляем второе условие */
			if ( X2 == ($index + 1) ) { // X2 = номер второго параграфа
				$paragraphs[$index] .= $another_ad_code;
			}
			/* Добавили второе условие */
		}
		return implode( '', $paragraphs ); // совмещаем все параграфы вместе и отдаем
	}
	return $content;
}

А если вы хотите добавить рекламный блок в конец записи на сайте на WordPress, то просто добавьте условие:

add_filter( 'the_content', 'prefix_insert_post_ads' );
function prefix_insert_post_ads( $content ) {
	$ad_code = 'Тут код вашего рекламного блока';
	if ( is_single() && ! is_admin() ) {
		$closing_p = '</p>';
		$paragraphs = explode( $closing_p, $content );
		$count_p = count($paragraphs);
		foreach ($paragraphs as $index => $paragraph) {
			if ( trim( $paragraph ) ) {
				$paragraphs[$index] .= $closing_p;
			}
			if ( $count_p == ($index + 1) ) {
				$paragraphs[$index] .= $ad_code;
			}
		}
		return implode( '', $paragraphs );
	}
	return $content;
}

Таким же образом вы можете добавить блок рекламных объявлений к любым другим тегам, которые вы используете при размете ваших записей на вашем сайте на CMS WordPress, которые у вас встречаются в тексте записи.

В процессе создания сайта на WordPress также необходимо продумать правильную структуру, создать необходимые типы записей, таксономии (таксономии — это категории и теги) и правильно разработать шаблон.

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

На сайте WordPress существует достаточно документации, чтобы создать любой сайт на основе данной CMS. Кодекс WordPress, о котором шла речь в предыдущей статье, расписывает абсолютно все функции, доступные разработчику при создании шаблона или плагина.

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

Она наглядно показывает как работает шаблон WordPress. Какие файлы являются основными, а какие подключаются под определенные типы записей, что позволяет кастомизировать шаблон буквально под каждую страницу вашего сайта!

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

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

Удачной разработки шаблона под CMS WordPress!

Типы записей (сущности/объекты)

В CMS WordPress по-умолчанию существует два типа записи — это «Записи» и «Страницы«, остальные пока не будем рассматривать. Записи (posts) — стандартный тип записи используемый для блогов, выводятся от новых к более поздним записям. Страницы (pages) — обычные страницы сайта, которые находятся отдельно от записей блога и по-умолчанию, страницы невозможно организовать по категориям и тегам. Однако они могут иметь вложенность — страница может быть дочерней к другой странице.

Из этого следует, что для реализации блогов или портфолио, интернет-магазинов и других типов каталогов где есть определенный список записей, разделенных на категории и подкатегории, необходимо использовать именно «Записи«, для прочих страниц, например, «Контакты» или «О нас» — мы используем «Страницы«.

Для продвинутых пользователей можно воспользоваться «Пользовательскими типами записей» и создать свой тип записи. Для начинающих пользователей, которые не очень дружат с кодом, рекомендовал бы использование плагина Magic Fields или Magic Fields 2.0.

При создании своего типа записи вы можете указать параметры из стандартных (заголовок, краткая запись, полная запись, таксономия/использование категорий, тегов, миниатюры записи), а также добавить свои пользовательские поля, например с загрузкой изображения/файла, поле input, или любое другое. Подробнее почитать можете в кодексе WordPress (http://codex.wordpress.org/Post_Types)

Таксономия — что это такое и с чем едят

Понятие «таксономия» в WordPress подразумевает возможность классификации записей (постов) по категориям (или тегам). По-умолчанию в WordPress есть два типа таксономии: Категории (Рубрики) и Теги. Они практически идентичны, каждая таксономия имеет свой префикс (Рубрики — category, Теги — tag), SEO-урл и название.

Основным отличием Тегов от Рубрик является отсутствие иерархии. При создании таксономии вы можете указать имеют ли элементы таксономии иерархию или нет. Это означает что Тег-1 не может быть дочерним или родительским к Тегу-2, а вот в категориях иерархия разрешена и из них можно построить дерево категорий.

Таксономию удобно использовать при создании каталогов, фильтров или любых других классификаций. Обратите внимание: никогда не создавайте категории или разделы из страниц! Для этого предназначена таксономия! Подробнее про таксономии можно прочитать в Кодексе (http://codex.wordpress.org/Taxonomies)

Вывод

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

Если данная статья была вам интересна, возможно вас бы интересовали другие вопросы относительно работы с WP — пишите в комментариях и я буду публиковать новые статьи на проблемные тематики. Спасибо.

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

Что же делать? Все просто! Найдите строку с вызовом данной функции (файл и строка указаны в тексте ошибки), и добавьте дополнительную проверку на существование функции:

if(function_exists("wpcf7_add_shortcode")){
wpcf7_add_shortcode('hidden', 'hidden', true);
}

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

Не знаю, возможно кому-то данная статья покажется ненужной или же слишком простой, но если она вам помогла, буду рад узнать об этом увидев инкремент счетчика лайков

Для чего он нужен? Ну например чтобы передавать данные о пользователе (IP, браузер и т.п.), данные о странице откуда отправили форму, или откуда перешли чтобы отправить форму (какая страница поспособствовала переходу в раздел контактов) и еще куча возможных применений!

Все это вы можете себе позволить, написав просто обработку нового shortcode (тега, шорт кода) в шаблоне контактной формы. По-умолчанию существуют такие теги как text, email, textarea, которые также сопровождаются параметрами: обязательное или не обязательное поле и многое другое.

Теперь мы создадим новый тег hidden и в шаблоне добавим его как обычный тег с именем [hidden inputName]. Само имя тега inputName мы внесем в тело нашего сообщения. И остается только в файле functions.php прописать следующий код для обработки shortcode‘а:

// Register new shortcode for getting pages where contact form was send
function hidden($tag) {
    if ( ! is_array( $tag ) )
        return '';

if($tag['name'] == "referer"){
    $pageURL = 'http';
    if ($_SERVER["HTTPS"] == "on") {
        $pageURL .= "s";
    }
    $pageURL .= "://";
    if ($_SERVER["SERVER_PORT"] != "80") {
        $pageURL .= $_SERVER["SERVER_NAME"].":".$_SERVER["SERVER_PORT"].$_SERVER["REQUEST_URI"];
    } else {
        $pageURL .= $_SERVER["SERVER_NAME"].$_SERVER["REQUEST_URI"];
    }
    $html = '<input type="'.$tag['basetype'].'" name="' . $tag['name'] . '" value="'.$pageURL.'" />';
}else{
    $html = '<input type="'.$tag['basetype'].'" name="' . $tag['name'] . '" value="" />';
}
    return $html;
}
if(function_exists("wpcf7_add_shortcode")){
    wpcf7_add_shortcode('hidden', 'hidden', true);
}

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

На этом вроде все, если возникают вопросы — пишите в раздел вопросов и ответов, пишите комментарии, ставьте лайки!
Удачного коддинга!

Зачастую Magic Fields применяется для создания каталогов записей определенного типа. Это может быть портфолио, каталог товаров, каталог заведений, чего угодно. Как и в любом каталоге пользователю было бы удобнее найти требуемую ему единицу благодаря поиску или фильтру по параметрам этих записей. Для этого нужно вывести фильтр — вывести все варианты значений, которые могут принимать параметры, для того чтобы с ними работал посетитель. Для полей типа input конечно варианты значений в фильтр не выводят, а вот для select (dropdown list) вывести их необходимо, но к сожалению, нативными средствами плагина Magic Fields 2 тут не обойдешься.

В своем старом посте Реализуем поиск для Magic Fields 2 я рассматривал вариант SQL запроса прямо в шаблоне, но так делать не красиво, и вот, спустя время был обнаружен еще один способ!

Для того чтобы получить опции выпадающего списка дополнительного поля Magic Fields достаточно просто в файле functions.php создать нужную функцию и к ней обращаться в любом месте шаблона. Вот собственно и сама функция:

// Magic Field get dropdown options
function get_field_options( $field, $post_type = NULL ) {
global $wpdb, $post;
static $field_options_cache = array();

if ( !$post_type ) { $post_type = get_post_type( $post->ID ); }

if ( !array_key_exists( $post_type, $field_options_cache ) ) {
$field_options_cache[$post_type] = array();

$sql = sprintf(
"SELECT name, options FROM %s WHERE post_type = '%s'",
MF_TABLE_CUSTOM_FIELDS, $post_type );

$results = $wpdb->get_results( $sql, ARRAY_A );
foreach ( $results as $result ) {
$field_options_cache[$post_type][$result['name']] = unserialize( $result['options'] );
}
}

return $field_options_cache[$post_type][$field];
}

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

На этом все. Удачного вам коддинга!