Я решил подробнее описать основы работы с моим плагином A2P-SAPELinks, предназначенным, как ясно из названия, для показа ссылок, размещаемых на вашем сайте через биржу ссылок SAPE.
Некоторые действия описаны, возможно, слишком подробно, но я постарался написать так, чтобы даже начинающие пользователи Wordpress смогли быстро начать использовать этот плагин по назначению.
Установка
Установка плагина не отличается от установки любого плагина для Wordpress. Просто копируется содержимое архива(папку с содержимым) в каталог wp-content/plugins. После это плагин активируется на странице Плагины (Plugins) панели управления блогом.
Настройка плагина
Плагин имеет несколько режимов работы, которые задаются с помощью настроек.
Для задания настроек плагина необходимо перейти на страницу управления плагином - Настройки -> SAPELinks (Settings -> SAPELinks).
Описание настроек плагина
Общие настройки
- Включить локальный тестовый режим - включение этого режима позволяет проверить только правильность установки плагина. При этом на страницах сайтах должны выводится тестовые ссылки.
Если добавлен хотя бы один виджет (см. далее), то будут показаны тестовые ссылки (количество зависит от настроек виджета). При этом максимальное количество тестовых ссылок - 5.
Если включён режим контекстных ссылок (см. далее), то вместо текста будет выведен тестовый текст со ссылкой. При этом, в зависимости, от режима контекстных ссылок, тестовый текст может быть показан как на всех страницах, так и только на страницах просмотра полного содержимого записи или страницы.
При включении локального тестового режима необходимо в поле Ваш SAPE код(хэш) (см. далее) прописать значение 1234567890. - Включить тестовый режим SAPE - при включении тестового режима SAPE в местах показа ссылок будет выведен блок HTML-комментария с содержимым
<!-- check code --> - Ваш SAPE код(хэш) - в это поле необходимо ввести название папки, в которой размещён ваш файл sape.php.
- Требуемая кодировка ссылок - в этом поле можно задать требуемую кодировку ссылок. По-умолчанию в системе используется WINDOWS-1251. Если ваш блог использует кодировку UTF-8 (Wordpress уже давно использует именно ее), то необходимо указать это.
- Код SAPE используется на нескольких сайтах (Multisite) - при включение этого режима добавляется параметр multi-site. Пока не тестировался.
Настройки контекстных ссылок
- Включить контекстные ссылки - включить вывод контекстных ссылок. При этом режим работы контекстных ссылок зависит от параметров, описанных ниже. По-умолчанию (если остальные параметры не включены), контекстные ссылки включаются на всех страницах блога.
- только для страниц с полным текстом (Page, Post) - при включении этой опции, контекстные ссылки будут включаться только на страницах просмотра одиночной записи или страницы (не будут включены для страниц со списками статей - категорий, архивов и прочее).
- включить также для краткого описания сообщения (Excerpt) - в некоторых темах, на страницах со списком статей используется функция the_excerpt() вместо the_content(), которая выводит краткое описание записи, которое вводится в отдельное поле при создании записи.
Как правило, если вы хотите, чтобы на таких страницах включались контекстные ссылки, то достаточно просто включить их используя первую опцию и не включая вторую.
Оформление виджетов со ссылками
Эти поля можно использовать для задания общих для всех виджетов блоков текста, которые будут показаны перед и после виджета.
- Код перед виджетом - код который будет выведен перед виджетами, для которых не заданы собственные значения этого параметра, например
<p>предлагаем посетить сайты наших партнёров</p> - Код после виджета - код который будет выведен после виджетов, для которых не заданы собственные значения этого параметра, например
<p>переход по ссылке будет выполнен в новом окне</p>
Примеры настроек контекстных ссылок
Если в настройках плагина включена только опция Включить контекстные ссылки , то контекстные ссылки будут включены как для страниц со списком записей (главная страница, страница со списком записей в категории, архив за месяц и другие списки записей), так и на странице просмотра содержимого отдельной записи.
При включении опции только для страниц с полным текстом (Page, Post) , на странице со списком записей контекстные ссылки отключаются, и будут выводится только при просмотре содержимого отдельной записи или страницы.

