{"id":279130,"date":"2026-03-16T10:22:18","date_gmt":"2026-03-16T10:22:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/topomer\/"},"modified":"2026-03-30T10:05:09","modified_gmt":"2026-03-30T10:05:09","slug":"topomer","status":"publish","type":"plugin","link":"https:\/\/tr.wordpress.org\/plugins\/topomer\/","author":23343342,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0","stable_tag":"trunk","tested":"6.9.4","requires":"5.0","requires_php":"7.4","requires_plugins":null,"header_name":"Topomer","header_author":"(C) Topomer","header_description":"A plugin to manage promo codes.","assets_banners_color":"8e9ea0","last_updated":"2026-03-30 10:05:09","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/topomer.com\/","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":170,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"gofranjemai","date":"2026-03-16 10:23:38"}},"upgrade_notice":{"1.1.3":"

Security and compatibility update to satisfy WordPress.org review requirements.\nThis release hardens session handling, sanitization\/escaping, and activation-only core loading.<\/p>","1.0":"

Initial release. Ensure WooCommerce is installed and active before activation.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3494415,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3494415,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3494415,"resolution":"1544x500","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3494415,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3494415,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3494415,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3494415,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3494415,"resolution":"5","location":"assets","locale":""},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3494415,"resolution":"6","location":"assets","locale":""},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3494415,"resolution":"7","location":"assets","locale":""}},"screenshots":{"1":"Topomer admin dashboard","2":"Manual promo management screen","3":"Customer balance display during checkout","4":"Topomer payment option in WooCommerce checkout","5":"Topomer logo asset used for branding","6":"Topomer mobile profile screen preview","7":"Topomer mobile balance screen preview"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[591,507,174841,257852,286],"plugin_category":[45],"plugin_contributors":[257853,257854],"plugin_business_model":[],"class_list":["post-279130","plugin","type-plugin","status-publish","hentry","plugin_tags-coupons","plugin_tags-payment","plugin_tags-promo-codes","plugin_tags-topomer","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-anisawadni","plugin_contributors-chouaybaroua","plugin_committers-gofranjemai"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/topomer\/assets\/icon-128x128.png?rev=3494415","icon_2x":"https:\/\/ps.w.org\/topomer\/assets\/icon-256x256.png?rev=3494415","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/topomer\/assets\/screenshot-1.png?rev=3494415","caption":"Topomer admin dashboard"},{"src":"https:\/\/ps.w.org\/topomer\/assets\/screenshot-2.png?rev=3494415","caption":"Manual promo management screen"},{"src":"https:\/\/ps.w.org\/topomer\/assets\/screenshot-3.png?rev=3494415","caption":"Customer balance display during checkout"},{"src":"https:\/\/ps.w.org\/topomer\/assets\/screenshot-4.png?rev=3494415","caption":"Topomer payment option in WooCommerce checkout"},{"src":"https:\/\/ps.w.org\/topomer\/assets\/screenshot-5.png?rev=3494415","caption":"Topomer logo asset used for branding"},{"src":"https:\/\/ps.w.org\/topomer\/assets\/screenshot-6.png?rev=3494415","caption":"Topomer mobile profile screen preview"},{"src":"https:\/\/ps.w.org\/topomer\/assets\/screenshot-7.png?rev=3494415","caption":"Topomer mobile balance screen preview"}],"raw_content":"\n

