dachcom-digital / members
Pimcore User, Object, Asset and Document Authentication
Installs: 63 311
Dependents: 0
Suggesters: 0
Security: 0
Stars: 54
Watchers: 16
Forks: 34
Open Issues: 4
Type:pimcore-bundle
Requires
- doctrine/orm: ^2.7
- pimcore/pimcore: ^11.0
- symfony/form: ^6.2
Requires (Dev)
- codeception/codeception: ^5.0
- codeception/module-symfony: ^3.1
- codeception/module-webdriver: ^4.0
- phpstan/phpstan: ^1.0
- phpstan/phpstan-symfony: ^1.0
- symplify/easy-coding-standard: ^9.0
Suggests
- dev-master
- v5.0.2
- v5.0.1
- v5.0.0
- 4.x-dev
- v4.1.2
- v4.1.1
- v4.1.0
- v4.0.4
- v4.0.3
- v4.0.2
- v4.0.1
- v4.0.0
- 3.x-dev
- v3.1.6
- v3.1.5
- v3.1.4
- v3.1.3
- v3.1.2
- v3.1.1
- v3.1.0
- v3.0.1
- v3.0.0
- 2.5.x-dev
- v2.5.1
- v2.5.0
- v2.4.0
- v2.3.0
- 2.2.1
- v2.2.0
- v2.1.1
- v2.1.0
- v2.0.1
- v2.0.0
- v1.5.7
- v1.5.6
- v1.5.5
- v1.5.4
- v1.5.3
- v1.5.2
- v1.5.1
- v1.5.0
- v1.4.1
- v1.4.0
- v1.3.0
- v1.1.4
- 1.1.3
- 1.1.2
- 1.1.1
- 1.1.0
- v1.0.12
- v1.0.11
- v1.0.10
- v1.0.9
- v1.0.8
- v1.0.7
- v1.0.6
- v1.0.5
- v1.0.4
- v1.0.3
- v1.0.2
- v1.0.1
- v1.0.0
- v0.9.0
- dev-pimcore4
- dev-customerDataFramework
This package is auto-updated.
Last update: 2024-10-12 06:57:00 UTC
README
Add frontend user authentication and document restriction to pimcore.
Release Plan
Features
- Create Members in backend
- Allow Members to register in frontend
- Restrict documents, objects and assets to specific user roles
Installation
Please read the installation instructions before going deep with Members!
Composer Installation
- Add code below to your
composer.json
"require" : { "dachcom-digital/members" : "~5.0.0" }
Add Bundle to bundles.php
:
return [ MembersBundle\MembersBundle::class => ['all' => true], ];
- Execute:
$ bin/console pimcore:bundle:install MembersBundle
Upgrading
- Execute:
$ bin/console doctrine:migrations:migrate --prefix 'MembersBundle\Migrations'
Optional: Class Installation
Read more about the required classes below).
bin/console members:install:class
Security Installation
It is not possible to merge security configurations from multiple locations, including bundles. Instead, you have to move them to
one single config file, e.g. config/packages/security.yaml
. Please adopt security_auth_manager.yaml
and merge your own firewall configuration into one single file.
Route Installation
MembersBundle does not include any routes per default. Otherwise, it would be hard for you to change or override included routes.
Include all Routes
# config/routes.yaml app: resource: '@MembersBundle/config/pimcore/routing/all.yaml'
Just include some Routes
# config/routes.yaml members_auth: resource: '@MembersBundle/config/pimcore/routing/auth.yaml' prefix: /{_locale}/members #change your prefix if you have to.
Class Installation
Since Members should be the one and only frontend authentication bundle, we need to add the most flexibility as possible. But no worries, it's still simple to integrate.
There is also a class installer command. If you're not using any special class configuration, feel free to use this command:
$ bin/console members:install:class
Use the-o
argument to also install the SsoIdentity Class
You need two classes: User and Group. So let's create it:
User
- Create a class and call it
MembersUser
- Add parent class:
\MembersBundle\Adapter\User\AbstractUser
- Add fields:
membersUser
is the default name, you may want to change it. Read here how to achieve that.
Customer Data Framework
If you want to use the Customer Data Framework you need to do some further work. Read more about it here.
SSO Login
You want to enable the SSO Feature in Members? Read more about it here.
Group
- Create a class and call it
MembersGroup
- Add parent class:
\MembersBundle\Adapter\Group\AbstractGroup
- Add fields:
membersGroup
is the default name, you may want to change it. Read here how to achieve that.
Feel free to add additional fields since those are just the required ones. That's it. Members will use those classes to manage authentication and group management.
Email Configuration
You're almost there, just check the email configuration and you're good to go.
User Management: Further Information
- Auth Identifier Use
email
instead ofusername
for authentication - Custom Class Names
- Frontend Routes & Views
- Available Events
- Custom Form Types
- Registration Types
- Email Configuration
- Groups
- Roles
- Use the Pimcore Customer Framework with Members
Restrictions
Learn more about the Members Restriction feature:
- Brief Overview
- Restricted Navigation
- Restricted Routing
- Restricted Listing
- Protected Asset Downloader
Single Sign On (SSO) with OAuth2
Upgrade Info
Before updating, please check our upgrade notes!
Copyright and license
Copyright: DACHCOM.DIGITAL
For licensing details please visit LICENSE.md