Документация по системе комментирования COMMENTS+ ( 4 версии )

1. Что будет нового!?
2. Общая информация
2.1. Подключение системы
2.2. Подключение системы к поддомену
2.2.1. Дополнительно...
2.3. Тестовая страница
3. Обязательные условия

4. Папка COMMENTS_1_4(основная папка со скриптом)
4.1. Вход, выход, настройки "__admin"
4.1.А. Авторизоваться в системе.
4.1.B. Изменить логин и пароль.
4.1.C. Интеграция в свою админку
4.1.D. Аватар админа
4.1.E. Вход со страницы.
4.1.F. Безопасность
4.1.G. Цена за безопасность
4.2.1. Основной файл настроек(__data.dat)
4.2.1.1. DEMO
4.2.1.2. Дополнительные возможности админа
4.2.1.2.1 Удалить сообщение пользователя.
4.2.1.2.2 Скрыть сообщение пользователя.
4.2.1.2.3 Опубликовать сообщение пользователя.
4.2.1.2.4 Закрепить сообщение.
4.2.1.2.5 Открепить сообщение.
4.2.1.2.6 Показать последнее сообщение.
4.2.1.2.7 Запись послених сообщений для главного сайта и поддоменов




5.3. "__form_for_comments.php"
5.3.A. Аватар, обработка + сессия пользователя.
5.3.B Загрузка своего аватара
5.4. Файл javascript "__js.js"

15. BBcode
15.1. Как это работает!?
15.2. Смайлы

99. Проблемы

Папка comments_1_4 4. Папки:
4.1. "__admin" - вход выход админу
4.2. "blocks" - все, что наименее активно будет лежать в этой папке... ,
Показать файлыСкрыть файлы
1. - _FORM.php
2. - __all.php
3. - __data.dat
4. - __is_it_time_for_send.dat
5. - __is_new_coment.dat
6. - __result_buttom.php
7. - __smiles.php
8. - Папка со смайлами _smaile
9. - Папка со смайлами _smaile_girl
10. - admin.png
11. - autosize.min.js
12. - email.png
13. - hand_no_foto.png
14. - lang
15. - logo.png
16. - right-arrow.png
17. - smilie.gif
18. - style_1_4.css
19. - terminator_cyr_semi-expanded_bold.ttf
20. - translit_1_4.php
21. - user.png
22. - youtube.gif
4.3. "store" - папка с сообщениями.
4.4. "ava" - папка загруженных аватаров.

5. Файлы:
5.1. "__config.php"
5.2. "__head.php"
5.3. "__form_for_comments.php"
5.4. "__js.js"
5.5. "test_page_comments_1_4.html"

4.1. "__admin" Если папку comments_1_4 поместили в корневую папку, то адрес на вход должен быть такой:
4.1.А. Авторизоваться в системе. Если вы открыли ссылку авторизации админа, и увидели вот такую картину:


1. То вам нужно открыть файл конфиг "__config.php"
и в строке 219 перед $all_data['write_cookie'] - поставить или убрать восклицательный знак.
Сохраняем файл с измененными данными => загружаем на сервер.
2. Возвращаемся на страницу авторизации.
3. Перезагружаем данные, и у вас должна появиться страница авторизации.
Если скрин не такой, то см. пункт №8
4. Вводим данные, авторизуемся.
5. После авторизации копируем адрес в даресной строке, идем в дургой браузер, и проверяем, что выдает там, если вы видите установите пароль -то все правильно! если вы видите страницу авторизации то:
6. Возвращаемся в файл "__config.php" - возвращаем все на место.
7. Загружаем файл "__config.php" на сервер.

Если вдруг! 8. И после этого вы видите приведенный скрин(а это возможно, слишком долго объяснить...), возвращаемся в пункт 1 и в этой же строке 219 , либо ставим, либо убираем вопросительный знак перед $all_data['write_cookie']! Т.е. нужно сделать наооборот.
9. Проделываем все операции с пункта 2 до 7.
10. Для проверки правильности, открываем ссылку авторизации в другом браузере. либо в этом же, только зайти нужно анонимно! И вы должны увидеть опять скрин установить пароль - теперь! После вашей авторизации - никто не мог увидеть форму авторизации!

4.1.B. Как изменить логин и пароль?
1. Открываем папку «__admin» -
2. Ищем файл «lp.dat» - удаляем!
3. Перезагружаем страницу авторизации!
Вы должны увидеть вот такую страницу создания заново логина и пароля.
4. Если пароль и логин записаны, то вы увидите форму авторизации и можете войти с новыми данными!


