F4 Shipping Phone and E-Mail for WooCommerce

描述

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

屏幕截图

  • 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

安装

  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

常见问题

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!

评价

2020 年 6 月 7 日
Thank you it is working like a charm, it is also available in the REST API result as a meta field.
2020 年 1 月 4 日
I only needed this. Recommended for those who do not need to add or move other fields.
2019 年 11 月 30 日 1 回复
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!!!
2019 年 10 月 9 日 1 回复
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.
阅读所有8条评价

贡献者及开发者

“F4 Shipping Phone and E-Mail for WooCommerce” 是开源软件。 以下人员对此插件做出了贡献。

贡献者

「F4 Shipping Phone and E-Mail for WooCommerce」插件已被翻译至 4 种本地化语言。 感谢所有译者为本插件所做的贡献。

将“F4 Shipping Phone and E-Mail for WooCommerce”翻译成您的语言。

对开发感兴趣吗?

您可以浏览代码,查看SVN仓库,或通过RSS订阅开发日志

更新日志

1.0.19

  • Support WooCommerce 8.7
  • Support WordPress 6.5

1.0.18

  • Add support for WC “High-Performance Order Storage” feature
  • Add support for WC “New product editor” feature
  • Support WooCommerce 8.2
  • Support WordPress 6.3

1.0.17

  • Support WooCommerce 7.1
  • Support WordPress 6.1

1.0.16

  • Update www.f4dev.ch links
  • Support WooCommerce 6.8

1.0.15

  • Support WooCommerce 6.5
  • Support WordPress 6.0

1.0.14

  • Support WordPress 5.9

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