conditional-logic-for-woo-product-add-ons
Last commit date
assets
1 year ago
freemius
1 year ago
languages
1 year ago
src
1 year ago
vendor
1 year ago
views
1 year ago
conditional-logic-for-product-addons.php
1 year ago
index.php
1 year ago
license.php
1 year ago
readme.txt
1 year ago
readme.txt
148 lines
| 1 | === Conditional Logic for Woo Product Add-ons === |
| 2 | Contributors: meowcrew, freemius |
| 3 | Tags: Woocommerce Product Addons, product add-ons, woocommerce product options, woocommerce, WooCommerce product fields |
| 4 | Requires at least: 4.2 |
| 5 | Tested up to: 6.7.0 |
| 6 | Requires PHP: 7.2 |
| 7 | Stable tag: 2.1.6 |
| 8 | License: GNU General Public License v2 |
| 9 | License URI: https://www.gnu.org/licenses/license-list.html#GPLCompatibleLicenses |
| 10 | |
| 11 | Show or hide certain fields of the WooCommerce Product Addons based on other fields' values or states (eg, show field X when option Y is selected) or based on selected variations |
| 12 | |
| 13 | == Description == |
| 14 | Conditional Logic for WooCommerce Product Add-Ons is an extension to the official **[WooCommerce Product Add-Ons plugin](https://woocommerce.com/products/product-add-ons/)**. With the help of this extension, you can set up conditional logic for Add-ons fields to either show or hide them based on what the user chooses, write or upload in other fields. Also you can determine to display add-ons fields only for specific product variations. |
| 15 | |
| 16 | [youtube https://youtu.be/R6_Fj8WUDBs] |
| 17 | |
| 18 | Important links: |
| 19 | **[Premium Version Page](https://meow-crew.com/plugin/conditional-logic-for-product-add-ons)** | **[Demo for Plugin Testing](http://conditional.meow-crew.com/demo/)** | **[Plugin Documentation](https://meow-crew.com/documentation/conditional-logic-for-woocommerce-product-add-ons-documentation)** |
| 20 | |
| 21 | Conditional Logic is designed to work with any field of Product Add-ons, and each field can have its own rules. Fields for which you set conditions can be shown or hidden if Any or All requirements are met. Conditions - set of rules of what the user (your customer) should choose, write or define in other fields. Let's say you offer two types of Gift Wrap options (Free and paid), and you'd like to offer an 'Add a message' service to the Paid option only - then you set the 'Short text' field to be visible only when the customer chose the Paid option. |
| 22 | In the Premium version of the plugin you can also add conditions to **show Product Add-ons field only when user select specific Product Variation**. This feature can work alone or you can combine it with another conditions based on other add-ons fields output. |
| 23 | |
| 24 | Types of conditions depend on the kind of field you use as the condition. |
| 25 | |
| 26 | **Multiple choice and Checkboxes** types can be conditioned as: |
| 27 | Is checked - when the customer selects the needed option |
| 28 | Is not checked - when the customer selects or checks anything besides the specified option |
| 29 | |
| 30 | **Short Text and Long Text** have the following condition types: |
| 31 | Is - text entered by a customer fully complies with your value |
| 32 | Is not - text entered by a customer is not the same as your value |
| 33 | Is empty - the customer does not enter any text |
| 34 | Is not empty - the customer enters any text |
| 35 | Text contains - text entered by the customer contains something specific anywhere in the text |
| 36 | Text does not contain - text entered by the customer does not contain what you specified anywhere in the text |
| 37 | Text starts with - text entered by the customer starts with anything specific |
| 38 | Text ends with - text entered by the customer ends with anything specific |
| 39 | |
| 40 | **File upload** field type may have the following logic: |
| 41 | Is selected - if the customer has chosen a file to upload |
| 42 | Is not selected - if the customer has not chosen a file to upload yet |
| 43 | |
| 44 | **Customer Defined Price and Quantity** are numeric types of fields, and their conditions may be: |
| 45 | Is - price entered by customer or selected quantity is equal to your value |
| 46 | Is not - price entered by customer or quantity is anything besides the value you set |
| 47 | Is greater than - price entered by customer or quantity is greater than the value |
| 48 | Is less than - price entered by customer or quantity is less than the value |
| 49 | Is greater than or equal - price entered by customer or quantity is greater than or equal to the value |
| 50 | Is less than or equal - price entered by customer or quantity is less than or equal to the value |
| 51 | |
| 52 | Those conditions are available to you in the general add-ons section as well as on the product level. |
| 53 | |
| 54 | Note: you should have **[WooCommerce Product Add-Ons plugin](https://woocommerce.com/products/product-add-ons/)** installed and configured. |
| 55 | You can find detailed instructions on how to hide and show WooCommerce Product Add-On options here in **[plugin's documentation](https://meow-crew.com/documentation/conditional-logic-for-woocommerce-product-add-ons-documentation)** |
| 56 | |
| 57 | == Installation == |
| 58 | 1. Upload the plugin files to the \'/wp-content/plugins/conditional-logic-for-woo-product-add-ons\' directory, or install the plugin through the WordPress plugins screen directly. |
| 59 | 2. Activate the plugin through the \'Plugins\' screen in WordPress |
| 60 | 3. To design conditionals to your Add-ons' fields, go to products with addons (if you have them separately for each product) or to Products > Add-ons > choose Add-ons Group |
| 61 | 5. Click on the 'Conditional logic' checkbox in the field for each you want to add conditions |
| 62 | |
| 63 | == Frequently Asked Questions == |
| 64 | |
| 65 | = What addons plugins can be used along with this conditional logic? = |
| 66 | The Conditional Logic for WooCommerce Product Add-ons is designed to work only with official Product Add-ons. You won't be able to set up conditional logic without that plugin and with any other plugin of that type. |
| 67 | |
| 68 | = How to show product add-ons field only when specific variant (e.g. red cap for red hoodie) is selected? |
| 69 | When you enable Conditional Logic for field, you will find Variations section. If you leave it empty - this field will be shown for every product variation. If you need to show the field only for specific variations - click on the field and select variations of the product, for which it will be displayed. |
| 70 | |
| 71 | = Is there any type of field conditional logic cannot be applied to? = |
| 72 | Conditional logic can be applied to any default Product Add-ons field. As well as, all of the fields and their options can be used as conditionals. |
| 73 | |
| 74 | = Are there any limits to the number of conditions set to one field? = |
| 75 | Yep, in community version it's limited to one condition. In premium version you can add as many conditions as you need. |
| 76 | |
| 77 | = When trying to add the conditional logic, I see an error saying Please update (re-save) the post to set up conditional logic = |
| 78 | That means you have not yet updated the add-on or product. Conditions need to assign a special slug to each field and its options, and that happens only when you update the add-on or product after installing the plugin. |
| 79 | |
| 80 | == Screenshots == |
| 81 | 1. How conditional fields work on product page |
| 82 | 2. Premium feature: display field based on selected variant |
| 83 | 3. How to add Conditional logic to add-ons field |
| 84 | 4. Premium feature: show Product Add-ons fields only when specific variation selected |
| 85 | 5. Dependencies for fields used as conditions |
| 86 | 6. Two types - if all rules match or any (when condition works) |
| 87 | 7. Condition types for Multiple choice and Checkboxes types of field |
| 88 | 8. Condition types (relations) for text fields |
| 89 | 9. Condition types for File upload type of field |
| 90 | 10. Condition types for numeric types of fields |
| 91 | |
| 92 | == Changelog == |
| 93 | |
| 94 | 2024-11-01 – version 2.1.6 |
| 95 | * Updated: Freemius version 2.9.0 |
| 96 | |
| 97 | 2024-10-10 – version 2.1.5 |
| 98 | * New: Bundle products compatibility |
| 99 | * Fix: UI fixes |
| 100 | * Updated: Woo 9.3 version compatibility |
| 101 | * Updated: Woo Product Add-ons 7.1 version compatibility |
| 102 | |
| 103 | 2024-08-30 – version 2.1.4 |
| 104 | * New: Composite products compatibility |
| 105 | * Fix: str_replace() deprecated warning |
| 106 | * Fix: UI fixes |
| 107 | * Fix: Variations list for current product in the conditions by variations |
| 108 | * Updated: Woo 9.2 version compatibility |
| 109 | * Updated: Woo Product Add-ons 7.0 version compatibility |
| 110 | |
| 111 | 2024-06-03 - version 2.1.3 |
| 112 | * Fix: Fatal error when previewing block themes |
| 113 | * Updated: Woo 8.9.0 version compatibility |
| 114 | * Updated: Freemius update |
| 115 | |
| 116 | 2024-02-01 - version 2.1.2 |
| 117 | * Fix: Add to cart button action, when required field is hidden under conditions |
| 118 | * Updated: Woo Product Add-ons 6.6 version compatibility |
| 119 | |
| 120 | 2023-12-12 - version 2.1.1 |
| 121 | * Fix: Required field (radio buttons) optional when hidden |
| 122 | * Fix: Not displaying conditional logic fields to global add-ons after adding and re-saving |
| 123 | |
| 124 | 2023-11-16 - version 2.1.0 |
| 125 | * Fix: Make required field (checkbox) optional when hidden |
| 126 | * Fix: Product name for variations with 3 or more attributes |
| 127 | * Updated: Woo Product Add-ons 6.5 version compatibility |
| 128 | * Updated: Woo 8.2.2 version compatibility |
| 129 | * Updated: Woo Cart and Checkout blocks compatibility |
| 130 | * Updated: WordPress 6.4.1 version compatibility |
| 131 | |
| 132 | 2023-07-26 - version 2.0.0 |
| 133 | * New feature: Conditions based on selected product variation |
| 134 | * Updated: WooCommerce Product Add-ons version compatibility |
| 135 | |
| 136 | 2023-07-05 - version 1.2.1 |
| 137 | * Updated Freemius SDK to the latest version |
| 138 | |
| 139 | 2023-06-17 - version 1.2.0 |
| 140 | * New feature: All required fields will stay optional if those fields are hidden |
| 141 | * HPOS compatibility |
| 142 | |
| 143 | 2023-04-20 - version 1.1.0 |
| 144 | * WooCommerce Product Add-ons 6x version compatibility |
| 145 | * Minor UI improvements |
| 146 | |
| 147 | 2023-01-10 - version 1.0.0 |
| 148 | * Initial release |