First Commit

Author: bekarice

Diff for: readme.md

@@ -0,0 +1,37 @@
+# SkyVerge WooCommerce Plugins
+
+Welcome to the `wc-plugins-snippets` repository! This repository stores code snippets related to [SkyVerge WooCommerce plugins](https://www.skyverge.com/shop/) to modify or add onto plugin behavior.
+
+Code snippets are organized by plugin (folder), and each plugin's folder includes one file per snippet or code example. The file name describes the snippet functionality.
+
+Some larger plugins, such as Memberships, may have sub-folders by category / snippet type to make it easier to find relevant snippets.
+
+**Please ensure you know how to [add custom code to your website](https://www.skyverge.com/blog/add-custom-code-to-wordpress/) if you use any of these code snippets**. These are provided publicly as a courtesy, and are **not supported**, so you should be familiar with adding code to your site to use them.
+
+## Issues and Contributions
+
+If you notice a snippet is outdated, please submit an issue so we can update it, or we welcome pull requests :smile_cat: 
+
+We also welcome new snippets! Please first check to see if a similar snippet exists, then submit a PR adding your snippet to the appropriate plugin folder(s), and ensure the name of the file is descriptive of what the snippet does. Including a brief description at the top snippet file is also helpful.
+
+**PR Guidelines**
+
+ - Please ensure that your PR follows WordPress coding standards and conventions.
+ 
+ - All snippets should be PHP 5.2 compatible and use best WooCommerce practices. Try to maintain compatibility at least as far back as WooCommerce 2.3, or otherwise note requirements in the snippet.
+ 
+ - Please use "poor man's namespacing" for function names by using this format:
+ 
+ ```
+function sv_wc_{plugin_name}_my_function() {
+	// the function code
+}
+```
+
+ - Files should include one "snippet" or example per file.
+ 
+ - If your snippet relates to multiple plugins, put it in both folders so it's easy to find.
+ 
+## Licensing
+
+All snippets / code in this repository is **GPL licensed** (GNU General Public License v3.0). If you plan to contribute your own snippets, please note that they will adopt this license.

Diff for: woocommerce-cart-notices/open-notice-links-in-new-window.php

@@ -0,0 +1,13 @@
+<?php
+/**
+ * Force all notices to open links in a new tab
+ */
+function sv_wc_cart_notices_set_target_blank( $notice_html ) {
+	$notice_html = str_replace( '<a', '<a target="blank"', $notice_html );
+	return $notice_html;
+}
+add_filter( 'woocommerce_cart_notice_minimum_amount_notice', 'sv_wc_cart_notices_set_target_blank' );
+add_filter( 'woocommerce_cart_notice_deadline_notice', 'sv_wc_cart_notices_set_target_blank' );
+add_filter( 'woocommerce_cart_notice_referer_notice', 'sv_wc_cart_notices_set_target_blank' );
+add_filter( 'woocommerce_cart_notice_products_notice', 'sv_wc_cart_notices_set_target_blank' );
+add_filter( 'woocommerce_cart_notice_categories_notice', 'sv_wc_cart_notices_set_target_blank' );

Diff for: woocommerce-cart-notices/remove-notices-from-checkout.php

@@ -0,0 +1,10 @@
+<?php
+/**
+ * Removes any Cart Notices from the checkout page
+ */
+function sv_wc_cart_notices_remove_on_checkout() {
+	if ( function_exists( 'wc_cart_notices' ) ) {
+		remove_action( 'woocommerce_before_checkout_form', array( wc_cart_notices(), 'add_cart_notice' ) );
+	}
+}
+add_action( 'init', 'sv_wc_cart_notices_remove_on_checkout' );

Diff for: woocommerce-checkout-add-ons/add-add-on-attributes-like-placeholders.php

@@ -0,0 +1,35 @@
+<?php
+/**
+ * Add attributes to Checkout Add-ons fields at checkout
+ * Example: add maximum character counts, placeholders, and descriptions for add-ons
+ *
+ * @param array $checkout_fields the fields in the WooCommerce checkout
+ * @return array $checkout_fields the updated fields array
+ */
+function sv_wc_checkout_add_ons_add_attributes( $checkout_fields ) {
+
+    $add_on_id = 3; // change 3 to your add-on id
+
+	// is our checkout add-on a field?
+    if ( isset( $checkout_fields['add_ons'][ 'wc_checkout_add_ons_' . $add_on_id ] ) ) {
+    
+    	// Adds a maximum character length + description to this add on
+        $checkout_fields['add_ons'][ 'wc_checkout_add_ons_' . $add_on_id ]['maxlength']   = "300";
+        $checkout_fields['add_ons'][ 'wc_checkout_add_ons_' . $add_on_id ]['description']   = "Please add no more than 300 characters.";
+    
+    }
+
+    // repeat for each add-on
+    $add_on_id = 7; // change 7 to your add-on id
+
+    if ( isset( $checkout_fields['add_ons'][ 'wc_checkout_add_ons_' . $add_on_id ] ) ) {
+    
+    	// Add a maximum length and placeholder
+        $checkout_fields['add_ons'][ 'wc_checkout_add_ons_' . $add_on_id ]['maxlength']   = "140";
+        $checkout_fields['add_ons'][ 'wc_checkout_add_ons_' . $add_on_id ]['placeholder'] = "My custom placeholder";
+        
+    }
+
+    return $checkout_fields;
+}
+add_filter( 'woocommerce_checkout_fields', 'sv_wc_checkout_add_ons_add_attributes', 20 );

Diff for: woocommerce-checkout-add-ons/conditionally-hide-add-ons.php

@@ -0,0 +1,27 @@
+<?php
+/**
+ * Conditionally show gift add-ons only if shipping address differs from billing
+ * Note: be careful not to require fields if you do this!
+ *   they may be hidden and the customer can't complete checkout
+ */
+function sv_wc_checkout_add_ons_conditionally_show_gift_add_on() {
+
+    wc_enqueue_js( "
+        $( 'input[name=ship_to_different_address]' ).change( function () {
+
+            if ( $( this ).is( ':checked' ) ) {
+
+                // show the gift checkout add-on -- replace '2' with the id of your add-on
+                $( '#wc_checkout_add_ons_2_field' ).show();
+
+            } else {
+
+                // hide the gift checkout add-on -- replace '2' with the id of your add-on
+                $( '#wc_checkout_add_ons_2_field' ).hide();
+
+            }
+
+        } ).change();
+    " );
+}
+add_action( 'wp_enqueue_scripts', 'sv_wc_checkout_add_ons_conditionally_show_gift_add_on' );

Diff for: woocommerce-checkout-add-ons/remove-add-ons-if-all-cart-items-in-category.php

@@ -0,0 +1,38 @@
+<?php
+/**
+ * Remove add-ons if _all products_ in the cart are in a given category
+ *
+ * Example: remove add-ons if all products in cart are in the "Gift box" category
+ * (and thus are gift-wrapped already)
+ */
+function sv_wc_checkout_add_ons_remove_add_ons_only_giftboxes() {
+
+	// bail if Checkout Add-ons isn't active
+	if ( ! function_exists( 'wc_checkout_add_ons' ) ) {
+		return;
+	}
+	
+	// holds checks for all products in cart to see if they're in our category
+	$category_checks = array();
+		
+	// check each cart item for our category
+	foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
+        	
+		$product = $cart_item['data'];
+	
+		// replace 'gift_box' with your category's slug
+		$product_in_cat = has_term( 'gift_box', 'product_cat', $product->id ) ? true : false;
+		
+		array_push( $category_checks, $product_in_cat );
+	}
+    	
+	// get the position of checkout add-ons so we can remove them properly
+	$position = get_option( 'wc_checkout_add_ons_position', 'woocommerce_checkout_after_customer_details' );
+    	
+	// if all items are in this category, remove the checkout add-ons
+	if ( ! in_array( false, $category_checks ) && $position ) {
+		remove_action( $position, array( wc_checkout_add_ons()->frontend, 'render_add_ons' ), 20 );
+	}
+
+}
+add_action( 'woocommerce_before_checkout_form', 'sv_wc_checkout_add_ons_remove_add_ons_only_giftboxes' );

Diff for: woocommerce-checkout-add-ons/remove-add-ons-if-any-cart-item-in-category.php

@@ -0,0 +1,35 @@
+<?php
+/**
+ * Remove add-ons if _any product_ in the cart is in a given category
+ * Example: remove add-ons if any product is in the "Gift box" category
+ */
+function sv_wc_checkout_add_ons_remove_add_ons_for_giftboxes() {
+
+	// bail if Checkout Add-ons isn't active
+	if ( ! function_exists( 'wc_checkout_add_ons' ) ) {
+		return;
+	}
+	
+	// set a flag
+	$cat_check = false;
+		
+	// check each cart item for our category
+	foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
+        	
+		$product = $cart_item['data'];
+		$product_in_cat = false;
+	
+		// replace 'gift_box' with your category's slug
+		if ( has_term( 'gift_box', 'product_cat', $product->id ) ) {
+			// flag the cart as containing this category
+			$cat_check = true;
+		}
+	}
+    	
+	// if a product in the cart is in our category, remove the add-ons
+	if ( $cat_check ) {
+		remove_action( 'woocommerce_checkout_after_customer_details', array( wc_checkout_add_ons()->frontend, 'render_add_ons' ) );
+	}
+
+}
+add_action( 'woocommerce_before_checkout_form', 'sv_wc_checkout_add_ons_remove_add_ons_for_giftboxes' );

Diff for: woocommerce-customer-order-csv-export/add-item-meta-to-order-export.php

@@ -0,0 +1,55 @@
+<?php
+/**
+ * Add line item meta to the Order CSV Export in Default format
+ * Example: add weight to the item meta data
+ */
+
+
+/**
+ * Add weight to line item data
+ * 
+ * @param array $line_item the original line item data
+ * @param array $item the item's order data
+ * @param object $product the \WC_Product object for the line
+ * @param object $order the \WC_Order object being exported
+ * @return array the updated line item data
+ */
+function sv_wc_csv_export_add_weight_to_line_item( $line_item, $item, $product, $order ) {
+
+	$line_item['weight'] = $product->get_weight();
+	return $line_item;
+
+}
+add_filter( 'wc_customer_order_csv_export_order_line_item', 'sv_wc_csv_export_add_weight_to_line_item', 10, 4 );
+
+
+/**
+ * Add weight as line item meta in CSV export CSV Import format
+ *
+ * @param array $order_data the original order data
+ * @param object $order the WC_Order object exported
+ * @return array the updated order data
+ */
+function sv_wc_csv_export_add_weight_to_csv_export_import_format( $order_data, $order ) {
+	
+	$count = 1;
+	
+	// add line items
+	foreach ( $order->get_items() as $item ) {
+	
+		$product = $order->get_product_from_item( $item );
+	
+		if ( ! is_object( $product ) ) {
+			$product = new WC_Product( 0 );
+		}
+	
+		if ( $weight = $product->get_weight() ) {
+			$order_data[ "order_item_{$count}" ] .= '|weight: ' . $weight;
+		}
+	
+		$count++;
+	}
+	
+	return $order_data;
+}
+add_filter( 'wc_customer_order_csv_export_order_row', 'sv_wc_csv_export_add_weight_to_csv_export_import_format', 20, 2 );

Diff for: woocommerce-customer-order-csv-export/add-item-price-to-order-export.php

@@ -0,0 +1,61 @@
+<?php
+/**
+ * Show the product price in the Default - One Row per Item order export format
+ * Adds a column for item price
+ */
+
+
+/**
+ * Add the product price to the individual line item entry
+ *
+ * @param array      $line_item    the original line item data
+ * @param array      $item         WC order item data
+ * @param WC_Product $product      the product
+ * @return array updated line item data
+ */
+function sv_wc_csv_export_order_line_item_price( $line_item, $item, $product ) {
+
+	$line_item['price'] = $product->get_price();
+
+	return $line_item;
+}
+add_filter( 'wc_customer_order_csv_export_order_line_item', 'sv_wc_csv_export_order_line_item_price', 10, 3 );
+
+
+/**
+ * Add `item_price` column to the Default - One Row per Item export format
+ *
+ * @param array  $column_headers the original column headers
+ * @param WC_Customer_Order_CSV_Export_Generator $csv_generator the generator instance
+ * @return array the updated column headers
+ */
+function sv_wc_csv_export_modify_column_headers_item_price( $column_headers, $csv_generator ) {
+
+	if ( 'default_one_row_per_item' === $csv_generator->order_format ) {
+
+		$new_headers = array(
+			'item_price' => 'item_price',
+		);
+
+		$column_headers = array_merge( $column_headers, $new_headers );
+	}
+
+	return $column_headers;
+}
+add_filter( 'wc_customer_order_csv_export_order_headers', 'sv_wc_csv_export_modify_column_headers_item_price', 10, 2 );
+
+
+/**
+ * Add the item_price column data for the Default - One Row per Item format
+ *
+ * @param array $order_data the original order data
+ * @param array $item       the item for this row
+ * @return array the updated order data
+ */
+function sv_wc_csv_export_order_row_one_row_per_item_price( $order_data, $item ) {
+
+	$order_data['item_price'] = $item['price'];
+
+	return $order_data;
+}
+add_filter( 'wc_customer_order_csv_export_order_row_one_row_per_item', 'sv_wc_csv_export_order_row_one_row_per_item_price', 10, 2 );