feat: Add support for MetaBox relationships (#17)

---------

Co-authored-by: Brent Vanwildemeersch <brent.vanwildemeersch@easyfairs.com>
Co-authored-by: Nicolas Lemoine <nico.lemoine@gmail.com>

README.md

@@ -344,15 +344,54 @@ Hellonico\Fixtures\Entity\Post:
       # repeater field
       features:
         - label: <words(2, true)>
-          value: <sentence()
+          value: <sentence()>
         - label: <words(2, true)>
           value: <sentence()>
         - label: <words(2, true)>
           value: <sentence()>
 ```
-
 Be careful with duplicate field keys, if you have multiple field with the same key, prefer using ACF field key (`field_948d1qj5mn4d3`).
 
+### MetaBox Support
+
+#### MetaBox Custom Fields
+MetaBox fields can be adressed using the `meta` key
+```yaml
+Hellonico\Fixtures\Entity\Post:
+  post{1..30}:
+    post_title: <words(3, true)>
+    post_date: <dateTimeThisDecade()>
+    meta:
+      # number field
+      number: <numberBetween(10, 200)>
+      meta_box_custom_field: <sentence()>
+```
+
+#### MetaBox Relationships (https://docs.metabox.io/extensions/mb-relationships/#using-code)
+When using the MB Relationships extension, the relationships can be set/defined using the key `mb_relations`. For each relationship you want to create a fixture for, you use the relationship-ID which is used to register the MB-relation 
+```php
+ MB_Relationships_API::register( [
+        'id'   => 'post_to_term',
+        'from'   => 'post',
+        'to' => [
+            'object_type' => 'term',
+            'taxonomy'=> 'custom_term'
+        ],
+        
+    ] );
+```
+and the post/term ID of the object you want it to have a relationship with.
+```yaml
+Hellonico\Fixtures\Entity\Post:
+  post{1..30}:
+    post_title: <words(3, true)>
+    post_date: <dateTimeThisDecade()>
+    mb_relations:
+      post_to_term: '1x @custom_term*->term_id'
+      post_to_post: '1x @custom_post*->ID'
+```
+
+
 ### Custom formatters
 
 In addition to formatters provided by [fzaninotto/Faker](https://github.com/fzaninotto/Faker#formatters), you can use custom formatters below.

examples/fixtures.yml

@@ -97,6 +97,8 @@ Hellonico\Fixtures\Entity\Post:
   # CUSTOM POST TYPE
   product{1..15}:
     post_type: product
+    mb_relations:
+      post_to_term: '1x @places*->term_id'
     acf:
       # number field
       price: <numberBetween(10, 200)>

src/Entity/Post.php

@@ -30,6 +30,7 @@ class Post extends Entity {
 	public $post_category;
 	public $meta_input;
 	public $acf;
+	public $mb_relations;
 	private $extra = [ 'meta_input', 'acf' ];
 
 	/**
@@ -126,6 +127,14 @@ public function persist() {
 			}
 		}
 
+		if ( defined( 'RWMB_VER' ) && class_exists( 'MB_Relationships_API' ) && ! empty( $this->mb_relations ) && is_array( $this->mb_relations ) ) {
+			foreach ( $this->mb_relations as $mb_rel_id => $object_ids ) {
+				foreach ( $object_ids as $id ) {
+					\MB_Relationships_API::add( $post_id, $id, $mb_rel_id );
+				}
+			}
+		}
+
 		return true;
 	}
 

src/Entity/Term.php

@@ -14,6 +14,7 @@ class Term extends Entity {
 	public $description;
 	public $parent;
 	public $acf;
+	public $mb_relations;
 
 	/**
 	 * Constructor.
@@ -98,6 +99,15 @@ public function persist() {
 			}
 		}
 
+		// Save MetaBox Relationships
+		if ( defined( 'RWMB_VER' ) && class_exists( 'MB_Relationships_API' ) && ! empty( $this->mb_relations ) && is_array( $this->mb_relations ) ) {
+			foreach ( $this->mb_relations as $mb_rel_id => $object_ids ) {
+				foreach ( $object_ids as $id ) {
+					\MB_Relationships_API::add( $post_id, $id, $mb_rel_id );
+				}
+			}
+		}
+
 		return true;
 	}
 

src/Entity/User.php

@@ -29,6 +29,7 @@ class User extends Entity {
 	public $use_ssl;
 	public $show_admin_bar_front;
 	public $acf;
+	public $mb_relations;
 
 	/**
 	 * {@inheritdoc}
@@ -88,6 +89,15 @@ public function persist() {
 			}
 		}
 
+		// Save MetaBox Relationships
+		if ( defined( 'RWMB_VER' ) && class_exists( 'MB_Relationships_API' ) && ! empty( $this->mb_relations ) && is_array( $this->mb_relations ) ) {
+			foreach ( $this->mb_relations as $mb_rel_id => $object_ids ) {
+				foreach ( $object_ids as $id ) {
+					\MB_Relationships_API::add( $post_id, $id, $mb_rel_id );
+				}
+			}
+		}
+
 		return true;
 	}