Полная инструкция
по использованию Textolite

Подробное руководство по установке, настройке и использованию веб-редактора файлов Textolite. Все этапы с примерами, настройками и советами.

1. Требования

Системные требования

  • PHP 8.4 или выше - обязательное требование
  • Расширения PHP:
    • mbstring - для работы с многобайтовыми строками
    • json - для работы с JSON конфигурацией
    • openssl - для шифрования паролей и SMTP
  • Веб-сервер: Apache, Nginx или встроенный PHP сервер
  • Права на запись в директорию проекта
Проверка расширений Проверить установленные расширения можно командой: php -m

Структура проекта

После установки структура проекта выглядит следующим образом:

textolite/ ├── assets/ │ ├── css/ │ │ └── textolite.css # Стили интерфейса │ ├── img/ │ │ └── favicon.svg # Иконка сайта │ └── js/ │ └── textolite.js # JavaScript логика ├── index.php # Главный роутер ├── textolite-config.php # Конфигурация ├── textolite-auth.php # Авторизация ├── textolite-files.php # Файловые операции ├── textolite-api.php # API endpoints ├── textolite-mail.php # Отправка почты ├── textolite-ui.php # HTML шаблоны ├── send-email.php # Скрипт для отправки почты из форм └── .textolite-config.json # Файл конфигурации (создаётся автоматически)

2. Установка

Шаг 1: Копирование файлов

Скопируйте папку textolite в корневую директорию вашего сайта:

# Для Apache/Nginx cp -r textolite /var/www/html/ # Или для другого расположения cp -r textolite /path/to/your/website/

Шаг 2: Настройка прав доступа

Убедитесь, что веб-сервер имеет права на чтение/запись файлов:

# Установка прав на директорию chmod -R 755 /var/www/html/textolite # Если используется www-data (Apache) chown -R www-data:www-data /var/www/html/textolite # Если используется nginx (Nginx) chown -R nginx:nginx /var/www/html/textolite
Важно Файл .textolite-config.json будет создан автоматически при первом запуске и должен иметь права 0600 для безопасности.

Шаг 3: Проверка установки

Откройте в браузере адрес редактора:

https://ваш-сайт.ru/textolite/?q=admin

Если всё установлено правильно, вы увидите форму входа.

3. Первый вход

Пароль по умолчанию

При первом входе используйте пароль по умолчанию:

Пароль: admin
Критически важно! Сразу после первого входа обязательно смените пароль в настройках! Пароль по умолчанию известен всем и небезопасен.

Смена пароля

  1. Войдите в систему с паролем по умолчанию
  2. Нажмите кнопку "Настройки" в верхнем меню
  3. Перейдите на вкладку "Авторизация"
  4. Введите новый пароль в поле "Новый пароль"
  5. Нажмите кнопку "Сохранить"
Рекомендации по паролю Используйте надёжный пароль: минимум 8 символов, включая буквы (заглавные и строчные), цифры и специальные символы.

4. Интерфейс

Верхнее меню

В верхней части экрана расположены основные кнопки управления:

Кнопка Описание
Файлы Открыть/закрыть панель файлового менеджера
Настройки Открыть окно настроек редактора
Сохранить Сохранить текущий открытый файл (активна только при наличии изменений)
HTML / Текст Переключение между режимами редактирования (визуальный/код)
Сайт Открыть главную страницу сайта в новой вкладке

Файловый менеджер

Слева находится панель файлового менеджера со следующими возможностями:

  • 📁 Папки - отображаются с иконкой папки, можно открывать для просмотра содержимого
  • 📄 Файлы - отображаются с соответствующими иконками по типу файла
  • ↻ Обновить - обновить список файлов
  • ✕ Закрыть - скрыть панель файлового менеджера
  • + - создать новый файл или папку
Контекстное меню Правый клик по файлу или папке открывает контекстное меню с действиями: переименовать, удалить, загрузить.

Рабочая область

В центре находится область для редактирования файлов. Когда файл не открыт, отображается сообщение "Выберите файл для редактирования".

В зависимости от типа файла доступны разные режимы редактирования:

  • HTML файлы - визуальный режим (WYSIWYG) и режим кода
  • Файлы кода - редактор кода с подсветкой синтаксиса
  • Медиа файлы - просмотр в новой вкладке браузера

Футер

Внизу экрана отображается информация о текущем открытом файле:

  • Путь к файлу - полный путь относительно корня сайта
  • Размер файла - размер в байтах
  • Кодировка - автоматически определённая кодировка (UTF-8, Windows-1251, ISO-8859-1, ASCII)

5. Работа с файлами

Открытие файла

  1. Нажмите кнопку "Файлы" в верхнем меню
  2. В списке файлов найдите нужный файл
  3. Кликните по файлу для его открытия

Файлы открываются в зависимости от типа:

  • HTML файлы - можно редактировать в визуальном режиме (как на сайте) или в режиме кода
  • Файлы кода (CSS, JS, PHP и др.) - открываются в редакторе кода с подсветкой синтаксиса
  • Изображения и PDF - открываются для просмотра в новой вкладке браузера

