|
Инструкция по инсталляции модулей Firebook
1.Состав модулей
| FirebookInstal.cgi | - основной инсталляционный модуль, используется только на этапе инсталляции
| | firebook.cgi | - основной модуль Гостевой книги
| | Firebook.pm | - модуль Гостевой книги (подпрограммы)
| | FirebookCreate.pm | - дополнительный модуль
| | readme.txt | - инструкция по инсталляции
| | readme_en.txt | - инструкция по инсталляции на английском
| | images | - папка с рабочими элементами дизайна: bgr, smiles,code,templat
|
2. Загрузка модулей на сервер.
2.1. Распакуйте архив Firebook.zip
2.2. Создайте в директории cgi-bin вашего сервера поддиректорию cgi-bin/firebook, или любую другую поддиректорию
2.3. Закачайте по FTP в директорию cgi-bin/firebook модули из п.1., включая инструкции и папку images
2.4. Средствами своего FTP-клиента cделайте модули исполняемыми.
Присвойте файлам FirebookInstal.cgi и firebook.cgi Атрибут: - 755.
К примеру для Windows Commander:
Инструменты -> Изменить атрибуты -> (Владелец=Выполнение, Член_группы=Выполнение, Прочие=Выполнение)
3. Инсталляция модулей
3.1. Наберите в строке браузера адрес основного инсталляционного модуля:
httр://ваш_сервер/cgi-bin/firebook/FirebookInstal.cgi
3.2. Установите свой личный пароль для входа в программу Инсталляции.
ВНИМАНИЕ! Не устанавливайте простых паролей, не облегчайте работу хакерам!
3.3. Установите свой e-mail, он будет записан в текст модуля и на него будут высылаться служебные сообщения
3.4. Установите язык интерфейса - русский или английский
3.5. Введите пароль и войдите в программу инсталляции.
3.6. Заполните форму создания гостевой книги.
3.6.1. Укажите имя вашего сервера (по умолчанию он будет указан)
3.6.2. Укажите корневую папку вашего сервера (по умолчанию она будет указана)
3.6.3. Укажите ваш e-mail (по умолчанию e-mail администратора)
3.6.4. Укажите название гостевой книги.
Название гостевой книги определяется именем папки, в которой будут находиться файлы гостевой книги. Папка будет располагаться в корневой директории, которую вы укажете. Если у вас есть домен третьего уровня, то вы можете создать гостевую в нем, указав название домена и соответствующую корневую папку.
3.6.5 Нажмите на кнопку "Создать гостевую книгу"
Примечание 1: По указанному алгоритму можно создать множество гостевых книг, последовательно указывая различные имена папок.
Примечание 2: При создании первой гостевой книги происходит инсталляция:
- программа проверяет наличие необходимых модулей на вашем сервере и корректирует тексты модулей;
- создается Аккаунт Администратора, включающий ваш логин (e-mail) и сгенерированный 4-значный пароль для работы в режиме администратора;
- создается рабочая папка firebook, общая для всех гостевых вашего ресурса, туда копируются все необходимые файлы из папки images, которую вы поместили в cgi-bin.
Примечание 3: Если вы включите опцию "Инсталлировать только исполняемые модули", то название гостевой можно не указывать. Это требуется в том случае, если вы хотите обновить программу, или если вы хотите подключить дополнительные модули, к примеру FirebookImages.pm. Имейте виду, что механический перенос инсталлированных модулей с сервера на сервер выдаст ошибку. В любом случае, чтобы получить работающую программу, требуется штатная инсталляция модулей.
Примечание 4. Если вы включите ссылку "Загрузить только элементы дизайна", то
в рабочую папку /firebook/images/ будут заново загружены элементы дизайна. Если программа не найдет папку cgi-bin/images, то элементы дизайна будут загружаться с сервера разработчика httр://firebook.ru. Это может занять некоторое время.
Примечание 5. Если вы повторите процедуру инсталяции для уже созданной гостевой книги, то все установочные файлы в папке /имя_гостевой/ (п.п.4.3.1-4.3.6) будут созданы заново.
Исполняемые модули при создании каждой новой гостевой также инсталлируются заново (если вы не установили режимы НЕ Инсталлировать Модули и НЕ Загружать Элементы Дизайна).
Файл Аккаунтов (п.4.2.1) файл Глобальных настроек (п.4.2.2) и файл Реестра ( п.4.3.3) остаются без изменения.
Сообщения (если они были) в папке /имя_гостевой/guest остаются не тронутыми.
Личные тексты в папке /имя_гостевой/text останутся не тронутыми.
Архив в папке /имя_гостевой/archiv останется не тронутым.
Примечание 6. Удалить Гостевую книгу можно из интерфейса гостевой.
Примечание 7. Чтобы изменить пароль для входа в модуль Инсталляции, перезагрузите по FTP модуль FirebookInstal.cgi.
4. Папки и файлы
При инсталляции модулей и создании гостевой книги на вашем сервере будут созданы следующие папки и файлы.
4.1. В корневой папке:
4.1.1. /firebook - папка с общими рабочими элементам для всех гостевых книг
4.1.2. /имя_гостевой - собственно Гостевая книга, папка, включающая все элементы одной гостевой
4.2. В папке /firebook:
4.2.1. /firebook/Account.txt - файл аккаунтов всех посетителей вашего ресурса и Администратора ресурса
4.2.2. /firebook/mainGlob.txt - файл с общими установками для всех гостевых книг вашего ресурса
4.2.3. firebook/mainReestrBooks.txt - реестр гостевых книг вашего ресурса.
Каждая строка реестра описывает основные индивидуальные параметры для каждой гостевой - размер дискового пространства, аккаунт хозяина гостевой.
4.2.2 /firebook/images - папка с элементами дизайна
4.2.2.1. /firebook/images/bgr - папка с несколькими бэкграундами
4.2.2.2. /firebook/images/smiles - папка со смайликами
4.2.2.3. /firebook/images/templat - папка с элементами дизайна
4.2.3. /firebook/logsbook - папка с лог-файлами по каждой гостевой и общим лог-файлом
4.3. Папка - Гостевая книга (к примеру guestbook)
4.3.1. .htaccess
4.3.2. index.html - основная форма вашей гостевой
4.3.3. main.txt - файл с основными настройками
4.3.4. user.txt - файл фиксации посетителей гостевой. Фиксируются только те посетители, кто оставил сообщение.
4.3.5. style.css - таблица стилей
4.3.6. Head.txt LeftPanel.txt RightPanel.txt FormaPost.txt FormaText.txt FormaAdd.txt Dizain.txt Info.txt - формы элементов странички
4.3.7. guest - папка с файлами сообщений
4.3.8. text - папка с файлами хозяина гостевой книги
4.3.9. images - папка для загрузки рабочих изображений
4.3.10. img - галерея изображений
4.3.11. img/my - галерея изображений для "избранных"
4.3.12. archiv - архив сообщений
5. Работа с гостевой книгой в режиме администратора.
5.1. Режим администрирования поддерживается куками, которые устанавливаются в ваш браузер, когда вы входите в режим администратора. Куки Администратора устанавливаются на 6 часов.
По истечении 6 часов вам нужно повторить вход в режим администратора.
5.2. Вход в режим администратора осуществляется в интерфейсе гостевой книги по ссылке "Авторизация" или "Редактировать аккаунт"
5.3. В режиме Администратора вам будет доступна "Панель администратора".
5.4. Аккаунт администратора отличается от аккаунта посетителя уровнем доступа.
Администратор ресурса имет доступ dop=10, администратор гостевой книги dop=5, пользователи dop=1.
Ресурс может обьединять множество разных гостевых, у каждой из которых может быть свой администратор.
6.Гарантии
6.1. Разработчик гарантирует работоспособность программы при условии штатной инсталляции модулей.
6.2. Ресурс разработчика httр://firebook.ru/
| 
