fluentcart-developer 3.0.0 → 3.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (612) hide show
  1. package/LICENSE.md +26 -26
  2. package/README.md +59 -59
  3. package/dist/cards/fluentcart/templates-native.js +1087 -1087
  4. package/dist/cards/fluentcart/tools.js +2309 -2309
  5. package/dist/server.d.ts.map +1 -1
  6. package/dist/server.js +37 -1
  7. package/dist/server.js.map +1 -1
  8. package/dist/skills/fluentcart-developer/SKILL.md +108 -108
  9. package/dist/skills/fluentcart-developer/examples/README.md +30 -30
  10. package/dist/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/fluent-cart/checkout.php +32 -32
  11. package/dist/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/functions.php +40 -40
  12. package/dist/skills/fluentcart-developer/examples/sample-custom-addon/fluentcart-custom-addon.php +113 -113
  13. package/dist/skills/fluentcart-developer/examples/sample-custom-payment-gateway/fluentcart-custom-gateway-example.php +148 -148
  14. package/dist/skills/fluentcart-developer/examples/sample-fee-surcharge-plugin/fluentcart-fee-surcharge.php +38 -38
  15. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/README.md +22 -22
  16. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/sample-plugin-with-licensing-sdk.php +79 -79
  17. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/updater/FluentLicensing.php +303 -303
  18. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/updater/LicenseSettings.php +566 -566
  19. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/updater/PluginUpdater.php +304 -304
  20. package/dist/skills/fluentcart-developer/examples/sample-shipping-carrier/fluentcart-custom-shipping-carrier.php +61 -61
  21. package/dist/skills/fluentcart-developer/references/api/authentication.md +452 -452
  22. package/dist/skills/fluentcart-developer/references/api/coupons.md +786 -786
  23. package/dist/skills/fluentcart-developer/references/api/customers.md +889 -889
  24. package/dist/skills/fluentcart-developer/references/api/files.md +609 -609
  25. package/dist/skills/fluentcart-developer/references/api/index.md +432 -432
  26. package/dist/skills/fluentcart-developer/references/api/licensing.md +633 -633
  27. package/dist/skills/fluentcart-developer/references/api/order-bump.md +384 -384
  28. package/dist/skills/fluentcart-developer/references/api/orders.md +814 -814
  29. package/dist/skills/fluentcart-developer/references/api/products.md +866 -866
  30. package/dist/skills/fluentcart-developer/references/api/roles-permissions.md +536 -536
  31. package/dist/skills/fluentcart-developer/references/api/subscriptions.md +827 -827
  32. package/dist/skills/fluentcart-developer/references/database/index.md +44 -44
  33. package/dist/skills/fluentcart-developer/references/database/models/activity.md +178 -178
  34. package/dist/skills/fluentcart-developer/references/database/models/applied-coupon.md +291 -291
  35. package/dist/skills/fluentcart-developer/references/database/models/attribute-group.md +239 -239
  36. package/dist/skills/fluentcart-developer/references/database/models/attribute-relation.md +181 -181
  37. package/dist/skills/fluentcart-developer/references/database/models/attribute-term.md +219 -219
  38. package/dist/skills/fluentcart-developer/references/database/models/cart.md +645 -645
  39. package/dist/skills/fluentcart-developer/references/database/models/coupon.md +427 -427
  40. package/dist/skills/fluentcart-developer/references/database/models/customer-addresses.md +348 -348
  41. package/dist/skills/fluentcart-developer/references/database/models/customer-meta.md +156 -156
  42. package/dist/skills/fluentcart-developer/references/database/models/customer.md +584 -584
  43. package/dist/skills/fluentcart-developer/references/database/models/dynamic-model.md +163 -163
  44. package/dist/skills/fluentcart-developer/references/database/models/label-relationship.md +155 -155
  45. package/dist/skills/fluentcart-developer/references/database/models/label.md +153 -153
  46. package/dist/skills/fluentcart-developer/references/database/models/license-activation.md +182 -182
  47. package/dist/skills/fluentcart-developer/references/database/models/license-meta.md +163 -163
  48. package/dist/skills/fluentcart-developer/references/database/models/license-site.md +208 -208
  49. package/dist/skills/fluentcart-developer/references/database/models/license.md +640 -640
  50. package/dist/skills/fluentcart-developer/references/database/models/meta.md +233 -233
  51. package/dist/skills/fluentcart-developer/references/database/models/order-address.md +391 -391
  52. package/dist/skills/fluentcart-developer/references/database/models/order-download-permission.md +144 -144
  53. package/dist/skills/fluentcart-developer/references/database/models/order-item.md +383 -383
  54. package/dist/skills/fluentcart-developer/references/database/models/order-meta.md +303 -303
  55. package/dist/skills/fluentcart-developer/references/database/models/order-operation.md +158 -158
  56. package/dist/skills/fluentcart-developer/references/database/models/order-promotion-stat.md +175 -175
  57. package/dist/skills/fluentcart-developer/references/database/models/order-promotion.md +250 -250
  58. package/dist/skills/fluentcart-developer/references/database/models/order-tax-rate.md +172 -172
  59. package/dist/skills/fluentcart-developer/references/database/models/order-transaction.md +440 -440
  60. package/dist/skills/fluentcart-developer/references/database/models/order.md +727 -727
  61. package/dist/skills/fluentcart-developer/references/database/models/product-detail.md +397 -397
  62. package/dist/skills/fluentcart-developer/references/database/models/product-download.md +258 -258
  63. package/dist/skills/fluentcart-developer/references/database/models/product-meta.md +153 -153
  64. package/dist/skills/fluentcart-developer/references/database/models/product-variation.md +556 -556
  65. package/dist/skills/fluentcart-developer/references/database/models/product.md +580 -580
  66. package/dist/skills/fluentcart-developer/references/database/models/relationships.md +427 -427
  67. package/dist/skills/fluentcart-developer/references/database/models/scheduled-action.md +175 -175
  68. package/dist/skills/fluentcart-developer/references/database/models/shipping-class.md +148 -148
  69. package/dist/skills/fluentcart-developer/references/database/models/shipping-method.md +280 -280
  70. package/dist/skills/fluentcart-developer/references/database/models/shipping-zone.md +205 -205
  71. package/dist/skills/fluentcart-developer/references/database/models/subscription-meta.md +173 -173
  72. package/dist/skills/fluentcart-developer/references/database/models/subscription.md +528 -528
  73. package/dist/skills/fluentcart-developer/references/database/models/tax-class.md +195 -195
  74. package/dist/skills/fluentcart-developer/references/database/models/tax-rate.md +225 -225
  75. package/dist/skills/fluentcart-developer/references/database/models/user-meta.md +166 -166
  76. package/dist/skills/fluentcart-developer/references/database/models/user.md +220 -220
  77. package/dist/skills/fluentcart-developer/references/database/models.md +404 -404
  78. package/dist/skills/fluentcart-developer/references/database/query-builder.md +860 -860
  79. package/dist/skills/fluentcart-developer/references/database/readme.md +276 -276
  80. package/dist/skills/fluentcart-developer/references/database/schema.md +1002 -1002
  81. package/dist/skills/fluentcart-developer/references/engineering/adding-custom-pages-to-the-customer-dashboard.md +395 -395
  82. package/dist/skills/fluentcart-developer/references/engineering/index.md +4 -4
  83. package/dist/skills/fluentcart-developer/references/engineering.md +4 -4
  84. package/dist/skills/fluentcart-developer/references/getting-started.md +249 -249
  85. package/dist/skills/fluentcart-developer/references/guides/frontend.md +519 -519
  86. package/dist/skills/fluentcart-developer/references/guides/index.md +107 -107
  87. package/dist/skills/fluentcart-developer/references/guides/integrations.md +600 -600
  88. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/index.md +237 -237
  89. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/labels-and-tracking.md +481 -481
  90. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/live-rates.md +269 -269
  91. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/reference.md +223 -223
  92. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/settings.md +370 -370
  93. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier.md +237 -237
  94. package/dist/skills/fluentcart-developer/references/guides/subscriptions.md +217 -217
  95. package/dist/skills/fluentcart-developer/references/hooks/actions/admin-and-templates.md +1079 -1079
  96. package/dist/skills/fluentcart-developer/references/hooks/actions/cart-and-checkout.md +1795 -1795
  97. package/dist/skills/fluentcart-developer/references/hooks/actions/customers-and-users.md +327 -327
  98. package/dist/skills/fluentcart-developer/references/hooks/actions/licenses.md +829 -829
  99. package/dist/skills/fluentcart-developer/references/hooks/actions/modules.md +81 -81
  100. package/dist/skills/fluentcart-developer/references/hooks/actions/orders.md +757 -757
  101. package/dist/skills/fluentcart-developer/references/hooks/actions/payments-and-integrations.md +1163 -1163
  102. package/dist/skills/fluentcart-developer/references/hooks/actions/pro-modules.md +219 -219
  103. package/dist/skills/fluentcart-developer/references/hooks/actions/products-and-coupons.md +1019 -1019
  104. package/dist/skills/fluentcart-developer/references/hooks/actions/subscriptions.md +1290 -1290
  105. package/dist/skills/fluentcart-developer/references/hooks/actions.md +16 -16
  106. package/dist/skills/fluentcart-developer/references/hooks/deprecated.md +60 -60
  107. package/dist/skills/fluentcart-developer/references/hooks/filters/cart-and-checkout.md +2032 -2032
  108. package/dist/skills/fluentcart-developer/references/hooks/filters/customers-and-subscriptions.md +1746 -1746
  109. package/dist/skills/fluentcart-developer/references/hooks/filters/integrations-and-advanced.md +2439 -2439
  110. package/dist/skills/fluentcart-developer/references/hooks/filters/modules.md +464 -464
  111. package/dist/skills/fluentcart-developer/references/hooks/filters/orders-and-payments.md +2658 -2658
  112. package/dist/skills/fluentcart-developer/references/hooks/filters/pro-modules.md +502 -502
  113. package/dist/skills/fluentcart-developer/references/hooks/filters/products-and-pricing.md +1785 -1785
  114. package/dist/skills/fluentcart-developer/references/hooks/filters/settings-and-configuration.md +2966 -2966
  115. package/dist/skills/fluentcart-developer/references/hooks/filters.md +14 -14
  116. package/dist/skills/fluentcart-developer/references/hooks/index.md +35 -35
  117. package/dist/skills/fluentcart-developer/references/index.md +625 -625
  118. package/dist/skills/fluentcart-developer/references/modules/fee-system.md +427 -427
  119. package/dist/skills/fluentcart-developer/references/modules/ghost-product-selling.md +440 -440
  120. package/dist/skills/fluentcart-developer/references/modules/index.md +484 -484
  121. package/dist/skills/fluentcart-developer/references/modules/licensing.md +342 -342
  122. package/dist/skills/fluentcart-developer/references/modules/order-bump.md +433 -433
  123. package/dist/skills/fluentcart-developer/references/modules/payment-methods.md +129 -129
  124. package/dist/skills/fluentcart-developer/references/modules/refunds.md +170 -170
  125. package/dist/skills/fluentcart-developer/references/modules/shipping.md +846 -846
  126. package/dist/skills/fluentcart-developer/references/modules/storage.md +986 -986
  127. package/dist/skills/fluentcart-developer/references/modules/subscription-vendor-ids.md +186 -186
  128. package/dist/skills/fluentcart-developer/references/modules/subscriptions.md +678 -678
  129. package/dist/skills/fluentcart-developer/references/payment-methods-integration/index.md +164 -164
  130. package/dist/skills/fluentcart-developer/references/payment-methods-integration/paddle-example.md +1648 -1648
  131. package/dist/skills/fluentcart-developer/references/payment-methods-integration/payment/setting/fields.md +353 -353
  132. package/dist/skills/fluentcart-developer/references/payment-methods-integration/quick-implementation.md +1079 -1079
  133. package/dist/skills/fluentcart-developer/references/payment-methods-integration.md +164 -164
  134. package/dist/skills/fluentcart-developer/references/restapi/checkout.md +573 -573
  135. package/dist/skills/fluentcart-developer/references/restapi/coupons.md +958 -958
  136. package/dist/skills/fluentcart-developer/references/restapi/customer-profile.md +1423 -1423
  137. package/dist/skills/fluentcart-developer/references/restapi/customers.md +1103 -1103
  138. package/dist/skills/fluentcart-developer/references/restapi/dashboard.md +1083 -1083
  139. package/dist/skills/fluentcart-developer/references/restapi/data-export.md +132 -132
  140. package/dist/skills/fluentcart-developer/references/restapi/email-notifications.md +846 -846
  141. package/dist/skills/fluentcart-developer/references/restapi/files.md +313 -313
  142. package/dist/skills/fluentcart-developer/references/restapi/index.md +127 -127
  143. package/dist/skills/fluentcart-developer/references/restapi/integrations.md +1000 -1000
  144. package/dist/skills/fluentcart-developer/references/restapi/inventory.md +192 -192
  145. package/dist/skills/fluentcart-developer/references/restapi/labels-and-attributes.md +797 -797
  146. package/dist/skills/fluentcart-developer/references/restapi/licensing.md +1733 -1733
  147. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-available-shipping-methods.md +30 -30
  148. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-checkout-summary.md +28 -28
  149. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-country-info.md +29 -29
  150. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-order-info.md +28 -28
  151. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-shipping-methods-list-view.md +30 -30
  152. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/login.md +66 -66
  153. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/place-order.md +179 -179
  154. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/apply-coupon.md +83 -83
  155. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/cancel-coupon.md +87 -87
  156. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/check-product-eligibility.md +59 -59
  157. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/create-coupon.md +230 -230
  158. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/delete-coupon.md +29 -29
  159. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon-settings.md +20 -20
  160. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon.md +27 -27
  161. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupon-codes.md +20 -20
  162. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupons.md +37 -37
  163. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/re-apply-coupons.md +75 -75
  164. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/store-coupon-settings.md +40 -40
  165. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/update-coupon.md +133 -133
  166. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-address-checkout.md +138 -138
  167. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-profile-address.md +119 -119
  168. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/dashboard-overview.md +22 -22
  169. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/delete-profile-address.md +46 -46
  170. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-order-details.md +30 -30
  171. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-portal-sections.md +29 -29
  172. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-profile-details.md +22 -22
  173. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-transaction-billing-address.md +30 -30
  174. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-upgrade-paths.md +31 -31
  175. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-downloads.md +29 -29
  176. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-orders.md +28 -28
  177. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/make-profile-address-primary.md +55 -55
  178. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/pause-subscription.md +29 -29
  179. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/resume-subscription.md +29 -29
  180. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/save-transaction-billing-address.md +92 -92
  181. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/select-address-for-checkout.md +32 -32
  182. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-address.md +115 -115
  183. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-details.md +69 -69
  184. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/attach-user.md +50 -50
  185. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/bulk-actions.md +65 -65
  186. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-address.md +135 -135
  187. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-customer.md +108 -108
  188. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/delete-address.md +62 -62
  189. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/detach-user.md +28 -28
  190. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/find-customer-order.md +27 -27
  191. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-attachable-users.md +20 -20
  192. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-addresses.md +28 -28
  193. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-orders.md +37 -37
  194. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-stats.md +27 -27
  195. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer.md +32 -32
  196. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/list-customers.md +37 -37
  197. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/recalculate-ltv.md +28 -28
  198. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/set-primary-address.md +72 -72
  199. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-additional-info.md +55 -55
  200. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-address.md +144 -144
  201. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-customer.md +123 -123
  202. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/attach-note-to-order.md +49 -49
  203. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-all-pages.md +21 -21
  204. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-single-page.md +55 -55
  205. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/delete-activity.md +28 -28
  206. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-country-info.md +29 -29
  207. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-dashboard-stats.md +22 -22
  208. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-filter-options.md +31 -31
  209. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-data.md +20 -20
  210. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-settings.md +20 -20
  211. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-print-templates.md +20 -20
  212. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-search-options.md +27 -27
  213. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-widgets.md +28 -28
  214. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/initialize-app.md +20 -20
  215. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-activities.md +33 -33
  216. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-attachments.md +21 -21
  217. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-countries.md +20 -20
  218. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/mark-activity-read.md +53 -53
  219. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/run-data-backfills.md +21 -21
  220. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-settings.md +54 -54
  221. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-tax-settings.md +73 -73
  222. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-print-templates.md +64 -64
  223. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/upload-attachment.md +42 -42
  224. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-customers-batch.md +129 -129
  225. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-licenses-batch.md +133 -133
  226. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-orders-batch.md +129 -129
  227. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-subscriptions-batch.md +129 -129
  228. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-customers-export-schema.md +21 -21
  229. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-licenses-export-schema.md +26 -26
  230. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-orders-export-schema.md +21 -21
  231. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-subscriptions-export-schema.md +21 -21
  232. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/enable-notification.md +57 -57
  233. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-digest-settings.md +22 -22
  234. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-notification.md +30 -30
  235. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-reminders.md +22 -22
  236. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-settings.md +22 -22
  237. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-shortcodes.md +22 -22
  238. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/list-notifications.md +20 -20
  239. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-default-template.md +66 -66
  240. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-notification.md +50 -50
  241. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-digest-settings.md +101 -101
  242. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-reminders.md +162 -162
  243. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-settings.md +99 -99
  244. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-digest-test.md +47 -47
  245. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-manual-reminder.md +51 -51
  246. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/update-notification.md +93 -93
  247. package/dist/skills/fluentcart-developer/references/restapi/operations/files/delete-file.md +31 -31
  248. package/dist/skills/fluentcart-developer/references/restapi/operations/files/get-bucket-list.md +28 -28
  249. package/dist/skills/fluentcart-developer/references/restapi/operations/files/list-files.md +30 -30
  250. package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-editor-file.md +32 -32
  251. package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-file.md +34 -34
  252. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/chained-data-request.md +46 -46
  253. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/change-feed-status.md +51 -51
  254. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/delete-feed.md +27 -27
  255. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-dynamic-options.md +29 -29
  256. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-lists.md +27 -27
  257. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-settings.md +27 -27
  258. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-feeds.md +20 -20
  259. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-settings.md +26 -26
  260. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/install-addon-plugin.md +49 -49
  261. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/list-addons.md +20 -20
  262. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/save-feed-settings.md +52 -52
  263. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/set-global-settings.md +50 -50
  264. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/bulk-update-stock.md +94 -94
  265. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/export-inventory.md +81 -81
  266. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-adjustment-history.md +26 -26
  267. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-inventory-stats.md +21 -21
  268. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/list-inventory.md +33 -33
  269. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/update-stock.md +75 -75
  270. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-attribute-group.md +31 -31
  271. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-label.md +31 -31
  272. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-terms.md +90 -90
  273. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-group.md +28 -28
  274. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-term.md +29 -29
  275. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-group.md +28 -28
  276. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-library.md +20 -20
  277. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-groups.md +32 -32
  278. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-terms.md +33 -33
  279. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-labels.md +20 -20
  280. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-groups.md +51 -51
  281. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-terms.md +56 -56
  282. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-group.md +37 -37
  283. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-term.md +39 -39
  284. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-label-selections.md +32 -32
  285. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-plugin-license.md +41 -41
  286. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-site-admin.md +60 -60
  287. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-plugin-license.md +18 -18
  288. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-admin.md +67 -67
  289. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-customer.md +47 -47
  290. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/delete-license.md +24 -24
  291. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/extend-license-validity.md +47 -47
  292. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-license-details.md +25 -25
  293. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-licenses-admin.md +26 -26
  294. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-activations.md +25 -25
  295. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-details.md +25 -25
  296. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-site.md +30 -30
  297. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-plugin-license-status.md +18 -18
  298. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-product-license-settings.md +24 -24
  299. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-customer-licenses.md +25 -25
  300. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-license-sites.md +33 -33
  301. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-licenses.md +38 -38
  302. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-activate-license.md +54 -54
  303. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-check-license.md +26 -26
  304. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-deactivate-license.md +46 -46
  305. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-download-license-package.md +23 -23
  306. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-get-license-version.md +26 -26
  307. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/regenerate-license-key.md +24 -24
  308. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/save-product-license-settings.md +193 -193
  309. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-activation-limit.md +53 -53
  310. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-status.md +52 -52
  311. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/create-order-bump.md +47 -47
  312. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/delete-order-bump.md +25 -25
  313. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/get-order-bump.md +25 -25
  314. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/list-order-bumps.md +29 -29
  315. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/update-order-bump.md +141 -141
  316. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/accept-dispute.md +47 -47
  317. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/bulk-actions.md +72 -72
  318. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-shipping.md +67 -67
  319. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-tax.md +98 -98
  320. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/change-customer.md +50 -50
  321. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/charge-now.md +29 -29
  322. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-and-change-customer.md +92 -92
  323. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-custom-order-item.md +68 -68
  324. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-order.md +351 -351
  325. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-renewal-now.md +29 -29
  326. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/delete-order.md +28 -28
  327. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/generate-missing-licenses.md +29 -29
  328. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order-transactions.md +27 -27
  329. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order.md +27 -27
  330. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-renewal.md +28 -28
  331. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-shipping-methods.md +28 -28
  332. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-single-transaction.md +28 -28
  333. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-order-currencies.md +22 -22
  334. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-orders.md +42 -42
  335. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-renewals.md +28 -28
  336. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/mark-as-paid.md +61 -61
  337. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/price-order.md +135 -135
  338. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/refund-order.md +72 -72
  339. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/resend-renewal-invoice.md +29 -29
  340. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/skip-renewal.md +48 -48
  341. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-order-statuses.md +28 -28
  342. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-pending-transaction.md +29 -29
  343. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address-id.md +60 -60
  344. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address.md +98 -98
  345. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order.md +172 -172
  346. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-statuses.md +77 -77
  347. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-subscription-details.md +84 -84
  348. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-transaction-status.md +51 -51
  349. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/void-renewal.md +30 -30
  350. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/create-pdf-template.md +42 -42
  351. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/delete-pdf-template.md +26 -26
  352. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/download-pdf-preview.md +44 -44
  353. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-factory-default-templates.md +19 -19
  354. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-status.md +21 -21
  355. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-template.md +26 -26
  356. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-saved-templates.md +21 -21
  357. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-seller-details.md +19 -19
  358. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/list-pdf-templates.md +19 -19
  359. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-pdf-template.md +53 -53
  360. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-seller-details.md +97 -97
  361. package/dist/skills/fluentcart-developer/references/restapi/operations/products/add-product-terms.md +64 -64
  362. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-edit-fetch.md +30 -30
  363. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-insert-products.md +62 -62
  364. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-products.md +59 -59
  365. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-variants.md +83 -83
  366. package/dist/skills/fluentcart-developer/references/restapi/operations/products/change-integration-status.md +64 -64
  367. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-dummy-products.md +45 -45
  368. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-product.md +81 -81
  369. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-variation.md +181 -181
  370. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-downloadable-file.md +27 -27
  371. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product-integration.md +30 -30
  372. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product.md +27 -27
  373. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-taxonomy-term.md +55 -55
  374. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-upgrade-path.md +27 -27
  375. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-variation.md +27 -27
  376. package/dist/skills/fluentcart-developer/references/restapi/operations/products/do-bulk-action.md +56 -56
  377. package/dist/skills/fluentcart-developer/references/restapi/operations/products/duplicate-product.md +56 -56
  378. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-products-by-ids.md +26 -26
  379. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-taxonomy-terms.md +20 -20
  380. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-terms-by-parent.md +60 -60
  381. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-variations-by-ids.md +26 -26
  382. package/dist/skills/fluentcart-developer/references/restapi/operations/products/find-subscription-variants.md +26 -26
  383. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-bundle-info.md +27 -27
  384. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-downloadable-url.md +27 -27
  385. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-max-excerpt-word-count.md +20 -20
  386. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-pricing-widgets.md +27 -27
  387. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-feeds.md +29 -29
  388. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-settings.md +31 -31
  389. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-pricing.md +28 -28
  390. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product.md +28 -28
  391. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-related-products.md +31 -31
  392. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-upgrade-settings.md +27 -27
  393. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-variation-upgrade-paths.md +28 -28
  394. package/dist/skills/fluentcart-developer/references/restapi/operations/products/group-bulk-update-variants.md +103 -103
  395. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-all-variants.md +26 -26
  396. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-product-variations.md +26 -26
  397. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-products.md +34 -34
  398. package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-shipping-class.md +27 -27
  399. package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-tax-class.md +27 -27
  400. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-bundle-info.md +56 -56
  401. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-product-integration.md +62 -62
  402. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-upgrade-path.md +78 -78
  403. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-product-variant-options.md +29 -29
  404. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-products-by-name.md +28 -28
  405. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-variants-by-name.md +28 -28
  406. package/dist/skills/fluentcart-developer/references/restapi/operations/products/set-variation-media.md +74 -74
  407. package/dist/skills/fluentcart-developer/references/restapi/operations/products/suggest-sku.md +28 -28
  408. package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-downloadable-files.md +134 -134
  409. package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-taxonomy-terms.md +61 -61
  410. package/dist/skills/fluentcart-developer/references/restapi/operations/products/toggle-product-tax-exemption.md +56 -56
  411. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-downloadable-file.md +98 -98
  412. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-inventory.md +56 -56
  413. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-long-desc-editor-mode.md +49 -49
  414. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-manage-stock.md +53 -53
  415. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-detail.md +58 -58
  416. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-pricing.md +225 -225
  417. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-shipping-class.md +49 -49
  418. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-tax-class.md +49 -49
  419. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-upgrade-path.md +78 -78
  420. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-option.md +79 -79
  421. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-tax-exemption.md +56 -56
  422. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation-pricing-table.md +49 -49
  423. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation.md +105 -105
  424. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/get-product-views.md +34 -34
  425. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/list-products.md +42 -42
  426. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/search-products.md +30 -30
  427. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/channel-rules.md +24 -24
  428. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/country-heat-map.md +22 -22
  429. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupon-overview.md +37 -37
  430. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupons.md +36 -36
  431. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-insights.md +31 -31
  432. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-overview.md +36 -36
  433. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-repeat.md +35 -35
  434. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segment-customers.md +36 -36
  435. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segments.md +30 -30
  436. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-value.md +34 -34
  437. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/dashboard-stats.md +30 -30
  438. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/failed-orders.md +34 -34
  439. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-new-vs-returning-customer.md +34 -34
  440. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-by-day-and-hour.md +34 -34
  441. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-meta.md +29 -29
  442. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-top-sold-products.md +34 -34
  443. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/future-renewals.md +31 -31
  444. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/generate-retention-snapshots.md +24 -24
  445. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-overview.md +30 -30
  446. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-activities.md +26 -26
  447. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-orders.md +20 -20
  448. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-revenue.md +37 -37
  449. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-at-risk.md +35 -35
  450. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-variations.md +33 -33
  451. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments.md +33 -33
  452. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/item-count-distribution.md +34 -34
  453. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-chart.md +30 -30
  454. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-pie-chart.md +22 -22
  455. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-summary.md +22 -22
  456. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/locations.md +43 -43
  457. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-chart.md +37 -37
  458. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-completion-time.md +34 -34
  459. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-mix.md +34 -34
  460. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-value-distribution.md +34 -34
  461. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-disputes.md +38 -38
  462. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-methods.md +36 -36
  463. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods.md +37 -37
  464. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison-launch.md +33 -33
  465. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison.md +40 -40
  466. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-detail.md +37 -37
  467. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-sales.md +37 -37
  468. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/refunds-overview.md +37 -37
  469. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/retention-snapshots-step.md +45 -45
  470. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sales-growth-chart.md +35 -35
  471. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/save-channel-rules.md +73 -73
  472. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/source-channels.md +37 -37
  473. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sources.md +49 -49
  474. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-cohorts.md +33 -33
  475. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-health.md +30 -30
  476. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-rebuys.md +37 -37
  477. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-retention.md +34 -34
  478. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-variations.md +22 -22
  479. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscriptions-overview.md +37 -37
  480. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/weeks-between-refund.md +34 -34
  481. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/assign-role.md +48 -48
  482. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/delete-role-assignment.md +47 -47
  483. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/get-role.md +25 -25
  484. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-managers.md +18 -18
  485. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-roles.md +18 -18
  486. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/search-users.md +25 -25
  487. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/update-role.md +43 -43
  488. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/create-saved-view.md +106 -106
  489. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/delete-saved-view.md +26 -26
  490. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/list-saved-views.md +25 -25
  491. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/update-saved-view.md +83 -83
  492. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-payment-addon.md +44 -44
  493. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-plugin-addon.md +44 -44
  494. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/change-storage-driver-status.md +56 -56
  495. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/check-paypal-webhook.md +26 -26
  496. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/create-storage-bucket.md +63 -63
  497. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/disconnect-payment-method.md +55 -55
  498. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/exchange-paypal-seller-auth-token.md +62 -62
  499. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-active-storage-drivers.md +20 -20
  500. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-checkout-fields.md +22 -22
  501. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-email-shortcodes.md +20 -20
  502. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-config-snippets.md +26 -26
  503. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-status.md +20 -20
  504. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-module-settings.md +20 -20
  505. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-connection-info.md +26 -26
  506. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-settings.md +26 -26
  507. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-permissions.md +22 -22
  508. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-plugin-addons.md +20 -20
  509. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-storage-driver-settings.md +27 -27
  510. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-store-settings.md +26 -26
  511. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-mcp-adapter.md +21 -21
  512. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-payment-addon.md +60 -60
  513. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-plugin-addon.md +64 -64
  514. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-payment-methods.md +20 -20
  515. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-storage-drivers.md +20 -20
  516. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-storage-buckets.md +67 -67
  517. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reorder-payment-methods.md +55 -55
  518. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reset-storage-driver-settings.md +45 -45
  519. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-checkout-fields.md +133 -133
  520. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-confirmation-settings.md +68 -68
  521. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-module-settings.md +68 -68
  522. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-design.md +67 -67
  523. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-settings.md +58 -58
  524. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-permissions.md +68 -68
  525. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-storage-driver-settings.md +62 -62
  526. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-store-settings.md +239 -239
  527. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/setup-paypal-webhook.md +48 -48
  528. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/toggle-mcp.md +40 -40
  529. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-storage-driver-connection.md +62 -62
  530. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-turnstile-keys.md +55 -55
  531. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-class.md +73 -73
  532. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-method.md +110 -110
  533. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-zone.md +56 -56
  534. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-class.md +29 -29
  535. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-method.md +29 -29
  536. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-zone.md +29 -29
  537. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class-profile.md +30 -30
  538. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class.md +29 -29
  539. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-packages.md +22 -22
  540. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-zone.md +27 -27
  541. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-countries.md +22 -22
  542. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-states.md +28 -28
  543. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-classes.md +31 -31
  544. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-zones.md +31 -31
  545. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/save-shipping-packages.md +112 -112
  546. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-class.md +79 -79
  547. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-method.md +113 -113
  548. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-zone.md +62 -62
  549. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-zone-order.md +52 -52
  550. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-auto-renew.md +30 -30
  551. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-subscription.md +52 -52
  552. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/confirm-subscription-switch.md +70 -70
  553. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/fetch-subscription-remote.md +28 -28
  554. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/generate-early-payment-link.md +29 -29
  555. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-customer-subscription.md +27 -27
  556. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-or-create-plan.md +69 -69
  557. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-setup-intent-attempts.md +30 -30
  558. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-subscription.md +28 -28
  559. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/initiate-early-payment.md +31 -31
  560. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-customer-subscriptions.md +27 -27
  561. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-subscriptions.md +39 -39
  562. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/pause-subscription.md +28 -28
  563. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/reactivate-subscription.md +28 -28
  564. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/resume-subscription.md +28 -28
  565. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/switch-payment-method.md +70 -70
  566. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-payment-method.md +69 -69
  567. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-vendor-ids.md +56 -56
  568. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/verify-vendor-ids.md +56 -56
  569. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-class.md +51 -51
  570. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-rate.md +117 -117
  571. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-product-override.md +27 -27
  572. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-shipping-tax-override.md +27 -27
  573. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-class.md +28 -28
  574. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-rate.md +27 -27
  575. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-id.md +27 -27
  576. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-rates.md +28 -28
  577. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-eu-vat-product-overrides.md +20 -20
  578. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-oss-country-rates.md +20 -20
  579. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-preconfigured-tax-rates.md +20 -20
  580. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-product-overrides.md +27 -27
  581. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-tax-settings.md +20 -20
  582. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-all-tax-rates.md +20 -20
  583. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-classes.md +20 -20
  584. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-records.md +37 -37
  585. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/mark-taxes-as-filed.md +58 -58
  586. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/reset-eu-vat-rates.md +21 -21
  587. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-configured-countries.md +57 -57
  588. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-country-tax-id.md +50 -50
  589. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-eu-vat-cross-border-settings.md +127 -127
  590. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-oss-country-rates.md +100 -100
  591. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-product-override.md +110 -110
  592. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-shipping-tax-override.md +52 -52
  593. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-tax-settings.md +166 -166
  594. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-country-status.md +54 -54
  595. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-tax-rate.md +116 -116
  596. package/dist/skills/fluentcart-developer/references/restapi/order-bumps.md +433 -433
  597. package/dist/skills/fluentcart-developer/references/restapi/orders.md +1212 -1212
  598. package/dist/skills/fluentcart-developer/references/restapi/pdf-templates.md +212 -212
  599. package/dist/skills/fluentcart-developer/references/restapi/products.md +2485 -2485
  600. package/dist/skills/fluentcart-developer/references/restapi/public-shop.md +191 -191
  601. package/dist/skills/fluentcart-developer/references/restapi/reports.md +3773 -3773
  602. package/dist/skills/fluentcart-developer/references/restapi/roles.md +403 -403
  603. package/dist/skills/fluentcart-developer/references/restapi/saved-views.md +136 -136
  604. package/dist/skills/fluentcart-developer/references/restapi/settings.md +1423 -1423
  605. package/dist/skills/fluentcart-developer/references/restapi/shipping.md +905 -905
  606. package/dist/skills/fluentcart-developer/references/restapi/subscriptions.md +1169 -1169
  607. package/dist/skills/fluentcart-developer/references/restapi/tax.md +1551 -1551
  608. package/dist/skills/fluentcart-developer/references/restapi.md +127 -127
  609. package/dist/skills/fluentcart-developer/scripts/cli.js +1 -1
  610. package/dist/version.d.ts +1 -1
  611. package/dist/version.js +1 -1
  612. package/package.json +66 -65
