fluentcart-developer 2.3.3 → 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
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: "fluentcart-developer"
|
|
3
|
-
description: "
|
|
4
|
-
summary: "
|
|
5
|
-
version: "
|
|
3
|
+
description: "Complete FluentCart developer documentation — every page of dev.fluentcart.com captured as local Markdown: 585 pages covering the 474 REST API operations, 49 database models, 22 hook files, 11 modules, payment-method integration, shipping carriers, and the licensing SDK, plus FastrSoft's own add-on and licensing notes."
|
|
4
|
+
summary: "The full FluentCart developer documentation as local Markdown — REST API, database models, action and filter hooks, modules, payment gateways, and shipping."
|
|
5
|
+
version: "3.0.0"
|
|
6
6
|
license: "MIT"
|
|
7
7
|
tags:
|
|
8
8
|
- wordpress
|
|
@@ -14,567 +14,95 @@ tags:
|
|
|
14
14
|
keywords:
|
|
15
15
|
- fluentcart
|
|
16
16
|
- wordpress e-commerce
|
|
17
|
+
- fluentcart rest api
|
|
18
|
+
- fluentcart hooks
|
|
19
|
+
- fluentcart database models
|
|
17
20
|
- software licensing sdk
|
|
18
21
|
- payment gateways
|
|
19
22
|
- custom shipping
|
|
20
|
-
- customer dashboard
|
|
21
|
-
- hook listener
|
|
22
23
|
use_cases:
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
24
|
+
- Finding the exact REST endpoint, method and payload for any FluentCart operation
|
|
25
|
+
- Looking up action and filter hook signatures by domain
|
|
26
|
+
- Reading the schema of any FluentCart Eloquent model or wp_fct_ table
|
|
27
|
+
- Building custom payment gateways, shipping carriers, and fee surcharges
|
|
28
|
+
- Monetizing and licensing WordPress plugins and themes via FluentCart Pro
|
|
28
29
|
---
|
|
29
30
|
|
|
30
31
|
# FluentCart Developer Skill
|
|
31
32
|
|
|
32
|
-
|
|
33
|
+
This skill is the **complete documentation of FluentCart**, captured from
|
|
34
|
+
<https://dev.fluentcart.com> and stored locally as Markdown. It is a mirror of
|
|
35
|
+
the vendor's own documentation — not a summary, not a paraphrase.
|
|
33
36
|
|
|
34
|
-
|
|
37
|
+
**588 pages** live under [`references/`](references/INDEX.md), laid out exactly as
|
|
38
|
+
the documentation site lays them out. If a page exists on the site, it exists
|
|
39
|
+
here under the same path.
|
|
35
40
|
|
|
36
|
-
|
|
41
|
+
---
|
|
37
42
|
|
|
38
|
-
|
|
43
|
+
## How to find anything
|
|
39
44
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
- **Order Lifecycle & Payments:** Creating orders, handling refunds, checkout hooks, payment gateway integration.
|
|
43
|
-
- **Subscriptions & Recurring Revenue:** Subscription status transitions, renewals, grace periods, billing cycles.
|
|
44
|
-
- **Software Licensing (Pro):** License key generation, site activations/deactivations, update API.
|
|
45
|
-
- **Cart & Checkout:** Cart items, validation, custom items, custom fee surcharges, checkout form schema.
|
|
46
|
-
- **Database & Architecture:** Querying FluentCart tables (`wp_fct_*`), Eloquent models, relationships.
|
|
47
|
-
- **REST API:** Administrative endpoints, customer portal endpoints, external API consumption.
|
|
45
|
+
Never guess a hook name, an endpoint, a column, or a parameter. The corpus is
|
|
46
|
+
complete, so the answer is almost always a file read away.
|
|
48
47
|
|
|
49
|
-
|
|
50
|
-
|
|
48
|
+
1. **Start at the index** — [`references/INDEX.md`](references/INDEX.md) lists
|
|
49
|
+
every page, grouped by section.
|
|
50
|
+
2. **Match the question to a section** using the map below.
|
|
51
|
+
3. **Open the page.** With the MCP server attached, call `fc_get_reference` with
|
|
52
|
+
the path; without it, read the file directly.
|
|
51
53
|
|
|
52
|
-
|
|
53
|
-
- [action-hooks-orders.md](references/action-hooks-orders.md) — Order creation, paid/completion events, refunds, status transitions, shipping fulfillment.
|
|
54
|
-
- [action-hooks-subscriptions.md](references/action-hooks-subscriptions.md) — Subscription lifecycle, status changes, renewal processing, reminder notifications.
|
|
55
|
-
- [action-hooks-licenses.md](references/action-hooks-licenses.md) — Software license updates, site activations/deactivations, license keys (Pro).
|
|
56
|
-
- [action-hooks-cart-checkout.md](references/action-hooks-cart-checkout.md) — Shopping flow from cart item additions to checkout page and thank-you receipt rendering.
|
|
57
|
-
- [action-hooks-customers-users.md](references/action-hooks-customers-users.md) — Customer lifecycle, user registration, customer portal tab/section rendering.
|
|
58
|
-
- [action-hooks-products-coupons.md](references/action-hooks-products-coupons.md) — Product creation, duplication, single product and archive page hooks, coupon creation.
|
|
59
|
-
- [action-hooks-payments-integrations.md](references/action-hooks-payments-integrations.md) — Payment gateway webhooks (Stripe, PayPal, Mollie, Paddle), integration feeds, dev logging.
|
|
60
|
-
- [action-hooks-admin-templates.md](references/action-hooks-admin-templates.md) — Application boot (`fluentcart_loaded`), admin UI menus, block/email editor, shortcode views, REST policy checks.
|
|
54
|
+
### Section map
|
|
61
55
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
56
|
+
| Section | Path prefix | Pages | What it answers |
|
|
57
|
+
| --- | --- | --- | --- |
|
|
58
|
+
| REST API operations | `references/restapi/operations/` | 449 | One page per endpoint: method, route, parameters, payload, response |
|
|
59
|
+
| REST API modules | `references/restapi/` | 25 | Per-domain API overviews (orders, products, tax, shipping, licensing…) |
|
|
60
|
+
| Database | `references/database/` | 49 | Every `wp_fct_*` model, its columns, relationships, and the query builder |
|
|
61
|
+
| Hooks | `references/hooks/` | 22 | Action and filter hooks, split by domain, plus the deprecated list |
|
|
62
|
+
| API overview | `references/api/` | 11 | Authentication and the older API surface |
|
|
63
|
+
| Modules | `references/modules/` | 11 | Fee system, order bumps, licensing, refunds, shipping, storage, subscriptions |
|
|
64
|
+
| Guides | `references/guides/` | 9 | Frontend, integrations, subscriptions, and the shipping-carrier tutorial |
|
|
65
|
+
| Payment methods | `references/payment-methods-integration/` | 4 | Building a gateway, field settings, and the Paddle worked example |
|
|
66
|
+
| Engineering | `references/engineering/` | 3 | Authoring notes and adding custom pages to the customer dashboard |
|
|
67
|
+
| Basics | `references/index.md`, `references/getting-started.md` | 2 | Orientation and the core concepts |
|
|
69
68
|
|
|
70
|
-
|
|
71
|
-
- [hooks-complete-index.md](references/hooks-complete-index.md) — Every hook the docs publish (680): name, purpose and source file, including the Module and Pro-Module hooks that have no per-topic file, plus the deprecated names that still fire. Check here first when a hook is not in the 14 topic files above.
|
|
69
|
+
### FastrSoft originals
|
|
72
70
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
- [database-models-reference.md](references/database-models-reference.md) — FluentCart Eloquent Models, relationships, and scopes across Core and Pro modules.
|
|
77
|
-
- [models-complete-index.md](references/models-complete-index.md) — Every model the docs publish (41), with DB table, class, source file, traits, attributes and relationships. Use when the model is not in `database-models-reference.md`.
|
|
78
|
-
- [database-models-query-builder.md](references/database-models-query-builder.md) — FluentCart ORM Query Builder usage, aggregates, CRUD operations, and comprehensive model map.
|
|
79
|
-
- [rest-api-reference.md](references/rest-api-reference.md) — Full REST API endpoints index, authentication, request/response formats.
|
|
80
|
-
- [rest-api-overview.md](references/rest-api-overview.md) — REST API getting started, authentication standards, module catalog, permission system (32 permissions across 4 roles), and error handling.
|
|
81
|
-
- [rest-api-orders.md](references/rest-api-orders.md) — Orders REST API (26 endpoints): CRUD, calculate shipping/tax, price preview, order currencies, bulk actions, refunds, customer reassignment, dispute handling, transactions.
|
|
82
|
-
- [rest-api-products.md](references/rest-api-products.md) — Products REST API (62 endpoints): CRUD, pricing, search/lookup, bulk operations (incl. variant bulk update), duplicate, bundle info, upgrade paths, inventory, downloadables, variations, tax exemption, integrations.
|
|
83
|
-
- [rest-api-customers.md](references/rest-api-customers.md) — Customers REST API (18 endpoints): CRUD, additional info (labels), bulk actions, order history, LTV recalculation, address management, WP user association.
|
|
84
|
-
- [rest-api-coupons.md](references/rest-api-coupons.md) — Coupons REST API (12 endpoints): CRUD, paginated listing, apply/cancel/reapply, product eligibility, checkout settings, Coupon model & DB table reference.
|
|
85
|
-
- [rest-api-subscriptions.md](references/rest-api-subscriptions.md) — Subscriptions REST API (27 endpoints): Admin lifecycle (cancel, charge-now, create-renewal, skip-renewal, update, vendor-id repair), renewal invoices (list, show, resend, void), Customer Portal self-service (payment updates, gateway switching, auto-renew cancellation), status constants, and hooks.
|
|
86
|
-
- [rest-api-tax.md](references/rest-api-tax.md) — Tax REST API (26 endpoints): Tax filing, tax classes, country rates, shipping/product category overrides, global tax settings, and EU VAT / OSS cross-border compliance.
|
|
87
|
-
- [rest-api-shipping.md](references/rest-api-shipping.md) — Shipping REST API (15 endpoints, `store/sensitive` permission): Shipping zones (region reset side effects, reordering), shipping methods (`flat_rate`, `free_shipping`, `local_pickup`, state scoping), shipping classes (`fixed` & `percentage` costs, `per_item` flags), and data models.
|
|
88
|
-
- [rest-api-settings.md](references/rest-api-settings.md) — Settings REST API (30 endpoints, `StoreSettingsPolicy` & `is_super_admin`): Gateway setup (Stripe, PayPal connect, reordering, designs, addons), PayPal OAuth & webhooks, store configuration (`FluentMetaRequest`), module toggles, permissions, confirmation shortcodes, storage drivers (S3, Bunny, Local), and checkout fields.
|
|
89
|
-
- [rest-api-email-notifications.md](references/rest-api-email-notifications.md) — Email Notifications REST API (11 endpoints, `store/sensitive` permission): Email templates catalog (order, subscription, scheduler), single template editor shortcodes, template HTML previews (custom & default PHP), global email sender configuration, and automated scheduling reminders.
|
|
90
|
-
- [rest-api-reports.md](references/rest-api-reports.md) — Reports API (45 endpoints, `ReportPolicy` & `reports/view` permission): Standard report parameters, YoY revenue overview, sales growth, quick stats, revenue/orders by grouping dimensions, day/hour heatmap, top products/variants, refund analytics, software license metrics, subscription MRR & cohort retention matrices, Action Scheduler snapshot generation, and UTM source attribution.
|
|
91
|
-
- [rest-api-integrations.md](references/rest-api-integrations.md) — Integrations API (17 endpoints, `IntegrationPolicy` & `ProductPolicy`): Addon listings & WP.org auto-installer, global provider credentials, global integration feeds, list merge field mapping, dynamic options & chained inputs, product-level integration feeds (`conditional_variation_ids`), and status toggles.
|
|
92
|
-
- [rest-api-files.md](references/rest-api-files.md) — Files API (5 endpoints, `StoreSensitivePolicy` & `AdminPolicy`): Downloadable file CRUD across storage drivers (Local, S3, Bunny, R2), timestamp collision prevention (`name__fluent-cart__.timestamp.ext`), blocked extension filters (`fluent_cart/local_file_blocked_extensions`), storage bucket lists, and WP Media Library editor image uploads (`media_handle_upload`).
|
|
93
|
-
- [rest-api-labels-attributes.md](references/rest-api-labels-attributes.md) — Labels & Attributes API (13 endpoints, `LabelPolicy` & `ProductPolicy`): Polymorphic order/customer labels (`LabelRequest`, `update-label-selections`), variation attribute groups (`AttrGroupRequest`, deletion guards), and attribute terms (`AttrTermRequest`, serial ordering).
|
|
94
|
-
- [rest-api-dashboard-utilities.md](references/rest-api-dashboard-utilities.md) — Dashboard & Utilities API (20 endpoints): Onboarding checklist wizard, 30-day dashboard stats widgets, page generator (`CreatePageRequest`), admin SPA init (`/app/init`), activity log (`/activity`), order notes, print HTML templates (invoices & slips), dynamic widgets, country address locales, and advanced filter options.
|
|
95
|
-
- [rest-api-public-shop.md](references/rest-api-public-shop.md) — Public Shop API (3 endpoints, `PublicPolicy` unauthenticated): Public catalog product browsing with taxonomy/price filters (cents pricing in `detail`), server-rendered HTML grid views for Gutenberg blocks & shortcodes (`ProductListRenderer`, transient block caching), and live search autocomplete (`SearchBarRenderer`).
|
|
96
|
-
- [rest-api-checkout.md](references/rest-api-checkout.md) — Checkout API (7 endpoints, `PublicPolicy`): Order placement (`place-order`, rate limit 5 req/60s), gateway UI configuration (`get-order-info`), cart summary calculation with shipping (`get-checkout-summary-view`), shipping availability (`get-available-shipping-methods` & list view), country locale rules (`get-country-info`), and customer login (`/user/login` with `X-WP-Nonce`).
|
|
97
|
-
- [rest-api-customer-profile.md](references/rest-api-customer-profile.md) — Customer Profile API (18 endpoints, `CustomerFrontendPolicy` authenticated): Portal dashboard overview, profile details & password updates, checkout address selector (`fct_cart_hash`), portal address management (guards against deleting primary/last address), order history & UUID details, plan upgrade paths & prorations, transaction invoice billing address editing (`vat_tax_id`), and signed digital file downloads.
|
|
98
|
-
- [rest-api-licensing.md](references/rest-api-licensing.md) — Licensing API (22 endpoints, `LicensePolicy` & Pro required): Admin software license CRUD, key regeneration, validity extensions (`lifetime` or `YYYY-MM-DD`), per-product variation validity rules (disabled for bundles), customer portal self-service activations, site Pro plugin licensing, and non-REST public software update API (`/?fluent-cart={action}`) with 48-hour signed package download tokens & staging auto-detection.
|
|
99
|
-
- [rest-api-roles-permissions.md](references/rest-api-roles-permissions.md) — Roles & Permissions API (7 endpoints, `AdminPolicy` & Pro required): List managers, user search (excluding WP admins), role definitions (`super_admin`, `manager`, `worker`, `accountant`), role assignment sync (`fluent_cart_admin`), role deletion, and capability matrix filters (`fluent_cart/permission/all_roles`).
|
|
100
|
-
- [rest-api-order-bumps.md](references/rest-api-order-bumps.md) — Order Bumps API (5 endpoints, `OrderBumpPolicy` & `store/sensitive` & Pro required): Checkout order bump promotion CRUD (`fct_order_promotions` table), `product_variant` eager loading, discount configuration (`percentage` vs `fixed` in cents), priority ordering, and cart condition rules.
|
|
101
|
-
- [modules-and-extensions-reference.md](references/modules-and-extensions-reference.md) — Building payment gateways, shipping carriers, fee surcharges, ghost products.
|
|
102
|
-
- [engineering-notes.md](references/engineering-notes.md) — Architecture decisions, performance work, and production lessons from FluentCart's core engineering team.
|
|
71
|
+
Five files at the root of `references/` are **not** from the vendor site. They
|
|
72
|
+
document FastrSoft's own FluentCart work and must not be treated as vendor
|
|
73
|
+
specification:
|
|
103
74
|
|
|
104
|
-
|
|
105
|
-
- [
|
|
106
|
-
- [
|
|
107
|
-
- [
|
|
108
|
-
- [
|
|
109
|
-
- [software-licensing-sdk.md](references/software-licensing-sdk.md) — Official FluentCart Software Licensing SDK (`fluent-cart/software-licensing-sdk`): client-side plugin updates, `FluentLicensing`, `LicenseSettings`, `PluginUpdater`, remote endpoints (`?fluent-cart=activate_license`), and filter hooks.
|
|
110
|
-
- [customer-dashboard-endpoints.md](references/customer-dashboard-endpoints.md) — Adding custom pages/tabs to the Vue 3 customer dashboard via `fluent_cart_api()->addCustomerDashboardEndpoint()`, hybrid routing tricks, reserved slugs, and customer session resolution.
|
|
111
|
-
- [storage-drivers-module.md](references/storage-drivers-module.md) — Storage drivers architecture (`BaseStorageDriver`, `BaseStorageInterface`, `FileManager`), creating custom cloud drivers (S3, Wasabi, R2), and signed download URLs.
|
|
112
|
-
- [shipping-module-guide.md](references/shipping-module-guide.md) — Shipping module architecture, shipping zones, dynamic carrier rate calculation (`fluent_cart/shipping/methods`), and shipping classes.
|
|
113
|
-
- [order-bump-module.md](references/order-bump-module.md) — Order Bump module (Pro): `OrderPromotion` model, condition engine, display positions, cart application filter (`fluent_cart/apply_order_bump`), and impression analytics.
|
|
114
|
-
- [device-licensing-and-hardware-tracking.md](references/device-licensing-and-hardware-tracking.md) — Universal licensing for non-WordPress software: `device://<uuid>` identifiers in `fct_license_sites`, activation payloads, `server_time_unix` clock-tamper defence, pre-computed `expires_in_days`, Fastr Devices admin display, and self-service deactivation.
|
|
115
|
-
- [trial-abuse-prevention.md](references/trial-abuse-prevention.md) — One trial per machine: the `wp_fastr_trial_registry` table, the activation / heartbeat / pre-checkout gates, fingerprint tiers per platform, `trial_already_used` and `trial_device_mismatch` contracts, single-use eligibility tokens, risk scoring, WP-CLI operations, and the 12-case test checklist.
|
|
116
|
-
- [client-integration-contract.md](references/client-integration-contract.md) — Language-agnostic integration contract: discovery via `fastr_capabilities`, the five client flows, exact request and response shapes, the rule that a licence is valid only when `status == "valid"` (FluentCart returns `key_mismatch` and `invalid_activation` as HTTP 200 with `success: true`), RS256 token verification, entitlements, and a minimum-viable-client checklist.
|
|
117
|
-
#### Runnable Code Examples & Project Boilerplates (`examples/`)
|
|
118
|
-
- [examples/README.md](examples/README.md) — Inventory and developer guide for ready-to-use sample plugins and templates.
|
|
119
|
-
- [sample-custom-addon/fluentcart-custom-addon.php](examples/sample-custom-addon/fluentcart-custom-addon.php) — Complete starter plugin with hook handlers, custom order meta, system logging, fee filters, and custom REST API endpoint.
|
|
120
|
-
- [sample-fee-surcharge-plugin/fluentcart-fee-surcharge.php](examples/sample-fee-surcharge-plugin/fluentcart-fee-surcharge.php) — Dynamic conditional fee surcharges (cents calculations, percentage payment surcharges).
|
|
121
|
-
- [sample-custom-payment-gateway/fluentcart-custom-gateway-example.php](examples/sample-custom-payment-gateway/fluentcart-custom-gateway-example.php) — Complete custom payment gateway implementation extending `AbstractPaymentGateway` and `BaseGatewaySettings`.
|
|
122
|
-
- [sample-shipping-carrier/fluentcart-custom-shipping-carrier.php](examples/sample-shipping-carrier/fluentcart-custom-shipping-carrier.php) — Dynamic shipping carrier calculation filter callback example.
|
|
123
|
-
- [fluentcart-starter-child-theme/](examples/fluentcart-starter-child-theme/) — Starter child theme with `add_theme_support('fluent_cart')` and template override structure.
|
|
124
|
-
- [sample-plugin-with-licensing-sdk/](examples/sample-plugin-with-licensing-sdk/) — Premium WordPress plugin with official FluentCart Software Licensing SDK integration, remote activation, and native one-click updates.
|
|
75
|
+
- [`references/fastr-addon-hooks.md`](references/fastr-addon-hooks.md)
|
|
76
|
+
- [`references/fastr-addon-schema.md`](references/fastr-addon-schema.md)
|
|
77
|
+
- [`references/client-integration-contract.md`](references/client-integration-contract.md)
|
|
78
|
+
- [`references/trial-abuse-prevention.md`](references/trial-abuse-prevention.md)
|
|
79
|
+
- [`references/device-licensing-and-hardware-tracking.md`](references/device-licensing-and-hardware-tracking.md)
|
|
125
80
|
|
|
126
81
|
---
|
|
127
82
|
|
|
128
|
-
##
|
|
129
|
-
|
|
130
|
-
### 1. Monetary Values & Currency Storage
|
|
131
|
-
- **ALWAYS store and calculate monetary values as integers in CENTS** (e.g. `$10.00` = `1000`, `$19.99` = `1999`).
|
|
132
|
-
- Convert decimal inputs to cents before saving: `\FluentCart\App\Helpers\Helper::toCent($decimalAmount)`.
|
|
133
|
-
- Format cents into decimal string for display: `\FluentCart\App\Helpers\Helper::toDecimal($amountInCents)`.
|
|
134
|
-
|
|
135
|
-
### 2. Code Commenting Standards
|
|
136
|
-
- **ALWAYS add meaningful single-line explanatory comments to PHP code snippets** (above/inside hook callbacks and helper calls) so developers can easily understand the logic.
|
|
137
|
-
|
|
138
|
-
### 3. Asynchronous Post-Payment Tasks
|
|
139
|
-
- **NEVER** perform blocking API calls (CRMs, webhooks, external emails) synchronously inside payment execution loops.
|
|
140
|
-
- Use `fluent_cart/order_paid_done` or Action Scheduler for asynchronous background processing.
|
|
141
|
-
|
|
142
|
-
### 4. Database Access
|
|
143
|
-
- Use FluentCart Eloquent Models (`\FluentCart\App\Models\*`) rather than raw `$wpdb` queries whenever possible.
|
|
83
|
+
## Working rules
|
|
144
84
|
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
-
|
|
149
|
-
|
|
85
|
+
- **Quote what the docs say, not what FluentCart "probably" does.** These files
|
|
86
|
+
are the vendor's own words. If the corpus does not cover something, say so
|
|
87
|
+
rather than inferring from a neighbouring page.
|
|
88
|
+
- **Cite the page.** When you give a hook signature or an endpoint, name the
|
|
89
|
+
file it came from so the developer can check it.
|
|
90
|
+
- **Prefer the specific page.** `restapi/operations/orders/list-orders.md` beats
|
|
91
|
+
`restapi/orders.md` whenever the question is about one endpoint.
|
|
92
|
+
- **The corpus is offline.** Internal links were rewritten from `.html` to
|
|
93
|
+
`.md`, so they resolve inside this folder.
|
|
150
94
|
|
|
151
95
|
---
|
|
152
96
|
|
|
153
|
-
##
|
|
154
|
-
|
|
155
|
-
### 1. Extension Plugin Boilerplate
|
|
156
|
-
```php
|
|
157
|
-
<?php
|
|
158
|
-
/**
|
|
159
|
-
* Plugin Name: Custom FluentCart Addon
|
|
160
|
-
* Description: Custom extension for FluentCart.
|
|
161
|
-
* Version: 1.0.0
|
|
162
|
-
* Author: Developer
|
|
163
|
-
*/
|
|
164
|
-
|
|
165
|
-
if (!defined('ABSPATH')) {
|
|
166
|
-
exit;
|
|
167
|
-
}
|
|
168
|
-
|
|
169
|
-
// Guard execution until WordPress plugins are loaded and FluentCart is active
|
|
170
|
-
add_action('plugins_loaded', function () {
|
|
171
|
-
if (!defined('FLUENT_CART')) {
|
|
172
|
-
return; // FluentCart is not active
|
|
173
|
-
}
|
|
174
|
-
|
|
175
|
-
// Initialize custom hook listeners and extension logic
|
|
176
|
-
});
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
### 2. Surcharge / Extra Fee Filter Pattern
|
|
180
|
-
```php
|
|
181
|
-
// Add custom handling fee to cart estimated total
|
|
182
|
-
add_filter('fluent_cart/fee_items', function ($fees, $cart) {
|
|
183
|
-
// Append $5.00 handling fee (500 cents)
|
|
184
|
-
$fees[] = [
|
|
185
|
-
'id' => 'handling_fee',
|
|
186
|
-
'title' => __('Special Handling Fee', 'my-extension'),
|
|
187
|
-
'amount' => 500, // Amount in cents
|
|
188
|
-
'taxable' => false,
|
|
189
|
-
];
|
|
190
|
-
return $fees;
|
|
191
|
-
}, 10, 2);
|
|
192
|
-
```
|
|
193
|
-
|
|
194
|
-
### 3. Order Paid Event Listener Pattern
|
|
195
|
-
```php
|
|
196
|
-
// Listen for completed order payments to trigger post-payment processing
|
|
197
|
-
add_action('fluent_cart/order_paid_done', function ($data) {
|
|
198
|
-
// Extract order model and customer model instances from payload
|
|
199
|
-
$order = $data['order'];
|
|
200
|
-
$customer = $data['customer'];
|
|
201
|
-
|
|
202
|
-
// Log order completion event to FluentCart logs
|
|
203
|
-
fluent_cart_add_log(
|
|
204
|
-
'Order Completed',
|
|
205
|
-
'Processed order #' . $order->id . ' for customer ' . $customer->email,
|
|
206
|
-
'info'
|
|
207
|
-
);
|
|
208
|
-
}, 10, 1);
|
|
209
|
-
```
|
|
210
|
-
|
|
211
|
-
### 4. Custom Payment Gateway Boilerplate
|
|
212
|
-
```php
|
|
213
|
-
<?php
|
|
214
|
-
defined('ABSPATH') || exit;
|
|
215
|
-
|
|
216
|
-
use FluentCart\App\Services\Gateways\AbstractPaymentGateway;
|
|
217
|
-
use FluentCart\App\Services\Gateways\BaseGatewaySettings;
|
|
218
|
-
|
|
219
|
-
class CustomPayGateway extends AbstractPaymentGateway
|
|
220
|
-
{
|
|
221
|
-
protected string $gateway = 'custom_pay';
|
|
222
|
-
protected string $title = 'CustomPay';
|
|
223
|
-
|
|
224
|
-
public function init(): void
|
|
225
|
-
{
|
|
226
|
-
// Declare feature capabilities (products, refunds, subscriptions)
|
|
227
|
-
$this->supports = ['products', 'refunds', 'subscriptions'];
|
|
228
|
-
}
|
|
229
|
-
|
|
230
|
-
public function handlePayment(array $orderData): array
|
|
231
|
-
{
|
|
232
|
-
$orderId = $orderData['id'];
|
|
233
|
-
$amountCents = $orderData['total']; // Amount in cents
|
|
234
|
-
|
|
235
|
-
// Call external processor API to create checkout session
|
|
236
|
-
$redirectUrl = 'https://checkout.example.com/pay/' . $orderId;
|
|
237
|
-
|
|
238
|
-
return [
|
|
239
|
-
'status' => 'pending',
|
|
240
|
-
'redirect_url' => $redirectUrl,
|
|
241
|
-
'message' => __('Redirecting to payment provider...', 'my-gateway')
|
|
242
|
-
];
|
|
243
|
-
}
|
|
244
|
-
|
|
245
|
-
public function handleWebhook(): void
|
|
246
|
-
{
|
|
247
|
-
$payload = file_get_contents('php://input');
|
|
248
|
-
// Validate webhook signature and update order status via:
|
|
249
|
-
// do_action('fluent_cart/order_status_updated', $orderId, 'paid');
|
|
250
|
-
}
|
|
251
|
-
}
|
|
97
|
+
## Refreshing the corpus
|
|
252
98
|
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
add_filter('fluent_cart/payment_methods', function (array $gateways): array {
|
|
256
|
-
$gateways['custom_pay'] = new CustomPayGateway();
|
|
257
|
-
return $gateways;
|
|
258
|
-
});
|
|
259
|
-
});
|
|
260
|
-
```
|
|
261
|
-
|
|
262
|
-
### 5. Monetizing Software: Licensing SDK & Automatic Updates
|
|
263
|
-
Integrate the official FluentCart Software Licensing SDK (`fluent-cart/software-licensing-sdk`) into commercial WordPress plugins or themes for remote license key activation and one-click updates directly in `wp-admin/plugins.php`:
|
|
264
|
-
|
|
265
|
-
```php
|
|
266
|
-
<?php
|
|
267
|
-
defined('ABSPATH') || exit;
|
|
268
|
-
|
|
269
|
-
add_action('plugins_loaded', function () {
|
|
270
|
-
if (!class_exists('\MyPlugin\FluentLicensing')) {
|
|
271
|
-
require_once plugin_dir_path(__FILE__) . 'updater/FluentLicensing.php';
|
|
272
|
-
}
|
|
273
|
-
|
|
274
|
-
$licenseManager = new \MyPlugin\FluentLicensing();
|
|
275
|
-
|
|
276
|
-
// 1. Register with your FluentCart store
|
|
277
|
-
$licenseManager->register([
|
|
278
|
-
'version' => '1.0.0', // Current plugin version
|
|
279
|
-
'item_id' => 42, // FluentCart Pro Product/Item ID
|
|
280
|
-
'basename' => plugin_basename(__FILE__), // Plugin basename
|
|
281
|
-
'api_url' => 'https://mystore.example.com/', // FluentCart store URL
|
|
282
|
-
'plugin_title' => 'My Commercial Plugin Pro', // Plugin title
|
|
283
|
-
'purchase_url' => 'https://mystore.example.com/checkout/?item_id=42',
|
|
284
|
-
'activate_url' => admin_url('tools.php?page=my-plugin-license'),
|
|
285
|
-
'show_check_update' => true,
|
|
286
|
-
'settings_key' => '__my_plugin_license_config'
|
|
287
|
-
]);
|
|
288
|
-
|
|
289
|
-
// 2. Attach Turnkey Admin Settings UI
|
|
290
|
-
if (is_admin() && class_exists('\MyPlugin\LicenseSettings')) {
|
|
291
|
-
$settings = new \MyPlugin\LicenseSettings();
|
|
292
|
-
$settings->register($licenseManager);
|
|
293
|
-
|
|
294
|
-
$settings->setConfig([
|
|
295
|
-
'title' => __('My Plugin License', 'my-plugin'),
|
|
296
|
-
'heading' => __('Activate License Key', 'my-plugin'),
|
|
297
|
-
'description' => __('Enter your FluentCart license key to receive one-click automatic updates.', 'my-plugin')
|
|
298
|
-
]);
|
|
299
|
-
|
|
300
|
-
$settings->addPage([
|
|
301
|
-
'type' => 'submenu',
|
|
302
|
-
'parent_slug' => 'tools.php',
|
|
303
|
-
'page_title' => __('License Settings', 'my-plugin'),
|
|
304
|
-
'menu_title' => __('Plugin License', 'my-plugin'),
|
|
305
|
-
'capability' => 'manage_options',
|
|
306
|
-
'menu_slug' => 'my-plugin-license'
|
|
307
|
-
]);
|
|
308
|
-
}
|
|
309
|
-
});
|
|
310
|
-
|
|
311
|
-
// 3. Conditional Feature Gating Helper
|
|
312
|
-
function my_plugin_is_licensed(): bool
|
|
313
|
-
{
|
|
314
|
-
if (!class_exists('\MyPlugin\FluentLicensing')) {
|
|
315
|
-
return false;
|
|
316
|
-
}
|
|
317
|
-
$manager = \MyPlugin\FluentLicensing::getInstance();
|
|
318
|
-
$status = $manager ? $manager->getStatus() : null;
|
|
319
|
-
return !is_wp_error($status) && isset($status['status']) && $status['status'] === 'valid';
|
|
320
|
-
}
|
|
321
|
-
```
|
|
322
|
-
|
|
323
|
-
### 6. Theme & Child Theme Development
|
|
324
|
-
Enable FluentCart theme compatibility and override default templates cleanly:
|
|
99
|
+
The pages are generated, never hand-edited — a hand edit is lost on the next
|
|
100
|
+
sync:
|
|
325
101
|
|
|
326
|
-
```
|
|
327
|
-
|
|
328
|
-
add_action('after_setup_theme', function () {
|
|
329
|
-
// Declare explicit FluentCart theme support
|
|
330
|
-
add_theme_support('fluent_cart');
|
|
331
|
-
});
|
|
102
|
+
```bash
|
|
103
|
+
npm run sync:docs # re-capture every page from dev.fluentcart.com
|
|
332
104
|
```
|
|
333
105
|
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
2. Copy the template from FluentCart core (`app/Views/`):
|
|
338
|
-
- `your-theme/fluent-cart/checkout.php` — Custom checkout container.
|
|
339
|
-
- `your-theme/fluent-cart/receipt.php` — Custom thank-you / receipt layout.
|
|
340
|
-
- `your-theme/fluent-cart/shop.php` — Product catalog grid wrapper.
|
|
341
|
-
|
|
342
|
-
### 7. Customer Dashboard Extensibility (`addCustomerDashboardEndpoint`)
|
|
343
|
-
Add custom server-rendered pages and navigation tabs to the Vue 3 customer dashboard without compiling Vue or flushing permalinks:
|
|
344
|
-
|
|
345
|
-
```php
|
|
346
|
-
<?php
|
|
347
|
-
defined('ABSPATH') || exit;
|
|
348
|
-
|
|
349
|
-
use FluentCart\Api\Resource\CustomerResource;
|
|
350
|
-
|
|
351
|
-
add_action('fluent_cart/init', function () {
|
|
352
|
-
if (!function_exists('fluent_cart_api')) {
|
|
353
|
-
return;
|
|
354
|
-
}
|
|
355
|
-
|
|
356
|
-
fluent_cart_api()->addCustomerDashboardEndpoint('my-custom-portal', [
|
|
357
|
-
'title' => __('VIP Portal', 'my-addon'),
|
|
358
|
-
'icon_svg' => '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none"><path d="M3 4a1 1 0 011-1h12a1 1 0 011 1v2a1 1 0 01-1 1H4a1 1 0 01-1-1V4zM3 10a1 1 0 011-1h12a1 1 0 011 1v6a1 1 0 01-1 1H4a1 1 0 01-1-1v-6z" fill="currentColor"/></svg>',
|
|
359
|
-
'render_callback' => function () {
|
|
360
|
-
// 1. Resolve logged-in customer (memoized, free)
|
|
361
|
-
$customer = CustomerResource::getCurrentCustomer();
|
|
362
|
-
if (!$customer) {
|
|
363
|
-
echo '<p>' . esc_html__('Please log in.', 'my-addon') . '</p>';
|
|
364
|
-
return;
|
|
365
|
-
}
|
|
366
|
-
|
|
367
|
-
// 2. Render HTML matching portal design system
|
|
368
|
-
echo '<div class="fct-custom-tab-box" style="padding: 24px; background: #fff; border: 1px solid var(--fct-customer-dashboard-border-color, #e5e7eb); border-radius: 8px;">';
|
|
369
|
-
echo '<h2>' . esc_html(sprintf(__('Hello, %s!', 'my-addon'), $customer->full_name)) . '</h2>';
|
|
370
|
-
echo '<p>' . esc_html__('Welcome to your custom account portal.', 'my-addon') . '</p>';
|
|
371
|
-
echo '</div>';
|
|
372
|
-
}
|
|
373
|
-
]);
|
|
374
|
-
});
|
|
375
|
-
```
|
|
376
|
-
|
|
377
|
-
### 8. Dynamic Shipping Carrier Rate Filter
|
|
378
|
-
Inject real-time shipping options or carrier calculations into checkout:
|
|
379
|
-
|
|
380
|
-
```php
|
|
381
|
-
add_filter('fluent_cart/shipping/methods', function (array $methods, $cart, array $address): array {
|
|
382
|
-
if (!$cart->needsShipping()) {
|
|
383
|
-
return $methods;
|
|
384
|
-
}
|
|
385
|
-
|
|
386
|
-
$methods[] = [
|
|
387
|
-
'id' => 'custom_express_air',
|
|
388
|
-
'title' => __('Express Air Delivery', 'my-addon'),
|
|
389
|
-
'cost' => 1800, // $18.00 in cents
|
|
390
|
-
'description' => __('Arrives in 1-2 business days', 'my-addon'),
|
|
391
|
-
'meta' => ['carrier' => 'SkyPost', 'days' => 2]
|
|
392
|
-
];
|
|
393
|
-
|
|
394
|
-
return $methods;
|
|
395
|
-
}, 10, 3);
|
|
396
|
-
```
|
|
397
|
-
|
|
398
|
-
### 9. Ghost Products / Dynamic Line Items
|
|
399
|
-
Sell arbitrary services, custom quotes, or event tickets dynamically without creating permanent database products:
|
|
400
|
-
|
|
401
|
-
```php
|
|
402
|
-
// Inject custom dynamic cart line item
|
|
403
|
-
add_filter('fluent_cart/cart_items', function (array $items, $cart) {
|
|
404
|
-
if (isset($_GET['custom_donation'])) {
|
|
405
|
-
$amountCents = absint($_GET['custom_donation']) * 100;
|
|
406
|
-
$items[] = [
|
|
407
|
-
'id' => 'ghost_donation_' . $amountCents,
|
|
408
|
-
'title' => __('Community Donation', 'my-addon'),
|
|
409
|
-
'unit_price' => $amountCents,
|
|
410
|
-
'quantity' => 1,
|
|
411
|
-
'taxable' => false,
|
|
412
|
-
'is_virtual' => true,
|
|
413
|
-
'line_total' => $amountCents
|
|
414
|
-
];
|
|
415
|
-
}
|
|
416
|
-
return $items;
|
|
417
|
-
}, 10, 2);
|
|
418
|
-
```
|
|
419
|
-
|
|
420
|
-
### 10. Non-WordPress Software Licensing (`device://`)
|
|
421
|
-
|
|
422
|
-
FluentCart licenses **desktop apps, browser extensions, audio plugins, and CLI tools** through the same endpoints a WordPress plugin uses. The trick: send a stable device identifier in the `site_url` field.
|
|
423
|
-
|
|
424
|
-
```text
|
|
425
|
-
site_url = device://550e8400-e29b-41d4-a716-446655440000
|
|
426
|
-
```
|
|
427
|
-
|
|
428
|
-
Generate the UUID **once per install**, persist it in the OS credential store, and never derive it from hardware serials or rotate it on update — rotation burns a customer's seat.
|
|
429
|
-
|
|
430
|
-
Full contract, storage tables and test checklist: [device-licensing-and-hardware-tracking.md](references/device-licensing-and-hardware-tracking.md).
|
|
431
|
-
|
|
432
|
-
#### 10.1 Tauri (Rust) — activation with clock guard
|
|
433
|
-
|
|
434
|
-
```rust
|
|
435
|
-
// Cargo: reqwest(blocking,json) serde serde_json keyring uuid
|
|
436
|
-
fn activate(license_key: &str) -> Result<LicenseState, String> {
|
|
437
|
-
let device = format!("device://{}", uuid::Uuid::new_v4()); // persist this!
|
|
438
|
-
let raw: RawResponse = reqwest::blocking::Client::new()
|
|
439
|
-
.post(format!("{}?fluent-cart=activate_license", STORE_URL))
|
|
440
|
-
.form(&[("license_key", license_key.trim()), ("item_id", "42"), ("site_url", &device)])
|
|
441
|
-
.send().map_err(|e| e.to_string())?
|
|
442
|
-
.json().map_err(|e| e.to_string())?;
|
|
443
|
-
|
|
444
|
-
// The server's clock is the only one that counts.
|
|
445
|
-
Ok(LicenseState {
|
|
446
|
-
status: raw.status.unwrap_or_default(),
|
|
447
|
-
server_time_unix: raw.server_time_unix.unwrap_or(0),
|
|
448
|
-
checked_at_local: now_unix(),
|
|
449
|
-
expires_in_days: raw.expires_in_days, // pre-computed, never date math
|
|
450
|
-
device_id: device,
|
|
451
|
-
..Default::default()
|
|
452
|
-
})
|
|
453
|
-
}
|
|
454
|
-
|
|
455
|
-
fn clock_is_sane(state: &LicenseState) -> bool {
|
|
456
|
-
// A backwards jump beyond 5 min is how a user tries to outlive an expiry.
|
|
457
|
-
now_unix() - state.checked_at_local >= -300
|
|
458
|
-
}
|
|
459
|
-
```
|
|
460
|
-
|
|
461
|
-
#### 10.2 Chrome MV3 — service worker + `chrome.storage` + 12h alarm
|
|
462
|
-
|
|
463
|
-
```javascript
|
|
464
|
-
const STORE_URL = 'https://store.example.com/';
|
|
465
|
-
const ITEM_ID = 42;
|
|
466
|
-
|
|
467
|
-
async function getDeviceId() {
|
|
468
|
-
const { fc_device_id } = await chrome.storage.local.get('fc_device_id');
|
|
469
|
-
if (fc_device_id) return fc_device_id;
|
|
470
|
-
const id = 'device://' + crypto.randomUUID(); // service workers die; store it
|
|
471
|
-
await chrome.storage.local.set({ fc_device_id: id });
|
|
472
|
-
return id;
|
|
473
|
-
}
|
|
474
|
-
|
|
475
|
-
async function checkLicense() {
|
|
476
|
-
const { fc_license } = await chrome.storage.local.get('fc_license');
|
|
477
|
-
if (!fc_license?.license_key) return false;
|
|
478
|
-
|
|
479
|
-
const res = await fetch(STORE_URL + '?fluent-cart=check_license', {
|
|
480
|
-
method: 'POST',
|
|
481
|
-
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
|
|
482
|
-
body: new URLSearchParams({
|
|
483
|
-
license_key: fc_license.license_key,
|
|
484
|
-
item_id: String(ITEM_ID),
|
|
485
|
-
site_url: fc_license.device_id,
|
|
486
|
-
}),
|
|
487
|
-
});
|
|
488
|
-
const data = await res.json();
|
|
489
|
-
|
|
490
|
-
await chrome.storage.local.set({
|
|
491
|
-
fc_license: { ...fc_license, status: data.status, server_time_unix: data.server_time_unix, checked_at_local: Date.now() },
|
|
492
|
-
});
|
|
493
|
-
return data.status === 'valid' || data.status === 'active';
|
|
494
|
-
}
|
|
495
|
-
|
|
496
|
-
// A service worker is killed after ~30s idle: the alarm is what re-checks it.
|
|
497
|
-
chrome.alarms.create('fc-license-check', { periodInMinutes: 720 });
|
|
498
|
-
chrome.alarms.onAlarm.addListener(a => { if (a.name === 'fc-license-check') checkLicense().catch(() => {}); });
|
|
499
|
-
```
|
|
500
|
-
|
|
501
|
-
> Needs `"permissions": ["storage", "alarms"]` **and** the store origin in `host_permissions` — without the latter the fetch fails with a bare `TypeError: Failed to fetch`.
|
|
502
|
-
|
|
503
|
-
#### 10.3 Python (CLI / desktop) — httpx + keyring
|
|
504
|
-
|
|
505
|
-
```python
|
|
506
|
-
import keyring, httpx, time, uuid
|
|
507
|
-
|
|
508
|
-
STORE_URL, ITEM_ID = "https://store.example.com/", 42
|
|
509
|
-
|
|
510
|
-
def device_id() -> str:
|
|
511
|
-
existing = keyring.get_password("acme-studio", "device-id")
|
|
512
|
-
if existing:
|
|
513
|
-
return existing
|
|
514
|
-
fresh = f"device://{uuid.uuid4()}"
|
|
515
|
-
keyring.set_password("acme-studio", "device-id", fresh)
|
|
516
|
-
return fresh
|
|
517
|
-
|
|
518
|
-
def validate(license_key: str, stored: dict) -> bool:
|
|
519
|
-
data = httpx.post(f"{STORE_URL}?fluent-cart=check_license", data={
|
|
520
|
-
"license_key": license_key,
|
|
521
|
-
"item_id": str(ITEM_ID),
|
|
522
|
-
"site_url": stored["device_id"],
|
|
523
|
-
}, timeout=15).json()
|
|
524
|
-
|
|
525
|
-
# Server clock, not the machine's: refuse if time moved backwards.
|
|
526
|
-
if time.time() - stored["checked_at_local"] < -300:
|
|
527
|
-
return False
|
|
528
|
-
days = data.get("expires_in_days")
|
|
529
|
-
return data.get("status") in ("valid", "active") and (days is None or days >= 0)
|
|
530
|
-
```
|
|
531
|
-
|
|
532
|
-
### 11. Trial Abuse Prevention (one trial per machine)
|
|
533
|
-
|
|
534
|
-
FluentCart's trial is account-scoped: `other_info.trial_days` on the variation plus `subscriptions.status = 'trialing'`. A new email gets a new trial. To bind a trial to the **machine**, install the Fastr Devices add-on and drive three gates.
|
|
535
|
-
|
|
536
|
-
| Gate | Hook | Stops |
|
|
537
|
-
|---|---|---|
|
|
538
|
-
| Eligibility | `fluent_cart_action_fastr_trial_eligibility` | Reaching payment before learning a trial was already used |
|
|
539
|
-
| Activation | `fluent_cart/license/activate_license_response` (priority 20) | Second trial from a new account on the same machine |
|
|
540
|
-
| Heartbeat | `fluent_cart/license/check_license_response` (priority 20) | Copying a key to another machine mid-trial |
|
|
541
|
-
|
|
542
|
-
Clients send `device_fingerprint` alongside `site_url`:
|
|
543
|
-
|
|
544
|
-
```text
|
|
545
|
-
device_fingerprint = v1|MACHINEID=<machine guid>|UUID=<smbios uuid>|DISK=<disk serial>|CPU=<brand>
|
|
546
|
-
```
|
|
547
|
-
|
|
548
|
-
The server stores only `hash_hmac('sha256', $raw, wp_salt('auth'))` in `wp_fastr_trial_registry`, keyed uniquely on `(fingerprint_hash, scope_key)`. `scope_key` is the product ID, or `0` for global scope — a nullable unique column would break the constraint, because MySQL treats every `NULL` as distinct.
|
|
549
|
-
|
|
550
|
-
Refusals are HTTP 422 with `success: false`:
|
|
551
|
-
|
|
552
|
-
| `error_type` | Meaning |
|
|
553
|
-
|---|---|
|
|
554
|
-
| `trial_already_used` | Machine consumed its trial |
|
|
555
|
-
| `trial_fingerprint_required` | Trial sent no fingerprint |
|
|
556
|
-
| `trial_device_mismatch` | Key checked from a machine that never claimed it |
|
|
557
|
-
|
|
558
|
-
FluentCart's `sendSuccessResponse()` sets `success = true` **after** the response filter returns, so a filter callback must terminate with `wp_send_json($payload, 422)` to express a hard failure. Returning an array cannot.
|
|
559
|
-
|
|
560
|
-
Full schema, fingerprint tiers, token verification, scoring weights, and test checklist: [trial-abuse-prevention.md](references/trial-abuse-prevention.md).
|
|
561
|
-
|
|
562
|
-
---
|
|
563
|
-
|
|
564
|
-
## ⚡ Fastr MCP Server Tools Guidance
|
|
565
|
-
|
|
566
|
-
When the **`fluentcart-developer`** MCP server is connected, AI coding assistants must use these 10 dedicated FluentCart tools instead of guessing or loading giant documentation files into context:
|
|
567
|
-
|
|
568
|
-
| Tool | Purpose | Typical User Query |
|
|
569
|
-
|---|---|---|
|
|
570
|
-
| `fc_search_hooks` | Instant search across 680+ action and filter hooks with exact parameters and file anchors. | *"What hook fires after an order is completed?"* |
|
|
571
|
-
| `fc_get_db_schema` | Look up exact column definitions, primary keys, and Eloquent model for any `wp_fct_*` table. | *"What columns are on the subscriptions table?"* |
|
|
572
|
-
| `fc_get_reference` | Read any of the 57 comprehensive reference manuals in full or by specific section heading. | *"Show me the Void Renewal Invoice section of the REST API."* |
|
|
573
|
-
| `fc_generate_payment_gateway_boilerplate` | Generate production-ready PHP boilerplate for custom payment gateways with webhook listeners. | *"Generate a payment gateway for Paddle Billing."* |
|
|
574
|
-
| `fc_generate_licensing_boilerplate` | Generate client-side integration boilerplate for the official FluentCart Software Licensing SDK. | *"How do I add FluentCart licensing to my premium plugin?"* |
|
|
575
|
-
| `fc_generate_customer_endpoint_boilerplate` | Generate PHP code for custom server-rendered tabs and sub-pages in the Vue 3 customer dashboard. | *"Add a Wallet tab to the FluentCart customer portal."* |
|
|
576
|
-
| `fc_generate_device_licensing_boilerplate` | Generate client licensing code for non-WordPress software (Tauri/Rust, Chrome MV3, Python, C++/JUCE) using `device://` ids and clock-tamper guards. | *"Add FluentCart licensing to my Tauri desktop app."* |
|
|
577
|
-
| `fc_generate_trial_guard_boilerplate` | Generate fingerprinting, pre-checkout eligibility, and activation code that enforces one free trial per machine through the Fastr Devices add-on. | *"Stop people from getting a second trial with a new email."* |
|
|
578
|
-
| `fc_generate_client_sdk` | Generate a complete licence client for Node/Electron, .NET, Go or Kotlin: activation, heartbeat, deactivation, RS256 token verification, release checks, usage reporting, and the status rule that survives FluentCart 200-with-success errors. | *"Integrate FluentCart licensing into my Electron app."* |
|
|
579
|
-
| `fc_generate_native_client` | Generate a complete licence client for Swift, Unity/C#, Java, PHP or C: activation, heartbeat, deactivation, RS256 token verification, release checks and usage reporting. | *"Integrate FluentCart licensing into my iOS app."* |
|
|
580
|
-
|
|
106
|
+
The sync enumerates the site through its VitePress `hashmap.json` and sidebar
|
|
107
|
+
data, so it never crawls blindly or misses an unlinked page. See
|
|
108
|
+
`scripts/sync-fluentcart-docs.mjs`.
|