Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spree/spree_auth_devise
Provides authentication (user accounts, login & signup) for @spree by using Devise
https://github.com/spree/spree_auth_devise
auth authentication devise ecommerce rails spree spreecomerce userauthentication
Last synced: 7 days ago
JSON representation
Provides authentication (user accounts, login & signup) for @spree by using Devise
- Host: GitHub
- URL: https://github.com/spree/spree_auth_devise
- Owner: spree
- License: bsd-3-clause
- Created: 2012-05-20T23:57:25.000Z (over 12 years ago)
- Default Branch: main
- Last Pushed: 2024-07-21T04:27:18.000Z (6 months ago)
- Last Synced: 2025-01-07T08:08:04.168Z (14 days ago)
- Topics: auth, authentication, devise, ecommerce, rails, spree, spreecomerce, userauthentication
- Language: Ruby
- Homepage: https://spreecommerce.org
- Size: 1.49 MB
- Stars: 139
- Watchers: 23
- Forks: 495
- Open Issues: 46
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Spree Auth Devise
[](https://circleci.com/gh/spree/spree_auth_devise/tree/main)
Provides authentication services for [Spree](https://spreecommerce.org), using the [Devise](https://github.com/plataformatec/devise) gem.
## Developed by
## Installation
1. Add this extension to your Gemfile with this line:
```ruby
gem 'spree_auth_devise'
```
if you run into any version-mismatch problems please run `bundle update`
2. Install the gem using Bundler:
```ruby
bundle install
```
3. Copy & run migrations
```ruby
bundle exec rails g spree:auth:install
```
## Upgrading from Spree 3.0 to 3.1
If you're upgrading from 3.0 to 3.1 you need to rerun the installer to copy new asset files (javascripts)
```ruby
bundle exec rails g spree:auth:install
```
## Configuration
### Confirmable
To enable Devise's Confirmable module, which will send the user an email with a link to confirm their account, you must do the following:
* Add this line to an initializer in your Rails project (typically `config/initializers/spree.rb`):
```ruby
Spree::Auth::Config[:confirmable] = true
```
* Add a Devise initializer to your Rails project (typically `config/initializers/devise.rb`):
```ruby
Devise.setup do |config|
# Required so users don't lose their carts when they need to confirm.
config.allow_unconfirmed_access_for = 1.days
# Fixes the bug where Confirmation errors result in a broken page.
config.router_name = :spree
# Add any other devise configurations here, as they will override the defaults provided by spree_auth_devise.
end
```
### Sign out after password change
To disable signout after password change you must add this line to an initializer in your Rails project (typically `config/initializers/spree.rb`):
```ruby
Spree::Auth::Config[:signout_after_password_change] = false
```
## Using in an existing Rails application
If you are installing Spree inside of a host application in which you want your own permission setup, you can do this using spree_auth_devise's register_ability method.
First create your own CanCan Ability class following the CanCan documentation.
For example: app/models/your_ability_class.rb
```ruby
class YourAbilityClass
include CanCan::Ability
def initialize user
# direct permissions
can :create, SomeRailsObject
# or permissions by group
if spree_user.has_spree_role? "admin"
can :create, SomeRailsAdminObject
end
end
end
```
Then register your class in your spree initializer: config/initializers/spree.rb
```ruby
Spree::Ability.register_ability(YourAbilityClass)
```
Inside of your host application you can then use CanCan like you normally would.
```ruby
<% if can? :show, SomeRailsObject %>
<% end %>
```
### Adding Permissions to Gems
This methodology can also be used by gems that extend spree and want/need to add permissions.
### Ruby 2.5 issues
If you encounter issues when using Ruby 2.5, please run:
```bash
bundle update devise
```
### Creating the default Admin user
If you didn't created the Admin user from the installer you can run this rake task:
```bash
bundle exec rake spree_auth:admin:create
```
## Testing
You need to do a quick one-time creation of a test application and then you can use it to run the tests.
bundle exec rake test_app
Then run the rspec tests.
bundle exec rspec
## License
Spree Starter (formerly Spark Starter Kit) is copyright © 2015-2021
[Spark Solutions Sp. z o.o.][spark]. It is free software,
and may be redistributed under the terms specified in the
[LICENSE](LICENSE.md) file.
## About Spark Solutions
[][spark]
Spree Auth Devise is maintained and funded by [Spark Solutions Sp. z o.o.](http://sparksolutions.co?utm_source=github)
The names and logos are trademarks of Spark Solutions Sp. z o.o.
We are passionate about open source software.
We are [available for hire][spark].
[spark]:http://sparksolutions.co?utm_source=github