zippyform 1.1.1

Streamline form development in Django effortlessly with this quick and code-free package. Create dynamic forms without writing code, making form development a breeze.

Zippy Form is a Django package that simplifies the creation of dynamic forms without requiring any coding.

Setup

To integrate the Zippy Form package into your Django project, follow these steps:

1. Add Package Name

• Open your Django project's settings.py file.
• Add the package name zippy_form to your project's INSTALLED_APPS.

2. Create Migration Files

• Open your terminal or command prompt.
• Run the following command to create migration files for the package:

python manage.py makemigrations zippy_form

3. Migrate

• Continue in your terminal.
• Run the following command to apply the migrations:

python manage.py migrate

4. Update URL Configuration

• In your Django project's urls.py file, add the following URL path to include the Zippy Form package's URLs:

path('form/', include('zippy_form.urls'))

By following these setup instructions, you'll successfully integrate the Zippy Form package into your Django project, allowing you to create dynamic forms with ease.

API Documentation

Click Here to view API Documentation.

---

Notes To Developer

# Subscribing to Zippy Form Events Using Callback Function

When specific functionalities occur on the Zippy Form, events will be triggered and you can subscribe to these events to receive data in your Django application.

Below is a list of events that you can subscribe to:

• New Account Created: This event is triggered when a new account is successfully created. To subscribe to these event and receive data in your Django app, follow the below steps

1. Open your project's settings file (usually named settings.py).
2. Import the function that you want to use for subscribing the event. For example: from yourapp.event_subscriptions import zippyform_after_account_create Replace "yourapp.event_subscriptions" with the actual path to your event_subscription function.
3. Add the below snippet to the settings file, ZF_EVENT_AFTER_ACCOUNT_CREATE = zippyform_after_account_create Replace "zippyform_after_account_created" with the name of the function you imported.

• New Form Created: This event is triggered when a new form is successfully created. To subscribe to these event and receive data in your Django app, follow the below steps

1. Open your project's settings file (usually named settings.py).
2. Import the function that you want to use for subscribing the event. For example: from yourapp.event_subscriptions import zippyform_after_form_create Replace "yourapp.event_subscriptions" with the actual path to your event_subscription function.
3. Add the below snippet to the settings file, ZF_EVENT_AFTER_FORM_CREATE = zippyform_after_form_create

• After Form Submit: This event is triggered when a form submitted(save or update). To subscribe to these event and receive data in your Django app, follow the below steps

1. Open your project's settings file (usually named settings.py).
2. Import the function that you want to use for subscribing the event. For example: from yourapp.event_subscriptions import zippyform_after_form_submit Replace "yourapp.event_subscriptions" with the actual path to your event_subscription function.
3. Add the below snippet to the settings file, ZF_EVENT_AFTER_FORM_SUBMIT = zippyform_after_form_submit

# Subscribing to Zippy Form Events Using Webhooks(Upcoming Release)

When specific functionalities occur on the Zippy Form, webhooks will be triggered.

# Overwrite Zippy Form Defaults

• List Per Page Size: To overwrite the default per page size of list (which is set to 6), you can configure it in the project settings file by adding the following line: ZF_LIST_PER_PAGE = 10 Replace "10" with your desired page size value. This allows you to customize the default per page size for the Zippy Form list.

• Form Field Label Unique: If you need to allow duplicate values for form field labels, you can configure it in the project settings file by adding the following line: ZF_IS_FIELD_LABEL_UNIQUE = False

---

FAQ

# Q1: Does Zippy Form support multi-step forms?

A: Yes, Zippy Form does support multi-step forms, allowing you to create and manage forms with multiple steps to collect information in a structured and user-friendly manner.

# Q2: Can a form be created without an account?

A: No, an account needs to be created before a form can be created because each form needs to be mapped to an account.

# Q3: How many accounts can be created?

A: There is no limit to creating accounts. If you are using the package in a standalone application, you can create a single account and map all the forms to it. If you are using the package in a multi-tenant application, you can create an account for each tenant and map the forms under that respective account.

# Q4: How can I synchronize my application's user account (tenant) with Zippy Form?

A: When creating an account in Zippy Form, include the unique ID associated with your application's user account(tenant) in the meta_detail parameter. This unique ID serves as a linkage between your application and Zippy Form. After you've passed the unique ID, you can retrieve it when Zippy Form events occur. Whether you're using event callback functions or webhooks, the meta_detail data will be included in the event payload.

# Q5: Can I include additional details when creating a form in Zippy Form?

A: Yes, you can pass additional details when creating a form in Zippy Form using the meta_detail parameter. This allows you to provide extra information or context related to the form. Subsequently, when Zippy Form events occur, whether you're utilizing event callback functions or webhooks, the meta_detail data you passed will be included in the event payload, enabling you to access and use it as needed.

# Q6: Why are form field labels set as unique?

A: Form field labels are set as unique by default to serve as unique identifiers when syncing form submission data to a Google Sheets, ensuring accurate data organization and management. If you wish to override this default behavior, please refer to the Overwrite Zippy Form Defaults > Form Field Label Unique section for instructions.

# Q7: What does receiving a "permission_error" with a 403 code mean when interacting with an API?

A: If you encounter a "permission_error" with a 403 status code, it typically indicates that there is an issue with authentication. This error commonly occurs when you have either missed passing the ZF-SECRET-KEY token in the header of your API request or the ZF-SECRET-KEY token provided is invalid. To resolve this, ensure that you include the correct and valid ZF-SECRET-KEY token in your API request's header for proper authentication.

# Q8: Where can I obtain the "ZF-SECRET-KEY"?

A: You can use your Zippy Form account ID as the ZF-SECRET-KEY. This ID uniquely identifies your Zippy Form account. Obtain your Zippy Form account ID by making an API request to the Form Builder / List All Accounts endpoint. This API call will provide you with the necessary account ID to use as the ZF-SECRET-KEY in your integration.

