Введение
Ransack поможет вам легко добавить поиск в ваше Rails-приложение без каких-либо дополнительных зависимостей.
Существуют решения для расширенного поиска, такие как ElasticSearch или Algolia. Ransack выполнит эту работу для многих веб-сайтов Rails без необходимости запуска дополнительной инфраструктуры или работы на другом языке. С Ransack вы делаете все это с помощью стандартных Ruby и ERB.
Готовы выйти за рамки основ? Используйте расширенные функции, такие как i18n, и обширные возможности конфигурации.
Ransack поддерживается для Rails 7.2, 7.1, 7.0, 6.1 на Ruby 3.1 и новее.
Установка
Чтобы установить ransack
и добавить его в Gemfile, запустите
Кровоточащий край
Если вы хотите использовать последние обновления, еще не опубликованные в RubyGems, используйте main
ветку:
gem 'ransack' , :github => 'activerecord-hackery/ransack' , :branch => 'main'
Документация
Существует обширная документация по Ransack, проекту Docusaurus, работающему как сайт GitHub Pages.
Трекер проблем
- Прежде чем писать о проблеме, прочтите Руководство для участников.
- Сообщите о проблеме, если ошибка вызвана Ransack, является новой (о ней еще не сообщалось) и может быть воспроизведена на основе предоставленной вами информации .
- Пожалуйста, рассмотрите возможность добавления ветки с неудачной спецификацией, описывающей проблему.
- Взносы приветствуются. ?
- Пожалуйста, не используйте систему отслеживания проблем для личных запросов в службу поддержки. Stack Overflow или обсуждения GitHub — лучшее место для этого, где более широкое сообщество может вам помочь!
Взносы
Для поддержки проекта:
- Рассмотрите возможность поддержки нас через Open Collective.
- Используйте Ransack в своих приложениях и сообщите нам, если обнаружите что-то сломанное или отсутствующее. Неудачная спецификация, демонстрирующая проблему, — это здорово. Пул-реквест с прохождением тестов еще лучше!
- Прежде чем подавать сообщение о проблеме или запрос на включение, обязательно прочитайте и следуйте Руководству для участников.
- Пожалуйста, используйте Stack Overflow или обсуждения GitHub для вопросов или обсуждений, не связанных напрямую с отчетами об ошибках, запросами на включение или улучшениями документации.
- Расскажите в социальных сетях, если Ransack был вам полезен. Чем больше людей будет использовать проект, тем быстрее мы сможем найти и исправить ошибки!
Авторы
Ransack был создан Эрни Миллером, разрабатывается и поддерживается:
- Шон Кэрролл
- Дейвид Родригес
- Грег Молнар
- Отличная группа участников.
- Логотип Ransack разработан Анилом Кылычем.
Сопровождающие выпускников
Этот проект существует благодаря всем людям, которые вносят свой вклад.
Сторонники
Спасибо всем нашим сторонникам! [Стать спонсором]
Спонсоры
Поддержите этот проект, став спонсором. Здесь появится ваш логотип со ссылкой на ваш сайт. [Стать спонсором]