'capability_here' * To add a page to the network admin (wp-admin/network), use: 'network_admin_menu' => 'capability_here' * To add a page to the user (wp-admin/user) admin, use: 'user_admin_menu' => 'capability_here' * * @since 2.0.0 * @var array */ protected $supported_panels = [ 'network_admin_menu' => 'wu_read_payments', ]; /** * Register ajax forms that we use for payments. * * @since 2.0.0 * @return void */ public function register_forms(): void { /* * Edit/Add Line Item */ wu_register_form( 'add_new_payment', [ 'render' => [$this, 'render_add_new_payment_modal'], 'handler' => [$this, 'handle_add_new_payment_modal'], 'capability' => 'wu_edit_payments', ] ); } /** * Renders the add/edit line items form. * * @since 2.0.0 * @return void */ public function render_add_new_payment_modal(): void { $fields = [ 'products' => [ 'type' => 'model', 'title' => __('Products', 'wp-multisite-waas'), 'placeholder' => __('Search Products...', 'wp-multisite-waas'), 'desc' => __('Each product will be added as a line item.', 'wp-multisite-waas'), 'value' => '', 'tooltip' => '', 'html_attr' => [ 'data-model' => 'product', 'data-value-field' => 'id', 'data-label-field' => 'name', 'data-search-field' => 'name', 'data-max-items' => 10, ], ], 'status' => [ 'type' => 'select', 'title' => __('Status', 'wp-multisite-waas'), 'placeholder' => __('Status', 'wp-multisite-waas'), 'desc' => __('The payment status to attach to the newly created payment.', 'wp-multisite-waas'), 'value' => Payment_Status::COMPLETED, 'options' => Payment_Status::to_array(), 'tooltip' => '', ], 'membership_id' => [ 'type' => 'model', 'title' => __('Membership', 'wp-multisite-waas'), 'placeholder' => __('Search Membership...', 'wp-multisite-waas'), 'desc' => __('The membership associated with this payment.', 'wp-multisite-waas'), 'value' => '', 'tooltip' => '', 'html_attr' => [ 'data-model' => 'membership', 'data-value-field' => 'id', 'data-label-field' => 'reference_code', 'data-max-items' => 1, 'data-selected' => '', ], ], 'add_setup_fees' => [ 'type' => 'toggle', 'title' => __('Include Setup Fees', 'wp-multisite-waas'), 'desc' => __('Checking this box will include setup fees attached to the selected products as well.', 'wp-multisite-waas'), 'value' => 1, ], 'submit_button' => [ 'type' => 'submit', 'title' => __('Add Payment', 'wp-multisite-waas'), 'value' => 'save', 'classes' => 'wu-w-full button button-primary', 'wrapper_classes' => 'wu-items-end', ], ]; $form = new \WP_Ultimo\UI\Form( 'add_payment', $fields, [ 'views' => 'admin-pages/fields', 'classes' => 'wu-modal-form wu-widget-list wu-striped wu-m-0 wu-mt-0', 'field_wrapper_classes' => 'wu-w-full wu-box-border wu-items-center wu-flex wu-justify-between wu-p-4 wu-m-0 wu-border-t wu-border-l-0 wu-border-r-0 wu-border-b-0 wu-border-gray-300 wu-border-solid', 'html_attr' => [ 'data-wu-app' => 'add_payment', 'data-state' => wu_convert_to_state( [ 'taxable' => 0, 'type' => 'product', ] ), ], ] ); $form->render(); } /** * Handles the add/edit of line items. * * @since 2.0.0 * @return mixed */ public function handle_add_new_payment_modal() { $membership = wu_get_membership(wu_request('membership_id')); if ( ! $membership) { $error = new \WP_Error('invalid-membership', __('Invalid membership.', 'wp-multisite-waas')); return wp_send_json_error($error); } $cart = new \WP_Ultimo\Checkout\Cart( [ 'products' => explode(',', (string) wu_request('products')), 'cart_type' => wu_request('add_setup_fees') ? 'new' : 'renewal', ] ); $payment_data = array_merge( $cart->to_payment_data(), [ 'status' => wu_request('status'), 'membership_id' => $membership->get_id(), 'customer_id' => $membership->get_customer_id(), ] ); $payment = wu_create_payment($payment_data); if (is_wp_error($payment)) { return wp_send_json_error($payment); } wp_send_json_success( [ 'redirect_url' => wu_network_admin_url( 'wp-ultimo-edit-payment', [ 'id' => $payment->get_id(), ] ), ] ); } /** * Allow child classes to register widgets, if they need them. * * @since 1.8.2 * @return void */ public function register_widgets() {} /** * Returns an array with the labels for the edit page. * * @since 1.8.2 * @return array */ public function get_labels() { return [ 'deleted_message' => __('Payment removed successfully.', 'wp-multisite-waas'), 'search_label' => __('Search Payment', 'wp-multisite-waas'), ]; } /** * Returns the title of the page. * * @since 2.0.0 * @return string Title of the page. */ public function get_title() { return __('Payments', 'wp-multisite-waas'); } /** * Returns the title of menu for this page. * * @since 2.0.0 * @return string Menu label of the page. */ public function get_menu_title() { return __('Payments', 'wp-multisite-waas'); } /** * Allows admins to rename the sub-menu (first item) for a top-level page. * * @since 2.0.0 * @return string False to use the title menu or string with sub-menu title. */ public function get_submenu_title() { return __('Payments', 'wp-multisite-waas'); } /** * Returns the action links for that page. * * @since 1.8.2 * @return array */ public function action_links() { return [ [ 'label' => __('Add Payment', 'wp-multisite-waas'), 'icon' => 'wu-circle-with-plus', 'classes' => 'wubox', 'url' => wu_get_form_url('add_new_payment'), ], ]; } /** * Loads the list table for this particular page. * * @since 2.0.0 * @return \WP_Ultimo\List_Tables\Base_List_Table */ public function table() { return new \WP_Ultimo\List_Tables\Payment_List_Table(); } }