fluentcart-developer 1.1.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.
Files changed (66) hide show
  1. package/.gitattributes +2 -0
  2. package/CLAUDE.md +22 -0
  3. package/CONTRIBUTING.md +73 -0
  4. package/LICENSE +21 -0
  5. package/README.md +127 -0
  6. package/SKILL.md +127 -0
  7. package/bin/index.js +281 -0
  8. package/copy-skills.js +43 -0
  9. package/package.json +38 -0
  10. package/skills/fluentcart-developer/SKILL.md +172 -0
  11. package/skills/fluentcart-developer/examples/README.md +25 -0
  12. package/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/fluent-cart/checkout.php +32 -0
  13. package/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/functions.php +40 -0
  14. package/skills/fluentcart-developer/examples/sample-custom-addon/fluentcart-custom-addon.php +114 -0
  15. package/skills/fluentcart-developer/examples/sample-custom-payment-gateway/fluentcart-custom-gateway-example.php +149 -0
  16. package/skills/fluentcart-developer/examples/sample-fee-surcharge-plugin/fluentcart-fee-surcharge.php +38 -0
  17. package/skills/fluentcart-developer/examples/sample-shipping-carrier/fluentcart-custom-shipping-carrier.php +62 -0
  18. package/skills/fluentcart-developer/references/action-hooks-admin-templates.md +787 -0
  19. package/skills/fluentcart-developer/references/action-hooks-cart-checkout.md +1355 -0
  20. package/skills/fluentcart-developer/references/action-hooks-customers-users.md +266 -0
  21. package/skills/fluentcart-developer/references/action-hooks-licenses.md +855 -0
  22. package/skills/fluentcart-developer/references/action-hooks-orders.md +631 -0
  23. package/skills/fluentcart-developer/references/action-hooks-payments-integrations.md +963 -0
  24. package/skills/fluentcart-developer/references/action-hooks-products-coupons.md +585 -0
  25. package/skills/fluentcart-developer/references/action-hooks-subscriptions.md +661 -0
  26. package/skills/fluentcart-developer/references/database-models-query-builder.md +194 -0
  27. package/skills/fluentcart-developer/references/database-models-reference.md +604 -0
  28. package/skills/fluentcart-developer/references/database-schema-reference.md +940 -0
  29. package/skills/fluentcart-developer/references/engineering-notes.md +154 -0
  30. package/skills/fluentcart-developer/references/fee-system-guide.md +449 -0
  31. package/skills/fluentcart-developer/references/filter-hooks-cart-checkout.md +1202 -0
  32. package/skills/fluentcart-developer/references/filter-hooks-customers-subscriptions.md +902 -0
  33. package/skills/fluentcart-developer/references/filter-hooks-integrations-advanced.md +1598 -0
  34. package/skills/fluentcart-developer/references/filter-hooks-orders-payments.md +1319 -0
  35. package/skills/fluentcart-developer/references/filter-hooks-products-pricing.md +628 -0
  36. package/skills/fluentcart-developer/references/filter-hooks-settings-configuration.md +1177 -0
  37. package/skills/fluentcart-developer/references/fluentcart-developer-guide.md +154 -0
  38. package/skills/fluentcart-developer/references/ghost-product-selling.md +458 -0
  39. package/skills/fluentcart-developer/references/modules-and-extensions-reference.md +224 -0
  40. package/skills/fluentcart-developer/references/paddle-gateway-case-study.md +1925 -0
  41. package/skills/fluentcart-developer/references/payment-gateway-integration.md +761 -0
  42. package/skills/fluentcart-developer/references/rest-api-checkout.md +286 -0
  43. package/skills/fluentcart-developer/references/rest-api-coupons.md +794 -0
  44. package/skills/fluentcart-developer/references/rest-api-customer-profile.md +190 -0
  45. package/skills/fluentcart-developer/references/rest-api-customers.md +1121 -0
  46. package/skills/fluentcart-developer/references/rest-api-dashboard-utilities.md +219 -0
  47. package/skills/fluentcart-developer/references/rest-api-email-notifications.md +619 -0
  48. package/skills/fluentcart-developer/references/rest-api-files.md +290 -0
  49. package/skills/fluentcart-developer/references/rest-api-integrations.md +324 -0
  50. package/skills/fluentcart-developer/references/rest-api-labels-attributes.md +321 -0
  51. package/skills/fluentcart-developer/references/rest-api-licensing.md +171 -0
  52. package/skills/fluentcart-developer/references/rest-api-order-bumps.md +200 -0
  53. package/skills/fluentcart-developer/references/rest-api-orders.md +1241 -0
  54. package/skills/fluentcart-developer/references/rest-api-overview.md +131 -0
  55. package/skills/fluentcart-developer/references/rest-api-products.md +2563 -0
  56. package/skills/fluentcart-developer/references/rest-api-public-shop.md +172 -0
  57. package/skills/fluentcart-developer/references/rest-api-reference.md +552 -0
  58. package/skills/fluentcart-developer/references/rest-api-reports.md +377 -0
  59. package/skills/fluentcart-developer/references/rest-api-roles-permissions.md +147 -0
  60. package/skills/fluentcart-developer/references/rest-api-settings.md +528 -0
  61. package/skills/fluentcart-developer/references/rest-api-shipping.md +800 -0
  62. package/skills/fluentcart-developer/references/rest-api-subscriptions.md +606 -0
  63. package/skills/fluentcart-developer/references/rest-api-tax.md +356 -0
  64. package/skills/fluentcart-developer/references/subscription-customization.md +197 -0
  65. package/skills/fluentcart-developer/scripts/cli.js +1 -0
  66. package/skills.sh.json +13 -0
