add-affiliate-to-group.php
5 months ago
create-affiliate-group.php
5 months ago
create-affiliate.php
5 months ago
create-referral.php
5 months ago
delete-affiliate-group.php
5 months ago
get-affiliate-group.php
5 months ago
get-affiliate.php
5 months ago
remove-affiliate-from-group.php
5 months ago
update-affiliate-group.php
5 months ago
update-affiliate-status.php
5 months ago
create-referral.php
209 lines
| 1 | <?php |
| 2 | /** |
| 3 | * CreateReferral. |
| 4 | * php version 5.6 |
| 5 | * |
| 6 | * @category CreateReferral |
| 7 | * @package SureTriggers |
| 8 | * @author BSF <username@example.com> |
| 9 | * @license https://www.gnu.org/licenses/gpl-3.0.html GPLv3 |
| 10 | * @link https://www.brainstormforce.com/ |
| 11 | * @since 1.0.0 |
| 12 | */ |
| 13 | |
| 14 | namespace SureTriggers\Integrations\FluentAffiliate\Actions; |
| 15 | |
| 16 | use Exception; |
| 17 | use SureTriggers\Integrations\AutomateAction; |
| 18 | use SureTriggers\Traits\SingletonLoader; |
| 19 | |
| 20 | /** |
| 21 | * CreateReferral |
| 22 | * |
| 23 | * @category CreateReferral |
| 24 | * @package SureTriggers |
| 25 | * @author BSF <username@example.com> |
| 26 | * @license https://www.gnu.org/licenses/gpl-3.0.html GPLv3 |
| 27 | * @link https://www.brainstormforce.com/ |
| 28 | * @since 1.0.0 |
| 29 | */ |
| 30 | class CreateReferral extends AutomateAction { |
| 31 | |
| 32 | /** |
| 33 | * Integration type. |
| 34 | * |
| 35 | * @var string |
| 36 | */ |
| 37 | public $integration = 'FluentAffiliate'; |
| 38 | |
| 39 | /** |
| 40 | * Action name. |
| 41 | * |
| 42 | * @var string |
| 43 | */ |
| 44 | public $action = 'fluentaffiliate_create_referral'; |
| 45 | |
| 46 | use SingletonLoader; |
| 47 | |
| 48 | /** |
| 49 | * Register a action. |
| 50 | * |
| 51 | * @param array $actions actions. |
| 52 | * @return array |
| 53 | */ |
| 54 | public function register( $actions ) { |
| 55 | |
| 56 | $actions[ $this->integration ][ $this->action ] = [ |
| 57 | 'label' => __( 'Create Referral', 'suretriggers' ), |
| 58 | 'action' => $this->action, |
| 59 | 'function' => [ $this, 'action_listener' ], |
| 60 | ]; |
| 61 | return $actions; |
| 62 | } |
| 63 | |
| 64 | /** |
| 65 | * Action listener. |
| 66 | * |
| 67 | * @param int $user_id user_id. |
| 68 | * @param int $automation_id automation_id. |
| 69 | * @param array $fields fields. |
| 70 | * @param array $selected_options selectedOptions. |
| 71 | * @return array|void |
| 72 | * @throws Exception Exception. |
| 73 | */ |
| 74 | public function _action_listener( $user_id, $automation_id, $fields, $selected_options ) { |
| 75 | |
| 76 | // Check if FluentAffiliate models exist. |
| 77 | if ( ! class_exists( 'FluentAffiliate\App\Models\Referral' ) || ! class_exists( 'FluentAffiliate\App\Models\Affiliate' ) ) { |
| 78 | return [ |
| 79 | 'status' => 'error', |
| 80 | 'message' => __( 'FluentAffiliate plugin is not installed or activated.', 'suretriggers' ), |
| 81 | ]; |
| 82 | } |
| 83 | |
| 84 | // Extract selected options. |
| 85 | $affiliate_id = isset( $selected_options['affiliate_id'] ) ? absint( $selected_options['affiliate_id'] ) : 0; |
| 86 | $amount = isset( $selected_options['amount'] ) ? sanitize_text_field( $selected_options['amount'] ) : ''; |
| 87 | $description = isset( $selected_options['description'] ) ? sanitize_text_field( $selected_options['description'] ) : ''; |
| 88 | $status = ! empty( $selected_options['status'] ) ? sanitize_text_field( $selected_options['status'] ) : 'unpaid'; |
| 89 | $type = ! empty( $selected_options['type'] ) ? sanitize_text_field( $selected_options['type'] ) : 'sale'; |
| 90 | |
| 91 | $affiliate = null; |
| 92 | |
| 93 | // Try to get affiliate by affiliate ID first. |
| 94 | if ( ! empty( $affiliate_id ) ) { |
| 95 | $affiliate = \FluentAffiliate\App\Models\Affiliate::find( $affiliate_id ); |
| 96 | } |
| 97 | |
| 98 | // Validate affiliate found. |
| 99 | if ( ! $affiliate ) { |
| 100 | return [ |
| 101 | 'status' => 'error', |
| 102 | 'message' => __( 'Affiliate not found.', 'suretriggers' ), |
| 103 | ]; |
| 104 | } |
| 105 | |
| 106 | // Validate affiliate is active. |
| 107 | if ( 'active' !== $affiliate->status ) { |
| 108 | return [ |
| 109 | 'status' => 'error', |
| 110 | 'message' => __( 'Cannot create a referral for an inactive affiliate.', 'suretriggers' ), |
| 111 | ]; |
| 112 | } |
| 113 | |
| 114 | // Validate required fields. |
| 115 | if ( empty( $amount ) ) { |
| 116 | return [ |
| 117 | 'status' => 'error', |
| 118 | 'message' => __( 'Amount is required.', 'suretriggers' ), |
| 119 | ]; |
| 120 | } |
| 121 | |
| 122 | // Validate status. |
| 123 | $allowed_statuses = [ 'unpaid', 'rejected', 'pending' ]; |
| 124 | if ( ! in_array( $status, $allowed_statuses, true ) ) { |
| 125 | return [ |
| 126 | 'status' => 'error', |
| 127 | 'message' => sprintf( __( 'Invalid status. Allowed values: %s', 'suretriggers' ), implode( ', ', $allowed_statuses ) ), |
| 128 | ]; |
| 129 | } |
| 130 | |
| 131 | // Validate type. |
| 132 | $allowed_types = [ 'sale', 'opt_in' ]; |
| 133 | if ( ! in_array( $type, $allowed_types, true ) ) { |
| 134 | return [ |
| 135 | 'status' => 'error', |
| 136 | 'message' => sprintf( __( 'Invalid type. Allowed values: %s', 'suretriggers' ), implode( ', ', $allowed_types ) ), |
| 137 | ]; |
| 138 | } |
| 139 | |
| 140 | // Create referral. |
| 141 | try { |
| 142 | $referral_data = [ |
| 143 | 'affiliate_id' => $affiliate->id, |
| 144 | 'description' => $description, |
| 145 | 'amount' => ( (int) ( (float) $amount * 100 ) ) / 100, |
| 146 | 'status' => $status, |
| 147 | 'type' => $type, |
| 148 | ]; |
| 149 | |
| 150 | $referral = \FluentAffiliate\App\Models\Referral::create( $referral_data ); |
| 151 | |
| 152 | if ( ! $referral ) { |
| 153 | return [ |
| 154 | 'status' => 'error', |
| 155 | 'message' => __( 'Failed to create referral.', 'suretriggers' ), |
| 156 | ]; |
| 157 | } |
| 158 | |
| 159 | // Fire creating event. |
| 160 | do_action( 'fluent_affiliate/referral_marked_unpaid', $referral ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores |
| 161 | |
| 162 | // Recount affiliate earnings. |
| 163 | $affiliate->recountEarnings(); |
| 164 | |
| 165 | // Get WordPress user context. |
| 166 | $user_data = []; |
| 167 | if ( isset( $affiliate->user_id ) ) { |
| 168 | $wp_user = get_user_by( 'ID', $affiliate->user_id ); |
| 169 | if ( false !== $wp_user ) { |
| 170 | $user_data = [ |
| 171 | 'user_id' => $wp_user->ID, |
| 172 | 'user_login' => $wp_user->user_login, |
| 173 | 'user_email' => $wp_user->user_email, |
| 174 | 'first_name' => $wp_user->first_name, |
| 175 | 'last_name' => $wp_user->last_name, |
| 176 | 'display_name' => $wp_user->display_name, |
| 177 | ]; |
| 178 | } |
| 179 | } |
| 180 | |
| 181 | // Prepare response data. |
| 182 | $context = array_merge( |
| 183 | $user_data, |
| 184 | [ |
| 185 | 'referral_id' => isset( $referral->id ) ? $referral->id : '', |
| 186 | 'affiliate_id' => isset( $referral->affiliate_id ) ? $referral->affiliate_id : '', |
| 187 | 'amount' => isset( $referral->amount ) ? $referral->amount : 0, |
| 188 | 'description' => isset( $referral->description ) ? $referral->description : '', |
| 189 | 'referral_status' => isset( $referral->status ) ? $referral->status : '', |
| 190 | 'type' => isset( $referral->type ) ? $referral->type : '', |
| 191 | 'created_at' => isset( $referral->created_at ) ? $referral->created_at : '', |
| 192 | 'status' => 'success', |
| 193 | ] |
| 194 | ); |
| 195 | |
| 196 | return $context; |
| 197 | |
| 198 | } catch ( \Exception $e ) { |
| 199 | return [ |
| 200 | 'status' => 'error', |
| 201 | 'message' => sprintf( __( 'Error creating referral: %s', 'suretriggers' ), $e->getMessage() ), |
| 202 | ]; |
| 203 | } |
| 204 | } |
| 205 | |
| 206 | } |
| 207 | |
| 208 | CreateReferral::get_instance(); |
| 209 |