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

DmitriyDenisov.com Logo

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

AdContent - плагин рекламы для WordPress

Стоимость плагина AdContent: 32$ (журнал изменений)

Купить Скачать бесплатно

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

  • Показ объявлений в определенных записях, рубриках и метках.
  • Показ объявлений в записях, которые находятся в определенных рубриках или отмечены определенными метками.
  • Поддержка произвольных типов записей и пользовательских таксономий.
  • Показ рекламных блоков с учетом типа устройства пользователя (ПК, смартфон или планшет).
  • Показ рекламных блоков с учетом местоположения пользователя (страны).
  • Показ объявлений в зависимости от типа страницы (главная страница, архивные страницы, поиск и т.д.).
  • Поддержка неограниченного количества пользовательских форматов и групп объявлений.
  • Настройка даты и времени начала и завершения показа рекламных блоков.
  • Показ рекламных блоков в зависимости от их приоритета.
  • Вставка рекламных блоков по хукам (Action Hooks).
  • Показ объявлений во всплывающем окне.
  • Встроенный генератор шорткодов.
  • Встроенный плагин Advances Custom Fields PRO.
  • Корректная работа с плагинами кэширования.
  • Поддержка мультиязычных сайтов на базе WPML.
  • Обход блокировок AdBlock и многое другое.

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

Функции и шорткоды

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

  • PHP-функции get_ads() и the_ads().
  • JavaScript функция adcontent_ajax().
  • Шорткод [adcontent].
  • HTML-шорткод.

Параметры

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

Параметры функций и шорткодов

  • id (string|array) – идентификаторы рекламных блоков через запятую или в виде массива.
  • num (integer) – количество рекламных блоков.
  • format (string|array) – идентификаторы форматов рекламных блоков через запятую или в виде массива..
  • group (string|array) – идентификаторы групп рекламных блоков через запятую или в виде массива.
  • post_id (integer) – идентификатор записи для которой нужно получить релевантные рекламные блоки.
  • term_id (integer) – идентификатор термина таксономии для которого нужно получить релевантные рекламные блоки.
  • page (string|array) – типы страниц через запятую или в виде массива. Поддерживаются значения:
    • front_page — главная страница;
    • page – статические страницы;
    • single – страницы постов и пользовательских типов записей;
    • term – страницы рубрик, меток и пользовательских таксономий;
    • search – страница с результатами поиска;
    • attachment – страницы вложений;
    • 404 – страница ошибки 404;
    • post_type_archive – архивные страницы типов записей;
    • author – архивные страницы авторов;
    • date – архивные страницы дат;
  • device (string|array) – типы устройств через запятую или в виде массива. Поддерживаются значения:
    • mobile – смартфоны;
    • desktop – настольные компьютеры;
    • tablet – планшеты;
  • location (string|array) – коды стран в верхнем регистре (Alpha-2 ISO 3166-1) через запятую или в виде массива. Пример: RU, UA, DE, NL, US.
  • orderby (string) – тип сортировки рекламных блоков. Поддерживаются значения:
    • priority – по приоритету;
    • post__in – по переданным ID;
    • rand – в случайном порядке;
    • date – по дате создания;
    • modified – по дате изменения;
  • order (string) – порядок сортировки. Поддерживаются значения:
    • ASC – в обычном порядке;
    • DESK – в обратном порядке;
  • not (string|array) – идентификаторы рекламных блоков через запятую или в виде массива, которые необходимо исключить из запроса.
  • default (string|array) – идентификаторы рекламных блоков через запятую или в виде массива, которые будут показаны по умолчанию, если для страницы не удалось подобрать релевантные объявления.
  • class (string) – CSS классы через пробел, которые будут использованы для контейнера с объявлениями.
  • timeout (integer) – задержка показа рекламных блоков в миллисекундах. Параметр актуален только для обычных и HTML-шорткодов, загружаемых при помощи Ajax.
  • ajax (integer) – статус Ajax. Используется только для шорткодов [adcontent]. Если указать 1, то шорткод вернет HTML шорткод для загрузки рекламных блоков при помощи Ajax.
  • return (string) – тип возвращаемых данных. Может принимать значение string или array. Параметр актуален только для JavaScript функции adcontent_ajax().

