CW Guest Book
Соглашение
Скрипт распространяется "как есть", это значит, что автор не несёт ответственности за ущерб принесённый в результате использования этого скрипта. Пользователь может обращатся к автору с вопросами о работоспособности скрипта ТОЛЬКО в форуме или гостевой книге расположенных на сайте www.cwg.ru. Пользователь должен излагать проблему со всеми подробностями. Автор имеет право никак не реагировать на вопросы, если они ему не понятны. Скрипт может распространяться только вместе с этим документом и только бесплатно.
Copyright 2002© Корсаков Кирилл. All Rights Reserved.
Требования к серверу
Операционная система: Любая
Веб-сервер: Любой, рекомендуется Apache
Интерпретатор: Perl 5
Модули: не требуются
Назначение
Скрипт представляет собой гостевую книгу. С его помощью ваши посетители могут оставлять комментарии и какие-либо сообщения для вас прямо на вашем сайте.
Возможности
  1. Возможность полного изменения дизайна !!!
  2. Редактирование/удаление сообщений администратором
  3. Возможность ответа на сообщения
  4. Возможность вызова через SSI(на Apache-серверах)
  5. Сохранение IP-адреса автора сообщения
  6. Возможность запрета добавления сообщений с определённого IP
  7. Возможность автозамены слов. Например для замены текстовых смайлов на картинки
  8. Разбиение на страницы
  9. Возможность установки пределов на длину полей
  10. Автоматическая замена url и email адресов на ссылки
  11. Вырезание тегов
  12. Сохранение данных автора(Имя,email итд) в куках, для того чтобы не вводить их каждый раз вновь
  13. Возможность отправки новых сообщения на email администратору*
  14. Возможность ограничения длины списка страниц, используется если их очень много и список идёт в несколько строк
  15. Защита от повторного нажатия на кнопку "отправить"
* Эксперементальные функции, возможно, что работают некорректно
Установка
  1. Исправьте первую строку в файлах cgi-bin/guest.pl и cgi-bin/admin.pl на путь к Perl'у на сервере, чаще всего это /usr/bin/perl.
  2. Закачайте файлы из папки cgi-bin архива на сервер в директорию для CGI скриптов, чаще всего это /public_html/cgi-bin/ или просто /cgi-bin/ [узнать как]
  3. Установите разрещение 755(rwxr-xr-x) для файлов admin.pl и guest.pl, а для vars.pl - 600(rw-------) [узнать как]
  4. Войдите в администрирование скрипта через браузер (файл admin.pl) введите логин admin, пароль password, перейдите в раздел "Изменение настроек".
  5. Внизу страницы введите желаемый логин, старый пароль 'password', новый пароль (два раза) и нажмите на кнопку "Применить".
Обновление более ранней версии до v2.7
Если у вас уже уставновлен этот скрипт, то для того чтобы сохранились все настройки вам необходимо скачать архив обновления, закачать его содержимое на сервер в ту же директорию где скрипт был уставновлен ранее, уставновить для файла update.pl разрешение - 755 и открыть его в браузере. Скрипт обновит файлы настройки, после чего можно смело пользоваться гостевой!
Использование
Для того чтобы ваши посетители могли просматривать и добавлять коментарии в вашу гостевую книгу, вы должны поместить на странице либо ssi код, либо ссылку на перл-скрипт следующим образом:
SSI: <!--#include virtual="/cgi-bin/guest/guest.pl?${QUERY_STRING}">
Внимание! Для того чтобы книга корректно работала через SSI необходимо найти в шаблоне отправки сообщения тег <form ...> и заменить его параметры method=post и action=guest.pl на method=get и action="имя_ssi_документа" соответственно.
Ссылка: <a href="/cgi-bin/guest/guest.pl">Гостевая книга</a>
Гостевую книгу можно вызвать с дополнительными параметрами:
page - страница
pages - количество сообщений на странице, all - все
Примеры вызова:
http://my.site.com/cgi-bin/guest/guest.pl?page=2
http://my.site.com/cgi-bin/guest/guest.pl?pages=10
http://my.site.com/cgi-bin/guest/guest.pl?pages=all

Администрирование
Для администрирования гостевой книги вы должны вызвать скрипт admin.pl и ввести свой логин и пароль. Если ввод произведён корректно, то вы должны увидеть строчки:
1. Редактирование, удаление коментариев
2. Изменение дизайна
3. Изменение настроек гостевой книги
4. Автозамена текста
5. Список запретов

Редактирование, удаление коментариев
При нажатии на эту ссылку вы увидите все коментарии оставленные в вашей гостевой книге. Для удаления сообщения нажмите на кнопку del. Для изменения - измените необходимые поля и нажмите на кнопку change. Единственное, что у вас может вызвать вопросы, это формат поля Дата. 1 цифра в этом поле означает день недели(1-воскресенье,2-понедельник,3-вторник,4-среда,...,7-суббота). 2, 3, 4 цифры это дата(день, месяц, год). 5, 6, 7 - это время(часы, минуты, секунды).
В новой версие так же добавлена новая кнопка - "ban ip". Если вы хотите запретить автору сообщения оставлять записи в книге, то нажмите на эту кнопку.
Изменение дизайна
При нажатии на эту ссылку вы увидите несколько полей, с помощью которых можно менять дизайн книги. Если вы не знакомы с html, то лучше ничего не трогать. Ниже полей приводится список слов, которые автоматически заменяются на нужные элементы гостевой книги.
Изменение настроек гостевой книги
Первые две строчки - пароль, используйте их если хотите изменить пароль.
Третяя и четвёртая строчка являются необязательными и их назначение, надеюсь, всем понятно.
Поле "Сообщений на странице" - количество коментариев на странице по умолчанию.
Максимальная длина сообщения - определяет, какой максимальной длины может быть коментарий.
Максимальная длина имени, e-mail, url, города - эти поля выполняют функцию аналогичную предыдущей.
Максимальная длина слова - максимальное значение длины слова, если кто-то попытается ввести более длинное сообщение, то он получит сообщение об ошибке.
Количество страниц - максимальное количество страниц, которые будут показываться в списке.
поля Cookies - имена с которыми будет сохраняться информация о посетителе в куках, используйте только если поля в гостевой книге испоьзуется не по назначению, например если Город используется для ICQ, то необходимо написать icq в поле "Cookies(поле Город)"
Отправлять новые сообщения админу на e-mail - если отметить галочкой, то все новые сообщения будут присылатся вам по почте.
Автозамена текста
Здесь вы можете определить слова, которые автоматически будут заменяться на определённое вами слово, выражение.
Обратная связь
e-mail: cwg@cwg.ru
url: www.cwg.ru