Huntflow Menu Organizer

🚀 Chrome браузерное расширение для организации и категоризации вакансий в Huntflow

Это расширение позволяет HR-специалистам и рекрутерам эффективно организовывать большое количество вакансий в системе Huntflow, создавая пользовательские категории и легко перемещая вакансии между ними с помощью удобного drag & drop интерфейса.

🌟 Основные возможности

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

  • Создание неограниченного количества пользовательских категорий
  • Переименование категорий одним кликом
  • Удаление категорий с автоматическим перемещением вакансий в "Без категории"

• 🖱️ Интуитивное перемещение

  • Drag & Drop перетаскивание вакансий между категориями
  • Перемещение вакансий внутри категории для изменения порядка
  • Быстрое перемещение в "Без категории" через кнопку

• 🎛️ Удобный интерфейс

  • Сворачивание/разворачивание категорий для экономии места
  • Темная тема, полностью соответствующая дизайну Huntflow
  • Анимации и визуальные эффекты для лучшего UX

• 💾 Надежное сохранение

  • Автоматическое сохранение всех изменений в Chrome Storage
  • Сохранение состояния свернутых/развернутых категорий
  • Мгновенное восстановление структуры при обновлении страницы

📦 Установка

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

• Браузер: Google Chrome версии 88+ или Chromium-based браузеры
• Разрешения: Доступ к локальному хранилищу и скриптам
• Платформа: Windows, macOS, Linux

Установка для разработки и тестирования

1. Скачайте файлы расширения

   git clone <repository-url>
   # или скачайте ZIP архив

2. Загрузите расширение в Chrome

   • Откройте Chrome и перейдите в chrome://extensions/
   • Включите "Режим разработчика" в правом верхнем углу
   • Нажмите "Загрузить распакованное расширение"
   • Выберите папку с файлами этого проекта

3. Проверьте установку

   • Расширение должно появиться в списке установленных
   • Убедитесь, что переключатель расширения включен

🧪 Тестирование и использование

Локальное тестирование (рекомендуется)

1. Откройте тестовую страницу

   # Просто откройте файл в браузере
   open example.html

2. Проверьте функциональность

   • В левом сайдбаре должна появиться кнопка "+ Добавить категорию"
   • Создайте несколько категорий (например: "Приоритетные", "В работе", "Архив")
   • Протестируйте перетаскивание вакансий между категориями
   • Проверьте переименование и удаление категорий
   • Обновите страницу - структура должна сохраниться

Использование в реальном Huntflow

1. Перейдите в Huntflow

   • Откройте ваш аккаунт Huntflow
   • Перейдите в раздел "Мои вакансии"

2. Начните организацию

   • В левом сайдбаре со списком вакансий появится интерфейс плагина
   • Нажмите "+ Добавить категорию" для создания первой категории
   • Перетащите вакансии в соответствующие категории

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

   • Переименование: Нажмите ✏️ рядом с названием категории
   • Удаление: Нажмите 🗑️ (вакансии переместятся в "Без категории")
   • Сворачивание: Кликните по заголовку категории

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

huntflow-menu-organizer/
├── 📄 manifest.json       # Манифест Chrome расширения (Manifest V3)
├── 🔧 content.js          # Основная логика плагина и DOM манипуляции
├── 🎨 styles.css          # Стили интерфейса в тёмной теме Huntflow
├── 🌐 example.html        # Тестовая страница с примерами вакансий
├── 📖 CLAUDE.md           # Техническая документация для разработчиков
├── 📋 README.md           # Документация пользователя (этот файл)
└── 🗂️ Хантфлоу.mhtml      # Сохранённая страница для анализа разметки

⚙️ Технические характеристики

Параметр	Значение
Платформа	Chrome Extension Manifest V3
Языки программирования	JavaScript (ES6+), CSS3, HTML5
Фреймворки	Vanilla JavaScript (без зависимостей)
Хранение данных	Chrome Storage Local API
DOM Селекторы	Адаптивные селекторы для разных версий UI
Совместимость	Huntflow с различными версиями классов
Размер	~15KB (все файлы)

📈 История версий и обновления

Версия 1.2 (Текущая)

• ✅ Обновлённый дизайн: Интерфейс полностью адаптирован под нативный стиль Huntflow
• ✅ Закруглённые углы: Увеличены border-radius значения для всех элементов (12px для категорий, 10px для вакансий)
• ✅ Современные тени: Добавлены тонкие box-shadow эффекты для визуальной глубины
• ✅ Плавные анимации: Улучшены переходы с cubic-bezier кривыми для естественности
• ✅ Стильная кнопка: Переработана кнопка "Добавить категорию" с hover эффектами

Версия 1.1

• ✅ Улучшенная совместимость: Обновлены селекторы для поддержки titleText--sZxcF и titleText--CVA7z
• ✅ Гибкие CSS: Добавлена поддержка вариативных классов через [class*="titleText--"]
• ✅ Исправлен парсинг: Функция getVacancyData() теперь корректно извлекает данные
• ✅ Тестовая среда: Создана example.html для локального тестирования
• ✅ Улучшенная документация: Обновлён README и добавлен CLAUDE.md

Версия 1.0 (Базовая)

• ✅ Основной функционал drag & drop
• ✅ Создание, переименование, удаление категорий
• ✅ Сворачивание категорий
• ✅ Сохранение в Chrome Storage

🔧 Устранение неполадок

Часто встречающиеся проблемы

❌ Плагин не загружается на Huntflow

• Проверьте, что расширение включено в chrome://extensions/
• Убедитесь, что вы находитесь на странице "Мои вакансии"
• Очистите кэш браузера и перезагрузите страницу

❌ Кнопка "Добавить категорию" не появляется

• Откройте консоль разработчика (F12) и проверьте ошибки
• Убедитесь, что Huntflow полностью загрузился
• Попробуйте протестировать на example.html

❌ Drag & Drop не работает

• Проверьте, что вакансии полностью загружены
• Убедитесь, что курсор мыши находится точно на элементе вакансии
• Попробуйте сначала создать категорию

❌ Данные не сохраняются

• Проверьте разрешения расширения в настройках Chrome
• Убедитесь, что Chrome Storage API доступен
• Очистите хранилище расширения: DevTools → Application → Storage

Отладка

1. Откройте консоль разработчика (F12)
2. Проверьте вкладку Console на наличие ошибок JavaScript
3. Во вкладке Application → Storage → Extension проверьте сохранённые данные
4. Протестируйте на example.html для изоляции проблемы

🤝 Поддержка и обратная связь

Сообщить о проблеме

• Опишите проблему максимально подробно
• Укажите версию Chrome и операционную систему
• Приложите скриншот консоли с ошибками (если есть)
• Протестируйте проблему на example.html

Предложить улучшение

• Опишите желаемую функциональность
• Объясните, как это поможет в работе с Huntflow
• Приложите макеты или схемы (если применимо)

---

💡 Совет: При первом использовании рекомендуется протестировать все функции на example.html, чтобы понять логику работы плагина перед использованием в реальном Huntflow.

Разработчики: Zahar Izmailov: https://github.com/izzzzzi Alisher Gaffarov: https://github.com/Alik20021223 Идея: Alexey Naumenko https://github.com/alexey-naumenko Tg: @ooprizrakoo

Исходный код опубликован под лицензией GNU General Public License v3.0