fluentcart-developer 2.3.4 → 3.0.0

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 (655) hide show
  1. package/dist/cards/fluentcart/tools.d.ts.map +1 -1
  2. package/dist/cards/fluentcart/tools.js +2368 -2323
  3. package/dist/cards/fluentcart/tools.js.map +1 -1
  4. package/dist/paths.d.ts +1 -1
  5. package/dist/paths.d.ts.map +1 -1
  6. package/dist/paths.js +1 -1
  7. package/dist/paths.js.map +1 -1
  8. package/dist/reference-reader.d.ts +32 -1
  9. package/dist/reference-reader.d.ts.map +1 -1
  10. package/dist/reference-reader.js +111 -22
  11. package/dist/reference-reader.js.map +1 -1
  12. package/dist/server.d.ts.map +1 -1
  13. package/dist/server.js +8 -1
  14. package/dist/server.js.map +1 -1
  15. package/dist/skills/fluentcart-developer/SKILL.md +66 -538
  16. package/dist/skills/fluentcart-developer/references/api/authentication.md +452 -0
  17. package/dist/skills/fluentcart-developer/references/api/coupons.md +786 -0
  18. package/dist/skills/fluentcart-developer/references/api/customers.md +889 -0
  19. package/dist/skills/fluentcart-developer/references/api/files.md +609 -0
  20. package/dist/skills/fluentcart-developer/references/api/index.md +432 -0
  21. package/dist/skills/fluentcart-developer/references/api/licensing.md +633 -0
  22. package/dist/skills/fluentcart-developer/references/api/order-bump.md +384 -0
  23. package/dist/skills/fluentcart-developer/references/api/orders.md +814 -0
  24. package/dist/skills/fluentcart-developer/references/api/products.md +866 -0
  25. package/dist/skills/fluentcart-developer/references/api/roles-permissions.md +536 -0
  26. package/dist/skills/fluentcart-developer/references/api/subscriptions.md +827 -0
  27. package/dist/skills/fluentcart-developer/references/database/index.md +44 -0
  28. package/dist/skills/fluentcart-developer/references/database/models/activity.md +178 -0
  29. package/dist/skills/fluentcart-developer/references/database/models/applied-coupon.md +291 -0
  30. package/dist/skills/fluentcart-developer/references/database/models/attribute-group.md +239 -0
  31. package/dist/skills/fluentcart-developer/references/database/models/attribute-relation.md +181 -0
  32. package/dist/skills/fluentcart-developer/references/database/models/attribute-term.md +219 -0
  33. package/dist/skills/fluentcart-developer/references/database/models/cart.md +645 -0
  34. package/dist/skills/fluentcart-developer/references/database/models/coupon.md +427 -0
  35. package/dist/skills/fluentcart-developer/references/database/models/customer-addresses.md +348 -0
  36. package/dist/skills/fluentcart-developer/references/database/models/customer-meta.md +156 -0
  37. package/dist/skills/fluentcart-developer/references/database/models/customer.md +584 -0
  38. package/dist/skills/fluentcart-developer/references/database/models/dynamic-model.md +163 -0
  39. package/dist/skills/fluentcart-developer/references/database/models/label-relationship.md +155 -0
  40. package/dist/skills/fluentcart-developer/references/database/models/label.md +153 -0
  41. package/dist/skills/fluentcart-developer/references/database/models/license-activation.md +182 -0
  42. package/dist/skills/fluentcart-developer/references/database/models/license-meta.md +163 -0
  43. package/dist/skills/fluentcart-developer/references/database/models/license-site.md +208 -0
  44. package/dist/skills/fluentcart-developer/references/database/models/license.md +640 -0
  45. package/dist/skills/fluentcart-developer/references/database/models/meta.md +233 -0
  46. package/dist/skills/fluentcart-developer/references/database/models/order-address.md +391 -0
  47. package/dist/skills/fluentcart-developer/references/database/models/order-download-permission.md +144 -0
  48. package/dist/skills/fluentcart-developer/references/database/models/order-item.md +383 -0
  49. package/dist/skills/fluentcart-developer/references/database/models/order-meta.md +303 -0
  50. package/dist/skills/fluentcart-developer/references/database/models/order-operation.md +158 -0
  51. package/dist/skills/fluentcart-developer/references/database/models/order-promotion-stat.md +175 -0
  52. package/dist/skills/fluentcart-developer/references/database/models/order-promotion.md +250 -0
  53. package/dist/skills/fluentcart-developer/references/database/models/order-tax-rate.md +172 -0
  54. package/dist/skills/fluentcart-developer/references/database/models/order-transaction.md +440 -0
  55. package/dist/skills/fluentcart-developer/references/database/models/order.md +727 -0
  56. package/dist/skills/fluentcart-developer/references/database/models/product-detail.md +397 -0
  57. package/dist/skills/fluentcart-developer/references/database/models/product-download.md +258 -0
  58. package/dist/skills/fluentcart-developer/references/database/models/product-meta.md +153 -0
  59. package/dist/skills/fluentcart-developer/references/database/models/product-variation.md +556 -0
  60. package/dist/skills/fluentcart-developer/references/database/models/product.md +580 -0
  61. package/dist/skills/fluentcart-developer/references/database/models/relationships.md +427 -0
  62. package/dist/skills/fluentcart-developer/references/database/models/scheduled-action.md +175 -0
  63. package/dist/skills/fluentcart-developer/references/database/models/shipping-class.md +148 -0
  64. package/dist/skills/fluentcart-developer/references/database/models/shipping-method.md +280 -0
  65. package/dist/skills/fluentcart-developer/references/database/models/shipping-zone.md +205 -0
  66. package/dist/skills/fluentcart-developer/references/database/models/subscription-meta.md +173 -0
  67. package/dist/skills/fluentcart-developer/references/database/models/subscription.md +528 -0
  68. package/dist/skills/fluentcart-developer/references/database/models/tax-class.md +195 -0
  69. package/dist/skills/fluentcart-developer/references/database/models/tax-rate.md +225 -0
  70. package/dist/skills/fluentcart-developer/references/database/models/user-meta.md +166 -0
  71. package/dist/skills/fluentcart-developer/references/database/models/user.md +220 -0
  72. package/dist/skills/fluentcart-developer/references/database/models.md +404 -0
  73. package/dist/skills/fluentcart-developer/references/database/query-builder.md +860 -0
  74. package/dist/skills/fluentcart-developer/references/database/readme.md +276 -0
  75. package/dist/skills/fluentcart-developer/references/database/schema.md +1002 -0
  76. package/dist/skills/fluentcart-developer/references/engineering/adding-custom-pages-to-the-customer-dashboard.md +395 -0
  77. package/dist/skills/fluentcart-developer/references/engineering/index.md +4 -0
  78. package/dist/skills/fluentcart-developer/references/engineering.md +4 -0
  79. package/dist/skills/fluentcart-developer/references/getting-started.md +249 -0
  80. package/dist/skills/fluentcart-developer/references/guides/frontend.md +519 -0
  81. package/dist/skills/fluentcart-developer/references/guides/index.md +107 -0
  82. package/dist/skills/fluentcart-developer/references/guides/integrations.md +600 -0
  83. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/index.md +237 -0
  84. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/labels-and-tracking.md +481 -0
  85. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/live-rates.md +269 -0
  86. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/reference.md +223 -0
  87. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/settings.md +370 -0
  88. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier.md +237 -0
  89. package/dist/skills/fluentcart-developer/references/{subscription-customization.md → guides/subscriptions.md} +57 -37
  90. package/dist/skills/fluentcart-developer/references/hooks/actions/admin-and-templates.md +1079 -0
  91. package/dist/skills/fluentcart-developer/references/hooks/actions/cart-and-checkout.md +1795 -0
  92. package/dist/skills/fluentcart-developer/references/hooks/actions/customers-and-users.md +327 -0
  93. package/dist/skills/fluentcart-developer/references/hooks/actions/licenses.md +829 -0
  94. package/dist/skills/fluentcart-developer/references/hooks/actions/modules.md +81 -0
  95. package/dist/skills/fluentcart-developer/references/hooks/actions/orders.md +757 -0
  96. package/dist/skills/fluentcart-developer/references/hooks/actions/payments-and-integrations.md +1163 -0
  97. package/dist/skills/fluentcart-developer/references/hooks/actions/pro-modules.md +219 -0
  98. package/dist/skills/fluentcart-developer/references/hooks/actions/products-and-coupons.md +1019 -0
  99. package/dist/skills/fluentcart-developer/references/hooks/actions/subscriptions.md +1290 -0
  100. package/dist/skills/fluentcart-developer/references/hooks/actions.md +16 -0
  101. package/dist/skills/fluentcart-developer/references/hooks/deprecated.md +60 -0
  102. package/dist/skills/fluentcart-developer/references/hooks/filters/cart-and-checkout.md +2032 -0
  103. package/dist/skills/fluentcart-developer/references/hooks/filters/customers-and-subscriptions.md +1746 -0
  104. package/dist/skills/fluentcart-developer/references/hooks/filters/integrations-and-advanced.md +2439 -0
  105. package/dist/skills/fluentcart-developer/references/hooks/filters/modules.md +464 -0
  106. package/dist/skills/fluentcart-developer/references/hooks/filters/orders-and-payments.md +2658 -0
  107. package/dist/skills/fluentcart-developer/references/hooks/filters/pro-modules.md +502 -0
  108. package/dist/skills/fluentcart-developer/references/hooks/filters/products-and-pricing.md +1785 -0
  109. package/dist/skills/fluentcart-developer/references/hooks/filters/settings-and-configuration.md +2966 -0
  110. package/dist/skills/fluentcart-developer/references/hooks/filters.md +14 -0
  111. package/dist/skills/fluentcart-developer/references/hooks/index.md +35 -0
  112. package/dist/skills/fluentcart-developer/references/index.md +625 -0
  113. package/dist/skills/fluentcart-developer/references/{fee-system-guide.md → modules/fee-system.md} +38 -60
  114. package/dist/skills/fluentcart-developer/references/{ghost-product-selling.md → modules/ghost-product-selling.md} +71 -89
  115. package/dist/skills/fluentcart-developer/references/modules/index.md +484 -0
  116. package/dist/skills/fluentcart-developer/references/modules/licensing.md +342 -0
  117. package/dist/skills/fluentcart-developer/references/modules/order-bump.md +433 -0
  118. package/dist/skills/fluentcart-developer/references/modules/payment-methods.md +129 -0
  119. package/dist/skills/fluentcart-developer/references/modules/refunds.md +170 -0
  120. package/dist/skills/fluentcart-developer/references/modules/shipping.md +846 -0
  121. package/dist/skills/fluentcart-developer/references/modules/storage.md +986 -0
  122. package/dist/skills/fluentcart-developer/references/modules/subscription-vendor-ids.md +186 -0
  123. package/dist/skills/fluentcart-developer/references/modules/subscriptions.md +678 -0
  124. package/dist/skills/fluentcart-developer/references/payment-methods-integration/index.md +164 -0
  125. package/dist/skills/fluentcart-developer/references/payment-methods-integration/paddle-example.md +1648 -0
  126. package/dist/skills/fluentcart-developer/references/payment-methods-integration/payment/setting/fields.md +353 -0
  127. package/dist/skills/fluentcart-developer/references/payment-methods-integration/quick-implementation.md +1079 -0
  128. package/dist/skills/fluentcart-developer/references/payment-methods-integration.md +164 -0
  129. package/dist/skills/fluentcart-developer/references/restapi/checkout.md +573 -0
  130. package/dist/skills/fluentcart-developer/references/restapi/coupons.md +958 -0
  131. package/dist/skills/fluentcart-developer/references/restapi/customer-profile.md +1423 -0
  132. package/dist/skills/fluentcart-developer/references/{rest-api-customers.md → restapi/customers.md} +406 -424
  133. package/dist/skills/fluentcart-developer/references/restapi/dashboard.md +1083 -0
  134. package/dist/skills/fluentcart-developer/references/restapi/data-export.md +132 -0
  135. package/dist/skills/fluentcart-developer/references/restapi/email-notifications.md +846 -0
  136. package/dist/skills/fluentcart-developer/references/restapi/files.md +313 -0
  137. package/dist/skills/fluentcart-developer/references/restapi/index.md +127 -0
  138. package/dist/skills/fluentcart-developer/references/restapi/integrations.md +1000 -0
  139. package/dist/skills/fluentcart-developer/references/restapi/inventory.md +192 -0
  140. package/dist/skills/fluentcart-developer/references/restapi/labels-and-attributes.md +797 -0
  141. package/dist/skills/fluentcart-developer/references/restapi/licensing.md +1733 -0
  142. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-available-shipping-methods.md +30 -0
  143. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-checkout-summary.md +28 -0
  144. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-country-info.md +29 -0
  145. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-order-info.md +28 -0
  146. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-shipping-methods-list-view.md +30 -0
  147. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/login.md +66 -0
  148. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/place-order.md +179 -0
  149. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/apply-coupon.md +83 -0
  150. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/cancel-coupon.md +87 -0
  151. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/check-product-eligibility.md +59 -0
  152. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/create-coupon.md +230 -0
  153. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/delete-coupon.md +29 -0
  154. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon-settings.md +20 -0
  155. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon.md +27 -0
  156. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupon-codes.md +20 -0
  157. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupons.md +37 -0
  158. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/re-apply-coupons.md +75 -0
  159. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/store-coupon-settings.md +40 -0
  160. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/update-coupon.md +133 -0
  161. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-address-checkout.md +138 -0
  162. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-profile-address.md +119 -0
  163. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/dashboard-overview.md +22 -0
  164. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/delete-profile-address.md +46 -0
  165. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-order-details.md +30 -0
  166. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-portal-sections.md +29 -0
  167. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-profile-details.md +22 -0
  168. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-transaction-billing-address.md +30 -0
  169. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-upgrade-paths.md +31 -0
  170. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-downloads.md +29 -0
  171. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-orders.md +28 -0
  172. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/make-profile-address-primary.md +55 -0
  173. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/pause-subscription.md +29 -0
  174. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/resume-subscription.md +29 -0
  175. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/save-transaction-billing-address.md +92 -0
  176. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/select-address-for-checkout.md +32 -0
  177. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-address.md +115 -0
  178. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-details.md +69 -0
  179. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/attach-user.md +50 -0
  180. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/bulk-actions.md +65 -0
  181. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-address.md +135 -0
  182. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-customer.md +108 -0
  183. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/delete-address.md +62 -0
  184. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/detach-user.md +28 -0
  185. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/find-customer-order.md +27 -0
  186. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-attachable-users.md +20 -0
  187. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-addresses.md +28 -0
  188. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-orders.md +37 -0
  189. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-stats.md +27 -0
  190. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer.md +32 -0
  191. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/list-customers.md +37 -0
  192. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/recalculate-ltv.md +28 -0
  193. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/set-primary-address.md +72 -0
  194. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-additional-info.md +55 -0
  195. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-address.md +144 -0
  196. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-customer.md +123 -0
  197. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/attach-note-to-order.md +49 -0
  198. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-all-pages.md +21 -0
  199. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-single-page.md +55 -0
  200. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/delete-activity.md +28 -0
  201. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-country-info.md +29 -0
  202. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-dashboard-stats.md +22 -0
  203. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-filter-options.md +31 -0
  204. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-data.md +20 -0
  205. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-settings.md +20 -0
  206. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-print-templates.md +20 -0
  207. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-search-options.md +27 -0
  208. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-widgets.md +28 -0
  209. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/initialize-app.md +20 -0
  210. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-activities.md +33 -0
  211. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-attachments.md +21 -0
  212. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-countries.md +20 -0
  213. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/mark-activity-read.md +53 -0
  214. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/run-data-backfills.md +21 -0
  215. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-settings.md +54 -0
  216. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-tax-settings.md +73 -0
  217. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-print-templates.md +64 -0
  218. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/upload-attachment.md +42 -0
  219. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-customers-batch.md +129 -0
  220. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-licenses-batch.md +133 -0
  221. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-orders-batch.md +129 -0
  222. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-subscriptions-batch.md +129 -0
  223. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-customers-export-schema.md +21 -0
  224. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-licenses-export-schema.md +26 -0
  225. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-orders-export-schema.md +21 -0
  226. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-subscriptions-export-schema.md +21 -0
  227. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/enable-notification.md +57 -0
  228. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-digest-settings.md +22 -0
  229. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-notification.md +30 -0
  230. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-reminders.md +22 -0
  231. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-settings.md +22 -0
  232. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-shortcodes.md +22 -0
  233. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/list-notifications.md +20 -0
  234. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-default-template.md +66 -0
  235. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-notification.md +50 -0
  236. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-digest-settings.md +101 -0
  237. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-reminders.md +162 -0
  238. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-settings.md +99 -0
  239. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-digest-test.md +47 -0
  240. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-manual-reminder.md +51 -0
  241. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/update-notification.md +93 -0
  242. package/dist/skills/fluentcart-developer/references/restapi/operations/files/delete-file.md +31 -0
  243. package/dist/skills/fluentcart-developer/references/restapi/operations/files/get-bucket-list.md +28 -0
  244. package/dist/skills/fluentcart-developer/references/restapi/operations/files/list-files.md +30 -0
  245. package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-editor-file.md +32 -0
  246. package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-file.md +34 -0
  247. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/chained-data-request.md +46 -0
  248. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/change-feed-status.md +51 -0
  249. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/delete-feed.md +27 -0
  250. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-dynamic-options.md +29 -0
  251. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-lists.md +27 -0
  252. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-settings.md +27 -0
  253. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-feeds.md +20 -0
  254. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-settings.md +26 -0
  255. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/install-addon-plugin.md +49 -0
  256. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/list-addons.md +20 -0
  257. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/save-feed-settings.md +52 -0
  258. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/set-global-settings.md +50 -0
  259. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/bulk-update-stock.md +94 -0
  260. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/export-inventory.md +81 -0
  261. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-adjustment-history.md +26 -0
  262. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-inventory-stats.md +21 -0
  263. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/list-inventory.md +33 -0
  264. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/update-stock.md +75 -0
  265. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-attribute-group.md +31 -0
  266. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-label.md +31 -0
  267. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-terms.md +90 -0
  268. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-group.md +28 -0
  269. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-term.md +29 -0
  270. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-group.md +28 -0
  271. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-library.md +20 -0
  272. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-groups.md +32 -0
  273. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-terms.md +33 -0
  274. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-labels.md +20 -0
  275. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-groups.md +51 -0
  276. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-terms.md +56 -0
  277. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-group.md +37 -0
  278. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-term.md +39 -0
  279. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-label-selections.md +32 -0
  280. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-plugin-license.md +41 -0
  281. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-site-admin.md +60 -0
  282. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-plugin-license.md +18 -0
  283. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-admin.md +67 -0
  284. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-customer.md +47 -0
  285. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/delete-license.md +24 -0
  286. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/extend-license-validity.md +47 -0
  287. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-license-details.md +25 -0
  288. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-licenses-admin.md +26 -0
  289. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-activations.md +25 -0
  290. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-details.md +25 -0
  291. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-site.md +30 -0
  292. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-plugin-license-status.md +18 -0
  293. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-product-license-settings.md +24 -0
  294. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-customer-licenses.md +25 -0
  295. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-license-sites.md +33 -0
  296. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-licenses.md +38 -0
  297. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-activate-license.md +54 -0
  298. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-check-license.md +26 -0
  299. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-deactivate-license.md +46 -0
  300. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-download-license-package.md +23 -0
  301. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-get-license-version.md +26 -0
  302. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/regenerate-license-key.md +24 -0
  303. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/save-product-license-settings.md +193 -0
  304. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-activation-limit.md +53 -0
  305. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-status.md +52 -0
  306. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/create-order-bump.md +47 -0
  307. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/delete-order-bump.md +25 -0
  308. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/get-order-bump.md +25 -0
  309. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/list-order-bumps.md +29 -0
  310. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/update-order-bump.md +141 -0
  311. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/accept-dispute.md +47 -0
  312. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/bulk-actions.md +72 -0
  313. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-shipping.md +67 -0
  314. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-tax.md +98 -0
  315. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/change-customer.md +50 -0
  316. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/charge-now.md +29 -0
  317. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-and-change-customer.md +92 -0
  318. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-custom-order-item.md +68 -0
  319. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-order.md +351 -0
  320. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-renewal-now.md +29 -0
  321. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/delete-order.md +28 -0
  322. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/generate-missing-licenses.md +29 -0
  323. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order-transactions.md +27 -0
  324. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order.md +27 -0
  325. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-renewal.md +28 -0
  326. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-shipping-methods.md +28 -0
  327. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-single-transaction.md +28 -0
  328. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-order-currencies.md +22 -0
  329. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-orders.md +42 -0
  330. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-renewals.md +28 -0
  331. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/mark-as-paid.md +61 -0
  332. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/price-order.md +135 -0
  333. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/refund-order.md +72 -0
  334. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/resend-renewal-invoice.md +29 -0
  335. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/skip-renewal.md +48 -0
  336. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-order-statuses.md +28 -0
  337. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-pending-transaction.md +29 -0
  338. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address-id.md +60 -0
  339. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address.md +98 -0
  340. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order.md +172 -0
  341. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-statuses.md +77 -0
  342. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-subscription-details.md +84 -0
  343. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-transaction-status.md +51 -0
  344. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/void-renewal.md +30 -0
  345. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/create-pdf-template.md +42 -0
  346. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/delete-pdf-template.md +26 -0
  347. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/download-pdf-preview.md +44 -0
  348. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-factory-default-templates.md +19 -0
  349. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-status.md +21 -0
  350. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-template.md +26 -0
  351. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-saved-templates.md +21 -0
  352. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-seller-details.md +19 -0
  353. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/list-pdf-templates.md +19 -0
  354. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-pdf-template.md +53 -0
  355. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-seller-details.md +97 -0
  356. package/dist/skills/fluentcart-developer/references/restapi/operations/products/add-product-terms.md +64 -0
  357. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-edit-fetch.md +30 -0
  358. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-insert-products.md +62 -0
  359. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-products.md +59 -0
  360. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-variants.md +83 -0
  361. package/dist/skills/fluentcart-developer/references/restapi/operations/products/change-integration-status.md +64 -0
  362. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-dummy-products.md +45 -0
  363. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-product.md +81 -0
  364. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-variation.md +181 -0
  365. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-downloadable-file.md +27 -0
  366. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product-integration.md +30 -0
  367. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product.md +27 -0
  368. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-taxonomy-term.md +55 -0
  369. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-upgrade-path.md +27 -0
  370. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-variation.md +27 -0
  371. package/dist/skills/fluentcart-developer/references/restapi/operations/products/do-bulk-action.md +56 -0
  372. package/dist/skills/fluentcart-developer/references/restapi/operations/products/duplicate-product.md +56 -0
  373. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-products-by-ids.md +26 -0
  374. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-taxonomy-terms.md +20 -0
  375. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-terms-by-parent.md +60 -0
  376. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-variations-by-ids.md +26 -0
  377. package/dist/skills/fluentcart-developer/references/restapi/operations/products/find-subscription-variants.md +26 -0
  378. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-bundle-info.md +27 -0
  379. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-downloadable-url.md +27 -0
  380. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-max-excerpt-word-count.md +20 -0
  381. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-pricing-widgets.md +27 -0
  382. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-feeds.md +29 -0
  383. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-settings.md +31 -0
  384. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-pricing.md +28 -0
  385. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product.md +28 -0
  386. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-related-products.md +31 -0
  387. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-upgrade-settings.md +27 -0
  388. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-variation-upgrade-paths.md +28 -0
  389. package/dist/skills/fluentcart-developer/references/restapi/operations/products/group-bulk-update-variants.md +103 -0
  390. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-all-variants.md +26 -0
  391. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-product-variations.md +26 -0
  392. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-products.md +34 -0
  393. package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-shipping-class.md +27 -0
  394. package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-tax-class.md +27 -0
  395. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-bundle-info.md +56 -0
  396. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-product-integration.md +62 -0
  397. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-upgrade-path.md +78 -0
  398. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-product-variant-options.md +29 -0
  399. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-products-by-name.md +28 -0
  400. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-variants-by-name.md +28 -0
  401. package/dist/skills/fluentcart-developer/references/restapi/operations/products/set-variation-media.md +74 -0
  402. package/dist/skills/fluentcart-developer/references/restapi/operations/products/suggest-sku.md +28 -0
  403. package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-downloadable-files.md +134 -0
  404. package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-taxonomy-terms.md +61 -0
  405. package/dist/skills/fluentcart-developer/references/restapi/operations/products/toggle-product-tax-exemption.md +56 -0
  406. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-downloadable-file.md +98 -0
  407. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-inventory.md +56 -0
  408. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-long-desc-editor-mode.md +49 -0
  409. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-manage-stock.md +53 -0
  410. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-detail.md +58 -0
  411. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-pricing.md +225 -0
  412. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-shipping-class.md +49 -0
  413. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-tax-class.md +49 -0
  414. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-upgrade-path.md +78 -0
  415. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-option.md +79 -0
  416. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-tax-exemption.md +56 -0
  417. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation-pricing-table.md +49 -0
  418. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation.md +105 -0
  419. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/get-product-views.md +34 -0
  420. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/list-products.md +42 -0
  421. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/search-products.md +30 -0
  422. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/channel-rules.md +24 -0
  423. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/country-heat-map.md +22 -0
  424. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupon-overview.md +37 -0
  425. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupons.md +36 -0
  426. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-insights.md +31 -0
  427. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-overview.md +36 -0
  428. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-repeat.md +35 -0
  429. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segment-customers.md +36 -0
  430. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segments.md +30 -0
  431. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-value.md +34 -0
  432. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/dashboard-stats.md +30 -0
  433. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/failed-orders.md +34 -0
  434. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-new-vs-returning-customer.md +34 -0
  435. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-by-day-and-hour.md +34 -0
  436. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-meta.md +29 -0
  437. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-top-sold-products.md +34 -0
  438. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/future-renewals.md +31 -0
  439. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/generate-retention-snapshots.md +24 -0
  440. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-overview.md +30 -0
  441. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-activities.md +26 -0
  442. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-orders.md +20 -0
  443. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-revenue.md +37 -0
  444. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-at-risk.md +35 -0
  445. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-variations.md +33 -0
  446. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments.md +33 -0
  447. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/item-count-distribution.md +34 -0
  448. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-chart.md +30 -0
  449. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-pie-chart.md +22 -0
  450. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-summary.md +22 -0
  451. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/locations.md +43 -0
  452. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-chart.md +37 -0
  453. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-completion-time.md +34 -0
  454. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-mix.md +34 -0
  455. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-value-distribution.md +34 -0
  456. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-disputes.md +38 -0
  457. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-methods.md +36 -0
  458. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods.md +37 -0
  459. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison-launch.md +33 -0
  460. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison.md +40 -0
  461. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-detail.md +37 -0
  462. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-sales.md +37 -0
  463. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/refunds-overview.md +37 -0
  464. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/retention-snapshots-step.md +45 -0
  465. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sales-growth-chart.md +35 -0
  466. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/save-channel-rules.md +73 -0
  467. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/source-channels.md +37 -0
  468. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sources.md +49 -0
  469. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-cohorts.md +33 -0
  470. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-health.md +30 -0
  471. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-rebuys.md +37 -0
  472. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-retention.md +34 -0
  473. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-variations.md +22 -0
  474. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscriptions-overview.md +37 -0
  475. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/weeks-between-refund.md +34 -0
  476. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/assign-role.md +48 -0
  477. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/delete-role-assignment.md +47 -0
  478. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/get-role.md +25 -0
  479. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-managers.md +18 -0
  480. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-roles.md +18 -0
  481. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/search-users.md +25 -0
  482. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/update-role.md +43 -0
  483. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/create-saved-view.md +106 -0
  484. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/delete-saved-view.md +26 -0
  485. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/list-saved-views.md +25 -0
  486. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/update-saved-view.md +83 -0
  487. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-payment-addon.md +44 -0
  488. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-plugin-addon.md +44 -0
  489. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/change-storage-driver-status.md +56 -0
  490. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/check-paypal-webhook.md +26 -0
  491. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/create-storage-bucket.md +63 -0
  492. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/disconnect-payment-method.md +55 -0
  493. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/exchange-paypal-seller-auth-token.md +62 -0
  494. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-active-storage-drivers.md +20 -0
  495. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-checkout-fields.md +22 -0
  496. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-email-shortcodes.md +20 -0
  497. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-config-snippets.md +26 -0
  498. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-status.md +20 -0
  499. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-module-settings.md +20 -0
  500. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-connection-info.md +26 -0
  501. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-settings.md +26 -0
  502. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-permissions.md +22 -0
  503. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-plugin-addons.md +20 -0
  504. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-storage-driver-settings.md +27 -0
  505. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-store-settings.md +26 -0
  506. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-mcp-adapter.md +21 -0
  507. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-payment-addon.md +60 -0
  508. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-plugin-addon.md +64 -0
  509. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-payment-methods.md +20 -0
  510. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-storage-drivers.md +20 -0
  511. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-storage-buckets.md +67 -0
  512. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reorder-payment-methods.md +55 -0
  513. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reset-storage-driver-settings.md +45 -0
  514. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-checkout-fields.md +133 -0
  515. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-confirmation-settings.md +68 -0
  516. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-module-settings.md +68 -0
  517. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-design.md +67 -0
  518. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-settings.md +58 -0
  519. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-permissions.md +68 -0
  520. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-storage-driver-settings.md +62 -0
  521. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-store-settings.md +239 -0
  522. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/setup-paypal-webhook.md +48 -0
  523. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/toggle-mcp.md +40 -0
  524. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-storage-driver-connection.md +62 -0
  525. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-turnstile-keys.md +55 -0
  526. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-class.md +73 -0
  527. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-method.md +110 -0
  528. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-zone.md +56 -0
  529. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-class.md +29 -0
  530. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-method.md +29 -0
  531. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-zone.md +29 -0
  532. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class-profile.md +30 -0
  533. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class.md +29 -0
  534. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-packages.md +22 -0
  535. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-zone.md +27 -0
  536. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-countries.md +22 -0
  537. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-states.md +28 -0
  538. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-classes.md +31 -0
  539. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-zones.md +31 -0
  540. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/save-shipping-packages.md +112 -0
  541. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-class.md +79 -0
  542. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-method.md +113 -0
  543. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-zone.md +62 -0
  544. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-zone-order.md +52 -0
  545. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-auto-renew.md +30 -0
  546. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-subscription.md +52 -0
  547. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/confirm-subscription-switch.md +70 -0
  548. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/fetch-subscription-remote.md +28 -0
  549. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/generate-early-payment-link.md +29 -0
  550. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-customer-subscription.md +27 -0
  551. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-or-create-plan.md +69 -0
  552. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-setup-intent-attempts.md +30 -0
  553. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-subscription.md +28 -0
  554. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/initiate-early-payment.md +31 -0
  555. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-customer-subscriptions.md +27 -0
  556. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-subscriptions.md +39 -0
  557. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/pause-subscription.md +28 -0
  558. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/reactivate-subscription.md +28 -0
  559. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/resume-subscription.md +28 -0
  560. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/switch-payment-method.md +70 -0
  561. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-payment-method.md +69 -0
  562. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-vendor-ids.md +56 -0
  563. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/verify-vendor-ids.md +56 -0
  564. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-class.md +51 -0
  565. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-rate.md +117 -0
  566. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-product-override.md +27 -0
  567. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-shipping-tax-override.md +27 -0
  568. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-class.md +28 -0
  569. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-rate.md +27 -0
  570. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-id.md +27 -0
  571. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-rates.md +28 -0
  572. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-eu-vat-product-overrides.md +20 -0
  573. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-oss-country-rates.md +20 -0
  574. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-preconfigured-tax-rates.md +20 -0
  575. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-product-overrides.md +27 -0
  576. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-tax-settings.md +20 -0
  577. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-all-tax-rates.md +20 -0
  578. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-classes.md +20 -0
  579. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-records.md +37 -0
  580. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/mark-taxes-as-filed.md +58 -0
  581. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/reset-eu-vat-rates.md +21 -0
  582. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-configured-countries.md +57 -0
  583. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-country-tax-id.md +50 -0
  584. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-eu-vat-cross-border-settings.md +127 -0
  585. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-oss-country-rates.md +100 -0
  586. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-product-override.md +110 -0
  587. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-shipping-tax-override.md +52 -0
  588. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-tax-settings.md +166 -0
  589. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-country-status.md +54 -0
  590. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-tax-rate.md +116 -0
  591. package/dist/skills/fluentcart-developer/references/restapi/order-bumps.md +433 -0
  592. package/dist/skills/fluentcart-developer/references/{rest-api-orders.md → restapi/orders.md} +146 -396
  593. package/dist/skills/fluentcart-developer/references/restapi/pdf-templates.md +212 -0
  594. package/dist/skills/fluentcart-developer/references/{rest-api-products.md → restapi/products.md} +354 -566
  595. package/dist/skills/fluentcart-developer/references/restapi/public-shop.md +191 -0
  596. package/dist/skills/fluentcart-developer/references/restapi/reports.md +3773 -0
  597. package/dist/skills/fluentcart-developer/references/restapi/roles.md +403 -0
  598. package/dist/skills/fluentcart-developer/references/restapi/saved-views.md +136 -0
  599. package/dist/skills/fluentcart-developer/references/restapi/settings.md +1423 -0
  600. package/dist/skills/fluentcart-developer/references/{rest-api-shipping.md → restapi/shipping.md} +243 -138
  601. package/dist/skills/fluentcart-developer/references/restapi/subscriptions.md +1169 -0
  602. package/dist/skills/fluentcart-developer/references/restapi/tax.md +1551 -0
  603. package/dist/skills/fluentcart-developer/references/restapi.md +127 -0
  604. package/dist/version.d.ts +1 -1
  605. package/dist/version.js +1 -1
  606. package/package.json +1 -1
  607. package/dist/skills/fluentcart-developer/.claude-plugin/plugin.json +0 -12
  608. package/dist/skills/fluentcart-developer/.mcp.json +0 -11
  609. package/dist/skills/fluentcart-developer/references/action-hooks-admin-templates.md +0 -787
  610. package/dist/skills/fluentcart-developer/references/action-hooks-cart-checkout.md +0 -1355
  611. package/dist/skills/fluentcart-developer/references/action-hooks-customers-users.md +0 -266
  612. package/dist/skills/fluentcart-developer/references/action-hooks-licenses.md +0 -855
  613. package/dist/skills/fluentcart-developer/references/action-hooks-orders.md +0 -631
  614. package/dist/skills/fluentcart-developer/references/action-hooks-payments-integrations.md +0 -963
  615. package/dist/skills/fluentcart-developer/references/action-hooks-products-coupons.md +0 -585
  616. package/dist/skills/fluentcart-developer/references/action-hooks-subscriptions.md +0 -661
  617. package/dist/skills/fluentcart-developer/references/customer-dashboard-endpoints.md +0 -169
  618. package/dist/skills/fluentcart-developer/references/database-models-query-builder.md +0 -194
  619. package/dist/skills/fluentcart-developer/references/database-models-reference.md +0 -604
  620. package/dist/skills/fluentcart-developer/references/database-schema-reference.md +0 -947
  621. package/dist/skills/fluentcart-developer/references/engineering-notes.md +0 -154
  622. package/dist/skills/fluentcart-developer/references/filter-hooks-cart-checkout.md +0 -1202
  623. package/dist/skills/fluentcart-developer/references/filter-hooks-customers-subscriptions.md +0 -902
  624. package/dist/skills/fluentcart-developer/references/filter-hooks-integrations-advanced.md +0 -1598
  625. package/dist/skills/fluentcart-developer/references/filter-hooks-orders-payments.md +0 -1319
  626. package/dist/skills/fluentcart-developer/references/filter-hooks-products-pricing.md +0 -628
  627. package/dist/skills/fluentcart-developer/references/filter-hooks-settings-configuration.md +0 -1177
  628. package/dist/skills/fluentcart-developer/references/fluentcart-developer-guide.md +0 -154
  629. package/dist/skills/fluentcart-developer/references/hooks-complete-index.md +0 -834
  630. package/dist/skills/fluentcart-developer/references/models-complete-index.md +0 -912
  631. package/dist/skills/fluentcart-developer/references/modules-and-extensions-reference.md +0 -224
  632. package/dist/skills/fluentcart-developer/references/order-bump-module.md +0 -163
  633. package/dist/skills/fluentcart-developer/references/paddle-gateway-case-study.md +0 -1931
  634. package/dist/skills/fluentcart-developer/references/payment-gateway-integration.md +0 -761
  635. package/dist/skills/fluentcart-developer/references/rest-api-checkout.md +0 -288
  636. package/dist/skills/fluentcart-developer/references/rest-api-coupons.md +0 -801
  637. package/dist/skills/fluentcart-developer/references/rest-api-customer-profile.md +0 -190
  638. package/dist/skills/fluentcart-developer/references/rest-api-dashboard-utilities.md +0 -219
  639. package/dist/skills/fluentcart-developer/references/rest-api-email-notifications.md +0 -619
  640. package/dist/skills/fluentcart-developer/references/rest-api-files.md +0 -290
  641. package/dist/skills/fluentcart-developer/references/rest-api-integrations.md +0 -324
  642. package/dist/skills/fluentcart-developer/references/rest-api-labels-attributes.md +0 -321
  643. package/dist/skills/fluentcart-developer/references/rest-api-licensing.md +0 -174
  644. package/dist/skills/fluentcart-developer/references/rest-api-order-bumps.md +0 -200
  645. package/dist/skills/fluentcart-developer/references/rest-api-overview.md +0 -131
  646. package/dist/skills/fluentcart-developer/references/rest-api-public-shop.md +0 -172
  647. package/dist/skills/fluentcart-developer/references/rest-api-reference.md +0 -552
  648. package/dist/skills/fluentcart-developer/references/rest-api-reports.md +0 -377
  649. package/dist/skills/fluentcart-developer/references/rest-api-roles-permissions.md +0 -147
  650. package/dist/skills/fluentcart-developer/references/rest-api-settings.md +0 -528
  651. package/dist/skills/fluentcart-developer/references/rest-api-subscriptions.md +0 -938
  652. package/dist/skills/fluentcart-developer/references/rest-api-tax.md +0 -356
  653. package/dist/skills/fluentcart-developer/references/shipping-module-guide.md +0 -126
  654. package/dist/skills/fluentcart-developer/references/software-licensing-sdk.md +0 -228
  655. package/dist/skills/fluentcart-developer/references/storage-drivers-module.md +0 -140
