|
Manlix Guestbook - гостевая книга, написана на php.
|
|
|
- Мульти-админ (управление скриптом несколькими людьми, 19 уровней доступа).
- ВСТРОЕННЫЙ РУССКИЙ ЯЗЫК МИНИ-ПРОГРАММИРОВАНИЯ.
- Вся база хранится в обычных текстовых файлах.
- Умная система анти-флуд.
- Система антимат (автозамена).
- Система блокировки (банлист).
- Система замены смайликов в сообщениях.
- Есть возможность закрывать гостевую книгу.
- Всё управление скриптом производится, через веб интерфейс.
- Добавление ответов к сообщениям.
- Редактирование ответов на сообщения.
- Удаление ответов на сообщения.
- Редактирование непонравившихся сообщений.
- Удаление непонравившихся сообщений.
- Поля: имя, сайт, почта, аська, сообщение.
- Полное изменение дизайна под любой сайт.
- Русская дата в сообщениях [Пример: 03 Мая, 2003 (Суббота, 15:46)].
- При добавлении сообщения, данные посетителя добавляются в куки (cookie).
- Навигация по страница следующего вида:
<< < 01 02 03 04 05 06 07 08 09 > >>
- Использование шаблонов.
- Создание своих шаблонов.
- Редактирование шаблонов.
- Поддержка большинства современных веб браузеров.
- Корректная работа скрипта, при error_reporting=E_ALL
- Корректная работа скрипта, при register_globals=Off
|
|
|
- Веб сервер
- PHP (4.1.0 или выше)
|
|
|
|
Добавленные или обновившееся файлы в этой версии |
|
|
|
файл: index.php |
файл: admin.php |
файл: inc/config.inc.dat |
файл: inc/functions.inc.php |
файл: inc/interpreter.inc.php |
файл: inc/templates/default/message.inc.html |
|
|
|
index.php | 660 |
admin.php | 660 |
images | 770 |
images/*.* | 660 |
images/smiles | 770 |
images/smiles/*.* | 660 |
inc | 770 |
inc/templates | 770 |
inc/templates/* | 770 |
inc/templates/*/*.* | 660 |
inc/*.dat | 660 |
inc/*.php | 660 |
Обратите внимание!
ЕСЛИ ВЫ ПОЛЬЗУЕТЕСЬ БЕСЛАТЫНМ ХОСТИНГОМ, то скорей всего CHMOD нужно ставить другой, обычно у таких хостеров есть свой F.A.Q. обязательно почитайте его, а то скажите, что мол скрипт не рабочий, а на самом деле окажется, что CHMOD не такой какой надо поставили. |
|
|
|
НЕ УСТАНАВЛИВАЙТЕ СКРИПТ В ПАПКУ CGI-BIN
- Создайте на своём веб сервере папку guestbook.
- Загрузите в неё файл index.php и две папки images & inc (вместе с их содержимом).
- Установите на файлы скрипта CHMOD (права доступа, установить их можно из почти любовго ftp клиента).
- Откройте веб браузер, введите в нём: http://ВашСайт/guestbook/index.php
- Если Вы увидели перед собой гостевую книгу, значит она у Вас работает :)
|
|
|
|
ИНФОРМАЦИЯ СПЕЦИАЛЬНО ДЛЯ ЛЮБИТЕЛЕЙ INCLUDE(), REQUIRE() И SSI |
|
|
|
Настоятельно рекомендую использовать шаблоны, не зря же их придумали,
ну и собственно не зря же я написал три раздела для работы с ними в
управлении скриптом (admin.php).
Если Вы всё-таки противитесь, то скажу минусы, из-за которых Вы точно
будете использовать шаблоны :) И так, при не использовании шаблонов Вас ждёт:
(имеется ввиду, если Вы вставите скрипт, куда-нибудь с помощью include(),
require() или ssi)
1. Отключение сохранение информации посетителя в куки (cookie)
при добавлении сообщения.
2. Отключение умной системы анти-флуд.
Думаете, что я специально Вам это отключу? :( Анн нет...
|
|
|
По-умолчанию, к управлению скриптом установлена следующая информация: Имя админа: admin Пароль: password
После того, как Вы загрузите сам скрипт на веб сайт, настоятельно рекомендую создать в управлении скриптом (admin.php) нового админа, с новым паролем (раздел админ -> добавление нового админа), а админа с именем admin удалить (раздел админ -> удаление админа).
|
|
|
|
Установка новых смайликов |
|
|
|
Все смайлики хранятся в папке images/smiles
Например, если в сообщении есть :20: и в папке images/smiles
существует файл с именем 20.gif, то :20: автоматически заменится
на графический файл 20.gif, если же такой файл не существует в
папке images/smiles, то :20: так и останется :20: ничего не заменится :)
Чтобы добавить в базу смайлик :abcd: просто-таки добавьте в папку
images/smiles файл abcd.gif
Вместо abcd, можно использовать следующие символы: A-Z, a-z, 0-9, - и _
|
|
|
Константы выглядят следующим образом @название_константы@, вставлять их нужно в шаблоны (управлять ими можно,
через управление скриптом (admin.php)). Каждая константа, содержит какую-либо информацию, вся эта информация указана ниже:
Шаблон "форма" |
@error@ | ошибка |
@cookie_name@ | имя посетителя, считывается из кук (cookie) |
@cookie_homepage@ | сайт посетителя, считывается из кук (cookie) |
@cookie_mail@ | адрес почты посетителя, считывается из кук (cookie) |
@cookie_icq@ | номер icq, считывается из кук (cookie) |
@cookie_message@ | сообщение посетителя, считывается из кук (cookie), если есть ошибка |
Шаблон "сообщение" |
@name@ | имя того, кто добавил сообщения |
@nameJS@ | имя того, кто добавил сообщения (для JS скриптов) |
@bgcolor@ | цвет чётный или нечётный, взависимости от номера сообщения |
@message@ | сообщение того, кто добавил сообщения |
@homepage@ | сайт того, кто добавил сообщения |
@mail@ | адрес почты того, кто добавил сообщения |
@icq@ | icq номер того, кто добавил сообщения |
@author@ | автор (один из админов) ответа на сообщение |
@answer@ | ответ админа |
@num@ | номер сообщения |
Шаблон "низ" |
@navigation@ | навигация по страница гостевой книги |
@AllMessages@ | кол-во сообщений в гостевой книге |
Системные константы (берутся из файла параметров скрипта, можно использовать в любых шаблонах) |
@IniDirPath@ | папка, в которой хранится сам скрипт |
@IniDirInc@ | системная папка скрипта |
@IniDirTemplates@ | папка в которой хранятся шаблоны |
@IniDirImages@ | папка, в которой хранятся картинки |
@IniDirSmiles@ | папка, в которой хранятся смайлики |
@IniFileBase@ | файл, в котором хранится база сообщений |
@IniFileFunctions@ | файл с функциями для скрипта |
@IniFileInterpreter@ | файл для работы с русским мини-языком программирования |
@IniFileAdmins@ | файл, в котором хранятся имена админов, их пароли и права доступа |
@IniFileAutochange@ | файл, с базой антимата (автозамена) |
@IniFileBanlist@ | файл, в котором хранится инфорамция о тех посетителях, которым заблокирован доступ в гостевую книгу |
@IniUrlGeneral@ | полный url до скрипта |
@IniUrlImages@ | url до картинок |
@IniUrlSmiles@ | url до смайликов |
@IniSymbolLeft@ | левый символ в навигации |
@IniSymbolRight@ | правый символ в навигации |
@IniSymbolSeparator_between_pages@ | разделитель между номерами страниц в навигации |
@IniNumericShow_messages@ | кол-во сообщений на одной странице |
@IniNumericShow_pages@ | кол-во страниц в навигации |
@IniNumericMin_name@ | минимальный размер имени в символах |
@IniNumericMax_name@ | максимальный размер имени в символах |
@IniNumericMin_icq@ | минимальный размер номера icq |
@IniNumericMax_message@ | максимальное кол-во символов в сообщении |
@IniNumericMax_word@ | максимальная длина каждого слова в сообщении |
@IniNumericFlood@ | через сколько минут после добавления сообщения, можно добавлять ещё одно сообщение |
@IniNumericShow_smiles@ | кол-во смайликов в одной строке (под формой) |
@IniTemplateParse@ | шаблон, который использует скрипт |
@IniTemplatesTop@ | имя шаблона "верхушка" |
@IniTemplatesForm@ | имя шаблона "форма" |
@IniTemplatesNo_messages@ | имя шаблона "нет сообщений" |
@IniTemplatesMessage@ | имя шаблона "сообщение" |
@IniTemplatesBottom@ | имя шаблона "низ" |
@IniTemplatesOkay@ | имя шаблона "сообщение добавлено" |
@IniTemplatesClosed@ | имя шаблона "гостевая книга закрыта" |
@IniClosedClosed@ | статус гостевой книги (0 - открыта, 1 - закрыта) |
@IniClosedMessages@ | если гостевая книга закрыта, то показывать ли сообщения, которые есть в базе? (0 - нет, 1 - да) |
@IniScriptName@ | название скрипта |
@IniScriptPrefix@ | префикс для кук (cookie) |
@IniScriptRussian@ | имя скрипта, но по-русски |
@IniScriptVersion@ | версия скрипта |
@IniScriptInfo@ | дополниетльная информация |
@IniColorCurrent_page@ | цвет текущей страницы в навигации |
@IniColorNot_current_page@ | цвет нетекущей страницы в навигации |
@IniColorEven@ | цвет для чёта |
@IniColorUneven@ | цвет для нечёта |
@IniColorActive_symbol@ | цвет для активных, боковых символов в навигации |
@IniColorNot_active_symbol@ | цвет для неактивных, боковых символов в нацигации |
|
|
|
|
Русский мини-язык программирования |
|
|
|
- Зачем он вообще нужен?
- Ответ прост: для облегчения и более расширенной работы скрипта для опытных пользователей.
Как он дествует?
- Его нужно писать в самом начале строки какого-либо шаблона, и действует он только на той строчке, на которой был записан, на данный момент этот язык умеет понимать, только одно условие, а именно если. Все операторы и переменные, нужно вводить, через пробел.
Примеры, с использованием оператора если:
-
- если сайт определён
Сайт: @homepage@
Описание: в этом примере, проверяется ввёл ли посетитель, адрес своей домашней странички, если ввёл, то скрипт выведет Сайт: @homepage@ (в переменной @homepage@ хранится сам адрес), а если нет, то эта строчка превратится в ноль, т.е. вообще не выводиться.
если - оператор
сайт - переменная
определена - условие
Существующие переменные:
- сайт
- почта
- ася
- ответ
- навигация
- чётная
- ошибка
Условия класса истина
- есть
- существует
- определён
- определенно
- определена
- определены
Условия класса ложь
- пустая
- пуста
- пустое
- пусты
- пуст
Подключаем в какой-нибудь шаблон текстовый файл:
-
- подключить d:/server/www/MyFile.html текст
Используем встроенный "русский мини-язык программирования".
Подключаем в какой-нибудь шаблон php файл:
-
- подключить d:/server/www/MyFile.php пхп
Опять же используем встроенный "русский мини-язык программирования".
|
|
|
|
- admin.php - управление скриптом.
- index.php - скрипт выведет первые несколько сообщений + навигацию по страницам гостевой книги.
- index.php?guestbook_page=5 - скрипт выведет 5 страницу гостевой книги
- index.php?guestbook_page=all - скрипт выведет все сообщения гостевой книгы на одной странице.
|
|
|
Мой скрипт ялвяется полностью БЕСПЛАТНЫМ, можете добавлять его в свои каталоги, на дискеты, на CD-ROM`ы, куда угодно...
|
|
|
- версия 1.4
-
- Исправлены найденные ошибки.
- Новая константа @nameJS@ для шаблона "сообщение", в ней хранится имя того, кто добавил сообщение, добавлена специально для работы с js скриптами.
- версия 1.3
-
- Теперь в файлы шаблонов можно подключать php и текстовые файлы с html кодом из любой папки.
- Исправлены найденные ошибки.
- Написано небольшое руководство по "русскому мини-языку программирования".
- версия 1.2
-
- Добавлена поддержка браузеров: Mozilla, Netscape и Opera.
- Теперь при щелчке по имени автора какого-нибудь сообщения, это имя автоматически добавляется в поле для сообщения.
- Исправлены мелкие ошибки.
- Новая переменная в русском мини-языке программирования: чётная (определяет тип сообщения: чётное или нечётное)
- Много новых констант (например: @IniScriptName@), автоматически берутся из файла параметров скрипта.
- Теперь сообщения в управлении скриптом выводятся в правильном порядке.
- Усовершенствована система замены смайликов в сообщении, засчёт этого:
У админа появилась возможность добавлять смайлики в свои ответы на сообщения. Экономится около 40 байт на каждое сообщение, в котором есть смайлик.
- Добавлен новый оператор "подключение", с помощью него можно подгружат в файлы шаблона php скрипты или обычный текст (с html кодом).
- Появилась возможность удалять ответы на сообщения.
- Появилась возможность редактировать сообщения пользователей.
- Появилась возможность закрывать гостевую книгу с двумя параметрами:
С выводом сообщений, которые есть в базе на данный момент. Без вывода сообщений.
- Добавлена система АнтиМат (автозамена).
- версия 1.1
-
- Добавлено ограничение на использование тегов посетителями.
- Создан раздел "изменение параметров" в управлении скриптом (admin.php).
- Доделан раздел "просмотр параметров" в управлении скриптом (admin.php).
- версия 1.0
-
|
|
|
Как говорится: "сам себя не похвалишь - никто не похвалит", скрипт на самом деле уникальный :) Это первый скрипт в русском интернете, который имеет встроенный мини-язык программирования на родном, на русском языке. Он даёт большие возможности опытным пользователям. Так же хочу сказать ОГРОМНОЕ СПАСИБО за использование именно моего скрипта!
|
|
|