Before starting it is also essential to define what a hook is. In the WordPress<\/a> ecosystem, a hook<\/a> is a means of modifying and\/or interacting with another code at a specific time. There are two types of hooks: actions<\/a> that allow you to add data or modify the way WordPress works; and filters<\/a> that allow you to modify the data (variables) of specific functions.<\/p>\n The Conditional Discounts for WooCommerce plugin contains several hooks which you can add to, or manipulate, to create your own discounts. We are going to study them (filters in this case) in the following order:<\/p>\n <\/p>\n <\/p>\n We can add our own operators. The format for creating an operator is simple and is as follows:<\/p>\n [php] [\/php]<\/p>\n We create an associative array in which we put the key of our operator and the value that will be displayed for this operator. An application of the previous rule will give the following:<\/p>\n [php] [\/php]<\/p>\n [php] [\/php]<\/p>\n So we can create our own operators by following the same rule thanks to the \u201cwad_operators_fields_match<\/strong>\u201d filter. In the application example (the second part of this document) a complete use of the filter was made and demonstrated.<\/p>\n Another simple example, the \u201cif customer role in\u201d rule is associated with a field which contains a dropdown containing the list of existing roles on WordPress. The following image illustrates the example:<\/p>\n 1<\/span>: We have added the condition ‘if customer role’ thanks to the ‘wad_get_discounts_conditions’ filter. We are going to create a discount which lets us reduce the price for a user based on whether he already benefited from certain discounts, which we will define in a list.<\/p>\n [php] [\/php]<\/p>\n Then we add the callback function linked to this filter:<\/p>\n [php]<\/p>\n \/ ** [\/php]<\/p>\n By so doing, we have added our \u201chas-discount\u201d discount to the list of rules.<\/li>\n [php] [\/php]<\/p>\n Then we call the callback function linked to the filter:<\/p>\n [php]<\/p>\n \/ ** $arr[‘has-discount’] = $discount_get_select; \/ ** [\/php]<\/li>\n [\/php]<\/p>\n Then<\/p>\n [php]<\/p>\n \/ ** [\/php]<\/p>\n Then<\/p>\n [php] if ( ‘has-discount’ === $rule[‘condition’]) {<\/p>\n $intersection = array_intersect( $rule[‘value’], $condition ); \/ ** \/\/ get a discount that user have benefitted. In reference to the example scenario mentioned earlier in this tutorial, we have been able to achieve the equation: A = B. Introduction The purpose of this developer guide for addons is to show how to add your own discount to the Conditional Discounts for WooCommerce plugin. It is important to understand the use or operation of the Conditional Discounts for WooCommerce plugin before reading and practicalizing this documentation. Before starting it is also essential to define […]<\/p>\n","protected":false},"author":1,"featured_media":149499,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_themeisle_gutenberg_block_has_review":false,"footnotes":""},"categories":[448],"tags":[258,183,259,36],"class_list":["post-38677","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-best-practices","tag-addon-developer-guide","tag-conditional-discounts-for-woocommerce","tag-developer","tag-woocommerce"],"acf":[],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.orionorigin.com\/service\/wp\/v2\/posts\/38677","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.orionorigin.com\/service\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.orionorigin.com\/service\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.orionorigin.com\/service\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.orionorigin.com\/service\/wp\/v2\/comments?post=38677"}],"version-history":[{"count":1,"href":"https:\/\/www.orionorigin.com\/service\/wp\/v2\/posts\/38677\/revisions"}],"predecessor-version":[{"id":134471,"href":"https:\/\/www.orionorigin.com\/service\/wp\/v2\/posts\/38677\/revisions\/134471"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.orionorigin.com\/service\/wp\/v2\/media\/149499"}],"wp:attachment":[{"href":"https:\/\/www.orionorigin.com\/service\/wp\/v2\/media?parent=38677"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.orionorigin.com\/service\/wp\/v2\/categories?post=38677"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.orionorigin.com\/service\/wp\/v2\/tags?post=38677"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
\n
\nFor example, to verify that a condition belongs to a predefined list we use the operators \u201cIN\u201d and \u201cNOT IN\u201d. In the case of a numerical comparison, we expect the use of operators like superior (>), superior or equal (> =), inferior or equal (<=), inferior or (<), equal ( =) …
\nThese are the default operators of our Conditional Discounts for WooCommerce plugin.<\/li>\n<\/ol>\nHow to add Operators<\/h2>\n
\n$arrays_operators = array(
\n‘KEY1′ =>’VALUE SHOW1’,
\n‘KEY2′ =>’VALUE SHOW2’,
\n);<\/p>\nExample 1:<\/h4>\n
\n$arrays_operators = array(
\n‘IN’ => __( ‘IN’, ‘wad’ ),
\n‘NOT IN’ => __( ‘NOT IN’, ‘wad’ ),
\n);<\/p>\nExample 2:<\/h4>\n
\n$number_operators = array(
\n‘<‘ => __( ‘is less than’, ‘wad’ ),
\n‘<=’ => __( ‘is less or equal to’, ‘wad’ ),
\n‘==’ => __( ‘equals’, ‘wad’ ),
\n‘>’ => __( ‘is more than’, ‘wad’ ),
\n‘> =’ => __( ‘is more or equal to’, ‘wad’ ),
\n‘%’ => __( ‘is a multiple of’, ‘wad’ ),
\n);<\/p>\n![\"Developer](\"https:\/\/www.orionorigin.com\/wp-content\/uploads\/2020\/06\/wad-98-dev-addon-tut-03.png\" "\\"\\"")
\n2<\/span>: We added the type of operator that we want to use, it is ‘IN’ and ‘NOT IN’ thanks to the ‘wad_operators_fields_match’ filter.
\n3<\/span>: These are the values \u200b\u200bthat will be associated with our condition, we added them using the ‘wad_fields_values_match’ filter.<\/p>\n\n
Application<\/h2>\n
Steps<\/h3>\n
\n
\nFirst, we add the filter:<\/p>\n
\nadd_filter( ‘wad_get_discounts_conditions’, ‘add_my_custom_condition’, 10 );<\/p>\n
\n* This function allows us to add our condition.
\n*
\n* @param type $ arrays contains all conditions.
\n* @return type
\n* \/
\nfunction add_my_custom_condition( $arrays ) {
\n$arrays[‘has-discount’] = __( ‘If Customer has benefited a discount’, ‘wad’ );
\nreturn $arrays;
\n}<\/p>\n
\nFirst, we call the filter:<\/p>\n
\nadd_filter(‘wad_fields_values_match’, ‘add_available_option_for_my_custom_condition’, 10, 3);<\/p>\n
\n* This function adds the options that are available for our condition.
\n* @param array $ arr contains all available options for each condition.
\n* @param type $ condition contains the condition (or the designation of the discount).
\n* @param type $ selected_value contains options that have been selected for the condition ???.
\n* @return type
\n* \/
\nfunction add_available_option_for_my_custom_condition( $arr, $condition, $selected_value ) {
\n$field_name = ‘o-discount [rules] [{rule-group}] [{rule-index}] [value]’;\/\/ the value of the name attribute of the select field
\n$discounts_title = wad_get_all_discounts_post_title();
\n$discount_get_select = get_wad_html_select( $field_name . ‘[]’, false, ”, $discounts_title, $selected_value, true );\/\/ get_wad_html_select allows you to create a select type field with the parameters given to it; the square brackets ([]) mean that it is a multiple field, if they are not put then a single field will be rendered.<\/p>\n
\nreturn $arr;
\n}<\/p>\n
\n* This function return all discounts title
\n* @return array
\n* \/
\nfunction wad_get_all_discounts_post_title() {
\n$all_discounts = wad_get_all_discounts();\/\/ we retrieve all discounts. it is a wad’s function.
\n$discounts_title = array();
\nforeach ( $all_discounts as $key => $value ) {
\n$discounts_title[ $value->ID ] = $value->post_title;
\n}
\nreturn $discounts_title;
\n}<\/p>\n
\n add_filter(‘wad_operators_fields_match’, ‘add_comparison_operators_for_my_custom_condition’, 10, 3);<\/p>\n
\n* This function allows us to associate comparison operators to our condition.
\n*
\n* @param type $ arrays contains the operators associated with each condition.
\n* @param type $ condition contains the condition (or the designation of the discount).
\n* @param type $ selected_value contains the operator currently active.
\n* @return type
\n* \/
\nfunction add_comparison_operators_for_my_custom_condition( $arrays, $condition, $selected_value ) {
\n$field_name = ‘o-discount [rules] [{rule-group}] [{rule-index}] [operator]’;
\n$arrays_operators = array(
\n‘IN’ => __( ‘IN’, ‘wad’ ),
\n‘NOT IN’ => __( ‘NOT IN’, ‘wad’ ),
\n);
\n$arrays_operators_select = get_wad_html_select( $field_name, false, ”, $arrays_operators, $selected_value );\/\/ get_wad_html_select allows you to create a select type field with the parameters given to it. it’s wad’s function.
\n$arrays[‘has-discount’] = $arrays_operators_select;
\nreturn $arrays;
\n}
\n[\/php]<\/li>\n
\nadd_filter(‘wad_is_rule_valid’, ‘is_rule_valid’, 10, 2);<\/p>\n
\n\/ **
\n* Description
\n*
\n* @param type $ is_valid after having compared the rules defined in the dashboard and the evaluable condition this boolean allows to say if the rule is valid or not.
\n* @param type $ rule comment contains the rules defined in the dashboard.
\n* @return type
\n* \/
\nfunction is_rule_valid( $is_valid, $rule ) {
\n$condition = get_all_discounts_customer_has_benefited(); \/\/ we recover the discounts from which the customer has benefited and we compare it to the rules defined in the dashboard according to the operators.<\/p>\n
\nif (( ‘NOT IN’ == $rule[‘operator’] && $rule[‘value’]! == $intersection ) ||
\n( ‘IN’ === $rule[‘operator’] && $rule[‘value’] === $intersection )) {
\n$is_valid = true;
\n}
\n}
\nreturn $is_valid;
\n}<\/p>\n
\n* This function recovers all the reductions from which the client has benefited, this will be the evaluable condition that will be used in is_rule_valid function to evaluate our discount.
\n*
\n* @return array
\n* \/
\nfunction get_all_discounts_customer_has_benefited() {
\n\/\/ Get all customer orders.
\n$customer_orders = get_posts(
\narray(
\n‘numberposts’ => -1,
\n‘meta_key’ => ‘_customer_user’,
\n‘orderby’ => ‘date’,
\n‘order’ => ‘DESC’,
\n‘meta_value’ => get_current_user_id(),
\n‘post_type’ => wc_get_order_types(),
\n‘post_status’ => array_keys( wc_get_order_statuses()),
\n‘post_status’ => array( ‘wc-processing’ ),
\n)
\n);<\/p>\n
\n$customer_discount_id = array();
\nforeach ( $customer_orders as $customer_order ) {
\n$order_data = wc_get_order( $customer_order );\/\/ we get the data on each customer’s order.
\n$customer_discount_id[] = get_post_meta( $order_data->get_id(), $key = ‘wad_used_discount’, true );\/\/ get discount that customer has benefited id.
\n}
\nreturn $customer_discount_id;
\n}
\n[\/php]<\/p>\n
\nIn this context, the function allows us to recover B (all the discounts from which the user has benefited) via the \u2018get_my_evaluable_condition\u2019 function, and A (the condition established in the dashboard by the administrator) via the \u2018is_rule_valid\u2019 function using the \u2018$rule\u2019 parameter.
\nGot any questions about this developer guide for addons to our Conditional Discounts for WooCommerce<\/a> plugin? Please reach out to us via Chat!<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"