Работа с виджетами
Виджеты предназначены для показа обычных SAPE-ссылок. Если вы не добавите ни одного виджета, то ссылки показаны не будут.
Создание нескольких виджетов
Вы можете добавить любое количество виджетов. Для этого необходимо перейти на страницу Дизайн -> Виджеты. В нижней части этой страницу будет блок с заголовком SAPE Links: Виджеты ссылок. В выпадающем списке вы можете выбрать требуемое число виджетов и нажать на кнопку "Сохранить". Созданные виджеты добавятся в колонку доступных виджетов с заголовками A2P Sape Links N, где N - номер виджета.
Настройка виджетов
После создания нужного количества виджетов, необходимо их разместить на панелях (для этого на странице управления виджетами в правой части нужно выбрать требуемую панель(сайдбар) и кликнуть по кнопке "Показать").
После размещения виджетов, для каждого из них можно задать необязательные параметры:
- Заголовок - заголовок виджета.
- Количество ссылок - максимальное количество SAPE-ссылок выводимых в данном блоке.
- Текст перед виджетом - текст который будет выведен перед виджетом. Если этот параметр не задан, будет использовано значение, заданное в настройках плагина.
- Текст после виджета - текст который будет выведен после виджета. Если этот параметр не задан, будет использовано значение, заданное в настройках плагина.
Замечания
- Для последнего виджета желательно всегда оставлять значение параметра "Количество ссылок" пустым. Это будет означать, что в данном блоке будут показаны все, оставшиеся в списке для данной странице непоказанными, ссылки.
- При этом вам необходимо следить, чтобы этот виджет выводился именно последним, так как иначе в нем будут показаны все ссылки, а в следующих за ним не будет ничего.
- При изменении настроек не забывайте чистить кэш(если у вас установлен какой-либо из плагинов кэширования).
- Не забывайте, что некоторые изменения могут отобразиться не раньше чем через час (так как файлы, создаваемые кодом системы SAPE обновляются через час). Для ускорения можно удалить файлы words.db и links.db, находящиеся в папке с файлом sape.php.

