|
1 | 1 | <?php
|
2 | 2 | /*
|
3 |
| -Plugin Name: WC API Custom Metafields |
4 |
| -Plugin URI: https://github.com/academe/TBC |
5 |
| -Description: Allows custom meta fields to be added to products when creating or updating. |
6 |
| -Version: 0.5.1 |
| 3 | +Plugin Name: WC API Custom Meta |
| 4 | +Plugin URI: hhttps://github.com/judgej/wc-api-custom-meta |
| 5 | +Description: Allows access to custom meta fields on products through the API. |
| 6 | +Version: 0.6.0 |
7 | 7 | Author: Jason Judge
|
8 | 8 | Author URI: http://academe.co.uk
|
9 | 9 | */
|
10 | 10 |
|
11 |
| -// Want to hook into woocommerce_api_process_product_meta_{product_type} for all product types. |
12 |
| - |
13 |
| -add_action('woocommerce_api_process_product_meta_simple', 'academe_wc_api_custom_meta', 10, 2); |
14 |
| -add_action('woocommerce_api_process_product_meta_variable', 'academe_wc_api_custom_meta', 10, 2); |
15 |
| -add_action('woocommerce_api_process_product_grouped', 'academe_wc_api_custom_meta', 10, 2); |
16 |
| -add_action('woocommerce_api_process_product_external', 'academe_wc_api_custom_meta', 10, 2); |
| 11 | +/** |
| 12 | + * Everything is static at present. |
| 13 | + * We may go singletone route in the future if there is some state |
| 14 | + * to handle, for example if the list of protected fields can be |
| 15 | + * modified - perhaps through a filter hook - at the start. |
| 16 | + */ |
| 17 | + |
| 18 | +class Academe_Wc_Api_Custom_Meta |
| 19 | +{ |
| 20 | + // Meta fields we want to protect, due to them being already handled |
| 21 | + // by the WC API. |
| 22 | + // To view or change these fields, go through the appropriate API. |
| 23 | + |
| 24 | + protected static $protected_fields = array( |
| 25 | + // A few WP internal fields should not be exposed. |
| 26 | + '_edit_lock', |
| 27 | + '_edit_last', |
| 28 | + // All these meta fields are already present in the |
| 29 | + // product_data in some form. |
| 30 | + '_visibility', |
| 31 | + '_stock_status', |
| 32 | + 'total_sales', |
| 33 | + '_downloadable', |
| 34 | + '_virtual', |
| 35 | + '_regular_price', |
| 36 | + '_sale_price', |
| 37 | + '_purchase_note', |
| 38 | + '_featured', |
| 39 | + '_weight', |
| 40 | + '_length', |
| 41 | + '_width', |
| 42 | + '_height', |
| 43 | + '_sku', |
| 44 | + '_product_attributes', |
| 45 | + '_price', |
| 46 | + '_sold_individually', |
| 47 | + '_manage_stock', |
| 48 | + '_backorders', |
| 49 | + '_stock', |
| 50 | + '_upsell_ids', |
| 51 | + '_crosssell_ids', |
| 52 | + '_product_image_gallery', |
| 53 | + '_sale_price_dates_from', |
| 54 | + '_sale_price_dates_to', |
| 55 | + ); |
| 56 | + |
| 57 | + protected static $product_type = array( |
| 58 | + 'meta_simple', |
| 59 | + 'meta_variable', |
| 60 | + 'grouped', |
| 61 | + 'external', |
| 62 | + ); |
| 63 | + |
| 64 | + /** |
| 65 | + * Initialise the hooks at plugin initialisation. |
| 66 | + */ |
| 67 | + public static function initialize() |
| 68 | + { |
| 69 | + // GET product: add in meta field to results. |
| 70 | + add_filter( |
| 71 | + 'woocommerce_api_product_response', |
| 72 | + array('Academe_Wc_Api_Custom_Meta', 'fetchCustomMeta'), |
| 73 | + 10, |
| 74 | + 4 |
| 75 | + ); |
17 | 76 |
|
18 |
| -function academe_wc_api_custom_meta($id, $data) { |
19 |
| - if (!empty($data['custom_meta']) && is_array($data['custom_meta'])) { |
20 |
| - foreach($data['custom_meta'] as $field_name => $field_value) { |
21 |
| - update_post_meta($id, $field_name, wc_clean($field_value)); |
| 77 | + // Want to hook into woocommerce_api_process_product_meta_{product_type} for all product types. |
| 78 | + foreach(static::$product_type as $product_type) { |
| 79 | + add_action( |
| 80 | + 'woocommerce_api_process_product_' . $product_type, |
| 81 | + array('Academe_Wc_Api_Custom_Meta', 'updateCustomMeta'), |
| 82 | + 10, |
| 83 | + 2 |
| 84 | + ); |
22 | 85 | }
|
23 | 86 | }
|
24 | 87 |
|
25 |
| - if (!empty($data['custom_meta']) && is_array($data['remove_custom_meta'])) { |
26 |
| - foreach($data['remove_custom_meta'] as $key => $value) { |
27 |
| - // If the key is numeric, then assume $value is the field name |
28 |
| - // and all entries need to be deleted. Otherwise is is a specfic value |
29 |
| - // of a named meta field that should be removed. |
| 88 | + /** |
| 89 | + * Fetch a product. |
| 90 | + */ |
| 91 | + public static function fetchCustomMeta($product_data, $product, $fields, $server) { |
| 92 | + // The admin and shop manager will have the capability "manage_woocommerce". |
| 93 | + // We only want users with this capability to see additional product meta fields. |
30 | 94 |
|
31 |
| - if (is_numeric($key)) { |
32 |
| - delete_post_meta($id, $value); |
33 |
| - } else { |
34 |
| - delete_post_meta($id, $key, $value); |
35 |
| - } |
36 |
| - } |
37 |
| - } |
38 |
| -} |
| 95 | + if (current_user_can('manage_woocommerce')) { |
| 96 | + $product_id = $product->id; |
39 | 97 |
|
| 98 | + $all_meta = get_post_meta($product_id); |
40 | 99 |
|
41 |
| -// GET product through the API |
42 |
| -add_filter('woocommerce_api_product_response', 'academe_wc_api_get_meta', 10, 4); |
43 |
| - |
44 |
| -function academe_wc_api_get_meta($product_data, $product, $fields, $server) { |
45 |
| - // The admin and shop manager will have the capability "manage_woocommerce". |
46 |
| - // We only want users with this capability to see additional product meta fields. |
47 |
| - |
48 |
| - if (current_user_can('manage_woocommerce')) { |
49 |
| - $product_id = $product->id; |
50 |
| - |
51 |
| - // Meta fields we don't want, due to them being already in the data. |
52 |
| - $exclude = array( |
53 |
| - // A few WP internal fields should not be exposed. |
54 |
| - "_edit_lock", |
55 |
| - "_edit_last", |
56 |
| - // All these meta fields are already present in the product_data in some form. |
57 |
| - "_visibility", |
58 |
| - "_stock_status", |
59 |
| - "total_sales", |
60 |
| - "_downloadable", |
61 |
| - "_virtual", |
62 |
| - "_regular_price", |
63 |
| - "_sale_price", |
64 |
| - "_purchase_note", |
65 |
| - "_featured", |
66 |
| - "_weight", |
67 |
| - "_length", |
68 |
| - "_width", |
69 |
| - "_height", |
70 |
| - "_sku", |
71 |
| - "_product_attributes", |
72 |
| - "_price", |
73 |
| - "_sold_individually", |
74 |
| - "_manage_stock", |
75 |
| - "_backorders", |
76 |
| - "_stock", |
77 |
| - "_upsell_ids", |
78 |
| - "_crosssell_ids", |
79 |
| - "_product_image_gallery", |
80 |
| - // The sale dates are actually not directly in the normal data returned. |
81 |
| - "_sale_price_dates_from", |
82 |
| - "_sale_price_dates_to", |
83 |
| - ); |
| 100 | + // Filter out meta we don't want. |
| 101 | + $all_meta = array_diff_key($all_meta, array_flip(static::$protected_fields)); |
84 | 102 |
|
85 |
| - $all_meta = get_post_meta($product_id); |
| 103 | + // Unserialize the meta field data where necessary. |
| 104 | + foreach($all_meta as $key => &$value) { |
| 105 | + $value = maybe_unserialize(reset($value)); |
| 106 | + } |
| 107 | + unset($value); |
86 | 108 |
|
87 |
| - // Filter out meta we don't want. |
88 |
| - $all_meta = array_diff_key($all_meta, array_flip($exclude)); |
| 109 | + $meta = array($all_meta); |
89 | 110 |
|
90 |
| - // Unserialize the meta field data where necessary. |
91 |
| - foreach($all_meta as $key => &$value) { |
92 |
| - $value = maybe_unserialize(reset($value)); |
| 111 | + $product_data['meta'] = $meta; |
93 | 112 | }
|
94 |
| - unset($value); |
95 | 113 |
|
96 |
| - $meta = array($all_meta); |
97 |
| - |
98 |
| - $product_data['meta'] = $meta; |
| 114 | + return $product_data; |
99 | 115 | }
|
100 | 116 |
|
101 |
| - return $product_data; |
| 117 | + /** |
| 118 | + * Update or create a product. |
| 119 | + */ |
| 120 | + public static function updateCustomMeta($id, $data) { |
| 121 | + // Create or update fields. |
| 122 | + if (!empty($data['custom_meta']) && is_array($data['custom_meta'])) { |
| 123 | + // Filter out protected fields. |
| 124 | + $custom_meta = array_diff_key( |
| 125 | + $data['custom_meta'], |
| 126 | + array_flip(static::$protected_fields) |
| 127 | + ); |
| 128 | + |
| 129 | + foreach($custom_meta as $field_name => $field_value) { |
| 130 | + update_post_meta($id, $field_name, wc_clean($field_value)); |
| 131 | + } |
| 132 | + } |
| 133 | + |
| 134 | + // Remove meta fields. |
| 135 | + if (!empty($data['remove_custom_meta']) && is_array($data['remove_custom_meta'])) { |
| 136 | + // Filter out protected fields. |
| 137 | + $remove_custom_meta = array_diff( |
| 138 | + $data['remove_custom_meta'], |
| 139 | + static::$protected_fields |
| 140 | + ); |
| 141 | + |
| 142 | + foreach($remove_custom_meta as $key => $value) { |
| 143 | + // If the key is numeric, then assume $value is the field name |
| 144 | + // and all entries need to be deleted. Otherwise is is a specfic value |
| 145 | + // of a named meta field that should be removed. |
| 146 | + |
| 147 | + if (is_numeric($key)) { |
| 148 | + delete_post_meta($id, $value); |
| 149 | + } else { |
| 150 | + delete_post_meta($id, $key, $value); |
| 151 | + } |
| 152 | + } |
| 153 | + } |
| 154 | + } |
102 | 155 | }
|
| 156 | + |
| 157 | +Academe_Wc_Api_Custom_Meta::initialize(); |
0 commit comments