Allow to add multiple participation

The participationController accept a new parameter : `persons_ids`,
which must receive a comma-separated list of person ids. A participation
will be create for all those peoples.

The `new` and `create` actions does not allow to receive both
`person_id` and `persons_ids`.

Tests are added.

ref #6

Controller/ParticipationController.php

@@ -26,6 +26,7 @@ use Chill\EventBundle\Entity\Participation;
 use Chill\EventBundle\Form\ParticipationType;
 use Symfony\Component\Form\Extension\Core\Type\SubmitType;
 use Chill\EventBundle\Security\Authorization\ParticipationVoter;
+use Symfony\Component\Form\Extension\Core\Type\CollectionType;
 
 /**
  * 
@@ -44,23 +45,65 @@ class ParticipationController extends Controller
      */
     public function newAction(Request $request)
     {
-        $single = $request->query->getInt('person_id', null);
-        $multiple = $request->query->get('persons_ids', null);
-        
-        if ($single !== NULL AND $multiple !== NULL) {
-            // we are not allowed to have both person_id and persons_ids
+        // test the request is correct
+        try {
+            $this->testRequest($request);
+        } catch (\RuntimeException $ex) {
+            $this->get('logger')->warning($ex->getMessage());
+            
             return (new Response())
                 ->setStatusCode(Response::HTTP_BAD_REQUEST)
-                ->setContent("You are not allow to provide both 'person_id' and "
+                ->setContent($ex->getMessage());
+        }
+        
+        // forward to other action
+        $single = $request->query->has('person_id');
+        $multiple = $request->query->has('persons_ids');
+        
+        if ($single === true) {
+            return $this->newSingle($request);
+        }
+        
+        if ($multiple === true) {
+            
+            return $this->newMultiple($request);
+        }
+        
+        // at this point, we miss the required fields. Throw an error
+        return (new Response())
+            ->setStatusCode(Response::HTTP_BAD_REQUEST)
+                ->setContent("You must provide either 'person_id' or "
+                        . "'persons_ids' argument in query");
+    }
+    
+    protected function testRequest($request)
+    {
+        $single = $request->query->has('person_id');
+        $multiple = $request->query->has('persons_ids');
+        
+        if ($single === true AND $multiple === true) {
+            // we are not allowed to have both person_id and persons_ids
+            throw new \RuntimeException("You are not allow to provide both 'person_id' and "
                       . "'persons_ids' simulaneously");
         }
         
-        if ($single !== NULL) {
-            return $this->newSingleAction($request);
+        if ($multiple === true) {
+            $persons_ids = $request->query->get('persons_ids');
+            
+            if (!preg_match('/^([0-9]{1,},){1,}[0-9]{1,}$/', $persons_ids)) {
+                throw new \RuntimeException("The persons_ids value should "
+                        . "contains int separated by ','");
+            }
         }
+        
+        // check for event_id - this could be removed later
+        if ($request->query->has('event_id') === FALSE) {
+            throw new \RuntimeException("You must provide an event_id");
+        }
+        
     }
     
-    protected function newSingleAction(Request $request)
+    protected function newSingle(Request $request)
     {
         $participation = $this->handleRequest($request, new Participation());
         
@@ -75,7 +118,57 @@ class ParticipationController extends Controller
         ));
     }
     
+    protected function newMultiple(Request $request)
+    {
+        $participations = $this->handleRequest($request, new Participation());
+        
+        foreach ($participations as $participation) {
+            $this->denyAccessUnlessGranted(ParticipationVoter::CREATE, 
+                $participation, 'The user is not allowed to create this participation');
+        }
+        
+        $form = $this->createCreateFormMultiple($participations);
+        
+        return $this->render('ChillEventBundle:Participation:new-multiple.html.twig', array(
+            'form' => $form->createView(),
+            'participations' => $participations
+        ));
+    }
+    
     public function createAction(Request $request)
+    {
+        // test the request is correct
+        try {
+            $this->testRequest($request);
+        } catch (\RuntimeException $ex) {
+            $this->get('logger')->warning($ex->getMessage());
+            
+            return (new Response())
+                ->setStatusCode(Response::HTTP_BAD_REQUEST)
+                ->setContent($ex->getMessage());
+        }
+        
+        // forward to other action
+        $single = $request->query->has('person_id');
+        $multiple = $request->query->has('persons_ids');
+        
+        if ($single === true) {
+            return $this->createSingle($request);
+        }
+        
+        if ($multiple === true) {
+            
+            return $this->createMultiple($request);
+        }
+        
+        // at this point, we miss the required fields. Throw an error
+        return (new Response())
+            ->setStatusCode(Response::HTTP_BAD_REQUEST)
+                ->setContent("You must provide either 'person_id' or "
+                        . "'persons_ids' argument in query");
+    }
+    
+    public function createSingle(Request $request)
     {
         $participation = $this->handleRequest($request, new Participation());
         
@@ -106,7 +199,49 @@ class ParticipationController extends Controller
         ));
     }
     
