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.
- package/.gitattributes +2 -0
- package/CLAUDE.md +22 -0
- package/CONTRIBUTING.md +73 -0
- package/LICENSE +21 -0
- package/README.md +127 -0
- package/SKILL.md +127 -0
- package/bin/index.js +281 -0
- package/copy-skills.js +43 -0
- package/package.json +38 -0
- package/skills/fluentcart-developer/SKILL.md +172 -0
- package/skills/fluentcart-developer/examples/README.md +25 -0
- package/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/fluent-cart/checkout.php +32 -0
- package/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/functions.php +40 -0
- package/skills/fluentcart-developer/examples/sample-custom-addon/fluentcart-custom-addon.php +114 -0
- package/skills/fluentcart-developer/examples/sample-custom-payment-gateway/fluentcart-custom-gateway-example.php +149 -0
- package/skills/fluentcart-developer/examples/sample-fee-surcharge-plugin/fluentcart-fee-surcharge.php +38 -0
- package/skills/fluentcart-developer/examples/sample-shipping-carrier/fluentcart-custom-shipping-carrier.php +62 -0
- package/skills/fluentcart-developer/references/action-hooks-admin-templates.md +787 -0
- package/skills/fluentcart-developer/references/action-hooks-cart-checkout.md +1355 -0
- package/skills/fluentcart-developer/references/action-hooks-customers-users.md +266 -0
- package/skills/fluentcart-developer/references/action-hooks-licenses.md +855 -0
- package/skills/fluentcart-developer/references/action-hooks-orders.md +631 -0
- package/skills/fluentcart-developer/references/action-hooks-payments-integrations.md +963 -0
- package/skills/fluentcart-developer/references/action-hooks-products-coupons.md +585 -0
- package/skills/fluentcart-developer/references/action-hooks-subscriptions.md +661 -0
- package/skills/fluentcart-developer/references/database-models-query-builder.md +194 -0
- package/skills/fluentcart-developer/references/database-models-reference.md +604 -0
- package/skills/fluentcart-developer/references/database-schema-reference.md +940 -0
- package/skills/fluentcart-developer/references/engineering-notes.md +154 -0
- package/skills/fluentcart-developer/references/fee-system-guide.md +449 -0
- package/skills/fluentcart-developer/references/filter-hooks-cart-checkout.md +1202 -0
- package/skills/fluentcart-developer/references/filter-hooks-customers-subscriptions.md +902 -0
- package/skills/fluentcart-developer/references/filter-hooks-integrations-advanced.md +1598 -0
- package/skills/fluentcart-developer/references/filter-hooks-orders-payments.md +1319 -0
- package/skills/fluentcart-developer/references/filter-hooks-products-pricing.md +628 -0
- package/skills/fluentcart-developer/references/filter-hooks-settings-configuration.md +1177 -0
- package/skills/fluentcart-developer/references/fluentcart-developer-guide.md +154 -0
- package/skills/fluentcart-developer/references/ghost-product-selling.md +458 -0
- package/skills/fluentcart-developer/references/modules-and-extensions-reference.md +224 -0
- package/skills/fluentcart-developer/references/paddle-gateway-case-study.md +1925 -0
- package/skills/fluentcart-developer/references/payment-gateway-integration.md +761 -0
- package/skills/fluentcart-developer/references/rest-api-checkout.md +286 -0
- package/skills/fluentcart-developer/references/rest-api-coupons.md +794 -0
- package/skills/fluentcart-developer/references/rest-api-customer-profile.md +190 -0
- package/skills/fluentcart-developer/references/rest-api-customers.md +1121 -0
- package/skills/fluentcart-developer/references/rest-api-dashboard-utilities.md +219 -0
- package/skills/fluentcart-developer/references/rest-api-email-notifications.md +619 -0
- package/skills/fluentcart-developer/references/rest-api-files.md +290 -0
- package/skills/fluentcart-developer/references/rest-api-integrations.md +324 -0
- package/skills/fluentcart-developer/references/rest-api-labels-attributes.md +321 -0
- package/skills/fluentcart-developer/references/rest-api-licensing.md +171 -0
- package/skills/fluentcart-developer/references/rest-api-order-bumps.md +200 -0
- package/skills/fluentcart-developer/references/rest-api-orders.md +1241 -0
- package/skills/fluentcart-developer/references/rest-api-overview.md +131 -0
- package/skills/fluentcart-developer/references/rest-api-products.md +2563 -0
- package/skills/fluentcart-developer/references/rest-api-public-shop.md +172 -0
- package/skills/fluentcart-developer/references/rest-api-reference.md +552 -0
- package/skills/fluentcart-developer/references/rest-api-reports.md +377 -0
- package/skills/fluentcart-developer/references/rest-api-roles-permissions.md +147 -0
- package/skills/fluentcart-developer/references/rest-api-settings.md +528 -0
- package/skills/fluentcart-developer/references/rest-api-shipping.md +800 -0
- package/skills/fluentcart-developer/references/rest-api-subscriptions.md +606 -0
- package/skills/fluentcart-developer/references/rest-api-tax.md +356 -0
- package/skills/fluentcart-developer/references/subscription-customization.md +197 -0
- package/skills/fluentcart-developer/scripts/cli.js +1 -0
- 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
|
+
}
|