Создание файла или папки

  1. Откройте файловый менеджер
  2. Нажмите кнопку "+" в верхней части менеджера
  3. Выберите тип: "Файл" или "Папка"
  4. Введите имя файла/папки
  5. Нажмите "Создать"
Совет Чтобы создать файл в подпапке, сначала перейдите в нужную папку, затем создайте файл.

Сохранение файла

После внесения изменений в файл:

  1. Нажмите кнопку "Сохранить" в верхнем меню
  2. Или используйте горячую клавишу: Ctrl+S (Cmd+S на Mac)

Кнопка "Сохранить" становится активной только после того, как вы внесли изменения в файл.

Удаление файла или папки

  1. Кликните правой кнопкой мыши на файл/папку в файловом менеджере
  2. Выберите "Удалить" в контекстном меню
  3. Подтвердите удаление
Внимание Удаление нельзя отменить! Будьте осторожны. При удалении папки удаляются все файлы внутри неё.

Переименование файла или папки

  1. Кликните правой кнопкой мыши на файл/папку
  2. Выберите "Переименовать"
  3. Введите новое имя
  4. Нажмите Enter или кнопку подтверждения

6. Режимы редактирования

Режим HTML (визуальное редактирование)

Для HTML файлов доступен визуальный режим редактирования:

  1. Откройте HTML файл
  2. Нажмите кнопку "HTML" в верхнем меню
  3. Редактируйте содержимое как на обычной веб-странице

Особенности:

  • Видно как будет выглядеть страница
  • Можно редактировать текст напрямую
  • Автоматически применяются стили и скрипты страницы
  • Поддержка iframe с полной изоляцией
Настройки визуального редактора В настройках можно включить/отключить выполнение скриптов и применение стилей в iframe, а также автоматическое преобразование ссылок на изображения.

Режим Текст (редактирование кода)

Для всех редактируемых файлов доступен режим кода:

  1. Откройте файл
  2. Нажмите кнопку "Текст" в верхнем меню
  3. Редактируйте исходный код

Возможности:

  • Подсветка синтаксиса для разных языков программирования
  • Номера строк (можно отключить в настройках)
  • Автодополнение табуляции
  • Отмена/повтор действий (Ctrl+Z / Ctrl+Y)
  • Настраиваемый размер шрифта и табуляции

Горячие клавиши:

  • Ctrl+Z - отменить последнее действие
  • Ctrl+Y или Ctrl+Shift+Z - повторить действие
  • Tab - добавить отступ
  • Shift+Tab - убрать отступ
  • Ctrl+S - сохранить файл

Поддерживаемые форматы файлов

Редактируемые в визуальном редакторе:

  • HTML, HTM

Редактируемые в редакторе кода:

  • Веб-технологии: HTML, HTM, CSS, JS, JSON, XML
  • Препроцессоры: SCSS, SASS, LESS
  • TypeScript: TS, JSX, TSX
  • Серверные языки: PHP
  • Языки программирования: PY (Python), JAVA, C, CPP, H, HPP, RB (Ruby), GO, RS (Rust), SWIFT, KT (Kotlin)
  • Скрипты: SH, BASH
  • Конфигурационные: YAML, YML, SQL, INI, CONF, LOG
  • Документация: TXT, MD (Markdown)

Просматриваемые (мультимедиа):

  • Изображения: JPG, JPEG, PNG, GIF, SVG, WEBP, BMP, ICO
  • Видео: MP4, WEBM
  • Аудио: MP3, WAV, OGG
  • Документы: PDF

7. Настройки

Авторизация

Настройки безопасности и доступа:

  • Новый пароль - измените пароль для входа (оставьте пустым, чтобы не менять)
  • Попыток авторизации - сколько раз можно ввести неправильный пароль перед блокировкой (1-10, по умолчанию: 5)
  • Длительность блокировки - на сколько часов блокируется IP после превышения лимита попыток (0.5-24, по умолчанию: 1)
  • Завершение сессии - через сколько минут неактивности произойдёт автоматический выход (5-1440, по умолчанию: 30)
  • Перенаправлять на сайт после выхода - включить редирект на главную страницу при выходе
Кнопка "Выход" Находится внизу вкладки "Авторизация" справа. Используйте её для безопасного выхода из системы.

Визуальный редактор

Настройки для режима HTML редактирования:

  • Включить скрипты - выполнять JavaScript код на странице при редактировании
  • Включить стили - применять CSS стили при редактировании
  • Автоматически изменять ссылки изображений - преобразовывать ссылки <a> на изображения в теги <img>
  • Удалять нелатинские символы - автоматически очищать имена файлов от кириллицы и других символов

Редактор кода

Настройки для режима редактирования кода:

  • Размер шрифта - от 9 до 20 пикселей (по умолчанию: 14)
  • Размер табуляции - количество пробелов для отступа (1-8, по умолчанию: 4)
  • Показывать номера строк - отображать номера строк слева от кода
  • Подсветка синтаксиса - включать цветовую подсветку кода
  • Максимальное количество шагов отмены - сколько действий можно отменить (1-100, по умолчанию: 50)

Файловый менеджер

  • Отображать размер каталогов - показывать общий размер папок (может замедлять работу на больших директориях)

