Введение

Программа Связка является одноуровневым каталогом ссылок на ресурсы сети Интернет. Связка предназначена для автоматизированного ведения каталога ссылок.

Связка разработана компанией INDevelopment.

Связка предназначена для автоматизации следующей деятельности:

• Ведение каталога ссылок;
• Проверка обратных ссылок;
• Уведомление администраторов о добавлении ссылок на их ресурсы;

Основными объектами системы являются: категория, ссылка, администратор, очередь на добавление.

вверх

Структура программы

Программа состоит из нескольких модулей, написанных на php. Часть модулей является публичной, часть - нет. Имена закрытых модулей начинаются с символа подчеркивания "_".

Логическую структуру программы можно представить на следующем рисунке.

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

вверх

Системные требования

Для нормального функционирования программы требуется, чтобы на сайте было установлено программное обеспечение:

• PHP 4.3 или старше (PHP 5 может не поддерживаться Программой);
• Apache 1.3.х или старше (Apache 2 может не поддерживаться Программой);

вверх

Настройка

Вы можете изменить следующие элементы Программы:

• Общие параметры. Параметры задаются в файле _config.php. Для редактирования этого файла подойдет любой текстовый редактор. Текстовые параметры обрамляются апострофами или кавычками. После параметра ставиться точка с запятой. Вы можете изменить:
  • Количество категорий в строке, на главной странице (параметр $categories_per_row);
  • Количество ссылок на страницу (параметр $links_per_page);
  • Email для обратной связи: ваш email, по умолчанию он указывается только в уведомлениях о добавлении в каталог (параметр $admin_email);
  • Пароль для Администратора (не рекомендуется использовать пароли короче 5 символов, обязательно измените пароль перед использованием Программы, параметр $admin_pass);
  • Упрощенный код ссылки на ваш сайт для модуля проверки. Для модуля проверки требуется как можно более короткий код, поскольку на других сайтах может стоять измененный код вашей ссылки (параметр $back_link_check);
  • Код ссылки на ваш сайт (параметр $back_link);
  • Включить/выключить уведомление администраторов сайтов о добавлении/ удалении их ссылок (параметр $warn_webmasters, возможные значения: true - уведомлять, false - не уведомлять);
• Шаблон страниц. Шаблон страниц состоит из верхней и нижней частей страницы(_top и _bottom.php соответственно) и файла стилей(style.css). Файлы _top и _bottom.php содержат обычный html-код, который может быть произвольным(в стиле вашего сайта). Однако для _top.php обязательно наличие следующих строк:

  <?php
  session_start();
  if(!isset($_SESSION['admin']))
      $_SESSION['admin'] = false;
  ?>
  

  Файл style.css содержит ряд обязательных стилей.

  Стиль	Описание
  table.cattable	Стиль таблицы для списка категорий (на главной странице). В каждой ячейке таблицы по одной ссылке. Стиль ссылок: a.catelem, стиль ячеек: td.catelem.
  table.listtable	Стиль таблицы, в которую заключаются ссылки. Ссылки оформляются следующим образом: <table class="listtable" cellspacing="0" align="center"> <tr><td> <h1 class="listtable">Название категории</h1> </td></tr> <tr><td> Ссылки </td></tr> </table> См. также: Оформление ссылок
  td.catelem	Стиль ячейки таблицы с категориями.
  a.catelem	Стиль ссылок в ячейке таблицы с категориями.
  h1.listtable	Стиль заголовка (<h1>) категории, на странице категории.
  td.label	Стиль оформления ячеек подписей в таблице форм ввода. Формы используются, когда от пользователя требуется ввод данных (добавление ссылок, добавление категорий). Элементы в них оформляются в виде таблицы: подпись - поле. td.label - стиль ячейки с подписью.
  td.item	Стиль оформления ячеек элементов ввода в таблице форм ввода. Формы используются, когда от пользователя требуется ввод данных (добавление ссылок, добавление категорий). Элементы в них оформляются в виде таблицы: подпись - поле. td.item - стиль ячейки с полем.
  input.item	Стиль оформления полей ввода в формах. Формы используются, когда от пользователя требуется ввод данных (добавление ссылок, добавление категорий).
  select.item	Стиль оформления ниспадающих списков в формах. Формы используются, когда от пользователя требуется ввод данных (добавление ссылок, добавление категорий).
  p	Стиль оформления абзацев с текстом.
  table	Стиль оформления таблиц, по умолчанию.

• Оформление ссылок. Оформление ссылок определяется в файле _link.php. В файле необходимо определить функцию display_link (если это еще не сделано), следующего вида:

  function display_link($title, $descr, $href, $a_title)
  {
  print "<ссылка>";
  }
  

  Где <ссылка> - код, сформированный из переданных параметров.
  Параметры функции:
  $title - Заголовок
  $descr - Описание
  $href - URL
  $a_title - Текст ссылки

вверх

Добавление ссылки

Добавление ссылки - завершающий этап обмена ссылками. Она осуществляется следующим образом. Администратор другого ресурса(возможно, уже разместив нашу ссылку), заходит в модуль добавления ссылки - add.php, заполняет форму добавления ссылки, которая затем попадает в очередь на добавление.

Ссылка в Связке имеет несколько параметров:

• Идентификатор (присваивается системой);
• Заголовок;
• Описание;
• URL;
• Текст ссылки;
• Обратная ссылка;
• Email администратора сайта, на который размещена ссылка;
• Видимость (скрыта/доступна), по умолчанию ссылка добавояется видимой.

вверх

Уведомления

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

Включение. Для активации режима отправки уведомлений необходимо установить в файле _config.php значение параметра $warn_webmasters в true (или в false, для отключения).

Текст уведомлений. Определяется в файле _messages.php. В этом файле должна быть определа функция get_message, следующего вида:

function get_message($id, $cid, $lid)
{
    return "Текст сообщения";
}

вверх

Проверка ссылок

Связка хранит адреса обратных ссылок, поэтому возможна их проверка. Проверка осуществляется с помощью модуля check.php. Вы можете обратиться к нему, перейдя по ссылке "Проверить ссылки" в начале каталога.

Модуль формирует страницу, содержащую ссылки, обратные к которым не найдены.

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

Другим решением проблемы, может быть добавление следующих строк в начало файла check.php:

<?php
set_time_limit(0);
?>

Такое решение невозможно, если php работает в безопасном режиме. Вы можете узнать о безопасном режиме у Службы поддержки вашего Хостера.

В некоторых каталогах ссылок, ваша может "плавать", т.е. менять адрес страницы. В этом случае система будет выводить на экран такие ссылки.

вверх

Добавление ссылок

В обязанности администратора входит модерирование новых ссылок. Поэтому вам надлежит регулярно проверять очередь на добавление. Вы можете это сделать, перейдя по ссылке "Новые ссылки" в начале каталога, либо обратившись к модулю queue.php. Модуль может некорректно работать в браузере Opera.

Модуль отобразит новые ссылки. Вы можете принять/отклонить ссылку, либо изменить категорию для добавления. Принятие/отклонение ссылки производится с помощью переключателя справа. Он меняет свой цвет с голубого(для принимаемых ссылок) на оранжевый(для отклоненных). Для переключения, нажмите мышкой. Категорию можете выбрать с помощью ниспадающего списка. После завершения, нажмите кнопку "Готово".

вверх