Requirement Fields

Requirement fields are custom form questions attached to service products. Customers must fill out these fields after purchasing a service before the vendor can begin work.

Field Types

Textbox

A single-line text input for short responses.

Best for: Names, URLs, brief instructions, file naming preferences.

Textarea

A multi-line text input for longer responses.

Best for: Project descriptions, detailed instructions, special requirements.

WYSIWYG Editor

A WordPress TinyMCE rich text editor with formatting toolbar.

Best for: Detailed briefs with formatting, styled content requirements, specifications that need headings or lists.

File Upload

A file upload field that allows customers to attach files with their requirements.

Best for: Logo files, brand assets, reference images, source documents.

Dropdown

A single-select dropdown menu where the customer picks one option.

Best for: Category selection, language preference, format options, any list with many choices.

Multi-Select

A multi-select dropdown (powered by Select2) where the customer can choose multiple options.

Best for: Selecting multiple features, choosing multiple platforms, any “select all that apply” scenario.

Radio Button

A set of predefined options where the customer selects exactly one.

Best for: Yes/No questions, service tier selection, turnaround time preference, style choices.

Adding Requirement Fields

1. Edit a product with the Service checkbox enabled
2. Scroll down to the Service Requirement Questions meta box
3. Click Add Field
4. Choose the field type (Textbox, Textarea, WYSIWYG Editor, File Upload, Dropdown, Multi-Select, or Radio Button)
5. Enter the question label
6. For Dropdown, Multi-Select, and Radio Button fields, add the available options
7. Check Required if the field must be completed
8. Repeat for additional fields

Managing Fields

• Reorder — drag and drop fields to change their display order
• Delete — click the remove button on any field
• Edit — click a field to modify its label, options, or required status

Export and Import

Requirement field configurations can be exported from one product and imported into another:

• Export — exports the requirement field definitions as JSON via an AJAX handler
• Import — imports a previously exported JSON configuration to a different product

This is useful when creating multiple service products with the same or similar requirement forms.

How Customers See Requirements

After a customer completes checkout for a service product:

1. If redirect is enabled and the order contains a single service, they are redirected to the service order page
2. The requirement form displays all fields configured for the product
3. Required fields must be completed before the form can be submitted
4. Once submitted, the order status changes from Waiting For Requirement to Work In Progress
5. The vendor receives an email notification with the submitted requirements

Requirements in the Order View

Both the customer and vendor can view submitted requirements on the order detail page. Requirements appear in a dedicated section above the conversation area.

The vendor also sees requirements in the WooCommerce order admin under the service meta box.

Storage

Requirement field definitions are stored as product meta using the key wbcom_wss_req_ques. Customer responses are stored as order item meta using the key wbcom_wss_customer_requirement, linked to the specific line item in the WooCommerce order. File attachments are stored separately under the woo_sell_attachment meta key.