+    public function createMultiple(Request $request)
+    {
+        $participations = $this->handleRequest($request, new Participation());
+        
+        foreach($participations as $participation) {
+            $this->denyAccessUnlessGranted(ParticipationVoter::CREATE, 
+                $participation, 'The user is not allowed to create this participation');
+        }
+        
+        $form = $this->createCreateFormMultiple($participations);
+        $form->handleRequest($request);
+        
+        if ($form->isSubmitted() && $form->isValid()) {
+            $em = $this->getDoctrine()->getManager();
+            $data = $form->getData();
+            
+            foreach($data['participations'] as $participation) {
+                $em->persist($participation);
+            }
+            
+            $em->flush();
+            
+            $this->addFlash('success', $this->get('translator')->trans(
+                    'The participations were created'
+                    ));
+            
+            return $this->redirectToRoute('chill_event__event_show', array(
+                'event_id' => $participations[0]->getEvent()->getId()
+            ));
+        }
+        
+        return $this->render('ChillEventBundle:Participation:new.html.twig', array(
+            'form' => $form->createView(),
+            'participation' => $participation
+        ));
+    }
+    
     /**
+     * 
+     * Handle the request to adapt $participation.
+     * 
+     * If the request is multiple, the $participation object is cloned. 
+     * Limitations: the $participation should not be persisted.
      * 
      * @param Request $request
      * @param Participation $participation
@@ -117,6 +252,10 @@ class ParticipationController extends Controller
     protected function handleRequest(Request $request, Participation $participation)
     {
         $em = $this->getDoctrine()->getManager();
+        if ($em->contains($participation)) {
+            throw new \LogicException("The participation object should not be managed by "
+                    . "the object manager using the method ".__METHOD__);
+        }
         
         $event_id = $request->query->getInt('event_id', null);
         
@@ -134,23 +273,37 @@ class ParticipationController extends Controller
             $participation->setEvent($event);
         }
         
-        $person_id = $request->query->getInt('person_id', null);
+        // this script should be able to handle multiple, so we translate 
+        // single person_id in an array
+        $persons_ids = $request->query->has('person_id') ?
+                array($request->query->getInt('person_id', null)):
+                explode(',', $request->query->get('persons_ids'))
+            ;
+        $participations = array();
         
-        if ($person_id !== NULL) {
-            $person = $em->getRepository('ChillPersonBundle:Person')
-                    ->find($person_id);
+        foreach($persons_ids as $person_id) {
             
-            if ($person === NULL) {
-                throw $this->createNotFoundException('The person with id '.$person_id.' is not found');
+            // clone if we have to reuse the $participation
+            $participation = count($persons_ids) > 1 ? clone $participation : $participation;
+        
+            if ($person_id !== NULL) {
+                $person = $em->getRepository('ChillPersonBundle:Person')
+                        ->find($person_id);
+
+                if ($person === NULL) {
+                    throw $this->createNotFoundException('The person with id '.$person_id.' is not found');
+                }
+
+                $this->denyAccessUnlessGranted('CHILL_PERSON_SEE', $person,
+                        'The user is not allowed to see the person');
+
+                $participation->setPerson($person);
             }
             
-            $this->denyAccessUnlessGranted('CHILL_PERSON_SEE', $person,
-                    'The user is not allowed to see the person');
-            
-            $participation->setPerson($person);
+            $participations[] = $participation;
         }
         
-        return $participation;
+        return count($participations) > 1 ? $participations : $participations[0];
     }
     
     /**
@@ -175,6 +328,37 @@ class ParticipationController extends Controller
         return $form;
     }
     
+    /**
+     * 
+     * @param array $participations
+     * @return type
+     */
+    public function createCreateFormMultiple(array $participations)
+    {
+        $form = $this->createForm(\Symfony\Component\Form\Extension\Core\Type\FormType::class,
+                array('participations' => $participations), array(
+                    'action' => $this->generateUrl('chill_event_participation_create', array(
+                'event_id' => $participations[0]->getEvent()->getId(),
+                'persons_ids' => implode(',', array_map(
+                        function(Participation $p) { return $p->getPerson()->getId(); }, 
+                        $participations))
+            )
+                )));
+        $form->add('participations', CollectionType::class,  array(
+            'entry_type' => ParticipationType::class,
+            'entry_options' => array(
+                  'event_type' => $participations[0]->getEvent()->getType()
+                ),
+            )
+        );
+        
+        $form->add('submit', SubmitType::class, array(
+            'label' => 'Create'
+        ));
+        
+        return $form;
+    }
+    
     /**
      * show an edit form for the participation with the given id.
      *