AdContent 2.0 — плагин для эффективного размещения рекламы на сайте

Logo

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

AdContent 2.0 – WordPress плагин для эффективного размещения рекламы на сайте

Стоимость плагина AdContent: 20$. Актуальная версия: 2.1.2 (журнал обновлений)

Купить Скачать

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

Основные возможности

  • Создание рекламных блоков трех типов: баннер, тизер и произвольный код.
  • Загрузка рекламных блоков в выбранных записях, рубриках и метках.
  • Загрузка рекламных блоков в записях, которые находятся в определенных рубриках или отмечены определенными метками.
  • Поддержка произвольных типов записей и пользовательских таксономий.
  • Автоматическая вставка рекламных блоков в статьи (с версии 2.02).
  • Автоматический вывод рекламы во всплывающем окне (с версии 2.1.1).
  • Загрузка рекламных блоков в зависимости от типа страницы (главная, поиск, архивные страницы дат и авторов, страница ошибки 404 и т.д.).
  • Загрузка рекламных блоков в зависимости от типа устройства пользователя (ПК, планшет или смартфон).
  • Загрузка рекламных блоков в зависимости от местоположения пользователя (страны).
  • Скрытие ссылок от индексации обычным способом, при помощи JavaScript и PHP-редиректа с возможностью шифрования.
  • Настройка даты и времени начала и завершения показа рекламных блоков.
  • Поддержка мультиязычных сайтов на базе WPML (с версии 2.0.8).
  • Загрузка рекламных блоков в зависимости от размера окна браузера (с версии 2.0.9).
  • Загрузка рекламных блоков при помощи PHP, шорткода, JavaScript и HTML кода.

В плагин AdContent интегрирована платная версия популярного плагина Advanced Custom Fields PRO. Таким образом, приобретая плагин AdContent, вы также получаете плагин ACF PRO абсолютно бесплатно. Единственное правило — запрещается распространять плагин ACF PRO или использовать его отдельно от плагина AdContent, так как это будет нарушением авторских прав.

Фотообзор основных страниц

Установка плагина

Для установки плагина AdContent перейдите в административную панель «Плагины — Добавить новый» и нажмите кнопку загрузить плагин. Далее укажите путь к архиву с файлами плагина и нажмите установить.

Установка плагина AdContent
Установка плагина AdContent

Сразу после установки и активации плагина в меню в административной панели сайта станет доступен новый пункт «AdContent», перейдя в который вы сможете приступить к созданию рекламных блоков. Но прежде чем это сделать, необходимо произвести базовую настройку плагина.

Настройка плагина

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

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

Форматы рекламных блоков
Форматы рекламных блоков

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

format_1 : формат 1
format_2 : формат 2

Типы записей – укажите через запятую все типы записей, на страницах которых вы хотите размещать рекламные блоки. Активация данного поля сделает доступной привязку рекламных блоков к отдельным записям на сайте, а также сделает возможной настройку параметров таксономий (см. Типы записей и таксономии).

Типы записей
Типы записей

Таксономии – укажите через запятую все таксономии, на страницах терминов которых вы хотите загружать рекламные блоки.

Таксономии
Таксономии

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

Типы записей и таксономии
Типы записей и таксономии

Для указания типов записей и таксономий используйте следующий шаблон:

post_type_1 : taxonomy_1, taxonomy_2
post_type_2 : taxonomy_3, taxonomy_4

Для повышения производительности, указывайте только типы записей и таксономии, которые планируете использовать. При этом типы записей должны быть объявлены в поле «Типы записей». Необъявленные типы записей будет исключены.

Максимальное количество рекламных блоков – используется для ограничения количества рекламных блоков, которые могут быть получены за один запрос посредством Ajax и шорткодов.

Максимальное количество рекламных блоков
Максимальное количество рекламных блоков

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

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

Дополнительные параметры
Дополнительные параметры

Загрузка рекламных блоков

Загрузить код рекламных блоков и вывести его на экран можно при помощи:

  1. PHP-функций get_ads() и the_ads().
  2. Шорткода [adcontent];
  3. JavaScript функции adcontent_ajax();
  4. HTML тегов с классом «adcontent-ajax»

Передаваемые параметры

  • ids (string) – идентификаторы рекламных блоков через запятую.
  • num (integer) – количество рекламных блоков.
  • type (string) – типы рекламных блоков через запятую. Поддерживаются значения:
    • banner – баннеры;
    • teaser – тизеры;
    • code – рекламный код;
  • format (string) – форматы рекламных блоков через запятую.
  • orderby (string) – тип сортировки рекламных блоков. Поддерживаются значения:
    • date – по дате создания;
    • modified – по дате изменения;
    • rand – в случайном порядке;
    • post__in – по переданным ID;
    • priority – по приоритету (с версии 2.0.9);
  • order (string) – порядок сортировки. Поддерживаются значения:
    • ASC – в обычном порядке;
    • DESK – в обратном порядке;
  • post_id (integer) – идентификатор записи для которой необходимо получить рекламные блоки.
  • post_type (string) – тип записи, идентификатор которой был передан в post_id.
  • term_id (integer) – идентификатор категории, метки или термина произвольной таксономии.
  • term_taxonomy (string) – таксономия термина, идентификатор которого был передан в term_id.
  • page_type (string) – тип страницы. Поддерживаются следующие значения:
    • front_page — главная страница;
    • page – статические страницы;
    • single – страницы постов и произвольных типов записей;
    • term – страницы рубрик, меток и произвольных таксономий;
    • search – страница с результатами поиска;
    • attachment – страницы вложений;
    • 404 – страница ошибки 404;
    • post_type_archive – архивные страницы типов записей;
    • author – архивные страницы авторов;
    • date – Архивные страницы дат;
  • device (string) – тип устройства пользователя. Поддерживаются следующие значения:
    • computer – настольные компьютеры;
    • tablet – планшеты;
    • mobile – смартфоны;
  • location (string) – код страны (Alpha-2 ISO 3166-1). Пример: RU.
  • viewport_width (integer) – ширина окна браузера (с версии 2.0.9).
  • viewport_height (integer) – высота окна браузера (с версии 2.0.9).

