ГОСТЕВАЯ КНИГА 1.25


Краткая информация / Аннотация
НазваниеГостевая книга
Версия1.25
Язык сообщенийРусский
Язык программированияPerl
АвторАндрей Юрин
E-mail автораandrey@script.ru
Homepage автораwww.script.ru
Назначение скриптаЭтот скрипт предназназначен для того, чтобы пользователи Вашего сервера могли оставлять свои пожелания, замечания и т.п. о работоспособности, дизайне вашего сервера или просто что-то сказать Вам и посетителям вашего сервера, при этом оставив адрес электронной почты и URL своей странички. Отличие этой программы от подобных заключается в том, что эта программа пользуется лишь одним html - файлом и очень легка в настройке



С возникающими вопросами Вы можете
обратиться к Андрею Юрину



Условия поставки
Эта программа предоставляется по принципу "AS IS", что в переводе: "КАК ЕСТЬ". Это означает, что автор не несет ответственности перед пользователем за неудобства (и т.п.), которые могут возникнуть при работе. Разработчик стремиться, чтобы такие "неудобства" не существовали.
Вы можете свободно пользоваться этой программой, передавать своим друзьям и т.д. Если Вы хотите использовать эту программу в коммерческих целях, то свяжитесь с автором этой программой через электронную почту по адресу andrey@script.ru
В комплект поставки программы входят следующие файлы:
  • gk.pl - Файл программы, написанный на языке Perl. Он находится в некомпилированном состоянии, поэтому Вы свободно можете вносить любые изменения в него, но для этого, скорее всего, Вам потребуется небольшое знание языка Perl.
  • gk.htm - HTML файл, через который происходит обращение к программе и в который происходит запись сообщений. В этом файле находится форма для введения параметров и сообщений. Если Вы хотите изменить этот файл, чтобы он не расходился с концепцией и дизайном Вашего сервера, то это не вызовет проблем, но нельзя забывать, что при модификации этого HTML файла нельзя изменять содержимое формы (т.е текст, который ограничивают теги "<FORM> и </FORM>").
  • styles.css - Файл каскадных стилей необходим для определения параметров шрифтов и страниц во всех выводимых HTML - документах. Вы свободно можете изменять его для своих потребностей.
  • readme.htm - Файл помощи по настройке и налаживанию работы программы в гипертекстовом формате (HTML).



  • Требования к системе
    Эта программа будет работать на той машине, на которой запускается стандартный дистрибутив PERL, его можно загрузить с www.perl.com, на этом сервере Вы можете найти PERL для различных операционных систем.
    Для запуска этой программы на машине с Win 95/98 Вам может потребоваться пакет Unix-утилит для DOS.

    Также для работы этой программы потребуется HTTP-сервер, способный запускать CGI-скрипты, написанные на языке Perl.
    Для Win 95/98 рекомендую Sambar Server, последнюю версию которого можно всегда загрузить с "Двух Коров" (www.tucows.com или tucows.infoart.ru) или с сервера www.script.ru
    Для Unix/Linux с успехом можно использовать Apache.



    Настройка скрипта
    Прежде всего необходимо правильно настроить программу, для этого можно воспользоваться текстовым редактором, который не сохраняет свои параметры в редактируемом файле.
    Необходимо открыть файл gk.pl и изменить некоторые параметры программы (значения некоторых переменных) после строки ##################################################
    # Определение переменных:
    ##################################################

    Процесс изменения параметров заключается в изменении текста, заключенного в кавычки. Вот переменные, которые необходимо настраивать:
  • # URL файла гостевой книги
    $guestbookurl = "http://127.0.0.1/gk.htm";

    Путь к HTML-файлу гостевой книги (URL страницы).
  • $styles_url = "http://127.0.0.1/styles.css";
    Путь к файлу каскадных стилей (URL и название css файла).
  • $guestbookreal = "../docs/gk.htm";
    Реальный путь к html-файлу гостевой книги - путь к директории, где хранятся ваши файлы и название файла, при изменении этой переменной стоит обратить внимание что путь должен быть относительно той директории, где хранятся исполняемый файл (gk.pl). Это значит, что если ваши perl-файлы хранятся в директории cgi-bin, а ваши документ, в директории docs, то надо не забыть написать в пути, что надо выйти из директории cgi-bin: "../", а затем войти в директорию docs: "docs", в итоге получается: "../docs/".
  • $cgiurl = "/cgi-bin/gk.pl";
    Путь к исполняемому файлу (URL и название pl файла).
  • Также Вам по необходимости можно изменить параметры в gk.htm. В основном это связано с методом отправки формы (GET или POST, в зависимости от Вашего сервера). А также с местонахождением исполняемой директории cgi-bin и исполняемым файлом. Измените (если требуется) URL gk.pl и метод отправки формы в HTML-файле:
    <form method="POST" action="/cgi-bin/gk.pl">



    Установка скрипта
    Установка программы заключается, в основном, в размещении файлов, входящих в комплект поставки, в правильные директории сервера, так, файлы gk.htm и styles.css должны быть размещены в директории, где храняться Ваши HTML - файлы, например DOCS, a файл gk.pl должен быть размещен в директории, где исполняются Perl-скрипты, например cgi-bin.



    История развития скрипта
    ВерсияЧто нового
    1.0Первая версия программы 26.08.98
    1.1Устранение некотрых недочетов и багов
    1.25
  • Документация теперь в гипертекстовом формате
  • Обновление документации
  • Коренное обновление интерфейса
  • Вывод сообщений в новом, удобочитаемом, формате
  • "Безопасные теги" - вывод тегов в текстовом виде
  • Дата и время при добавлении сообщения
  • Исправление некоторых недочетов и багов
  • © 1999, Андрей Юрин