Merge pull request #1204

Author: jmikola

docs/en/reference/basic-mapping.rst

@@ -300,15 +300,14 @@ Here is how you can configure the strategy for the different configuration forma
                                 xsi:schemaLocation="http://doctrine-project.org/schemas/odm/doctrine-mongo-mapping
                                                     http://doctrine-project.org/schemas/odm/doctrine-mongo-mapping.xsd">
     
-            <document name="MyPersistentClass" customId="true">
+            <document name="MyPersistentClass">
                 <field name="id" id="true" strategy="NONE" />
             </document>
         </doctrine-mongo-mapping>
     
     .. code-block:: yaml
 
         MyPersistentClass:
-          customId: true
           fields:
             id:
               id: true
@@ -337,6 +336,57 @@ Now you can retrieve the document later:
 
     $document = $dm->find('MyPersistentClass', 'my_unique_identifier');
 
+You can define your own ID generator by extending the
+``Doctrine\ODM\MongoDB\Id\AbstractIdGenerator`` class and specifying the class
+as an option for the ``CUSTOM`` strategy:
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        <?php
+
+        /** Document */
+        class MyPersistentClass
+        {
+            /** @Id(strategy="CUSTOM", type="string", options={"class"="Vendor\Specific\Generator"}) */
+            private $id;
+
+            public function setId($id)
+            {
+                $this->id = $id;
+            }
+
+            //...
+        }
+
+    .. code-block:: xml
+
+        <doctrine-mongo-mapping xmlns="http://doctrine-project.org/schemas/odm/doctrine-mongo-mapping"
+                                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                                xsi:schemaLocation="http://doctrine-project.org/schemas/odm/doctrine-mongo-mapping
+                                                    http://doctrine-project.org/schemas/odm/doctrine-mongo-mapping.xsd">
+
+            <document name="MyPersistentClass">
+                <field name="id" id="true" strategy="CUSTOM" type="string">
+                    <id-generator-option name="class" value="Vendor\Specific\Generator" />
+                </field>
+            </document>
+        </doctrine-mongo-mapping>
+
+    .. code-block:: yaml
+
+        MyPersistentClass:
+          fields:
+            id:
+              id: true
+              strategy: CUSTOM
+              type: string
+              options:
+                class: Vendor\Specific\Generator
+
+
+
 Fields
 ~~~~~~