conditional-logic-for-woo-product-add-ons
Last commit date
assets
3 years ago
freemius
3 years ago
languages
3 years ago
src
3 years ago
vendor
3 years ago
views
3 years ago
changelog.txt
3 years ago
conditional-logic-for-product-addons.php
3 years ago
index.php
3 years ago
license.php
3 years ago
readme.txt
3 years ago
readme.txt
87 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.2 |
| 6 | Requires PHP: 7.0 |
| 7 | Stable tag: 1.1.0 |
| 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) |
| 12 | |
| 13 | |
| 14 | == Description == |
| 15 | 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. |
| 16 | |
| 17 | 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. |
| 18 | Types of conditions depend on the kind of field you use as the condition. |
| 19 | |
| 20 | **Multiple choice and Checkboxes** types can be conditioned as: |
| 21 | Is checked - when the customer selects the needed option |
| 22 | Is not checked - when the customer selects or checks anything besides the specified option |
| 23 | |
| 24 | **Short Text and Long Text** have the following condition types: |
| 25 | Is - text entered by a customer fully complies with your value |
| 26 | Is not - text entered by a customer is not the same as your value |
| 27 | Is empty - the customer does not enter any text |
| 28 | Is not empty - the customer enters any text |
| 29 | Text contains - text entered by the customer contains something specific anywhere in the text |
| 30 | Text does not contain - text entered by the customer does not contain what you specified anywhere in the text |
| 31 | Text starts with - text entered by the customer starts with anything specific |
| 32 | Text ends with - text entered by the customer ends with anything specific |
| 33 | |
| 34 | **File upload** field type may have the following logic: |
| 35 | Is selected - if the customer has chosen a file to upload |
| 36 | Is not selected - if the customer has not chosen a file to upload yet |
| 37 | |
| 38 | **Customer Defined Price and Quantity** are numeric types of fields, and their conditions may be: |
| 39 | Is - price entered by customer or selected quantity is equal to your value |
| 40 | Is not - price entered by customer or quantity is anything besides the value you set |
| 41 | Is greater than - price entered by customer or quantity is greater than the value |
| 42 | Is less than - price entered by customer or quantity is less than the value |
| 43 | Is greater than or equal - price entered by customer or quantity is greater than or equal to the value |
| 44 | Is less than or equal - price entered by customer or quantity is less than or equal to the value |
| 45 | |
| 46 | Those conditions are available to you in the general add-ons section as well as on the product level. |
| 47 | |
| 48 | Note: you should have **[WooCommerce Product Add-Ons plugin](https://woocommerce.com/products/product-add-ons/)** installed and configured. |
| 49 | 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)** |
| 50 | |
| 51 | == Installation == |
| 52 | 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. |
| 53 | 2. Activate the plugin through the \'Plugins\' screen in WordPress |
| 54 | 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 |
| 55 | 5. Click on the 'Conditional logic' checkbox in the field for each you want to add conditions |
| 56 | |
| 57 | == Frequently Asked Questions == |
| 58 | |
| 59 | = What addons plugins can be used along with this conditional logic? = |
| 60 | 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. |
| 61 | |
| 62 | = Is there any type of field conditional logic cannot be applied to? = |
| 63 | 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. |
| 64 | |
| 65 | = Are there any limits to the number of conditions set to one field? = |
| 66 | Yep, in comunnity version it's limited to one condition. In premium version you can add as many conditions as you need. |
| 67 | |
| 68 | = When trying to add the conditional logic, I see an error saying Please update (re-save) the post to set up conditional logic = |
| 69 | 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. |
| 70 | |
| 71 | == Screenshots == |
| 72 | 1. How conditional fields work on product page |
| 73 | 2. How to add Conditional logic to add-ons field |
| 74 | 3. Dependencies for fields used as conditions |
| 75 | 4. Two types - if all rules match or any (when condition works) |
| 76 | 5. Condition types for Multiple choice and Checkboxes types of field |
| 77 | 6. Condition types (relations) for text fields |
| 78 | 7. Condition types for File upload type of field |
| 79 | 8. Condition types for numeric types of fields |
| 80 | |
| 81 | == Changelog == |
| 82 | 2023-04-20 - version 1.1.0 |
| 83 | * WooCommerce Product Add-ons 6x version compatibility |
| 84 | * Minor UI improvements |
| 85 | |
| 86 | 2023-01-10 - version 1.0.0 |
| 87 | * Initial release |