Merge pull request #150 from docusign/embeded-sending

Embedded sending example updates

Author: InbarGazit

composer.json

@@ -15,13 +15,13 @@
     },
     "description": "DocuSign PHP launcher",
     "require": {
-        "docusign/admin-client": "^1.4.2",
-        "docusign/click-client": "^1.4.1",
-        "docusign/esign-client": "^6.19.0",
-        "docusign/rooms-client": "^2.1.1",
-        "docusign/monitor-client": "^1.2.1",
-        "docusign/webforms-client": "^1.0.1",
-        "docusign/maestro-client": "^1.0.0",
+        "docusign/admin-client": "^1.4.2-rc1",
+        "docusign/click-client": "^1.4.1-rc1",
+        "docusign/esign-client": "^7.0.0-rc1",
+        "docusign/rooms-client": "^2.1.1-rc1",
+        "docusign/monitor-client": "^1.2.1-rc1",
+        "docusign/webforms-client": "^1.0.1-rc1",
+        "docusign/maestro-client": "v1.0.0-rc1",
         "twig/twig": "^3.9.3",
         "league/oauth2-client": "^2.7.0",
         "ext-json": "*",

composer.lock

@@ -2,7 +2,12 @@
 
 namespace DocuSign\Services\Examples\eSignature;
 
-use DocuSign\eSign\Model\ReturnUrlRequest;
+use DocuSign\eSign\Model\EnvelopeViewRecipientSettings;
+use DocuSign\eSign\Model\EnvelopeViewDocumentSettings;
+use DocuSign\eSign\Model\EnvelopeViewTaggerSettings;
+use DocuSign\eSign\Model\EnvelopeViewTemplateSettings;
+use DocuSign\eSign\Model\EnvelopeViewRequest;
+use DocuSign\eSign\Model\EnvelopeViewSettings;
 
 class EmbeddedSendingService
 {
@@ -30,7 +35,7 @@ public static function embeddedSending(array $args, $clientService, $demoDocsPat
 
         # Create sender view
         #ds-snippet-start:eSign11Step3
-        $view_request = new ReturnUrlRequest(['return_url' => $args['ds_return_url']]);
+        $view_request = EmbeddedSendingService::prepareViewRequest($args['starting_view'], $args['ds_return_url']);
         $envelope_api = $clientService->getEnvelopeApi();
         $senderView = $envelope_api->createSenderView($args['account_id'], $envelope_id, $view_request);
 
@@ -43,4 +48,41 @@ public static function embeddedSending(array $args, $clientService, $demoDocsPat
         return ['envelope_id' => $envelope_id, 'redirect_url' =>  $url];
         #ds-snippet-end:eSign11Step3
     }
+
+    private static function prepareViewRequest(string $startingView, string $returnUrl): EnvelopeViewRequest
+    {
+        $viewSettings = new EnvelopeViewSettings([
+            'starting_screen' => $startingView,
+            'send_button_action' => 'send',
+            'show_back_button' => 'false',
+            'back_button_action' => 'previousPage',
+            'show_header_actions' => 'false',
+            'show_discard_action' => 'false',
+            'lock_token' => '',
+            'recipient_settings' => new EnvelopeViewRecipientSettings([
+                'show_edit_recipients' => 'false',
+                'show_contacts_list' => 'false'
+            ]),
+            'document_settings' => new EnvelopeViewDocumentSettings([
+                'show_edit_documents' => 'false',
+                'show_edit_document_visibility' => 'false',
+                'show_edit_pages' => 'false',
+            ]),
+            'tagger_settings' => new EnvelopeViewTaggerSettings([
+                'palette_sections' => 'default',
+                'palette_default' => 'custom'
+            ]),
+            'template_settings' => new EnvelopeViewTemplateSettings([
+                'show_matching_templates_prompt' => 'true'
+            ])
+        ]);
+
+        $viewRequest = new EnvelopeViewRequest([
+            'return_url' => $returnUrl,
+            'view_access' => 'envelope',
+            'settings' => $viewSettings
+        ]);
+
+        return $viewRequest;
+    }
 }

src/Services/Examples/eSignature/EmbeddedSendingService.php

@@ -45,8 +45,8 @@ <h4>{{ code_example_text['ExampleName'] | raw }}</h4>
         </label>
 
         <select id="starting_view" name="starting_view" class="form-control">
-            <option value="tagging" selected>Tagging view</option>
-            <option value="recipient">Recipient &amp; Documents view</option>
+            <option value="Tagger" selected>Tagging view</option>
+            <option value="Prepare">Prepare view</option>
         </select>
     </div>
     <div class="form-group">