meuhmeuhconcept/fos-user-bundle

FosUserBundle implementation for MeuhMeuhConcept

2.12 2024-12-05 12:04 UTC

Requires

• php: ~7.0
• doctrine/orm: ^2.5
• friendsofsymfony/user-bundle: ^2.0|^3.0
• symfony/cache: ~3.4.38|~4.0|~5.0
• symfony/config: ~3.4.38|~4.0|~5.0
• symfony/dependency-injection: ~3.4.38|~4.0|~5.0
• symfony/doctrine-bridge: ~3.4.38|~4.0|~5.0
• symfony/event-dispatcher: ~3.4.38|~4.0|~5.0
• symfony/framework-bundle: ~3.4.38|~4.0|~5.0
• symfony/http-foundation: ~3.4.38|~4.0|~5.0
• symfony/http-kernel: ~3.4.38|~4.0|~5.0
• symfony/routing: ~3.4.38|~4.0|~5.0
• symfony/security: ~3.4.38|~4.0|~5.0
• symfony/security-bundle: ~3.4.38|~4.0|~5.0

Requires (Dev)

• doctrine/annotations: ^1.2
• friendsofphp/php-cs-fixer: ^1.12
• phpunit/phpunit: ~5.6

proprietary

• Jean-Noël Germon

README

Implementation of FosUserBundle for MeuhMeuhConcept

Installation

Add the repository in composer.json

{
       "require": {
               "meuhmeuhconcept/fos-user-bundle": "~2.0"",
       },
}

Via composer

composer require meuhmeuhconcept/fos-user-bundle

Installs bundles web assets under a public web directory

bin/console assets:install

Configuration

Add bundles

In app/AppKernel.php, add following lines

public function registerBundles()
{
    $bundles = [

        // ...

        new MMC\FosUserBundle\MMCFosUserBundle(),
        new FOS\UserBundle\FOSUserBundle(),

        // ...
    ];

    // ...
}

Create your own user entity

<?php

namespace AppBundle\Entity;

use Doctrine\ORM\Mapping as ORM;
use MMC\FosUserBundle\Entity\User as BaseUser;

/**
 * @ORM\Entity
 */
class User extends BaseUser
{
    public function __construct()
    {
        parent::__construct();
        // your own logic
    }
}

Add fos user configuration and twig layout :

# app/config/config.yml
fos_user:
    db_driver: orm # other valid values are 'mongodb', 'couchdb' and 'propel'
    firewall_name: main
    user_class: AppBundle\Entity\User


twig:
    globals:
        mmc_fos_user_layout: "FOSUserBundle::layout.html.twig"

If you need a designed layout, you should use the default layout :

# app/config/config.yml

twig:
    globals:
        mmc_fos_user_layout: "FOSUserBundle:Default:layout.html.twig"

Add fos user security configuration :

# app/config/security.yml
    encoders:
        FOS\UserBundle\Model\UserInterface: bcrypt

    role_hierarchy:
        ROLE_ADMIN:       ROLE_USER
        ROLE_SUPER_ADMIN: ROLE_ADMIN

    providers:
        mmc_fos_user:
            id: fos_user.user_provider.username_email

    firewalls:
        main:
            pattern: ^/
            form_login:
                provider: mmc_fos_user
                csrf_token_generator: security.csrf.token_manager
                default_target_path:     /admin
            logout:
                path:     /logout
                target:   /login
            anonymous:    true
            remember_me:
                secret:   '%secret%'
                lifetime: 604800 # 1 week in seconds
                path:     /

    access_control:
        - { path: ^/login$, role: IS_AUTHENTICATED_ANONYMOUSLY }
        - { path: ^/register, role: IS_AUTHENTICATED_ANONYMOUSLY }
        - { path: ^/resetting, role: IS_AUTHENTICATED_ANONYMOUSLY }
        - { path: ^/admin/, role: ROLE_ADMIN }

Add fos user route :

# app/config/routing.yml
fos_user:
    resource: "@FOSUserBundle/Resources/config/routing/all.xml"

Customization

If you need to change the logout path ('/logout' by default), you should edit the twig global 'mmc_fos_user_bundle_logout_path'. For example, if I need '/admin/logout' for logout path :

# app/config/config.yml

twig:
    globals:
        mmc_fos_user_bundle_logout_path: '/admin/logout'

By default, the admin title prefix, in the login page, is 'MMC'. You can change it with the twig global :

# app/config/config.yml

twig:
    globals:
        admin_title_suffix: 'Foo'
        #'AdminMMC' => 'AdminFoo'

And change the path in security.yml :

# app/config/security.yml

    /----

    main:
        logout:
            path:     /admin/logout
            target:   /admin/login
    /----

Use with MMC/SonataAdminBundle

If you use the bundle MMCSonataAdminBudnle and you need to use the admin of users you can enable it like this:

# app/config/config.yml
mmc_fos_user:
    admin: ~

By default, the admin is place under sonata.admin.group.administration, you can change it like this :

# app/config/config.yml
mmc_fos_user:
    admin:
        group: 'name.of.my.custom.group'
        icon: '<i class="fa fa-user"></i>'
        nav_top: ~

If you override the configuration on sonata_admin.dashboard.groups, the previous configuration is useless because it will be overwritten.

You should add the service id mmc_fos_user_bundle.sonata_admin.user in the items list :

# app/config/config.yml
sonata_admin:
    dashboard:
        groups:
            sonata.admin.group.admin:
                items:
                    - mmc_fos_user_bundle.sonata_admin.user

Don't forget to give access for your admin user with roel ROLE_MMC_FOS_USER_BUNDLE_SONATA_ADMIN_USER_ALL

Create a custom block

If you need to add a new custom block, you should :

• Create a block service