✨ Add support for passing arguments to Partials (#325)

Author: johanmolen

src/Builder.php

@@ -45,7 +45,7 @@
  * @method FieldBuilder addNumber(string $name, array $args = [])
  * @method FieldBuilder addOembed(string $name, array $args = [])
  * @method FieldBuilder addPageLink(string $name, array $args = [])
- * @method FieldBuilder addPartial(string $partial)
+ * @method FieldBuilder addPartial(string $partial, array $args = [])
  * @method FieldBuilder addPartials(array $partials)
  * @method FieldBuilder addPassword(string $name, array $args = [])
  * @method FieldBuilder addPostObject(string $name, array $args = [])
@@ -91,14 +91,14 @@ public static function make(string $name, array $config = []): self
     /**
      * Add a partial to the field group.
      */
-    public function addPartial(string $partial): self
+    public function addPartial(string $partial, array $args = []): self
     {
         if (
             is_string($partial) &&
             is_subclass_of($partial, Partial::class) &&
             ! (new ReflectionClass($partial))->isAbstract()
         ) {
-            $partial = $partial::make($this->composer())->compose();
+            $partial = $partial::make($this->composer())->compose($args);
         }
 
         if (! is_a($partial, FieldsBuilder::class)) {
@@ -113,8 +113,11 @@ public function addPartial(string $partial): self
      */
     public function addPartials(array $partials): self
     {
-        foreach ($partials as $partial) {
-            $this->addPartial($partial);
+        foreach ($partials as $key => $value) {
+            $partial = is_string($value) ? $value : $key;
+            $args = is_array($value) ? $value : [];
+
+            $this->addPartial($partial, $args);
         }
 
         return $this;

src/Builder/AccordionBuilder.php

@@ -31,7 +31,7 @@
  * @method FieldBuilder addNumber(string $name, array $args = [])
  * @method FieldBuilder addOembed(string $name, array $args = [])
  * @method FieldBuilder addPageLink(string $name, array $args = [])
- * @method FieldBuilder addPartial(string $partial)
+ * @method FieldBuilder addPartial(string $partial, array $args = [])
  * @method FieldBuilder addPartials(array $partials)
  * @method FieldBuilder addPassword(string $name, array $args = [])
  * @method FieldBuilder addPostObject(string $name, array $args = [])

src/Builder/ChoiceFieldBuilder.php

@@ -31,7 +31,7 @@
  * @method FieldBuilder addNumber(string $name, array $args = [])
  * @method FieldBuilder addOembed(string $name, array $args = [])
  * @method FieldBuilder addPageLink(string $name, array $args = [])
- * @method FieldBuilder addPartial(string $partial)
+ * @method FieldBuilder addPartial(string $partial, array $args = [])
  * @method FieldBuilder addPartials(array $partials)
  * @method FieldBuilder addPassword(string $name, array $args = [])
  * @method FieldBuilder addPostObject(string $name, array $args = [])

src/Builder/FieldBuilder.php

@@ -34,7 +34,7 @@
  * @method FieldBuilder addNumber(string $name, array $args = [])
  * @method FieldBuilder addOembed(string $name, array $args = [])
  * @method FieldBuilder addPageLink(string $name, array $args = [])
- * @method FieldBuilder addPartial(string $partial)
+ * @method FieldBuilder addPartial(string $partial, array $args = [])
  * @method FieldBuilder addPartials(array $partials)
  * @method FieldBuilder addPassword(string $name, array $args = [])
  * @method FieldBuilder addPostObject(string $name, array $args = [])

src/Builder/FlexibleContentBuilder.php

@@ -35,7 +35,7 @@
  * @method FieldBuilder addNumber(string $name, array $args = [])
  * @method FieldBuilder addOembed(string $name, array $args = [])
  * @method FieldBuilder addPageLink(string $name, array $args = [])
- * @method FieldBuilder addPartial(string $partial)
+ * @method FieldBuilder addPartial(string $partial, array $args = [])
  * @method FieldBuilder addPartials(array $partials)
  * @method FieldBuilder addPassword(string $name, array $args = [])
  * @method FieldBuilder addPostObject(string $name, array $args = [])

src/Builder/GroupBuilder.php

@@ -33,7 +33,7 @@
  * @method FieldBuilder addNumber(string $name, array $args = [])
  * @method FieldBuilder addOembed(string $name, array $args = [])
  * @method FieldBuilder addPageLink(string $name, array $args = [])
- * @method FieldBuilder addPartial(string $partial)
+ * @method FieldBuilder addPartial(string $partial, array $args = [])
  * @method FieldBuilder addPartials(array $partials)
  * @method FieldBuilder addPassword(string $name, array $args = [])
  * @method FieldBuilder addPostObject(string $name, array $args = [])

src/Builder/RepeaterBuilder.php

@@ -33,7 +33,7 @@
  * @method FieldBuilder addNumber(string $name, array $args = [])
  * @method FieldBuilder addOembed(string $name, array $args = [])
  * @method FieldBuilder addPageLink(string $name, array $args = [])
- * @method FieldBuilder addPartial(string $partial)
+ * @method FieldBuilder addPartial(string $partial, array $args = [])
  * @method FieldBuilder addPartials(array $partials)
  * @method FieldBuilder addPassword(string $name, array $args = [])
  * @method FieldBuilder addPostObject(string $name, array $args = [])

src/Builder/TabBuilder.php

@@ -31,7 +31,7 @@
  * @method FieldBuilder addNumber(string $name, array $args = [])
  * @method FieldBuilder addOembed(string $name, array $args = [])
  * @method FieldBuilder addPageLink(string $name, array $args = [])
- * @method FieldBuilder addPartial(string $partial)
+ * @method FieldBuilder addPartial(string $partial, array $args = [])
  * @method FieldBuilder addPartials(array $partials)
  * @method FieldBuilder addPassword(string $name, array $args = [])
  * @method FieldBuilder addPostObject(string $name, array $args = [])

src/Composer.php

@@ -74,13 +74,15 @@ public function handle(): self
     /**
      * Call a method using the application container.
      */
-    protected function call(string $hook): mixed
+    protected function call(string $hook, array $args = []): mixed
     {
         if (! method_exists($this, $hook)) {
             return null;
         }
 
-        return $this->app->call([$this, $hook]);
+        return $this->app->call([$this, $hook], [
+            'args' => $args,
+        ]);
     }
 
     /**
@@ -134,9 +136,9 @@ public function getFields(bool $cache = true): array
     /**
      * Resolve the fields from the Composer with the container.
      */
-    public function resolveFields(): mixed
+    public function resolveFields(array $args = []): mixed
     {
-        return $this->call('fields') ?? [];
+        return $this->call('fields', $args) ?? [];
     }
 
     /**

src/Partial.php

@@ -7,11 +7,12 @@ abstract class Partial extends Composer
     /**
      * Compose and register the defined field groups with ACF.
      *
+     * @param  array  $args  Optional arguments to pass to the partial.
      * @return \StoutLogic\AcfBuilder\FieldsBuilder|void
      */
-    public function compose()
+    public function compose(array $args = [])
     {
-        $fields = $this->resolveFields();
+        $fields = $this->resolveFields($args);
 
         if (blank($fields)) {
             return;