# Q9: Why am I receiving an "Invalid Form ID" error message when attempting to submit a form?

A: You will encounter the "Invalid Form ID" error message when submitting a form if the following conditions are not met:

• Form Status: The form can only be submitted if its status is active. If the form is in any other state such as deleted, inactive, or draft you will receive this error message.
• Form ID Validity: Ensure that the form ID you have provided is accurate and corresponds to an existing, active form. An incorrect or nonexistent form ID will trigger the "Invalid Form ID" error.

# Q10: Why are the fields I created not displaying on the form?

A: Only active fields will be displayed on the form for submission. To resolve this, you can use the Form Builder / Update Form API to update the field status from draft to active ensuring that they are visible and can be submitted on the form.

# Q11: Can I handle my own business logic when an account is created, a form is created, or a form is submitted in Zippy Form?

A: Yes, you have the flexibility to handle your own business logic when working with Zippy Form. The approach depends on whether you've installed the Zippy Form package in a standalone application or a multi-tenant application:

• Standalone Application: If you've integrated Zippy Form into a standalone application, you can subscribe to Zippy Form events using callback functions. This feature enables you to access event data within any function you add to your application.
• Multi-Tenant Application: For multi-tenant applications, you can subscribe to Zippy Form events using webhooks. Webhooks provide a way to receive real-time notifications about Zippy Form events, and you can handle these events in your application according to your business needs.

For detailed instructions on how to implement these approaches, please refer to the "Notes To Developer" section in the Zippy Form documentation, which provides comprehensive information on how to use callback functions and webhooks for event handling.

# Q12: Does the "After Form Submit" event trigger after each form step or only at the final step?

A: The "After Form Submit" event typically triggers after the last form step has been completed and the entire form has been submitted. This event occurs once the user has finished providing input and confirmed their submission. It does not trigger after each form step but rather at the conclusion of the entire form submission process.

# Q13: Does Zippy Form support unique validation?

A: Yes, Zippy Form supports unique validation. Unique validation checks submitted entries in forms with draft and active statuses to ensure that values are unique, preventing duplicate entries.

# Q14: Can I delete an uploaded file?

A: Yes, you can delete an uploaded file. If the field is set as not required, you can simply pass "reset" to the field key when updating the entry, and it will delete the previously uploaded file.

# Q15: How can I update a form without adding a new file and retaining the old file?

A: To update a form without adding a new file and retain the old file, you can pass an empty value to the field key. This action will skip the required validation during the update and keep the old file intact.

# Q16: Why is my media not saving to the media folder in Zippy Form?

A: Zippy Form does not control the location where media is saved; instead, it relies on your Django application's configuration. To ensure your media is saved to the correct folder, follow these steps:

1. Configure Django Settings: Open your Django project's settings file and add the following snippets:

import os

DOMAIN = "http://127.0.0.1:8000"
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
MEDIA_FOLDER = '/media/'
MEDIA_URL = DOMAIN + MEDIA_FOLDER

2. Update URL Configuration: In your Django project's urls.py file, include the ZippyForm package's URL patterns, and make sure to handle static media files by adding the following:

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    ...  ,
    path('form/', include('zippy_form.urls')),  # Include Zippy Form package's URL patterns here
] + static(settings.MEDIA_FOLDER, document_root=settings.MEDIA_ROOT)

By following these steps and configuring your Django project correctly, media files should be saved to the specified media folder.

# Q17: How can I make my submitted form data sync to Google Sheet?

A: To sync the submitted form data to Google Sheet, follow these steps:

1. Open your project's settings.py file.
2. Add the following snippet to enable the syncing of form submissions to Google Sheet:

ZF_GSHEET_SYNC_FORM_SUBMISSION = True

3. Additionally, you need to provide the Google Sheet credentials. Add your credentials to the Zippy Form project settings by assigning them to ZF_GSHEET_CREDENTIALS.

Sample Gsheet Credentials:

ZF_GSHEET_CREDENTIALS = {
  "type": "service_account",
  "project_id": "gsheet-test-******",
  "private_key_id": "",
  "private_key": "",
  "client_email": "",
  "client_id": "",
  "auth_uri": "",
  "token_uri": "",
  "auth_provider_x509_cert_url": "",
  "client_x509_cert_url": "",
  "universe_domain": ""
}

By following these steps, your form submissions will be automatically synchronized with Google Sheet. This ensures that your data is efficiently organized and accessible for further analysis or processing.

# Q18: Where can I find the Google Sheet URL to view the data submitted through the form?

A: After enabling Google Sheet form submission sync and adding Google Sheet credentials:

1. Create a new form.
2. Once the form is created, Google Sheet will automatically be created and shared with the admin email provided in your account. You can also find the Google Sheet URL on the Form Builder / List All Forms API.

# Q19: Why is the Google Sheet document created blank after creating a new form?

A: The Google Sheet document remains blank initially because the headers for the sheet are synced only when triggering the Form Builder / Update Form API. This synchronization ensures that only the active fields from the form are transferred to the Google Sheet as headers, allowing for precise and organized data tracking.

# Q20: Can I move/rearrange columns in Google Sheet to different positions directly within the sheet?

A: Yes, you can freely move columns to different positions within the Google Sheet. However, it's essential to ensure that you do not modify the column headings while moving them, as altering column headings can lead to synchronization issues with associated data.

---

Releases

Version	Features
1.0.0	Form Builder, Dynamic Form, Subscribing To Events Using Callback Function
1.1.0	Save Submitted Form Entries To Google Sheet

Upcoming Releases

Version	Features
1.2.0	Webhook Support
1.3.0	Payment Form