Revert "Removed any reference to immediate option related to listener"

This reverts commit ec27a19.

Author: XWB

DependencyInjection/Configuration.php

@@ -536,6 +536,7 @@ protected function getPersistenceNode()
                         ->scalarNode('update')->defaultTrue()->end()
                         ->scalarNode('delete')->defaultTrue()->end()
                         ->scalarNode('flush')->defaultTrue()->end()
+                        ->booleanNode('immediate')->defaultFalse()->end()
                         ->scalarNode('logger')
                             ->defaultFalse()
                             ->treatNullLike('fos_elastica.logger')

DependencyInjection/FOSElasticaExtension.php

@@ -581,7 +581,7 @@ private function getDoctrineEvents(array $typeConfig)
             'insert' => array(constant($eventsClass.'::postPersist')),
             'update' => array(constant($eventsClass.'::postUpdate')),
             'delete' => array(constant($eventsClass.'::preRemove')),
-            'flush' => array(constant($eventsClass.'::postFlush')),
+            'flush' => array($typeConfig['listener']['immediate'] ? constant($eventsClass.'::preFlush') : constant($eventsClass.'::postFlush')),
         );
 
         foreach ($eventMapping as $event => $doctrineEvents) {

Resources/doc/setup.md

@@ -127,7 +127,8 @@ Below is an example for the Doctrine ORM.
                         driver: orm
                         model: Acme\ApplicationBundle\Entity\User
                         provider: ~
-                        listener: ~
+                        listener:
+                            immediate: ~
                         finder: ~
 ```
 

Resources/doc/types.md

@@ -325,6 +325,21 @@ You can also choose to only listen for some of the events:
 
 > **Propel** doesn't support this feature yet.
 
+Flushing Method
+---------------
+
+FOSElasticaBundle, since 3.0.0 performs its indexing in the postFlush Doctrine event
+instead of prePersist and preUpdate which means that indexing will only occur when there
+has been a successful flush. This new default makes more sense but in the instance where
+you want to perform indexing before the flush is confirmed you may set the `immediate`
+option on a type persistence configuration to `true`.
+
+```yaml
+                    persistence:
+                        listener:
+                            immediate: true
+```
+
 Logging Errors
 --------------