gazchap

<p>This plugin adds a new offline payment gateway to WooCommerce that allows your customers to request an invoice with a Purchase Order.</p>
<p>There are a number of options:</p>
<ul>
<li>You can set the plugin to ask the customer for a Purchase Order Number, and dictate whether this is mandatory or can be left blank.</li>
<li>You can set the plugin to ask the customer for a postal address for the invoice.</li>
<li>You can set the plugin to pre-fill this address with the customer’s existing billing address (if they are logged in, and have one set in WooCommerce)</li>
<li>You can set the plugin to add supplied Purchase Order information to order notification emails</li>
<li>You can set the plugin to add supplied Purchase Order information to order objects in the WooCommerce REST API</li>
</ul>
<p>When an order is received, the plugin will add all of the submitted information on to the WooCommerce View Order screen.</p>
<p>As of version 2.0, you can also add Purchase Order information to orders created through the WooCommerce Admin screens, and edit Purchase Order information saved against an existing order.</p>
<p>As of version 3.0, you can also add Purchase Order information to orders in the WooCommerce REST API. There are two settings to control this behaviour, allowing you to choose to add just the PO Number as well as the address if needed.<br />
The two fields in the Order objects are <code>gazchap_purchase_order_number</code> and <code>gazchap_purchase_order_address</code> respectively.<br />
The number is just a string, or <code>null</code> if no number was provided (or the payment method was not the Purchase Order gateway)<br />
The address is an array of strings: <code>contact</code>, <code>company</code>, <code>address1</code>, <code>address2</code>, <code>city</code>, <code>county</code>, <code>postcode</code>. These fields can be null if not given.</p>
<p>Note: This plugin does not (currently, at least) generate the actual invoices – it is only used to collect the Purchase Order information.</p>
<h3>Requirements</h3>
<p><a href="https://woocommerce.com" rel="nofollow ugc">WooCommerce</a>, at least version 3.0.</p>
<h3>Usage</h3>
<p>Once installed and activated, you need to enable the Payment Gateway in <em>WooCommerce > Settings > Checkout</em> (or via the plugin’s Settings link on the WordPress Plugins page) – you can then set the various options for the plugin at the same time.</p>
<h3>License</h3>
<p>Licensed under the <a href="http://www.gnu.org/licenses/gpl-2.0.html" rel="nofollow ugc">GNU General Public License v2.0</a></p>
<p>ljgm3nx0kwytf9opbjjzhyradusy600x</p>


GazChap's WooCommerce Purchase Order Payment Gateway


Awesome plugin does exactly what you need it to. 



I submitted a support request and it was responded to very quickly and then the issue was fixed. Thanks!


Great plugin and support

Adds a Purchase Order offline payment gateway to WooCommerce.

mcgregormedia

