fluentcart-developer 2.3.4 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cards/fluentcart/tools.d.ts.map +1 -1
- package/dist/cards/fluentcart/tools.js +2368 -2323
- package/dist/cards/fluentcart/tools.js.map +1 -1
- package/dist/paths.d.ts +1 -1
- package/dist/paths.d.ts.map +1 -1
- package/dist/paths.js +1 -1
- package/dist/paths.js.map +1 -1
- package/dist/reference-reader.d.ts +32 -1
- package/dist/reference-reader.d.ts.map +1 -1
- package/dist/reference-reader.js +111 -22
- package/dist/reference-reader.js.map +1 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +8 -1
- package/dist/server.js.map +1 -1
- package/dist/skills/fluentcart-developer/SKILL.md +66 -538
- package/dist/skills/fluentcart-developer/references/api/authentication.md +452 -0
- package/dist/skills/fluentcart-developer/references/api/coupons.md +786 -0
- package/dist/skills/fluentcart-developer/references/api/customers.md +889 -0
- package/dist/skills/fluentcart-developer/references/api/files.md +609 -0
- package/dist/skills/fluentcart-developer/references/api/index.md +432 -0
- package/dist/skills/fluentcart-developer/references/api/licensing.md +633 -0
- package/dist/skills/fluentcart-developer/references/api/order-bump.md +384 -0
- package/dist/skills/fluentcart-developer/references/api/orders.md +814 -0
- package/dist/skills/fluentcart-developer/references/api/products.md +866 -0
- package/dist/skills/fluentcart-developer/references/api/roles-permissions.md +536 -0
- package/dist/skills/fluentcart-developer/references/api/subscriptions.md +827 -0
- package/dist/skills/fluentcart-developer/references/database/index.md +44 -0
- package/dist/skills/fluentcart-developer/references/database/models/activity.md +178 -0
- package/dist/skills/fluentcart-developer/references/database/models/applied-coupon.md +291 -0
- package/dist/skills/fluentcart-developer/references/database/models/attribute-group.md +239 -0
- package/dist/skills/fluentcart-developer/references/database/models/attribute-relation.md +181 -0
- package/dist/skills/fluentcart-developer/references/database/models/attribute-term.md +219 -0
- package/dist/skills/fluentcart-developer/references/database/models/cart.md +645 -0
- package/dist/skills/fluentcart-developer/references/database/models/coupon.md +427 -0
- package/dist/skills/fluentcart-developer/references/database/models/customer-addresses.md +348 -0
- package/dist/skills/fluentcart-developer/references/database/models/customer-meta.md +156 -0
- package/dist/skills/fluentcart-developer/references/database/models/customer.md +584 -0
- package/dist/skills/fluentcart-developer/references/database/models/dynamic-model.md +163 -0
- package/dist/skills/fluentcart-developer/references/database/models/label-relationship.md +155 -0
- package/dist/skills/fluentcart-developer/references/database/models/label.md +153 -0
- package/dist/skills/fluentcart-developer/references/database/models/license-activation.md +182 -0
- package/dist/skills/fluentcart-developer/references/database/models/license-meta.md +163 -0
- package/dist/skills/fluentcart-developer/references/database/models/license-site.md +208 -0
- package/dist/skills/fluentcart-developer/references/database/models/license.md +640 -0
- package/dist/skills/fluentcart-developer/references/database/models/meta.md +233 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-address.md +391 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-download-permission.md +144 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-item.md +383 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-meta.md +303 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-operation.md +158 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-promotion-stat.md +175 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-promotion.md +250 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-tax-rate.md +172 -0
- package/dist/skills/fluentcart-developer/references/database/models/order-transaction.md +440 -0
- package/dist/skills/fluentcart-developer/references/database/models/order.md +727 -0
- package/dist/skills/fluentcart-developer/references/database/models/product-detail.md +397 -0
- package/dist/skills/fluentcart-developer/references/database/models/product-download.md +258 -0
- package/dist/skills/fluentcart-developer/references/database/models/product-meta.md +153 -0
- package/dist/skills/fluentcart-developer/references/database/models/product-variation.md +556 -0
- package/dist/skills/fluentcart-developer/references/database/models/product.md +580 -0
- package/dist/skills/fluentcart-developer/references/database/models/relationships.md +427 -0
- package/dist/skills/fluentcart-developer/references/database/models/scheduled-action.md +175 -0
- package/dist/skills/fluentcart-developer/references/database/models/shipping-class.md +148 -0
- package/dist/skills/fluentcart-developer/references/database/models/shipping-method.md +280 -0
- package/dist/skills/fluentcart-developer/references/database/models/shipping-zone.md +205 -0
- package/dist/skills/fluentcart-developer/references/database/models/subscription-meta.md +173 -0
- package/dist/skills/fluentcart-developer/references/database/models/subscription.md +528 -0
- package/dist/skills/fluentcart-developer/references/database/models/tax-class.md +195 -0
- package/dist/skills/fluentcart-developer/references/database/models/tax-rate.md +225 -0
- package/dist/skills/fluentcart-developer/references/database/models/user-meta.md +166 -0
- package/dist/skills/fluentcart-developer/references/database/models/user.md +220 -0
- package/dist/skills/fluentcart-developer/references/database/models.md +404 -0
- package/dist/skills/fluentcart-developer/references/database/query-builder.md +860 -0
- package/dist/skills/fluentcart-developer/references/database/readme.md +276 -0
- package/dist/skills/fluentcart-developer/references/database/schema.md +1002 -0
- package/dist/skills/fluentcart-developer/references/engineering/adding-custom-pages-to-the-customer-dashboard.md +395 -0
- package/dist/skills/fluentcart-developer/references/engineering/index.md +4 -0
- package/dist/skills/fluentcart-developer/references/engineering.md +4 -0
- package/dist/skills/fluentcart-developer/references/getting-started.md +249 -0
- package/dist/skills/fluentcart-developer/references/guides/frontend.md +519 -0
- package/dist/skills/fluentcart-developer/references/guides/index.md +107 -0
- package/dist/skills/fluentcart-developer/references/guides/integrations.md +600 -0
- package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/index.md +237 -0
- package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/labels-and-tracking.md +481 -0
- package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/live-rates.md +269 -0
- package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/reference.md +223 -0
- package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/settings.md +370 -0
- package/dist/skills/fluentcart-developer/references/guides/shipping-carrier.md +237 -0
- package/dist/skills/fluentcart-developer/references/{subscription-customization.md → guides/subscriptions.md} +57 -37
- package/dist/skills/fluentcart-developer/references/hooks/actions/admin-and-templates.md +1079 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/cart-and-checkout.md +1795 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/customers-and-users.md +327 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/licenses.md +829 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/modules.md +81 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/orders.md +757 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/payments-and-integrations.md +1163 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/pro-modules.md +219 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/products-and-coupons.md +1019 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions/subscriptions.md +1290 -0
- package/dist/skills/fluentcart-developer/references/hooks/actions.md +16 -0
- package/dist/skills/fluentcart-developer/references/hooks/deprecated.md +60 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/cart-and-checkout.md +2032 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/customers-and-subscriptions.md +1746 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/integrations-and-advanced.md +2439 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/modules.md +464 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/orders-and-payments.md +2658 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/pro-modules.md +502 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/products-and-pricing.md +1785 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters/settings-and-configuration.md +2966 -0
- package/dist/skills/fluentcart-developer/references/hooks/filters.md +14 -0
- package/dist/skills/fluentcart-developer/references/hooks/index.md +35 -0
- package/dist/skills/fluentcart-developer/references/index.md +625 -0
- package/dist/skills/fluentcart-developer/references/{fee-system-guide.md → modules/fee-system.md} +38 -60
- package/dist/skills/fluentcart-developer/references/{ghost-product-selling.md → modules/ghost-product-selling.md} +71 -89
- package/dist/skills/fluentcart-developer/references/modules/index.md +484 -0
- package/dist/skills/fluentcart-developer/references/modules/licensing.md +342 -0
- package/dist/skills/fluentcart-developer/references/modules/order-bump.md +433 -0
- package/dist/skills/fluentcart-developer/references/modules/payment-methods.md +129 -0
- package/dist/skills/fluentcart-developer/references/modules/refunds.md +170 -0
- package/dist/skills/fluentcart-developer/references/modules/shipping.md +846 -0
- package/dist/skills/fluentcart-developer/references/modules/storage.md +986 -0
- package/dist/skills/fluentcart-developer/references/modules/subscription-vendor-ids.md +186 -0
- package/dist/skills/fluentcart-developer/references/modules/subscriptions.md +678 -0
- package/dist/skills/fluentcart-developer/references/payment-methods-integration/index.md +164 -0
- package/dist/skills/fluentcart-developer/references/payment-methods-integration/paddle-example.md +1648 -0
- package/dist/skills/fluentcart-developer/references/payment-methods-integration/payment/setting/fields.md +353 -0
- package/dist/skills/fluentcart-developer/references/payment-methods-integration/quick-implementation.md +1079 -0
- package/dist/skills/fluentcart-developer/references/payment-methods-integration.md +164 -0
- package/dist/skills/fluentcart-developer/references/restapi/checkout.md +573 -0
- package/dist/skills/fluentcart-developer/references/restapi/coupons.md +958 -0
- package/dist/skills/fluentcart-developer/references/restapi/customer-profile.md +1423 -0
- package/dist/skills/fluentcart-developer/references/{rest-api-customers.md → restapi/customers.md} +406 -424
- package/dist/skills/fluentcart-developer/references/restapi/dashboard.md +1083 -0
- package/dist/skills/fluentcart-developer/references/restapi/data-export.md +132 -0
- package/dist/skills/fluentcart-developer/references/restapi/email-notifications.md +846 -0
- package/dist/skills/fluentcart-developer/references/restapi/files.md +313 -0
- package/dist/skills/fluentcart-developer/references/restapi/index.md +127 -0
- package/dist/skills/fluentcart-developer/references/restapi/integrations.md +1000 -0
- package/dist/skills/fluentcart-developer/references/restapi/inventory.md +192 -0
- package/dist/skills/fluentcart-developer/references/restapi/labels-and-attributes.md +797 -0
- package/dist/skills/fluentcart-developer/references/restapi/licensing.md +1733 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-available-shipping-methods.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-checkout-summary.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-country-info.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-order-info.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-shipping-methods-list-view.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/login.md +66 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/place-order.md +179 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/apply-coupon.md +83 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/cancel-coupon.md +87 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/check-product-eligibility.md +59 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/create-coupon.md +230 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/delete-coupon.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon-settings.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupon-codes.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupons.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/re-apply-coupons.md +75 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/store-coupon-settings.md +40 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/update-coupon.md +133 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-address-checkout.md +138 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-profile-address.md +119 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/dashboard-overview.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/delete-profile-address.md +46 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-order-details.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-portal-sections.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-profile-details.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-transaction-billing-address.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-upgrade-paths.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-downloads.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-orders.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/make-profile-address-primary.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/pause-subscription.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/resume-subscription.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/save-transaction-billing-address.md +92 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/select-address-for-checkout.md +32 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-address.md +115 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-details.md +69 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/attach-user.md +50 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/bulk-actions.md +65 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-address.md +135 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-customer.md +108 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/delete-address.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/detach-user.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/find-customer-order.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-attachable-users.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-addresses.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-orders.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-stats.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer.md +32 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/list-customers.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/recalculate-ltv.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/set-primary-address.md +72 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-additional-info.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-address.md +144 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-customer.md +123 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/attach-note-to-order.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-all-pages.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-single-page.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/delete-activity.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-country-info.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-dashboard-stats.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-filter-options.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-data.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-settings.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-print-templates.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-search-options.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-widgets.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/initialize-app.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-activities.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-attachments.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-countries.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/mark-activity-read.md +53 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/run-data-backfills.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-settings.md +54 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-tax-settings.md +73 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-print-templates.md +64 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/upload-attachment.md +42 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-customers-batch.md +129 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-licenses-batch.md +133 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-orders-batch.md +129 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-subscriptions-batch.md +129 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-customers-export-schema.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-licenses-export-schema.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-orders-export-schema.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-subscriptions-export-schema.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/enable-notification.md +57 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-digest-settings.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-notification.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-reminders.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-settings.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-shortcodes.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/list-notifications.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-default-template.md +66 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-notification.md +50 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-digest-settings.md +101 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-reminders.md +162 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-settings.md +99 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-digest-test.md +47 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-manual-reminder.md +51 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/update-notification.md +93 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/files/delete-file.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/files/get-bucket-list.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/files/list-files.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-editor-file.md +32 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-file.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/chained-data-request.md +46 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/change-feed-status.md +51 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/delete-feed.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-dynamic-options.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-lists.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-settings.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-feeds.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-settings.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/install-addon-plugin.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/list-addons.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/save-feed-settings.md +52 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/integration/set-global-settings.md +50 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/bulk-update-stock.md +94 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/export-inventory.md +81 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-adjustment-history.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-inventory-stats.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/list-inventory.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/update-stock.md +75 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-attribute-group.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-label.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-terms.md +90 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-group.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-term.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-group.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-library.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-groups.md +32 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-terms.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-labels.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-groups.md +51 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-terms.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-group.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-term.md +39 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-label-selections.md +32 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-plugin-license.md +41 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-site-admin.md +60 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-plugin-license.md +18 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-admin.md +67 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-customer.md +47 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/delete-license.md +24 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/extend-license-validity.md +47 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-license-details.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-licenses-admin.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-activations.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-details.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-site.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-plugin-license-status.md +18 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-product-license-settings.md +24 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-customer-licenses.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-license-sites.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-licenses.md +38 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-activate-license.md +54 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-check-license.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-deactivate-license.md +46 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-download-license-package.md +23 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-get-license-version.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/regenerate-license-key.md +24 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/save-product-license-settings.md +193 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-activation-limit.md +53 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-status.md +52 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/create-order-bump.md +47 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/delete-order-bump.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/get-order-bump.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/list-order-bumps.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/update-order-bump.md +141 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/accept-dispute.md +47 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/bulk-actions.md +72 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-shipping.md +67 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-tax.md +98 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/change-customer.md +50 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/charge-now.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-and-change-customer.md +92 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-custom-order-item.md +68 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-order.md +351 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-renewal-now.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/delete-order.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/generate-missing-licenses.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order-transactions.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-renewal.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-shipping-methods.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-single-transaction.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-order-currencies.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-orders.md +42 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-renewals.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/mark-as-paid.md +61 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/price-order.md +135 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/refund-order.md +72 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/resend-renewal-invoice.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/skip-renewal.md +48 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-order-statuses.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-pending-transaction.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address-id.md +60 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address.md +98 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order.md +172 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-statuses.md +77 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-subscription-details.md +84 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-transaction-status.md +51 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/orders/void-renewal.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/create-pdf-template.md +42 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/delete-pdf-template.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/download-pdf-preview.md +44 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-factory-default-templates.md +19 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-status.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-template.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-saved-templates.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-seller-details.md +19 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/list-pdf-templates.md +19 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-pdf-template.md +53 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-seller-details.md +97 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/add-product-terms.md +64 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-edit-fetch.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-insert-products.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-products.md +59 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-variants.md +83 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/change-integration-status.md +64 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-dummy-products.md +45 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-product.md +81 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-variation.md +181 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-downloadable-file.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product-integration.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-taxonomy-term.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-upgrade-path.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-variation.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/do-bulk-action.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/duplicate-product.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-products-by-ids.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-taxonomy-terms.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-terms-by-parent.md +60 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-variations-by-ids.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/find-subscription-variants.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-bundle-info.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-downloadable-url.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-max-excerpt-word-count.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-pricing-widgets.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-feeds.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-settings.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-pricing.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-related-products.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-upgrade-settings.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-variation-upgrade-paths.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/group-bulk-update-variants.md +103 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-all-variants.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-product-variations.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-products.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-shipping-class.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-tax-class.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-bundle-info.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-product-integration.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-upgrade-path.md +78 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-product-variant-options.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-products-by-name.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-variants-by-name.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/set-variation-media.md +74 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/suggest-sku.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-downloadable-files.md +134 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-taxonomy-terms.md +61 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/toggle-product-tax-exemption.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-downloadable-file.md +98 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-inventory.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-long-desc-editor-mode.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-manage-stock.md +53 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-detail.md +58 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-pricing.md +225 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-shipping-class.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-tax-class.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-upgrade-path.md +78 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-option.md +79 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-tax-exemption.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation-pricing-table.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation.md +105 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/get-product-views.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/list-products.md +42 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/search-products.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/channel-rules.md +24 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/country-heat-map.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupon-overview.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupons.md +36 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-insights.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-overview.md +36 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-repeat.md +35 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segment-customers.md +36 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segments.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-value.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/dashboard-stats.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/failed-orders.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-new-vs-returning-customer.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-by-day-and-hour.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-meta.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-top-sold-products.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/future-renewals.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/generate-retention-snapshots.md +24 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-overview.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-activities.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-orders.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-revenue.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-at-risk.md +35 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-variations.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/item-count-distribution.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-chart.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-pie-chart.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-summary.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/locations.md +43 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-chart.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-completion-time.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-mix.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-value-distribution.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-disputes.md +38 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-methods.md +36 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison-launch.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison.md +40 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-detail.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-sales.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/refunds-overview.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/retention-snapshots-step.md +45 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sales-growth-chart.md +35 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/save-channel-rules.md +73 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/source-channels.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sources.md +49 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-cohorts.md +33 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-health.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-rebuys.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-retention.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-variations.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscriptions-overview.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/reports/weeks-between-refund.md +34 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/assign-role.md +48 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/delete-role-assignment.md +47 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/get-role.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-managers.md +18 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-roles.md +18 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/search-users.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/update-role.md +43 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/create-saved-view.md +106 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/delete-saved-view.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/list-saved-views.md +25 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/update-saved-view.md +83 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-payment-addon.md +44 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-plugin-addon.md +44 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/change-storage-driver-status.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/check-paypal-webhook.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/create-storage-bucket.md +63 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/disconnect-payment-method.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/exchange-paypal-seller-auth-token.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-active-storage-drivers.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-checkout-fields.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-email-shortcodes.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-config-snippets.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-status.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-module-settings.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-connection-info.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-settings.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-permissions.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-plugin-addons.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-storage-driver-settings.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-store-settings.md +26 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-mcp-adapter.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-payment-addon.md +60 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-plugin-addon.md +64 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-payment-methods.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-storage-drivers.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-storage-buckets.md +67 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reorder-payment-methods.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reset-storage-driver-settings.md +45 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-checkout-fields.md +133 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-confirmation-settings.md +68 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-module-settings.md +68 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-design.md +67 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-settings.md +58 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-permissions.md +68 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-storage-driver-settings.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-store-settings.md +239 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/setup-paypal-webhook.md +48 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/toggle-mcp.md +40 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-storage-driver-connection.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-turnstile-keys.md +55 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-class.md +73 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-method.md +110 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-zone.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-class.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-method.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-zone.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class-profile.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-packages.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-zone.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-countries.md +22 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-states.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-classes.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-zones.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/save-shipping-packages.md +112 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-class.md +79 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-method.md +113 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-zone.md +62 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-zone-order.md +52 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-auto-renew.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-subscription.md +52 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/confirm-subscription-switch.md +70 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/fetch-subscription-remote.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/generate-early-payment-link.md +29 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-customer-subscription.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-or-create-plan.md +69 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-setup-intent-attempts.md +30 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-subscription.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/initiate-early-payment.md +31 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-customer-subscriptions.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-subscriptions.md +39 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/pause-subscription.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/reactivate-subscription.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/resume-subscription.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/switch-payment-method.md +70 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-payment-method.md +69 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-vendor-ids.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/verify-vendor-ids.md +56 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-class.md +51 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-rate.md +117 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-product-override.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-shipping-tax-override.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-class.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-rate.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-id.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-rates.md +28 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-eu-vat-product-overrides.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-oss-country-rates.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-preconfigured-tax-rates.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-product-overrides.md +27 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-tax-settings.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-all-tax-rates.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-classes.md +20 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-records.md +37 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/mark-taxes-as-filed.md +58 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/reset-eu-vat-rates.md +21 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-configured-countries.md +57 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-country-tax-id.md +50 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-eu-vat-cross-border-settings.md +127 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-oss-country-rates.md +100 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-product-override.md +110 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-shipping-tax-override.md +52 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-tax-settings.md +166 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-country-status.md +54 -0
- package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-tax-rate.md +116 -0
- package/dist/skills/fluentcart-developer/references/restapi/order-bumps.md +433 -0
- package/dist/skills/fluentcart-developer/references/{rest-api-orders.md → restapi/orders.md} +146 -396
- package/dist/skills/fluentcart-developer/references/restapi/pdf-templates.md +212 -0
- package/dist/skills/fluentcart-developer/references/{rest-api-products.md → restapi/products.md} +354 -566
- package/dist/skills/fluentcart-developer/references/restapi/public-shop.md +191 -0
- package/dist/skills/fluentcart-developer/references/restapi/reports.md +3773 -0
- package/dist/skills/fluentcart-developer/references/restapi/roles.md +403 -0
- package/dist/skills/fluentcart-developer/references/restapi/saved-views.md +136 -0
- package/dist/skills/fluentcart-developer/references/restapi/settings.md +1423 -0
- package/dist/skills/fluentcart-developer/references/{rest-api-shipping.md → restapi/shipping.md} +243 -138
- package/dist/skills/fluentcart-developer/references/restapi/subscriptions.md +1169 -0
- package/dist/skills/fluentcart-developer/references/restapi/tax.md +1551 -0
- package/dist/skills/fluentcart-developer/references/restapi.md +127 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
- package/dist/skills/fluentcart-developer/.claude-plugin/plugin.json +0 -12
- package/dist/skills/fluentcart-developer/.mcp.json +0 -11
- package/dist/skills/fluentcart-developer/references/action-hooks-admin-templates.md +0 -787
- package/dist/skills/fluentcart-developer/references/action-hooks-cart-checkout.md +0 -1355
- package/dist/skills/fluentcart-developer/references/action-hooks-customers-users.md +0 -266
- package/dist/skills/fluentcart-developer/references/action-hooks-licenses.md +0 -855
- package/dist/skills/fluentcart-developer/references/action-hooks-orders.md +0 -631
- package/dist/skills/fluentcart-developer/references/action-hooks-payments-integrations.md +0 -963
- package/dist/skills/fluentcart-developer/references/action-hooks-products-coupons.md +0 -585
- package/dist/skills/fluentcart-developer/references/action-hooks-subscriptions.md +0 -661
- package/dist/skills/fluentcart-developer/references/customer-dashboard-endpoints.md +0 -169
- package/dist/skills/fluentcart-developer/references/database-models-query-builder.md +0 -194
- package/dist/skills/fluentcart-developer/references/database-models-reference.md +0 -604
- package/dist/skills/fluentcart-developer/references/database-schema-reference.md +0 -947
- package/dist/skills/fluentcart-developer/references/engineering-notes.md +0 -154
- package/dist/skills/fluentcart-developer/references/filter-hooks-cart-checkout.md +0 -1202
- package/dist/skills/fluentcart-developer/references/filter-hooks-customers-subscriptions.md +0 -902
- package/dist/skills/fluentcart-developer/references/filter-hooks-integrations-advanced.md +0 -1598
- package/dist/skills/fluentcart-developer/references/filter-hooks-orders-payments.md +0 -1319
- package/dist/skills/fluentcart-developer/references/filter-hooks-products-pricing.md +0 -628
- package/dist/skills/fluentcart-developer/references/filter-hooks-settings-configuration.md +0 -1177
- package/dist/skills/fluentcart-developer/references/fluentcart-developer-guide.md +0 -154
- package/dist/skills/fluentcart-developer/references/hooks-complete-index.md +0 -834
- package/dist/skills/fluentcart-developer/references/models-complete-index.md +0 -912
- package/dist/skills/fluentcart-developer/references/modules-and-extensions-reference.md +0 -224
- package/dist/skills/fluentcart-developer/references/order-bump-module.md +0 -163
- package/dist/skills/fluentcart-developer/references/paddle-gateway-case-study.md +0 -1931
- package/dist/skills/fluentcart-developer/references/payment-gateway-integration.md +0 -761
- package/dist/skills/fluentcart-developer/references/rest-api-checkout.md +0 -288
- package/dist/skills/fluentcart-developer/references/rest-api-coupons.md +0 -801
- package/dist/skills/fluentcart-developer/references/rest-api-customer-profile.md +0 -190
- package/dist/skills/fluentcart-developer/references/rest-api-dashboard-utilities.md +0 -219
- package/dist/skills/fluentcart-developer/references/rest-api-email-notifications.md +0 -619
- package/dist/skills/fluentcart-developer/references/rest-api-files.md +0 -290
- package/dist/skills/fluentcart-developer/references/rest-api-integrations.md +0 -324
- package/dist/skills/fluentcart-developer/references/rest-api-labels-attributes.md +0 -321
- package/dist/skills/fluentcart-developer/references/rest-api-licensing.md +0 -174
- package/dist/skills/fluentcart-developer/references/rest-api-order-bumps.md +0 -200
- package/dist/skills/fluentcart-developer/references/rest-api-overview.md +0 -131
- package/dist/skills/fluentcart-developer/references/rest-api-public-shop.md +0 -172
- package/dist/skills/fluentcart-developer/references/rest-api-reference.md +0 -552
- package/dist/skills/fluentcart-developer/references/rest-api-reports.md +0 -377
- package/dist/skills/fluentcart-developer/references/rest-api-roles-permissions.md +0 -147
- package/dist/skills/fluentcart-developer/references/rest-api-settings.md +0 -528
- package/dist/skills/fluentcart-developer/references/rest-api-subscriptions.md +0 -938
- package/dist/skills/fluentcart-developer/references/rest-api-tax.md +0 -356
- package/dist/skills/fluentcart-developer/references/shipping-module-guide.md +0 -126
- package/dist/skills/fluentcart-developer/references/software-licensing-sdk.md +0 -228
- package/dist/skills/fluentcart-developer/references/storage-drivers-module.md +0 -140
|
@@ -0,0 +1,757 @@
|
|
|
1
|
+
# Orders
|
|
2
|
+
|
|
3
|
+
All hooks related to order lifecycle, status transitions, payments, shipping, refunds, and order items. These action hooks allow you to respond to key order events in FluentCart.
|
|
4
|
+
|
|
5
|
+
Each hook passes an associative array as its single parameter. The `order` value is always an [`\FluentCart\App\Models\Order`](/database/models/order.md) model instance with the [`customer`](/database/models/customer.md), `shipping_address`, and `billing_address` relationships eager-loaded (unless noted otherwise).
|
|
6
|
+
|
|
7
|
+
> **Amounts are in cents.** All monetary values (`total`, `refunded_amount`, etc.) are stored as integers in the smallest currency unit. Use `Helper::toDecimal($amount)` to convert for display.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Order Status Changes
|
|
12
|
+
|
|
13
|
+
Fired when the **order status** field changes (e.g. `processing` → `completed`). Both a dynamic, status-specific hook and a generic hook fire on every change.
|
|
14
|
+
|
|
15
|
+
### ` order_status_changed_to_{status} `
|
|
16
|
+
|
|
17
|
+
`fluent_cart/order_status_changed_to_{$newStatus}` — Fires when the order status changes to a specific status
|
|
18
|
+
|
|
19
|
+
**When it runs:** Fires inside `OrderStatusUpdated::afterDispatch()` whenever the order status type transitions to a new value. The `{$newStatus}` portion is replaced dynamically with the target status, so you can listen for a single status you care about.
|
|
20
|
+
|
|
21
|
+
**Available dynamic variants:** `completed`, `canceled`, `processing`, `on-hold`, `failed`
|
|
22
|
+
|
|
23
|
+
**Parameters:**
|
|
24
|
+
|
|
25
|
+
- `$data` (array): Order status change data
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
$data = [
|
|
29
|
+
'order' => $order, // \FluentCart\App\Models\Order (with customer, addresses loaded)
|
|
30
|
+
'old_status' => 'processing', // Previous order status string
|
|
31
|
+
'new_status' => 'completed', // New order status string (matches the dynamic suffix)
|
|
32
|
+
'manageStock' => true, // Whether stock management should be applied
|
|
33
|
+
'activity' => [ // Optional activity log context
|
|
34
|
+
'title' => '',
|
|
35
|
+
'content' => '',
|
|
36
|
+
],
|
|
37
|
+
];
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
**Source:** `app/Events/Order/OrderStatusUpdated.php` (line 91)
|
|
41
|
+
|
|
42
|
+
**Usage:**
|
|
43
|
+
|
|
44
|
+
```
|
|
45
|
+
add_action('fluent_cart/order_status_changed_to_completed', function ($data) {
|
|
46
|
+
$order = $data['order'];
|
|
47
|
+
// Grant digital access when order completes
|
|
48
|
+
grant_digital_access($order->customer_id, $order->id);
|
|
49
|
+
}, 10, 1);
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
### ` order_status_changed `
|
|
53
|
+
|
|
54
|
+
`fluent_cart/order_status_changed` — Fires on any order status change
|
|
55
|
+
|
|
56
|
+
**When it runs:** Fires immediately after the dynamic `order_status_changed_to_{$newStatus}` hook, on every order status transition regardless of the target status. Use this when you need to react to all status changes in a single callback.
|
|
57
|
+
|
|
58
|
+
**Parameters:**
|
|
59
|
+
|
|
60
|
+
- `$data` (array): Order status change data
|
|
61
|
+
|
|
62
|
+
```
|
|
63
|
+
$data = [
|
|
64
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
65
|
+
'old_status' => 'processing', // Previous order status
|
|
66
|
+
'new_status' => 'completed', // New order status
|
|
67
|
+
'manageStock' => true, // Whether stock management applies
|
|
68
|
+
'activity' => [
|
|
69
|
+
'title' => '',
|
|
70
|
+
'content' => '',
|
|
71
|
+
],
|
|
72
|
+
];
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
**Source:** `app/Events/Order/OrderStatusUpdated.php` (line 92)
|
|
76
|
+
|
|
77
|
+
**Usage:**
|
|
78
|
+
|
|
79
|
+
```
|
|
80
|
+
add_action('fluent_cart/order_status_changed', function ($data) {
|
|
81
|
+
$order = $data['order'];
|
|
82
|
+
// Log every status transition
|
|
83
|
+
fluent_cart_add_log(
|
|
84
|
+
'Order status changed',
|
|
85
|
+
sprintf('Order #%d: %s -> %s', $order->id, $data['old_status'], $data['new_status']),
|
|
86
|
+
'info'
|
|
87
|
+
);
|
|
88
|
+
}, 10, 1);
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
## Payment Status Changes
|
|
94
|
+
|
|
95
|
+
Fired when the **payment status** field changes (e.g. `pending` → `paid`). Both a dynamic, status-specific hook and a generic hook fire on every change.
|
|
96
|
+
|
|
97
|
+
### ` payment_status_changed_to_{status} `
|
|
98
|
+
|
|
99
|
+
`fluent_cart/payment_status_changed_to_{$newStatus}` — Fires when payment status changes to a specific status
|
|
100
|
+
|
|
101
|
+
**When it runs:** Fires inside `OrderStatusUpdated::afterDispatch()` when the status change type is `payment_status`. The `{$newStatus}` suffix is replaced dynamically so you can target a single payment state.
|
|
102
|
+
|
|
103
|
+
**Available dynamic variants:** `pending`, `paid`, `partially_paid`, `failed`, `refunded`, `partially_refunded`, `authorized`
|
|
104
|
+
|
|
105
|
+
**Parameters:**
|
|
106
|
+
|
|
107
|
+
- `$data` (array): Payment status change data
|
|
108
|
+
|
|
109
|
+
```
|
|
110
|
+
$data = [
|
|
111
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
112
|
+
'old_status' => 'pending', // Previous payment status
|
|
113
|
+
'new_status' => 'paid', // New payment status (matches the dynamic suffix)
|
|
114
|
+
'manageStock' => true, // Whether stock management applies
|
|
115
|
+
'activity' => [
|
|
116
|
+
'title' => '',
|
|
117
|
+
'content' => '',
|
|
118
|
+
],
|
|
119
|
+
];
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
**Source:** `app/Events/Order/OrderStatusUpdated.php` (line 81)
|
|
123
|
+
|
|
124
|
+
**Usage:**
|
|
125
|
+
|
|
126
|
+
```
|
|
127
|
+
add_action('fluent_cart/payment_status_changed_to_paid', function ($data) {
|
|
128
|
+
$order = $data['order'];
|
|
129
|
+
// Trigger fulfillment workflow when payment is confirmed
|
|
130
|
+
do_action('my_custom_fulfillment_start', $order->id);
|
|
131
|
+
}, 10, 1);
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
### ` payment_status_changed `
|
|
135
|
+
|
|
136
|
+
`fluent_cart/payment_status_changed` — Fires on any payment status change
|
|
137
|
+
|
|
138
|
+
**When it runs:** Fires immediately after the dynamic `payment_status_changed_to_{$newStatus}` hook, on every payment status transition. Use this when you need a single callback for all payment status changes.
|
|
139
|
+
|
|
140
|
+
**Parameters:**
|
|
141
|
+
|
|
142
|
+
- `$data` (array): Payment status change data
|
|
143
|
+
|
|
144
|
+
```
|
|
145
|
+
$data = [
|
|
146
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
147
|
+
'old_status' => 'pending', // Previous payment status
|
|
148
|
+
'new_status' => 'paid', // New payment status
|
|
149
|
+
'manageStock' => true, // Whether stock management applies
|
|
150
|
+
'activity' => [
|
|
151
|
+
'title' => '',
|
|
152
|
+
'content' => '',
|
|
153
|
+
],
|
|
154
|
+
];
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
**Source:** `app/Events/Order/OrderStatusUpdated.php` (line 82)
|
|
158
|
+
|
|
159
|
+
**Usage:**
|
|
160
|
+
|
|
161
|
+
```
|
|
162
|
+
add_action('fluent_cart/payment_status_changed', function ($data) {
|
|
163
|
+
$order = $data['order'];
|
|
164
|
+
// Send payment status update notification
|
|
165
|
+
if ($data['new_status'] === 'paid') {
|
|
166
|
+
wp_mail($order->customer->email, 'Payment Confirmed', 'Your payment has been received.');
|
|
167
|
+
}
|
|
168
|
+
}, 10, 1);
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
---
|
|
172
|
+
|
|
173
|
+
## Shipping Status Changes
|
|
174
|
+
|
|
175
|
+
Fired when the **shipping status** field changes (e.g. `unshipped` → `shipped`). Both a dynamic, status-specific hook and a generic hook fire on every change.
|
|
176
|
+
|
|
177
|
+
### ` shipping_status_changed_to_{status} `
|
|
178
|
+
|
|
179
|
+
`fluent_cart/shipping_status_changed_to_{$newStatus}` — Fires when shipping status changes to a specific status
|
|
180
|
+
|
|
181
|
+
**When it runs:** Fires inside `OrderStatusUpdated::afterDispatch()` when the status change type is `shipping_status`. The `{$newStatus}` suffix is replaced dynamically so you can target a single shipping state.
|
|
182
|
+
|
|
183
|
+
**Available dynamic variants:** `unshipped`, `shipped`, `delivered`, `unshippable`
|
|
184
|
+
|
|
185
|
+
**Parameters:**
|
|
186
|
+
|
|
187
|
+
- `$data` (array): Shipping status change data
|
|
188
|
+
|
|
189
|
+
```
|
|
190
|
+
$data = [
|
|
191
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
192
|
+
'old_status' => 'unshipped', // Previous shipping status
|
|
193
|
+
'new_status' => 'shipped', // New shipping status (matches the dynamic suffix)
|
|
194
|
+
'manageStock' => true, // Whether stock management applies
|
|
195
|
+
'activity' => [
|
|
196
|
+
'title' => '',
|
|
197
|
+
'content' => '',
|
|
198
|
+
],
|
|
199
|
+
];
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
**Source:** `app/Events/Order/OrderStatusUpdated.php` (line 86)
|
|
203
|
+
|
|
204
|
+
**Usage:**
|
|
205
|
+
|
|
206
|
+
```
|
|
207
|
+
add_action('fluent_cart/shipping_status_changed_to_shipped', function ($data) {
|
|
208
|
+
$order = $data['order'];
|
|
209
|
+
// Notify customer that their order has shipped
|
|
210
|
+
wp_mail(
|
|
211
|
+
$order->customer->email,
|
|
212
|
+
'Your Order Has Shipped!',
|
|
213
|
+
sprintf('Order #%d has been shipped.', $order->id)
|
|
214
|
+
);
|
|
215
|
+
}, 10, 1);
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
### ` shipping_status_changed `
|
|
219
|
+
|
|
220
|
+
`fluent_cart/shipping_status_changed` — Fires on any shipping status change
|
|
221
|
+
|
|
222
|
+
**When it runs:** Fires immediately after the dynamic `shipping_status_changed_to_{$newStatus}` hook, on every shipping status transition. Use this when you need a single callback for all shipping status changes.
|
|
223
|
+
|
|
224
|
+
**Parameters:**
|
|
225
|
+
|
|
226
|
+
- `$data` (array): Shipping status change data
|
|
227
|
+
|
|
228
|
+
```
|
|
229
|
+
$data = [
|
|
230
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
231
|
+
'old_status' => 'unshipped', // Previous shipping status
|
|
232
|
+
'new_status' => 'shipped', // New shipping status
|
|
233
|
+
'manageStock' => true, // Whether stock management applies
|
|
234
|
+
'activity' => [
|
|
235
|
+
'title' => '',
|
|
236
|
+
'content' => '',
|
|
237
|
+
],
|
|
238
|
+
];
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
**Source:** `app/Events/Order/OrderStatusUpdated.php` (line 87)
|
|
242
|
+
|
|
243
|
+
**Usage:**
|
|
244
|
+
|
|
245
|
+
```
|
|
246
|
+
add_action('fluent_cart/shipping_status_changed', function ($data) {
|
|
247
|
+
$order = $data['order'];
|
|
248
|
+
// Log all shipping status transitions
|
|
249
|
+
fluent_cart_add_log(
|
|
250
|
+
'Shipping status changed',
|
|
251
|
+
sprintf('Order #%d: %s -> %s', $order->id, $data['old_status'], $data['new_status']),
|
|
252
|
+
'info'
|
|
253
|
+
);
|
|
254
|
+
}, 10, 1);
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
---
|
|
258
|
+
|
|
259
|
+
## Refunds
|
|
260
|
+
|
|
261
|
+
Fired during the refund flow after transaction records have been created. The generic `order_refunded` hook fires on every refund, followed by either `order_fully_refunded` or `order_partially_refunded` depending on the refund type. Refund data includes the [Order](/database/models/order.md), [OrderItem](/database/models/order-item.md), [OrderTransaction](/database/models/order-transaction.md), and [Customer](/database/models/customer.md) models.
|
|
262
|
+
|
|
263
|
+
### ` order_refunded `
|
|
264
|
+
|
|
265
|
+
`fluent_cart/order_refunded` — Fires after any refund (full or partial)
|
|
266
|
+
|
|
267
|
+
**When it runs:** Fires inside `OrderRefund::afterDispatch()` after a refund transaction is recorded and the refund amount is calculated. This hook fires for both full and partial refunds. It fires before the type-specific hooks below.
|
|
268
|
+
|
|
269
|
+
**Parameters:**
|
|
270
|
+
|
|
271
|
+
- `$data` (array): Refund data
|
|
272
|
+
|
|
273
|
+
```
|
|
274
|
+
$data = [
|
|
275
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
276
|
+
'refunded_items' => [], // Array of OrderItem models (looked up from refundedItemIds)
|
|
277
|
+
'new_refunded_items' => [], // Raw refunded items array with restore_quantity info
|
|
278
|
+
'refunded_amount' => 5000, // Newly refunded amount in cents
|
|
279
|
+
'manage_stock' => true, // Whether stock should be restored
|
|
280
|
+
'transaction' => $transaction, // \FluentCart\App\Models\OrderTransaction (the refund transaction)
|
|
281
|
+
'customer' => $customer, // \FluentCart\App\Models\Customer
|
|
282
|
+
'type' => 'full', // 'full' or 'partial'
|
|
283
|
+
];
|
|
284
|
+
```
|
|
285
|
+
|
|
286
|
+
**Source:** `app/Events/Order/OrderRefund.php` (line 141)
|
|
287
|
+
|
|
288
|
+
**Usage:**
|
|
289
|
+
|
|
290
|
+
```
|
|
291
|
+
add_action('fluent_cart/order_refunded', function ($data) {
|
|
292
|
+
$order = $data['order'];
|
|
293
|
+
$amount = \FluentCart\App\Helpers\Helper::toDecimal($data['refunded_amount']);
|
|
294
|
+
// Notify admin of any refund
|
|
295
|
+
wp_mail(
|
|
296
|
+
get_option('admin_email'),
|
|
297
|
+
sprintf('Refund on Order #%d', $order->id),
|
|
298
|
+
sprintf('A %s refund of %s has been processed.', $data['type'], $amount)
|
|
299
|
+
);
|
|
300
|
+
}, 10, 1);
|
|
301
|
+
```
|
|
302
|
+
|
|
303
|
+
### ` order_fully_refunded `
|
|
304
|
+
|
|
305
|
+
`fluent_cart/order_fully_refunded` — Fires only when an order is fully refunded
|
|
306
|
+
|
|
307
|
+
**When it runs:** Fires inside `OrderRefund::afterDispatch()` immediately after the generic `order_refunded` hook, but only when the total refunded amount meets or exceeds the order's total paid amount (i.e. full refund).
|
|
308
|
+
|
|
309
|
+
**Parameters:**
|
|
310
|
+
|
|
311
|
+
- `$data` (array): Full refund data (identical structure to `order_refunded`)
|
|
312
|
+
|
|
313
|
+
```
|
|
314
|
+
$data = [
|
|
315
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
316
|
+
'refunded_items' => [], // Array of OrderItem models
|
|
317
|
+
'new_refunded_items' => [], // Raw refunded items with restore_quantity
|
|
318
|
+
'refunded_amount' => 10000, // Refunded amount in cents
|
|
319
|
+
'manage_stock' => true, // Whether stock should be restored
|
|
320
|
+
'transaction' => $transaction, // \FluentCart\App\Models\OrderTransaction
|
|
321
|
+
'customer' => $customer, // \FluentCart\App\Models\Customer
|
|
322
|
+
'type' => 'full', // Always 'full' for this hook
|
|
323
|
+
];
|
|
324
|
+
```
|
|
325
|
+
|
|
326
|
+
**Source:** `app/Events/Order/OrderRefund.php` (line 144)
|
|
327
|
+
|
|
328
|
+
**Usage:**
|
|
329
|
+
|
|
330
|
+
```
|
|
331
|
+
add_action('fluent_cart/order_fully_refunded', function ($data) {
|
|
332
|
+
$order = $data['order'];
|
|
333
|
+
// Revoke digital access on full refund
|
|
334
|
+
update_user_meta($order->customer_id, 'membership_active', false);
|
|
335
|
+
}, 10, 1);
|
|
336
|
+
```
|
|
337
|
+
|
|
338
|
+
### ` order_partially_refunded `
|
|
339
|
+
|
|
340
|
+
`fluent_cart/order_partially_refunded` — Fires only when an order is partially refunded
|
|
341
|
+
|
|
342
|
+
**When it runs:** Fires inside `OrderRefund::afterDispatch()` immediately after the generic `order_refunded` hook, but only when the total refunded amount is less than the order's total paid amount (i.e. partial refund).
|
|
343
|
+
|
|
344
|
+
**Parameters:**
|
|
345
|
+
|
|
346
|
+
- `$data` (array): Partial refund data (identical structure to `order_refunded`)
|
|
347
|
+
|
|
348
|
+
```
|
|
349
|
+
$data = [
|
|
350
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
351
|
+
'refunded_items' => [], // Array of OrderItem models
|
|
352
|
+
'new_refunded_items' => [], // Raw refunded items with restore_quantity
|
|
353
|
+
'refunded_amount' => 3000, // Refunded amount in cents
|
|
354
|
+
'manage_stock' => true, // Whether stock should be restored
|
|
355
|
+
'transaction' => $transaction, // \FluentCart\App\Models\OrderTransaction
|
|
356
|
+
'customer' => $customer, // \FluentCart\App\Models\Customer
|
|
357
|
+
'type' => 'partial', // Always 'partial' for this hook
|
|
358
|
+
];
|
|
359
|
+
```
|
|
360
|
+
|
|
361
|
+
**Source:** `app/Events/Order/OrderRefund.php` (line 146)
|
|
362
|
+
|
|
363
|
+
**Usage:**
|
|
364
|
+
|
|
365
|
+
```
|
|
366
|
+
add_action('fluent_cart/order_partially_refunded', function ($data) {
|
|
367
|
+
$order = $data['order'];
|
|
368
|
+
$customer = $data['customer'];
|
|
369
|
+
// Notify customer of partial refund
|
|
370
|
+
wp_mail(
|
|
371
|
+
$customer->email,
|
|
372
|
+
'Partial Refund Processed',
|
|
373
|
+
sprintf('A partial refund has been issued for Order #%d.', $order->id)
|
|
374
|
+
);
|
|
375
|
+
}, 10, 1);
|
|
376
|
+
```
|
|
377
|
+
|
|
378
|
+
---
|
|
379
|
+
|
|
380
|
+
## Order Items
|
|
381
|
+
|
|
382
|
+
Hooks that fire when custom line items on an order are being deleted. These are useful for cleanup or audit logging on custom [OrderItem](/database/models/order-item.md) records.
|
|
383
|
+
|
|
384
|
+
### ` order/before_custom_items_deleted `
|
|
385
|
+
|
|
386
|
+
`fluent_cart/order/before_custom_items_deleted` — Fires before custom line items are deleted
|
|
387
|
+
|
|
388
|
+
**When it runs:** Fires inside `OrderResource::updateOrderItems()` just before custom order items (flagged as `is_custom`) are permanently deleted from the database. Only fires if the filtered collection of custom items is not empty.
|
|
389
|
+
|
|
390
|
+
**Parameters:**
|
|
391
|
+
|
|
392
|
+
- `$customItems` (\Illuminate\Support\Collection): Collection of [`\FluentCart\App\Models\OrderItem`](/database/models/order-item.md) models about to be deleted (only items where `is_custom` is true)
|
|
393
|
+
- `$order` ([`\FluentCart\App\Models\Order`](/database/models/order.md)): The parent order model
|
|
394
|
+
|
|
395
|
+
**Source:** `api/Resource/OrderResource.php` (line 1624)
|
|
396
|
+
|
|
397
|
+
**Usage:**
|
|
398
|
+
|
|
399
|
+
```
|
|
400
|
+
add_action('fluent_cart/order/before_custom_items_deleted', function ($customItems, $order) {
|
|
401
|
+
// Archive custom items before they are removed
|
|
402
|
+
foreach ($customItems as $item) {
|
|
403
|
+
fluent_cart_add_log(
|
|
404
|
+
'Custom item removed',
|
|
405
|
+
sprintf('Item "%s" removed from Order #%d', $item->title, $order->id),
|
|
406
|
+
'info'
|
|
407
|
+
);
|
|
408
|
+
}
|
|
409
|
+
}, 10, 2);
|
|
410
|
+
```
|
|
411
|
+
|
|
412
|
+
### ` order/after_custom_items_deleted `
|
|
413
|
+
|
|
414
|
+
`fluent_cart/order/after_custom_items_deleted` — Fires after custom line items are deleted
|
|
415
|
+
|
|
416
|
+
**When it runs:** Fires inside `OrderResource::updateOrderItems()` immediately after custom order items have been permanently deleted from the database. The collection still holds the model instances (now removed from DB). Only fires if the collection is not empty.
|
|
417
|
+
|
|
418
|
+
**Parameters:**
|
|
419
|
+
|
|
420
|
+
- `$customItems` (\Illuminate\Support\Collection): Collection of [`\FluentCart\App\Models\OrderItem`](/database/models/order-item.md) models that were just deleted
|
|
421
|
+
- `$order` ([`\FluentCart\App\Models\Order`](/database/models/order.md)): The parent order model
|
|
422
|
+
|
|
423
|
+
**Source:** `api/Resource/OrderResource.php` (line 1630)
|
|
424
|
+
|
|
425
|
+
**Usage:**
|
|
426
|
+
|
|
427
|
+
```
|
|
428
|
+
add_action('fluent_cart/order/after_custom_items_deleted', function ($customItems, $order) {
|
|
429
|
+
// Recalculate order totals after custom items removed
|
|
430
|
+
$order->recalculateTotals();
|
|
431
|
+
}, 10, 2);
|
|
432
|
+
```
|
|
433
|
+
|
|
434
|
+
---
|
|
435
|
+
|
|
436
|
+
## Order Lifecycle
|
|
437
|
+
|
|
438
|
+
General lifecycle hooks that fire at key moments during an [Order](/database/models/order.md)'s existence: invoice generation, [Customer](/database/models/customer.md) changes, payment completion, license generation, and receipt viewing.
|
|
439
|
+
|
|
440
|
+
### ` order/invoice_number_added `
|
|
441
|
+
|
|
442
|
+
`fluent_cart/order/invoice_number_added` — Fires after an invoice/receipt number is assigned to an order
|
|
443
|
+
|
|
444
|
+
**When it runs:** Fires in two places:
|
|
445
|
+
|
|
446
|
+
1. Inside the `Order::booted()` `created` callback, immediately after a new order is persisted to the database with an invoice number already set (when payment status is `paid` at creation time).
|
|
447
|
+
2. Inside `Order::generateReceiptNumber()`, when a receipt number is generated for an existing order that did not previously have one.
|
|
448
|
+
|
|
449
|
+
**Parameters:**
|
|
450
|
+
|
|
451
|
+
- `$data` (array): Order data
|
|
452
|
+
|
|
453
|
+
```
|
|
454
|
+
$data = [
|
|
455
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
456
|
+
];
|
|
457
|
+
```
|
|
458
|
+
|
|
459
|
+
**Source:** `app/Models/Order.php` (lines 60 and 734)
|
|
460
|
+
|
|
461
|
+
**Usage:**
|
|
462
|
+
|
|
463
|
+
```
|
|
464
|
+
add_action('fluent_cart/order/invoice_number_added', function ($data) {
|
|
465
|
+
$order = $data['order'];
|
|
466
|
+
// Sync invoice number to external accounting system
|
|
467
|
+
sync_to_accounting($order->id, $order->invoice_no, $order->receipt_number);
|
|
468
|
+
}, 10, 1);
|
|
469
|
+
```
|
|
470
|
+
|
|
471
|
+
### ` order_customer_changed `
|
|
472
|
+
|
|
473
|
+
`fluent_cart/order_customer_changed` — Fires when the customer assigned to an order changes
|
|
474
|
+
|
|
475
|
+
**When it runs:** Fires inside `OrderController::changeCustomer()` after the order (and any child orders and [subscriptions](/database/models/subscription.md)) have been reassigned to a new customer, and both the old and new customer stats have been recounted.
|
|
476
|
+
|
|
477
|
+
**Parameters:**
|
|
478
|
+
|
|
479
|
+
- `$data` (array): Customer change data
|
|
480
|
+
|
|
481
|
+
```
|
|
482
|
+
$data = [
|
|
483
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
484
|
+
'old_customer' => $oldCustomer, // \FluentCart\App\Models\Customer|null
|
|
485
|
+
'new_customer' => $newCustomer, // \FluentCart\App\Models\Customer
|
|
486
|
+
'connected_order_ids' => [123, 124], // Array of all order IDs updated (parent + children)
|
|
487
|
+
];
|
|
488
|
+
```
|
|
489
|
+
|
|
490
|
+
**Source:** `app/Http/Controllers/OrderController.php` (line 536)
|
|
491
|
+
|
|
492
|
+
**Usage:**
|
|
493
|
+
|
|
494
|
+
```
|
|
495
|
+
add_action('fluent_cart/order_customer_changed', function ($data) {
|
|
496
|
+
$order = $data['order'];
|
|
497
|
+
$oldCustomer = $data['old_customer'];
|
|
498
|
+
$newCustomer = $data['new_customer'];
|
|
499
|
+
// Notify the new customer about the transfer
|
|
500
|
+
wp_mail(
|
|
501
|
+
$newCustomer->email,
|
|
502
|
+
'Order Transferred to Your Account',
|
|
503
|
+
sprintf('Order #%d has been assigned to your account.', $order->id)
|
|
504
|
+
);
|
|
505
|
+
}, 10, 1);
|
|
506
|
+
```
|
|
507
|
+
|
|
508
|
+
### ` order/generateMissingLicenses `
|
|
509
|
+
|
|
510
|
+
`fluent_cart/order/generateMissingLicenses` — Fires when an admin triggers license generation for an order
|
|
511
|
+
|
|
512
|
+
**When it runs:** Fires inside `OrderController::generateLicense()` when an admin requests license generation for an order that has fewer licenses than expected. This allows license modules to hook in and create the missing license keys.
|
|
513
|
+
|
|
514
|
+
**Parameters:**
|
|
515
|
+
|
|
516
|
+
- `$data` (array): Order data
|
|
517
|
+
|
|
518
|
+
```
|
|
519
|
+
$data = [
|
|
520
|
+
'order' => $order, // \FluentCart\App\Models\Order (with order_items and licenses loaded)
|
|
521
|
+
];
|
|
522
|
+
```
|
|
523
|
+
|
|
524
|
+
**Source:** `app/Http/Controllers/OrderController.php` (line 324)
|
|
525
|
+
|
|
526
|
+
**Usage:**
|
|
527
|
+
|
|
528
|
+
```
|
|
529
|
+
add_action('fluent_cart/order/generateMissingLicenses', function ($data) {
|
|
530
|
+
$order = $data['order'];
|
|
531
|
+
// Generate licenses for each eligible order item
|
|
532
|
+
foreach ($order->order_items as $item) {
|
|
533
|
+
generate_license_key($order->id, $item->product_id);
|
|
534
|
+
}
|
|
535
|
+
}, 10, 1);
|
|
536
|
+
```
|
|
537
|
+
|
|
538
|
+
### ` order_placed_offline `
|
|
539
|
+
|
|
540
|
+
`fluent_cart/order_placed_offline` — Fires when an order is placed via Cash on Delivery or other offline payment
|
|
541
|
+
|
|
542
|
+
**When it runs:** Fires inside `CodHandler::processPayment()` after the order and its [transaction](/database/models/order-transaction.md) have been created for an offline/COD payment. The [Order](/database/models/order.md), [Customer](/database/models/customer.md), and transaction data are all available at this point. The order has its `customer`, `shipping_address`, and `billing_address` relationships loaded.
|
|
543
|
+
|
|
544
|
+
**Parameters:**
|
|
545
|
+
|
|
546
|
+
- `$data` (array): Offline order data
|
|
547
|
+
|
|
548
|
+
```
|
|
549
|
+
$data = [
|
|
550
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
551
|
+
'customer' => $order->customer ?? [], // \FluentCart\App\Models\Customer or empty array
|
|
552
|
+
'transaction' => $transaction ?? [], // \FluentCart\App\Models\OrderTransaction or empty array
|
|
553
|
+
];
|
|
554
|
+
```
|
|
555
|
+
|
|
556
|
+
**Source:** `app/Modules/PaymentMethods/Cod/CodHandler.php` (line 59)
|
|
557
|
+
|
|
558
|
+
**Usage:**
|
|
559
|
+
|
|
560
|
+
```
|
|
561
|
+
add_action('fluent_cart/order_placed_offline', function ($data) {
|
|
562
|
+
$order = $data['order'];
|
|
563
|
+
// Notify warehouse of new COD order
|
|
564
|
+
wp_mail(
|
|
565
|
+
'[email protected]',
|
|
566
|
+
sprintf('New COD Order #%d', $order->id),
|
|
567
|
+
'A new Cash on Delivery order needs to be prepared for shipment.'
|
|
568
|
+
);
|
|
569
|
+
}, 10, 1);
|
|
570
|
+
```
|
|
571
|
+
|
|
572
|
+
### ` order_paid_done `
|
|
573
|
+
|
|
574
|
+
`fluent_cart/order_paid_done` — Main lifecycle hook when order payment completes (recommended for integrations)
|
|
575
|
+
|
|
576
|
+
**When it runs:** Fires asynchronously via Action Scheduler after an order's payment is confirmed as `paid`. The `OrderPaid` event enqueues a `fluent_cart/order_paid_async_private_handle` async action, which validates the order is still paid, then dispatches this hook. This is the **recommended hook for third-party integrations** because it runs outside the payment gateway request cycle, avoiding race conditions and timeouts. For subscription or renewal orders, the associated [Subscription](/database/models/subscription.md) model is included in the data.
|
|
577
|
+
|
|
578
|
+
**Parameters:**
|
|
579
|
+
|
|
580
|
+
- `$data` (array): Order payment completion data
|
|
581
|
+
|
|
582
|
+
```
|
|
583
|
+
$data = [
|
|
584
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
585
|
+
'transaction' => $transaction, // \FluentCart\App\Models\OrderTransaction (latest successful transaction)
|
|
586
|
+
'customer' => $customer, // \FluentCart\App\Models\Customer
|
|
587
|
+
'subscription' => $subscription, // \FluentCart\App\Models\Subscription (only for subscription/renewal orders)
|
|
588
|
+
];
|
|
589
|
+
```
|
|
590
|
+
|
|
591
|
+
**Note:** The `subscription` key is only present when the order type is `subscription` or `renewal`.
|
|
592
|
+
|
|
593
|
+
**Source:** `app/Hooks/actions.php` (line 170)
|
|
594
|
+
|
|
595
|
+
**Usage:**
|
|
596
|
+
|
|
597
|
+
```
|
|
598
|
+
add_action('fluent_cart/order_paid_done', function ($data) {
|
|
599
|
+
$order = $data['order'];
|
|
600
|
+
$customer = $data['customer'];
|
|
601
|
+
|
|
602
|
+
// Grant membership access after payment
|
|
603
|
+
update_user_meta($customer->user_id, 'membership_active', true);
|
|
604
|
+
|
|
605
|
+
// Handle subscription orders differently
|
|
606
|
+
if (!empty($data['subscription'])) {
|
|
607
|
+
$subscription = $data['subscription'];
|
|
608
|
+
update_user_meta($customer->user_id, 'subscription_id', $subscription->id);
|
|
609
|
+
}
|
|
610
|
+
}, 10, 1);
|
|
611
|
+
```
|
|
612
|
+
|
|
613
|
+
### ` order/receipt_viewed `
|
|
614
|
+
|
|
615
|
+
`fluent_cart/order/receipt_viewed` — Fires the first time a customer views their order receipt
|
|
616
|
+
|
|
617
|
+
**When it runs:** Fires at the end of receipt rendering (both the `ReceiptRenderer` class and the `receipt_slip.php` view template) when the `$is_first_time` flag is true. This means it only fires once per order, the very first time the receipt page is loaded. Subsequent views do not trigger this hook. The data includes both the [Order](/database/models/order.md) and [OrderOperation](/database/models/order-operation.md) models.
|
|
618
|
+
|
|
619
|
+
**Parameters:**
|
|
620
|
+
|
|
621
|
+
- `$data` (array): Receipt view data
|
|
622
|
+
|
|
623
|
+
```
|
|
624
|
+
$data = [
|
|
625
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
626
|
+
'order_operation' => $order_operation, // \FluentCart\App\Models\OrderOperation
|
|
627
|
+
];
|
|
628
|
+
```
|
|
629
|
+
|
|
630
|
+
**Source:** `app/Services/Renderer/Receipt/ReceiptRenderer.php` (line 162), `app/Views/invoice/receipt_slip.php` (line 482)
|
|
631
|
+
|
|
632
|
+
**Usage:**
|
|
633
|
+
|
|
634
|
+
```
|
|
635
|
+
add_action('fluent_cart/order/receipt_viewed', function ($data) {
|
|
636
|
+
$order = $data['order'];
|
|
637
|
+
// Track receipt view for analytics
|
|
638
|
+
fluent_cart_add_log(
|
|
639
|
+
'Receipt viewed',
|
|
640
|
+
sprintf('Customer viewed receipt for Order #%d', $order->id),
|
|
641
|
+
'info',
|
|
642
|
+
['module_name' => 'order', 'module_id' => $order->id]
|
|
643
|
+
);
|
|
644
|
+
}, 10, 1);
|
|
645
|
+
```
|
|
646
|
+
|
|
647
|
+
### ` order_canceled `
|
|
648
|
+
|
|
649
|
+
`fluent_cart/order_canceled` — Fires when a renewal order is canceled/voided
|
|
650
|
+
|
|
651
|
+
**When it runs:** Fires inside `RenewalController`'s void/cancel flow, immediately after the order's customer stats have been recounted and immediately before the more specific `fluent_cart/renewal_voided` hook (same call site, one line later). Both hooks receive the same payload.
|
|
652
|
+
|
|
653
|
+
**Parameters:**
|
|
654
|
+
|
|
655
|
+
- `$data` (array): Canceled order data
|
|
656
|
+
|
|
657
|
+
```
|
|
658
|
+
$data = [
|
|
659
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
660
|
+
'customer' => $order->customer, // \FluentCart\App\Models\Customer
|
|
661
|
+
];
|
|
662
|
+
```
|
|
663
|
+
|
|
664
|
+
**Source:** `app/Http/Controllers/RenewalController.php:122`
|
|
665
|
+
|
|
666
|
+
**Usage:**
|
|
667
|
+
|
|
668
|
+
```
|
|
669
|
+
add_action('fluent_cart/order_canceled', function ($data) {
|
|
670
|
+
$order = $data['order'];
|
|
671
|
+
fluent_cart_add_log(
|
|
672
|
+
'Order Canceled',
|
|
673
|
+
sprintf('Order #%d was canceled/voided.', $order->id),
|
|
674
|
+
'info'
|
|
675
|
+
);
|
|
676
|
+
}, 10, 1);
|
|
677
|
+
```
|
|
678
|
+
|
|
679
|
+
### ` order_paid_async_private_handle `
|
|
680
|
+
|
|
681
|
+
`fluent_cart/order_paid_async_private_handle` — Internal async post-payment hook for non-renewal orders
|
|
682
|
+
|
|
683
|
+
**When it runs:** Fires inside `IntegrationEventListener` after an order is confirmed paid, but only when the order's `type` is **not** `renewal`. It is also enqueued as an Action Scheduler job from `OrderPaid`. **You should generally hook into `fluent_cart/order_paid_done` instead of this internal hook.**
|
|
684
|
+
|
|
685
|
+
**Parameters:**
|
|
686
|
+
|
|
687
|
+
- `$data` (array): Order identifier
|
|
688
|
+
|
|
689
|
+
```
|
|
690
|
+
$data = [
|
|
691
|
+
'order_id' => 123, // int — the order ID
|
|
692
|
+
];
|
|
693
|
+
```
|
|
694
|
+
|
|
695
|
+
**Source:** `app/Listeners/IntegrationEventListener.php:380`
|
|
696
|
+
|
|
697
|
+
**Usage:**
|
|
698
|
+
|
|
699
|
+
```
|
|
700
|
+
// Not recommended for third-party use. Use fluent_cart/order_paid_done instead.
|
|
701
|
+
add_action('fluent_cart/order_paid_async_private_handle', function ($data) {
|
|
702
|
+
$orderId = $data['order_id'];
|
|
703
|
+
}, 10, 1);
|
|
704
|
+
```
|
|
705
|
+
|
|
706
|
+
---
|
|
707
|
+
|
|
708
|
+
---
|
|
709
|
+
|
|
710
|
+
## Order Emails
|
|
711
|
+
|
|
712
|
+
### ` email/order_entitlements `
|
|
713
|
+
|
|
714
|
+
`fluent_cart/email/order_entitlements` — Print what an order grants in the order email
|
|
715
|
+
|
|
716
|
+
**When it runs:** This action fires while FluentCart renders an order email, after the licenses block and before the downloads block. Use it to show what the order grants, for example a membership or course access. It fires in two places:
|
|
717
|
+
|
|
718
|
+
- `order_paid_customer`: the default body of the paid-order email to the customer.
|
|
719
|
+
- `payment_receipt`: the payment receipt smartcode, which custom email bodies use.
|
|
720
|
+
|
|
721
|
+
The output is captured into the email body. **Echo your HTML** and escape your own values. Use inline styles, because email clients drop most CSS.
|
|
722
|
+
|
|
723
|
+
The action does not fire for the email preview in the admin, because the preview uses a sample order.
|
|
724
|
+
|
|
725
|
+
**Parameters:**
|
|
726
|
+
|
|
727
|
+
- `$data` (array): Order and render context
|
|
728
|
+
|
|
729
|
+
```
|
|
730
|
+
$data = [
|
|
731
|
+
'order' => $order, // \FluentCart\App\Models\Order
|
|
732
|
+
'context' => 'order_paid_customer', // or 'payment_receipt'
|
|
733
|
+
];
|
|
734
|
+
```
|
|
735
|
+
|
|
736
|
+
**Source:**
|
|
737
|
+
|
|
738
|
+
- `app/Views/emails/order/paid/customer.php:52`
|
|
739
|
+
- `app/Services/ShortCodeParser/Parsers/OrderParser.php:340`
|
|
740
|
+
|
|
741
|
+
**Usage:**
|
|
742
|
+
|
|
743
|
+
```
|
|
744
|
+
add_action('fluent_cart/email/order_entitlements', function ($data) {
|
|
745
|
+
$order = $data['order'];
|
|
746
|
+
|
|
747
|
+
$levels = my_plugin_get_levels_for_order($order->id);
|
|
748
|
+
if (!$levels) {
|
|
749
|
+
return;
|
|
750
|
+
}
|
|
751
|
+
|
|
752
|
+
echo '<h3 style="margin: 20px 0 10px;">' . esc_html__('Your memberships', 'my-plugin') . '</h3>';
|
|
753
|
+
foreach ($levels as $level) {
|
|
754
|
+
echo '<p style="margin: 0 0 6px;">' . esc_html($level->title) . '</p>';
|
|
755
|
+
}
|
|
756
|
+
}, 10, 1);
|
|
757
|
+
```
|