Система

  • Главная страница или файл сайта - имя главного файла сайта (обычно index.html или index.php)
  • Сообщать о появлении новых версий - получать уведомления о выходе новых версий Textolite
  • Сообщать о появлении новых бета-версий - получать уведомления о бета-версиях
  • Язык интерфейса - выбрать язык: Русский (ru) или English (en)

8. Настройка SMTP

Параметры SMTP

Для работы отправки почты настройте параметры в разделе "Почта":

  • SMTP сервер - адрес SMTP сервера (например: smtp.yandex.ru)
  • SMTP порт - порт SMTP (обычно 587 для STARTTLS или 465 для SSL)
  • SSL/TLS - включить использование шифрования
  • Логин - полный email адрес для авторизации
  • Пароль - пароль от почтового ящика или пароль приложения
  • Email отправителя - email адрес, который будет указан как отправитель
  • Имя отправителя - имя, которое будет отображаться как отправитель

Примеры настроек для популярных почтовых сервисов

Yandex:

  • SMTP сервер: smtp.yandex.ru
  • SMTP порт: 465 (SSL) или 587 (STARTTLS)
  • SSL/TLS: Да
  • Логин: полный email (например: user@yandex.ru)
  • Пароль: пароль приложения (рекомендуется)

Gmail:

  • SMTP сервер: smtp.gmail.com
  • SMTP порт: 587 (STARTTLS) или 465 (SSL)
  • SSL/TLS: Да
  • Логин: полный email
  • Пароль: пароль приложения (обязательно для Gmail)

Mail.ru:

  • SMTP сервер: smtp.mail.ru
  • SMTP порт: 465 (SSL) или 587 (STARTTLS)
  • SSL/TLS: Да
  • Логин: полный email
  • Пароль: пароль приложения (для аккаунтов с 2FA)

Использование отправки почты

После настройки SMTP вы можете использовать скрипт send-email.php для отправки писем из форм на вашем сайте.

Примеры использования находятся в настройках Textolite (раздел "Почта"):

  • HTML форма с полями email, name, subject, message
  • AJAX запрос с минимальным набором данных
  • PHP код для прямой отправки
Автоматическое использование настроек Скрипт send-email.php автоматически использует настройки SMTP из конфигурации Textolite.

9. API Endpoints

GET запросы

Endpoint Описание
GET ?q=api/list&path=<путь> Получить список файлов в директории
GET ?q=api/read&path=<путь> Прочитать содержимое файла
GET ?q=api/get-config Получить текущую конфигурацию

POST запросы

Endpoint Параметры Описание
POST ?q=api/save path, content Сохранить файл
POST ?q=api/create path, type Создать файл/директорию
POST ?q=api/delete path Удалить файл/директорию
POST ?q=api/rename path, newName Переименовать
POST ?q=api/change-password password Изменить пароль
POST ?q=api/update-auth-config JSON с настройками Обновить настройки авторизации
POST ?q=api/update-mail-config JSON с настройками Обновить настройки почты
Безопасность API Все API запросы требуют авторизации. Ответы возвращаются в формате JSON.

10. Безопасность

Защита паролей

  • Пароли хранятся в зашифрованном виде в .textolite-config.json
  • Файл конфигурации защищён правами доступа (0600)
  • Используется шифрование через OpenSSL

Защита от атак

  • Path Traversal Protection - защита от попыток выхода за пределы разрешённых директорий
  • Блокировка IP - автоматическая блокировка IP после множественных неудачных попыток входа
  • Таймаут сессии - автоматический выход при бездействии
  • Защита системных файлов - запрет редактирования файлов самого Textolite

Рекомендации по безопасности

  • Сразу после первого входа смените пароль!
  • Используйте надёжный пароль (минимум 8 символов, буквы и цифры)
  • Регулярно проверяйте настройки авторизации
  • Не делитесь паролем с другими людьми
  • Используйте HTTPS для доступа к редактору
  • Регулярно проверяйте логи на наличие подозрительной активности

11. Решение проблем

Проблемы с входом

Не могу войти с паролем по умолчанию:

  • Убедитесь, что используете правильный пароль: admin
  • Проверьте, что файл .textolite-config.json создан и доступен
  • Очистите кэш браузера и попробуйте снова

IP заблокирован:

  • Подождите указанное время блокировки
  • Или удалите файл .auth-lockouts.json для сброса блокировок

Проблемы с файлами

Не могу сохранить файл:

  • Проверьте права доступа к файлу и директории
  • Убедитесь, что веб-сервер имеет права на запись
  • Проверьте, что файл не защищён от записи

Файлы не отображаются:

  • Проверьте права доступа к директории
  • Убедитесь, что веб-сервер имеет права на чтение
  • Попробуйте обновить список файлов (кнопка "Обновить")

Проблемы с SMTP

Письма не отправляются:

  • Проверьте правильность настроек SMTP
  • Убедитесь, что используете правильный порт (587 или 465)
  • Для Gmail обязательно используйте пароль приложения
  • Проверьте, что SSL/TLS включён
  • Проверьте логи веб-сервера на наличие ошибок