[FEATURE] Allow defining arguments for f:render with f:variable

This patch allows you to define arguments that get passed to
f:render by using f:variable in the tag contents.

```xml
<f:render partial="Something">
   <f:variable name="arg1">Special value for arg1 variable</f:variable>
   <f:variable name="arg2">Special value for arg2 variable</f:variable>
</f:render>
```

Any argument specified with f:variable this way will override
the argument of the same name if it was passed in the “arguments”
array as well. The combined result will be used as variables for the
sub-rendering call.

References: #427

Author: NamelessCoder

src/Core/ViewHelper/ViewHelperVariableContainer.php

@@ -6,6 +6,7 @@
  * See LICENSE.txt that was shipped with this package.
  */
 
+use TYPO3Fluid\Fluid\Core\Variables\VariableProviderInterface;
 use TYPO3Fluid\Fluid\View\ViewInterface;
 
 /**
@@ -29,6 +30,30 @@ class ViewHelperVariableContainer
      */
     protected $view;
 
+    public function pushDelegateVariableContainer($viewHelperClassName, VariableProviderInterface $variableProvider)
+    {
+        if (!isset($this->objects[$viewHelperClassName]['delegateVariableProviderStack'])) {
+            $this->objects[$viewHelperClassName]['delegateVariableProviderStack'] = [];
+        }
+        $this->objects[$viewHelperClassName]['delegateVariableProviderStack'][] = $variableProvider;
+    }
+
+    public function getTopmostDelegateVariableContainer($viewHelperClassName)
+    {
+        if (!isset($this->objects[$viewHelperClassName]['delegateVariableProviderStack'])) {
+            return null;
+        }
+        return end($this->objects[$viewHelperClassName]['delegateVariableProviderStack']);
+    }
+
+    public function popDelegateVariableContainer($viewHelperClassName)
+    {
+        if (isset($this->objects[$viewHelperClassName]['delegateVariableProviderStack'])) {
+            return array_pop($this->objects[$viewHelperClassName]['delegateVariableProviderStack']);
+        }
+        return null;
+    }
+
     /**
      * Add a variable to the Variable Container. Make sure that $viewHelperName is ALWAYS set
      * to your fully qualified ViewHelper Class Name

src/ViewHelpers/RenderViewHelper.php

@@ -121,7 +121,21 @@ public static function renderStatic(array $arguments, \Closure $renderChildrenCl
         $delegate = $arguments['delegate'];
         /** @var RenderableInterface $renderable */
         $renderable = $arguments['renderable'];
+
+
+        // Prepare a delegate variable provider that will be possible to extract after rendering the child closure.
+        // Any variable defined therein gets used as argument and overrides any argument of the same name.
+        // Note: not using late static binding here is a conscious decision: if late static binding had been used
+        // then f:variable would not be able to reference this ViewHelper class' stack variable correctly.
+        $viewHelperVariableContainer = $renderingContext->getViewHelperVariableContainer();
+        $collector = $renderingContext->getVariableProvider()->getScopeCopy($variables);
+
+        $viewHelperVariableContainer->pushDelegateVariableContainer(self::class, $collector);
+
         $tagContent = $renderChildrenClosure();
+
+        $variables = $viewHelperVariableContainer->popDelegateVariableContainer(self::class)->getAll();
+
         if ($arguments['contentAs']) {
             $variables[$arguments['contentAs']] = $tagContent;
         }

src/ViewHelpers/VariableViewHelper.php

@@ -57,6 +57,9 @@ public static function renderStatic(
     ) {
         $value = $renderChildrenClosure();
         $renderingContext->getVariableProvider()->add($arguments['name'], $value);
+        if ($delegateVariableProvider = $renderingContext->getViewHelperVariableContainer()->getTopmostDelegateVariableContainer(RenderViewHelper::class)) {
+            $delegateVariableProvider->add($arguments['name'], $value);
+        }
     }
 
 }