@@ -0,0 +1,1019 @@
1
+ # Products & Coupons
2
+
3
+ All hooks related to catalog management including [Product](/database/models/product.md) lifecycle, single product page rendering, product card rendering, and [Coupon](/database/models/coupon.md) management.
4
+
5
+ ## Product Lifecycle
6
+
7
+ Hooks that fire during product create/update/duplicate operations in the admin.
8
+
9
+ ### ` product_duplicated `
10
+
11
+ `fluent_cart/product_duplicated` — Fired after a product is duplicated
12
+
13
+ **When it runs:** This action fires after a [Product](/database/models/product.md) has been fully duplicated, including all variants, taxonomy terms, and post meta. The database transaction has already been committed when this hook runs.
14
+
15
+ **Parameters:**
16
+
17
+ - `$data` (array): Duplication result data
18
+
19
+ ```
20
+ $data = [
21
+ 'original_product_id' => 123, // (int) The source product's post ID
22
+ 'new_product_id' => 456, // (int) The newly created product's post ID
23
+ 'options' => [
24
+ 'import_stock_management' => true, // (bool) Whether stock settings were copied
25
+ 'import_license_settings' => true, // (bool) Whether license settings were copied
26
+ 'import_downloadable_files' => false, // (bool) Whether downloadable files were copied
27
+ ],
28
+ ];
29
+ ```
30
+
31
+ **Source:** `app/Models/Product.php`
32
+
33
+ **Usage:**
34
+
35
+ ```
36
+ add_action('fluent_cart/product_duplicated', function($data) {
37
+ $originalId = $data['original_product_id'];
38
+ $newId = $data['new_product_id'];
39
+
40
+ // Copy custom meta that the core duplication doesn't handle
41
+ $custom = get_post_meta($originalId, '_my_custom_field', true);
42
+ if ($custom) {
43
+ update_post_meta($newId, '_my_custom_field', $custom);
44
+ }
45
+ }, 10, 1);
46
+ ```
47
+
48
+ ### ` product_updated `
49
+
50
+ `fluent_cart/product_updated` — Fired when a product is updated via the admin API
51
+
52
+ **When it runs:** This action fires after a product has been successfully updated through the admin REST API (ProductController). It runs after `ProductResource::update()` has persisted all changes, including variants and product details.
53
+
54
+ **Parameters:**
55
+
56
+ - `$data` (array): Contains the raw request data and the updated [Product](/database/models/product.md) model
57
+
58
+ ```
59
+ $data = [
60
+ 'data' => [ // (array) Sanitized request payload
61
+ 'title' => 'Product Name',
62
+ 'detail' => [
63
+ 'variation_type' => 'simple',
64
+ // ... other product detail fields
65
+ ],
66
+ 'variants' => [
67
+ // ... variant data
68
+ ],
69
+ ],
70
+ 'product' => $product, // (Product model) The updated Product instance
71
+ ];
72
+ ```
73
+
74
+ **Source:** `app/Http/Controllers/ProductController.php`
75
+
76
+ **Usage:**
77
+
78
+ ```
79
+ add_action('fluent_cart/product_updated', function($data) {
80
+ $product = $data['product'];
81
+
82
+ // Sync product to an external inventory system
83
+ do_action('my_plugin/sync_inventory', [
84
+ 'product_id' => $product->ID,
85
+ 'title' => $product->post_title,
86
+ ]);
87
+
88
+ // Clear any cached product data
89
+ wp_cache_delete('fct_product_' . $product->ID, 'fluent_cart');
90
+ }, 10, 1);
91
+ ```
92
+
93
+ ---
94
+
95
+ ## Single Product Page Rendering
96
+
97
+ Hooks that fire during the server-side rendering of a single product page. All rendering hooks use **output buffering** -- your callback should `echo` HTML directly rather than return a value.
98
+
99
+ ### ` render_product_header `
100
+
101
+ `fluent_cart/product/render_product_header` — Before the single product page content
102
+
103
+ **When it runs:** This action fires at the very top of a single product page, before the main post content is rendered. Output is captured via `ob_start()` / `ob_get_clean()` and prepended to the product content.
104
+
105
+ **Parameters:**
106
+
107
+ - `$postId` (int): The product's WordPress post ID
108
+
109
+ **Source:** `app/Modules/Templating/TemplateActions.php`
110
+
111
+ **Usage:**
112
+
113
+ ```
114
+ add_action('fluent_cart/product/render_product_header', function($postId) {
115
+ // Display a promotional banner above the product
116
+ echo '<div class="my-promo-banner">Free shipping on this item!</div>';
117
+ }, 10, 1);
118
+ ```
119
+
120
+ ### ` after_product_content `
121
+
122
+ `fluent_cart/product/after_product_content` — After the single product page content
123
+
124
+ **When it runs:** This action fires immediately after the main product content on a single product page. Output is captured via `ob_start()` / `ob_get_clean()` and appended to the product content.
125
+
126
+ **Parameters:**
127
+
128
+ - `$postId` (int): The product's WordPress post ID
129
+
130
+ **Source:** `app/Modules/Templating/TemplateActions.php`
131
+
132
+ **Usage:**
133
+
134
+ ```
135
+ add_action('fluent_cart/product/after_product_content', function($postId) {
136
+ // Add a trust badge section below the product
137
+ echo '<div class="trust-badges">';
138
+ echo '<span>30-day money back guarantee</span>';
139
+ echo '</div>';
140
+ }, 10, 1);
141
+ ```
142
+
143
+ ### ` product_archive `
144
+
145
+ `fluent_cart/template/product_archive` — Render the product archive/taxonomy page
146
+
147
+ **When it runs:** This action fires when a product taxonomy archive page (category, tag, etc.) is being rendered. It is triggered inside `renderMainContent()` when the current page is a taxonomy page for `fluent-products`.
148
+
149
+ **Parameters:**
150
+
151
+ None.
152
+
153
+ **Source:** `app/Modules/Templating/TemplateActions.php`
154
+
155
+ **Usage:**
156
+
157
+ ```
158
+ add_action('fluent_cart/template/product_archive', function() {
159
+ // Render a custom product archive layout
160
+ echo '<div class="my-custom-archive">';
161
+ // ... your custom archive rendering
162
+ echo '</div>';
163
+ }, 10, 0);
164
+ ```
165
+
166
+ ### ` before_price_block `
167
+
168
+ `fluent_cart/product/single/before_price_block` — Before the price block on a single product page
169
+
170
+ **When it runs:** This action fires immediately before the price wrapper `` is rendered on a single product page. It fires in two contexts: once for simple products showing a single price, and once for multi-variant products showing the selected variant's price.
171
+
172
+ **Parameters:**
173
+
174
+ - `$data` (array): Price block context
175
+
176
+ ```
177
+ $data = [
178
+ 'product' => $product, // (Product model) The current product
179
+ 'current_price' => 5000, // (int) Price in cents
180
+ 'scope' => 'price_range', // (string) 'price_range' for simple products,
181
+ // 'product_variant_price' for variant pricing
182
+ ];
183
+ ```
184
+
185
+ **Source:** `app/Services/Renderer/ProductRenderer.php`
186
+
187
+ **Usage:**
188
+
189
+ ```
190
+ add_action('fluent_cart/product/single/before_price_block', function($data) {
191
+ if ($data['scope'] === 'price_range') {
192
+ echo '<div class="price-label">Our Price:</div>';
193
+ }
194
+ }, 10, 1);
195
+ ```
196
+
197
+ ### ` after_price (single & card) `
198
+
199
+ `fluent_cart/product/after_price` — Inline after the price is rendered
200
+
201
+ **When it runs:** This action fires inline immediately after a price value is echoed, while still inside the price `` or ``. It fires in multiple contexts: simple product prices, price ranges, individual variant prices, and product cards. Use the `scope` key to distinguish between contexts.
202
+
203
+ **Parameters:**
204
+
205
+ - `$data` (array): Price context
206
+
207
+ ```
208
+ $data = [
209
+ 'product' => $product, // (Product model) The current product
210
+ 'current_price' => 5000, // (int) Price in cents
211
+ 'scope' => 'price_range', // (string) One of:
212
+ // 'price_range' - simple product or min/max range
213
+ // 'product_variant_price' - individual variant price
214
+ // 'product_card' - product card on archive/group pages
215
+ ];
216
+ ```
217
+
218
+ **Source:** `app/Services/Renderer/ProductRenderer.php`, `app/Services/Renderer/ProductCardRender.php`
219
+
220
+ **Usage:**
221
+
222
+ ```
223
+ add_action('fluent_cart/product/after_price', function($data) {
224
+ // Show a "per unit" label next to the price
225
+ if ($data['scope'] === 'product_variant_price') {
226
+ echo '<span class="per-unit"> / unit</span>';
227
+ }
228
+
229
+ // Show a sale badge on product cards
230
+ if ($data['scope'] === 'product_card') {
231
+ echo '<span class="sale-badge">Sale</span>';
232
+ }
233
+ }, 10, 1);
234
+ ```
235
+
236
+ ### ` after_price_block `
237
+
238
+ `fluent_cart/product/single/after_price_block` — After the price block wrapper closes on a single product page
239
+
240
+ **When it runs:** This action fires immediately after the closing `` of the price block on a single product page. Like `before_price_block`, it fires in two contexts: simple product pricing and variant pricing.
241
+
242
+ **Parameters:**
243
+
244
+ - `$data` (array): Price block context
245
+
246
+ ```
247
+ $data = [
248
+ 'product' => $product, // (Product model) The current product
249
+ 'current_price' => 5000, // (int) Price in cents
250
+ 'scope' => 'price_range', // (string) 'price_range' for simple products,
251
+ // 'product_variant_price' for variant pricing
252
+ ];
253
+ ```
254
+
255
+ **Source:** `app/Services/Renderer/ProductRenderer.php`
256
+
257
+ **Usage:**
258
+
259
+ ```
260
+ add_action('fluent_cart/product/single/after_price_block', function($data) {
261
+ // Add installment info below the price
262
+ $monthly = \FluentCart\App\Helpers\Helper::toDecimal(intval($data['current_price'] / 3));
263
+ echo '<p class="installment-info">Or 3 payments of ' . esc_html($monthly) . '</p>';
264
+ }, 10, 1);
265
+ ```
266
+
267
+ ### ` before_price_range_block `
268
+
269
+ `fluent_cart/product/single/before_price_range_block` — Before the price range block for multi-variant products
270
+
271
+ **When it runs:** This action fires before the min-max price range `` is rendered on multi-variant products (products with more than one variant that show a "from X - Y" price range). It does **not** fire for simple products.
272
+
273
+ **Parameters:**
274
+
275
+ - `$data` (array): Price range context
276
+
277
+ ```
278
+ $data = [
279
+ 'product' => $product, // (Product model) The current product
280
+ 'current_price' => 2000, // (int) Minimum price in cents
281
+ 'scope' => 'price_range',
282
+ ];
283
+ ```
284
+
285
+ **Source:** `app/Services/Renderer/ProductRenderer.php`
286
+
287
+ **Usage:**
288
+
289
+ ```
290
+ add_action('fluent_cart/product/single/before_price_range_block', function($data) {
291
+ echo '<div class="pricing-note">Choose a plan below:</div>';
292
+ }, 10, 1);
293
+ ```
294
+
295
+ ### ` after_price_range_block `
296
+
297
+ `fluent_cart/product/single/after_price_range_block` — After the price range block for multi-variant products
298
+
299
+ **When it runs:** This action fires after the closing `` of the min-max price range block on multi-variant products. It does **not** fire for simple products.
300
+
301
+ **Parameters:**
302
+
303
+ - `$data` (array): Price range context
304
+
305
+ ```
306
+ $data = [
307
+ 'product' => $product, // (Product model) The current product
308
+ 'current_price' => 2000, // (int) Minimum price in cents
309
+ 'scope' => 'price_range',
310
+ ];
311
+ ```
312
+
313
+ **Source:** `app/Services/Renderer/ProductRenderer.php`
314
+
315
+ **Usage:**
316
+
317
+ ```
318
+ add_action('fluent_cart/product/single/after_price_range_block', function($data) {
319
+ echo '<p class="bulk-discount">Bulk discounts available for 10+ licenses.</p>';
320
+ }, 10, 1);
321
+ ```
322
+
323
+ ### ` before_variant_item `
324
+
325
+ `fluent_cart/product/single/before_variant_item` — Before each variant item in the variant list
326
+
327
+ **When it runs:** This action fires before each individual [ProductVariation](/database/models/product-variation.md) option is rendered in the variant selection list. It fires once per variant, inside the `foreach` loop that iterates over sorted variants. It fires in both the standard variant list and the tabbed (subscription/onetime) variant layout.
328
+
329
+ **Parameters:**
330
+
331
+ - `$data` (array): Variant item context
332
+
333
+ ```
334
+ $data = [
335
+ 'product' => $product, // (Product model) The current product
336
+ 'variant' => $variant, // (ProductVariant model) The current variant being rendered
337
+ 'scope' => 'product_variant_item',
338
+ ];
339
+ ```
340
+
341
+ **Source:** `app/Services/Renderer/ProductRenderer.php`
342
+
343
+ **Usage:**
344
+
345
+ ```
346
+ add_action('fluent_cart/product/single/before_variant_item', function($data) {
347
+ $variant = $data['variant'];
348
+
349
+ // Add a "Most Popular" badge before a specific variant
350
+ if ($variant->id === 42) {
351
+ echo '<div class="popular-badge">Most Popular</div>';
352
+ }
353
+ }, 10, 1);
354
+ ```
355
+
356
+ ### ` after_variant_item `
357
+
358
+ `fluent_cart/product/single/after_variant_item` — After each variant item in the variant list
359
+
360
+ **When it runs:** This action fires after each individual variant option is rendered in the variant selection list. It fires once per variant, immediately after `renderVariationItem()` completes. It fires in both the standard variant list and the tabbed variant layout.
361
+
362
+ **Parameters:**
363
+
364
+ - `$data` (array): Variant item context
365
+
366
+ ```
367
+ $data = [
368
+ 'product' => $product, // (Product model) The current product
369
+ 'variant' => $variant, // (ProductVariant model) The current variant being rendered
370
+ 'scope' => 'product_variant_item',
371
+ ];
372
+ ```
373
+
374
+ **Source:** `app/Services/Renderer/ProductRenderer.php`
375
+
376
+ **Usage:**
377
+
378
+ ```
379
+ add_action('fluent_cart/product/single/after_variant_item', function($data) {
380
+ $variant = $data['variant'];
381
+
382
+ // Show remaining stock below each variant
383
+ if ($variant->stock_quantity > 0 && $variant->stock_quantity < 10) {
384
+ echo '<span class="low-stock">Only ' . esc_html($variant->stock_quantity) . ' left!</span>';
385
+ }
386
+ }, 10, 1);
387
+ ```
388
+
389
+ ### ` before_quantity_block `
390
+
391
+ `fluent_cart/product/single/before_quantity_block` — Before the quantity selector on a single product page
392
+
393
+ **When it runs:** This action fires immediately before the quantity input container is rendered on a single product page. It only fires if the product allows quantity selection (not hidden by sold-individually or other conditions).
394
+
395
+ **Parameters:**
396
+
397
+ - `$data` (array): Quantity block context
398
+
399
+ ```
400
+ $data = [
401
+ 'product' => $product, // (Product model) The current product
402
+ 'scope' => 'product_quantity_block',
403
+ ];
404
+ ```
405
+
406
+ **Source:** `app/Services/Renderer/ProductRenderer.php`
407
+
408
+ **Usage:**
409
+
410
+ ```
411
+ add_action('fluent_cart/product/single/before_quantity_block', function($data) {
412
+ echo '<p class="quantity-hint">Select your desired quantity:</p>';
413
+ }, 10, 1);
414
+ ```
415
+
416
+ ### ` after_quantity_block `
417
+
418
+ `fluent_cart/product/single/after_quantity_block` — After the quantity selector on a single product page
419
+
420
+ **When it runs:** This action fires immediately after the quantity input container is rendered on a single product page, after the closing `` of the quantity wrapper.
421
+
422
+ **Parameters:**
423
+
424
+ - `$data` (array): Quantity block context
425
+
426
+ ```
427
+ $data = [
428
+ 'product' => $product, // (Product model) The current product
429
+ 'scope' => 'product_quantity_block',
430
+ ];
431
+ ```
432
+
433
+ **Source:** `app/Services/Renderer/ProductRenderer.php`
434
+
435
+ **Usage:**
436
+
437
+ ```
438
+ add_action('fluent_cart/product/single/after_quantity_block', function($data) {
439
+ // Show bulk pricing table after the quantity selector
440
+ echo '<div class="bulk-pricing">';
441
+ echo '<small>Buy 5+ and save 10% &bull; Buy 10+ and save 20%</small>';
442
+ echo '</div>';
443
+ }, 10, 1);
444
+ ```
445
+
446
+ ---
447
+
448
+ ## Product Card Rendering (Archive / Group Pages)
449
+
450
+ Hooks that fire during server-side rendering of product cards on archive pages, product group blocks, and shop listings. All rendering hooks use **output buffering** -- your callback should `echo` HTML directly.
451
+
452
+ ### ` group/before_image_block `
453
+
454
+ `fluent_cart/product/group/before_image_block` — Before the product card image
455
+
456
+ **When it runs:** This action fires before the product card image link and `` tag are rendered inside a product card on archive or group pages.
457
+
458
+ **Parameters:**
459
+
460
+ - `$data` (array): Product card context
461
+
462
+ ```
463
+ $data = [
464
+ 'product' => $product, // (Product model) The current product
465
+ 'scope' => 'product_card',
466
+ ];
467
+ ```
468
+
469
+ **Source:** `app/Services/Renderer/ProductCardRender.php`
470
+
471
+ **Usage:**
472
+
473
+ ```
474
+ add_action('fluent_cart/product/group/before_image_block', function($data) {
475
+ // Add a "New" ribbon over the product card image
476
+ $product = $data['product'];
477
+ $created = strtotime($product->post_date);
478
+ if ($created > strtotime('-30 days')) {
479
+ echo '<span class="new-ribbon">New</span>';
480
+ }
481
+ }, 10, 1);
482
+ ```
483
+
484
+ ### ` group/after_image_block `
485
+
486
+ `fluent_cart/product/group/after_image_block` — After the product card image
487
+
488
+ **When it runs:** This action fires immediately after the product card image link closes, before the rest of the card content (title, price, button) is rendered.
489
+
490
+ **Parameters:**
491
+
492
+ - `$data` (array): Product card context
493
+
494
+ ```
495
+ $data = [
496
+ 'product' => $product, // (Product model) The current product
497
+ 'scope' => 'product_card',
498
+ ];
499
+ ```
500
+
501
+ **Source:** `app/Services/Renderer/ProductCardRender.php`
502
+
503
+ **Usage:**
504
+
505
+ ```
506
+ add_action('fluent_cart/product/group/after_image_block', function($data) {
507
+ // Add a quick-view button overlay after the image
508
+ echo '<button class="quick-view-btn" data-product="' . esc_attr($data['product']->ID) . '">Quick View</button>';
509
+ }, 10, 1);
510
+ ```
511
+
512
+ ### ` group/before_price_block `
513
+
514
+ `fluent_cart/product/group/before_price_block` — Before the price section in product cards
515
+
516
+ **When it runs:** This action fires before the price wrapper `` is rendered inside a product card on archive or group pages.
517
+
518
+ **Parameters:**
519
+
520
+ - `$data` (array): Product card price context
521
+
522
+ ```
523
+ $data = [
524
+ 'product' => $product, // (Product model) The current product
525
+ 'current_price' => 2000, // (int) Minimum price in cents
526
+ 'scope' => 'product_card',
527
+ ];
528
+ ```
529
+
530
+ **Source:** `app/Services/Renderer/ProductCardRender.php`
531
+
532
+ **Usage:**
533
+
534
+ ```
535
+ add_action('fluent_cart/product/group/before_price_block', function($data) {
536
+ // Show a "Starting at" label before the price
537
+ echo '<span class="price-prefix">Starting at</span>';
538
+ }, 10, 1);
539
+ ```
540
+
541
+ ### ` group/after_price_block `
542
+
543
+ `fluent_cart/product/group/after_price_block` — After the price section in product cards
544
+
545
+ **When it runs:** This action fires immediately after the closing `` of the product card price wrapper, after prices and the inline `fluent_cart/product/after_price` hook have been rendered.
546
+
547
+ **Parameters:**
548
+
549
+ - `$data` (array): Product card price context
550
+
551
+ ```
552
+ $data = [
553
+ 'product' => $product, // (Product model) The current product
554
+ 'current_price' => 2000, // (int) Minimum price in cents
555
+ 'scope' => 'product_card',
556
+ ];
557
+ ```
558
+
559
+ **Source:** `app/Services/Renderer/ProductCardRender.php`
560
+
561
+ **Usage:**
562
+
563
+ ```
564
+ add_action('fluent_cart/product/group/after_price_block', function($data) {
565
+ // Show a short feature list below the price on product cards
566
+ $features = get_post_meta($data['product']->ID, '_card_features', true);
567
+ if ($features) {
568
+ echo '<ul class="card-features">';
569
+ foreach ((array) $features as $feature) {
570
+ echo '<li>' . esc_html($feature) . '</li>';
571
+ }
572
+ echo '</ul>';
573
+ }
574
+ }, 10, 1);
575
+ ```
576
+
577
+ ---
578
+
579
+ ## Product Card & Single-Page Render Hooks
580
+
581
+ Positional markers wrapping the card and single-product-page blocks (title, excerpt, purchase actions), plus a data hook that fires after a batch of variants is saved. Unlike the `$data`-array hooks above, these pass a `$gateContext` array built by `RenderGate::context()` / `RenderContext::decorate()` -- at minimum `'product'` (the current [Product](/database/models/product.md) model) and `'scope'` (a `RenderGate::SCOPE_*` constant, `'card'` or `'single'`). All rendering hooks here use **output buffering** -- your callback should `echo` HTML directly rather than return a value.
582
+
583
+ ### ` product/group/before_card `
584
+
585
+ `fluent_cart/product/group/before_card` — Before a product card's opening `` tag
586
+
587
+ **When it runs:** Fires on archive/group/shop listings immediately before the `` wrapper for a single product card is opened.
588
+
589
+ **Parameters:**
590
+
591
+ - `$gateContext` (array): The render gate context for this card. Built here via `RenderContext::decorate(['product' => $this->product, 'scope' => RenderGate::SCOPE_CARD])`.
592
+
593
+ ```
594
+ $gateContext = [
595
+ 'product' => $product, // \FluentCart\App\Models\Product
596
+ 'scope' => RenderGate::SCOPE_CARD, // 'card'
597
+ ];
598
+ ```
599
+
600
+ **Source:** `app/Services/Renderer/ProductCardRender.php:75`
601
+
602
+ **Usage:**
603
+
604
+ ```
605
+ add_action('fluent_cart/product/group/before_card', function ($gateContext) {
606
+ // Wrap featured products in a highlight container
607
+ if (get_post_meta($gateContext['product']->ID, '_is_featured', true)) {
608
+ echo '<div class="fct-featured-card-wrap">';
609
+ }
610
+ }, 10, 1);
611
+ ```
612
+
613
+ ### ` product/group/after_card `
614
+
615
+ `fluent_cart/product/group/after_card` — After a product card's closing `` tag
616
+
617
+ **When it runs:** Fires on archive/group/shop listings immediately after a product card's `` tag closes, once the buy button has already been rendered.
618
+
619
+ **Parameters:**
620
+
621
+ - `$gateContext` (array): The render gate context for this card.
622
+
623
+ ```
624
+ $gateContext = [
625
+ 'product' => $product, // \FluentCart\App\Models\Product
626
+ 'scope' => RenderGate::SCOPE_CARD, // 'card'
627
+ ];
628
+ ```
629
+
630
+ **Source:** `app/Services/Renderer/ProductCardRender.php:95`
631
+
632
+ **Usage:**
633
+
634
+ ```
635
+ add_action('fluent_cart/product/group/after_card', function ($gateContext) {
636
+ // Close the featured-product wrapper opened in before_card
637
+ if (get_post_meta($gateContext['product']->ID, '_is_featured', true)) {
638
+ echo '</div>';
639
+ }
640
+ }, 10, 1);
641
+ ```
642
+
643
+ ### ` product/group/before_title_block `
644
+
645
+ `fluent_cart/product/group/before_title_block` — Before the product card title
646
+
647
+ **When it runs:** Fires inside `renderTitle()` on a product card, immediately before the title link/text is echoed.
648
+
649
+ **Parameters:**
650
+
651
+ - `$gateContext` (array): The render gate context for this card (at minimum `'product'` and `'scope' => RenderGate::SCOPE_CARD`).
652
+
653
+ **Source:** `app/Services/Renderer/ProductCardRender.php:171`
654
+
655
+ **Usage:**
656
+
657
+ ```
658
+ add_action('fluent_cart/product/group/before_title_block', function ($gateContext) {
659
+ // Show a category eyebrow above the card title
660
+ $term = get_the_terms($gateContext['product']->ID, 'product-category');
661
+ if ($term && !is_wp_error($term)) {
662
+ echo '<span class="fct-card-eyebrow">' . esc_html($term[0]->name) . '</span>';
663
+ }
664
+ }, 10, 1);
665
+ ```
666
+
667
+ ### ` product/group/after_title_block `
668
+
669
+ `fluent_cart/product/group/after_title_block` — After the product card title
670
+
671
+ **When it runs:** Fires inside `renderTitle()` on a product card, immediately after the title markup is echoed.
672
+
673
+ **Parameters:**
674
+
675
+ - `$gateContext` (array): The render gate context for this card (at minimum `'product'` and `'scope' => RenderGate::SCOPE_CARD`).
676
+
677
+ **Source:** `app/Services/Renderer/ProductCardRender.php:205`
678
+
679
+ **Usage:**
680
+
681
+ ```
682
+ add_action('fluent_cart/product/group/after_title_block', function ($gateContext) {
683
+ // Show a star rating summary right under the card title
684
+ echo do_shortcode('[my_reviews_stars id="' . esc_attr($gateContext['product']->ID) . '"]');
685
+ }, 10, 1);
686
+ ```
687
+
688
+ ### ` product/group/before_excerpt_block `
689
+
690
+ `fluent_cart/product/group/before_excerpt_block` — Before the product card excerpt
691
+
692
+ **When it runs:** Fires inside `renderExcerpt()`/similar on a product card, immediately before the `` is echoed.
693
+
694
+ **Parameters:**
695
+
696
+ - `$gateContext` (array): The render gate context for this card (at minimum `'product'` and `'scope' => RenderGate::SCOPE_CARD`).
697
+
698
+ **Source:** `app/Services/Renderer/ProductCardRender.php:150`
699
+
700
+ **Usage:**
701
+
702
+ ```
703
+ add_action('fluent_cart/product/group/before_excerpt_block', function ($gateContext) {
704
+ echo '<span class="fct-card-highlight">Best Seller</span>';
705
+ }, 10, 1);
706
+ ```
707
+
708
+ ### ` product/group/after_excerpt_block `
709
+
710
+ `fluent_cart/product/group/after_excerpt_block` — After the product card excerpt
711
+
712
+ **When it runs:** Fires on a product card immediately after the excerpt `` markup is echoed.
713
+
714
+ **Parameters:**
715
+
716
+ - `$gateContext` (array): The render gate context for this card (at minimum `'product'` and `'scope' => RenderGate::SCOPE_CARD`).
717
+
718
+ **Source:** `app/Services/Renderer/ProductCardRender.php:160`
719
+
720
+ **Usage:**
721
+
722
+ ```
723
+ add_action('fluent_cart/product/group/after_excerpt_block', function ($gateContext) {
724
+ echo '<a class="fct-card-readmore" href="' . esc_url(get_permalink($gateContext['product']->ID)) . '">Read more</a>';
725
+ }, 10, 1);
726
+ ```
727
+
728
+ ### ` product/group/before_actions_block `
729
+
730
+ `fluent_cart/product/group/before_actions_block` — Before the buy button row on a product card
731
+
732
+ **When it runs:** Fires on a product card immediately before `renderBuyButtonMarkup()` renders the add-to-cart/buy-now buttons.
733
+
734
+ **Parameters:**
735
+
736
+ - `$gateContext` (array): The render gate context for this card (at minimum `'product'` and `'scope' => RenderGate::SCOPE_CARD`).
737
+
738
+ **Source:** `app/Services/Renderer/ProductCardRender.php:362`
739
+
740
+ **Usage:**
741
+
742
+ ```
743
+ add_action('fluent_cart/product/group/before_actions_block', function ($gateContext) {
744
+ // Wishlist icon before the buy button
745
+ echo '<button class="fct-wishlist-btn" data-product-id="' . esc_attr($gateContext['product']->ID) . '">&hearts;</button>';
746
+ }, 10, 1);
747
+ ```
748
+
749
+ ### ` product/group/after_actions_block `
750
+
751
+ `fluent_cart/product/group/after_actions_block` — After the buy button row on a product card
752
+
753
+ **When it runs:** Fires on a product card immediately after `renderBuyButtonMarkup()` has rendered the add-to-cart/buy-now buttons.
754
+
755
+ **Parameters:**
756
+
757
+ - `$gateContext` (array): The render gate context for this card (at minimum `'product'` and `'scope' => RenderGate::SCOPE_CARD`).
758
+
759
+ **Source:** `app/Services/Renderer/ProductCardRender.php:366`
760
+
761
+ **Usage:**
762
+
763
+ ```
764
+ add_action('fluent_cart/product/group/after_actions_block', function ($gateContext) {
765
+ // Social share icons below the buy button
766
+ echo '<div class="fct-card-share">' . do_shortcode('[addtoany]') . '</div>';
767
+ }, 10, 1);
768
+ ```
769
+
770
+ ### ` product/single/before_title_block `
771
+
772
+ `fluent_cart/product/single/before_title_block` — Before the `` title on a single product page
773
+
774
+ **When it runs:** Fires on a single product page immediately before the `` / `` wrapper is rendered.
775
+
776
+ **Parameters:**
777
+
778
+ - `$gateContext` (array): The render gate context for the single product page, typically carrying at least `'product'` (this [Product](/database/models/product.md) model) and `'scope' => RenderGate::SCOPE_SINGLE`.
779
+
780
+ **Source:** `app/Services/Renderer/ProductRenderer.php:725`
781
+
782
+ **Usage:**
783
+
784
+ ```
785
+ add_action('fluent_cart/product/single/before_title_block', function ($gateContext) {
786
+ // Breadcrumb above the product title
787
+ echo '<nav class="fct-breadcrumb">' . get_the_term_list($gateContext['product']->ID, 'product-category', '', ', ') . '</nav>';
788
+ }, 10, 1);
789
+ ```
790
+
791
+ ### ` product/single/after_title_block `
792
+
793
+ `fluent_cart/product/single/after_title_block` — After the `` title on a single product page
794
+
795
+ **When it runs:** Fires on a single product page immediately after the product title `` and its wrapper `` close.
796
+
797
+ **Parameters:**
798
+
799
+ - `$gateContext` (array): The render gate context for the single product page, typically carrying at least `'product'` and `'scope' => RenderGate::SCOPE_SINGLE`.
800
+
801
+ **Source:** `app/Services/Renderer/ProductRenderer.php:731`
802
+
803
+ **Usage:**
804
+
805
+ ```
806
+ add_action('fluent_cart/product/single/after_title_block', function ($gateContext) {
807
+ echo do_shortcode('[my_reviews_stars id="' . esc_attr($gateContext['product']->ID) . '" show_count="1"]');
808
+ }, 10, 1);
809
+ ```
810
+
811
+ ### ` product/single/before_excerpt_block `
812
+
813
+ `fluent_cart/product/single/before_excerpt_block` — Before the excerpt on a single product page
814
+
815
+ **When it runs:** Fires on a single product page immediately before the `` wrapper is rendered (only when the product has an excerpt).
816
+
817
+ **Parameters:**
818
+
819
+ - `$gateContext` (array): The render gate context for the single product page, typically carrying at least `'product'` and `'scope' => RenderGate::SCOPE_SINGLE`.
820
+
821
+ **Source:** `app/Services/Renderer/ProductRenderer.php:942`
822
+
823
+ **Usage:**
824
+
825
+ ```
826
+ add_action('fluent_cart/product/single/before_excerpt_block', function ($gateContext) {
827
+ echo '<span class="fct-single-highlight">Limited stock</span>';
828
+ }, 10, 1);
829
+ ```
830
+
831
+ ### ` product/single/after_excerpt_block `
832
+
833
+ `fluent_cart/product/single/after_excerpt_block` — After the excerpt on a single product page
834
+
835
+ **When it runs:** Fires on a single product page immediately after the product excerpt `` wrapper closes.
836
+
837
+ **Parameters:**
838
+
839
+ - `$gateContext` (array): The render gate context for the single product page, typically carrying at least `'product'` and `'scope' => RenderGate::SCOPE_SINGLE`.
840
+
841
+ **Source:** `app/Services/Renderer/ProductRenderer.php:948`
842
+
843
+ **Usage:**
844
+
845
+ ```
846
+ add_action('fluent_cart/product/single/after_excerpt_block', function ($gateContext) {
847
+ // Trust badges below the excerpt
848
+ echo '<div class="fct-trust-badges"><span>30-day guarantee</span><span>Secure checkout</span></div>';
849
+ }, 10, 1);
850
+ ```
851
+
852
+ ### ` product/single/before_actions_block `
853
+
854
+ `fluent_cart/product/single/before_actions_block` — Before the buy-now / add-to-cart buttons on a single product page
855
+
856
+ **When it runs:** Fires on a single product page immediately before `renderBuyNowButton()` and `renderAddToCartButton()` render the purchase buttons.
857
+
858
+ **Parameters:**
859
+
860
+ - `$gateContext` (array): The render gate context for the single product page, typically carrying at least `'product'` and `'scope' => RenderGate::SCOPE_SINGLE`.
861
+
862
+ **Source:** `app/Services/Renderer/ProductRenderer.php:1424`
863
+
864
+ **Usage:**
865
+
866
+ ```
867
+ add_action('fluent_cart/product/single/before_actions_block', function ($gateContext) {
868
+ // Urgency message above the purchase buttons
869
+ if ($gateContext['product']->getStockQuantity() < 5) {
870
+ echo '<p class="fct-urgency">Only a few left in stock!</p>';
871
+ }
872
+ }, 10, 1);
873
+ ```
874
+
875
+ ### ` product/single/after_actions_block `
876
+
877
+ `fluent_cart/product/single/after_actions_block` — After the buy-now / add-to-cart buttons on a single product page
878
+
879
+ **When it runs:** Fires on a single product page immediately after `renderBuyNowButton()` and `renderAddToCartButton()` have rendered the purchase buttons.
880
+
881
+ **Parameters:**
882
+
883
+ - `$gateContext` (array): The render gate context for the single product page, typically carrying at least `'product'` and `'scope' => RenderGate::SCOPE_SINGLE`.
884
+
885
+ **Source:** `app/Services/Renderer/ProductRenderer.php:1430`
886
+
887
+ **Usage:**
888
+
889
+ ```
890
+ add_action('fluent_cart/product/single/after_actions_block', function ($gateContext) {
891
+ // Accepted payment icons below the purchase buttons
892
+ echo '<div class="fct-payment-icons"><img src="' . esc_url(FLUENTCART_PLUGIN_URL . 'assets/images/payment-icons.svg') . '" alt="" /></div>';
893
+ }, 10, 1);
894
+ ```
895
+
896
+ ### ` product/variants_updated `
897
+
898
+ `fluent_cart/product/variants_updated` — Fired after a batch of product variants is saved
899
+
900
+ **When it runs:** Fires after a product's variants have been persisted, whether through the bulk variant-update endpoint, a single-variant field update, or (in Pro) the advanced-variation save path. Listen here once instead of duplicating logic across every variant-save entry point.
901
+
902
+ **Parameters:**
903
+
904
+ - `$data` (array): Updated variant batch
905
+
906
+ ```
907
+ $data = [
908
+ 'post_id' => 456, // (int) The product's WordPress post ID
909
+ 'variants' => $batchData, // (array) The variant records that were just written
910
+ ];
911
+ ```
912
+
913
+ **Source:**
914
+
915
+ - `app/Http/Controllers/ProductVariationController.php:387` (bulk variant update)
916
+ - `app/Http/Controllers/ProductVariationController.php:649` (single-variant field update)
917
+ - `app/Services/AdvancedVariationService.php:280` (Pro's advanced-variation save path)
918
+
919
+ **Usage:**
920
+
921
+ ```
922
+ add_action('fluent_cart/product/variants_updated', function ($data) {
923
+ // Push the new variant stock/prices to an external inventory system
924
+ do_action('my_plugin/sync_variants', $data['post_id'], $data['variants']);
925
+ }, 10, 1);
926
+ ```
927
+
928
+ ---
929
+
930
+ ## Coupons
931
+
932
+ Hooks that fire during [Coupon](/database/models/coupon.md) create and update operations in the admin.
933
+
934
+ ### ` coupon_created `
935
+
936
+ `fluent_cart/coupon_created` — Fired after a new coupon is created via the admin
937
+
938
+ **When it runs:** This action fires after a [Coupon](/database/models/coupon.md) has been successfully created through the admin REST API. It runs after `CouponResource::create()` has persisted the coupon and after the activity log entry has been recorded.
939
+
940
+ **Parameters:**
941
+
942
+ - `$data` (array): [Coupon](/database/models/coupon.md) creation data
943
+
944
+ ```
945
+ $data = [
946
+ 'data' => [ // (array) Sanitized request payload
947
+ 'title' => 'SAVE20',
948
+ 'type' => 'percentage', // 'percentage' or 'fixed'
949
+ 'amount' => 2000, // (int) Discount amount in cents (or percentage value)
950
+ 'start_date' => '2026-01-01 00:00:00', // (string|null) GMT start date
951
+ 'end_date' => '2026-12-31 23:59:59', // (string|null) GMT end date
952
+ 'conditions' => [
953
+ 'is_recurring' => 'no',
954
+ // ... other condition fields
955
+ ],
956
+ ],
957
+ 'coupon' => $coupon, // (Coupon model) The newly created Coupon instance
958
+ ];
959
+ ```
960
+
961
+ **Source:** `app/Http/Controllers/CouponsController.php`
962
+
963
+ **Usage:**
964
+
965
+ ```
966
+ add_action('fluent_cart/coupon_created', function($data) {
967
+ $coupon = $data['coupon'];
968
+
969
+ // Notify marketing team about the new coupon
970
+ wp_mail(
971
+ '[email&#160;protected]',
972
+ 'New Coupon Created: ' . $coupon->title,
973
+ 'A new coupon has been created with code: ' . $coupon->title
974
+ );
975
+ }, 10, 1);
976
+ ```
977
+
978
+ ### ` coupon_updated `
979
+
980
+ `fluent_cart/coupon_updated` — Fired after a coupon is updated via the admin
981
+
982
+ **When it runs:** This action fires after a [Coupon](/database/models/coupon.md) has been successfully updated through the admin REST API. It runs after `CouponResource::update()` has persisted the changes, but before the activity log entry is recorded.
983
+
984
+ **Parameters:**
985
+
986
+ - `$data` (array): Coupon update data
987
+
988
+ ```
989
+ $data = [
990
+ 'data' => [ // (array) Sanitized request payload
991
+ 'title' => 'SAVE20',
992
+ 'type' => 'percentage',
993
+ 'amount' => 2500,
994
+ 'start_date' => '2026-01-01 00:00:00',
995
+ 'end_date' => '2026-12-31 23:59:59',
996
+ 'conditions' => [
997
+ 'is_recurring' => 'no',
998
+ // ... other condition fields
999
+ ],
1000
+ ],
1001
+ 'coupon' => $coupon, // (Coupon model) The updated Coupon instance
1002
+ ];
1003
+ ```
1004
+
1005
+ **Source:** `app/Http/Controllers/CouponsController.php`
1006
+
1007
+ **Usage:**
1008
+
1009
+ ```
1010
+ add_action('fluent_cart/coupon_updated', function($data) {
1011
+ $coupon = $data['coupon'];
1012
+
1013
+ // Clear coupon validation cache when a coupon is modified
1014
+ wp_cache_delete('fct_coupon_' . $coupon->id, 'fluent_cart');
1015
+
1016
+ // Sync updated coupon to external promotion platform
1017
+ do_action('my_plugin/sync_coupon', $coupon);
1018
+ }, 10, 1);
1019
+ ```