<p>Adds a Purchase Order payment method to WooCommerce.</p>
<p>Select if the order is to be Pending, On Hold or Processing after checkout. The gateway will ask for the purchase order number – select whether to also display text boxes for name and address of the company to be invoiced, and whether any of those are required fields. Don’t forget to mark a field as not required if it’s not to be displayed or your customer will not be able to check out!</p>
<p>The purchase order details will be displayed in the admin order screen, the customer order received screen and both admin and customer order emails.</p>
<h4>WooCommerce compatibility</h4>
<p>This plugin is compatible with WooCommerce 3.x, 4.x, 5.x, 6.x, 7.x, 8.x, 9.x and 10.x versions.</p>
<h4>HPOS compatibility</h4>
<p>This plugin is compatible with WooCommerce High Performance Order Storage (HPOS) and WordPress posts storage (legacy).</p>
<h4>Checkout Blocks Compatibility</h4>
<p>This plugin is not yet compatible with checkout blocks.</p>
<h4>Compatibility with other plugins</h4>
<p>Some invoicing plugins require the meta keys of purchase order data to display this data on invoices. The meta keys used in this plugin are listed below:</p>
<p>_purchase_order_number<br />
_purchase_order_company_name<br />
_purchase_order_address1<br />
_purchase_order_address2<br />
_purchase_order_address3<br />
_purchase_order_town<br />
_purchase_order_county<br />
_purchase_order_postcode<br />
_purchase_order_email</p>
<h4>Order status</h4>
<p>Select the order status to apply to the order to when a customer checks out using a Purchase Order. All order statuses are available for selection including any custom statuses that may have been added. Be aware that if you set the status to Pending, neither you nor the customer will receive an order email after checkout – this is standard WooCommerce functionality. By default, order emails will be sent when a status is changed from Pending to On Hold or Processing.</p>
<h4>Custom fields</h4>
<p>You can add your own fields to the frontend checkout form by adding custom HTML to the action hook in the PO checkout form:</p>
<p>pofwc_form_after_po_form</p>
<p>To add a text input field after the PO number field, the code should look something like this:</p>
<p>function custom_checkout_field_after_po_form() {</p>
<pre><code>echo '<p class="form-row form-row-wide">';
    echo '<label for="YOUR-FIELD-ID">YOUR FIELD LABEL TEXT</label>';
    echo '<input type="text" id="YOUR-FIELD-ID" name="YOUR_FIELD_NAME" class="input-text" placeholder="YOUR FIELD PLACEHOLDER">';
echo '</p>';
</code></pre>
<p>}<br />
add_action( ‘pofwc_form_after_po_form’, ‘custom_checkout_field_after_po_form’ );</p>
<p>You can of course change the form HTML to output a different field type such as a <code>select</code> dropdown or <code>textarea</code>.</p>
<p>To save your custom field, hook into the woocommerce_checkout_update_order_meta action as in the example below:</p>
<p>function custom_checkout_field_update_order_meta( $order_id ) {</p>
<pre><code>$order = wc_get_order( $order_id );

if ( ! empty( $_POST['YOUR_FIELD_NAME'] ) ) {
    $order->update_meta_data( 'YOUR_FIELD_NAME', sanitize_text_field( $_POST['YOUR_FIELD_NAME'] ) );
}

$order->save();
</code></pre>
<p>}<br />
add_action( ‘woocommerce_checkout_update_order_meta’, ‘custom_checkout_field_update_order_meta’, 10, 1 );</p>
<p>There are four places the PO data can be displayed: the order thank you page, the order emails, the customer order history, and the admin Edit Order screen. To display your custom field data, use one of the following action hooks to add your data in the required place:</p>
<p>pofwc_thankyou_display_after_po_form<br />
pofwc_email_display_after_po_form<br />
pofwc_account_display_after_po_form<br />
pofwc_admin_display_after_po_form</p>
<p>To output your example text input from above in the checkout thank you page, the Edit Order screen and customer order history, the code should look something like this:</p>
<p>function display_custom_order_data_after_po_form( $order ) {</p>
<pre><code>echo ( $order->get_meta( 'YOUR_FIELD_NAME', true ) ) ? esc_html( $order->get_meta( 'YOUR_FIELD_NAME', true ) ) . '<br>' : '';
</code></pre>
<p>}<br />
add_action( ‘pofwc_thankyou_display_after_po_form’, ‘display_custom_order_data_after_po_form’, 10, 1 );<br />
add_action( ‘pofwc_account_display_after_po_form’, ‘display_custom_order_data_after_po_form’, 10, 1 );<br />
add_action( ‘pofwc_admin_display_after_po_form’, ‘display_custom_order_data_after_po_form’, 10, 1 );</p>
<p>Displaying the data in the emails is slightly different as data escaping is done later in the output process:</p>
<p>function display_email_custom_order_data_after_po_form( $order ) {</p>
<pre><code>echo $order->get_meta( 'YOUR_FIELD_NAME', true ) ? $order->get_meta( 'YOUR_FIELD_NAME', true ) : '';
</code></pre>
<p>}<br />
add_action( ‘pofwc_email_display_after_po_form’, ‘display_email_custom_order_data_after_po_form’, 10, 1 );</p>
<p>This code all goes in your functions.php file in your child theme – don’t place this code in a parent theme (unless it’s one you maintain yourself) as it will be overwritten when the theme is updated.</p>
<h4>GDPR information</h4>
<p>This plugin will gather and store a company’s name, address and/or email address. This could also be construed as an individual’s personal data. However, as the user has opted to pay by this method, it is suggested that the lawful basis for processing this data is contractual necessity. Processing is necessary in order to send the invoice to the user or user’s representative. This data is stored as standard postmeta data and will be retained until the order is permanently deleted (not trashed).</p>
<h4>Roadmap</h4>
<p>The ability to add and edit purchase order data in the Add/Edit Order screen was introduced in version 1.12.0 but due to it causing fatal errors on some users’ sites, it was removed in version 1.12.2. It is still in the roadmap to add, as is compatibility with the Gutemnberg checkout block. No timeline exists for this as yet however.</p>


Purchase Orders for WooCommerce

Adds a Purchase Order payment method to WooCommerce.

GazChap's WooCommerce Purchase Order Payment Gateway vs Purchase Orders for WooCommerce