Если передать в качестве параметра значение 0 (или false для php), функция будет отключена. Это может быть полезно, например, если вы хотите выборочно отключить некоторые функции, которые включены в настройках плагина по умолчанию.

PHP-функция get_ads()

Получает код рекламных блоков в виде массива.

Возвращает

Индексный массив. Если не удалось получить рекламные блоки – false.

Использование

get_ads( $args );

$args (array) – массив аргументов, в соответствии с которыми будут получены рекламные блоки.

Примеры

1. Получение 10 тизерных рекламных блоков, отсортированных в случайном порядке.

$ads = get_ads( array(
'num' => 10,
'type' => 'teaser',
'orderby' => 'rand'
) );

2. Получение 3-х случайных рекламных блоков по их ID и вывод результата на экран.

$ads = get_ads( array(
'ids' => '1, 5, 10, 15, 20',
'num' => 3,
'orderby' => 'rand'
) );
if ( is_array( $ads ) ) {
echo implode( '', $ads );
}

PHP-функция the_ads()

Выводит рекламные блоки на экран в случае успеха. В противном случае ничего не выводит. Является оберткой для функции get_ads().

Использование

the_ads( $args, $before, $after, $default );
  • $args (array) — массив аргументов, в соответствии с которыми будут получены рекламные блоки.
  • $before (string) – текст или HTML-код, который будет добавлен перед рекламными блоками.
  • $after (string) – текст или HTML-код, который будет добавлен после рекламных блоков.
  • $default(string) – текст или HTML-код, который будет выведен на экран по умолчанию, если рекламные блоки не будут найдены или возникнет какая-то ошибка в процессе их получения.

Примеры

Вывод двух рекламных блоков в сайдбаре.

the_ads(
array( 'num' => 2 ),
'<div class="widget">',
'</div>'
);

Шорткод [adcontent]

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

[adcontent]

Вы можете передавать в шорткоде любой параметр, из ранее перечисленных. В качестве примера выведем два рекламных блока формата «article».

[adcontent num="2" format="article"]

Шорткоды также можно использовать для получения рекламных блоков непосредственно в шаблоне сайта посредством функции do_shortcode();

$ads = do_shortcode( '[adcontent num="2" format="article"]' );

HTML-теги с классом «adcontent-ajax»

Использование HTML-тегов позволяет быстро и легко загружать рекламные блоки в текстах статей и шаблоне сайта посредством Ajax без каких-либо манипуляций с JavaScript кодом. Для этого достаточно создать элемент с классом «adcontent-ajax» и передать в него соответствующие параметры через атрибут data-*.

В качестве примера получим один баннерный рекламный блок.

<span class="adcontent-ajax" data-num="1" data-type="banner"></span>

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

JavaScript-функция adcontent_ajax()

Плагин также позволяет получать рекламные блоки посредством JavaScript и Ajax. Для этого необходимо использовать функцию adcontent_ajax(), привязав ее к событию «adcontent_globals_init», которое срабатывает сразу после получения всех необходимых данных для работы JavaScript функций плагина.

Использование

adcontent_ajax( args, callback );
  • args (object) – объект с аргументами для получения рекламных блоков.
  • callback (function) – функция, в которую будут переданы результаты запроса.

В случае успеха в функцию callback будет передан индексный массив с кодом рекламных блоков. В противном случае – false.

Пример использования

В качестве примера получим один рекламный блок формата «sidebar», обернем его в HTML-код виджета и добавим в сайдбар.

jQuery( window ).on( 'adcontent_globals_init', function() {
adcontent_ajax( { num: 1, format: 'sidebar' }, function( data ) {
/* Проверяем тип полученных данных */
if ( jQuery.type( data ) !== 'array' ) {
return;
}
/* Создаем виджет и добавляем в него код рекламных блоков */
var ads = '<div class="widget">' + data.join( '' ) + '</div>';
ads = jQuery( '<div/>' ).html( ads ).contents();
/* Добавляем виджет в сайдбар */
jQuery( '#sidebar' ).append( ads );
} );
} );

Обновление плагина

Для обновления плагина скачайте актуальную версию по ссылке, предоставленной в начале и конце статьи. После этого деактивируйте плагин AdContent (данные будут сохранены), удалите его через административную панель сайта и установите новую версию.

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

Купить Скачать

Обнаружили ошибку? Выделите ее и нажмите Ctrl+Enter

Оставить комментарий

отменить ответ