Topomer extends WooCommerce with two main capabilities:<\/p>\n\n

    \n
  1. Promo code management (automatic and manual)<\/li>\n
  2. A Topomer payment flow that lets eligible customers pay with their Topomer balance<\/li>\n<\/ol>\n\n

    The plugin validates customer tokens through Topomer services, calculates discount rules from remote price intervals, and updates balances after successful checkout.<\/p>\n\n

    Features<\/h3>\n\n
      \n
    • Automatic promo code generation based on cart total<\/li>\n
    • Manual promo code creation and management from the admin area<\/li>\n
    • Dynamic discount percentage based on configured price intervals<\/li>\n
    • WooCommerce checkout integration<\/li>\n
    • Topomer token validation through API<\/li>\n
    • Customer balance display at checkout<\/li>\n
    • Balance consumption and synchronization after successful payment<\/li>\n<\/ul>\n\n

      Requirements<\/h3>\n\n
        \n
      • WordPress 5.0+<\/li>\n
      • WooCommerce installed and activated<\/li>\n
      • PHP 7.4+<\/li>\n<\/ul>\n\n

        Setup<\/h3>\n\n
          \n
        1. Confirm WooCommerce is active.<\/li>\n
        2. Configure your Topomer settings and API-related options.<\/li>\n
        3. Verify promo intervals and manual promo settings.<\/li>\n
        4. Test checkout using a valid Topomer token.<\/li>\n<\/ol>\n\n

          External Services<\/h3>\n\n

          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.<\/p>\n\n

          Service Provider<\/h4>\n\n
            \n
          • Provider: Topomer<\/li>\n
          • Service base domain: files-pub.com<\/li>\n
          • Terms of service: https:\/\/topomer.com\/terms<\/li>\n
          • Privacy policy: https:\/\/topomer.com\/privacy<\/li>\n<\/ul>\n\n

            Endpoints, Data Sent, and Purpose<\/h4>\n\n
              \n
            1. Token verification endpoint<\/li>\n<\/ol>\n\n

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

                \n
              1. Price intervals endpoint<\/li>\n<\/ol>\n\n

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

                  \n
                1. Balance update endpoint<\/li>\n<\/ol>\n\n

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

                    \n
                  1. Token expiration endpoint<\/li>\n<\/ol>\n\n

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

                      \n
                    1. Personal shopper balance endpoint<\/li>\n<\/ol>\n\n

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

                        \n
                      1. Promo code management endpoints<\/li>\n<\/ol>\n\n

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

                          \n
                        1. Order processing endpoint<\/li>\n<\/ol>\n\n

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

                            \n
                          1. Authentication endpoint<\/li>\n<\/ol>\n\n

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

                            Credits<\/h3>\n\n

                            Developed by Topomer.<\/p>\n\n\n

                            Install from WordPress Admin<\/h4>\n\n
                              \n
                            1. In WordPress admin, go to Plugins > Add New.<\/li>\n
                            2. Search for \"Topomer\".<\/li>\n
                            3. Click Install Now.<\/li>\n
                            4. Click Activate.<\/li>\n<\/ol>\n\n

                              Manual Install (ZIP)<\/h4>\n\n
                                \n
                              1. Download the plugin ZIP.<\/li>\n
                              2. In WordPress admin, go to Plugins > Add New > Upload Plugin.<\/li>\n
                              3. Upload the ZIP file and click Install Now.<\/li>\n
                              4. Activate the plugin.<\/li>\n<\/ol>\n\n\n
                                \n

                                Does this plugin require WooCommerce?<\/h3><\/dt>\n

                                Yes. WooCommerce must be installed and active.<\/p><\/dd>\n

                                How are automatic promo codes generated?<\/h3><\/dt>\n

                                Promo rules are applied dynamically using cart total and price intervals from Topomer APIs.<\/p><\/dd>\n

                                How does Topomer payment appear at checkout?<\/h3><\/dt>\n

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

                                What if the user balance is not enough?<\/h3><\/dt>\n

                                The payment is rejected and the customer is notified about the insufficient amount.<\/p><\/dd>\n\n<\/dl>\n\n\n

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

                                  1.0<\/h4>\n\n
                                    \n
                                  • Initial release<\/li>\n
                                  • Automatic promo code generation<\/li>\n
                                  • Manual promo management<\/li>\n
                                  • WooCommerce integration<\/li>\n
                                  • Topomer payment method<\/li>\n
                                  • Token verification via API<\/li>\n
                                  • Dynamic discount calculation<\/li>\n
                                  • Balance synchronization after payment<\/li>\n<\/ul>","raw_excerpt":"Manage automatic and manual promo codes for WooCommerce, with Topomer balance payment support.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/279130","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=279130"}],"author":[{"embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/gofranjemai"}],"wp:attachment":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=279130"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=279130"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=279130"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=279130"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=279130"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=279130"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}