GamerHub for WooCommerce
| 开发者 | gamerhubstore01 |
|---|---|
| 更新时间 | 2026年8月1日 20:30 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Add games in one click - every game GamerHub sells becomes a WooCommerce product (one variation per top-up amount), priced at what you pay plus the profit % you set.
- Your prices, your way - set a default profit %, then fine-tune it for one game or one single top-up amount, with filters and a bulk edit. A price is never allowed to fall below what GamerHub charges you (see the currency note below).
- Sell in your own currency - if your shop sells in a different currency from the one GamerHub charges you in, the plugin converts every cost at an exchange rate, adds an optional safety buffer, then adds your profit. If it cannot get a trustworthy rate it refuses to write any price at all rather than guess.
- Player ID / Server fields on the product page, generated automatically from the game's own schema, with an optional live account check before purchase. The fields use standard WooCommerce markup, so they inherit your theme's styling.
- Automatic fulfilment - when a WooCommerce order is paid, each unit is submitted to GamerHub server-side over an HMAC-signed request. One supplier order per unit, so every supplier and every quantity works.
- Signed status webhook - the order flips to Completed once GamerHub confirms delivery; voucher codes are attached to the order and emailed to the customer.
- Works with your add-ons - already render Player ID / Server with PPOM or another product add-on? Turn off the built-in fields and the plugin rebuilds the fulfilment data from the order automatically. If it can't be certain which field is which, it blocks the order instead of guessing - a top-up is never sent to the wrong account.
- Manual linking - hand-build any product (your own name / price / image) and link it to a GamerHub top-up amount, or sell a single amount as its own standalone product that keeps tracking cost and stock.
- Keep everything up to date (optional) - refresh prices and stock in the background every 1, 3, 6, 12 or 24 hours, with a per-product on/off switch. Products that go inactive or out of stock upstream are marked out of stock automatically and restock themselves when they return.
- HPOS compatible.
安装:
- Install and activate the plugin. WooCommerce must already be active.
- In the WordPress menu on the left, click GamerHub. Paste your API Key, API Secret and Webhook Secret from portal.gamerhubstore.shop. The Webhook Secret must be exactly the same as the one in your GamerHub account - if it is not, GamerHub still delivers and still charges you, but your shop never marks the order Complete. Set your Default profit % - leave it at 0 and you sell at cost price and earn nothing. Press Save settings.
- Press Test connection. If it fails, the message shows this server's address. Open the API Key page in your GamerHub account, add that address to the allowed list, then test again. When it succeeds it also tells you which currency GamerHub charges you in - you need that for the next step.
- Still on the GamerHub page, check Currency handling. If your shop sells in a different currency from the one GamerHub charges you in, nothing will be imported until you choose Convert. See the currency question below.
- Press Get the game list, then press Add to my shop on each game you want to sell.
- Put some money in your GamerHub wallet, then buy one cheap item on your own shop to check the code or top-up really arrives.
常见问题:
My shop and my GamerHub account use different currencies. What happens?
GamerHub charges you in one currency (often USD). Your shop sells in another. A cost of 2.50 USD is not a price of 2.50 in your currency, so the plugin will not guess - by default it stops and imports nothing. That is deliberate: it protects you. On the GamerHub page, under Currency handling, pick one of three:
- Convert - what almost every shop wants. GamerHub's cost is multiplied by an exchange rate, then your profit % is added. The rate comes from your GamerHub account and stays up to date on its own, or you can type your own. If the rate is missing or more than a day old, the plugin stops writing prices until it has a fresh one, so you are never priced from a stale rate.
- Pause - the default. Nothing is imported and no price changes while the two currencies are different.
- No conversion - the number is copied across with no maths at all, so a cost of 2.50 USD becomes a price of 2.50 in your currency. Only safe if you type every price by hand and turn "Keep price and stock up to date" off. In this mode the below-cost protection cannot work, because the two numbers are not in the same currency.
Can I change my WooCommerce currency after adding games?
Not safely. WooCommerce stores a price as a plain number and puts your currency label on it. If you switch currency, every imported price keeps its old number and only the label changes - so 11.75 in the old currency becomes 11.75 in the new one, and most of your shop is suddenly priced wrong. The plugin shows a red warning if it detects this. Fix it by adding your games again before you take any orders.
Does it need a GamerHub account?
Yes. This plugin is a client for the GamerHub merchant platform; you need a merchant account, API credentials, and enough wallet balance (orders draw the wholesale cost).
What does the customer have to fill in?
Only the game fields the product requires (e.g. Player ID, Server) - these come from GamerHub automatically. Vouchers require nothing; the buyer just pays and receives a code.
Can I set my own profit or prices?
Yes. Set a Default profit % on the GamerHub page. Every game in the list then has its own Your profit box right in the table — you can fill it in even before you add the game to your shop, and it is applied the moment you do. Press Prices on a game's row to see each top-up amount with what you pay and what the buyer pays side by side, and to give one single amount its own profit. Note the two profit types: % on top of cost multiplies, and + CUR on top of cost adds that many units of your currency on top of the cost - it does not set the price to that amount. A price is never allowed to fall below what GamerHub charges you, as long as your shop currency matches your GamerHub currency or you use Convert.
How often do prices and stock refresh?
Turn on the interval on the GamerHub page - every 1, 3, 6, 12 or 24 hours. Each time it runs it rewrites the prices of the games already in your shop using your profit %, and also puts the GamerHub name back and puts the product back on sale - so a price or a name you typed by hand on one of those products will be replaced. To protect one game from this, untick Keep updated on its row. If a product goes inactive or out of stock upstream it is automatically marked out of stock so it can't be sold while it can't be fulfilled, and it restocks itself on the next successful sync.
I use PPOM or another product add-on for the Player ID fields. Does it work?
Yes. On a product that uses an add-on, tick "Another plugin already asks for the Player ID" in its GamerHub box to turn ours off and let your add-on render the Player ID / Server. When an order is paid the plugin rebuilds the fulfilment data from the order automatically - matching each GamerHub field by your saved mapping, its label, or a synonym. If it can't be certain which field is which, it blocks the order instead of guessing, so a top-up is never sent to the wrong account. Note that with this on, the plugin no longer checks that the buyer filled the fields in - so place one test order before you go live. Pressing Prices on a game's row shows exactly which fields that game needs, and for dropdowns (such as a Genshin server) the exact values to use. You can also map fields explicitly, per product or per variation.
Will the player fields match my theme?
Yes. The built-in fields use standard WooCommerce form markup and inherit your theme's checkout styling, so they look like the rest of your store.
How are orders fulfilled?
When an order is paid, each unit is submitted to GamerHub over a signed request. The order stays in "processing" until GamerHub's signed webhook confirms delivery, then it completes; failures are held for your review (never auto-refunded).
Is it compatible with High-Performance Order Storage (HPOS)?
Yes.
更新日志:
- Sell in your own currency. If your shop's currency is not the one GamerHub charges you in, costs are now converted at a rate taken from your GamerHub account (or one you type), with an optional safety buffer and optional rounding. If no trustworthy rate is available the plugin refuses to write a price rather than guess, and rounding is always upward so it can never push a price below cost.
- See what you pay and what the buyer pays for every top-up amount, side by side and each labelled with its own currency, without adding anything to your shop - press Prices on any game.
- Set the profit for a game straight from the game list, including games you have not added yet: the value is remembered and applied the moment you add them.
- Give a hand-built or single-amount product its own profit %, instead of only the global default - so you can set a different margin without losing the automatic sold-out protection.
- The denomination picker on the product editor now shows what each amount costs you, in GamerHub's currency and in yours, so you can price against real numbers.
- Plain-language rewrite of every admin screen, aimed at shop owners rather than developers, and every admin string is now translatable.
- Fixed: with a rounding step set, a price could jump a whole step because of a floating-point rounding artefact (for example 50.00 plus 10% became 60 instead of 55).
- Fixed: choosing "no conversion" and then saving the settings page again silently reset it to "Pause", which stopped all imports and repricing with no explanation.
- Fixed: the per-game price refresh silently returned cached data instead of fetching fresh figures.
- Fixed: a bulk edit reported games as changed even when their prices could not be rewritten.
- Fixed: "Sync from GamerHub" on a fixed-price product showed a red error for what is normal, expected behaviour.
- Faster: the admin pages no longer run an unbounded product query on every screen, and the game list no longer runs one query per product.
- Per-product and per-denomination markup, set inline in GamerHub -> Products, with filters and bulk edit.
- Per-product auto-sync on/off switch, and new auto-sync intervals: every 1, 3, 6, 12 or 24 hours.
- Closed-loop stock: products that are inactive or out of stock upstream are marked out of stock automatically and restock on the next successful sync. Transient API errors never change stock.
- Works with PPOM / product add-ons: turn off the built-in fields and the plugin rebuilds fulfilment data from the order, matching each field by mapping, label or synonym - and blocks rather than guessing when unsure. A reference in Products shows each game's required fields and dropdown values; fields can also be mapped explicitly per product or per variation.
- Add a single denomination as a standalone product ("Import as product") that keeps tracking cost & stock.
- See live prices before importing: a Price column in GamerHub -> Products shows each game's retail range, refreshed per game with a single click (no product created).
- Sync one product on demand: a "Sync from GamerHub" action on the WooCommerce Products list and a button on the product editor refresh just that product's price & stock, without re-syncing the whole catalog.
- Built-in player fields now inherit your theme's styling.
- Initial release: settings + connection test, batched catalog sync (variable products), player-ID fields, Verify ID, per-unit order placement, signed webhook receiver with replay protection, auto-sync, manual product linking.