fluentcart-developer 3.0.0 → 3.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (612) hide show
  1. package/LICENSE.md +26 -26
  2. package/README.md +59 -59
  3. package/dist/cards/fluentcart/templates-native.js +1087 -1087
  4. package/dist/cards/fluentcart/tools.js +2309 -2309
  5. package/dist/server.d.ts.map +1 -1
  6. package/dist/server.js +37 -1
  7. package/dist/server.js.map +1 -1
  8. package/dist/skills/fluentcart-developer/SKILL.md +108 -108
  9. package/dist/skills/fluentcart-developer/examples/README.md +30 -30
  10. package/dist/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/fluent-cart/checkout.php +32 -32
  11. package/dist/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/functions.php +40 -40
  12. package/dist/skills/fluentcart-developer/examples/sample-custom-addon/fluentcart-custom-addon.php +113 -113
  13. package/dist/skills/fluentcart-developer/examples/sample-custom-payment-gateway/fluentcart-custom-gateway-example.php +148 -148
  14. package/dist/skills/fluentcart-developer/examples/sample-fee-surcharge-plugin/fluentcart-fee-surcharge.php +38 -38
  15. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/README.md +22 -22
  16. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/sample-plugin-with-licensing-sdk.php +79 -79
  17. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/updater/FluentLicensing.php +303 -303
  18. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/updater/LicenseSettings.php +566 -566
  19. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/updater/PluginUpdater.php +304 -304
  20. package/dist/skills/fluentcart-developer/examples/sample-shipping-carrier/fluentcart-custom-shipping-carrier.php +61 -61
  21. package/dist/skills/fluentcart-developer/references/api/authentication.md +452 -452
  22. package/dist/skills/fluentcart-developer/references/api/coupons.md +786 -786
  23. package/dist/skills/fluentcart-developer/references/api/customers.md +889 -889
  24. package/dist/skills/fluentcart-developer/references/api/files.md +609 -609
  25. package/dist/skills/fluentcart-developer/references/api/index.md +432 -432
  26. package/dist/skills/fluentcart-developer/references/api/licensing.md +633 -633
  27. package/dist/skills/fluentcart-developer/references/api/order-bump.md +384 -384
  28. package/dist/skills/fluentcart-developer/references/api/orders.md +814 -814
  29. package/dist/skills/fluentcart-developer/references/api/products.md +866 -866
  30. package/dist/skills/fluentcart-developer/references/api/roles-permissions.md +536 -536
  31. package/dist/skills/fluentcart-developer/references/api/subscriptions.md +827 -827
  32. package/dist/skills/fluentcart-developer/references/database/index.md +44 -44
  33. package/dist/skills/fluentcart-developer/references/database/models/activity.md +178 -178
  34. package/dist/skills/fluentcart-developer/references/database/models/applied-coupon.md +291 -291
  35. package/dist/skills/fluentcart-developer/references/database/models/attribute-group.md +239 -239
  36. package/dist/skills/fluentcart-developer/references/database/models/attribute-relation.md +181 -181
  37. package/dist/skills/fluentcart-developer/references/database/models/attribute-term.md +219 -219
  38. package/dist/skills/fluentcart-developer/references/database/models/cart.md +645 -645
  39. package/dist/skills/fluentcart-developer/references/database/models/coupon.md +427 -427
  40. package/dist/skills/fluentcart-developer/references/database/models/customer-addresses.md +348 -348
  41. package/dist/skills/fluentcart-developer/references/database/models/customer-meta.md +156 -156
  42. package/dist/skills/fluentcart-developer/references/database/models/customer.md +584 -584
  43. package/dist/skills/fluentcart-developer/references/database/models/dynamic-model.md +163 -163
  44. package/dist/skills/fluentcart-developer/references/database/models/label-relationship.md +155 -155
  45. package/dist/skills/fluentcart-developer/references/database/models/label.md +153 -153
  46. package/dist/skills/fluentcart-developer/references/database/models/license-activation.md +182 -182
  47. package/dist/skills/fluentcart-developer/references/database/models/license-meta.md +163 -163
  48. package/dist/skills/fluentcart-developer/references/database/models/license-site.md +208 -208
  49. package/dist/skills/fluentcart-developer/references/database/models/license.md +640 -640
  50. package/dist/skills/fluentcart-developer/references/database/models/meta.md +233 -233
  51. package/dist/skills/fluentcart-developer/references/database/models/order-address.md +391 -391
  52. package/dist/skills/fluentcart-developer/references/database/models/order-download-permission.md +144 -144
  53. package/dist/skills/fluentcart-developer/references/database/models/order-item.md +383 -383
  54. package/dist/skills/fluentcart-developer/references/database/models/order-meta.md +303 -303
  55. package/dist/skills/fluentcart-developer/references/database/models/order-operation.md +158 -158
  56. package/dist/skills/fluentcart-developer/references/database/models/order-promotion-stat.md +175 -175
  57. package/dist/skills/fluentcart-developer/references/database/models/order-promotion.md +250 -250
  58. package/dist/skills/fluentcart-developer/references/database/models/order-tax-rate.md +172 -172
  59. package/dist/skills/fluentcart-developer/references/database/models/order-transaction.md +440 -440
  60. package/dist/skills/fluentcart-developer/references/database/models/order.md +727 -727
  61. package/dist/skills/fluentcart-developer/references/database/models/product-detail.md +397 -397
  62. package/dist/skills/fluentcart-developer/references/database/models/product-download.md +258 -258
  63. package/dist/skills/fluentcart-developer/references/database/models/product-meta.md +153 -153
  64. package/dist/skills/fluentcart-developer/references/database/models/product-variation.md +556 -556
  65. package/dist/skills/fluentcart-developer/references/database/models/product.md +580 -580
  66. package/dist/skills/fluentcart-developer/references/database/models/relationships.md +427 -427
  67. package/dist/skills/fluentcart-developer/references/database/models/scheduled-action.md +175 -175
  68. package/dist/skills/fluentcart-developer/references/database/models/shipping-class.md +148 -148
  69. package/dist/skills/fluentcart-developer/references/database/models/shipping-method.md +280 -280
  70. package/dist/skills/fluentcart-developer/references/database/models/shipping-zone.md +205 -205
  71. package/dist/skills/fluentcart-developer/references/database/models/subscription-meta.md +173 -173
  72. package/dist/skills/fluentcart-developer/references/database/models/subscription.md +528 -528
  73. package/dist/skills/fluentcart-developer/references/database/models/tax-class.md +195 -195
  74. package/dist/skills/fluentcart-developer/references/database/models/tax-rate.md +225 -225
  75. package/dist/skills/fluentcart-developer/references/database/models/user-meta.md +166 -166
  76. package/dist/skills/fluentcart-developer/references/database/models/user.md +220 -220
  77. package/dist/skills/fluentcart-developer/references/database/models.md +404 -404
  78. package/dist/skills/fluentcart-developer/references/database/query-builder.md +860 -860
  79. package/dist/skills/fluentcart-developer/references/database/readme.md +276 -276
  80. package/dist/skills/fluentcart-developer/references/database/schema.md +1002 -1002
  81. package/dist/skills/fluentcart-developer/references/engineering/adding-custom-pages-to-the-customer-dashboard.md +395 -395
  82. package/dist/skills/fluentcart-developer/references/engineering/index.md +4 -4
  83. package/dist/skills/fluentcart-developer/references/engineering.md +4 -4
  84. package/dist/skills/fluentcart-developer/references/getting-started.md +249 -249
  85. package/dist/skills/fluentcart-developer/references/guides/frontend.md +519 -519
  86. package/dist/skills/fluentcart-developer/references/guides/index.md +107 -107
  87. package/dist/skills/fluentcart-developer/references/guides/integrations.md +600 -600
  88. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/index.md +237 -237
  89. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/labels-and-tracking.md +481 -481
  90. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/live-rates.md +269 -269
  91. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/reference.md +223 -223
  92. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/settings.md +370 -370
  93. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier.md +237 -237
  94. package/dist/skills/fluentcart-developer/references/guides/subscriptions.md +217 -217
  95. package/dist/skills/fluentcart-developer/references/hooks/actions/admin-and-templates.md +1079 -1079
  96. package/dist/skills/fluentcart-developer/references/hooks/actions/cart-and-checkout.md +1795 -1795
  97. package/dist/skills/fluentcart-developer/references/hooks/actions/customers-and-users.md +327 -327
  98. package/dist/skills/fluentcart-developer/references/hooks/actions/licenses.md +829 -829
  99. package/dist/skills/fluentcart-developer/references/hooks/actions/modules.md +81 -81
  100. package/dist/skills/fluentcart-developer/references/hooks/actions/orders.md +757 -757
  101. package/dist/skills/fluentcart-developer/references/hooks/actions/payments-and-integrations.md +1163 -1163
  102. package/dist/skills/fluentcart-developer/references/hooks/actions/pro-modules.md +219 -219
  103. package/dist/skills/fluentcart-developer/references/hooks/actions/products-and-coupons.md +1019 -1019
  104. package/dist/skills/fluentcart-developer/references/hooks/actions/subscriptions.md +1290 -1290
  105. package/dist/skills/fluentcart-developer/references/hooks/actions.md +16 -16
  106. package/dist/skills/fluentcart-developer/references/hooks/deprecated.md +60 -60
  107. package/dist/skills/fluentcart-developer/references/hooks/filters/cart-and-checkout.md +2032 -2032
  108. package/dist/skills/fluentcart-developer/references/hooks/filters/customers-and-subscriptions.md +1746 -1746
  109. package/dist/skills/fluentcart-developer/references/hooks/filters/integrations-and-advanced.md +2439 -2439
  110. package/dist/skills/fluentcart-developer/references/hooks/filters/modules.md +464 -464
  111. package/dist/skills/fluentcart-developer/references/hooks/filters/orders-and-payments.md +2658 -2658
  112. package/dist/skills/fluentcart-developer/references/hooks/filters/pro-modules.md +502 -502
  113. package/dist/skills/fluentcart-developer/references/hooks/filters/products-and-pricing.md +1785 -1785
  114. package/dist/skills/fluentcart-developer/references/hooks/filters/settings-and-configuration.md +2966 -2966
  115. package/dist/skills/fluentcart-developer/references/hooks/filters.md +14 -14
  116. package/dist/skills/fluentcart-developer/references/hooks/index.md +35 -35
  117. package/dist/skills/fluentcart-developer/references/index.md +625 -625
  118. package/dist/skills/fluentcart-developer/references/modules/fee-system.md +427 -427
  119. package/dist/skills/fluentcart-developer/references/modules/ghost-product-selling.md +440 -440
  120. package/dist/skills/fluentcart-developer/references/modules/index.md +484 -484
  121. package/dist/skills/fluentcart-developer/references/modules/licensing.md +342 -342
  122. package/dist/skills/fluentcart-developer/references/modules/order-bump.md +433 -433
  123. package/dist/skills/fluentcart-developer/references/modules/payment-methods.md +129 -129
  124. package/dist/skills/fluentcart-developer/references/modules/refunds.md +170 -170
  125. package/dist/skills/fluentcart-developer/references/modules/shipping.md +846 -846
  126. package/dist/skills/fluentcart-developer/references/modules/storage.md +986 -986
  127. package/dist/skills/fluentcart-developer/references/modules/subscription-vendor-ids.md +186 -186
  128. package/dist/skills/fluentcart-developer/references/modules/subscriptions.md +678 -678
  129. package/dist/skills/fluentcart-developer/references/payment-methods-integration/index.md +164 -164
  130. package/dist/skills/fluentcart-developer/references/payment-methods-integration/paddle-example.md +1648 -1648
  131. package/dist/skills/fluentcart-developer/references/payment-methods-integration/payment/setting/fields.md +353 -353
  132. package/dist/skills/fluentcart-developer/references/payment-methods-integration/quick-implementation.md +1079 -1079
  133. package/dist/skills/fluentcart-developer/references/payment-methods-integration.md +164 -164
  134. package/dist/skills/fluentcart-developer/references/restapi/checkout.md +573 -573
  135. package/dist/skills/fluentcart-developer/references/restapi/coupons.md +958 -958
  136. package/dist/skills/fluentcart-developer/references/restapi/customer-profile.md +1423 -1423
  137. package/dist/skills/fluentcart-developer/references/restapi/customers.md +1103 -1103
  138. package/dist/skills/fluentcart-developer/references/restapi/dashboard.md +1083 -1083
  139. package/dist/skills/fluentcart-developer/references/restapi/data-export.md +132 -132
  140. package/dist/skills/fluentcart-developer/references/restapi/email-notifications.md +846 -846
  141. package/dist/skills/fluentcart-developer/references/restapi/files.md +313 -313
  142. package/dist/skills/fluentcart-developer/references/restapi/index.md +127 -127
  143. package/dist/skills/fluentcart-developer/references/restapi/integrations.md +1000 -1000
  144. package/dist/skills/fluentcart-developer/references/restapi/inventory.md +192 -192
  145. package/dist/skills/fluentcart-developer/references/restapi/labels-and-attributes.md +797 -797
  146. package/dist/skills/fluentcart-developer/references/restapi/licensing.md +1733 -1733
  147. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-available-shipping-methods.md +30 -30
  148. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-checkout-summary.md +28 -28
  149. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-country-info.md +29 -29
  150. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-order-info.md +28 -28
  151. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-shipping-methods-list-view.md +30 -30
  152. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/login.md +66 -66
  153. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/place-order.md +179 -179
  154. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/apply-coupon.md +83 -83
  155. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/cancel-coupon.md +87 -87
  156. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/check-product-eligibility.md +59 -59
  157. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/create-coupon.md +230 -230
  158. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/delete-coupon.md +29 -29
  159. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon-settings.md +20 -20
  160. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon.md +27 -27
  161. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupon-codes.md +20 -20
  162. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupons.md +37 -37
  163. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/re-apply-coupons.md +75 -75
  164. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/store-coupon-settings.md +40 -40
  165. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/update-coupon.md +133 -133
  166. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-address-checkout.md +138 -138
  167. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-profile-address.md +119 -119
  168. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/dashboard-overview.md +22 -22
  169. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/delete-profile-address.md +46 -46
  170. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-order-details.md +30 -30
  171. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-portal-sections.md +29 -29
  172. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-profile-details.md +22 -22
  173. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-transaction-billing-address.md +30 -30
  174. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-upgrade-paths.md +31 -31
  175. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-downloads.md +29 -29
  176. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-orders.md +28 -28
  177. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/make-profile-address-primary.md +55 -55
  178. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/pause-subscription.md +29 -29
  179. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/resume-subscription.md +29 -29
  180. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/save-transaction-billing-address.md +92 -92
  181. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/select-address-for-checkout.md +32 -32
  182. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-address.md +115 -115
  183. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-details.md +69 -69
  184. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/attach-user.md +50 -50
  185. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/bulk-actions.md +65 -65
  186. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-address.md +135 -135
  187. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-customer.md +108 -108
  188. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/delete-address.md +62 -62
  189. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/detach-user.md +28 -28
  190. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/find-customer-order.md +27 -27
  191. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-attachable-users.md +20 -20
  192. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-addresses.md +28 -28
  193. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-orders.md +37 -37
  194. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-stats.md +27 -27
  195. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer.md +32 -32
  196. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/list-customers.md +37 -37
  197. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/recalculate-ltv.md +28 -28
  198. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/set-primary-address.md +72 -72
  199. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-additional-info.md +55 -55
  200. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-address.md +144 -144
  201. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-customer.md +123 -123
  202. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/attach-note-to-order.md +49 -49
  203. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-all-pages.md +21 -21
  204. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-single-page.md +55 -55
  205. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/delete-activity.md +28 -28
  206. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-country-info.md +29 -29
  207. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-dashboard-stats.md +22 -22
  208. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-filter-options.md +31 -31
  209. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-data.md +20 -20
  210. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-settings.md +20 -20
  211. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-print-templates.md +20 -20
  212. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-search-options.md +27 -27
  213. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-widgets.md +28 -28
  214. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/initialize-app.md +20 -20
  215. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-activities.md +33 -33
  216. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-attachments.md +21 -21
  217. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-countries.md +20 -20
  218. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/mark-activity-read.md +53 -53
  219. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/run-data-backfills.md +21 -21
  220. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-settings.md +54 -54
  221. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-tax-settings.md +73 -73
  222. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-print-templates.md +64 -64
  223. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/upload-attachment.md +42 -42
  224. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-customers-batch.md +129 -129
  225. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-licenses-batch.md +133 -133
  226. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-orders-batch.md +129 -129
  227. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-subscriptions-batch.md +129 -129
  228. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-customers-export-schema.md +21 -21
  229. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-licenses-export-schema.md +26 -26
  230. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-orders-export-schema.md +21 -21
  231. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-subscriptions-export-schema.md +21 -21
  232. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/enable-notification.md +57 -57
  233. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-digest-settings.md +22 -22
  234. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-notification.md +30 -30
  235. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-reminders.md +22 -22
  236. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-settings.md +22 -22
  237. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-shortcodes.md +22 -22
  238. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/list-notifications.md +20 -20
  239. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-default-template.md +66 -66
  240. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-notification.md +50 -50
  241. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-digest-settings.md +101 -101
  242. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-reminders.md +162 -162
  243. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-settings.md +99 -99
  244. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-digest-test.md +47 -47
  245. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-manual-reminder.md +51 -51
  246. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/update-notification.md +93 -93
  247. package/dist/skills/fluentcart-developer/references/restapi/operations/files/delete-file.md +31 -31
  248. package/dist/skills/fluentcart-developer/references/restapi/operations/files/get-bucket-list.md +28 -28
  249. package/dist/skills/fluentcart-developer/references/restapi/operations/files/list-files.md +30 -30
  250. package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-editor-file.md +32 -32
  251. package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-file.md +34 -34
  252. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/chained-data-request.md +46 -46
  253. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/change-feed-status.md +51 -51
  254. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/delete-feed.md +27 -27
  255. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-dynamic-options.md +29 -29
  256. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-lists.md +27 -27
  257. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-settings.md +27 -27
  258. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-feeds.md +20 -20
  259. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-settings.md +26 -26
  260. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/install-addon-plugin.md +49 -49
  261. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/list-addons.md +20 -20
  262. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/save-feed-settings.md +52 -52
  263. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/set-global-settings.md +50 -50
  264. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/bulk-update-stock.md +94 -94
  265. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/export-inventory.md +81 -81
  266. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-adjustment-history.md +26 -26
  267. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-inventory-stats.md +21 -21
  268. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/list-inventory.md +33 -33
  269. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/update-stock.md +75 -75
  270. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-attribute-group.md +31 -31
  271. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-label.md +31 -31
  272. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-terms.md +90 -90
  273. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-group.md +28 -28
  274. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-term.md +29 -29
  275. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-group.md +28 -28
  276. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-library.md +20 -20
  277. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-groups.md +32 -32
  278. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-terms.md +33 -33
  279. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-labels.md +20 -20
  280. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-groups.md +51 -51
  281. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-terms.md +56 -56
  282. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-group.md +37 -37
  283. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-term.md +39 -39
  284. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-label-selections.md +32 -32
  285. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-plugin-license.md +41 -41
  286. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-site-admin.md +60 -60
  287. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-plugin-license.md +18 -18
  288. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-admin.md +67 -67
  289. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-customer.md +47 -47
  290. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/delete-license.md +24 -24
  291. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/extend-license-validity.md +47 -47
  292. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-license-details.md +25 -25
  293. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-licenses-admin.md +26 -26
  294. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-activations.md +25 -25
  295. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-details.md +25 -25
  296. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-site.md +30 -30
  297. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-plugin-license-status.md +18 -18
  298. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-product-license-settings.md +24 -24
  299. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-customer-licenses.md +25 -25
  300. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-license-sites.md +33 -33
  301. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-licenses.md +38 -38
  302. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-activate-license.md +54 -54
  303. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-check-license.md +26 -26
  304. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-deactivate-license.md +46 -46
  305. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-download-license-package.md +23 -23
  306. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-get-license-version.md +26 -26
  307. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/regenerate-license-key.md +24 -24
  308. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/save-product-license-settings.md +193 -193
  309. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-activation-limit.md +53 -53
  310. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-status.md +52 -52
  311. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/create-order-bump.md +47 -47
  312. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/delete-order-bump.md +25 -25
  313. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/get-order-bump.md +25 -25
  314. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/list-order-bumps.md +29 -29
  315. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/update-order-bump.md +141 -141
  316. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/accept-dispute.md +47 -47
  317. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/bulk-actions.md +72 -72
  318. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-shipping.md +67 -67
  319. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-tax.md +98 -98
  320. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/change-customer.md +50 -50
  321. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/charge-now.md +29 -29
  322. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-and-change-customer.md +92 -92
  323. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-custom-order-item.md +68 -68
  324. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-order.md +351 -351
  325. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-renewal-now.md +29 -29
  326. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/delete-order.md +28 -28
  327. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/generate-missing-licenses.md +29 -29
  328. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order-transactions.md +27 -27
  329. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order.md +27 -27
  330. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-renewal.md +28 -28
  331. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-shipping-methods.md +28 -28
  332. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-single-transaction.md +28 -28
  333. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-order-currencies.md +22 -22
  334. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-orders.md +42 -42
  335. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-renewals.md +28 -28
  336. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/mark-as-paid.md +61 -61
  337. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/price-order.md +135 -135
  338. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/refund-order.md +72 -72
  339. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/resend-renewal-invoice.md +29 -29
  340. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/skip-renewal.md +48 -48
  341. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-order-statuses.md +28 -28
  342. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-pending-transaction.md +29 -29
  343. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address-id.md +60 -60
  344. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address.md +98 -98
  345. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order.md +172 -172
  346. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-statuses.md +77 -77
  347. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-subscription-details.md +84 -84
  348. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-transaction-status.md +51 -51
  349. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/void-renewal.md +30 -30
  350. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/create-pdf-template.md +42 -42
  351. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/delete-pdf-template.md +26 -26
  352. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/download-pdf-preview.md +44 -44
  353. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-factory-default-templates.md +19 -19
  354. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-status.md +21 -21
  355. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-template.md +26 -26
  356. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-saved-templates.md +21 -21
  357. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-seller-details.md +19 -19
  358. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/list-pdf-templates.md +19 -19
  359. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-pdf-template.md +53 -53
  360. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-seller-details.md +97 -97
  361. package/dist/skills/fluentcart-developer/references/restapi/operations/products/add-product-terms.md +64 -64
  362. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-edit-fetch.md +30 -30
  363. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-insert-products.md +62 -62
  364. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-products.md +59 -59
  365. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-variants.md +83 -83
  366. package/dist/skills/fluentcart-developer/references/restapi/operations/products/change-integration-status.md +64 -64
  367. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-dummy-products.md +45 -45
  368. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-product.md +81 -81
  369. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-variation.md +181 -181
  370. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-downloadable-file.md +27 -27
  371. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product-integration.md +30 -30
  372. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product.md +27 -27
  373. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-taxonomy-term.md +55 -55
  374. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-upgrade-path.md +27 -27
  375. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-variation.md +27 -27
  376. package/dist/skills/fluentcart-developer/references/restapi/operations/products/do-bulk-action.md +56 -56
  377. package/dist/skills/fluentcart-developer/references/restapi/operations/products/duplicate-product.md +56 -56
  378. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-products-by-ids.md +26 -26
  379. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-taxonomy-terms.md +20 -20
  380. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-terms-by-parent.md +60 -60
  381. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-variations-by-ids.md +26 -26
  382. package/dist/skills/fluentcart-developer/references/restapi/operations/products/find-subscription-variants.md +26 -26
  383. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-bundle-info.md +27 -27
  384. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-downloadable-url.md +27 -27
  385. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-max-excerpt-word-count.md +20 -20
  386. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-pricing-widgets.md +27 -27
  387. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-feeds.md +29 -29
  388. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-settings.md +31 -31
  389. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-pricing.md +28 -28
  390. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product.md +28 -28
  391. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-related-products.md +31 -31
  392. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-upgrade-settings.md +27 -27
  393. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-variation-upgrade-paths.md +28 -28
  394. package/dist/skills/fluentcart-developer/references/restapi/operations/products/group-bulk-update-variants.md +103 -103
  395. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-all-variants.md +26 -26
  396. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-product-variations.md +26 -26
  397. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-products.md +34 -34
  398. package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-shipping-class.md +27 -27
  399. package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-tax-class.md +27 -27
  400. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-bundle-info.md +56 -56
  401. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-product-integration.md +62 -62
  402. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-upgrade-path.md +78 -78
  403. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-product-variant-options.md +29 -29
  404. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-products-by-name.md +28 -28
  405. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-variants-by-name.md +28 -28
  406. package/dist/skills/fluentcart-developer/references/restapi/operations/products/set-variation-media.md +74 -74
  407. package/dist/skills/fluentcart-developer/references/restapi/operations/products/suggest-sku.md +28 -28
  408. package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-downloadable-files.md +134 -134
  409. package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-taxonomy-terms.md +61 -61
  410. package/dist/skills/fluentcart-developer/references/restapi/operations/products/toggle-product-tax-exemption.md +56 -56
  411. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-downloadable-file.md +98 -98
  412. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-inventory.md +56 -56
  413. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-long-desc-editor-mode.md +49 -49
  414. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-manage-stock.md +53 -53
  415. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-detail.md +58 -58
  416. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-pricing.md +225 -225
  417. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-shipping-class.md +49 -49
  418. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-tax-class.md +49 -49
  419. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-upgrade-path.md +78 -78
  420. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-option.md +79 -79
  421. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-tax-exemption.md +56 -56
  422. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation-pricing-table.md +49 -49
  423. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation.md +105 -105
  424. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/get-product-views.md +34 -34
  425. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/list-products.md +42 -42
  426. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/search-products.md +30 -30
  427. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/channel-rules.md +24 -24
  428. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/country-heat-map.md +22 -22
  429. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupon-overview.md +37 -37
  430. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupons.md +36 -36
  431. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-insights.md +31 -31
  432. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-overview.md +36 -36
  433. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-repeat.md +35 -35
  434. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segment-customers.md +36 -36
  435. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segments.md +30 -30
  436. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-value.md +34 -34
  437. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/dashboard-stats.md +30 -30
  438. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/failed-orders.md +34 -34
  439. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-new-vs-returning-customer.md +34 -34
  440. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-by-day-and-hour.md +34 -34
  441. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-meta.md +29 -29
  442. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-top-sold-products.md +34 -34
  443. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/future-renewals.md +31 -31
  444. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/generate-retention-snapshots.md +24 -24
  445. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-overview.md +30 -30
  446. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-activities.md +26 -26
  447. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-orders.md +20 -20
  448. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-revenue.md +37 -37
  449. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-at-risk.md +35 -35
  450. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-variations.md +33 -33
  451. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments.md +33 -33
  452. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/item-count-distribution.md +34 -34
  453. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-chart.md +30 -30
  454. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-pie-chart.md +22 -22
  455. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-summary.md +22 -22
  456. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/locations.md +43 -43
  457. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-chart.md +37 -37
  458. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-completion-time.md +34 -34
  459. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-mix.md +34 -34
  460. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-value-distribution.md +34 -34
  461. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-disputes.md +38 -38
  462. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-methods.md +36 -36
  463. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods.md +37 -37
  464. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison-launch.md +33 -33
  465. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison.md +40 -40
  466. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-detail.md +37 -37
  467. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-sales.md +37 -37
  468. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/refunds-overview.md +37 -37
  469. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/retention-snapshots-step.md +45 -45
  470. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sales-growth-chart.md +35 -35
  471. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/save-channel-rules.md +73 -73
  472. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/source-channels.md +37 -37
  473. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sources.md +49 -49
  474. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-cohorts.md +33 -33
  475. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-health.md +30 -30
  476. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-rebuys.md +37 -37
  477. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-retention.md +34 -34
  478. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-variations.md +22 -22
  479. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscriptions-overview.md +37 -37
  480. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/weeks-between-refund.md +34 -34
  481. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/assign-role.md +48 -48
  482. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/delete-role-assignment.md +47 -47
  483. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/get-role.md +25 -25
  484. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-managers.md +18 -18
  485. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-roles.md +18 -18
  486. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/search-users.md +25 -25
  487. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/update-role.md +43 -43
  488. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/create-saved-view.md +106 -106
  489. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/delete-saved-view.md +26 -26
  490. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/list-saved-views.md +25 -25
  491. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/update-saved-view.md +83 -83
  492. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-payment-addon.md +44 -44
  493. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-plugin-addon.md +44 -44
  494. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/change-storage-driver-status.md +56 -56
  495. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/check-paypal-webhook.md +26 -26
  496. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/create-storage-bucket.md +63 -63
  497. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/disconnect-payment-method.md +55 -55
  498. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/exchange-paypal-seller-auth-token.md +62 -62
  499. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-active-storage-drivers.md +20 -20
  500. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-checkout-fields.md +22 -22
  501. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-email-shortcodes.md +20 -20
  502. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-config-snippets.md +26 -26
  503. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-status.md +20 -20
  504. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-module-settings.md +20 -20
  505. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-connection-info.md +26 -26
  506. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-settings.md +26 -26
  507. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-permissions.md +22 -22
  508. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-plugin-addons.md +20 -20
  509. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-storage-driver-settings.md +27 -27
  510. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-store-settings.md +26 -26
  511. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-mcp-adapter.md +21 -21
  512. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-payment-addon.md +60 -60
  513. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-plugin-addon.md +64 -64
  514. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-payment-methods.md +20 -20
  515. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-storage-drivers.md +20 -20
  516. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-storage-buckets.md +67 -67
  517. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reorder-payment-methods.md +55 -55
  518. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reset-storage-driver-settings.md +45 -45
  519. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-checkout-fields.md +133 -133
  520. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-confirmation-settings.md +68 -68
  521. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-module-settings.md +68 -68
  522. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-design.md +67 -67
  523. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-settings.md +58 -58
  524. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-permissions.md +68 -68
  525. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-storage-driver-settings.md +62 -62
  526. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-store-settings.md +239 -239
  527. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/setup-paypal-webhook.md +48 -48
  528. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/toggle-mcp.md +40 -40
  529. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-storage-driver-connection.md +62 -62
  530. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-turnstile-keys.md +55 -55
  531. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-class.md +73 -73
  532. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-method.md +110 -110
  533. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-zone.md +56 -56
  534. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-class.md +29 -29
  535. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-method.md +29 -29
  536. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-zone.md +29 -29
  537. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class-profile.md +30 -30
  538. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class.md +29 -29
  539. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-packages.md +22 -22
  540. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-zone.md +27 -27
  541. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-countries.md +22 -22
  542. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-states.md +28 -28
  543. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-classes.md +31 -31
  544. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-zones.md +31 -31
  545. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/save-shipping-packages.md +112 -112
  546. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-class.md +79 -79
  547. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-method.md +113 -113
  548. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-zone.md +62 -62
  549. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-zone-order.md +52 -52
  550. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-auto-renew.md +30 -30
  551. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-subscription.md +52 -52
  552. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/confirm-subscription-switch.md +70 -70
  553. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/fetch-subscription-remote.md +28 -28
  554. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/generate-early-payment-link.md +29 -29
  555. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-customer-subscription.md +27 -27
  556. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-or-create-plan.md +69 -69
  557. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-setup-intent-attempts.md +30 -30
  558. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-subscription.md +28 -28
  559. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/initiate-early-payment.md +31 -31
  560. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-customer-subscriptions.md +27 -27
  561. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-subscriptions.md +39 -39
  562. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/pause-subscription.md +28 -28
  563. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/reactivate-subscription.md +28 -28
  564. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/resume-subscription.md +28 -28
  565. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/switch-payment-method.md +70 -70
  566. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-payment-method.md +69 -69
  567. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-vendor-ids.md +56 -56
  568. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/verify-vendor-ids.md +56 -56
  569. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-class.md +51 -51
  570. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-rate.md +117 -117
  571. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-product-override.md +27 -27
  572. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-shipping-tax-override.md +27 -27
  573. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-class.md +28 -28
  574. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-rate.md +27 -27
  575. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-id.md +27 -27
  576. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-rates.md +28 -28
  577. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-eu-vat-product-overrides.md +20 -20
  578. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-oss-country-rates.md +20 -20
  579. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-preconfigured-tax-rates.md +20 -20
  580. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-product-overrides.md +27 -27
  581. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-tax-settings.md +20 -20
  582. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-all-tax-rates.md +20 -20
  583. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-classes.md +20 -20
  584. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-records.md +37 -37
  585. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/mark-taxes-as-filed.md +58 -58
  586. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/reset-eu-vat-rates.md +21 -21
  587. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-configured-countries.md +57 -57
  588. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-country-tax-id.md +50 -50
  589. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-eu-vat-cross-border-settings.md +127 -127
  590. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-oss-country-rates.md +100 -100
  591. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-product-override.md +110 -110
  592. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-shipping-tax-override.md +52 -52
  593. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-tax-settings.md +166 -166
  594. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-country-status.md +54 -54
  595. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-tax-rate.md +116 -116
  596. package/dist/skills/fluentcart-developer/references/restapi/order-bumps.md +433 -433
  597. package/dist/skills/fluentcart-developer/references/restapi/orders.md +1212 -1212
  598. package/dist/skills/fluentcart-developer/references/restapi/pdf-templates.md +212 -212
  599. package/dist/skills/fluentcart-developer/references/restapi/products.md +2485 -2485
  600. package/dist/skills/fluentcart-developer/references/restapi/public-shop.md +191 -191
  601. package/dist/skills/fluentcart-developer/references/restapi/reports.md +3773 -3773
  602. package/dist/skills/fluentcart-developer/references/restapi/roles.md +403 -403
  603. package/dist/skills/fluentcart-developer/references/restapi/saved-views.md +136 -136
  604. package/dist/skills/fluentcart-developer/references/restapi/settings.md +1423 -1423
  605. package/dist/skills/fluentcart-developer/references/restapi/shipping.md +905 -905
  606. package/dist/skills/fluentcart-developer/references/restapi/subscriptions.md +1169 -1169
  607. package/dist/skills/fluentcart-developer/references/restapi/tax.md +1551 -1551
  608. package/dist/skills/fluentcart-developer/references/restapi.md +127 -127
  609. package/dist/skills/fluentcart-developer/scripts/cli.js +1 -1
  610. package/dist/version.d.ts +1 -1
  611. package/dist/version.js +1 -1
  612. package/package.json +66 -65
@@ -1,1019 +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
- ```
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
+ ```