Third-Party Integrations
Toggle the bridge into Ultimate Gift Card. The integration auto-detects the target plugin and only boots when present — zero overhead when it isn't installed.
Tested versions
The bridge boots only when its target plugin is detected. The tested compatibility window is noted in the table below.
Where
Wallet → Settings → Third-Party Integrations.
Available Integrations
| Plugin | Tested up to | Bridge does |
|---|---|---|
| Ultimate Gift Card | 2.6 | Gift card redemption credits wallet directly |
Step-by-step Setup
1. Verify target plugin is active
If the integration toggle is greyed out, Ultimate Gift Card isn't detected. Activate it first.
2. Toggle the bridge
| Toggle | Effect |
|---|---|
| ON | Bridge listens to Ultimate Gift Card's hooks and fires wallet operations |
| OFF | Bridge silent; Ultimate Gift Card runs normally without wallet involvement |
3. Gift card extras
| Extra | Use |
|---|---|
| Auto-credit on redeem | ON = gift card balance credits wallet on redemption |
4. Save
Click Save changes.
Verify
With the bridge enabled, run a real flow:
- Customer redeems a gift card code
- Wallet credited the gift card amount
Conditional Loading
| Behaviour | Notes |
|---|---|
| Auto-detection | The bridge wraps its boot in class_exists() / function_exists() guards |
| Silent no-op | Removing or upgrading Ultimate Gift Card never breaks wallet |
| Hook priority | The bridge boots on plugins_loaded priority 20 |
Plugin Conflicts (avoid)
| Plugin | Conflict | Workaround |
|---|---|---|
| TeraWallet | duplicate gateway / shortcodes | Run only one wallet plugin |
| YITH Account Funds | duplicate balance UI | Run only one |
| Smart Coupons (refund-to-credit feature) | duplicate refund flow | Disable Smart Coupons' refund feature |
Troubleshooting
| Problem | Fix |
|---|---|
| Gift card balance not crediting wallet | Bridge toggle off OR auto-credit-on-redeem disabled |
| Toggle greyed out | Ultimate Gift Card not active — activate it first |
