Установка кода SAPE на DLE

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

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

Начнём:

Необходимость написания статьи возникла по двум причинам:
1. Про подключение Биржи ссылок статьи есть, а вот про подключение кода Биржи статей - Articles.sape к DLE нет.
2. Очень много актуальных обращений за помощью в установке кода и проверке правильности его установки.

Ну вот предыстория этой статьи раскрыта, теперь выделим основные пункты и дадим личные советы по работе и подключению кода Sape к DLE.



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

Часть 1 - Общая - регистрация, добавление площадки и получение кода.

Часть 2 - Подключение кода для продажи ссылок с главных и внутренних страниц сайтов(без контекстных ссылок).

- Вариант 1 - Выводим все ссылки одним блоком.

- - Вариант 1.1 - Если появляются error с пояснением, что не удалось определить IP сайта.

- - Вариант 1.2 - Если появляются error на страницах тегов написанных на кирилице.

- Вариант 2 - Выводим ссылки несколькими блоками в разных частях шаблона.

Часть 3 - Подключение кода для продажи ссылок со страниц для печати.

Часть 4 - Подключение кода для продажи контекстных ссылок с внутренних страниц сайтов.

Часть 5 - Добавление площадки, её настройки и индексация пауком Sape, основные принципы и правила работы, ошибки и проверка правильности установки кода, статусы ссылок.

И так поехали!



Если Вы ещё не зарегистрированы в Sape, то регистрируемся здесь или авторизуемся и входим в раздел Вебмастеров.


В разделе Мои площадки жмём кнопку Добавить площадку


Теперь жмём на ссылку Для хостинга с поддержкой PHP


в раскрывшемся меню вводим ссылку на zip-архив и скачиваем его, а следуем инструкциям:

1) Скаченный к себе на компьютер и zip-архив распакуйте, внутри архива будет ваша пользовательская папка **************************(звёздочками я заменил код, у каждого он свой, имя скаченной папки является Вашим кодом для Sape и будет нам необходимо в дальнейшем).
2) Скопируйте папку ************* из архива к себе в корень вашего сайта(там где у вас файл index.php).
3) Выставите права доступа 777 на эту папку (но не на файл sape.php), чтобы наш php-клиент мог управлять файлом с базой ссылок.
4) Сохраните копии файлов index.php, show.full.php(engine/modules/), main.tpl(templates/Ваш шаблон/), print.tpl(templates/), static_print.tpl(templates/)

Внимание!
Для всех сайтов одного пользователя системы КОД УСТАНАВЛИВАЕТСЯ ОДИНАКОВЫЙ. Вам необходимо СНАЧАЛА УСТАНОВИТЬ КОД, а потом добавить свой сайт через форму ниже! Иначе процесс проверки Вашего ресурса может сильно затянуться!

В случае, если Вы обновляете код на своём сайте – удалите старый файл links.db и обязательно удостоверьтесь в том, что для Вашей пользовательской папки выставлены права доступа 777. При переносе сайта на новый хостинг, необходимо выполнить те же действия.

Тут я сделаю отступление и приведу самый простой и старый способ подключения кода Sape на основе использования любых PHP вставок в шаблонах:

Открываем файл index.php скрипта, и находим строку:

echo $tpl->result['main'];

Заменяем на:

eval (' ?' . '>' . $tpl->result['main'] . '<' . '?php ');

Подключаем код sape в самый верх main.tpl:

