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,519 +1,519 @@
1
- # Frontend Development Guide
2
-
3
- This guide covers frontend development for FluentCart, including Vue.js integration, template customization, and asset management.
4
-
5
- ## Template System
6
-
7
- ### Template Hierarchy
8
-
9
- The storefront is not rendered from a `Views/` template tree. FluentCart builds its markup in PHP renderer classes under `app/Services/Renderer/`:
10
-
11
- ```
12
- app/Services/Renderer/
13
- ├── ProductRenderer.php # single product
14
- ├── ProductCardRender.php # product cards in listings
15
- ├── CartItemRenderer.php # cart line items
16
- ├── CartSummaryRender.php # cart totals
17
- ├── CheckoutRenderer.php # checkout form
18
- ├── PricingTableRenderer.php # variant pricing tables
19
- ├── TaxRenderer.php # tax line display
20
- ├── AdvancedVariationRenderer.php
21
- ├── RenderHelper.php # shared helpers
22
- ├── RenderContext.php # decorates hook payloads with source / source_name
23
- └── Receipt/
24
- ├── ReceiptRenderer.php
25
- ├── ThankYouRender.php
26
- └── StoreBusinessInfoHelper.php
27
- ```
28
-
29
- `app/Views/` does exist, but it holds admin, email, invoice and print templates — not the storefront.
30
-
31
- The matching browser assets live under `resources/public/`, one directory per surface (`cart`, `checkout`, `product-card`, `single-product`, `product-page`, `receipt`, `customer-profile`, `payment-methods`, `search-bar-app`, and others).
32
-
33
- ### Custom Templates
34
-
35
- Theme overrides go through the template loader rather than through a copied view tree. `TemplateLoader::templatePath()` returns the directory the loader looks for inside the active theme, filterable:
36
-
37
- ```
38
- // Default: 'fluent-cart/'
39
- add_filter('fluent_cart/template_path', function ($path) {
40
- return 'my-theme-cart/';
41
- });
42
- ```
43
-
44
- Two further filters control the lookup:
45
-
46
- ```
47
- // Add or reorder candidate template files
48
- add_filter('fluent_cart/template_loader_files', function ($templates, $context) {
49
- return $templates;
50
- }, 10, 2);
51
-
52
- // Tell FluentCart whether the block theme already provides a template
53
- add_filter('fluent_cart/has_block_template', function ($hasTemplate, $context) {
54
- return $hasTemplate;
55
- }, 10, 2);
56
- ```
57
-
58
- ### Template Loading
59
-
60
- `TemplateLoader` is an all-static class in `FluentCart\App\Modules\Templating`. There is no `FluentCart\App\FC\Template\DefaultTemplate\TemplateLoader`, and it is not instantiated with the app container:
61
-
62
- ```
63
- use FluentCart\App\Modules\Templating\TemplateLoader;
64
-
65
- // Called by the plugin during boot
66
- TemplateLoader::init();
67
-
68
- // Resolve the template WordPress should use for the current query
69
- $template = TemplateLoader::loadTemplate($template);
70
-
71
- // Where the loader looks inside the theme
72
- $dir = TemplateLoader::templatePath(); // 'fluent-cart/'
73
-
74
- // Whether the active theme declares support
75
- $supported = TemplateLoader::hasThemeSupport();
76
- ```
77
-
78
- ### Template Hooks
79
-
80
- Storefront hooks are namespaced with a slash and fire from the renderer classes:
81
-
82
- ```
83
- // Single product: around the price block
84
- add_action('fluent_cart/product/single/after_price_block', function ($data) {
85
- echo '<div class="custom-product-info">Custom content here</div>';
86
- }, 20);
87
-
88
- // Other anchors on the same page
89
- // fluent_cart/product/single/after_title_block
90
- // fluent_cart/product/single/after_excerpt_block
91
- // fluent_cart/product/single/after_quantity_block
92
- // fluent_cart/product/single/after_actions_block
93
-
94
- // Checkout: before the form opens
95
- add_action('fluent_cart/checkout_form_opening', function ($data) {
96
- echo '<div class="checkout-notice">Important notice</div>';
97
- });
98
-
99
- // Cart line items
100
- add_action('fluent_cart/cart/line_item/after_main_title', function ($data) {
101
- echo '<div class="cart-recommendations">Recommended products</div>';
102
- });
103
- ```
104
-
105
- Payloads are wrapped by `RenderContext::decorate()`, so every one of these carries `source` and `source_name` alongside the entry's own keys. The full set is in the [action](/hooks/actions.md) and [filter](/hooks/filters.md) references.
106
-
107
- ## Vue.js Integration
108
-
109
- ### Admin Interface
110
-
111
- FluentCart uses Vue.js 3 with Element Plus for the admin interface. The admin components are located in `resources/admin/`:
112
-
113
- ```
114
- resources/admin/
115
- ├── Application.vue
116
- ├── Bits/Components/ # 337 Vue components
117
- ├── Modules/ # Feature-specific components
118
- │ ├── Products/ # 43 components
119
- │ ├── Orders/ # 34 components
120
- │ ├── Customers/ # 19 components
121
- │ └── Reports/ # 73 components
122
- ├── Pages/ # Page components
123
- └── utils/ # Utilities and mixins
124
- ```
125
-
126
- ### Frontend Vue Components
127
-
128
- Only the customer profile is built with Vue. Every other storefront surface is plain JavaScript:
129
-
130
- ```
131
- resources/public/
132
- ├── customer-profile/ # 48 .vue files — the only Vue app on the storefront
133
- ├── cart/ # plain JS
134
- ├── checkout/ # plain JS
135
- ├── product-card/ # plain JS
136
- ├── pricing-table/ # plain JS
137
- ├── single-product/ # plain JS
138
- └── search-bar-app/ # plain JS
139
- ```
140
-
141
- The admin is the Vue-heavy side, with roughly 840 `.vue` files under `resources/admin/`.
142
-
143
- ### Component Example
144
-
145
- ```
146
- <template>
147
- <div class="fluent-cart-component">
148
- <el-button @click="handleClick" type="primary">
149
- {{ buttonText }}
150
- </el-button>
151
- </div>
152
- </template>
153
-
154
- <script setup>
155
- import { ref, computed } from 'vue'
156
- import { ElButton } from 'element-plus'
157
-
158
- const props = defineProps({
159
- buttonText: {
160
- type: String,
161
- default: 'Click Me'
162
- }
163
- })
164
-
165
- const emit = defineEmits(['click'])
166
-
167
- const handleClick = () => {
168
- emit('click')
169
- }
170
- </script>
171
- ```
172
-
173
- ### React Integration
174
-
175
- FluentCart also includes React components for Gutenberg blocks:
176
-
177
- ```
178
- resources/admin/BlockEditor/
179
- ├── Buttons/ # Add to Cart, Direct Checkout
180
- ├── Checkout/ # Checkout block
181
- ├── CustomerProfile/ # Customer profile block
182
- ├── PricingTable/ # Pricing table block
183
- ├── ProductCard/ # Product card block
184
- └── SearchBar/ # Search bar block
185
- ```
186
-
187
- ### State Management
188
-
189
- For complex applications, consider using Pinia for state management:
190
-
191
- ```
192
- import { createPinia } from 'pinia'
193
- import { defineStore } from 'pinia'
194
-
195
- // Cart store
196
- export const useCartStore = defineStore('cart', {
197
- state: () => ({
198
- items: [],
199
- total: 0,
200
- loading: false
201
- }),
202
-
203
- actions: {
204
- async addToCart(productId, quantity = 1) {
205
- this.loading = true
206
- try {
207
- // The AJAX endpoint the bundled cart uses — prefer
208
- // window.fluentCartCart over calling it directly.
209
- const response = await fetch(window.fluentCartRestVars.ajaxurl
210
- + '?action=fluent_cart_checkout_routes'
211
- + '&fc_checkout_action=fluent_cart_cart_update', {
212
- method: 'POST',
213
- headers: {
214
- 'Content-Type': 'application/json',
215
- 'X-WP-Nonce': window.fluentCartRestVars.nonce
216
- },
217
- body: JSON.stringify({
218
- action: 'add_to_cart',
219
- product_id: productId,
220
- quantity: quantity
221
- })
222
- })
223
-
224
- const data = await response.json()
225
- this.items = data.items
226
- this.total = data.total
227
- } catch (error) {
228
- console.error('Error adding to cart:', error)
229
- } finally {
230
- this.loading = false
231
- }
232
- }
233
- }
234
- })
235
-
236
- // Initialize Pinia
237
- const pinia = createPinia()
238
- app.use(pinia)
239
- ```
240
-
241
- ### Event Handling
242
-
243
- FluentCart dispatches `CustomEvent`s on `window`, and exposes its storefront objects as individually named globals:
244
-
245
- | Global | What it is |
246
- | --- | --- |
247
- | `window.fluentCartCart` | the cart instance (add, update, remove) |
248
- | `window.fluentCartRestVars` | `ajaxurl`, nonce and REST config |
249
- | `window.fluentCartCheckout` | checkout controller |
250
- | `window.fluentCartCheckoutParams` | checkout configuration |
251
- | `window.fluentCartSingleProduct` | single-product controller |
252
- | `window.fluentCartShopApps` | mounted storefront apps |
253
-
254
- Events you can listen for include:
255
-
256
- ```
257
- // Payment method lifecycle
258
- window.addEventListener('fluent_cart_payment_method_loading', (e) => {});
259
- window.addEventListener('fluent_cart_payment_method_loading_success', (e) => {});
260
- window.addEventListener('fluent_cart_payment_method_loading_failed', (e) => {});
261
-
262
- // Per-gateway load hook: fluent_cart_load_payments_{slug}
263
- window.addEventListener('fluent_cart_load_payments_stripe', (e) => {
264
- // e.detail carries orderHandler, isZeroPayment, hasSubscriptions and more
265
- });
266
-
267
- // Nonce refresh
268
- window.addEventListener('fcart_renew_rest_nonce', (e) => {});
269
- ```
270
-
271
- Reviews add their own `fct-review-*` events (`fct-review-form-mounted`, `fct-review-form-before-submit`, `fct-review-submitted`, `fct-review-form-saved`).
272
-
273
- #### Updating the cart
274
-
275
- Cart changes go through the WordPress AJAX handler, not a REST route:
276
-
277
- ```
278
- // What window.fluentCartCart does internally
279
- const url = window.fluentCartRestVars.ajaxurl
280
- + '?action=fluent_cart_checkout_routes&fc_checkout_action=fluent_cart_cart_update';
281
- ```
282
-
283
- Prefer the `window.fluentCartCart` instance over calling that URL yourself.
284
-
285
- ## Asset Management
286
-
287
- ### Vite Configuration
288
-
289
- FluentCart uses Vite for asset bundling and development:
290
-
291
- ```
292
- // vite.config.mjs
293
- import { defineConfig } from 'vite'
294
- import vue from '@vitejs/plugin-vue'
295
-
296
- export default defineConfig({
297
- plugins: [vue()],
298
- build: {
299
- rollupOptions: {
300
- input: {
301
- // Real entries, as listed in vite.config.mjs
302
- 'admin': 'resources/admin/bootstrap/app.js',
303
- 'tailwind': 'resources/styles/tailwind/style.css',
304
- 'shop-app': 'resources/admin/BlockEditor/ShopApp/ShopAppBlockEditor.jsx'
305
- }
306
- }
307
- }
308
- })
309
- ```
310
-
311
- ### SCSS Compilation
312
-
313
- Organize styles with SCSS:
314
-
315
- ```
316
- // resources/styles/…
317
- @import 'variables';
318
- @import 'mixins';
319
-
320
- .fluent-cart-checkout {
321
- &__form {
322
- @include form-styles;
323
-
324
- &-group {
325
- margin-bottom: 1rem;
326
- }
327
- }
328
-
329
- &__payment-methods {
330
- @include payment-methods-styles;
331
- }
332
- }
333
-
334
- // Variables
335
- $primary-color: #007cba;
336
- $border-radius: 4px;
337
- $spacing: 1rem;
338
-
339
- // Mixins
340
- @mixin form-styles {
341
- .form-control {
342
- border: 1px solid #ddd;
343
- border-radius: $border-radius;
344
- padding: 0.5rem;
345
-
346
- &:focus {
347
- border-color: $primary-color;
348
- outline: none;
349
- }
350
- }
351
- }
352
- ```
353
-
354
- ### JavaScript Bundling
355
-
356
- Structure JavaScript files for optimal loading:
357
-
358
- ```
359
- // resources/public/checkout/…
360
- import { createApp } from 'vue'
361
- import CheckoutComponent from './components/Checkout.vue'
362
- import '../scss/checkout.scss'
363
-
364
- // Initialize checkout app
365
- const checkoutApp = createApp(CheckoutComponent)
366
- checkoutApp.mount('#checkout-app')
367
-
368
- // Lazy load additional components
369
- const loadPaymentMethods = () => {
370
- return import('./components/PaymentMethods.vue')
371
- }
372
-
373
- // Load payment methods when needed
374
- document.addEventListener('DOMContentLoaded', () => {
375
- const paymentSection = document.querySelector('#payment-methods')
376
- if (paymentSection) {
377
- loadPaymentMethods().then(module => {
378
- checkoutApp.component('PaymentMethods', module.default)
379
- })
380
- }
381
- })
382
- ```
383
-
384
- ## Responsive Design
385
-
386
- ### Mobile-First Approach
387
-
388
- Design for mobile devices first:
389
-
390
- ```
391
- // Mobile-first responsive design
392
- .fluent-cart-product {
393
- display: block;
394
- margin-bottom: 1rem;
395
-
396
- // Tablet and up
397
- @media (min-width: 768px) {
398
- display: flex;
399
- gap: 1rem;
400
- }
401
-
402
- // Desktop and up
403
- @media (min-width: 1024px) {
404
- gap: 2rem;
405
- }
406
- }
407
-
408
- .fluent-cart-checkout {
409
- &__form {
410
- // Mobile: single column
411
- display: block;
412
-
413
- // Tablet: two columns
414
- @media (min-width: 768px) {
415
- display: grid;
416
- grid-template-columns: 1fr 1fr;
417
- gap: 1rem;
418
- }
419
- }
420
- }
421
- ```
422
-
423
- ### Touch-Friendly Interface
424
-
425
- Ensure touch-friendly interactions:
426
-
427
- ```
428
- .fluent-cart-button {
429
- min-height: 44px; // Minimum touch target
430
- padding: 0.75rem 1.5rem;
431
- border-radius: 4px;
432
-
433
- &:active {
434
- transform: scale(0.98); // Touch feedback
435
- }
436
- }
437
-
438
- .fluent-cart-input {
439
- min-height: 44px;
440
- padding: 0.75rem;
441
- font-size: 16px; // Prevent zoom on iOS
442
-
443
- @media (max-width: 767px) {
444
- font-size: 16px; // Ensure no zoom
445
- }
446
- }
447
- ```
448
-
449
- ## Performance Optimization
450
-
451
- ### Lazy Loading
452
-
453
- Implement lazy loading for images and components:
454
-
455
- ```
456
- // Lazy load product images
457
- const lazyImages = document.querySelectorAll('img[data-src]')
458
-
459
- const imageObserver = new IntersectionObserver((entries) => {
460
- entries.forEach(entry => {
461
- if (entry.isIntersecting) {
462
- const img = entry.target
463
- img.src = img.dataset.src
464
- img.classList.remove('lazy')
465
- imageObserver.unobserve(img)
466
- }
467
- })
468
- })
469
-
470
- lazyImages.forEach(img => imageObserver.observe(img))
471
- ```
472
-
473
- ### Code Splitting
474
-
475
- Split code for better performance:
476
-
477
- ```
478
- // Dynamic imports for route-based code splitting
479
- const routes = [
480
- {
481
- path: '/checkout',
482
- component: () => import('./views/Checkout.vue')
483
- },
484
- {
485
- path: '/cart',
486
- component: () => import('./views/Cart.vue')
487
- }
488
- ]
489
- ```
490
-
491
- ### Caching Strategies
492
-
493
- Implement proper caching:
494
-
495
- ```
496
- // Service worker for caching
497
- self.addEventListener('fetch', (event) => {
498
- if (event.request.url.includes('/wp-json/fluent-cart/')) {
499
- event.respondWith(
500
- caches.match(event.request).then(response => {
501
- return response || fetch(event.request).then(fetchResponse => {
502
- return caches.open('fluent-cart-v1').then(cache => {
503
- cache.put(event.request, fetchResponse.clone())
504
- return fetchResponse
505
- })
506
- })
507
- })
508
- )
509
- }
510
- })
511
- ```
512
-
513
- ---
514
-
515
- **Related Documentation:**
516
-
517
- - [Template System](./../modules/) - Module development
518
- - [REST API](./../api/) - API integration
519
- - [Developer Hooks](./../hooks/) - Customization hooks
1
+ # Frontend Development Guide
2
+
3
+ This guide covers frontend development for FluentCart, including Vue.js integration, template customization, and asset management.
4
+
5
+ ## Template System
6
+
7
+ ### Template Hierarchy
8
+
9
+ The storefront is not rendered from a `Views/` template tree. FluentCart builds its markup in PHP renderer classes under `app/Services/Renderer/`:
10
+
11
+ ```
12
+ app/Services/Renderer/
13
+ ├── ProductRenderer.php # single product
14
+ ├── ProductCardRender.php # product cards in listings
15
+ ├── CartItemRenderer.php # cart line items
16
+ ├── CartSummaryRender.php # cart totals
17
+ ├── CheckoutRenderer.php # checkout form
18
+ ├── PricingTableRenderer.php # variant pricing tables
19
+ ├── TaxRenderer.php # tax line display
20
+ ├── AdvancedVariationRenderer.php
21
+ ├── RenderHelper.php # shared helpers
22
+ ├── RenderContext.php # decorates hook payloads with source / source_name
23
+ └── Receipt/
24
+ ├── ReceiptRenderer.php
25
+ ├── ThankYouRender.php
26
+ └── StoreBusinessInfoHelper.php
27
+ ```
28
+
29
+ `app/Views/` does exist, but it holds admin, email, invoice and print templates — not the storefront.
30
+
31
+ The matching browser assets live under `resources/public/`, one directory per surface (`cart`, `checkout`, `product-card`, `single-product`, `product-page`, `receipt`, `customer-profile`, `payment-methods`, `search-bar-app`, and others).
32
+
33
+ ### Custom Templates
34
+
35
+ Theme overrides go through the template loader rather than through a copied view tree. `TemplateLoader::templatePath()` returns the directory the loader looks for inside the active theme, filterable:
36
+
37
+ ```
38
+ // Default: 'fluent-cart/'
39
+ add_filter('fluent_cart/template_path', function ($path) {
40
+ return 'my-theme-cart/';
41
+ });
42
+ ```
43
+
44
+ Two further filters control the lookup:
45
+
46
+ ```
47
+ // Add or reorder candidate template files
48
+ add_filter('fluent_cart/template_loader_files', function ($templates, $context) {
49
+ return $templates;
50
+ }, 10, 2);
51
+
52
+ // Tell FluentCart whether the block theme already provides a template
53
+ add_filter('fluent_cart/has_block_template', function ($hasTemplate, $context) {
54
+ return $hasTemplate;
55
+ }, 10, 2);
56
+ ```
57
+
58
+ ### Template Loading
59
+
60
+ `TemplateLoader` is an all-static class in `FluentCart\App\Modules\Templating`. There is no `FluentCart\App\FC\Template\DefaultTemplate\TemplateLoader`, and it is not instantiated with the app container:
61
+
62
+ ```
63
+ use FluentCart\App\Modules\Templating\TemplateLoader;
64
+
65
+ // Called by the plugin during boot
66
+ TemplateLoader::init();
67
+
68
+ // Resolve the template WordPress should use for the current query
69
+ $template = TemplateLoader::loadTemplate($template);
70
+
71
+ // Where the loader looks inside the theme
72
+ $dir = TemplateLoader::templatePath(); // 'fluent-cart/'
73
+
74
+ // Whether the active theme declares support
75
+ $supported = TemplateLoader::hasThemeSupport();
76
+ ```
77
+
78
+ ### Template Hooks
79
+
80
+ Storefront hooks are namespaced with a slash and fire from the renderer classes:
81
+
82
+ ```
83
+ // Single product: around the price block
84
+ add_action('fluent_cart/product/single/after_price_block', function ($data) {
85
+ echo '<div class="custom-product-info">Custom content here</div>';
86
+ }, 20);
87
+
88
+ // Other anchors on the same page
89
+ // fluent_cart/product/single/after_title_block
90
+ // fluent_cart/product/single/after_excerpt_block
91
+ // fluent_cart/product/single/after_quantity_block
92
+ // fluent_cart/product/single/after_actions_block
93
+
94
+ // Checkout: before the form opens
95
+ add_action('fluent_cart/checkout_form_opening', function ($data) {
96
+ echo '<div class="checkout-notice">Important notice</div>';
97
+ });
98
+
99
+ // Cart line items
100
+ add_action('fluent_cart/cart/line_item/after_main_title', function ($data) {
101
+ echo '<div class="cart-recommendations">Recommended products</div>';
102
+ });
103
+ ```
104
+
105
+ Payloads are wrapped by `RenderContext::decorate()`, so every one of these carries `source` and `source_name` alongside the entry's own keys. The full set is in the [action](/hooks/actions.md) and [filter](/hooks/filters.md) references.
106
+
107
+ ## Vue.js Integration
108
+
109
+ ### Admin Interface
110
+
111
+ FluentCart uses Vue.js 3 with Element Plus for the admin interface. The admin components are located in `resources/admin/`:
112
+
113
+ ```
114
+ resources/admin/
115
+ ├── Application.vue
116
+ ├── Bits/Components/ # 337 Vue components
117
+ ├── Modules/ # Feature-specific components
118
+ │ ├── Products/ # 43 components
119
+ │ ├── Orders/ # 34 components
120
+ │ ├── Customers/ # 19 components
121
+ │ └── Reports/ # 73 components
122
+ ├── Pages/ # Page components
123
+ └── utils/ # Utilities and mixins
124
+ ```
125
+
126
+ ### Frontend Vue Components
127
+
128
+ Only the customer profile is built with Vue. Every other storefront surface is plain JavaScript:
129
+
130
+ ```
131
+ resources/public/
132
+ ├── customer-profile/ # 48 .vue files — the only Vue app on the storefront
133
+ ├── cart/ # plain JS
134
+ ├── checkout/ # plain JS
135
+ ├── product-card/ # plain JS
136
+ ├── pricing-table/ # plain JS
137
+ ├── single-product/ # plain JS
138
+ └── search-bar-app/ # plain JS
139
+ ```
140
+
141
+ The admin is the Vue-heavy side, with roughly 840 `.vue` files under `resources/admin/`.
142
+
143
+ ### Component Example
144
+
145
+ ```
146
+ <template>
147
+ <div class="fluent-cart-component">
148
+ <el-button @click="handleClick" type="primary">
149
+ {{ buttonText }}
150
+ </el-button>
151
+ </div>
152
+ </template>
153
+
154
+ <script setup>
155
+ import { ref, computed } from 'vue'
156
+ import { ElButton } from 'element-plus'
157
+
158
+ const props = defineProps({
159
+ buttonText: {
160
+ type: String,
161
+ default: 'Click Me'
162
+ }
163
+ })
164
+
165
+ const emit = defineEmits(['click'])
166
+
167
+ const handleClick = () => {
168
+ emit('click')
169
+ }
170
+ </script>
171
+ ```
172
+
173
+ ### React Integration
174
+
175
+ FluentCart also includes React components for Gutenberg blocks:
176
+
177
+ ```
178
+ resources/admin/BlockEditor/
179
+ ├── Buttons/ # Add to Cart, Direct Checkout
180
+ ├── Checkout/ # Checkout block
181
+ ├── CustomerProfile/ # Customer profile block
182
+ ├── PricingTable/ # Pricing table block
183
+ ├── ProductCard/ # Product card block
184
+ └── SearchBar/ # Search bar block
185
+ ```
186
+
187
+ ### State Management
188
+
189
+ For complex applications, consider using Pinia for state management:
190
+
191
+ ```
192
+ import { createPinia } from 'pinia'
193
+ import { defineStore } from 'pinia'
194
+
195
+ // Cart store
196
+ export const useCartStore = defineStore('cart', {
197
+ state: () => ({
198
+ items: [],
199
+ total: 0,
200
+ loading: false
201
+ }),
202
+
203
+ actions: {
204
+ async addToCart(productId, quantity = 1) {
205
+ this.loading = true
206
+ try {
207
+ // The AJAX endpoint the bundled cart uses — prefer
208
+ // window.fluentCartCart over calling it directly.
209
+ const response = await fetch(window.fluentCartRestVars.ajaxurl
210
+ + '?action=fluent_cart_checkout_routes'
211
+ + '&fc_checkout_action=fluent_cart_cart_update', {
212
+ method: 'POST',
213
+ headers: {
214
+ 'Content-Type': 'application/json',
215
+ 'X-WP-Nonce': window.fluentCartRestVars.nonce
216
+ },
217
+ body: JSON.stringify({
218
+ action: 'add_to_cart',
219
+ product_id: productId,
220
+ quantity: quantity
221
+ })
222
+ })
223
+
224
+ const data = await response.json()
225
+ this.items = data.items
226
+ this.total = data.total
227
+ } catch (error) {
228
+ console.error('Error adding to cart:', error)
229
+ } finally {
230
+ this.loading = false
231
+ }
232
+ }
233
+ }
234
+ })
235
+
236
+ // Initialize Pinia
237
+ const pinia = createPinia()
238
+ app.use(pinia)
239
+ ```
240
+
241
+ ### Event Handling
242
+
243
+ FluentCart dispatches `CustomEvent`s on `window`, and exposes its storefront objects as individually named globals:
244
+
245
+ | Global | What it is |
246
+ | --- | --- |
247
+ | `window.fluentCartCart` | the cart instance (add, update, remove) |
248
+ | `window.fluentCartRestVars` | `ajaxurl`, nonce and REST config |
249
+ | `window.fluentCartCheckout` | checkout controller |
250
+ | `window.fluentCartCheckoutParams` | checkout configuration |
251
+ | `window.fluentCartSingleProduct` | single-product controller |
252
+ | `window.fluentCartShopApps` | mounted storefront apps |
253
+
254
+ Events you can listen for include:
255
+
256
+ ```
257
+ // Payment method lifecycle
258
+ window.addEventListener('fluent_cart_payment_method_loading', (e) => {});
259
+ window.addEventListener('fluent_cart_payment_method_loading_success', (e) => {});
260
+ window.addEventListener('fluent_cart_payment_method_loading_failed', (e) => {});
261
+
262
+ // Per-gateway load hook: fluent_cart_load_payments_{slug}
263
+ window.addEventListener('fluent_cart_load_payments_stripe', (e) => {
264
+ // e.detail carries orderHandler, isZeroPayment, hasSubscriptions and more
265
+ });
266
+
267
+ // Nonce refresh
268
+ window.addEventListener('fcart_renew_rest_nonce', (e) => {});
269
+ ```
270
+
271
+ Reviews add their own `fct-review-*` events (`fct-review-form-mounted`, `fct-review-form-before-submit`, `fct-review-submitted`, `fct-review-form-saved`).
272
+
273
+ #### Updating the cart
274
+
275
+ Cart changes go through the WordPress AJAX handler, not a REST route:
276
+
277
+ ```
278
+ // What window.fluentCartCart does internally
279
+ const url = window.fluentCartRestVars.ajaxurl
280
+ + '?action=fluent_cart_checkout_routes&fc_checkout_action=fluent_cart_cart_update';
281
+ ```
282
+
283
+ Prefer the `window.fluentCartCart` instance over calling that URL yourself.
284
+
285
+ ## Asset Management
286
+
287
+ ### Vite Configuration
288
+
289
+ FluentCart uses Vite for asset bundling and development:
290
+
291
+ ```
292
+ // vite.config.mjs
293
+ import { defineConfig } from 'vite'
294
+ import vue from '@vitejs/plugin-vue'
295
+
296
+ export default defineConfig({
297
+ plugins: [vue()],
298
+ build: {
299
+ rollupOptions: {
300
+ input: {
301
+ // Real entries, as listed in vite.config.mjs
302
+ 'admin': 'resources/admin/bootstrap/app.js',
303
+ 'tailwind': 'resources/styles/tailwind/style.css',
304
+ 'shop-app': 'resources/admin/BlockEditor/ShopApp/ShopAppBlockEditor.jsx'
305
+ }
306
+ }
307
+ }
308
+ })
309
+ ```
310
+
311
+ ### SCSS Compilation
312
+
313
+ Organize styles with SCSS:
314
+
315
+ ```
316
+ // resources/styles/…
317
+ @import 'variables';
318
+ @import 'mixins';
319
+
320
+ .fluent-cart-checkout {
321
+ &__form {
322
+ @include form-styles;
323
+
324
+ &-group {
325
+ margin-bottom: 1rem;
326
+ }
327
+ }
328
+
329
+ &__payment-methods {
330
+ @include payment-methods-styles;
331
+ }
332
+ }
333
+
334
+ // Variables
335
+ $primary-color: #007cba;
336
+ $border-radius: 4px;
337
+ $spacing: 1rem;
338
+
339
+ // Mixins
340
+ @mixin form-styles {
341
+ .form-control {
342
+ border: 1px solid #ddd;
343
+ border-radius: $border-radius;
344
+ padding: 0.5rem;
345
+
346
+ &:focus {
347
+ border-color: $primary-color;
348
+ outline: none;
349
+ }
350
+ }
351
+ }
352
+ ```
353
+
354
+ ### JavaScript Bundling
355
+
356
+ Structure JavaScript files for optimal loading:
357
+
358
+ ```
359
+ // resources/public/checkout/…
360
+ import { createApp } from 'vue'
361
+ import CheckoutComponent from './components/Checkout.vue'
362
+ import '../scss/checkout.scss'
363
+
364
+ // Initialize checkout app
365
+ const checkoutApp = createApp(CheckoutComponent)
366
+ checkoutApp.mount('#checkout-app')
367
+
368
+ // Lazy load additional components
369
+ const loadPaymentMethods = () => {
370
+ return import('./components/PaymentMethods.vue')
371
+ }
372
+
373
+ // Load payment methods when needed
374
+ document.addEventListener('DOMContentLoaded', () => {
375
+ const paymentSection = document.querySelector('#payment-methods')
376
+ if (paymentSection) {
377
+ loadPaymentMethods().then(module => {
378
+ checkoutApp.component('PaymentMethods', module.default)
379
+ })
380
+ }
381
+ })
382
+ ```
383
+
384
+ ## Responsive Design
385
+
386
+ ### Mobile-First Approach
387
+
388
+ Design for mobile devices first:
389
+
390
+ ```
391
+ // Mobile-first responsive design
392
+ .fluent-cart-product {
393
+ display: block;
394
+ margin-bottom: 1rem;
395
+
396
+ // Tablet and up
397
+ @media (min-width: 768px) {
398
+ display: flex;
399
+ gap: 1rem;
400
+ }
401
+
402
+ // Desktop and up
403
+ @media (min-width: 1024px) {
404
+ gap: 2rem;
405
+ }
406
+ }
407
+
408
+ .fluent-cart-checkout {
409
+ &__form {
410
+ // Mobile: single column
411
+ display: block;
412
+
413
+ // Tablet: two columns
414
+ @media (min-width: 768px) {
415
+ display: grid;
416
+ grid-template-columns: 1fr 1fr;
417
+ gap: 1rem;
418
+ }
419
+ }
420
+ }
421
+ ```
422
+
423
+ ### Touch-Friendly Interface
424
+
425
+ Ensure touch-friendly interactions:
426
+
427
+ ```
428
+ .fluent-cart-button {
429
+ min-height: 44px; // Minimum touch target
430
+ padding: 0.75rem 1.5rem;
431
+ border-radius: 4px;
432
+
433
+ &:active {
434
+ transform: scale(0.98); // Touch feedback
435
+ }
436
+ }
437
+
438
+ .fluent-cart-input {
439
+ min-height: 44px;
440
+ padding: 0.75rem;
441
+ font-size: 16px; // Prevent zoom on iOS
442
+
443
+ @media (max-width: 767px) {
444
+ font-size: 16px; // Ensure no zoom
445
+ }
446
+ }
447
+ ```
448
+
449
+ ## Performance Optimization
450
+
451
+ ### Lazy Loading
452
+
453
+ Implement lazy loading for images and components:
454
+
455
+ ```
456
+ // Lazy load product images
457
+ const lazyImages = document.querySelectorAll('img[data-src]')
458
+
459
+ const imageObserver = new IntersectionObserver((entries) => {
460
+ entries.forEach(entry => {
461
+ if (entry.isIntersecting) {
462
+ const img = entry.target
463
+ img.src = img.dataset.src
464
+ img.classList.remove('lazy')
465
+ imageObserver.unobserve(img)
466
+ }
467
+ })
468
+ })
469
+
470
+ lazyImages.forEach(img => imageObserver.observe(img))
471
+ ```
472
+
473
+ ### Code Splitting
474
+
475
+ Split code for better performance:
476
+
477
+ ```
478
+ // Dynamic imports for route-based code splitting
479
+ const routes = [
480
+ {
481
+ path: '/checkout',
482
+ component: () => import('./views/Checkout.vue')
483
+ },
484
+ {
485
+ path: '/cart',
486
+ component: () => import('./views/Cart.vue')
487
+ }
488
+ ]
489
+ ```
490
+
491
+ ### Caching Strategies
492
+
493
+ Implement proper caching:
494
+
495
+ ```
496
+ // Service worker for caching
497
+ self.addEventListener('fetch', (event) => {
498
+ if (event.request.url.includes('/wp-json/fluent-cart/')) {
499
+ event.respondWith(
500
+ caches.match(event.request).then(response => {
501
+ return response || fetch(event.request).then(fetchResponse => {
502
+ return caches.open('fluent-cart-v1').then(cache => {
503
+ cache.put(event.request, fetchResponse.clone())
504
+ return fetchResponse
505
+ })
506
+ })
507
+ })
508
+ )
509
+ }
510
+ })
511
+ ```
512
+
513
+ ---
514
+
515
+ **Related Documentation:**
516
+
517
+ - [Template System](./../modules/) - Module development
518
+ - [REST API](./../api/) - API integration
519
+ - [Developer Hooks](./../hooks/) - Customization hooks