From 0a14122cbf327801038a01b145fc3681d72cc48e Mon Sep 17 00:00:00 2001 From: pravin Date: Fri, 10 Oct 2025 10:40:32 +0530 Subject: [PATCH 1/3] Update request-signatures.md Update the help document for navigation menu. --- docs/docs/help/New-Document/request-signatures.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/docs/help/New-Document/request-signatures.md b/docs/docs/help/New-Document/request-signatures.md index 016374e001..1e2df3a9cb 100644 --- a/docs/docs/help/New-Document/request-signatures.md +++ b/docs/docs/help/New-Document/request-signatures.md @@ -240,6 +240,11 @@ Use the option on the right side to add recipients if you need to include additi - Add Signer/Change Signer: Clicking the first icon on the Email widget allows you to change the signer. You can choose from existing signers in the dropdown or add a new signer. - Copy : Clicking on this you can duplicate the email widget. ### 📄 Document Page Controls +- **Navigating Between Pages in OpenSign™** + To navigate between pages of a document that you have uploaded either click on the previous page ∧ & V next page buttons at the top or click on any of the page previews loaded on the left side. + + OpenSign Page controls + - **Add Pages** In the left-side panel, users will see an **"Add" button**. Clicking it allows users to select and merge new documents into the current one. @@ -254,8 +259,6 @@ Use the option on the right side to add recipients if you need to include additi - **Rotate Page** Options are provided to **rotate pages** in both **clockwise** and **counterclockwise** directions. - -OpenSign_Widgets ### Step 4: Next: - **Next**: After adding the widgets and signatures, click the 'Next' button. The document will then be created. From 7680c8e140683aca15c1b94eadd0766d33c9b966 Mon Sep 17 00:00:00 2001 From: pravin Date: Fri, 10 Oct 2025 10:46:24 +0530 Subject: [PATCH 2/3] Update and rename navigate-between-pages.md to widgets.md --- .../New-Document/navigate-between-pages.md | 9 -- docs/docs/help/New-Document/widgets.md | 100 ++++++++++++++++++ 2 files changed, 100 insertions(+), 9 deletions(-) delete mode 100644 docs/docs/help/New-Document/navigate-between-pages.md create mode 100644 docs/docs/help/New-Document/widgets.md diff --git a/docs/docs/help/New-Document/navigate-between-pages.md b/docs/docs/help/New-Document/navigate-between-pages.md deleted file mode 100644 index f7705c792e..0000000000 --- a/docs/docs/help/New-Document/navigate-between-pages.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -sidebar_position: 3 -title: Navigate between pages of a document ---- - -# How to navigate between pages of a document in OpenSign™? - -To navigate between pages of a document that you have uploaded either click on the previous page `<<` & next page `>>` buttons at the top or click on any of the page previews loaded on the left side - -![image](https://github.com/user-attachments/assets/4d4d8dc1-1197-4b29-90ea-3537389bd1d8) diff --git a/docs/docs/help/New-Document/widgets.md b/docs/docs/help/New-Document/widgets.md new file mode 100644 index 0000000000..33da99b56c --- /dev/null +++ b/docs/docs/help/New-Document/widgets.md @@ -0,0 +1,100 @@ +--- +sidebar_position: 3 +title: Widgets in OpenSign +--- + +# 🧩 Understanding Widgets in OpenSign + +Widgets in **OpenSign** are interactive fields that you can place on your documents to collect information, signatures, or confirmations from recipients during the signing process. + +They make your documents dynamic — allowing signers to fill in details like names, dates, numbers, checkboxes, or digital signatures directly within the document. + +Widgets help you: +- Create fillable and interactive documents +- Control the type of input signers can provide (text, date, number, etc.) +- Ensure data consistency and validation +- Streamline form completion and signing workflows + +OpenSign offers various widget types such as **Signature**, **Initial**, **Text**, **Date**, **Checkbox**, **Stamp**, and now the newly added **Number Widget** — each designed for specific use cases. + +# 🧮 Number Widget – Help Guide + +The **Number Widget** in **OpenSign** allows you to collect numeric input from signers within your document — such as phone numbers, invoice totals, employee IDs, or any other numerical values. + +This widget ensures that only **numbers** can be entered, helping maintain data accuracy and consistency in your signed documents. + +--- + +## 🔹 Purpose + +Use the **Number Widget** when you need signers to input strictly numerical data during the signing process. +It’s ideal for: + +- Numeric IDs (e.g., Employee ID, Order Number) +- Contact numbers +- Amounts or values +- Zip/Postal codes +- Quantity or count fields + +--- + +## 🧭 How to Add the Number Widget + +1. Open a document in the **OpenSign editor**. +2. From the **Widget Toolbar**, select **“Number”**. +3. Click anywhere on the document where you want the number field to appear. +4. Adjust the size and position as needed. +5. Assign the widget to a **signer** (if the document has multiple signers). + +--- + +## ⚙️ Widget Properties + +You can configure the following options for the **Number Widget**: + +| **Property** | **Description** | +|---------------|-----------------| +| **Label** | Adds a name or description for the field (e.g., *Enter Invoice Number*). | +| **Placeholder** | Displays a hint or example inside the field before the signer types (e.g., *12345*). | +| **Default Value** | Pre-fills the field with a number (optional). | +| **Required** | Makes the field mandatory for the signer to complete before submission. | +| **Read-Only** | Displays the number but prevents editing by the signer. | +| **Validation** | Ensures only numbers are entered — no alphabets or special characters are allowed. | + +--- + +## ✍️ Signer Experience + +When the document is opened for signing: + +- The signer will see a numeric input box where the Number Widget is placed. +- Only **digits (0–9)** can be entered in the field. +- If the field is marked **Required**, the signer cannot complete signing without entering a number. +- The entered number will appear in the final signed PDF. + +--- + +## 📄 Example Use Case + +**Scenario:** +You’re sending a purchase order form where the vendor needs to enter a **quotation amount**. +Add a **Number Widget** labeled “Quotation Amount” and mark it as **Required**. +This ensures the vendor provides a valid numeric value before submitting the signed document. + +--- + +## 💡 Tips + +- Use the **Number Widget** for fields where accuracy is critical — such as payment amounts or IDs. +- Combine with **Text** or **Date Widgets** to create comprehensive forms. +- Avoid using the **Number Widget** for formatted data (e.g., currency symbols, percentages). For such cases, predefine formatting in the document. + +--- + +## 🔐 Output in Final Document + +Once signed, the numeric input appears exactly as entered in the signed PDF, maintaining consistent alignment and formatting. + +--- + +> 📝 *Tip: You can include screenshots here for better visual guidance (e.g., toolbar selection, widget placement, and signer view).* From ef1d4967d97d31b179a75b62f0d810f15648c861 Mon Sep 17 00:00:00 2001 From: pravin Date: Fri, 10 Oct 2025 13:00:31 +0530 Subject: [PATCH 3/3] Update widgets.md Update the content for number widget --- docs/docs/help/New-Document/widgets.md | 105 ++++++++++++++++--------- 1 file changed, 68 insertions(+), 37 deletions(-) diff --git a/docs/docs/help/New-Document/widgets.md b/docs/docs/help/New-Document/widgets.md index 33da99b56c..3194e1ca99 100644 --- a/docs/docs/help/New-Document/widgets.md +++ b/docs/docs/help/New-Document/widgets.md @@ -9,42 +9,44 @@ Widgets in **OpenSign** are interactive fields that you can place on your docume They make your documents dynamic — allowing signers to fill in details like names, dates, numbers, checkboxes, or digital signatures directly within the document. -Widgets help you: +**Widgets help you:** - Create fillable and interactive documents - Control the type of input signers can provide (text, date, number, etc.) - Ensure data consistency and validation - Streamline form completion and signing workflows -OpenSign offers various widget types such as **Signature**, **Initial**, **Text**, **Date**, **Checkbox**, **Stamp**, and now the newly added **Number Widget** — each designed for specific use cases. +OpenSign offers various widget types such as **Signature**, **Initial**, **Text**, **Date**, **Checkbox**, **Stamp**, and the newly added **Number Widget** — each designed for specific use cases. -# 🧮 Number Widget – Help Guide +--- + +# 🧮 Number Widget -The **Number Widget** in **OpenSign** allows you to collect numeric input from signers within your document — such as phone numbers, invoice totals, employee IDs, or any other numerical values. +The **Number Widget** in **OpenSign** lets you collect numeric input from signers within your document. +It can also perform **dynamic calculations** using values from other number widgets. -This widget ensures that only **numbers** can be entered, helping maintain data accuracy and consistency in your signed documents. +This widget ensures that only **numbers** are entered, helping maintain data accuracy and consistency across signed documents. --- ## 🔹 Purpose -Use the **Number Widget** when you need signers to input strictly numerical data during the signing process. +Use the **Number Widget** when you need signers to input strictly numeric data during the signing process. It’s ideal for: -- Numeric IDs (e.g., Employee ID, Order Number) -- Contact numbers -- Amounts or values -- Zip/Postal codes -- Quantity or count fields +- Numeric IDs (e.g., Employee ID, Order Number) +- Amounts or currency values +- Quantity or item counts +- Zip/Postal codes --- -## 🧭 How to Add the Number Widget +## 🧭 How to Add a Number Widget -1. Open a document in the **OpenSign editor**. +1. Upload the document and open the Create Document panel. 2. From the **Widget Toolbar**, select **“Number”**. 3. Click anywhere on the document where you want the number field to appear. -4. Adjust the size and position as needed. -5. Assign the widget to a **signer** (if the document has multiple signers). +4. Adjust its size and position as needed. +5. Assign the widget to a **signer** (if the document has multiple signers). --- @@ -54,12 +56,13 @@ You can configure the following options for the **Number Widget**: | **Property** | **Description** | |---------------|-----------------| -| **Label** | Adds a name or description for the field (e.g., *Enter Invoice Number*). | -| **Placeholder** | Displays a hint or example inside the field before the signer types (e.g., *12345*). | -| **Default Value** | Pre-fills the field with a number (optional). | -| **Required** | Makes the field mandatory for the signer to complete before submission. | -| **Read-Only** | Displays the number but prevents editing by the signer. | -| **Validation** | Ensures only numbers are entered — no alphabets or special characters are allowed. | +| **Name** | A unique identifier for this number widget.
• Example: `number-1`, `number-2`
• Must be unique within the document.
• Used in formulas as `{{number-1}}`.
🔸 *If you include a number widget in a formula, its name must be unique, since formulas rely on these identifiers.* | +| **Default Value** | (Optional) Sets an initial numeric value for the widget. This value appears automatically unless changed by the signer or overridden by a formula. | +| **Formula** | Defines a calculation using other number widgets.| +| **Required / Optional** | Specifies whether the signer must complete the field before submission. | +| **Placeholder** | Displays hint text before input (e.g., *12345*). | +| **Font Size** | Controls the font size of the number displayed on the document. | +| **Color** | Sets the font color for the number field. | --- @@ -67,34 +70,62 @@ You can configure the following options for the **Number Widget**: When the document is opened for signing: -- The signer will see a numeric input box where the Number Widget is placed. -- Only **digits (0–9)** can be entered in the field. -- If the field is marked **Required**, the signer cannot complete signing without entering a number. -- The entered number will appear in the final signed PDF. +- The signer will see a **numeric input box** at the widget’s location. +- Only **digits (0–9)** can be entered. +- If marked as **Required**, the signer cannot finish signing without entering a number. +- The entered value appears in the final signed PDF. + +--- + +## 🔢 Using Formulas in the Number Field + +You can use number widgets to perform **arithmetic and algebraic calculations** inside the **Formula** field. +Assume you have four number widgets named: +`number-1`, `number-2`, `number-3`, and `number-4`. --- -## 📄 Example Use Case +### 🧩 Basic Formulas -**Scenario:** -You’re sending a purchase order form where the vendor needs to enter a **quotation amount**. -Add a **Number Widget** labeled “Quotation Amount” and mark it as **Required**. -This ensures the vendor provides a valid numeric value before submitting the signed document. +| **Formula** | **Description** | **Example Result** | +|--------------|-----------------|--------------------| +| `{{number-1}} + {{number-2}}` | Adds two numbers | 10 + 5 = **15** | +| `{{number-1}} - {{number-3}}` | Subtracts one number from another | 20 - 4 = **16** | +| `{{number-1}} * {{number-2}}` | Multiplies two numbers | 6 * 3 = **18** | +| `{{number-1}} / {{number-2}}` | Divides one number by another | 25 / 5 = **5** | +| `({{number-1}} + {{number-2}}) * {{number-3}}` | Groups values using parentheses | (4 + 6) * 2 = **20** | +| `{{number-1}} + {{number-2}} - ({{number-3}} * {{number-4}})` | Combines multiple operations | 10 + 8 - (2 * 3) = **12** | --- -## 💡 Tips +### 🧮 Advanced Formulas -- Use the **Number Widget** for fields where accuracy is critical — such as payment amounts or IDs. -- Combine with **Text** or **Date Widgets** to create comprehensive forms. -- Avoid using the **Number Widget** for formatted data (e.g., currency symbols, percentages). For such cases, predefine formatting in the document. +| **Formula** | **Description** | **Example Result** | +|--------------|-----------------|--------------------| +| `({{number-1}} + {{number-2}} + {{number-3}}) / 3` | Calculates the average of three widgets | (10 + 20 + 30) / 3 = **20** | +| `({{number-1}} * {{number-2}}) + ({{number-3}} / {{number-4}})` | Combines multiplication and division | (5 * 6) + (8 / 4) = 30 + 2 = **32** | +| `({{number-1}} + {{number-2}}) * ({{number-3}} - {{number-4}})` | Multiplies a sum by a difference | (10 + 5) * (6 - 2) = 15 * 4 = **60** | +| `({{number-1}} * {{number-2}} * {{number-3}}) / {{number-4}}` | Calculates a scaled ratio | (2 * 3 * 4) / 2 = 24 / 2 = **12** | +| `({{number-1}} + {{number-2}} + {{number-3}} + {{number-4}}) / 4` | Finds the average of four widgets | (8 + 10 + 12 + 14) / 4 = **11** | +| `{{number-1}} * ({{number-2}} + {{number-3}} - {{number-4}})` | Weighted total | 5 * (10 + 4 - 2) = 5 * 12 = **60** | +| `({{number-1}} + {{number-2}})^2 / {{number-3}}` | Squares the sum and divides by another widget | (4 + 6)^2 / 5 = 100 / 5 = **20** | +| `({{number-1}} * {{number-2}} + {{number-3}}) * {{number-4}}` | Compound operation using addition and multiplication | (3 * 4 + 2) * 5 = (12 + 2) * 5 = **70** | +| `({{number-1}}^2 + {{number-2}}^2) / ({{number-3}} + {{number-4}})` | Sum of squares divided by total | (3² + 4²) / (2 + 1) = (9 + 16) / 3 = **8.33** | --- -## 🔐 Output in Final Document +## 🧠 Tips -Once signed, the numeric input appears exactly as entered in the signed PDF, maintaining consistent alignment and formatting. +- Use **parentheses `( )`** to control calculation order. +- Formulas follow **standard arithmetic precedence** (multiplication/division before addition/subtraction). +- Only **number widgets (`{{number-x}}`)** can be used in formulas. +- Non-numeric fields (like text or date) are **not supported** in formula expressions. +- Ensure all widget names used in formulas exist in the same document. --- -> 📝 *Tip: You can include screenshots here for better visual guidance (e.g., toolbar selection, widget placement, and signer view).* +## 📩 Need Help? + +If you need further assistance, contact our support team at **support@opensignlabs.com**. + +Happy Signing with **OpenSign™**!