Вопрос по сайту (площадке), который Вы намерены добавить в систему

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

<?php
     if (!defined('_SAPE_USER')){
        define('_SAPE_USER', 'ваш_хэш_код');
     }
     require_once(realpath($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php'));
     $sape = new SAPE_client();
?>

Далее, в тех местах страницы, где вы хотели бы выводить ссылки, необходимо вставить следующий код:

<?php 
    echo $sape->return_links($n); 
?> 

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

Пример: предположим, Вы планируете выводить на странице 5 ссылок в 3-х блоках, разнесенных в разные места страницы, например, 1 ссылку под левым навигационным меню, 2 ссылки под правым меню и оставшиеся 2 ссылки в «подвале» страницы. В этой ситуации вам необходимо сделать в исходном коде страницы 3 дополнительные php-вставки:

echo $sape->return_links(1); // под левым меню;

echo $sape->return_links(2); // под правым меню;

echo $sape->return_links();  // в «подвале» (обратите внимание, функция вызывается без параметра, т.к. это последний ее вызов на данной странице)

В том случае, если страница сайта собирается последовательным включением нескольких файлов (через include, require) или вызовом каких-либо функций, то для вызова кода внутри этих файлов или функций необходимо определить переменную $sape как глобальную при создании клиента и перед тем, как использовать ее.

То есть первоначальная инициация клиента будет иметь вид:

 <?php
    global $sape;
    if (!defined('_SAPE_USER')){
        define('_SAPE_USER', '64af559e55505dc136d734ad7fe3f62b');
    }
    require_once(realpath($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php'));
    $sape = new SAPE_client();
?>

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

<?php
    global $sape;
    echo $sape->return_links();
?>

Важно: для аккуратного оформления ссылок вы можете создать для них отдельный класс стилей CSS и указать название этого класса в разделе «настройки» Вашей площадки, который будет доступен после добавления сайта в систему.

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

в планируемом месте вывода ссылочного блока в исходном коде страницы необходимо произвести следующую php-вставку:

<?php
     if (!defined('_SAPE_USER')){
        define('_SAPE_USER', '64af559e55505dc136d734ad7fe3f62b');
     }
     require_once(realpath($_SERVER['DOCUMENT_ROOT'].'/'._SAPE_USER.'/sape.php'));
     $sape = new SAPE_client();
     echo $sape->return_links();
?>