<?php
     if (!defined('_SAPE_USER')){
        define('_SAPE_USER', '***************');
     }
     require_once($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php');  
        $o['host'] = 'www.url сайта(или без www).ru';
        $sape = new SAPE_client($o);
        unset($o);
?>

внимание, не забудьте вставить свой код вместо звёздочек* и указать url сайта.

Выводим ссылки:

<? echo $sape->return_links(1); ?>

1 в скобках - это количество ссылок в блоке.



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

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

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

Мы и Sape настоятельно рекомендуем не размещать более 2-х ссылок на страницу, последствия могут быть печальные: потеря показателей в первую очередь тИЦ и даже вылет из индекса, особенно это актуально после последствий последних АП-ов Яндекса. И если вы решили прислушаться к нашим рекомендациям, то думаю вывести максимум две ссылки на страницу можно и одним блоком, а не раскидывать их по шаблону усложняя себе жизнь и не будучи уверенным в том что их купят все две на каждой странице. Ну вот мы и подошли к первому варианту размещения и вывода ссылок на страницах.



Откройте index.php и ПЕРЕД строкой:

$tpl->compile ( 'main' );

вставьте:

define('_SAPE_USER', '********************');  
require_once($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php');  
$sape = new SAPE_client();
$tpl->set('', $sape->return_links());

внимание, не забудьте вставить свой код вместо звёздочек*.

В шаблон main.tpl в различных местах вставьте теги для вывода ссылок:

Откройте index.php и ПЕРЕД строкой:

$tpl->compile ( 'main' );

вставьте(но в коде вместо ВАШСАЙТ.РУ введите свой URL):

define('_SAPE_USER', '********************');  
require_once($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php');  
$o['host'] = 'http://ВАШСАЙТ.РУ';
$sape = new SAPE_client($o);
$tpl->set('', $sape->return_links());

внимание, не забудьте вставить свой код вместо звёздочек*.

В шаблон main.tpl в различных местах вставьте теги для вывода ссылок:

Откройте index.php и ПЕРЕД строкой:

$tpl->compile ( 'main' );

вставьте:

define('_SAPE_USER', '********************');  
require_once($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php');
if (substr($_SERVER['REDIRECT_URL'], 0, 6) == "/tags/") {
$host['request_uri'] = str_replace ("+", "+", str_replace ("/", "/", rawurlencode ($_SERVER['REDIRECT_URL'])));
} else {
$host['request_uri'] = $_SERVER['REDIRECT_URL'];
}

$sape = new SAPE_client($host);
$tpl->set('', $sape->return_links());

внимание, не забудьте вставить свой код вместо звёздочек*.

В шаблон main.tpl в различных местах вставьте теги для вывода ссылок:

Откройте index.php и ПЕРЕД строкой:

$tpl->compile ( 'main' );

вставьте:

define('_SAPE_USER', '********************');  
require_once($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php');  
$o['multi_site'] = true;
$sape = new SAPE_client($o);
$tpl->set('', $sape->return_links());

внимание, не забудьте вставить свой код вместо звёздочек*.

В шаблон main.tpl в различных местах вставьте теги для вывода ссылок:

В этом случае мы выводим ссылки тремя блоками 2+1+оставшиеся ссылки если их купили

Откройте index.php и ПЕРЕД строкой:

$tpl->compile ( 'main' );

вставьте:

define('_SAPE_USER', '********************');  
require_once($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php');  
$sape = new SAPE_client();
$tpl->set('{links1}', $sape->return_links(2));
$tpl->set('{links2}', $sape->return_links(1));
$tpl->set('', $sape->return_links());

внимание, не забудьте вставить свой код вместо звёздочек*.

В шаблон main.tpl в различных местах вставьте теги для вывода ссылок:
{links1}, {links2} и


Прокомментирую код в данном варианте для того чтобы вы могли сами выводить нужное вам количество блоков на страницу(2,3 или 4) с нужным вам количеством ссылок в каждом блоке:
Смотрим интересующие нас строки которые мы вставили в index.php

......

$tpl->set('{links1}', $sape->return_links(2));
$tpl->set('{links2}', $sape->return_links(1));
$tpl->set('', $sape->return_links());

{linкs1}, {linкs2}, {linкs} - это подключенные теги для вывода в шаблоне их же мы и потом вставим в шаблон там где захотим вывести каждый из них.
rеturn_linкs(2) - где 2 это максимальное количество ссылок которое мы выведем в этом блоке.

Из приведённого примера кода становится ясно что мы собираемся вывести в шаблон сайта три блока:
в первом блоке({linкs1}) выводим до двух ссылок, так как в rеturn_linкs у нас 2, если их купили(а если купили всего одну то выведется одна);
во втором блоке({linкs2}) выводим ещё одну(третью), так как в rеturn_linкs у нас 1, если она куплена;
в третьем блоке({linкs}) выводим оставшиеся(третью, четвёртую), если они есть и куплены.

На основе комментария теперь ясно как сделать нужное количество блоков, если захотим сделать два блока, то удалим строку с {linкs2} из кода который подключаем в index.php, оставив только строки с {linкs1} и {linкs} и не будем вставлять этот тег в main.tpl; ну а если захотим создать четвёртый блок то после строки с подключением тега {linкs2} добавим строку с подключением тега {linкs3}, не забыв указать количество ссылок в rеturn_linкs и потом вставить тег ещё одного блока в main.tpl.

Есть ещё один способ подключения и вывода ссылок в блоке, с возможностью скрытия блока если ссылки на странице не куплены.
Это способ подключения от WWW.ZEOS.IN скачать: zeos_sape.rar [1,92 Kb]



Очень неплохая возможность для заработка, это продажа ссылок со страниц для печати, особенно если учесть что в DLE их очень хорошо индексирует Яндекс, но Вы должны будете в Настройках скрипта разрешить их индексацию, а в шаблоне полной новости и статичной страницы должны быть ссылки на страницу печати.

Для подключения страниц для печати откройте show.full.php и static.php(engine/modules/) и после строки:

if( ! defined( 'DATALIFEENGINE' ) ) {
    die( "Hacking attempt!" );
}

вставьте:

define('_SAPE_USER', '********************');  
require_once($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php');  
$sape = new SAPE_client();
$tpl->set('', $sape->return_links());

внимание, не забудьте вставить свой код вместо звёздочек*.

В файлы шаблонов print.tpl и static_print.tpl в папке templates в нужном месте после тега { full-stоrу} вставьте тег для вывода ссылок:

Продавать контекстные ссылки с главных страниц и кратких новостей не имеет смысла так как они динамичны и вскоре после продажи ссылки краткая новость переместится на вторую а затем и следующие страницы сайта и естественно упадёт в error. Поэтому подключаем мы контекстные ссылки к полной новости.
Откройте show.full.php(engine/modules/)
Ищем:

$tpl->set( '{short-story}', stripslashes( $row['short_story'] ) );

После вставляем:

if (!defined('_SAPE_USER')){
define('_SAPE_USER', '*************');
}  
require_once($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php');
$sape_context = new SAPE_context();

$row['full_story'] = $sape_context->replace_in_text_segment( $row['full_story'] );

Не забыв заменить звёздочки* на свой код

На этом установка кодов закончена и теперь необходимо очистить кеш движка, а затем через ftp или панель управления хостингом зайти в папку Sape (ту, что Вы скачали и залили себе на хост) и удалить в ней все файлы кроме sape.php(удалить: links.db, words.db и articles.db - этот если есть).

Переходим к завершающей части.



Если вы закрыли страницу добавления площадки в интерфейсе Sape, то опять откройте


В разделе Мои площадки жмём кнопку Добавить площадку, а если не закрывали страницу


переходим в её низ и выбираем там категорию сайта, вводим его URL и жмём кнопку Добавить сайт

и теперь два варианта развития событий:

1. код на страницах нашёлся и сайт успешно добавился, а мы переходим к активации страниц, установке цен и его настройкам в Sape;
2. код не найден на страницах и вас просят указать любую страницу с размещённым кодом.

Если биржа не нашла кода на вашем сайте, то причин может быть несколько:
совершили ошибку при установке кода или зачем-то переименовали папку скаченную с Sape, а может забыли выставить атрибуты 777 на неё;
блок вывода ссылок на вашем сайте закрыт от индексации или тегом noindex или в robots.txt;
невалидный шаблон(попробуйте для проверки временно его сменить, Sape очень чуствительна к недружелюбным или незакрытым тегам);
запрещены исходящие подключения на вашем сервере(хостинге);
ваш хостинг блокирует IP паука Sape;
у вас нет бубна или вы не исполнили с ним танец.
Если всё перечисленное не ваш случай пишите в support Sape, бывают глюки и у них, правда отвечают они не совсем оперативно.

Внимание! после любых изменений в коде или выводе ссылок, а также при ошибках, Вам необходимо очищать кеш движка и через ftp или панель управления хостингом зайти в папку Sape (ту, что Вы скачали и залили себе на хост) и удалить все файлы в ней кроме sape.php(удалить: links.db, words.db и articles.db - этот если есть).

Успешно добавленная площадка уходит на индексацию пауком Sape и последующую модерацию в системе, а вам предстоит выставить уровень цен и активировать страницы, а самое главное - активировать нужно только те страницы которые проиндексированы Яндексом(не индексированные Яндексом удалите до следующей индексации), иначе модератор отклонить площадку и вам всё равно придётся это сделать, но при этом понадобится ещё и ожидать перемодерацию площадки, написав заявку на повторную модерацию с указанием того, что вы исправили.

Удалите из биржи те страницы, которые у вас закрыты от индексации в robots.txt, иначе они упадут в error после покупки на них ссылок, а из найденых пауком контекстных страниц удалите те ,которые всегда динамичны и не имеют постоянного адреса или те страницы, которые не имеют контента.


а проверить индексацию страницы в Яндексе можно кликнув на YAP рядом с ссылкой на страницу в интерфейсе.

О всех настройках успешно добавленой площадки можно прочитать в FAQ Sape, а здесь мы посоветуем пока обратить внимание на настройки количества ссылок на страницах, их настоятельно рекомендуем оставить не более двух, а так же определиться с тем будут ли заявки подтверждатся автоматически.



И ещё никакие ссылки сразу после модерации площадки у вас сразу не появятся их ещё должны купить, если у вас в настройках не установлен Автоматический режим приёма ссылок, то заявки ещё придётся подтверждать, поэтому для начала попробуйте Автоматический режим приёма ссылок, а позже освоившись в интерфейсе и настройках Биржи уже окончательно решите какой режим выбрать.



Мы чуть облегчили для вас установку начальных настроек площадки, опубликовав чуть выше два скрина: скрин примерных настроек 1 и скрин примерных настроек 2

Если вы не уверены в правильности установки кода, можете это проверить:

Приводим пример проверки для Варианта 1 установки кода.

временно замените в нашем коде строку:

$sape = new SAPE_client();

на

$o['force_show_code'] = true;
$sape = new SAPE_client($o);

и увидите закомментированное число или строку

<!--check code-->

или например

<!--566784897554-->

в исходном коде страницы в том месте, где вы хотите размещать ссылки.
Файл links.db в папке скаченной с Sape и загруженной в корень вашего сайта, так же подтверждает корректную работу, если в нём содержатся ссылки, когда они уже у вас куплены.

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

Возможные статусы ссылок:
* OK — когда ссылка найдена роботом SAPE
* ERROR — когда по каким-то причинам ссылка не размещена на указанной странице.
* WAIT — ссылка ожидает одобрения оптимизатора для размещения на площадке (по истечении 7 дней такая ссылка снимется автоматически).
* SLEEP — ссылка заблокирована из-за нулевого баланса оптимизатора(при значении B) или ссылка заблокирована оптимизатором самостоятельно по неизвестное причине(при значении M). Ссылка не размещается и не занимает места.

Важное:
Изучив интерфейс системы и работу с настройками площадки, когда у вас уже начнут покупать ссылки и они будут выводится без ошибок, рекомендуем ещё более обезопасить свой сайт от санкций Поисковых систем в отношении продажных ссылок, отключив Автоматический режим приёма ссылок начните модерировать каждую заявку, отметая ссылки сайтов сомнительного или вредоносного содержания, а так же не проиндексированые сайты, иначе существует опасность попадания вашего сайта под фильтры. Одобряйте ссылки сайтов схожей тематики и ссылки сайтов, которые имеют общие ключевики с вашей страницей на которой их хотят купить, а главное не увлекайтесь количеством продажных ссылок на одной странице, напоминаю - оптимально это 2 ссылки.

Остальное за вами, удачной работы!



Если Вы ещё не работали с Articles.Sape то Вам необходимо Зарегистрироваться.

1. Войдя в свой аккаунт. переходим на вкладку Биржи статей - Статьи.

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

3. Теперь добавляем возможность вывода анонсов, открываем файл index.php:
найти:

$tpl->compile ('main');

и перед ним вставляем один из Вариантов кода приведённого ниже:

Вариант 1. Вариант для тех кто не использует Биржу для продажи ссылок, а хочет только подключить продажу статей или использует модуль Sape:(говоря проще способ для тех у кого код Sape не вписан в index.php)

if (!defined('_SAPE_USER')){
        define('_SAPE_USER', '***********');
     }
     require_once($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php');
     $sape_article = new SAPE_articles();
     $tpl->set( '{announce}', $sape_article->return_announcements() );

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

Вариант 2. Вариант для тех у кого подключена уже в файле index.php продажа ссылок и он хочет подключить продажу статей:

В Ваш код подключения ссылок Sape добавляем в конце кода Sape только две строки:

$sape_article = new SAPE_articles();
$tpl->set( '{announce}', $sape_article->return_announcements() );

и у вас например получится вот так(ваш код может отличатся обращаем внимание на пример):

if (!defined('_SAPE_USER')){
define('_SAPE_USER', '**********');
}
require_once($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php');
$sape = new SAPE_client();
$tpl->set( '', $sape->return_links() );
$sape_article = new SAPE_articles();
$tpl->set( '{announce}', $sape_article->return_announcements() );

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

Открываем main.tpl и в удобном для Вас месте выводим анонсы:

{announce}

4. Теперь внизу на странице Добавления площадки в интерфейсе Биржи статей прописываем URL вашего сайта и нажимаем кнопку Добавить


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

6. В Управлении ценами устанавливаем цены и количество мест под анонсы на страницах и так же сохраняем.

7. Создаём шаблон вывода статей:
В папке своего шаблона создадим файл main_sape.tpl
открываем ваш main.tpl копируем всё его содержимое в main_sape.tpl

находим:

{headers}

и меняем на:

<title>{title}</title>
<meta name="keywords" content="{keywords}" />
<meta name="description" content="{description}" />

находим:

{info} {content}

и меняем на:

{header} {body}

8. Подключаем шаблон вывода статей:
В файле index.php находим строку:

$tpl->load_template ( 'main.tpl' );

и заменяем на:

if($_GET['do'] == "sape")
$tpl->load_template ( 'main_sape.tpl' );
else
$tpl->load_template ( 'main.tpl' );

и теперь наш шаблон доступен по адресу: http://www.сайт.ру/?do=sape
при переходе на данную страницу Вы увидите два тега:

{header} {body}

- это нормально.

9. В настройках площадки на вкладке Шаблоны статей внизу указываем имя(любое на Ваш выбор) и url расположения шаблона:

http://ваш_сайт.ру/?do=sape

и нажимаем Добавить.

10. В настройках площадки на вкладке Шаблоны URL'ов внизу указываем url(предлагаю самый оптимальный):

/publik/{id}-{name}.html

и нажимаем Добавить. Не уходим с этой вкладки мы на неё ещё вернёмся после редактирования ещё одного файла.

Открываем .htaccess и после:

# Редиректы
RewriteRule ^page/(.*)$ index.php?cstart=$1 [L]

добавляем:

#Articles rules
RewriteCond %{ENV:REDIRECT_STATUS} ^$
RewriteRule ^publik/([0-9]+)-([a-z0-9\_\-]+)\.html$ /***********.php [L]

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

ну и теперь на вкладке Шаблоны URL'ов внизу Активируем(текст активировать справа от url-a) тот URL, который добавили перед редактированием .htaccess.

Всё ждем модерации площадки! Напоминаю: согласно правилам ТИЦ площадки не должен быть менее 10 и возраст сайта не менее 6месяцев и др.