@@ -1,427 +1,427 @@
1
- # Model Relationships
2
-
3
- FluentCart uses Eloquent ORM relationships to establish connections between different models. Understanding these relationships is crucial for efficient data querying and manipulation.
4
-
5
- ## Relationship Types
6
-
7
- FluentCart models use the following relationship types:
8
-
9
- - **One-to-One** - Each model has one related model
10
- - **One-to-Many** - One model has many related models
11
- - **Many-to-Many** - Models can have multiple related models
12
- - **Polymorphic** - Models can relate to multiple different model types
13
-
14
- ## Core Model Relationships
15
-
16
- ### Order Relationships
17
-
18
- The Order model is central to FluentCart and has the most relationships:
19
-
20
- ```
21
- $order = Order::find(1);
22
-
23
- $order->customer; // belongsTo Customer
24
- $order->order_items; // hasMany OrderItem
25
- $order->feeItems; // order_items filtered to payment_type = 'fee'
26
- $order->transactions; // hasMany OrderTransaction
27
- $order->orderMeta; // hasMany OrderMeta
28
- $order->subscriptions; // hasMany Subscription (parent_order_id)
29
- $order->billing_address; // hasOne OrderAddress where type = billing
30
- $order->activities; // morphMany Activity, via the HasActivity trait
31
- ```
32
-
33
- #### Order Model Relationships
34
-
35
- | Relationship | Type | Related Model | Foreign Key | Local Key |
36
- | --- | --- | --- | --- | --- |
37
- | customer | belongsTo | Customer | customer_id | id |
38
- | order_items | hasMany | OrderItem | order_id | id |
39
- | filteredOrderItems | hasMany | OrderItem | order_id | id |
40
- | feeItems | hasMany | OrderItem | order_id | id |
41
- | transactions | hasMany | OrderTransaction | order_id | id |
42
- | orderMeta | hasMany | OrderMeta | order_id | id |
43
- | orderTaxRates | hasMany | OrderTaxRate | order_id | id |
44
- | appliedCoupons | hasMany | AppliedCoupon | order_id | id |
45
- | usedCoupons | hasManyThrough | Coupon via AppliedCoupon | order_id | id |
46
- | subscriptions | hasMany | Subscription | parent_order_id | id |
47
- | parentOrder | belongsTo | Order | parent_id | id |
48
- | children | hasMany | Order | parent_id | id |
49
- | shipments | hasMany | Shipment | order_id | id |
50
- | order_addresses | hasMany | OrderAddress | order_id | id |
51
- | billing_address | hasOne | OrderAddress (type = billing) | order_id | id |
52
- | shipping_address | hasOne | OrderAddress (type = shipping) | order_id | id |
53
- | orderOperation | hasOne | OrderOperation | order_id | id |
54
- | licenses | hasMany | License (Pro) | order_id | id |
55
- | labels | morphMany | LabelRelationship | labelable | — |
56
- | activities | morphMany | Activity (`module`) | module_id | id |
57
-
58
- `feeItems` is `order_items()` narrowed to `payment_type = 'fee'`, so it is a relation you can eager-load and constrain like any other.
59
-
60
- `parentOrder` and `children` link orders to each other through `parent_id`. A subscription's renewal invoices hang off the subscription's `parent_order_id` instead, which is what `subscriptions` resolves.
61
-
62
- ### Customer Relationships
63
-
64
- ```
65
- $customer = Customer::find(1);
66
-
67
- $customer->orders; // hasMany Order
68
- $customer->subscriptions; // hasMany Subscription
69
- $customer->primary_billing_address; // hasOne CustomerAddresses where type = billing
70
- $customer->wpUser; // belongsTo the WordPress user, when linked
71
- ```
72
-
73
- #### Customer Model Relationships
74
-
75
- | Relationship | Type | Related Model | Foreign Key | Local Key |
76
- | --- | --- | --- | --- | --- |
77
- | orders | hasMany | Order | customer_id | id |
78
- | subscriptions | hasMany | Subscription | customer_id | id |
79
- | success_order_items | hasManyThrough | OrderItem via Order | customer_id / order_id | id |
80
- | billing_address | hasMany | CustomerAddresses (type = billing) | customer_id | id |
81
- | shipping_address | hasMany | CustomerAddresses (type = shipping) | customer_id | id |
82
- | primary_billing_address | hasOne | CustomerAddresses (type = billing) | customer_id | id |
83
- | primary_shipping_address | hasOne | CustomerAddresses (type = shipping) | customer_id | id |
84
- | wpUser | belongsTo | User (`wp_users`) | user_id | ID |
85
- | labels | morphMany | LabelRelationship | labelable | — |
86
-
87
- `wpUser` selects a fixed column list, so `user_pass` and `user_activation_key` never load. Customer carries no cart or licence relation — query `Cart` by `customer_id` and `License` by `customer_id` directly.
88
-
89
- ### Product Relationships
90
-
91
- A product is a WordPress post, so its relations key off `ID`, not `product_id`:
92
-
93
- ```
94
- $product = Product::find(1);
95
-
96
- $product->detail; // hasOne ProductDetail
97
- $product->variants; // hasMany ProductVariation
98
- $product->reviews; // approved, top-level reviews
99
- $product->downloadable_files; // hasMany ProductDownload
100
- ```
101
-
102
- #### Product Model Relationships
103
-
104
- | Relationship | Type | Related Model | Foreign Key | Local Key |
105
- | --- | --- | --- | --- | --- |
106
- | detail | hasOne | ProductDetail | post_id | ID |
107
- | variants | hasMany | ProductVariation | post_id | ID |
108
- | orderItems | hasMany | OrderItem | post_id | ID |
109
- | downloadable_files | hasMany | ProductDownload | post_id | ID |
110
- | reviews | hasMany | ProductReview (approved, top-level) | post_id | ID |
111
- | integrations | hasMany | ProductMeta (object_type = product_integration) | object_id | ID |
112
- | licensesMeta | hasOne | ProductMeta (meta_key = license_settings) | object_id | ID |
113
- | postmeta | hasOne | PostMeta (gallery image) | post_id | ID |
114
- | wp_terms | hasMany | TermRelationship | object_id | ID |
115
- | wpTerms | hasManyThrough | TermTaxonomy via TermRelationship | object_id | ID |
116
-
117
- Categories and tags come through the term relations rather than a `belongsToMany`. There is no `variations` relation — it is `variants` — and no licence relation on Product.
118
-
119
- ### Subscription Relationships
120
-
121
- ```
122
- $subscription = Subscription::find(1);
123
-
124
- $subscription->order; // belongsTo the parent Order
125
- $subscription->customer; // belongsTo Customer
126
- $subscription->transactions; // hasMany OrderTransaction
127
- $subscription->meta; // hasMany SubscriptionMeta
128
- ```
129
-
130
- #### Subscription Model Relationships
131
-
132
- | Relationship | Type | Related Model | Foreign Key | Local Key |
133
- | --- | --- | --- | --- | --- |
134
- | order | belongsTo | Order | parent_order_id | id |
135
- | customer | belongsTo | Customer | customer_id | id |
136
- | product | belongsTo | Product | product_id | ID |
137
- | variation | belongsTo | ProductVariation | variation_id | id |
138
- | transactions | hasMany | OrderTransaction | subscription_id | id |
139
- | meta | hasMany | SubscriptionMeta | subscription_id | id |
140
- | billing_addresses | hasMany | CustomerAddresses | customer_id | customer_id |
141
- | license | hasOne | License (Pro) | subscription_id | id |
142
- | licenses | hasMany | License (Pro) | subscription_id | id |
143
- | labels | morphMany | LabelRelationship | labelable | — |
144
- | activities | morphMany | Activity (`module`) | module_id | id |
145
-
146
- A subscription points **up** to the order that created it through `parent_order_id`. Its renewal invoices are orders in their own right — reach them from the parent order's `children`, or query `Order` by `type = 'renewal'`.
147
-
148
- `license` and `licenses` are guarded by `class_exists(License::class)` and return `null` when FluentCart Pro is not active, so check before chaining:
149
-
150
- ```
151
- $relation = $subscription->licenses();
152
- $licenses = $relation ? $relation->get() : collect();
153
- ```
154
-
155
- ## Pro Plugin Relationships
156
-
157
- ### License Relationships (Pro)
158
-
159
- Licenses have relationships with multiple entities:
160
-
161
- ```
162
- // License belongs to one Customer
163
- $license = License::find(1);
164
- $customer = $license->customer;
165
-
166
- // License belongs to one Product
167
- $product = $license->product;
168
-
169
- // License belongs to one Order
170
- $order = $license->order;
171
-
172
- // License belongs to one Subscription (optional)
173
- $subscription = $license->subscription;
174
-
175
- // License has many Activations
176
- $activations = $license->activations;
177
-
178
- // The variation it was issued for
179
- $variation = $license->variation;
180
- ```
181
-
182
- #### License Model Relationships
183
-
184
- | Relationship | Type | Related Model | Foreign Key | Local Key |
185
- | --- | --- | --- | --- | --- |
186
- | customer | belongsTo | Customer | customer_id | id |
187
- | product | belongsTo | Product | product_id | ID |
188
- | order | belongsTo | Order | order_id | id |
189
- | subscription | belongsTo | Subscription | subscription_id | id |
190
- | activations | hasMany | LicenseActivation | license_id | id |
191
- | variation | belongsTo | ProductVariation | variation_id | id |
192
- | productVariant | belongsTo | ProductVariation | variation_id | id |
193
- | labels | morphMany | LabelRelationship | labelable | — |
194
-
195
- Licence metadata lives in `fct_license_meta`, keyed by `object_id` and `object_type`; query `LicenseMeta` directly. Activation sites are reached through `activations` — `fct_license_sites` holds no `license_id` of its own. | meta | hasMany | LicenseMeta | license_id | id | | transactions | hasMany | LicenseTransaction | license_id | id |
196
-
197
- ## Relationship Usage Examples
198
-
199
- ### Eager Loading
200
-
201
- Prevent N+1 queries by eager loading relationships:
202
-
203
- ```
204
- // Load orders with their customers and items
205
- $orders = Order::with(['customer', 'items', 'transactions'])->get();
206
-
207
- // Load customers with their orders and subscriptions
208
- $customers = Customer::with(['orders', 'subscriptions'])->get();
209
-
210
- // Load products with their variations
211
- $products = Product::with(['variants'])->get();
212
- ```
213
-
214
- ### Querying with Relationships
215
-
216
- Use relationships in queries:
217
-
218
- ```
219
- // Get orders for customers with specific email
220
- $orders = Order::whereHas('customer', function($query) {
221
- $query->where('email', '[email protected]');
222
- })->get();
223
-
224
- // Get customers who have active subscriptions
225
- $customers = Customer::whereHas('subscriptions', function($query) {
226
- $query->where('status', 'active');
227
- })->get();
228
-
229
- // Get products that have been ordered
230
- $products = Product::whereHas('orderItems')->get();
231
- ```
232
-
233
- ### Filtering by Relationship Data
234
-
235
- ```
236
- // Get orders with total greater than $100
237
- $orders = Order::whereHas('items', function($query) {
238
- $query->where('line_total', '>', 10000);
239
- })->get();
240
-
241
- // Get customers with orders in specific date range
242
- $customers = Customer::whereHas('orders', function($query) {
243
- $query->whereBetween('created_at', ['2024-01-01', '2024-01-31']);
244
- })->get();
245
- ```
246
-
247
- ### Counting Relationships
248
-
249
- ```
250
- // Get customers with order count
251
- $customers = Customer::withCount('orders')->get();
252
-
253
- // Get products with order item count
254
- $products = Product::withCount('orderItems')->get();
255
-
256
- // Get orders with item count
257
- $orders = Order::withCount('items')->get();
258
- ```
259
-
260
- ### Complex Relationship Queries
261
-
262
- ```
263
- // Get customers with their latest order
264
- $customers = Customer::with(['orders' => function($query) {
265
- $query->latest()->limit(1);
266
- }])->get();
267
-
268
- // Get orders with their customer's subscription status
269
- $orders = Order::with(['customer.subscriptions' => function($query) {
270
- $query->where('status', 'active');
271
- }])->get();
272
-
273
- // Get products with their most recent order
274
- $products = Product::with(['orderItems.order' => function($query) {
275
- $query->latest()->limit(1);
276
- }])->get();
277
- ```
278
-
279
- ## Relationship Best Practices
280
-
281
- ### 1. Use Eager Loading
282
-
283
- Always eager load relationships to prevent N+1 queries:
284
-
285
- ```
286
- // Bad - N+1 queries
287
- $orders = Order::all();
288
- foreach ($orders as $order) {
289
- echo $order->customer->full_name; // N+1 query
290
- }
291
-
292
- // Good - Eager loading
293
- $orders = Order::with('customer')->get();
294
- foreach ($orders as $order) {
295
- echo $order->customer->full_name; // No additional queries
296
- }
297
- ```
298
-
299
- ### 2. Use Specific Columns
300
-
301
- Only load the columns you need:
302
-
303
- ```
304
- // Load only specific columns
305
- $orders = Order::with(['customer:id,first_name,last_name,email'])->get();
306
- ```
307
-
308
- ### 3. Use Constraints
309
-
310
- Apply constraints to relationships:
311
-
312
- ```
313
- // Load only active subscriptions
314
- $customers = Customer::with(['subscriptions' => function($query) {
315
- $query->where('status', 'active');
316
- }])->get();
317
- ```
318
-
319
- ### 4. Use Lazy Loading Wisely
320
-
321
- Lazy load when you don't always need the relationship:
322
-
323
- ```
324
- $order = Order::find(1);
325
-
326
- // Only load when needed
327
- if ($needCustomer) {
328
- $customer = $order->customer;
329
- }
330
- ```
331
-
332
- ### 5. Use Relationship Methods
333
-
334
- Use relationship methods for complex queries:
335
-
336
- ```
337
- // Get orders for specific customer
338
- $customer = Customer::find(1);
339
- $orders = $customer->orders()->where('status', 'completed')->get();
340
-
341
- // Get active subscriptions for customer
342
- $activeSubscriptions = $customer->subscriptions()
343
- ->where('status', 'active')
344
- ->get();
345
- ```
346
-
347
- ## Common Relationship Patterns
348
-
349
- ### 1. Parent-Child Relationships
350
-
351
- ```
352
- // Order -> Order Items
353
- $order = Order::find(1);
354
- $items = $order->order_items;
355
-
356
- // Customer -> Orders
357
- $customer = Customer::find(1);
358
- $orders = $customer->orders;
359
- ```
360
-
361
- ### 2. Many-to-Many Relationships
362
-
363
- ```
364
- // Product -> Categories
365
- $product = Product::find(1);
366
- $categories = $product->categories;
367
-
368
- // Customer -> Products (through orders)
369
- $customer = Customer::find(1);
370
- $products = $customer->orders()->with('items.product')->get();
371
- ```
372
-
373
- ### 3. Polymorphic Relationships
374
-
375
- Activity is polymorphic on `module`, so it stores `module_type` and `module_id`. Read it from the owning model, which the `HasActivity` trait provides on `Order`, `Subscription` and `Coupon`:
376
-
377
- ```
378
- $order->activities; // morphMany Activity
379
- $subscription->activities;
380
- $coupon->activities;
381
- ```
382
-
383
- Querying the table directly works too, with the real column names:
384
-
385
- ```
386
- $activities = Activity::where('module_type', Order::class)
387
- ->where('module_id', $order->id)
388
- ->get();
389
- ```
390
-
391
- ## Performance Considerations
392
-
393
- ### 1. Foreign key columns are already indexed
394
-
395
- The migrations index the columns these relations join on — `fct_orders.customer_id`, `fct_order_items.order_id`, `fct_subscriptions.customer_id` and the rest — so there is no `ALTER TABLE` to run before eager-loading performs well. See [Database Schema](/database/schema.md) for each table's index list.
396
-
397
- ### 2. Use Query Scopes
398
-
399
- Create scopes for common relationship queries:
400
-
401
- ```
402
- // In Order model
403
- public function scopeWithCustomer($query) {
404
- return $query->with('customer');
405
- }
406
-
407
- public function scopeWithItems($query) {
408
- return $query->with('order_items');
409
- }
410
-
411
- // Usage
412
- $orders = Order::withCustomer()->withItems()->get();
413
- ```
414
-
415
- ### 3. Cache Relationship Data
416
-
417
- Cache frequently accessed relationship data:
418
-
419
- ```
420
- // Cache customer orders
421
- $customer = Customer::find(1);
422
- $orders = Cache::remember("customer_{$customer->id}_orders", 3600, function() use ($customer) {
423
- return $customer->orders()->with('order_items')->get();
424
- });
425
- ```
426
-
427
- ---
1
+ # Model Relationships
2
+
3
+ FluentCart uses Eloquent ORM relationships to establish connections between different models. Understanding these relationships is crucial for efficient data querying and manipulation.
4
+
5
+ ## Relationship Types
6
+
7
+ FluentCart models use the following relationship types:
8
+
9
+ - **One-to-One** - Each model has one related model
10
+ - **One-to-Many** - One model has many related models
11
+ - **Many-to-Many** - Models can have multiple related models
12
+ - **Polymorphic** - Models can relate to multiple different model types
13
+
14
+ ## Core Model Relationships
15
+
16
+ ### Order Relationships
17
+
18
+ The Order model is central to FluentCart and has the most relationships:
19
+
20
+ ```
21
+ $order = Order::find(1);
22
+
23
+ $order->customer; // belongsTo Customer
24
+ $order->order_items; // hasMany OrderItem
25
+ $order->feeItems; // order_items filtered to payment_type = 'fee'
26
+ $order->transactions; // hasMany OrderTransaction
27
+ $order->orderMeta; // hasMany OrderMeta
28
+ $order->subscriptions; // hasMany Subscription (parent_order_id)
29
+ $order->billing_address; // hasOne OrderAddress where type = billing
30
+ $order->activities; // morphMany Activity, via the HasActivity trait
31
+ ```
32
+
33
+ #### Order Model Relationships
34
+
35
+ | Relationship | Type | Related Model | Foreign Key | Local Key |
36
+ | --- | --- | --- | --- | --- |
37
+ | customer | belongsTo | Customer | customer_id | id |
38
+ | order_items | hasMany | OrderItem | order_id | id |
39
+ | filteredOrderItems | hasMany | OrderItem | order_id | id |
40
+ | feeItems | hasMany | OrderItem | order_id | id |
41
+ | transactions | hasMany | OrderTransaction | order_id | id |
42
+ | orderMeta | hasMany | OrderMeta | order_id | id |
43
+ | orderTaxRates | hasMany | OrderTaxRate | order_id | id |
44
+ | appliedCoupons | hasMany | AppliedCoupon | order_id | id |
45
+ | usedCoupons | hasManyThrough | Coupon via AppliedCoupon | order_id | id |
46
+ | subscriptions | hasMany | Subscription | parent_order_id | id |
47
+ | parentOrder | belongsTo | Order | parent_id | id |
48
+ | children | hasMany | Order | parent_id | id |
49
+ | shipments | hasMany | Shipment | order_id | id |
50
+ | order_addresses | hasMany | OrderAddress | order_id | id |
51
+ | billing_address | hasOne | OrderAddress (type = billing) | order_id | id |
52
+ | shipping_address | hasOne | OrderAddress (type = shipping) | order_id | id |
53
+ | orderOperation | hasOne | OrderOperation | order_id | id |
54
+ | licenses | hasMany | License (Pro) | order_id | id |
55
+ | labels | morphMany | LabelRelationship | labelable | — |
56
+ | activities | morphMany | Activity (`module`) | module_id | id |
57
+
58
+ `feeItems` is `order_items()` narrowed to `payment_type = 'fee'`, so it is a relation you can eager-load and constrain like any other.
59
+
60
+ `parentOrder` and `children` link orders to each other through `parent_id`. A subscription's renewal invoices hang off the subscription's `parent_order_id` instead, which is what `subscriptions` resolves.
61
+
62
+ ### Customer Relationships
63
+
64
+ ```
65
+ $customer = Customer::find(1);
66
+
67
+ $customer->orders; // hasMany Order
68
+ $customer->subscriptions; // hasMany Subscription
69
+ $customer->primary_billing_address; // hasOne CustomerAddresses where type = billing
70
+ $customer->wpUser; // belongsTo the WordPress user, when linked
71
+ ```
72
+
73
+ #### Customer Model Relationships
74
+
75
+ | Relationship | Type | Related Model | Foreign Key | Local Key |
76
+ | --- | --- | --- | --- | --- |
77
+ | orders | hasMany | Order | customer_id | id |
78
+ | subscriptions | hasMany | Subscription | customer_id | id |
79
+ | success_order_items | hasManyThrough | OrderItem via Order | customer_id / order_id | id |
80
+ | billing_address | hasMany | CustomerAddresses (type = billing) | customer_id | id |
81
+ | shipping_address | hasMany | CustomerAddresses (type = shipping) | customer_id | id |
82
+ | primary_billing_address | hasOne | CustomerAddresses (type = billing) | customer_id | id |
83
+ | primary_shipping_address | hasOne | CustomerAddresses (type = shipping) | customer_id | id |
84
+ | wpUser | belongsTo | User (`wp_users`) | user_id | ID |
85
+ | labels | morphMany | LabelRelationship | labelable | — |
86
+
87
+ `wpUser` selects a fixed column list, so `user_pass` and `user_activation_key` never load. Customer carries no cart or licence relation — query `Cart` by `customer_id` and `License` by `customer_id` directly.
88
+
89
+ ### Product Relationships
90
+
91
+ A product is a WordPress post, so its relations key off `ID`, not `product_id`:
92
+
93
+ ```
94
+ $product = Product::find(1);
95
+
96
+ $product->detail; // hasOne ProductDetail
97
+ $product->variants; // hasMany ProductVariation
98
+ $product->reviews; // approved, top-level reviews
99
+ $product->downloadable_files; // hasMany ProductDownload
100
+ ```
101
+
102
+ #### Product Model Relationships
103
+
104
+ | Relationship | Type | Related Model | Foreign Key | Local Key |
105
+ | --- | --- | --- | --- | --- |
106
+ | detail | hasOne | ProductDetail | post_id | ID |
107
+ | variants | hasMany | ProductVariation | post_id | ID |
108
+ | orderItems | hasMany | OrderItem | post_id | ID |
109
+ | downloadable_files | hasMany | ProductDownload | post_id | ID |
110
+ | reviews | hasMany | ProductReview (approved, top-level) | post_id | ID |
111
+ | integrations | hasMany | ProductMeta (object_type = product_integration) | object_id | ID |
112
+ | licensesMeta | hasOne | ProductMeta (meta_key = license_settings) | object_id | ID |
113
+ | postmeta | hasOne | PostMeta (gallery image) | post_id | ID |
114
+ | wp_terms | hasMany | TermRelationship | object_id | ID |
115
+ | wpTerms | hasManyThrough | TermTaxonomy via TermRelationship | object_id | ID |
116
+
117
+ Categories and tags come through the term relations rather than a `belongsToMany`. There is no `variations` relation — it is `variants` — and no licence relation on Product.
118
+
119
+ ### Subscription Relationships
120
+
121
+ ```
122
+ $subscription = Subscription::find(1);
123
+
124
+ $subscription->order; // belongsTo the parent Order
125
+ $subscription->customer; // belongsTo Customer
126
+ $subscription->transactions; // hasMany OrderTransaction
127
+ $subscription->meta; // hasMany SubscriptionMeta
128
+ ```
129
+
130
+ #### Subscription Model Relationships
131
+
132
+ | Relationship | Type | Related Model | Foreign Key | Local Key |
133
+ | --- | --- | --- | --- | --- |
134
+ | order | belongsTo | Order | parent_order_id | id |
135
+ | customer | belongsTo | Customer | customer_id | id |
136
+ | product | belongsTo | Product | product_id | ID |
137
+ | variation | belongsTo | ProductVariation | variation_id | id |
138
+ | transactions | hasMany | OrderTransaction | subscription_id | id |
139
+ | meta | hasMany | SubscriptionMeta | subscription_id | id |
140
+ | billing_addresses | hasMany | CustomerAddresses | customer_id | customer_id |
141
+ | license | hasOne | License (Pro) | subscription_id | id |
142
+ | licenses | hasMany | License (Pro) | subscription_id | id |
143
+ | labels | morphMany | LabelRelationship | labelable | — |
144
+ | activities | morphMany | Activity (`module`) | module_id | id |
145
+
146
+ A subscription points **up** to the order that created it through `parent_order_id`. Its renewal invoices are orders in their own right — reach them from the parent order's `children`, or query `Order` by `type = 'renewal'`.
147
+
148
+ `license` and `licenses` are guarded by `class_exists(License::class)` and return `null` when FluentCart Pro is not active, so check before chaining:
149
+
150
+ ```
151
+ $relation = $subscription->licenses();
152
+ $licenses = $relation ? $relation->get() : collect();
153
+ ```
154
+
155
+ ## Pro Plugin Relationships
156
+
157
+ ### License Relationships (Pro)
158
+
159
+ Licenses have relationships with multiple entities:
160
+
161
+ ```
162
+ // License belongs to one Customer
163
+ $license = License::find(1);
164
+ $customer = $license->customer;
165
+
166
+ // License belongs to one Product
167
+ $product = $license->product;
168
+
169
+ // License belongs to one Order
170
+ $order = $license->order;
171
+
172
+ // License belongs to one Subscription (optional)
173
+ $subscription = $license->subscription;
174
+
175
+ // License has many Activations
176
+ $activations = $license->activations;
177
+
178
+ // The variation it was issued for
179
+ $variation = $license->variation;
180
+ ```
181
+
182
+ #### License Model Relationships
183
+
184
+ | Relationship | Type | Related Model | Foreign Key | Local Key |
185
+ | --- | --- | --- | --- | --- |
186
+ | customer | belongsTo | Customer | customer_id | id |
187
+ | product | belongsTo | Product | product_id | ID |
188
+ | order | belongsTo | Order | order_id | id |
189
+ | subscription | belongsTo | Subscription | subscription_id | id |
190
+ | activations | hasMany | LicenseActivation | license_id | id |
191
+ | variation | belongsTo | ProductVariation | variation_id | id |
192
+ | productVariant | belongsTo | ProductVariation | variation_id | id |
193
+ | labels | morphMany | LabelRelationship | labelable | — |
194
+
195
+ Licence metadata lives in `fct_license_meta`, keyed by `object_id` and `object_type`; query `LicenseMeta` directly. Activation sites are reached through `activations` — `fct_license_sites` holds no `license_id` of its own. | meta | hasMany | LicenseMeta | license_id | id | | transactions | hasMany | LicenseTransaction | license_id | id |
196
+
197
+ ## Relationship Usage Examples
198
+
199
+ ### Eager Loading
200
+
201
+ Prevent N+1 queries by eager loading relationships:
202
+
203
+ ```
204
+ // Load orders with their customers and items
205
+ $orders = Order::with(['customer', 'items', 'transactions'])->get();
206
+
207
+ // Load customers with their orders and subscriptions
208
+ $customers = Customer::with(['orders', 'subscriptions'])->get();
209
+
210
+ // Load products with their variations
211
+ $products = Product::with(['variants'])->get();
212
+ ```
213
+
214
+ ### Querying with Relationships
215
+
216
+ Use relationships in queries:
217
+
218
+ ```
219
+ // Get orders for customers with specific email
220
+ $orders = Order::whereHas('customer', function($query) {
221
+ $query->where('email', '[email protected]');
222
+ })->get();
223
+
224
+ // Get customers who have active subscriptions
225
+ $customers = Customer::whereHas('subscriptions', function($query) {
226
+ $query->where('status', 'active');
227
+ })->get();
228
+
229
+ // Get products that have been ordered
230
+ $products = Product::whereHas('orderItems')->get();
231
+ ```
232
+
233
+ ### Filtering by Relationship Data
234
+
235
+ ```
236
+ // Get orders with total greater than $100
237
+ $orders = Order::whereHas('items', function($query) {
238
+ $query->where('line_total', '>', 10000);
239
+ })->get();
240
+
241
+ // Get customers with orders in specific date range
242
+ $customers = Customer::whereHas('orders', function($query) {
243
+ $query->whereBetween('created_at', ['2024-01-01', '2024-01-31']);
244
+ })->get();
245
+ ```
246
+
247
+ ### Counting Relationships
248
+
249
+ ```
250
+ // Get customers with order count
251
+ $customers = Customer::withCount('orders')->get();
252
+
253
+ // Get products with order item count
254
+ $products = Product::withCount('orderItems')->get();
255
+
256
+ // Get orders with item count
257
+ $orders = Order::withCount('items')->get();
258
+ ```
259
+
260
+ ### Complex Relationship Queries
261
+
262
+ ```
263
+ // Get customers with their latest order
264
+ $customers = Customer::with(['orders' => function($query) {
265
+ $query->latest()->limit(1);
266
+ }])->get();
267
+
268
+ // Get orders with their customer's subscription status
269
+ $orders = Order::with(['customer.subscriptions' => function($query) {
270
+ $query->where('status', 'active');
271
+ }])->get();
272
+
273
+ // Get products with their most recent order
274
+ $products = Product::with(['orderItems.order' => function($query) {
275
+ $query->latest()->limit(1);
276
+ }])->get();
277
+ ```
278
+
279
+ ## Relationship Best Practices
280
+
281
+ ### 1. Use Eager Loading
282
+
283
+ Always eager load relationships to prevent N+1 queries:
284
+
285
+ ```
286
+ // Bad - N+1 queries
287
+ $orders = Order::all();
288
+ foreach ($orders as $order) {
289
+ echo $order->customer->full_name; // N+1 query
290
+ }
291
+
292
+ // Good - Eager loading
293
+ $orders = Order::with('customer')->get();
294
+ foreach ($orders as $order) {
295
+ echo $order->customer->full_name; // No additional queries
296
+ }
297
+ ```
298
+
299
+ ### 2. Use Specific Columns
300
+
301
+ Only load the columns you need:
302
+
303
+ ```
304
+ // Load only specific columns
305
+ $orders = Order::with(['customer:id,first_name,last_name,email'])->get();
306
+ ```
307
+
308
+ ### 3. Use Constraints
309
+
310
+ Apply constraints to relationships:
311
+
312
+ ```
313
+ // Load only active subscriptions
314
+ $customers = Customer::with(['subscriptions' => function($query) {
315
+ $query->where('status', 'active');
316
+ }])->get();
317
+ ```
318
+
319
+ ### 4. Use Lazy Loading Wisely
320
+
321
+ Lazy load when you don't always need the relationship:
322
+
323
+ ```
324
+ $order = Order::find(1);
325
+
326
+ // Only load when needed
327
+ if ($needCustomer) {
328
+ $customer = $order->customer;
329
+ }
330
+ ```
331
+
332
+ ### 5. Use Relationship Methods
333
+
334
+ Use relationship methods for complex queries:
335
+
336
+ ```
337
+ // Get orders for specific customer
338
+ $customer = Customer::find(1);
339
+ $orders = $customer->orders()->where('status', 'completed')->get();
340
+
341
+ // Get active subscriptions for customer
342
+ $activeSubscriptions = $customer->subscriptions()
343
+ ->where('status', 'active')
344
+ ->get();
345
+ ```
346
+
347
+ ## Common Relationship Patterns
348
+
349
+ ### 1. Parent-Child Relationships
350
+
351
+ ```
352
+ // Order -> Order Items
353
+ $order = Order::find(1);
354
+ $items = $order->order_items;
355
+
356
+ // Customer -> Orders
357
+ $customer = Customer::find(1);
358
+ $orders = $customer->orders;
359
+ ```
360
+
361
+ ### 2. Many-to-Many Relationships
362
+
363
+ ```
364
+ // Product -> Categories
365
+ $product = Product::find(1);
366
+ $categories = $product->categories;
367
+
368
+ // Customer -> Products (through orders)
369
+ $customer = Customer::find(1);
370
+ $products = $customer->orders()->with('items.product')->get();
371
+ ```
372
+
373
+ ### 3. Polymorphic Relationships
374
+
375
+ Activity is polymorphic on `module`, so it stores `module_type` and `module_id`. Read it from the owning model, which the `HasActivity` trait provides on `Order`, `Subscription` and `Coupon`:
376
+
377
+ ```
378
+ $order->activities; // morphMany Activity
379
+ $subscription->activities;
380
+ $coupon->activities;
381
+ ```
382
+
383
+ Querying the table directly works too, with the real column names:
384
+
385
+ ```
386
+ $activities = Activity::where('module_type', Order::class)
387
+ ->where('module_id', $order->id)
388
+ ->get();
389
+ ```
390
+
391
+ ## Performance Considerations
392
+
393
+ ### 1. Foreign key columns are already indexed
394
+
395
+ The migrations index the columns these relations join on — `fct_orders.customer_id`, `fct_order_items.order_id`, `fct_subscriptions.customer_id` and the rest — so there is no `ALTER TABLE` to run before eager-loading performs well. See [Database Schema](/database/schema.md) for each table's index list.
396
+
397
+ ### 2. Use Query Scopes
398
+
399
+ Create scopes for common relationship queries:
400
+
401
+ ```
402
+ // In Order model
403
+ public function scopeWithCustomer($query) {
404
+ return $query->with('customer');
405
+ }
406
+
407
+ public function scopeWithItems($query) {
408
+ return $query->with('order_items');
409
+ }
410
+
411
+ // Usage
412
+ $orders = Order::withCustomer()->withItems()->get();
413
+ ```
414
+
415
+ ### 3. Cache Relationship Data
416
+
417
+ Cache frequently accessed relationship data:
418
+
419
+ ```
420
+ // Cache customer orders
421
+ $customer = Customer::find(1);
422
+ $orders = Cache::remember("customer_{$customer->id}_orders", 3600, function() use ($customer) {
423
+ return $customer->orders()->with('order_items')->get();
424
+ });
425
+ ```
426
+
427
+ ---