Title: Topomer
Author: Gofran Jemai
Published: <strong>2026 年 3 月 16 日</strong>
Last modified: 2026 年 3 月 30 日

---

搜尋外掛

![](https://ps.w.org/topomer/assets/icon-256x256.png?rev=3494415)

# Topomer

 由 [Gofran Jemai](https://profiles.wordpress.org/gofranjemai/) 開發

[下載](https://downloads.wordpress.org/plugin/topomer.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/topomer/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/topomer/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/topomer/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/topomer/#developers)

 [技術支援](https://wordpress.org/support/plugin/topomer/)

## 外掛說明

Topomer extends WooCommerce with two main capabilities:

 1. Promo code management (automatic and manual)
 2. A Topomer payment flow that lets eligible customers pay with their Topomer balance

The plugin validates customer tokens through Topomer services, calculates discount
rules from remote price intervals, and updates balances after successful checkout.

### Features

 * Automatic promo code generation based on cart total
 * Manual promo code creation and management from the admin area
 * Dynamic discount percentage based on configured price intervals
 * WooCommerce checkout integration
 * Topomer token validation through API
 * Customer balance display at checkout
 * Balance consumption and synchronization after successful payment

### Requirements

 * WordPress 5.0+
 * WooCommerce installed and activated
 * PHP 7.4+

### Setup

 1. Confirm WooCommerce is active.
 2. Configure your Topomer settings and API-related options.
 3. Verify promo intervals and manual promo settings.
 4. Test checkout using a valid Topomer token.

### External Services

This plugin relies on external services provided by Topomer (hosted on files-pub.
com) for core functionality. Without these services, token validation, balance handling,
and some promo/payment logic will not work.

#### Service Provider

 * Provider: Topomer
 * Service base domain: files-pub.com
 * Terms of service: https://topomer.com/terms
 * Privacy policy: https://topomer.com/privacy

#### Endpoints, Data Sent, and Purpose

 1. Token verification endpoint

* URL: https://files-pub.com/api/plugin/users/get-by-token
 * Purpose: Validate 
customer token and retrieve account data. * Trigger: Checkout flow and visits containing?
idTopomer=TOKEN. * Data sent: Token value (URL parameter).

 1. Price intervals endpoint

* URL: https://files-pub.com/api/interval-prix
 * Purpose: Retrieve discount intervals
used for dynamic promo calculation. * Trigger: Cart/checkout logic when discount
rules are needed. * Data sent: No customer personal data.

 1. Balance update endpoint

* URL: https://files-pub.com/api/plugin/users/update-solde
 * Purpose: Update user
balance after successful payment. * Trigger: After order completion/payment processing.*
Data sent: Token, updated balance amount, user ID.

 1. Token expiration endpoint

* URL: https://files-pub.com/api/plugin/users/update-expired
 * Purpose: Mark a 
token as used/expired. * Trigger: After token usage or validation workflow. * Data
sent: Token, expiration status.

 1. Personal shopper balance endpoint

* URL: Hosted on files-pub.com (Topomer internal endpoint)
 * Purpose: Retrieve 
available shopper balance for payment checks. * Trigger: Access with ?idTopomer=
ID and during checkout. * Data sent: Personal shopper ID and authentication token
in headers.

 1. Promo code management endpoints

* URL: Hosted on files-pub.com (Topomer internal endpoints)
 * Purpose: Create/update
promo codes from admin actions. * Trigger: Admin creates or updates promo definitions.*
Data sent: Promo details (code, percentage, type, and ID for updates).

 1. Order processing endpoint

* URL: Hosted on files-pub.com (Topomer internal endpoint)
 * Purpose: Create/process
order records after payment. * Trigger: After successful payment. * Data sent: Order
data (order ID, customer info, items, totals, payment method).

 1. Authentication endpoint

* URL: Hosted on files-pub.com (Topomer internal endpoint)
 * Purpose: Obtain access
token for API requests. * Trigger: Plugin authentication flow. * Data sent: Authentication
credentials.

### Credits

Developed by Topomer.

## 螢幕擷圖

 * [[
 * Topomer admin dashboard
 * [[
 * Manual promo management screen
 * [[
 * Customer balance display during checkout
 * [[
 * Topomer payment option in WooCommerce checkout
 * [[
 * Topomer logo asset used for branding
 * [[
 * Topomer mobile profile screen preview
 * [[
 * Topomer mobile balance screen preview

## 安裝方式

#### Install from WordPress Admin

 1. In WordPress admin, go to Plugins > Add New.
 2. Search for “Topomer”.
 3. Click Install Now.
 4. Click Activate.

#### Manual Install (ZIP)

 1. Download the plugin ZIP.
 2. In WordPress admin, go to Plugins > Add New > Upload Plugin.
 3. Upload the ZIP file and click Install Now.
 4. Activate the plugin.

## 常見問題集

### Does this plugin require WooCommerce?

Yes. WooCommerce must be installed and active.

### How are automatic promo codes generated?

Promo rules are applied dynamically using cart total and price intervals from Topomer
APIs.

### How does Topomer payment appear at checkout?

When conditions are met (for example a valid token and eligible promo/payment context),
Topomer payment becomes available in checkout.

### What if the user balance is not enough?

The payment is rejected and the customer is notified about the insufficient amount.

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈Topomer〉的開發相關工作。

參與者

 *   [ Gofran Jemai ](https://profiles.wordpress.org/gofranjemai/)
 *   [ anisawadni ](https://profiles.wordpress.org/anisawadni/)
 *   [ chouaybaroua ](https://profiles.wordpress.org/chouaybaroua/)

[將〈Topomer〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/topomer)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/topomer/)、查看
[SVN 存放庫](https://plugins.svn.wordpress.org/topomer/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/topomer/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/topomer/)。

## 變更記錄

#### 1.1.3

 * Refactor plugin bootstrap into modular files for maintainability.
 * Restrict core upgrade loading to activation context only (guarded dbDelta usage).
 * Remove direct WP_List_Table core file loading from templates.
 * Ensure sessions are started only in the narrow Topomer flow (?idTopomer).
 * Improve session data sanitization and validation in payment flow.
 * Escape API error output to prevent unsafe admin/frontend notices.
 * Add session_write_close() after session writes to reduce lock duration.

#### 1.0

 * Initial release
 * Automatic promo code generation
 * Manual promo management
 * WooCommerce integration
 * Topomer payment method
 * Token verification via API
 * Dynamic discount calculation
 * Balance synchronization after payment

## 中繼資料

 *  版本 **1.0**
 *  最後更新 **5 天前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 5.0 或更新版本 **
 *  已測試相容的 WordPress 版本 **6.9.4**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/topomer/)
 * 標籤
 * [coupons](https://tw.wordpress.org/plugins/tags/coupons/)[payment](https://tw.wordpress.org/plugins/tags/payment/)
   [promo codes](https://tw.wordpress.org/plugins/tags/promo-codes/)[woocommerce](https://tw.wordpress.org/plugins/tags/woocommerce/)
 *  [進階檢視](https://tw.wordpress.org/plugins/topomer/advanced/)

## 評分

這個項目尚無任何評論記錄。

[新增使用者評論](https://wordpress.org/support/plugin/topomer/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/topomer/reviews/)

## 參與者

 *   [ Gofran Jemai ](https://profiles.wordpress.org/gofranjemai/)
 *   [ anisawadni ](https://profiles.wordpress.org/anisawadni/)
 *   [ chouaybaroua ](https://profiles.wordpress.org/chouaybaroua/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/topomer/)