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 reply
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 reply
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