Devdocs 8770: createHasAgreed code example (#92)

* Bump twig/twig from 3.3.8 to 3.4.3 in /Quick_ACG

Bumps [twig/twig](https://github.com/twigphp/Twig) from 3.3.8 to 3.4.3.
- [Release notes](https://github.com/twigphp/Twig/releases)
- [Changelog](https://github.com/twigphp/Twig/blob/3.x/CHANGELOG)
- [Commits](twigphp/Twig@v3.3.8...v3.4.3)

---
updated-dependencies:
- dependency-name: twig/twig
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>

* Bump twig/twig from 3.3.8 to 3.4.3

Bumps [twig/twig](https://github.com/twigphp/Twig) from 3.3.8 to 3.4.3.
- [Release notes](https://github.com/twigphp/Twig/releases)
- [Changelog](https://github.com/twigphp/Twig/blob/3.x/CHANGELOG)
- [Commits](twigphp/Twig@v3.3.8...v3.4.3)

---
updated-dependencies:
- dependency-name: twig/twig
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>

* README.md updates

* initial commit

* adding in routes

* bug in click2

* checking in fixes for embed clickwrap

* bugfix and check-in

* small cleanup changes

* show inactive clickwraps and redirect if used and removed extra error string on template render method

* checks before loading example and reroutes based on clickwraps present and/or active

* manifest error fix

* error text fixes

* error fixes

* check in

* fixed error handling

* small bugfixes

* fix small bug on ifelse in index

* figured out the mismatch on error handling

* match pdf doc from other launchers

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Inbar Gazit <inbar.gazit@docusign.com>

Author: 3 people

composer.json

@@ -14,7 +14,7 @@
     },
     "require": {
         "docusign/admin-client": "1.1.0",
-        "docusign/click-client": "1.1.0",
+        "docusign/click-client": "1.2.2",
         "docusign/esign-client": "6.8.0",
         "docusign/rooms-client": "2.0.0",
         "docusign/monitor-client": "1.1.0",

composer.lock

@@ -39,7 +39,7 @@ function createController(): void
         );
 
         if ($clickwrapSummaryResponse) {
-            $clickwrap_name = $clickwrapSummaryResponse['clickwrapName'];
+            $clickwrap_name = $clickwrapSummaryResponse['clickwrap_name'];
             $clickwrapSummaryResponse = json_decode((string)$clickwrapSummaryResponse, true);
             $this->clientService->showDoneTemplateFromManifest(
                 $this->codeExampleText,

public/demo_documents/TermsOfService.pdf

@@ -0,0 +1,80 @@
+<?php
+
+namespace Example\Controllers\Examples\Click;
+
+use DocuSign\Click\Client\ApiException;
+use Example\Controllers\ClickApiBaseController;
+use Example\Services\Examples\Click\EmbedClickwrapService;
+
+class EG006EmbedClickwrap extends ClickApiBaseController
+{
+    const EG = 'ceg006'; # reference (and URL) for this example
+    const FILE = __FILE__;
+
+    /**
+     * 1. Get available clickwraps
+     * 2. Create a new controller instance.
+     *
+     * @return void
+     */
+    public function __construct()
+    {
+        parent::__construct();
+        # Get available clickwraps
+        $clickwraps = EmbedClickwrapService::getClickwraps(
+            $this->routerService,
+            $this->clientService,
+            $this->args,
+            $this::EG
+        );
+
+        parent::controller(['clickwraps' => $clickwraps[0], 'inactives'=>$clickwraps[1]]);
+    }
+
+  
+
+    /**
+     * 1. Check the token
+     * 2. Call the worker method
+     * 3. Display clickwrap responses data
+     *
+     * @return void
+     */
+    function createController(): void
+    {
+        $this->checkDsToken();
+        $clickwrapResponse = EmbedClickwrapService::createAgreeementUrl($this->args, $this->clientService);
+        $htmlString = "<p id='agreementStatus'>NOT AGREED</p><div id='ds-terms-of-service'></div><script src='https://stage.docusign.net/clickapi/sdk/latest/docusign-click.js'></script><script>docuSignClick.Clickwrap.render({agreementUrl: '" . $clickwrapResponse . "',onAgreed: function () {document.getElementById('agreementStatus').innerHTML = 'AGREED';}}, '#ds-terms-of-service');</script>";
+        if ($clickwrapResponse) {
+
+            if($clickwrapResponse === 'Already Agreed'){
+                $e = new ApiException("The email address was already used to agree to this elastic template. Provide a different email address if you want to view the agreement and agree to it.",990);
+                $this->clientService->showErrorTemplate($e);
+                exit;
+            }
+
+
+
+            $this->clientService->showDoneTemplateFromManifest(
+                $this->codeExampleText,
+                null,
+                $this->codeExampleText["ResultsPageText"]."<p>Agreement URL received back from API call: <code>".$clickwrapResponse."</code></p>".$htmlString
+            );
+            
+        }
+    }
+
+    public function getTemplateArgs(): array
+    {
+        return [
+            'account_id' => $_SESSION['ds_account_id'],
+            'ds_access_token' => $_SESSION['ds_access_token'],
+            'clickwrap_id' => $this->checkInputValues($_POST['clickwrap_id']),
+            'full_name' => $this->checkInputValues($_POST['fullName']),
+            'email_address' => $this->checkInputValues(($_POST['emailAddress'])),
+            'company' => $this->checkInputValues($_POST['company']),
+            'job_title' => $this->checkInputValues($_POST['jobTitle']),
+            'date' => $this->checkInputValues($_POST['date'])
+        ];
+    }
+}

src/Controllers/Examples/Click/EG001CreateClickwrap.php

@@ -32,8 +32,19 @@ public function controller()
         }
     }
 
+    
     private function getController()
     {
+        /* 
+        we don't know if the api_type has been set, 
+        if it has never been set, this will trigger an 
+        error in the manifest, therefore, we'll set it 
+        to ESignature for the Manifest service to work. 
+        */
+        if(!isset($_SESSION['api_type'])){
+            $_SESSION['api_type'] = "ESignature";
+        }
+
         $GLOBALS['twig']->display(
             'select_api.html',
             [