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

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

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

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

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

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

Дополнение включает библиотеку 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. Заполните поля:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. Защита App Password:

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

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