Changeset 3494551
- Timestamp:
- 03/30/2026 11:52:58 AM (4 days ago)
- File:
-
- 1 edited
-
affloc/trunk/readme.txt (modified) (2 diffs)
Legend:
- Unmodified
- Added
- Removed
-
affloc/trunk/readme.txt
r3494502 r3494551 1 === AffLoc — Affiliate Link Localization ===1 === AffLoc — Affiliate Link Localization for Amazon & More === 2 2 Contributors: affloc 3 Tags: a ffiliate, localization, geotargeting, links, redirects3 Tags: amazon affiliate, affiliate links, geo targeting, link localization, affiliate marketing 4 4 Requires at least: 6.0 5 5 Tested up to: 6.9 … … 8 8 License URI: https://www.gnu.org/licenses/gpl-2.0.html 9 9 10 Stop losing affiliate commissions to international visitors. AffLoc auto-detects country and swaps links instantly.10 Stop losing affiliate commissions from UK, Canada, and 190+ countries. Auto-redirect affiliate links by visitor country — no coding required. 11 11 12 12 == Description == 13 13 14 AffLoc is a lightweight, cache-friendly WordPress plugin designed to help you maximize your affiliate revenue globally. It automatically detects your visitor's country via IP and swaps out your affiliate links to match their regional store (e.g., Amazon US vs Amazon UK), ensuring you never lose a commission due to a "Not Available in Your Country" error.14 **Are your Amazon affiliate links not working for international visitors?** If you have traffic from the UK, Canada, Australia, Germany or other countries, you're likely losing a large chunk of your affiliate commissions every day. 15 15 16 = Features = 17 * **Automatic Geolocation:** Detects visitor country securely and accurately. 18 * **Country-Specific Links:** Assign different URLs for the same offer based on the user's country code. 19 * **Cache-Friendly:** Uses a hybrid JavaScript approach so it works perfectly with caching plugins (WP Rocket, W3 Total Cache, etc.). 20 * **Global Fallback:** Define a default link for countries without a specific mapping. 21 * **Easy Shortcodes:** Simply use `[affloc_link slug="your-offer"]` and let the plugin handle the rest. 16 **AffLoc fixes this automatically.** It detects each visitor's country and instantly swaps your affiliate link to the correct regional store — Amazon UK, Amazon CA, Amazon DE, and 190+ countries. One shortcode. No coding. No per-click fees. 17 18 = Why You're Losing Money Right Now = 19 20 When a UK visitor clicks your Amazon US affiliate link, they get redirected to Amazon UK — but **without your affiliate tag**. You get zero commission. The same happens for Canada, Australia, Germany, France, and every other country. 21 22 International traffic can account for 20–40% of a blog's total visitors. Without geo-targeting, all of that traffic earns you nothing. 23 24 = How AffLoc Solves It = 25 26 1. Visitor arrives on your page 27 2. AffLoc detects their country (via IP, cached in browser) 28 3. The affiliate link instantly swaps to your regional URL 29 4. Visitor clicks — **you earn the commission** 30 31 It's the simplest geo-targeting affiliate plugin for WordPress. 32 33 = Key Features = 34 35 * **Automatic Country Detection** — Detects visitor country accurately via HTTPS geolocation. Cached in the browser to minimize API calls. 36 * **Unlimited Countries** — Set country-specific links for all 190+ countries. Assign Amazon US, UK, CA, AU, DE, FR, ES, IT, JP, and any other regional store. 37 * **Global Fallback Link** — A default URL for countries without a specific mapping, so no visitor ever lands on a dead link. 38 * **Cache-Friendly** — Uses a client-side JavaScript approach. Works perfectly with WP Rocket, W3 Total Cache, LiteSpeed Cache, and all major caching plugins. 39 * **One Shortcode** — `[affloc_link slug="your-offer" text="Buy Now"]` is all you need. Works in posts, pages, widgets, and the block editor. 40 * **Lightweight** — No bloat. Scripts only load on pages that use the shortcode. 41 * **Import / Export** — Manage all your link mappings easily. Migrate between sites in seconds. 42 43 = AffLoc vs Amazon OneLink = 44 45 Amazon's free OneLink tool only works if you're enrolled in multiple Amazon Associates programs. Setting it up requires separate accounts for each country. AffLoc works with **any affiliate program** — not just Amazon — and requires zero extra registrations. 46 47 = AffLoc vs Geniuslink = 48 49 Geniuslink charges per click (starts at $9/month for 2,000 clicks). AffLoc is a flat $29/year — no per-click fees, no limits. For WordPress bloggers, AffLoc is the smarter choice. 50 51 = AffLoc vs ThirstyAffiliates Geo Targeting = 52 53 ThirstyAffiliates geo-targeting requires MaxMind database setup. AffLoc works out of the box — no database downloads, no configuration, no cron jobs. 54 55 = Perfect For = 56 57 * **Amazon Associates** who want to earn commissions from UK, Canada, Australia, Germany and beyond 58 * **Travel bloggers** linking to regional booking and gear stores 59 * **Finance bloggers** with international readers 60 * **Niche site owners** targeting multiple countries 61 * Anyone tired of losing affiliate revenue from international traffic 62 63 = How to Set Up Amazon Affiliate Links for Multiple Countries = 64 65 1. Install AffLoc from the WordPress plugin directory 66 2. Go to **AffLoc** in your WP admin menu 67 3. Add a mapping: enter your offer slug (e.g. `laptop`), select country `US`, paste your Amazon US affiliate link 68 4. Add another mapping: same slug `laptop`, country `UK`, paste your Amazon UK affiliate link 69 5. Repeat for CA, AU, DE, or any other country 70 6. Add a fallback link for all other countries 71 7. Use `[affloc_link slug="laptop" text="Buy on Amazon"]` in your post 72 73 That's it. Your readers automatically land on the right regional store. 22 74 23 75 == Installation == 24 76 25 77 1. Upload the plugin files to the `/wp-content/plugins/affloc` directory, or install the plugin through the WordPress plugins screen directly. 26 2. Activate the plugin through the 'Plugins'screen in WordPress.78 2. Activate the plugin through the **Plugins** screen in WordPress. 27 79 3. Navigate to **AffLoc** in your WordPress admin menu. 28 4. Add your first mapping (e.g., `slug: amazon`, `country: US`, `url: https://amazon.com/...`).80 4. Add your first mapping: enter a slug (e.g. `amazon`), select a country, and paste your affiliate URL. 29 81 5. Use the shortcode `[affloc_link slug="amazon" text="Buy Now"]` in your posts or pages. 30 82 31 83 == External Services == 84 32 85 This plugin relies on the following external services to function: 33 1. **ipapi.co** - Used to detect the visitor's country securely over HTTPS by resolving their IP address. Their privacy policy is available at [https://ipapi.co/privacy/](https://ipapi.co/privacy/). No personal data other than the user's IP address and proxy headers is transmitted. 34 2. **flagcdn.com** - Used to deliver fast and reliable SVG/PNG country flag icons inside the WordPress Admin Dashboard. 86 87 1. **ipapi.co** — Used to detect the visitor's country via HTTPS by resolving their IP address. Privacy policy: [https://ipapi.co/privacy/](https://ipapi.co/privacy/). No personal data other than the visitor's IP address is transmitted. 88 2. **flagcdn.com** — Used to deliver country flag icons in the WordPress Admin Dashboard. 35 89 36 90 == Screenshots == 37 91 38 1. The **AffLoc admin page** featuring the **Add New Mapping** form (Offer Slug, Country search, Affiliate text and URL fields) alongside the sidebar with **White-label Shortcode (Pro)**, **Shortcode Helper**, and **Import / Export Mappings** tools. 39 2. The **Existing Mappings** table — all mappings grouped by slug/project, showing country flags, destination URLs, ready-to-copy shortcodes with a "Copy Shortcode" button, creation date, and Edit/Delete row actions. 40 3. Inserting the shortcode into a page using the WordPress block editor (Gutenberg) — add a standard **Shortcode** block and paste `[affloc_link slug="your-slug" text="Buy Now"]`. 41 4. The rendered result on the front end — a geo-localised **"Buy Now"** affiliate link automatically swapped to the correct regional URL based on the visitor's country. 92 1. The **AffLoc admin page** — Add New Mapping form with Offer Slug, Country search, Affiliate Text and URL fields. Sidebar includes the Shortcode Helper and Import/Export tools. 93 2. The **Existing Mappings** table — all mappings grouped by slug, showing country flags, destination URLs, and ready-to-copy shortcodes. 94 3. Inserting the shortcode in the WordPress block editor (Gutenberg) — add a Shortcode block and paste `[affloc_link slug="your-slug" text="Buy Now"]`. 95 4. The front-end result — a geo-localized "Buy Now" button automatically swapped to the correct regional affiliate URL based on the visitor's country. 96 97 == Frequently Asked Questions == 98 99 = Are my Amazon affiliate links not working for international visitors? = 100 101 Yes — this is the most common affiliate revenue leak. When a UK or Canadian visitor clicks your Amazon US link, they get redirected to their local Amazon store but **your affiliate tag is stripped**. AffLoc fixes this by automatically serving country-specific links so every visitor lands on the correct regional store with your tag intact. 102 103 = How much money am I losing from international traffic? = 104 105 It depends on your traffic split. If 30% of your visitors come from the UK, Canada, and Australia — and your average EPC (earnings per click) is $0.10 — you're losing roughly $0.03 per click from those visitors. For a site with 50,000 monthly clicks, that's $1,500/month in missed commissions. 106 107 = Does AffLoc work with caching plugins? = 108 109 Yes. The link substitution happens in the visitor's browser (client-side JavaScript), so your pages remain fully cacheable. AffLoc is compatible with WP Rocket, W3 Total Cache, LiteSpeed Cache, Cloudflare, and all major caching solutions. 110 111 = Which countries are supported? = 112 113 All 190+ countries with ISO country codes. You can set unique affiliate links for any country — Amazon US, UK, CA, AU, DE, FR, ES, IT, JP, IN, BR, and more. 114 115 = Does it work with affiliate programs other than Amazon? = 116 117 Yes. AffLoc works with any affiliate program — just paste any URL as the destination link for each country. Use it for Booking.com regional links, eBay affiliate links, Etsy, or any program with regional stores. 118 119 = Is it compatible with the block editor (Gutenberg)? = 120 121 Yes. Use the standard Shortcode block in Gutenberg and paste your `[affloc_link]` shortcode. 122 123 = What happens if my visitor's country doesn't have a specific link? = 124 125 AffLoc falls back to the default URL you set for that offer, so no visitor ever sees a broken or missing link. 126 127 = How is this different from Amazon OneLink? = 128 129 Amazon OneLink only works for Amazon affiliate programs and requires you to join the Amazon Associates program in each target country separately. AffLoc works with **any affiliate link**, requires no external account registrations, and runs entirely within your WordPress site. 130 131 = How is AffLoc different from Geniuslink? = 132 133 Geniuslink charges per click ($9+/month). AffLoc is a flat annual fee with no per-click charges — making it far more economical for WordPress bloggers with high traffic volumes. 134 135 = How is AffLoc different from ThirstyAffiliates geo-targeting? = 136 137 ThirstyAffiliates' geo-targeting feature requires downloading and configuring the MaxMind GeoIP database. AffLoc uses a lightweight API and works out of the box with zero configuration. 42 138 43 139 == Upgrade Notice == 44 140 45 141 = 0.2.0 = 46 Major release introducing Free version usage limit ations, new "Affiliate Text" field, improved Admin UI responsiveness, and WP.org code compliance improvements.142 Major release introducing Free version usage limits, new "Affiliate Text" field, improved Admin UI responsiveness, and WordPress.org code compliance improvements. 47 143 48 144 = 0.1.5 = 49 145 Important security update adding strict IP validation and full HTTPS geolocation API support. 50 146 51 == Frequently Asked Questions ==52 53 = Does it work with caching plugins? =54 Yes! The substitution happens on the client side (in the browser), meaning your pages remain fully cacheable.55 56 = Which IP geolocation service is used? =57 We use the free ipapi.co service with a secure HTTPS connection. The plugin also caches the location in the user's browser to minimize API calls and speed up link swapping.58 59 147 == Changelog == 60 148 61 149 = 0.2.0 = 62 * Features: Added maximum mapping limit and Affiliate Text shortcode support. 150 * Feature: Added maximum mapping limit for Free plan. 151 * Feature: Added Affiliate Text field support in shortcode. 63 152 * Refactoring: Conformed strictly to WordPress Database APIs for SQL queries. 64 153 65 154 = 0.1.5 = 66 * Enhancement s: Added copy-to-clipboard functionality for shortcodes.67 * Enhancement s: Admin UI improvements including country flags, grouping, searching, date sorting, and row actions.155 * Enhancement: Added copy-to-clipboard functionality for shortcodes. 156 * Enhancement: Admin UI improvements — country flags, grouping, search, date sorting, and row actions. 68 157 * Security: Switched to secure HTTPS endpoints for IP geolocation. 69 * Security: Added comprehensive IP validation including support for Cloudflare/Proxies.70 * Performance: Frontend scripts now only loadon pages containing the shortcode.158 * Security: Added comprehensive IP validation including Cloudflare/proxy support. 159 * Performance: Frontend scripts now load only on pages containing the shortcode. 71 160 72 161 = 0.1.0 = 73 * Initial Beta release. 162 * Initial Beta release.
Note: See TracChangeset
for help on using the changeset viewer.