AI
1 year ago
Agentic
7 months ago
AbstractAddressSchema.php
1 year ago
AbstractSchema.php
1 month ago
BatchSchema.php
2 years ago
BillingAddressSchema.php
2 years ago
CartCouponSchema.php
1 year ago
CartExtensionsSchema.php
1 year ago
CartFeeSchema.php
2 years ago
CartItemSchema.php
1 month ago
CartSchema.php
2 months ago
CartShippingRateSchema.php
1 month ago
CheckoutOrderSchema.php
2 years ago
CheckoutSchema.php
1 month ago
ErrorSchema.php
2 years ago
ImageAttachmentSchema.php
3 months ago
ItemSchema.php
11 months ago
OrderCouponSchema.php
2 years ago
OrderFeeSchema.php
2 years ago
OrderItemSchema.php
1 month ago
OrderSchema.php
2 months ago
PatternsSchema.php
1 year ago
ProductAttributeSchema.php
2 years ago
ProductAttributeTermSchema.php
1 month ago
ProductBrandSchema.php
1 year ago
ProductCategorySchema.php
2 years ago
ProductCollectionDataSchema.php
11 months ago
ProductReviewSchema.php
2 years ago
ProductSchema.php
1 month ago
ShippingAddressSchema.php
2 years ago
ShopperListItemSchema.php
1 month ago
ShopperListSchema.php
1 month ago
TermSchema.php
2 years ago
ItemSchema.php
325 lines
| 1 | <?php |
| 2 | declare( strict_types=1 ); |
| 3 | |
| 4 | namespace Automattic\WooCommerce\StoreApi\Schemas\V1; |
| 5 | |
| 6 | /** |
| 7 | * ItemSchema class. |
| 8 | */ |
| 9 | abstract class ItemSchema extends ProductSchema { |
| 10 | |
| 11 | /** |
| 12 | * Item schema properties. |
| 13 | * |
| 14 | * @return array |
| 15 | */ |
| 16 | public function get_properties() { |
| 17 | return [ |
| 18 | 'key' => [ |
| 19 | 'description' => __( 'Unique identifier for the item.', 'woocommerce' ), |
| 20 | 'type' => 'string', |
| 21 | 'context' => [ 'view', 'edit' ], |
| 22 | 'readonly' => true, |
| 23 | ], |
| 24 | 'type' => [ |
| 25 | 'description' => __( 'The item type.', 'woocommerce' ), |
| 26 | 'type' => 'string', |
| 27 | 'context' => [ 'view', 'edit' ], |
| 28 | 'readonly' => true, |
| 29 | ], |
| 30 | 'id' => [ |
| 31 | 'description' => __( 'The item product or variation ID.', 'woocommerce' ), |
| 32 | 'type' => 'integer', |
| 33 | 'context' => [ 'view', 'edit' ], |
| 34 | 'readonly' => true, |
| 35 | ], |
| 36 | 'quantity' => [ |
| 37 | 'description' => __( 'Quantity of this item.', 'woocommerce' ), |
| 38 | 'type' => 'number', |
| 39 | 'context' => [ 'view', 'edit' ], |
| 40 | 'readonly' => true, |
| 41 | ], |
| 42 | 'quantity_limits' => [ |
| 43 | 'description' => __( 'How the quantity of this item should be controlled, for example, any limits in place.', 'woocommerce' ), |
| 44 | 'type' => 'object', |
| 45 | 'context' => [ 'view', 'edit' ], |
| 46 | 'readonly' => true, |
| 47 | 'properties' => [ |
| 48 | 'minimum' => [ |
| 49 | 'description' => __( 'The minimum quantity allowed for this line item.', 'woocommerce' ), |
| 50 | 'type' => 'number', |
| 51 | 'context' => [ 'view', 'edit' ], |
| 52 | 'readonly' => true, |
| 53 | ], |
| 54 | 'maximum' => [ |
| 55 | 'description' => __( 'The maximum quantity allowed for this line item.', 'woocommerce' ), |
| 56 | 'type' => 'number', |
| 57 | 'context' => [ 'view', 'edit' ], |
| 58 | 'readonly' => true, |
| 59 | ], |
| 60 | 'multiple_of' => [ |
| 61 | 'description' => __( 'The amount that quantities increment by. Quantity must be an multiple of this value.', 'woocommerce' ), |
| 62 | 'type' => 'number', |
| 63 | 'context' => [ 'view', 'edit' ], |
| 64 | 'readonly' => true, |
| 65 | 'default' => 1, |
| 66 | ], |
| 67 | 'editable' => [ |
| 68 | 'description' => __( 'If the quantity is editable or fixed.', 'woocommerce' ), |
| 69 | 'type' => 'boolean', |
| 70 | 'context' => [ 'view', 'edit' ], |
| 71 | 'readonly' => true, |
| 72 | 'default' => true, |
| 73 | ], |
| 74 | ], |
| 75 | ], |
| 76 | 'name' => [ |
| 77 | 'description' => __( 'Product name.', 'woocommerce' ), |
| 78 | 'type' => 'string', |
| 79 | 'context' => [ 'view', 'edit' ], |
| 80 | 'readonly' => true, |
| 81 | ], |
| 82 | 'short_description' => [ |
| 83 | 'description' => __( 'Product short description in HTML format.', 'woocommerce' ), |
| 84 | 'type' => 'string', |
| 85 | 'context' => [ 'view', 'edit' ], |
| 86 | 'readonly' => true, |
| 87 | ], |
| 88 | 'description' => [ |
| 89 | 'description' => __( 'Product full description in HTML format.', 'woocommerce' ), |
| 90 | 'type' => 'string', |
| 91 | 'context' => [ 'view', 'edit' ], |
| 92 | 'readonly' => true, |
| 93 | ], |
| 94 | 'sku' => [ |
| 95 | 'description' => __( 'Stock keeping unit, if applicable.', 'woocommerce' ), |
| 96 | 'type' => 'string', |
| 97 | 'context' => [ 'view', 'edit' ], |
| 98 | 'readonly' => true, |
| 99 | ], |
| 100 | 'low_stock_remaining' => [ |
| 101 | 'description' => __( 'Quantity left in stock if stock is low, or null if not applicable.', 'woocommerce' ), |
| 102 | 'type' => [ 'number', 'null' ], |
| 103 | 'context' => [ 'view', 'edit' ], |
| 104 | 'readonly' => true, |
| 105 | ], |
| 106 | 'backorders_allowed' => [ |
| 107 | 'description' => __( 'True if backorders are allowed past stock availability.', 'woocommerce' ), |
| 108 | 'type' => [ 'boolean' ], |
| 109 | 'context' => [ 'view', 'edit' ], |
| 110 | 'readonly' => true, |
| 111 | ], |
| 112 | 'show_backorder_badge' => [ |
| 113 | 'description' => __( 'True if the product is on backorder.', 'woocommerce' ), |
| 114 | 'type' => [ 'boolean' ], |
| 115 | 'context' => [ 'view', 'edit' ], |
| 116 | 'readonly' => true, |
| 117 | ], |
| 118 | 'sold_individually' => [ |
| 119 | 'description' => __( 'If true, only one item of this product is allowed for purchase in a single order.', 'woocommerce' ), |
| 120 | 'type' => 'boolean', |
| 121 | 'context' => [ 'view', 'edit' ], |
| 122 | 'readonly' => true, |
| 123 | ], |
| 124 | 'permalink' => [ |
| 125 | 'description' => __( 'Product URL.', 'woocommerce' ), |
| 126 | 'type' => 'string', |
| 127 | 'format' => 'uri', |
| 128 | 'context' => [ 'view', 'edit' ], |
| 129 | 'readonly' => true, |
| 130 | ], |
| 131 | 'images' => [ |
| 132 | 'description' => __( 'List of images.', 'woocommerce' ), |
| 133 | 'type' => 'array', |
| 134 | 'context' => [ 'view', 'edit' ], |
| 135 | 'readonly' => true, |
| 136 | 'items' => [ |
| 137 | 'type' => 'object', |
| 138 | 'properties' => $this->image_attachment_schema->get_properties(), |
| 139 | ], |
| 140 | ], |
| 141 | 'variation' => [ |
| 142 | 'description' => __( 'Chosen attributes (for variations).', 'woocommerce' ), |
| 143 | 'type' => 'array', |
| 144 | 'context' => [ 'view', 'edit' ], |
| 145 | 'readonly' => true, |
| 146 | 'items' => [ |
| 147 | 'type' => 'object', |
| 148 | 'properties' => [ |
| 149 | 'raw_attribute' => [ |
| 150 | 'description' => __( 'Variation system generated attribute name.', 'woocommerce' ), |
| 151 | 'type' => 'string', |
| 152 | 'context' => array( 'view', 'edit' ), |
| 153 | 'readonly' => true, |
| 154 | ], |
| 155 | 'attribute' => [ |
| 156 | 'description' => __( 'Variation attribute name.', 'woocommerce' ), |
| 157 | 'type' => 'string', |
| 158 | 'context' => [ 'view', 'edit' ], |
| 159 | 'readonly' => true, |
| 160 | ], |
| 161 | 'value' => [ |
| 162 | 'description' => __( 'Variation attribute value.', 'woocommerce' ), |
| 163 | 'type' => 'string', |
| 164 | 'context' => [ 'view', 'edit' ], |
| 165 | 'readonly' => true, |
| 166 | ], |
| 167 | ], |
| 168 | ], |
| 169 | ], |
| 170 | 'item_data' => [ |
| 171 | 'description' => __( 'Metadata related to the item', 'woocommerce' ), |
| 172 | 'type' => 'array', |
| 173 | 'context' => [ 'view', 'edit' ], |
| 174 | 'readonly' => true, |
| 175 | 'items' => [ |
| 176 | 'type' => 'object', |
| 177 | 'properties' => [ |
| 178 | 'name' => [ |
| 179 | 'description' => __( 'Name of the metadata.', 'woocommerce' ), |
| 180 | 'type' => 'string', |
| 181 | 'context' => [ 'view', 'edit' ], |
| 182 | 'readonly' => true, |
| 183 | ], |
| 184 | 'value' => [ |
| 185 | 'description' => __( 'Value of the metadata.', 'woocommerce' ), |
| 186 | 'type' => 'string', |
| 187 | 'context' => [ 'view', 'edit' ], |
| 188 | 'readonly' => true, |
| 189 | ], |
| 190 | 'display' => [ |
| 191 | 'description' => __( 'Optionally, how the metadata value should be displayed to the user.', 'woocommerce' ), |
| 192 | 'type' => 'string', |
| 193 | 'context' => [ 'view', 'edit' ], |
| 194 | 'readonly' => true, |
| 195 | ], |
| 196 | ], |
| 197 | ], |
| 198 | ], |
| 199 | 'prices' => [ |
| 200 | 'description' => __( 'Price data for the product in the current line item, including or excluding taxes based on the "display prices during cart and checkout" setting. Provided using the smallest unit of the currency.', 'woocommerce' ), |
| 201 | 'type' => 'object', |
| 202 | 'context' => [ 'view', 'edit' ], |
| 203 | 'readonly' => true, |
| 204 | 'properties' => array_merge( |
| 205 | $this->get_store_currency_properties(), |
| 206 | [ |
| 207 | 'price' => [ |
| 208 | 'description' => __( 'Current product price.', 'woocommerce' ), |
| 209 | 'type' => 'string', |
| 210 | 'context' => [ 'view', 'edit' ], |
| 211 | 'readonly' => true, |
| 212 | ], |
| 213 | 'regular_price' => [ |
| 214 | 'description' => __( 'Regular product price.', 'woocommerce' ), |
| 215 | 'type' => 'string', |
| 216 | 'context' => [ 'view', 'edit' ], |
| 217 | 'readonly' => true, |
| 218 | ], |
| 219 | 'sale_price' => [ |
| 220 | 'description' => __( 'Sale product price, if applicable.', 'woocommerce' ), |
| 221 | 'type' => 'string', |
| 222 | 'context' => [ 'view', 'edit' ], |
| 223 | 'readonly' => true, |
| 224 | ], |
| 225 | 'price_range' => [ |
| 226 | 'description' => __( 'Price range, if applicable.', 'woocommerce' ), |
| 227 | 'type' => [ 'object', 'null' ], |
| 228 | 'context' => [ 'view', 'edit' ], |
| 229 | 'readonly' => true, |
| 230 | 'properties' => [ |
| 231 | 'min_amount' => [ |
| 232 | 'description' => __( 'Price amount.', 'woocommerce' ), |
| 233 | 'type' => 'string', |
| 234 | 'context' => [ 'view', 'edit' ], |
| 235 | 'readonly' => true, |
| 236 | ], |
| 237 | 'max_amount' => [ |
| 238 | 'description' => __( 'Price amount.', 'woocommerce' ), |
| 239 | 'type' => 'string', |
| 240 | 'context' => [ 'view', 'edit' ], |
| 241 | 'readonly' => true, |
| 242 | ], |
| 243 | ], |
| 244 | ], |
| 245 | 'raw_prices' => [ |
| 246 | 'description' => __( 'Raw unrounded product prices used in calculations. Provided using a higher unit of precision than the currency.', 'woocommerce' ), |
| 247 | 'type' => [ 'object', 'null' ], |
| 248 | 'context' => [ 'view', 'edit' ], |
| 249 | 'readonly' => true, |
| 250 | 'properties' => [ |
| 251 | 'precision' => [ |
| 252 | 'description' => __( 'Decimal precision of the returned prices.', 'woocommerce' ), |
| 253 | 'type' => 'integer', |
| 254 | 'context' => [ 'view', 'edit' ], |
| 255 | 'readonly' => true, |
| 256 | ], |
| 257 | 'price' => [ |
| 258 | 'description' => __( 'Current product price.', 'woocommerce' ), |
| 259 | 'type' => 'string', |
| 260 | 'context' => [ 'view', 'edit' ], |
| 261 | 'readonly' => true, |
| 262 | ], |
| 263 | 'regular_price' => [ |
| 264 | 'description' => __( 'Regular product price.', 'woocommerce' ), |
| 265 | 'type' => 'string', |
| 266 | 'context' => [ 'view', 'edit' ], |
| 267 | 'readonly' => true, |
| 268 | ], |
| 269 | 'sale_price' => [ |
| 270 | 'description' => __( 'Sale product price, if applicable.', 'woocommerce' ), |
| 271 | 'type' => 'string', |
| 272 | 'context' => [ 'view', 'edit' ], |
| 273 | 'readonly' => true, |
| 274 | ], |
| 275 | ], |
| 276 | ], |
| 277 | ] |
| 278 | ), |
| 279 | ], |
| 280 | 'totals' => [ |
| 281 | 'description' => __( 'Item total amounts provided using the smallest unit of the currency.', 'woocommerce' ), |
| 282 | 'type' => 'object', |
| 283 | 'context' => [ 'view', 'edit' ], |
| 284 | 'readonly' => true, |
| 285 | 'properties' => array_merge( |
| 286 | $this->get_store_currency_properties(), |
| 287 | [ |
| 288 | 'line_subtotal' => [ |
| 289 | 'description' => __( 'Line subtotal (the price of the product before coupon discounts have been applied).', 'woocommerce' ), |
| 290 | 'type' => 'string', |
| 291 | 'context' => [ 'view', 'edit' ], |
| 292 | 'readonly' => true, |
| 293 | ], |
| 294 | 'line_subtotal_tax' => [ |
| 295 | 'description' => __( 'Line subtotal tax.', 'woocommerce' ), |
| 296 | 'type' => 'string', |
| 297 | 'context' => [ 'view', 'edit' ], |
| 298 | 'readonly' => true, |
| 299 | ], |
| 300 | 'line_total' => [ |
| 301 | 'description' => __( 'Line total (the price of the product after coupon discounts have been applied).', 'woocommerce' ), |
| 302 | 'type' => 'string', |
| 303 | 'context' => [ 'view', 'edit' ], |
| 304 | 'readonly' => true, |
| 305 | ], |
| 306 | 'line_total_tax' => [ |
| 307 | 'description' => __( 'Line total tax.', 'woocommerce' ), |
| 308 | 'type' => 'string', |
| 309 | 'context' => [ 'view', 'edit' ], |
| 310 | 'readonly' => true, |
| 311 | ], |
| 312 | ] |
| 313 | ), |
| 314 | ], |
| 315 | 'catalog_visibility' => [ |
| 316 | 'description' => __( 'Whether the product is visible in the catalog', 'woocommerce' ), |
| 317 | 'type' => 'string', |
| 318 | 'context' => [ 'view', 'edit' ], |
| 319 | 'readonly' => true, |
| 320 | ], |
| 321 | self::EXTENDING_KEY => $this->get_extended_schema( self::IDENTIFIER ), |
| 322 | ]; |
| 323 | } |
| 324 | } |
| 325 |