Комментариев: 56
блог хороший, но все как то разбросано
Установил плагин на свой блог. У меня возникают ошибки. Пишет мол папки с таким названием не существует. Хотя с самого Сапа все работает нормально. Версия блога 2.3.3
IpMoney, плагин использует переменную $_SERVER[’DOCUMENT_ROOT’], возможно в вашем случае она почему-то указывает не на корневой каталог вашего сайта?
Ну и на всякий случай, может быть ошиблись при вводе значения в поле “Ваш SAPE код(хэш)”?
Плагин чёто не пашит у меня((((
На пашет потому что ты и не пробовал !
Для новичков думаю очень полезное чтиво, автор, не переживай. Еще услышишь “спасибо” за труды)
В тестовых режимах работает, в реальном режиме еще не проверил, переезд сайта не закончен. В любом случае за плагин спасибо!
Спасибо за труды. Попробую протестить на своем сайте)))
Хороший блог
Вопрос - так как ссылку выводит виджет, который по идее должен отображаться на каждой странице, то и ссылка будет отображаться на каждой странице? Или инофрмация в виджете динамически меняется?
Конечно меняется. Ведь используется функция из кода сапы, которая выводит ссылки только для соответствующей страницы.
Тяжело ориентироватся в вашем блоге. Но информации полезной куча. Спасибо.
Спасибо! Все работает
мне нравится блог, удобно очень
Давно искал, наконец то наткнулся на саит. Автор спасибо большое !)
Ух, ну хоть работает по человечески, уже радует
Алексей, а почему в конце блог-постов видна вот такая надпись: PHP has encountered an Access Violation at 7C81BD02
Это так и должно быть или как то можно убрать?
Приношу свои извинения за предыдущий вопрос, я понял в чем причина :-).
А за плагин огромное спасибо, очень выручил.
при включении локального тестового режима и кода 1234567890 все как в Вашем примере показывается.
при включении тестового режима с норм. своим кодом не показывается чек код на сайте.
что мы не так делаем? версия вордпресс 2 6 2
“Файл с кодом SAPE не найден! Убедитесь в правильности размещения файла и в правильности указанного SAPE_ID!”
Файл с САПЕ архива лежит в гл. директории на хостинге.
а плагин Ваш, соотвественно, в плагинах..
Что оно возмущается то? Либо, куда устанавливать папку с сапыным кодом в названии?
Код сапы должен лежать в папке public_html/{ваш SAPE_ID}. То есть нужно просто распаковать содержимое архива в папку public_html.
Можетбыть вы ошиблись при указании SAPE_ID? Если вы уверены, что все сделано правильно, то можете кинуть мне в Обратную связь инфу по доступу к хостинг-аккаунту и в админку блога, я попробую глянуть, когда смогу.
вроде настроилось. подожду пока Сапа отреагирует. если нет тада уж будем думать что и как.
а как сделать вставку кода обычных ссылок? не все же виджеты используют.
Проблема аналогичная как у Алексея “Файл с кодом SAPE не найден! Убедитесь в правильности размещения файла и в правильности указанного SAPE_ID!”. Появляется не первый раз, раньше когда устанавливал, тоже самое было, раньше просто удалял, а щас хочется разобраться
Не могу понять что случилось, но оно само вдруг начало работать спустя мин 10
������� ссылки сначала отображались нормально, а теперь вот такие крякозябры стало выкидывать.
У меня проблема с контекстными ссылками!
Когда я в настройках включил контестные ссылки в тестовом режиме у меня в место текста выходила тестовая ссылка а текста небыло, потом оеключил контекстные ссылки текст опять появился.
С чем это связано , как убрать это баг?
Подскажите народ!
Спасибо конечно, отличный виджет! Столько мучался, не мог вручную вставить ссылки
Только вот проблема - сами сайдбары-то пропали и нету их больше! Глянь пожалуйста, сайт в подписи.
Спасибо!
Спасибо плагин просто супер!
спасибо за плагин
правда, есть некоторые проблемы, например, при включении отображения контекстных ссылок появляется ошибка на главной странице.
и календарь почему-то изменился в размерах и уехал за пределы страницы
Плагин просто золото! Большое спасибо!
Поставил за 5 мин.
как можно внедрить этот плагин в шаблон если не используюся виджеты?
скажите, если в виджете не отражается, а сам виджет показывается, это о чем говорит?
****если не отображается *check code
Файл с кодом SAPE не найден! Убедитесь в правильности размещения файла и в правильности указанного SAPE_ID
Работает только в локальном тестовом режиме.
Как исправить?
Сори - залил новый sape.php все заработало
Вопрос! установил плагин, контекстные ссылки рабатают, а обычные нет! можно юто как то исправить?
Ни один плагин не помогает, ничо не работает. Сапа все время пишет- “Укажите полный УРЛ любой страницы сайта, на которой заведомо установлен код!” Не знаю что делать.. все крутил, все адреса поменял, устанавливал и плагины и просто код… никак, ни в какую!
Привет всем!
По плагину есть 2-а момента:
1-й поставил и настроил плагин. Сапа его приняла.
Но проиндексировала, только 12 страниц. Вида /page/1, 2 и т.д.
Как можно проверить, стоит ли код на других страницах?
2-й У меня на сайте, только один сайдбар и он черный. Плагин выводит так же черный текст. Пробовал изменить цвет текста, через поле “Текст перед виджетом, текст после виджета” Не вышло.
Друзья, подскажите плизз решение. Буду безмерно вам благодарен.
Алексей, возник плановый вопрос по плагину - тестировали ли Вы мультисайт?
Дело в том, что засунул в САПу второй сайт с одного хостинга и уже полтора суток прошло, а денежко не капает. Может нужно чекбокс “Код SAPE используется на нескольких сайтах (Multisite)” нажимать?
Если да, то только на втором или на обоих?
Та же ситуация, что и у Алексея.
Подскажите поставил плагин но вместо нориального текста ссылок выводится ������� что делать? Версия движка 2.7
Внимательно просмотрите в настройках кодировку. Скорее всего, не стоит utf-8
Алексей, Станислав, вопрос снимаю. Все работает без параметра мультисайт. Просто проблемы на САПе были. Еще раз ОГРОМНОЕ спасибо за плагин.
Я поставил мультисайт. Стало все начисляться. Возможно решились проблемы на сапе. Но убирать теперь его страшно
Так что пусть стоит.
Статья замечательная. С размещением ссылок у новичка возникает много проблема.
но что делать в такой ситуации моя тема не поддерживает установку виджетов (Simple Balance). Но можно самому вставить код в страницу.
Вопрос только какой код вставлять ….
Код видимо должен быть примерно таким
Ссылки Sape
но что-то ещё нужно сюда добавить
Подскажите как решить эту проблему:
Не как не получается создать больше одного виджета, просто не создается и все. Версия блога Версия 2.8.4
В чем может быть проблема?
Мак
После того, как создали один виджет, нажимайте - сохранить и только после этого создавайте другой, иначе предыдущий исчезает. Нужно сохранять после каждых изменений - глюк в вордпрессе.
Очень Класный плагин! Большое спасибо разработчику!
у меня не появляются новые виджеты, жму “сколко вы хотите добавить виджетов” , выбираю, жму сохранить , но ничего не появляется((( и тот виджет, что я установил(появился всего один), я не вижу на своем сайте(( в чем может быть дело?
Да, да, да. Последнее время стала возникать эта проблема.
Поставил на один свой сайт все с первого раза получилось. Понравилась простота и возможность тестировать. Жду индексации сапы.
Плагин БЫЛ хорошим. На новых версиях WP не работает. Возникает проблема описанная выше. А жаль придется искать другие плагины…
к сожалению не могу сделать более одного виджета со ссылками. Увы. Вордпресс 2.9
Поставил плагин на свой сайт по полиграфии. Пашет как надо
ЪХороший плагин пользуюсь. А есть возможность, скажем одновременного использования виджента и вставки кода в футер(разбивка на несколько мест), в футер вставлять обычный саповский код или какой то др.?