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

I. Быстрая инструкция по изменению формата отображения ссылок

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

Чтобы отображать ссылки на сайте в формате блоков, выполните следующие шаги.

1. Убедитесь, что на вашем сайте установлен клиентский код версии, поддерживающей блочный вывод ссылок (например, не ниже 1.1.2 для платформы PHP);
   Скачать новый клиентский код можно на странице настроек сайта на вкладке «Код».
2. Зайдите на страницу настроек сайта, перейдите на вкладку «Отображение».
3. Далее обратитесь к параметру «Режим отображения».
   1. Если вы хотите, чтобы отображение всех ссылок на сайте переключилось в формат блоков, то установите значение «Только в формате блоков». Это значение стоит использовать для быстрого перехода на блочный формат отображения, править вызовы клиентского кода в этом случае не потребуется.
   2. Если вы хотите использовать на сайте как блочное, так и обычное отображение ссылок, то установите значение «Смешанный». В этом случае вызовы return_links(...) будут выводить ссылки в обычном формате. Для вывода ссылок в формате блоков нужно будет использовать новый метод return_block_links(...) .
4. Далее на этой же вкладке вы можете настроить внешний вид блока ссылок. Подробнее о настройках блока можно узнать в этом разделе.
5. После того, как вы закончите редактирование, нажмите кнопку «Применить». После этого наша система обновит параметры блока и попытается сбросить кэш сервера, отдающего файл links.db, а также попытается удалить старый файл links.db на сайте.
6. Если вы выполнили все шаги (разместили новый клиентский код, поменяли вызовы клиентского кода на сайте, изменили настройки блока), но формат отображения ссылок не изменился.
   1. Возможно, нашему сервису не удалось удалить links.db на вашем сайте. Попробуйте удалить файл links.db вручную и перезагрузить страницу сайта, которая содержит вызов клиентского кода
   2. Возможно, нашему серверу не удалось сбросить кеш. Попробуйте подождать 1 час, за это время кэш должен сброситься автоматичнски.
   3. Если после часа ожидания настройки блока не применились, то напишите в обратную связь с указанием сайта и шагов по установке нового кода, которые вы выполни. 

II. Технические подробности: вызовы клиентского кода

Для отображения блочных ссылок используйте метод return_block_links($n, $options). Этот метод будет отображать ссылки в формате блока вне зависимости от значения  параметра «Режим отображения» в настройках сайта.
 

Метод return_links($n, $options) будет отображать ссылки в обычном формате, только если параметр «Режим отображения» в настройках сайта установлен в значение «Смешанный». В противном случае этот метод будет работать как return_block_links()

Если методу return_links() передать $options['as_block'] = true, то он будет работать как return_block_links с соответствующими параметрами.

Некоторые параметры отображения ссылок в формате блока можно переопределить для отдельного блока, передав через параметр $options соответствующее значение.
Если значение не указано, то оно берется из настроек сайта.
 

Остальные параметры отображения будут одинаковыми для всех блоков на сайте и будут браться из настроек сайта (если используется таблица стилей CSS, сгенерированная клиентским кодом на основе настроек сайта).

Ориентация блока

<?php 
$options['block_orientation'] = (1|0);  
// Переопределяет ориентацию блока: 1 - горизонтальная, 0 - вертикальная 
?>

Пример1: вывод блока в вертикальной ориентации.

<?php 
$sape = new SAPE_client(); 
$options = array(); 
$options['block_orientation'] = 0; 
echo $sape->return_block_links(5, $options); 
?>

Ширина блока

<?php 
$options['block_width'] = ('auto'|'[?]px'|'[?]%'|'[?]');  
// Переопределяет ширину блока:  
// 'auto'  - определяется шириной блока-предка с фиксированной шириной,  
// если такового нет, то займет всю ширину 
// '[?]px' - значение в пикселях 
// '[?]%'  - значение в процентах от ширины блока-предка с фиксированной шириной 
// '[?]'   - любое другое значение, которое поддерживается спецификацией CSS 
?>

Пример2: вывод двух блоков шириной 500 пикселей и 50% соответственно.

<?php 
$sape = new SAPE_client(); 
$options = array(); 

$options['block_width'] = '500px'; 
echo $sape->return_block_links(5, $options); 

$options['block_width'] = '50%'; 
echo $sape->return_block_links(5, $options); 
?>

Отображение css в коде страницы

<?php 
$options['block_no_css'] = (false|true);  
// Переопределяет запрет на вывод css в коде страницы: false - выводить css 
?>

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

Примечание 2: если на странице требуется вывести несколько блоков без css, то параметр $options['block_no_css'] = false нужно указать для каждого из них.  
Пример 3: вывод блока без css. 

<?php 
$sape = new SAPE_client(); 
$options = array(); 
$options['block_no_css'] = true; 
echo $sape->return_block_links(5, $options); 
?>