Checkbox Field for Product & Variation
This field type is used to create a multi choice checked list. It used to collect extra choices from the user. Checkbox field for Products and Checkbox field for Variations has same properties.
Checkbox Field Configurations for Product & Variation
Option | Description |
---|---|
Options | Use the Option Factory (Located at the Right Side) to create Check boxs. for manual creation see the below explanation.
Each check box will contains Value attribute (which is not visible to User) with that you will have to provide a caption which convey the purpose of that Check Box. So basically we need two things to create a single Check Box, Value and Label, Value represent the Value attribute of the checkbox and Label represent the Caption. Here we represent a single option with “|” delimiter, if more than one option then delimit with new line.
|
Default Options | Default Options for this radio group, all the check boxes created will be displayed here on real time – (These options will be used incase If user hadn’t chosen any). |
Layout | How the Checkboxes should be stocked on the screen Vertically or Horizontally. |
Required | Make this checkboxes group mandatory – user cannot perform Add To Cart operation without choosing this any option. |
Message | Message that has to be displayed when validation failed for this checkbox group (When the Required Option is Set). |
Visibility | Whether this checkboxes value (Chosen by the user) has to be displayed on the Cart & Check Page. Note: Regardless of this option this fields value will be added as Order Meta (Unless you configured not so). |
Order Item Meta | Whether to add this field’s value (Chosen by the user) as Order Item Meta. |
Send to Customer | Whether to show this field to customer’s order email and customer’s order view (in the My Account page). Even though it is added as Order Item Meta, but visible only to store admin only. |
Logged in Users Only | Make this field available only for the Registered Users only (They must have to be logged in). |
Target Roles | Make this field available only for the users that have the selected roles. Available to all, if you haven’t selected any |
Editable | Make this field’s value editable on Cart Page – (incase If user has chosed the wrong value, he can correct it on the cart page itself, no need to go back to product page). Note: this is only for the Cart page not for the Checkout Page. |
Cloneable | Exclude this field from cloning (Works only if Cloning option is enabled from the Settings Page). |
Field Class | Use this option to add a custom css class to this field for your own styling purpose (added to each check boxes). |
Onload | This option controls the fields visibility when the product is loaded. By default Yes |
Product Field’s Raw Output
<table class="wccpf_fields_table "> <tbody> <tr> <!-- Label section starts here --> <td class="wccpf_label"> <label for="test_check_field">Test Check Field</label> </td> <!-- Label section ends here --> <!-- Field section starts here --> <td class="wccpf_value"> <!-- Actual field --> <ul class="wccpf-field-layout-horizontal" data-cloneable="yes"> <li> <label class="wcff-option-wrapper-label"><input type="checkbox" class="wccpf-field " name="test_check_field[]" value="red" wccpf-type="checkbox" wccpf-pattern="mandatory" wccpf-mandatory="no"> Red</label> </li> <li> <label class="wcff-option-wrapper-label"><input type="checkbox" class="wccpf-field " name="test_check_field[]" value="blue" checked="" wccpf-type="checkbox" wccpf-pattern="mandatory" wccpf-mandatory="no"> Blue</label> </li> </ul> <!-- Validation message --> <span class="wccpf-validation-message">Test product checkbox validation message</span> </td> <!-- Field section ends here --> </tr> </tbody> </table>
Checkbox Field for Admin
Checkbox field can be added for woocommerce admin products, variations & product categories. To give store admin, the ability to add more configurations for the product. This fields can also be enabled to show on front end product page as well. The value can be retrieved like any other post meta, using get_post_meta()
function.
Checkbox Field Configurations for Admin
Checkbox Field for Admin has all the properties as Product & Variation except Onload
property which is specifically for Field Rules functionality. besides that Checkbox Field for Admin has some additional properties.
Option | Description |
---|---|
Show on Product Page | Show this field on Front end Product page as well. |
Read Only | Whether to show this field as Read Only Field (applicable only on Front End Product Page). |
Value or Field | Show the value that is chosen on this Admin Field instead as the Field itself. Whatever the option, Store Admin chosen for this field on the back end will be displayed on the Front end Product Page. |
Tips | Whether to show the tip icon in the back end. |
Description | Tool-tip message, when admin user click on the Tips Icon. |
Admin Field’s Raw Output (on Product Page)
<p class="form-field"> <!-- Label for the Check Box Group --> <label for="test_admin_check">Test Admin Check</label> <!-- Individual options starts here --> <label class="wcff-option-wrapper-label"><input type="checkbox" class="wccaf-field " name="test_admin_check[]" value="red" wccaf-type="checkbox" wccaf-pattern="mandatory" wccaf-mandatory="no"> Red</label> <label class="wcff-option-wrapper-label"><input type="checkbox" class="wccaf-field " name="test_admin_check[]" value="blue" wccaf-type="checkbox" wccaf-pattern="mandatory" wccaf-mandatory="no"> Blue</label> <!-- Individual options ends here --> <!-- Validation message --> <span class="wccaf-validation-message">This field can't be Empty</span> </p>
Admin Field’s Raw Output (on Product Category Create Page)
<div class="form-field"> <!-- Label for the Check Box Group --> <label for="test_admin_check">Test Admin Check</label> <!-- Individual options starts here --> <label class="wcff-option-wrapper-label"><input type="checkbox" class="wccaf-field " name="test_admin_check[]" value="red" wccaf-type="checkbox" wccaf-pattern="mandatory" wccaf-mandatory="no"> Red</label> <label class="wcff-option-wrapper-label"><input type="checkbox" class="wccaf-field " name="test_admin_check[]" value="blue" wccaf-type="checkbox" wccaf-pattern="mandatory" wccaf-mandatory="no"> Blue</label> <!-- Individual options ends here --> <!-- Validation message --> <span class="wccaf-validation-message">This field can't be Empty</span> </div>
Admin Field’s Raw Output (on Product Category Edit Page)
<tr class="form-field"> <!-- Admin Edit Category field's label starts here --> <th scope="row" valign="top"> <label for="test_admin_check">Test Admin Check</label> </th> <!-- Admin Edit Category field's label ends here --> <td> <!-- Individual options starts here --> <label class="wcff-option-wrapper-label"><input type="checkbox" class="wccaf-field " name="test_admin_check[]" value="red" wccaf-type="checkbox" wccaf-pattern="mandatory" wccaf-mandatory="no"> Red</label> <label class="wcff-option-wrapper-label"><input type="checkbox" class="wccaf-field " name="test_admin_check[]" value="blue" wccaf-type="checkbox" wccaf-pattern="mandatory" wccaf-mandatory="no"> Blue</label> <!-- Individual options ends here --> <!-- Validation message --> <span class="wccaf-validation-message">This field can't be Empty</span> </td> </tr>