Документация по системе комментирования 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 Запись послених сообщений для главного сайта и поддоменов
4.2.1.2.8 Показать последнее сообщение с помощью javascript .



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

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

Папка 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. - logo.png
15. - right-arrow.png
16. - smilie.gif
17. - style_1_4.css
18. - terminator_cyr_semi-expanded_bold.ttf
19. - translit_1_4.php
20. - user.png
21. - 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" Адрес для входа в админку должен быть такой:

Внимание! Если вы нажали по верхней ссылке, то вы должны увидеть вот такое:
Это сделано просто для того, чтобы разные дятлы(и их творения) не приходили и не долбились в данную форму. Здесь мы освещали тему безопасности., но у вас есть возможность не пользоваться этой функцией!


4.1.А. Пароль и авторизация в системе.
1. Вводим желаем имя и пароль.
2. Если все прошло удачно, то вы должны увидеть соответствующее сообщение и далее с теми данными, который были отправлены, вы можете войти в систему:
3. Если теперь вы откроете тестовую страницу , либо страницу с коментами, вы должны увидеть требование системы...
Какие данные обязательны!? Нажмите отправить в само низу страницы и система сама скажет, без каких данных она не сможет функционировать!
4. Форма входа должна закрыться от посторонних автоматически! Открыть, закрыть - это кнопка no_form. Протестировать нужно на другом браузере, где не запущена сессия админа.



4.1.B. Изменить логин и пароль. 1. Ищем в админке, слово выйти.
2. Идем в папку __admin – удаляем файл 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» идем в строку .
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 - строка № 709 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.
Если вы хотите использоваться другой аватар, то при следующем комментарии, нужно выбрать другой аватар.