builder_alerts() ) {
return;
}
$hide_class = ! Helpers::has_stripe_field( $this->form_data ) ? 'wpforms-hidden' : '';
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo Notices::get_fee_notice( $hide_class );
if ( Helpers::is_legacy_payment_settings( $this->form_data ) ) {
$this->legacy_builder_content();
return;
}
$this->maybe_convert_legacy_settings();
echo '';
if ( ! Helpers::is_pro() ) {
$this->builder_content_one_time();
$this->builder_content_recurring();
} else {
parent::builder_content();
}
echo '
';
}
/**
* Convert legacy settings if they exist.
*
* @since 1.8.4
*/
private function maybe_convert_legacy_settings() {
// Enable one-time payments if they were active.
if ( ! empty( $this->form_data['payments']['stripe']['enable'] ) ) {
unset( $this->form_data['payments']['stripe']['enable'] );
$this->form_data['payments']['stripe']['enable_one_time'] = 1;
}
// Convert subscription settings if they exist and disabled to new default plan.
if (
empty( $this->form_data['payments']['stripe']['recurring'] ) ||
! empty( $this->form_data['payments']['stripe']['enable_recurring'] )
) {
return;
}
$stripe_recurring_settings = $this->form_data['payments']['stripe']['recurring'];
unset( $this->form_data['payments']['stripe']['recurring'] );
if (
! empty( $stripe_recurring_settings['enable'] ) ||
array_filter( $stripe_recurring_settings, 'is_array' ) === $stripe_recurring_settings
) {
return;
}
// Preserve all settings (name, period, email, and CL).
$this->form_data['payments']['stripe']['recurring'][] = $stripe_recurring_settings;
}
/**
* Display legacy content inside the panel content area.
*
* @since 1.8.4
*/
private function legacy_builder_content() {
$this->enable_payments_toggle();
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo $this->content_section_body();
}
/**
* Builder content for one time payments.
*
* @since 1.8.4
*/
private function builder_content_one_time() {
?>
slug,
'enable_one_time',
$this->form_data,
esc_html__( 'Enable one-time payments', 'wpforms-lite' ),
[
'parent' => 'payments',
'default' => '0',
'tooltip' => esc_html__( 'Allow your customers to one-time pay via the form.', 'wpforms-lite' ),
'class' => 'wpforms-panel-content-section-payment-toggle wpforms-panel-content-section-payment-toggle-one-time',
]
);
?>
get_builder_content_one_time_content(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>
add_plan_education();
wpforms_panel_field(
'toggle',
$this->slug,
'enable_recurring',
$this->form_data,
esc_html__( 'Enable recurring subscription payments', 'wpforms-lite' ),
[
'parent' => 'payments',
'default' => '0',
'tooltip' => esc_html__( 'Allow your customer to pay recurringly via the form.', 'wpforms-lite' ),
'class' => 'wpforms-panel-content-section-payment-toggle wpforms-panel-content-section-payment-toggle-recurring',
]
);
?>
form_data['payments'][ $this->slug ]['recurring'] ) ) {
$this->form_data['payments'][ $this->slug ]['recurring'][] = [];
}
foreach ( $this->form_data['payments'][ $this->slug ]['recurring'] as $plan_id => $plan_settings ) {
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo wpforms_render(
'builder/payment/recurring/item',
[
'plan_id' => $plan_id,
'content' => $this->get_builder_content_recurring_payment_content( $plan_id ),
],
true
);
// Limit plans if Stripe addon is NOT active.
break;
}
?>
obj( 'addons' )->get_addon( 'wpforms-stripe' );
if ( empty( $addon ) ) {
return;
}
echo '' . esc_html( $label ) . '';
return;
}
echo '' . esc_html( $label ) . '';
}
/**
* Display alert if Stripe keys are not set.
*
* @since 1.8.2
*
* @return bool
*/
private function builder_alerts() {
if ( Helpers::has_stripe_keys() ) {
if ( Helpers::is_legacy_payment_settings( $this->form_data ) ) {
Notices::prompt_new_interface();
}
$this->stripe_credit_card_alert();
return false;
}
$this->alert_icon();
echo '';
esc_html_e( 'Heads up! Stripe payments can\'t be enabled yet.', 'wpforms-lite' );
echo '
';
printf(
wp_kses( /* translators: %1$s - admin area Payments settings page URL. */
__( 'First, please connect to your Stripe account on the WPForms Settings page.', 'wpforms-lite' ),
[
'a' => [
'href' => [],
'class' => [],
],
]
),
esc_url( admin_url( 'admin.php?page=wpforms-settings&view=payments' ) )
);
echo '
';
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
echo $this->learn_more_link();
echo '
';
$content .= $this->get_builder_content_one_time_content();
$content .= sprintf( '
%1$s
', esc_html__( 'Subscriptions', 'wpforms-lite' ) );
$content .= wpforms_panel_field(
'toggle',
'stripe',
'enable',
$this->form_data,
esc_html__( 'Enable recurring subscription payments', 'wpforms-lite' ),
[
'parent' => 'payments',
'subsection' => 'recurring',
'default' => '0',
],
false
);
$content .= $this->get_builder_content_recurring_payment_content( '' );
$content .= '';
return $content;
}
/**
* Get content inside the one time payment area.
*
* @since 1.8.4
*
* @return string
*/
protected function get_builder_content_one_time_content() {
$content = wpforms_panel_field(
'text',
$this->slug,
'payment_description',
$this->form_data,
esc_html__( 'Payment Description', 'wpforms-lite' ),
[
'parent' => 'payments',
'tooltip' => esc_html__( 'Enter your payment description. Eg: Donation for the soccer team. Only used for standard one-time payments.', 'wpforms-lite' ),
],
false
);
$content .= wpforms_panel_field(
'select',
$this->slug,
'receipt_email',
$this->form_data,
esc_html__( 'Stripe Payment Receipt', 'wpforms-lite' ),
[
'parent' => 'payments',
'field_map' => [ 'email' ],
'placeholder' => esc_html__( '--- Select Email ---', 'wpforms-lite' ),
'tooltip' => esc_html__( 'If you would like to have Stripe send a receipt after payment, select the email field to use. This is optional but recommended. Only used for standard one-time payments.', 'wpforms-lite' ),
],
false
);
$content .= wpforms_panel_field(
'select',
$this->slug,
'customer_email',
$this->form_data,
esc_html__( 'Customer Email', 'wpforms-lite' ),
[
'parent' => 'payments',
'field_map' => [ 'email' ],
'placeholder' => esc_html__( '--- Select Email ---', 'wpforms-lite' ),
'tooltip' => esc_html__( 'Select the field that contains the customer\'s email address. This is optional but recommended.', 'wpforms-lite' ),
],
false
);
$content .= $this->get_customer_name_panel_field();
$content .= $this->get_address_panel_fields();
$content .= $this->single_payments_conditional_logic_section();
return $content;
}
/**
* Get content inside the recurring payment area.
*
* @since 1.8.4
*
* @param string $plan_id Plan id.
*
* @return string
*/
protected function get_builder_content_recurring_payment_content( $plan_id ) {
$content = wpforms_panel_field(
'text',
$this->slug,
'name',
$this->form_data,
esc_html__( 'Plan Name', 'wpforms-lite' ),
[
'parent' => 'payments',
'subsection' => 'recurring',
'index' => $plan_id,
'tooltip' => esc_html__( 'Enter the subscription name. Eg: Email Newsletter. Subscription period and price are automatically appended. If left empty the form name will be used.', 'wpforms-lite' ),
'class' => 'wpforms-panel-content-section-payment-plan-name',
],
false
);
$content .= wpforms_panel_field(
'select',
$this->slug,
'period',
$this->form_data,
esc_html__( 'Recurring Period', 'wpforms-lite' ),
[
'parent' => 'payments',
'subsection' => 'recurring',
'index' => $plan_id,
'default' => 'yearly',
'options' => [
'daily' => esc_html__( 'Daily', 'wpforms-lite' ),
'weekly' => esc_html__( 'Weekly', 'wpforms-lite' ),
'monthly' => esc_html__( 'Monthly', 'wpforms-lite' ),
'quarterly' => esc_html__( 'Quarterly', 'wpforms-lite' ),
'semiyearly' => esc_html__( 'Semi-Yearly', 'wpforms-lite' ),
'yearly' => esc_html__( 'Yearly', 'wpforms-lite' ),
],
'tooltip' => esc_html__( 'How often you would like the charge to recur.', 'wpforms-lite' ),
],
false
);
$content .= wpforms_panel_field(
'select',
$this->slug,
'email',
$this->form_data,
esc_html__( 'Customer Email', 'wpforms-lite' ),
[
'parent' => 'payments',
'subsection' => 'recurring',
'index' => $plan_id,
'field_map' => [ 'email' ],
'placeholder' => esc_html__( '--- Select Email ---', 'wpforms-lite' ),
'tooltip' => esc_html__( "Select the field that contains the customer's email address. This field is required.", 'wpforms-lite' ),
],
false
);
$content .= $this->get_customer_name_panel_field( $plan_id );
$content .= $this->get_address_panel_fields( $plan_id );
$content .= $this->recurring_payments_conditional_logic_section( $plan_id );
return $content;
}
/**
* Alert icon.
*
* @since 1.8.4
*/
private function alert_icon() {
printf(
'
',
esc_url( WPFORMS_PLUGIN_URL . 'assets/images/addon-icon-stripe.png' ),
esc_attr__( 'Connect WPForms to Stripe.', 'wpforms-lite' )
);
}
/**
* Learn more link.
*
* @since 1.8.4
*
* @return string
*/
private function learn_more_link() {
return sprintf(
'%2$s',
esc_url( wpforms_utm_link( 'https://wpforms.com/docs/how-to-install-and-use-the-stripe-addon-with-wpforms/', 'builder-payments', 'Stripe Documentation' ) ),
esc_html__( 'Learn more about our Stripe integration.', 'wpforms-lite' )
);
}
/**
* Get Customer name panel field.
*
* @since 1.8.6
*
* @param string|null $plan_id Plan ID.
*
* @return string
*/
private function get_customer_name_panel_field( $plan_id = null ) {
$args = [
'parent' => 'payments',
'field_map' => [ 'name' ],
'placeholder' => esc_html__( '--- Select Name ---', 'wpforms-lite' ),
'tooltip' => esc_html__( 'Select the field that contains the customer\'s name. This is optional but recommended.', 'wpforms-lite' ),
];
if ( ! is_null( $plan_id ) ) {
$args['subsection'] = 'recurring';
$args['index'] = $plan_id;
}
return wpforms_panel_field(
'select',
$this->slug,
'customer_name',
$this->form_data,
esc_html__( 'Customer Name', 'wpforms-lite' ),
$args,
false
);
}
/**
* Get address panel fields.
*
* @since 1.8.8
*
* @param string|null $plan_id Plan ID.
*
* @return string
*/
private function get_address_panel_fields( $plan_id = null ): string {
$args = [
'parent' => 'payments',
'field_map' => [ 'address' ],
'placeholder' => esc_html__( '--- Select Address ---', 'wpforms-lite' ),
];
$is_subscription = ! is_null( $plan_id );
if ( $is_subscription ) {
$args['subsection'] = 'recurring';
$args['index'] = $plan_id;
}
$is_pro = wpforms()->is_pro();
if ( ! $is_pro ) {
$args['pro_badge'] = true;
$args['data'] = [
'action' => 'upgrade',
'name' => esc_html__( 'Customer Address', 'wpforms-lite' ),
'utm-content' => 'Builder Stripe Address Field',
'licence' => 'pro',
];
$args['input_class'] = 'education-modal';
$args['readonly'] = true;
} else {
$args['tooltip'] = esc_html__( 'Select the field that contains the customer\'s address. This is optional but required for some regions.', 'wpforms-lite' );
}
$output = wpforms_panel_field(
'select',
$this->slug,
'customer_address',
$this->form_data,
esc_html__( 'Customer Address', 'wpforms-lite' ),
$args,
false
);
if ( $is_subscription ) {
return $output;
}
if ( ! $is_pro ) {
$args['data']['name'] = esc_html__( 'Shipping Address', 'wpforms-lite' );
} else {
$args['tooltip'] = esc_html__( 'Select the field that contains the shipping address. This is optional but required for some regions.', 'wpforms-lite' );
}
$output .= wpforms_panel_field(
'select',
$this->slug,
'shipping_address',
$this->form_data,
esc_html__( 'Shipping Address', 'wpforms-lite' ),
$args,
false
);
return $output;
}
}