dynamic / silverstripe-user-invitation
A SilverStripe module to handle user invitations to your secure website.
Installs: 2 045
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 3
Forks: 5
Open Issues: 7
Type:silverstripe-vendormodule
Requires
- lekoala/silverstripe-cms-actions: ^1.4
- silverstripe/framework: ^4 || ^5
Requires (Dev)
- silverstripe/recipe-testing: ^2 || ^3
This package is auto-updated.
Last update: 2024-10-21 18:04:26 UTC
README
This module adds the ability to invite users to a secure website (e.g. Intranet or Extranet).
Requirements
- silverstripe/framework ^4
Installation
composer require dynamic/silverstripe-user-invitation
License
See License
Invite users to Silverstripe CMS
This module makes it posible to invite users that you would like to register on your site. Users can be invited from either a:
Features
- Quick-entry invitation form (By default only first name and email fields are required to invite someone)
- Sends email invitations to recipient
- Supports optional user group assignment (See below for how to enforce this group selection)
- Invitation expiry can be set via configuration.
- Default SilverStripe member validation is applied.
- Create and send invites from CMS admin interface
Force required user group assignment
Place the following in your mysite/_config/config.yml
Dynamic\SilverStripe\UserInvitations\Model\UserInvitation: force_require_group: true
Template override
To update the base template use updateMainTemplates
. It defaults to Page
.
/** * @param array $mainTemplates */ public function updateMainTemplates(&$mainTemplates) { array_unshift($mainTemplates, 'InvitationPage'); }
Redirect after successful user creation
You can set a custom 'BackURL', that the user will be redirected to, after having completed signup from invitation.
Dynamic\SilverStripe\UserInvitations\Control\UserController: back_url: '/admin/'
Please remember to set an admin_email (used as sender)
This is done in your app/_config/email.yml file
SilverStripe\Control\Email\Email: admin_email: #Default email this site sends emails from mail@example.com: 'Admin at example.com'
For easy email testing, use: https://mailcatcher.me/
Maintainers
Credits
Forked from FSWebWorks/silverstripe-user-invitation to upgrade for Silverstripe 4 & 5.
Bugtracker
Bugs are tracked in the issues section of this repository. Before submitting an issue please read over existing issues to ensure yours is unique.
If the issue does look like a new bug:
- Create a new issue
- Describe the steps required to reproduce your issue, and the expected outcome. Unit tests, screenshots and screencasts can help here.
- Describe your environment as detailed as possible: SilverStripe version, Browser, PHP version, Operating System, any installed SilverStripe modules.
Please report security issues to the module maintainers directly. Please don't file security issues in the bugtracker.
Development and contribution
If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.