# better-payment/2.4.0/includes/Classes/ProSubscriptionTransactionData.php Better Payment – Instant Payments, Donations, Fundraising with Subscriptions & More, version 2.4.0. 168 lines. - Page: https://pluginprobe.com/plugins/better-payment/2.4.0/code/includes/Classes/ProSubscriptionTransactionData.php - Raw: https://pluginprobe.com/plugins/better-payment/2.4.0/raw/includes/Classes/ProSubscriptionTransactionData.php - Modified: 2026-09-24T10:14:42+00:00 Line numbers below start at 1. Link to a line or a range by appending a fragment to the page URL, for example `https://pluginprobe.com/plugins/better-payment/2.4.0/code/includes/Classes/ProSubscriptionTransactionData.php#L10-L20`. ```php = 1.4.4. * Pro copy: better-payment-pro/includes/SubscriptionTransactionData.php. * Slug: subscription_transaction_data. * * Only Pro's checkout stores `subscription_*` and `is_payment_split_payment` in a * transaction's `form_fields_info`. Lite still reads those keys in five places, and * each now asks a hook instead: * * | Lite call site | Hook Pro fills | Method here | * | ------------------------------------------------ | ------------------------------------------------ | ---------------------------- | * | `API\UserAPI` Subscriptions tab row | `better_payment/user_api/subscription_row` | subscription_row() | * | `Helper::payment_type_label()` (API + CSV) | `better_payment/transaction/payment_type` | payment_type() | * | `Export::form_fields_info_formatted()` | `better_payment/export/form_fields_info` | export_fields() | * | `Import::build_form_fields()` | `better_payment/import/form_fields_info` | import_fields() | * | `Admin\DB::get_user_transactions_paginated()` | `better_payment/db/user_transactions_type_where` | subscriptions_type_where() | * * Every call site runs the method here only while lite_copy_applies(): an active * Pro that does not declare the slug. A free install never runs it, and a Pro that * declares the slug fills the hook itself. Pro's SubscriptionTransactionDataParityTest * fails when the method bodies here and in Pro drift. * * @since 2.4.0 */ class ProSubscriptionTransactionData { /** * Feature slug Pro declares once it reads the data itself. */ const FEATURE = 'subscription_transaction_data'; /** * Whether Lite's copy runs on this request. * * @return bool */ public static function lite_copy_applies(): bool { return ProCompatibility::lite_copy_applies( self::FEATURE ); } /** * Add the subscription columns to a `/user-transactions?tab=subscriptions` row. * * @param mixed $row REST row built by UserAPI. * @param mixed $form_fields_info The transaction's unserialized form_fields_info. * @return array */ public static function subscription_row( $row, $form_fields_info = [] ): array { $row = is_array( $row ) ? $row : []; $form_fields_info = is_array( $form_fields_info ) ? $form_fields_info : []; $row['subscription_id'] = sanitize_text_field( $form_fields_info['subscription_id'] ?? '' ); $row['subscription_plan_id'] = sanitize_text_field( $form_fields_info['subscription_plan_id'] ?? '' ); $row['subscription_status'] = sanitize_text_field( $form_fields_info['subscription_status'] ?? '' ); $row['subscription_interval'] = sanitize_text_field( $form_fields_info['subscription_interval'] ?? '' ); $row['subscription_created_date'] = intval( $form_fields_info['subscription_created_date'] ?? 0 ); $row['subscription_current_period_end'] = intval( $form_fields_info['subscription_current_period_end'] ?? 0 ); $row['is_payment_split_payment'] = ! empty( $form_fields_info['is_payment_split_payment'] ) ? intval( $form_fields_info['is_payment_split_payment'] ) : 0; $row['subscription_product_name'] = ''; return $row; } /** * The payment type label of a transaction: "Subscription" when Pro's checkout * stored a subscription id, otherwise the label passed in. * * @param mixed $label Label so far ('One Time' from Lite). * @param mixed $form_fields_info The transaction's unserialized form_fields_info. * @return string */ public static function payment_type( $label, $form_fields_info = [] ): string { if ( is_array( $form_fields_info ) && ! empty( $form_fields_info['subscription_id'] ) ) { return 'Subscription'; } return is_string( $label ) ? $label : 'One Time'; } /** * Append the subscription keys to a CSV export's `form_fields_info` cell. * * @param mixed $fields Cell fields so far (customer_name, customer_email). * @param mixed $form_fields_info The transaction's unserialized form_fields_info. * @return array */ public static function export_fields( $fields, $form_fields_info = [] ): array { $fields = is_array( $fields ) ? $fields : []; $form_fields_info = is_array( $form_fields_info ) ? $form_fields_info : []; $fields['subscription_id'] = isset( $form_fields_info['subscription_id'] ) ? sanitize_text_field( $form_fields_info['subscription_id'] ) : ''; $fields['subscription_customer_id'] = isset( $form_fields_info['subscription_customer_id'] ) ? sanitize_text_field( $form_fields_info['subscription_customer_id'] ) : ''; $fields['subscription_plan_id'] = isset( $form_fields_info['subscription_plan_id'] ) ? sanitize_text_field( $form_fields_info['subscription_plan_id'] ) : ''; $fields['subscription_interval'] = ! empty( $form_fields_info['subscription_interval'] ) ? sanitize_text_field( $form_fields_info['subscription_interval'] ) : ''; $fields['subscription_current_period_start'] = ! empty( $form_fields_info['subscription_current_period_start'] ) ? sanitize_text_field( $form_fields_info['subscription_current_period_start'] ) : ''; $fields['subscription_current_period_end'] = ! empty( $form_fields_info['subscription_current_period_end'] ) ? sanitize_text_field( $form_fields_info['subscription_current_period_end'] ) : ''; $fields['subscription_status'] = ! empty( $form_fields_info['subscription_status'] ) ? sanitize_text_field( $form_fields_info['subscription_status'] ) : ''; $fields['subscription_created_date'] = ! empty( $form_fields_info['subscription_created_date'] ) ? sanitize_text_field( $form_fields_info['subscription_created_date'] ) : ''; $fields['is_payment_split_payment'] = ! empty( $form_fields_info['is_payment_split_payment'] ) ? intval( $form_fields_info['is_payment_split_payment'] ) : 0; return $fields; } /** * Copy the subscription keys of a CSV row whose payment type is "Subscription" * into the imported transaction's `form_fields_info`. * * @param mixed $fields form_fields_info built so far. * @param mixed $record The CSV row, keyed by header. * @param mixed $form_fields_info The row's `form_fields_info` cell, decoded by * Import::decode_form_fields_info() (never an object). * @return array */ public static function import_fields( $fields, $record = [], $form_fields_info = [] ): array { $fields = is_array( $fields ) ? $fields : []; $record = is_array( $record ) ? $record : []; $form_fields_info = is_array( $form_fields_info ) ? $form_fields_info : []; if ( empty( $record['payment_type'] ) || 'subscription' !== strtolower( (string) $record['payment_type'] ) ) { return $fields; } $keys = [ 'subscription_id', 'subscription_customer_id', 'subscription_plan_id', 'subscription_interval', 'subscription_current_period_start', 'subscription_current_period_end', 'subscription_status', 'subscription_created_date', 'is_payment_split_payment', ]; foreach ( $keys as $key ) { $fields[ $key ] = isset( $form_fields_info[ $key ] ) ? sanitize_text_field( $form_fields_info[ $key ] ) : ''; } return $fields; } /** * The SQL condition that narrows a user's transactions to subscription rows. * * @param mixed $where Condition so far (null when nothing supplies one). * @param string $type Requested row type. * @return mixed The condition for 'subscriptions', otherwise $where unchanged. */ public static function subscriptions_type_where( $where, $type = '' ) { if ( 'subscriptions' !== $type ) { return $where; } return " AND form_fields_info LIKE '%\"subscription_id\"%'"; } } ```