Следует отметить, что параметры post_id, term_id, page, device и location определяются автоматически, если вы не указали их вручную. Также вы можете отключить любой из параметров, несмотря на его статус в настройках плагина, указав в качестве его значения 0 или false.

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

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

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

Возвращает

Индексный массив или строку, в зависимости от значения параметра $return. false или пустую строку, если рекламные блоки получить не удалось.

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

get_ads( $args, $return );
    • $args (array) – массив аргументов для получения рекламных блоков.
    • $return (string) – тип возвращаемых данных. Поддерживаемые значения:
      • array – функция вернет индексный массив с кодом рекламных блоков.
      • string – функция вернет строку, содержащую рекламные блоки вместе с контейнером.

Пример:

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

$ads = get_ads( array(
    'num' => 10,
    'orderby' => 'priority'
) );

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

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

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

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

Пример:

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

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

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

Данная функция позволяет получать рекламные блоки при помощи Ajax. Для максимальной эффективности ее следует использовать после инициализации Ajax переменных. Сделать это можно, привязав функцию к событию adcontent_ajax_globals_init.

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

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

Возвращает

В случае успеха в функцию callback будет передан индексный массив или строка с кодом рекламных блоков. В противном случае — false. Тип возвращаемых данных задается через параметр args['return'], который может принимать значение string или array.

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

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

jQuery( window ).on( 'adcontent_ajax_globals_init', function() {
    adcontent_ajax( { 'num' : 1, 'return' : 'string' }, function( data ) {
        if ( jQuery.type( data ) === 'string' ) {
            var ads = '<div class="widget">' + data + '</div>';
            ads = jQuery( '<div/>' ).html( ads ).contents();
            jQuery( '#sidebar' ).append( ads );
        }
    } );
} );

Шорткод [adcontent]

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

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

[adcontent num="2" orderby="rand" class="ads"]

Чтобы получить код рекламных блоков в шаблоне сайта, используйте WordPress функцию do_shortcode().

$ads = do_shortcode( '[adcontent num="2" orderby="rand"]' );

HTML-шорткоды

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

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

<span class="adcontent-ajax" data-num="5" data-orderby="rand"></span>

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

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

Комментарии 4

  1. lexa

    День добрый и с наступающим Новым Годом!

    В вашем плагине AdContent реализована поддержка страниц подгружаемых автоматически, например через плагин infinite scroll.

    Цена 20$ это для одного сайта?

    • Дмитрий Денисов

      Здравствуйте, lexa!

      Спасибо. И вас с наступающим Новым Годом!

      Все зависит от рекламных блоков, способа их загрузки и особенностей подгрузки контента. Если в рекламных блоках используется JavaScript и/или загрузка рекламных блоков производится при помощи Ajax, то потребуется доработка сайта с учетом индивидуальных особенностей его работы. Если быть более конкретным, то потребуется повторная инициализация JavaScript функций плагина AdContent каждый раз, когда подгружается новый контент.

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

  2. Алексей

    Добрый день! Очень интересный плагин. А возможно ли в нем реализовать подмену рекламного блока (кода) в зависимости от реффера поисковой системы и сайтов в целом? К примеру, пользователем из Яндекс показывать РСЯ, а пользователям из Гугла Адсенс.

    • Дмитрий Денисов

      Здравствуйте, Алексей.

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

      До тех пор загрузить рекламные блоки с учетом источника перехода можно только вручную, например, при помощи Ajax, используя JavaScript функцию adcontent_ajax(). Вы можете создать отдельные форматы для разных поисковых систем и загружать рекламные блоки в зависимости от значения document.referrer.

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

* - поля, обязательные для заполнения
Загрузка Google reCAPTCHA