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
package/dist/skills/fluentcart-developer/references/{fee-system-guide.md → modules/fee-system.md}
RENAMED
|
@@ -2,8 +2,6 @@
|
|
|
2
2
|
|
|
3
3
|
FluentCart provides a built-in fee system that allows developers to attach additional charges to a cart during checkout. This is useful for processing fees, handling fees, small-order surcharges, payment gateway surcharges, environmental levies, and more.
|
|
4
4
|
|
|
5
|
-
---
|
|
6
|
-
|
|
7
5
|
## Overview
|
|
8
6
|
|
|
9
7
|
Fees are stored as order items with `payment_type = 'fee'` and a cached `fee_total` column on the order for fast aggregation. The system provides two ways to register fees:
|
|
@@ -20,13 +18,11 @@ Fees automatically integrate with:
|
|
|
20
18
|
- Refund distribution (proportional)
|
|
21
19
|
- REST API responses
|
|
22
20
|
|
|
23
|
-
---
|
|
24
|
-
|
|
25
21
|
## Fee Data Structure
|
|
26
22
|
|
|
27
23
|
Every fee follows this structure:
|
|
28
24
|
|
|
29
|
-
```
|
|
25
|
+
```
|
|
30
26
|
[
|
|
31
27
|
'key' => 'processing_fee', // Unique slug (required)
|
|
32
28
|
'label' => 'Processing Fee', // Customer-facing name (required)
|
|
@@ -37,7 +33,7 @@ Every fee follows this structure:
|
|
|
37
33
|
]
|
|
38
34
|
```
|
|
39
35
|
|
|
40
|
-
|
|
36
|
+
**Rules:**
|
|
41
37
|
|
|
42
38
|
- `amount` must be a positive integer (in cents). Negative values are rejected.
|
|
43
39
|
- `key` is sanitized with `sanitize_key()`. Combined with `source`, it forms a composite dedup key (`source:key`).
|
|
@@ -53,17 +49,15 @@ Use the `fluent_cart/cart/fees` filter to add fees that are recalculated on ever
|
|
|
53
49
|
|
|
54
50
|
**Parameters:**
|
|
55
51
|
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
| `$fees` | `array` | Current fees array (may contain fees from other addons or stored fees) |
|
|
59
|
-
| `$context` | `array` | Cart context for condition evaluation |
|
|
52
|
+
- `$fees` (array): Current fees array (may contain fees from other addons or stored fees)
|
|
53
|
+
- `$context` (array): Cart context for condition evaluation
|
|
60
54
|
|
|
61
55
|
**Returns:** Modified fees array
|
|
62
56
|
|
|
63
|
-
|
|
57
|
+
**Context array contents:**
|
|
64
58
|
|
|
65
59
|
| Key | Type | Description |
|
|
66
|
-
|
|
60
|
+
| --- | --- | --- |
|
|
67
61
|
| `cart` | `Cart` | The Cart model instance |
|
|
68
62
|
| `cart_items` | `array` | Current cart item data |
|
|
69
63
|
| `cart_subtotal` | `int` | Cart subtotal in cents (before discounts) |
|
|
@@ -76,12 +70,10 @@ Use the `fluent_cart/cart/fees` filter to add fees that are recalculated on ever
|
|
|
76
70
|
|
|
77
71
|
Add a $5 fee when the cart subtotal is under $25:
|
|
78
72
|
|
|
79
|
-
```
|
|
73
|
+
```
|
|
80
74
|
add_filter('fluent_cart/cart/fees', function (array $fees, array $context) {
|
|
81
|
-
// Get cart subtotal in cents
|
|
82
75
|
$subtotal = $context['cart_subtotal'];
|
|
83
76
|
|
|
84
|
-
// Apply $5 fee only when subtotal is between $0.01 and $24.99
|
|
85
77
|
if ($subtotal > 0 && $subtotal < 2500) {
|
|
86
78
|
$fees[] = [
|
|
87
79
|
'key' => 'small_order_fee',
|
|
@@ -101,9 +93,8 @@ add_filter('fluent_cart/cart/fees', function (array $fees, array $context) {
|
|
|
101
93
|
|
|
102
94
|
Add a 2.9% processing fee for Stripe payments:
|
|
103
95
|
|
|
104
|
-
```
|
|
96
|
+
```
|
|
105
97
|
add_filter('fluent_cart/cart/fees', function (array $fees, array $context) {
|
|
106
|
-
// Only apply fee for Stripe payment method
|
|
107
98
|
if ($context['payment_method'] !== 'stripe') {
|
|
108
99
|
return $fees;
|
|
109
100
|
}
|
|
@@ -113,7 +104,6 @@ add_filter('fluent_cart/cart/fees', function (array $fees, array $context) {
|
|
|
113
104
|
return $fees;
|
|
114
105
|
}
|
|
115
106
|
|
|
116
|
-
// Calculate 2.9% of subtotal, rounded to nearest cent
|
|
117
107
|
$feeAmount = (int) round($subtotal * 0.029);
|
|
118
108
|
|
|
119
109
|
$fees[] = [
|
|
@@ -133,17 +123,14 @@ add_filter('fluent_cart/cart/fees', function (array $fees, array $context) {
|
|
|
133
123
|
|
|
134
124
|
Add a handling fee for orders shipping to remote areas:
|
|
135
125
|
|
|
136
|
-
```
|
|
126
|
+
```
|
|
137
127
|
add_filter('fluent_cart/cart/fees', function (array $fees, array $context) {
|
|
138
|
-
// Extract shipping address from checkout data
|
|
139
128
|
$checkoutData = $context['checkout_data'];
|
|
140
129
|
$country = $checkoutData['form_data']['shipping_country'] ?? '';
|
|
141
130
|
$state = $checkoutData['form_data']['shipping_state'] ?? '';
|
|
142
131
|
|
|
143
|
-
// Define remote US territories
|
|
144
132
|
$remoteAreas = ['AK', 'HI', 'PR']; // Alaska, Hawaii, Puerto Rico
|
|
145
133
|
|
|
146
|
-
// Apply $15 handling fee for remote US areas
|
|
147
134
|
if ($country === 'US' && in_array($state, $remoteAreas, true)) {
|
|
148
135
|
$fees[] = [
|
|
149
136
|
'key' => 'remote_handling',
|
|
@@ -168,11 +155,9 @@ Use these methods to programmatically add or remove fees that are stored on the
|
|
|
168
155
|
|
|
169
156
|
Adds a fee to the cart and saves immediately. If a fee with the same `source:key` already exists, it will be updated.
|
|
170
157
|
|
|
171
|
-
```
|
|
172
|
-
// Find the cart by ID
|
|
158
|
+
```
|
|
173
159
|
$cart = \FluentCart\App\Models\Cart::find($cartId);
|
|
174
160
|
|
|
175
|
-
// Add a $2 handling fee to the cart
|
|
176
161
|
$cart->addFee([
|
|
177
162
|
'key' => 'handling_fee',
|
|
178
163
|
'label' => 'Handling Fee',
|
|
@@ -187,7 +172,7 @@ $cart->addFee([
|
|
|
187
172
|
|
|
188
173
|
Removes a fee by key. Optionally filter by source to avoid removing another addon's fee with the same key.
|
|
189
174
|
|
|
190
|
-
```
|
|
175
|
+
```
|
|
191
176
|
// Remove a specific fee by key and source
|
|
192
177
|
$cart->removeFee('handling_fee', 'my-addon');
|
|
193
178
|
|
|
@@ -199,7 +184,7 @@ $cart->removeFee('handling_fee');
|
|
|
199
184
|
|
|
200
185
|
Removes all fees from a specific source. Useful for clearing all your addon's fees before recalculating.
|
|
201
186
|
|
|
202
|
-
```
|
|
187
|
+
```
|
|
203
188
|
// Clear all fees from your addon
|
|
204
189
|
$cart->removeFeesBySource('my-addon');
|
|
205
190
|
```
|
|
@@ -212,8 +197,7 @@ Returns all validated fees (stored + dynamic from filter).
|
|
|
212
197
|
|
|
213
198
|
Returns the total of all fees in cents.
|
|
214
199
|
|
|
215
|
-
```
|
|
216
|
-
// Retrieve all fees and the total
|
|
200
|
+
```
|
|
217
201
|
$fees = $cart->getFees();
|
|
218
202
|
$total = $cart->getFeeTotal(); // e.g., 700 (= $7.00)
|
|
219
203
|
```
|
|
@@ -282,12 +266,11 @@ After an order is placed, fees are stored as order items. Use these methods to a
|
|
|
282
266
|
|
|
283
267
|
### `$order->feeItems()`
|
|
284
268
|
|
|
285
|
-
Returns a
|
|
269
|
+
Returns a HasMany relationship query for fee order items.
|
|
286
270
|
|
|
287
|
-
```
|
|
271
|
+
```
|
|
288
272
|
$order = \FluentCart\App\Models\Order::find($orderId);
|
|
289
273
|
|
|
290
|
-
// Iterate over fee items attached to this order
|
|
291
274
|
$feeItems = $order->feeItems()->get();
|
|
292
275
|
|
|
293
276
|
foreach ($feeItems as $item) {
|
|
@@ -301,7 +284,7 @@ foreach ($feeItems as $item) {
|
|
|
301
284
|
|
|
302
285
|
Returns a simplified array of applied fees.
|
|
303
286
|
|
|
304
|
-
```
|
|
287
|
+
```
|
|
305
288
|
$fees = $order->getAppliedFees();
|
|
306
289
|
// [
|
|
307
290
|
// [
|
|
@@ -318,7 +301,7 @@ $fees = $order->getAppliedFees();
|
|
|
318
301
|
|
|
319
302
|
Returns order items excluding fees and signup fees. Use this whenever displaying product line items to avoid showing fee rows in the product list.
|
|
320
303
|
|
|
321
|
-
```
|
|
304
|
+
```
|
|
322
305
|
// Correct: excludes fee and signup_fee items
|
|
323
306
|
$products = $order->getProductItems();
|
|
324
307
|
|
|
@@ -333,7 +316,7 @@ $feeTotal = $order->fee_total; // e.g., 650
|
|
|
333
316
|
When a fee becomes an order item, it has this structure in `fct_order_items`:
|
|
334
317
|
|
|
335
318
|
| Column | Value | Notes |
|
|
336
|
-
|
|
319
|
+
| --- | --- | --- |
|
|
337
320
|
| `post_id` | `0` | No product |
|
|
338
321
|
| `object_id` | `0` | No variation |
|
|
339
322
|
| `title` | `"Processing Fee"` | The fee label |
|
|
@@ -352,7 +335,7 @@ When a fee becomes an order item, it has this structure in `fct_order_items`:
|
|
|
352
335
|
|
|
353
336
|
Fired after fees are collected and stored on the cart during checkout summary recalculation.
|
|
354
337
|
|
|
355
|
-
```
|
|
338
|
+
```
|
|
356
339
|
add_action('fluent_cart/cart/fees_calculated', function (array $fees, $cart) {
|
|
357
340
|
// Log or track fee activity
|
|
358
341
|
if (!empty($fees)) {
|
|
@@ -365,7 +348,7 @@ add_action('fluent_cart/cart/fees_calculated', function (array $fees, $cart) {
|
|
|
365
348
|
|
|
366
349
|
Fired after fee order items are created during order placement.
|
|
367
350
|
|
|
368
|
-
```
|
|
351
|
+
```
|
|
369
352
|
add_action('fluent_cart/order/fee_items_created', function (array $feeOrderItems, $order) {
|
|
370
353
|
// Post-creation processing
|
|
371
354
|
}, 10, 2);
|
|
@@ -375,21 +358,14 @@ add_action('fluent_cart/order/fee_items_created', function (array $feeOrderItems
|
|
|
375
358
|
|
|
376
359
|
## Important Behavior Notes
|
|
377
360
|
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
- **Fees are read-only after order creation.** Once an order is placed, fee items cannot be edited from the admin panel.
|
|
387
|
-
|
|
388
|
-
- **Fees participate in proportional refunds.** When an order is refunded, fee items are included in the proportional distribution automatically.
|
|
389
|
-
|
|
390
|
-
- **Per-request caching.** `getFees()` caches results within a single request. Call `$cart->clearFeeCache()` if you modify fees and need to re-read within the same request.
|
|
391
|
-
|
|
392
|
-
- **Recursion guard.** If your filter callback calls `$cart->getFees()`, it returns only stored fees (not the filter result) to prevent infinite loops.
|
|
361
|
+
1. **Fees are recalculated on every checkout update.** Dynamic fees (via filter) run whenever the checkout summary refreshes — item changes, coupon application, payment method change, address change, etc.
|
|
362
|
+
2. **Fees are not applied to subscription renewals.** The filter is skipped when `checkout_data.renew_data.is_renewal` is `yes`.
|
|
363
|
+
3. **Fees are not applied to locked carts.** Custom/manual checkout carts that are locked return only stored fees without running the filter.
|
|
364
|
+
4. **Deduplication uses `source:key`.** Two addons can both register a fee with `key = 'processing_fee'` as long as they use different `source` values.
|
|
365
|
+
5. **Fees are read-only after order creation.** Once an order is placed, fee items cannot be edited from the admin panel.
|
|
366
|
+
6. **Fees participate in proportional refunds.** When an order is refunded, fee items are included in the proportional distribution automatically.
|
|
367
|
+
7. **Per-request caching.** `getFees()` caches results within a single request. Call `$cart->clearFeeCache()` if you modify fees and need to re-read within the same request.
|
|
368
|
+
8. **Recursion guard.** If your filter callback calls `$cart->getFees()`, it returns only stored fees (not the filter result) to prevent infinite loops.
|
|
393
369
|
|
|
394
370
|
---
|
|
395
371
|
|
|
@@ -397,7 +373,7 @@ add_action('fluent_cart/order/fee_items_created', function (array $feeOrderItems
|
|
|
397
373
|
|
|
398
374
|
A full working example that applies tiered handling fees based on cart subtotal:
|
|
399
375
|
|
|
400
|
-
```
|
|
376
|
+
```
|
|
401
377
|
<?php
|
|
402
378
|
/**
|
|
403
379
|
* Plugin Name: FluentCart Handling Fee
|
|
@@ -407,12 +383,11 @@ A full working example that applies tiered handling fees based on cart subtotal:
|
|
|
407
383
|
add_filter('fluent_cart/cart/fees', function (array $fees, array $context) {
|
|
408
384
|
$subtotal = $context['cart_subtotal'];
|
|
409
385
|
|
|
410
|
-
// Skip if cart is empty
|
|
411
386
|
if ($subtotal <= 0) {
|
|
412
387
|
return $fees;
|
|
413
388
|
}
|
|
414
389
|
|
|
415
|
-
// Tiered handling fee
|
|
390
|
+
// Tiered handling fee
|
|
416
391
|
$feeAmount = match (true) {
|
|
417
392
|
$subtotal < 2000 => 500, // Under $20: $5.00 fee
|
|
418
393
|
$subtotal < 5000 => 300, // $20-$49.99: $3.00 fee
|
|
@@ -420,7 +395,6 @@ add_filter('fluent_cart/cart/fees', function (array $fees, array $context) {
|
|
|
420
395
|
default => 0, // $100+: no fee
|
|
421
396
|
};
|
|
422
397
|
|
|
423
|
-
// Only add fee if amount is non-zero
|
|
424
398
|
if ($feeAmount > 0) {
|
|
425
399
|
$fees[] = [
|
|
426
400
|
'key' => 'handling_fee',
|
|
@@ -443,7 +417,11 @@ add_filter('fluent_cart/cart/fees', function (array $fees, array $context) {
|
|
|
443
417
|
|
|
444
418
|
## Related Documentation
|
|
445
419
|
|
|
446
|
-
- [Developer Hooks](
|
|
447
|
-
- [Orders API](
|
|
448
|
-
- [Database Models](database
|
|
449
|
-
- [Ghost Product Selling](ghost-product-selling.md) - Custom product selling guide
|
|
420
|
+
- [Developer Hooks](/hooks/) - Complete hooks and filters reference
|
|
421
|
+
- [Orders API](/restapi/operations/orders/) - Order management API
|
|
422
|
+
- [Database Models](/database/models/) - Data model documentation
|
|
423
|
+
- [Ghost Product Selling](/modules/ghost-product-selling.md) - Custom product selling guide
|
|
424
|
+
|
|
425
|
+
---
|
|
426
|
+
|
|
427
|
+
**Next Steps:** Explore [Custom Payment Gateway Integration](/payment-methods-integration/) or return to [Getting Started](/getting-started.md)
|
|
@@ -2,8 +2,6 @@
|
|
|
2
2
|
|
|
3
3
|
FluentCart provides a powerful hook system that allows developers to sell ghost products that don't exist in the product catalog. This feature enables selling add-ons, gift wrapping, custom subscriptions, and any other custom items through your store.
|
|
4
4
|
|
|
5
|
-
---
|
|
6
|
-
|
|
7
5
|
## Overview
|
|
8
6
|
|
|
9
7
|
Custom product selling allows you to add items to the cart that are not stored as regular products in the database. This is useful for:
|
|
@@ -13,8 +11,6 @@ Custom product selling allows you to add items to the cart that are not stored a
|
|
|
13
11
|
- **Dynamic Products** - Products created on-the-fly based on user selections
|
|
14
12
|
- **Service-Based Items** - One-time or recurring service purchases
|
|
15
13
|
|
|
16
|
-
---
|
|
17
|
-
|
|
18
14
|
## Implementation Flow
|
|
19
15
|
|
|
20
16
|
The complete implementation follows this flow:
|
|
@@ -33,8 +29,8 @@ Add the appropriate button to your page based on the item type.
|
|
|
33
29
|
|
|
34
30
|
For one-time purchases that are added to the cart:
|
|
35
31
|
|
|
36
|
-
```
|
|
37
|
-
<button
|
|
32
|
+
```
|
|
33
|
+
<button
|
|
38
34
|
data-cart-id="1000"
|
|
39
35
|
data-quantity="1"
|
|
40
36
|
data-is-custom="true"
|
|
@@ -48,13 +44,13 @@ For one-time purchases that are added to the cart:
|
|
|
48
44
|
|
|
49
45
|
For subscription items that go directly to checkout:
|
|
50
46
|
|
|
51
|
-
```
|
|
47
|
+
```
|
|
52
48
|
<a href="https://yourstore.com/?fluent-cart=instant_checkout&item_id=3001&quantity=1&is_custom=true">
|
|
53
49
|
Buy Now
|
|
54
50
|
</a>
|
|
55
51
|
```
|
|
56
52
|
|
|
57
|
-
|
|
53
|
+
**Note:** Replace `https://yourstore.com` with your actual site URL and `3001` with your custom item ID.
|
|
58
54
|
|
|
59
55
|
---
|
|
60
56
|
|
|
@@ -66,21 +62,17 @@ Use this filter to validate and return the custom product item when it's added t
|
|
|
66
62
|
|
|
67
63
|
**Parameters:**
|
|
68
64
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
| `$variation` | `object/array` | The variation object to be modified |
|
|
72
|
-
| `$item` | `array` | The item data from the request |
|
|
65
|
+
- `$variation` (object/array): The variation object to be modified
|
|
66
|
+
- `$item` (array): The item data from the request
|
|
73
67
|
|
|
74
68
|
**Returns:** The modified variation object
|
|
75
69
|
|
|
76
70
|
### Example: Validate New Custom Item
|
|
77
71
|
|
|
78
|
-
```
|
|
79
|
-
add_filter('fluent_cart/cart/validate_custom_item',
|
|
72
|
+
```
|
|
73
|
+
add_filter('fluent_cart/cart/validate_custom_item',
|
|
80
74
|
function($variation, $item) {
|
|
81
|
-
// Check if the item is flagged as custom
|
|
82
75
|
if ((bool)$item['is_custom']) {
|
|
83
|
-
// Build the custom variation object with all required fields
|
|
84
76
|
$variation = (object) [
|
|
85
77
|
'item_id' => absint($item['item_id']),
|
|
86
78
|
'object_id' => absint($item['item_id']),
|
|
@@ -111,30 +103,27 @@ function($variation, $item) {
|
|
|
111
103
|
|
|
112
104
|
## Step 3: Handle Quantity Changes (Cart)
|
|
113
105
|
|
|
114
|
-
This step applies only to
|
|
106
|
+
This step applies only to one-time items for quantity increment/decrement actions.
|
|
115
107
|
|
|
116
108
|
### Hook: `fluent_cart/cart/custom_item_quantity_changed`
|
|
117
109
|
|
|
118
110
|
**Parameters:**
|
|
119
111
|
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
| `$variation` | `object/array` | The variation object to be updated |
|
|
123
|
-
| `$item` | `array` | Item data including quantity changes |
|
|
112
|
+
- `$variation` (object/array): The variation object to be updated
|
|
113
|
+
- `$item` (array): Item data including quantity changes
|
|
124
114
|
|
|
125
115
|
**Returns:** The modified variation object with updated quantity and totals
|
|
126
116
|
|
|
127
117
|
### Example: Change Existing Item Quantity
|
|
128
118
|
|
|
129
|
-
```
|
|
119
|
+
```
|
|
130
120
|
add_filter('fluent_cart/cart/custom_item_quantity_changed', function ($variation, $item) {
|
|
131
121
|
|
|
132
|
-
// Skip non-custom items
|
|
133
122
|
if (empty($item['is_custom'])) {
|
|
134
123
|
return $variation;
|
|
135
124
|
}
|
|
136
125
|
|
|
137
|
-
// Ensure array
|
|
126
|
+
// Ensure array
|
|
138
127
|
$variation = (array) $variation;
|
|
139
128
|
|
|
140
129
|
$newQty = (int) ($item['new_quantity'] ?? 1);
|
|
@@ -148,7 +137,6 @@ add_filter('fluent_cart/cart/custom_item_quantity_changed', function ($variation
|
|
|
148
137
|
$newQty = $newQty == 0 ? 0 : ($oldQty+$newQty);
|
|
149
138
|
}
|
|
150
139
|
|
|
151
|
-
// Recalculate line total based on new quantity
|
|
152
140
|
$price = (float) ($variation['price'] ?? 0);
|
|
153
141
|
|
|
154
142
|
$variation['quantity'] = $newQty;
|
|
@@ -169,21 +157,19 @@ This hook runs before payment processing for both one-time and subscription item
|
|
|
169
157
|
|
|
170
158
|
**Parameters:**
|
|
171
159
|
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
| `$items` | `array` | Array containing product and variation objects |
|
|
175
|
-
| `$data` | `array` | Additional checkout data |
|
|
160
|
+
- `$items` (array): Array containing product and variation objects
|
|
161
|
+
- `$data` (array): Additional checkout data
|
|
176
162
|
|
|
177
163
|
**Returns:** Modified items array
|
|
178
164
|
|
|
179
165
|
### Example: Payment Validate Item
|
|
180
166
|
|
|
181
|
-
```
|
|
167
|
+
```
|
|
182
168
|
add_filter('fluent_cart/payment/validate_custom_item', function ($items, $data) {
|
|
183
169
|
|
|
184
170
|
[$product, $variation] = $items;
|
|
185
171
|
|
|
186
|
-
// Mark the item as custom visually
|
|
172
|
+
// Mark the item as custom visually
|
|
187
173
|
$variation->title .= ' (Custom Item)';
|
|
188
174
|
$product->post_title .= ' [Custom]';
|
|
189
175
|
|
|
@@ -204,16 +190,14 @@ Handle custom item updates from the WordPress admin panel after an order is plac
|
|
|
204
190
|
|
|
205
191
|
**Parameters:**
|
|
206
192
|
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
| `$oldItem` | `array` | The original item data |
|
|
210
|
-
| `$item` | `array` | The updated item data |
|
|
193
|
+
- `$oldItem` (array): The original item data
|
|
194
|
+
- `$item` (array): The updated item data
|
|
211
195
|
|
|
212
196
|
**Returns:** The item to be saved
|
|
213
197
|
|
|
214
|
-
|
|
198
|
+
#### Example: Order Item Changed
|
|
215
199
|
|
|
216
|
-
```
|
|
200
|
+
```
|
|
217
201
|
add_filter('fluent_cart/order/custom_item_changed', function ($oldItem, $item) {
|
|
218
202
|
|
|
219
203
|
$oldItem = (array) $oldItem;
|
|
@@ -251,17 +235,14 @@ add_filter('fluent_cart/order/custom_item_changed', function ($oldItem, $item) {
|
|
|
251
235
|
|
|
252
236
|
**Parameters:**
|
|
253
237
|
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
| `$customItems` | `array` | Array of custom items to be deleted |
|
|
257
|
-
| `$order` | `object` | The order object |
|
|
238
|
+
- `$customItems` (array): Array of custom items to be deleted
|
|
239
|
+
- `$order` (object): The order object
|
|
258
240
|
|
|
259
|
-
|
|
241
|
+
#### Example: Before Order Item Deleted
|
|
260
242
|
|
|
261
|
-
```
|
|
243
|
+
```
|
|
262
244
|
add_action('fluent_cart/order/before_custom_items_deleted', function ($customItems, $order) {
|
|
263
245
|
|
|
264
|
-
// Log each custom item before deletion
|
|
265
246
|
foreach ($customItems as $item) {
|
|
266
247
|
error_log(
|
|
267
248
|
sprintf(
|
|
@@ -284,17 +265,14 @@ add_action('fluent_cart/order/before_custom_items_deleted', function ($customIte
|
|
|
284
265
|
|
|
285
266
|
**Parameters:**
|
|
286
267
|
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
| `$customItems` | `array` | Array of deleted custom items |
|
|
290
|
-
| `$order` | `object` | The order object |
|
|
268
|
+
- `$customItems` (array): Array of deleted custom items
|
|
269
|
+
- `$order` (object): The order object
|
|
291
270
|
|
|
292
|
-
|
|
271
|
+
#### Example: After Order Item Deleted
|
|
293
272
|
|
|
294
|
-
```
|
|
273
|
+
```
|
|
295
274
|
add_action('fluent_cart/order/after_custom_items_deleted', function ($customItems, $order) {
|
|
296
275
|
|
|
297
|
-
// Log deletion and perform cleanup for each item
|
|
298
276
|
foreach ($customItems as $item) {
|
|
299
277
|
error_log(
|
|
300
278
|
sprintf(
|
|
@@ -307,7 +285,7 @@ add_action('fluent_cart/order/after_custom_items_deleted', function ($customItem
|
|
|
307
285
|
|
|
308
286
|
// Analytics or internal counters
|
|
309
287
|
// Notify admin
|
|
310
|
-
// wp_mail('
|
|
288
|
+
// wp_mail('[email protected]', 'Custom Item Deleted', 'Item ID ' . $item->id . ' was deleted');
|
|
311
289
|
}
|
|
312
290
|
|
|
313
291
|
}, 10, 2);
|
|
@@ -319,18 +297,18 @@ add_action('fluent_cart/order/after_custom_items_deleted', function ($customItem
|
|
|
319
297
|
|
|
320
298
|
### One-Time Item
|
|
321
299
|
|
|
322
|
-
```
|
|
300
|
+
```
|
|
323
301
|
$item = [
|
|
324
302
|
"item_id" => 1000,
|
|
325
|
-
"object_id"
|
|
303
|
+
"object_id" => 1000,
|
|
326
304
|
"post_id" => 10000,
|
|
327
|
-
"quantity"
|
|
328
|
-
"is_custom"
|
|
329
|
-
"post_title"
|
|
330
|
-
"title"
|
|
331
|
-
"price"
|
|
332
|
-
"unit_price"
|
|
333
|
-
"line_total"
|
|
305
|
+
"quantity" => 1,
|
|
306
|
+
"is_custom" => true,
|
|
307
|
+
"post_title" => "Air Max 1 running shoe",
|
|
308
|
+
"title" => "Version 1",
|
|
309
|
+
"price" => 2000,
|
|
310
|
+
"unit_price" => 2000,
|
|
311
|
+
"line_total" => 2000 * 1, // quantity is 1
|
|
334
312
|
"payment_type" => "onetime",
|
|
335
313
|
"fulfillment_type" => "digital",
|
|
336
314
|
"featured_media" => "http://wordpress.test/wp-content/uploads/2025/11/white-navy-athletic-shoe-4-1.jpeg",
|
|
@@ -338,23 +316,23 @@ $item = [
|
|
|
338
316
|
"other_info" => [
|
|
339
317
|
"payment_type" => "onetime"
|
|
340
318
|
],
|
|
341
|
-
"view_url" => "https://www.example.com/
|
|
319
|
+
"view_url" => "https://www.example.com/turkey-breast-joint-high-welfare-kellybronze?cid=9427"
|
|
342
320
|
];
|
|
343
321
|
```
|
|
344
322
|
|
|
345
323
|
### Subscription Item
|
|
346
324
|
|
|
347
|
-
```
|
|
325
|
+
```
|
|
348
326
|
$item = [
|
|
349
327
|
"item_id" => 2000,
|
|
350
|
-
"object_id"
|
|
328
|
+
"object_id" => 2000,
|
|
351
329
|
"post_id" => 20000,
|
|
352
|
-
"quantity"
|
|
353
|
-
"is_custom"
|
|
354
|
-
"post_title"
|
|
355
|
-
"title"
|
|
356
|
-
"price"
|
|
357
|
-
"unit_price"
|
|
330
|
+
"quantity" => 1, // always 1 for subscription
|
|
331
|
+
"is_custom" => true,
|
|
332
|
+
"post_title" => "Weekly Protein Pack",
|
|
333
|
+
"title" => "Subscription Version 1",
|
|
334
|
+
"price" => 2500,
|
|
335
|
+
"unit_price" => 2500,
|
|
358
336
|
"line_total" => 2500 * 1,
|
|
359
337
|
"payment_type" => "subscription",
|
|
360
338
|
"fulfillment_type" => "digital",
|
|
@@ -363,17 +341,17 @@ $item = [
|
|
|
363
341
|
"other_info" => [
|
|
364
342
|
"payment_type" => "subscription",
|
|
365
343
|
"repeat_interval" => "monthly",
|
|
366
|
-
"installment"
|
|
367
|
-
"manage_setup_fee"
|
|
368
|
-
|
|
344
|
+
"installment" => "no",
|
|
345
|
+
"manage_setup_fee" => "yes",
|
|
346
|
+
"signup_fee" => 500
|
|
369
347
|
],
|
|
370
|
-
"view_url" => "https://www.example.com/
|
|
348
|
+
"view_url" => "https://www.example.com/weekly-protein-pack?cid=9428"
|
|
371
349
|
];
|
|
372
350
|
```
|
|
373
351
|
|
|
374
352
|
### Payment Gateway Validation During Checkout
|
|
375
353
|
|
|
376
|
-
```
|
|
354
|
+
```
|
|
377
355
|
$variation = (object)[
|
|
378
356
|
"item_id" => 1000,
|
|
379
357
|
"object_id" => 1000,
|
|
@@ -409,7 +387,7 @@ $product = (object)[
|
|
|
409
387
|
### Item Object Properties
|
|
410
388
|
|
|
411
389
|
| Property | Type | Description | Example |
|
|
412
|
-
|
|
390
|
+
| --- | --- | --- | --- |
|
|
413
391
|
| `item_id` | integer | Unique identifier for the custom item | `1000` |
|
|
414
392
|
| `object_id` | integer | Reference ID for the item | `1000` |
|
|
415
393
|
| `post_id` | integer | WordPress post ID reference | `5000` |
|
|
@@ -426,10 +404,10 @@ $product = (object)[
|
|
|
426
404
|
| `sold_individually` | integer | `0` for no, `1` for yes | `0` |
|
|
427
405
|
| `other_info` | array | Additional information | See below |
|
|
428
406
|
|
|
429
|
-
###
|
|
407
|
+
### other_info Properties for Subscriptions
|
|
430
408
|
|
|
431
409
|
| Property | Type | Description | Example |
|
|
432
|
-
|
|
410
|
+
| --- | --- | --- | --- |
|
|
433
411
|
| `payment_type` | string | Type of payment | `"subscription"` |
|
|
434
412
|
| `repeat_interval` | string | Billing frequency | `"monthly"` |
|
|
435
413
|
| `installment` | string | Installment plan | `"no"` |
|
|
@@ -440,19 +418,23 @@ $product = (object)[
|
|
|
440
418
|
|
|
441
419
|
## Best Practices
|
|
442
420
|
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
421
|
+
1. **Always Validate Data**: Use the validation hook to ensure item data is correct before adding to cart
|
|
422
|
+
2. **Handle Quantity Changes**: Implement quantity change handlers for one-time items
|
|
423
|
+
3. **Mark Custom Items**: Use `is_custom` flag to distinguish custom items from regular products (required for all custom items)
|
|
424
|
+
4. **Set Correct Payment Type**: Ensure `payment_type` is set correctly (`onetime` or `subscription`)
|
|
425
|
+
5. **Calculate Totals**: Always calculate `line_total` as `price × quantity`
|
|
426
|
+
6. **Use Sanitization**: Apply `sanitize_text_field()` and `absint()` for security
|
|
427
|
+
7. **Handle Admin Actions**: Implement order update handlers if admins will modify orders
|
|
450
428
|
|
|
451
429
|
---
|
|
452
430
|
|
|
453
431
|
## Related Documentation
|
|
454
432
|
|
|
455
|
-
- [Developer Hooks](
|
|
456
|
-
- [Products API](
|
|
457
|
-
- [Orders API](
|
|
458
|
-
- [Database Models](database
|
|
433
|
+
- [Developer Hooks](/hooks/) - Complete hooks and filters reference
|
|
434
|
+
- [Products API](/api/products/) - Product management API
|
|
435
|
+
- [Orders API](/api/orders/) - Order management API
|
|
436
|
+
- [Database Models](/database/models/) - Data model documentation
|
|
437
|
+
|
|
438
|
+
---
|
|
439
|
+
|
|
440
|
+
**Next Steps:** Explore [Payment Methods Module](/modules/payment-methods.md) or return to [Modules Overview](/modules/)
|