Не найдено

WordPress Manager for NVDA — Подробное руководство

WordPress Manager — это профессиональное дополнение для NVDA (NonVisual Desktop Access), позволяющее незрячим и слабовидящим пользователям полноценно управлять сайтами на WordPress через удобный графический интерфейс. Дополнение интегрируется в системный трей Windows и предоставляет доступ ко всем основным функциям администрирования WordPress.

Ключевые возможности:

• Создание и публикация записей и страниц
• Управление комментариями (одобрение, пометка спамом, удаление)
• Настройка основных параметров сайта
• Поддержка HTML-контента
• Работа с категориями и метками
• Безопасное подключение через App Passwords

Требования и установка

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

• Активный WordPress сайт с поддержкой REST API (WordPress 4.7+)

Установка необходимых библиотек:

Дополнение включает библиотеку requests в папке lib. Если возникают проблемы с импортом:

1. Убедитесь, что папка lib существует в каталоге дополнения
2. При необходимости установите библиотеку вручную:
   pip install requests

Первоначальная настройка

1. Подготовка WordPress сайта

Создание App Password:

1. Войдите в админ-панель WordPress
2. Перейдите в Профиль → Настройки приложений
3. Создайте новый пароль приложения
4. Скопируйте сгенерированный пароль (он покажется только один раз!)

Проверка REST API:

Убедитесь, что REST API включен:

• Откройте в браузере: ваш-сайт.ru/wp-json/
• Должна отобразиться структура JSON

2. Настройка дополнения

Конфигурация аккаунта:

1. В системном трее найдите меню "WordPress Manager"
2. Выберите "Конфигурация аккаунта..."
3. Заполните поля:
   • URL сайта: Полный адрес (https://ваш-сайт.ru)
   • Имя пользователя: Логин администратора WordPress
   • Пароль приложения: Созданный ранее App Password

Важные примечания:

• URL должен начинаться с https:// для безопасного соединения
• Для HTTP соединения потребуется дополнительное подтверждение
• Данные сохраняются в конфигурации NVDA в зашифрованном виде

Основные функции

Структура меню:

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

1. Новый контент... — Создание записей и страниц
2. Управление комментариями... — Модерация комментариев
3. Настройки сайта... — Изменение параметров WordPress
4. Конфигурация аккаунта... — Настройка подключения
5. Посетить сайт — Открытие сайта в браузере
6. Поддержать разработчика — Переход на страницу доната

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

Все поля в диалогах имеют назначенные горячие клавиши (подчеркнутые буквы):

• Alt + подчеркнутая буква — быстрый доступ к полю
• Tab/Shift+Tab — навигация между элементами
• Enter — подтверждение действий в полях ввода

Работа с контентом

Создание записи/страницы:

Диалог "Создание контента" содержит:

Основные поля:

• Заголовок: Название материала
• Содержание: Текст контента (многострочное поле)
• Тип: Запись или Страница
• Статус: Черновик или Опубликовать

Дополнительные настройки:

• Разрешить HTML: Включение HTML-разметки в содержимом
• Метки (ID): ID меток через запятую
• Видимость: Публично или Приватно
• Пароль: Защита паролем (если требуется)
• Категории: Множественный выбор из списка (загружаются автоматически)

Особенности работы с содержимым:

• Поддержка многострочного ввода (Enter для новой строки)
• Автоматическая загрузка списка категорий при открытии диалога
• Поддержка HTML при включенной опции
• Возможность сохранения как черновика для дальнейшего редактирования

Процесс публикации:

1. Заполните обязательные поля (Заголовок, Содержание)
2. Выберите категории (опционально, но рекомендуется)
3. Укажите метки (ID через запятую, опционально)
4. Выберите тип (Запись или Страница) и статус
5. Настройте видимость и пароль при необходимости
6. Нажмите OK для публикации или сохранения черновика

Управление комментариями

Функционал модерации:

Загрузка комментариев:

• Автоматически загружаются 10 последних комментариев при открытии диалога
• Отображается автор и первые 50 символов текста комментария
• Список автоматически обновляется после выполнения действий

Доступные действия:

1. Одобрить — Публикация комментария на сайте
2. В спам — Пометить как спам и переместить в соответствующую папку
3. В корзину — Удаление комментария (возможно восстановление из корзины WordPress)

Процесс модерации:

1. Откройте "Управление комментариями..."
2. Дождитесь загрузки списка комментариев
3. Выберите комментарий из списка с помощью стрелок или мыши
4. Нажмите нужную кнопку действия (Одобрить, В спам, В корзину)
5. После обработки комментарий автоматически исчезнет из списка

Настройки сайта

Доступные параметры:

Основные настройки:

• Заголовок сайта: Отображается в шапке сайта и заголовке браузера
• Слоган: Краткое описание сайта, отображается под заголовком
• Записей на страницу: Количество материалов на странице архива (от 1 до 100)
• ID категории по умолчанию: Категория, которая будет автоматически присваиваться новым записям

Особенности работы:

• Все настройки автоматически загружаются с сайта при открытии диалога
• Изменения применяются немедленно после сохранения
• Поддерживается работа с числовыми и текстовыми параметрами
• Все изменения логируются WordPress API

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

Частые ошибки и решения:

1. "Требуется настройка"

Причина: Не указаны или неверно указаны данные подключения
Решение: Заполните все поля в "Конфигурация аккаунта..."

2. "Соединение не удалось"

Возможные причины:

• Неправильный URL сайта
• Проблемы с интернет-соединением
• Отключен REST API WordPress
• Блокировка файрволом или антивирусом

Проверка:

1. Убедитесь, что сайт доступен из браузера
2. Проверьте доступность REST API: ваш-сайт.ru/wp-json/
3. Перепроверьте логин и App Password
4. Временно отключите антивирус для проверки

3. "Код ошибки: 401"

Причина: Неверные учетные данные
Решение:

1. Создайте новый App Password в WordPress
2. Обновите настройки в дополнении
3. Убедитесь, что пользователь имеет необходимые права

4. "Код ошибки: 404"

Причина: Неправильный endpoint API или старая версия WordPress
Решение:

1. Убедитесь, что WordPress версии 4.7 или новее
2. Проверьте правильность URL в настройках
3. Убедитесь, что REST API не отключен плагинами

Логирование:

Дополнение не ведет собственных логов. Для диагностики проблем:

1. Включите отладку в настройках NVDA (NVDA+Ctrl+O → Общие → Уровень журнала)
2. Проверьте журнал NVDA (NVDA+F1)
3. Используйте инструменты разработчика браузера (F12) для проверки API-запросов
4. Проверьте логи ошибок WordPress в админ-панели

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

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

1. Используйте HTTPS

• Всегда указывайте URL с https://
• Не подтверждайте использование HTTP без крайней необходимости
• SSL-сертификат обязателен для безопасной передачи данных
• Регулярно обновляйте SSL-сертификаты

2. Защита App Password:

• Храните пароль приложения в надежном месте (менеджер паролей)
• Не используйте обычный пароль администратора WordPress
• Регулярно обновляйте App Passwords (раз в 3-6 месяцев)
• Удаляйте неиспользуемые App Passwords
• Ограничьте права App Password только необходимыми действиями

3. Ограничение прав пользователя:

• Создайте отдельного пользователя WordPress с минимальными необходимыми правами
• Используйте App Password только для этого пользователя
• Регулярно проверяйте список активных App Passwords в WordPress
• Отключайте App Passwords при подозрении на компрометацию

Хранение данных:

• Учетные данные хранятся в зашифрованном виде в конфигурации NVDA
• Пароли не отображаются в открытом виде (используется поле с маскировкой)
• Настройки доступны только текущему пользователю Windows
• Конфигурационные файлы находятся в защищенной директории пользователя