Pour commencer!

Ces manipulations fonctionnent avec Doctrine et sous les versions Symfony supérieur ou égal à la version 1.2.

L’installation du plugin sfDoctrineGuardPlugin est nécessaire, pour installer ce plugin, la documentation du site symfony est très complète, si vous souhaitez une traduction, faite le moi savoir!

Le schema et les données pré-renseignées

Pour pouvoir personnalisez sfDoctrineGuardPlugin, nous avons besoin d’ajouter au moins un nouveau modele, qui à une relation avec le model sfGuardUser déjà existant avec l’installation de sfDoctrineGuardPlugin. Pour le faire, on va éditer le fichier config/doctrine/schema.yml. Vous allez copier/coller le code YAML ci-dessous.

Pour ce tuto, on va créer un modèle Profile et créer une relation avec sfGuardUser. Par défaut, le plugin sfDoctrineGuardPlugin contient dans le modèle sfGuardUser uniquement les informations relatives au processus d’identification (si vous êtes curieux, vous pouvez consulter le YAML du plugin dans le fichier plugin/sfDoctrineGuardPlugin/config/doctrine/schema.yml). Pour faciliter la gestion des utilisateurs (mail, nom, prenom, etc.) il est donc conseillé de venir greffer ce modèle Profile sur le modèle sfGuardUser en les reliant.

Profile:
columns:
sf_guard_user_id: integer(4)
nom: string(255)
prenom: string(255)
email: string(255)
telephone: string(10)
relations:
sfGuardUser:
class: sfGuardUser
foreignType: one

Maintenant que nous avons définit la relation un-pour-un entre Profile et sfGuardUser, les instructions suivantes sont réalisables.

$user = new sfGuardUser();
$user->Profile->prenom = 'Jonathan';

Et vous pouvez aussi avoir accès à ces données dans le sens inverse, Doctrine crée automatiquement des relations entre les modèles qui sont bidirectionnels.

$profile = Doctrine_Query::create()
   ->from('Profile p')
   ->innerJoin('p.User u')
   ->where('p.id = ?', 1)
   ->fetchOne();
$user = $profile->User;

Maintenant que nous avons créé le modèle ainsi que les relations, nous allons renseigner le fichier des fixtures de symfony. Copiez/coller le code YML suivant dans le fichier data/fixtures/fixtures.yml.

sfGuardUser:
goldorak:
username: goldo
password: test
is_active: true
is_super_admin: true
Profile:
nom: Goldorak
prenom: Jean-édouard
email: goldo@vol.com
telephone: '9987235467'

Voilà, on peut ensuite re-build le projet avec la commande suivante :

symfony doctrine:build --all --and-load --no-confirmation

Maintenant vous pouvez vous rendre sur votre navigateur chéwi et regarder le résultat. Ouvrez http://votredomaine/backend_dev.php/sf_guard_user et vous pourrez voir l’utilisateur créé.

La personnalisation

Après de dur labeur et beaucoup de manipulations, on va enfin pouvoir faire “mumuse” avec la puissance de symfony. On a créé un modèle Profile, qui est relié au modèle sfGuardUser. OK… Mais comment modifier les informations du profile en même temps que celle de sfGuardUser?

C’est un jeu d’enfant …  Nous avons juste besoins de tuner quelques lignes de code pour le faire!

Nous allons tous d’abord récupérer le fichier sfGuardUserAdminForm.class.php présent dans le plugin et le coller dans notre dossier lib.

Copier le fichier :

plugins/sfDoctrineGuardPlugin/lib/form/doctrine/sfGuardUserAdminForm.class.php

Dans le dossier :

lib/form/doctrine/

Maintenant, ouvrez le fichier dupliqué lib/form/doctrine/sfGuardUserAdminForm.class.php et copiez/coller le code suivant à la place de la méthode configure() vide présente dans le fichier.

public function configure() {
   parent::configure();
   $profileForm = new ProfileForm($this->object->Profile);
   unset($profileForm['id'], $profileForm['sf_guard_user_id']);
   $this->embedForm('Profile', $profileForm);
}

La dernière chose à faire est de personnaliser le fichier generator.yml de notre module. Ouvrez le fichier apps/backend/modules/LE_MODULE/config/generator.yml et complétez le (vous avez une table des commandes possibles pour le generator.yml) comme le fichier ci-dessus le montre.

generator:
class: sfDoctrineGenerator
param:
config:
form:
class: sfGuardUserAdminForm
display:
"NONE": [username, password, password_again, Profile]
"Permissions et groupes": [is_active, is_super_admin, groups_list, permissions_list]

Et voilà le travail!

Bon dev’ :D