Merge pull request #9 from martywallace/master

Ability to provide rendering options to the render function

README.md

@@ -67,6 +67,15 @@ Add the following tag to your form where you’d like the reCAPTCHA to be displa
 {{ craft.recaptcha.render() }}
 ```
 
+Render parameters [per the documentation](https://developers.google.com/recaptcha/docs/display#render_param) are injectable to the `render()` function, e.g.
+
+```twig
+{{ craft.recaptcha.render({
+  theme: 'dark',
+  size: 'compact'
+}) }}
+```
+
 You can also create the reCAPTCHA element yourself using the `sitekey` template variable. This is especially useful for implementing invisible recaptcha.
 
 ```twig

src/services/CraftRecaptchaService.php

@@ -35,15 +35,19 @@ class CraftRecaptchaService extends Component
     // Public Methods
     // =========================================================================
 
-    public function render()
+    public function render(array $options = [])
     {
         $settings = CraftRecaptcha::$plugin->getSettings();
 
         \Craft::$app->view->registerJsFile('https://www.google.com/recaptcha/api.js');
 
+        $defaultOptions = [
+            'sitekey' => $settings->attributes['siteKey']
+        ];
+
         $vars = array(
             'id' => 'gRecaptchaContainer',
-            'siteKey' => $settings->attributes['siteKey']
+            'options' => array_merge($defaultOptions, $options)
         );
 
         $oldMode = \Craft::$app->view->getTemplateMode();

src/templates/_recaptcha.twig

@@ -1 +1 @@
-<div class="g-recaptcha" data-sitekey="{{siteKey}}" id="{{id}}"></div>
+<div class="g-recaptcha" id="{{id}}" {% for key, value in options %}data-{{ key }}="{{ value }}" {% endfor %}></div>

src/variables/CraftRecaptchaVariable.php

@@ -36,12 +36,12 @@ class CraftRecaptchaVariable
      *
      *    {{ craft.recaptcha.render() }}
      *
-     * @param null $params
+     * @param array $options
      * @return string
      */
-    public function render()
+    public function render(array $options = [])
     {
-      return CraftRecaptcha::$plugin->craftRecaptchaService->render();
+      return CraftRecaptcha::$plugin->craftRecaptchaService->render($options);
     }
 
     public function sitekey()