F4 Shipping Phone and E-Mail for WooCommerce

Mô tả

F4 Shipping Phone and E-Mail for WooCommerce does exactly what the name says. It adds (often needed) fields
for e-mail and/or telephone number to the shipping address. Here are a few things the plugin does:

  • Adds e-mail and/or telephone field to the shipping address checkout form
  • Adds e-mail and/or telephone field to the edit shipping address form
  • Adds e-mail and/or telephone field to the edit order backend page
  • Shows e-mail and/or telephone field in privacy data export
  • Erases e-mail and/or telephone data if privacy erase is requested
  • Shows e-mail and/or telephone field in orders (thank you page, email etc.)
  • Full integration into the PayPal payment gateway

Usage

This plugin works out-of-the-box. By default, the settings from the billing address
are used for both fields (e-mail = required and telephone = required, optional or hidden, according to the billing address settings).

You can change the settings for both fields on the Accounts & Privacy screen in your WooCommerce settings. Both fields you can hide or set to optional/required.

Features overview

  • Adds e-mail and/or telephone fields
  • Works without configuration
  • Can be configurated for both fields
  • Easy to use
  • Lightweight and optimized
  • 100% free!

Planned features

  • Full integration into API and REST
  • Compatibility check for other popular payment gateways

Ảnh màn hình

  • Fields in checkout shipping form
  • Fields on order confirmation page
  • Fields in order confirmation e-mail
  • Fields on the order admin page
  • Fields in edit address form
  • Field configuration in WooCommerce settings

Cài đặt

  1. Upload the plugin files to the /wp-content/plugins/f4-woocommerce-shipping-phone-and-e-mail directory, or install the plugin through the WordPress plugins screen directly
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Use the Woocommerce -> Settings -> Accounts & Privacy screen to configure the plugin

Hỏi đáp

Since WooCommerce 5.6 the shipping phone is missing in the email addresses and on the order page

Since WooCommerce 5.6 the shipping phone is natively supported in the formatted shipping address. You have to make sure that your template files
(emails/email-addresses.php, emails/plain/email-addresses.php, order/order-details-customer.php) are up-to-date (@version 5.6.0). If your template is not at
least 5.6 compatible then you can simply add the following hook to your functions.php. This hook should restore the previous functionality until your templates are up-to-date:

add_filter('F4/WCSPE/append_phone_field_to_formatted_address', '__return_true')

The shipping email/phone fields are displayed wrong or different than the billing email/phone fields

Since WooCommerce 5.6 the order of our shipping email/phone fields is different than the billing email/phone fields. Thats because our simple solution to add
this fields to every theme without changing the code is limited and the WooCommerce 5.6 update changes a few things in the template files that prevents us from
displaying the fields in the right order. Also the shipping fields may look different than the billing fields, because we don’t add any html code to format the output.
If you want to change the order of the billing phone/email or the displayed output, you can follow these steps to disable our default output and add your own code:

Add the following hook to your theme (functions.php):

add_filter('F4/WCSPE/append_email_field_to_formatted_address', '__return_false');
add_filter('F4/WCSPE/append_phone_field_to_formatted_address', '__return_false'); // only for versions lesser than 5.6

Search in the template file emails/email-addresses.php for the following code:

<address class="address">
    <?php echo wp_kses_post( $shipping ); ?>
    <?php if ( $order->get_shipping_phone() ) : ?>
        <br /><?php echo wc_make_phone_clickable( $order->get_shipping_phone() ); ?>
    <?php endif; ?>
</address>

and replace it with this code:

<address class="address">
    <?php echo wp_kses_post( $shipping ); ?>
    <?php if ( $order->get_shipping_phone() ) : ?>
        <br /><?php echo wc_make_phone_clickable( $order->get_shipping_phone() ); ?>
    <?php endif; ?>
    <?php if ( $order->get_meta('_shipping_email') ) : ?>
        <br/><?php echo esc_html( $order->get_meta('_shipping_email') ); ?>
    <?php endif; ?>