4.1.C. Интеграция в свою админку Если у вас уже есть админка и запуск сессии админа, то наши коменты можно интегрировать с любой сессией админа, на любом сайте!
1. Первое, что нужно проверить, а может и ничего делать не нужно!
Заходим на свой сайт «админом» и идем на страницу авторизации коментов…
и если вы видите такую страницу, то вам действительно ничего делать не нужно!
Это скорее исключение, но название вашей сессии админа такая же, как и у нас…
2. Если вы пролетели в пункте 1, то ничего страшного!
Спокойно! Я с Вами!
Вам нужно узнать где запускается сессия админа на вашем сайте.
Обычно она запускается в скрипте, который обрабатывает вход в админку.
Это должно выглядеть примерно так:
3. Вам нужно впереди запуска вашей сессии поставить нашу сессию админа… строка должна выглядеть так:

Ещё.


4.1.D. Аватар админа В любом из выше перечисленных пунктов, если запустилась сессия админа(наших коментов) - $_SESSION['admin'], то зайдя на тестовую страницу.
Адрес которой должен быть, при расположении папки в корневой папке…
Вы должны увидеть аватар админа:
Для изменения аватара - поступаем аналогично

4.1.E. Вход со страницы. Наводим мышку на горизонтальную линию, после главной формы… - это вход в админку.
Если вы авторизованы, то вас вернёт на страницу, откуда вы пришли!

4.1.F. Безопасность Безопасность - это, наверное самое сложное!
Со всех щелей лезут гаденыши!
Давно я хотел себе сделать такую вещь, но никак руки не доходили, а тут я конкретно за морочился!
Как это работает!? 1. Вы входите на сайт в форме авторизации! И если вы выбираете запомнить, то создается кука на год!
2. После того, как данные приняты, в наш файл с данными записывается переменная «write_cookie =1»…
3. Если переменная write_cookie существует, то всем желающим увидеть форму никак не получится..., а будет показываться все тот же скрин:
4. Естественно, что мы в процессе! И в том числе потому. что самим нужна эта система.
И ! ! ! После того, как вы авторизуетесь, выше показанного скрина вы не увидите, потому, что там будет настройки комментирования, см. ДЕМО

5. Пока вы самолично не нажмете кнопку выйти, никто и никогда – форму входа не увидит…

4.1.G. Цена за безопасность Если вдруг, пропали куки, и нет сессии, то вам придется войти и обновить и куки и сессию!
Но к сожалению!
За все приходится платить!
Я имею ввиду предыдущий пункт – безопасность!

Запись в файле дат существует, а куки нет.
От кук запускается сессия.
А от «дат» не избавится без сессии … замкнутый круг !

Поэтому!

1. Для решения этой проблемы, нам придется обратиться к файлу «__config.php» идем в строку 219 .
2. Впереди переменной $all_data['write_cookie'] убираем восклицательный знак или ставим(меняем ан противоположный).
3. Загружаем на сервер,
4. Идем на страницу авторизации!
5. Авторизуется. Копируем из адресной строки адрес, идем в другой браузер и проверяем, что выдает, если вы видите установите пароль - то все хорошо! Если нет то далее по списку...
6. Возвращаемся в файл «__config.php», возвращаем все на место.
7. Загружаем на сервер,

P.S. Вчера написал вариант, но он был настолько опасный, поэтому, решил подумать вариант попроще и безопаснее!
К сожалению, повторюсь, этот замкнутый круг, никак не обойти! Можно, конечно, но тогда придется городить еще больший огород!

5.3 __form_for_comments.php" 5.3.A. Аватар, обработка + сессия пользователя. Подойдя к теме аватара… пришло понимание, что каждую строчку описывать невозможно!
Поэтому, только логика, и если уж никак без объяснения…, то будут подробности!

Начало скрипта строка Конец скрипта
1. Аватар будет зависеть от емайла, (кроме админа - заранее известный путь).
Для пользователя - в любом случае в сессию пользователя запишем емайл пропущенный через md5 - строка № 716 2. Если свой аватар не был загружен, то аватар будет по умолчанию


3. Если аватар был уже ранее загружен, то его помещаем в переменную $imgAva - для отображения в форме.
$img_hidden - для записи в файл,$face_user_file - для сохранения в папке.
3.1. Аватар в коментах, для каждой отдельной строки будет проверять на существование создавая путь из md5_email (если существует, а если нет, то по умолчанию)
4. Для аватара(например) будет доступен такой адрес...
http://ВАШ_САЙТ/comments_1_4/ava/73/734c845f260e89987d3125bba2d08ff3.png


5. Дополнительная папка "73" -создалась автоматически...из первых двух символов md5_email(это сделано для того, чтобы не загружать аватрки в одну папку...)
6. Количество возможный вариаций папок = 38 * 38 = 1444 - вопрос на засыпку... откуда цифры...

5.3.B. Загрузка аватара 1.
Аватар можно загрузить свой, стандартный выбор фото, max высота, ширина 100px, и не более 30 кб.
При нажатии на аватар рядом с формой ввода сообщения.
Для того, чтобы скрыть форму - надо опять нажать по аватару.


2.
Если вы ввели тот же самый емайл, при повторном сообщении, то аватар установится автоматически, тот, который загрузили в пункте №5.3.B.1..
3.
Если вы хотите использоваться другой аватар, то при следующем комментарии, нужно выбрать другой аватар.