@@ -0,0 +1,38 @@
1
+ <?php
2
+ /**
3
+ * Plugin Name: FluentCart Fee Surcharge Addon
4
+ * Description: Example plugin demonstrating dynamic conditional fee surcharges (e.g. Gift Wrapping & Heavy Freight fees) in FluentCart.
5
+ * Version: 1.0.0
6
+ * Author: Developer Team
7
+ */
8
+
9
+ if (!defined('ABSPATH')) {
10
+ exit;
11
+ }
12
+
13
+ // Hook into FluentCart fee calculation lifecycle
14
+ add_filter('fluent_cart/fee_items', function ($fees, $cart) {
15
+ // Calculate subtotal in cents
16
+ $subtotal = $cart->getSubTotal();
17
+
18
+ // Condition 1: Add $3.50 (350 cents) Gift Wrapping Fee for orders under $50.00 (5000 cents)
19
+ if ($subtotal < 5000) {
20
+ $fees[] = [
21
+ 'id' => 'gift_wrap_fee',
22
+ 'title' => __('Optional Gift Packaging', 'fc-fee-addon'),
23
+ 'amount' => 350, // 350 cents = $3.50
24
+ 'taxable' => false,
25
+ ];
26
+ }
27
+
28
+ // Condition 2: Add 2% Payment Surcharge (percentage fee)
29
+ $surchargeAmount = (int) round($subtotal * 0.02); // 2% calculation in cents
30
+ $fees[] = [
31
+ 'id' => 'payment_surcharge',
32
+ 'title' => __('Payment Processing Surcharge (2%)', 'fc-fee-addon'),
33
+ 'amount' => $surchargeAmount,
34
+ 'taxable' => false,
35
+ ];
36
+
37
+ return $fees;
38
+ }, 10, 2);
@@ -0,0 +1,62 @@
1
+ <?php
2
+ /**
3
+ * Plugin Name: FluentCart Custom Shipping Carrier Example
4
+ * Plugin URI: https://github.com/atifjubaer/skills
5
+ * Description: Example plugin demonstrating how to register custom dynamic shipping calculation methods in FluentCart.
6
+ * Version: 1.0.0
7
+ * Author: Fastrsoft
8
+ * License: MIT
9
+ */
10
+
11
+ if (!defined('ABSPATH')) {
12
+ exit; // Exit if direct file access is attempted
13
+ }
14
+
15
+ // Hook into FluentCart shipping rate registration filter
16
+ add_filter('fluent_cart/shipping/methods', function($methods) {
17
+ // Append custom carrier calculation class or handler
18
+ $methods['custom_express_carrier'] = [
19
+ 'title' => __('Custom Express Carrier', 'fluentcart'),
20
+ 'description' => __('Calculates real-time express shipping rates based on cart total and weight.', 'fluentcart'),
21
+ 'callback' => 'fluentcart_calculate_express_shipping_rate'
22
+ ];
23
+ return $methods;
24
+ });
25
+
26
+ // Callback function to calculate dynamic shipping rate for current cart
27
+ function fluentcart_calculate_express_shipping_rate($cartData) {
28
+ // Extract subtotal and item total weights from cart data object
29
+ $subtotal = $cartData['subtotal'] ?? 0;
30
+ $totalWeight = $cartData['total_weight'] ?? 0; // Total weight in kg
31
+
32
+ // Set base shipping fee
33
+ $baseRate = 500; // $5.00 in cents
34
+
35
+ // Apply free shipping logic for high subtotal orders over $100 (10000 cents)
36
+ if ($subtotal >= 10000) {
37
+ return [
38
+ 'id' => 'custom_express_free',
39
+ 'title' => __('Express Shipping (Free - Order > $100)', 'fluentcart'),
40
+ 'cost' => 0, // Free rate
41
+ 'delivery' => __('1-2 Business Days', 'fluentcart')
42
+ ];
43
+ }
44
+
45
+ // Calculate weight-based surcharge ($2 per extra kg over 1kg)
46
+ $weightSurcharge = 0;
47
+ if ($totalWeight > 1) {
48
+ $extraKg = ceil($totalWeight - 1);
49
+ $weightSurcharge = $extraKg * 200; // $2.00 per extra kg
50
+ }
51
+
52
+ // Sum total shipping cost in store currency cents
53
+ $finalCost = $baseRate + $weightSurcharge;
54
+
55
+ // Return shipping rate item payload
56
+ return [
57
+ 'id' => 'custom_express_rate',
58
+ 'title' => __('Express Delivery', 'fluentcart'),
59
+ 'cost' => $finalCost, // Amount in monetary cents
60
+ 'delivery' => __('1-2 Business Days', 'fluentcart')
61
+ ];
62
+ }