</address>

Search in the template file emails/plain/email-addresses.php for the following code:

if ( $order->get_shipping_phone() ) {
    echo $order->get_shipping_phone() . "\n"; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
}

and replace it with this code:

if ( $order->get_shipping_phone() ) {
    echo $order->get_shipping_phone() . "\n"; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
}
if ( $order->get_meta('_shipping_email') ) {
    echo $order->get_meta('_shipping_email') . "\n"; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
}

Search in the template file order/order-details-customer.php for the following code:

<?php if ( $order->get_shipping_phone() ) : ?>
    <p class="woocommerce-customer-details--phone"><?php echo esc_html( $order->get_shipping_phone() ); ?></p>
<?php endif; ?>

and replace it with this code:

<?php if ( $order->get_shipping_phone() ) : ?>
    <p class="woocommerce-customer-details--phone"><?php echo esc_html( $order->get_shipping_phone() ); ?></p>
<?php endif; ?>

<?php if ( $order->get_meta('_shipping_email') ) : ?>
    <p class="woocommerce-customer-details--email"><?php echo esc_html( $order->get_meta('_shipping_email') ); ?></p>
<?php endif; ?>

The code may vary in your theme, you just have to look for similar looking code.

Is it really free?

Yes, absolutely!

Đánh giá

27 Tháng Mười Một, 2020
Excellent and simple. Thank you.
7 Tháng Sáu, 2020
Thank you it is working like a charm, it is also available in the REST API result as a meta field.
4 Tháng Một, 2020
I only needed this. Recommended for those who do not need to add or move other fields.
30 Tháng Mười Một, 2019
I created a wordpress.org account to write this review. This is a great plugin! I wasted a few hours to search for a way to include a shipping phone number to emails for customers and admin, but failed to find the proper way. But this plugin does it. THANK YOU!!!
9 Tháng Mười, 2019
I usually do not waste my time in giving reviews, but this plugin is great. I spent hours trying to find code that would do everything this plugin does in a couple of minutes.
Đọc tất cả 8 đánh giá

Người đóng góp & Lập trình viên

“F4 Shipping Phone and E-Mail for WooCommerce” là mã nguồn mở. Những người sau đã đóng góp vào plugin này.

Những người đóng góp

“F4 Shipping Phone and E-Mail for WooCommerce” đã được dịch qua 4 ngôn ngữ. Cảm ơn những người tham gia dịch vì đóng góp của họ.

Dịch “F4 Shipping Phone and E-Mail for WooCommerce” sang ngôn ngữ của bạn.

Muốn tham gia phát triển?

Duyệt code, check out SVN repository, hoặc theo dõi nhật ký phát triển qua RSS.

Nhật ký thay đổi

1.0.13

  • Fix phone field output in formatted address for WooCommerce 5.6
  • Add hooks to individually hide email or phone field in formatted address
  • Add some FAQ
  • Support WooCommerce 5.6

1.0.12

  • Fix condition for formatted part in address block
  • Support WooCommerce 5.5
  • Support WordPress 5.8

1.0.11

  • Support WooCommerce 5.0
  • Support WordPress 5.7

1.0.10

  • Support WooCommerce 4.8
  • Support WordPress 5.6

1.0.9

  • Save guest checkout fields in session

1.0.8

  • Support WooCommerce 4.4
  • Support WordPress 5.5

1.0.7

  • Update translations

1.0.6

  • Support WooCommerce 4.0
  • Support WordPress 5.4

1.0.5

  • Fix privacy export and erase

1.0.4

  • Add donation link
  • Rename plugin according to the new naming conventions

1.0.3

  • Fix formatted output

1.0.2

  • Fix “load shipping address” function in order backend

1.0.1

  • Update plugin slug and basename for better compatibility with the plugin name

1.0.0

  • Initial stable release