=== Marbl === Plugin Name: Marbl Affiliate Links Plugin URI: https://www.c-amie.co.uk/marbl/ Contributors: camieuk Donate link: http://www.c-amie.co.uk/ Tags: Amazon, eBay, link, monetization, affiliate Author: C:Amie Author URI: https://www.c-amie.co.uk/ Requires at least: 4.7 Tested up to: 6.8 Stable tag: 0.9.23 Requires PHP: 7.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Embeds a user-selectable multi-contry Amazon or eBay store drop-down buyer link into the page at any point the shortcode is added. == Description == The `Multi-region Affiliate & Referral Buyers Link` plugin, or Marbl is a simple plugin designed to allow a single affiliate link to be present the browser with a list of national flags so that they can select their own home marketplace and be redirected towards the correct affiliate site and language without relying on external tools. The plugin features include: * Supports Amazon Affiliates and eBay Partner Networks (EPN) * Allows affiliate schemes between the two in the following geographic locations, each with their own scheme ID: * Austria * Australia * Belgium * Brazil * Canada * China * France * Germany * Ireland * India * Italy * Japan * Mexico * Netherlands * Poland * Saudi Arabia * Singapore * Spain * Sweden * Switzerland * United Arab Emirates * United Kingdom * United States * A full shortcode API * A full JavaScript API for inclusion on pages outside of WordPress * NO telemetry * NO tracking * NO redirecting of your affiliate scheme links EVER * Customisable CSS/national flag images via the specification of a custom resources folder For examples and the full documentation please visit https://www.c-amie.co.uk/marbl/ To view the source code please visit https://github.com/c-amie/marbl == Installation == = To install Marbl = 1. Upload the plugin files to the `/wp-content/plugins/marbl` directory, or install the plugin through the WordPress plugins screen directly. 2. Activate the plugin through the 'Plugins' screen in WordPress 3. Use the Settings, 'Marbl Links for Amazon & eBay' screen to configure the plugin 4. Configure the 'General Settings' section as required = To enable Shortcodes for Amazon Links = 1. Open Settings, 'Marbl Links for Amazon & eBay' screen 2. Select the 'Amazon Settings' button 3. Select 'yes' next to 'Enable Marbl for Amazon' 4. Click 'Save Changes' 5. Enter at least one global Amazon Associates ID into its respective country textbox 6. Click 'Save Changes' = To enable Shortcodes for eBay Links = 1. Open Settings, 'Marbl Links for Amazon & eBay' screen 2. Select the 'eBay Settings' button 3. Select 'yes' next to 'Enable Marbl for eBay' 4. Click 'Save Changes' 5. Enter your eBay Partner ID 6. Enter your Default Campaign ID 7. Enable at least one global eBay region from the list 8. Click 'Save Changes' == Frequently Asked Questions == = How do I obtain an Amazon Affiliates ID? = Head to https://affiliate-program.amazon.com/ and select the regional Amazon programme that you would like to sign up with. = How do I obtain an eBay Partner Network ID? = Head to https://epn.ebay.com and sign-up for your regional programme. == Screenshots == 1. Sample page body showing an expanded Amazon Associates link 2. Sample page body showing an expanded eBay Partnet Network link 3. Marbl General settings 4. Marbl Amazon Associates Settings 5. eBay Partner Network (EPN) Settings == Changelog == = 0.9.23.20250904 = * Corrected default 16x16 alignment in the sample CSS * [WordPress] Fixed skipped config removals from the database in the uninstall command due to syntax error * [WordPress] Switched plugin self location definition from using WP_PLUGIN_URL to plugin_dir_url() * [WordPress] Added list of legal county codes to the admin documentation sections for both eBay and Amazon * [JavaScript] Removed hard-coded CSS floats = 0.9.22.20250903 = * [WordPress] Changed minimum PHP version to 7.0 * [WordPress] Removed calls to deprecated utf8_encode() * [WordPress] Removed sanitisation calls that used json_encode() * [WordPress] Added if ( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly * [WordPress] Renamed main WordPress file marbl.php -> marbl-affiliate-links.php = 0.9.21.20250901 = * [WordPress] Simplified sanitation for WordPress code review * [WordPress] Fixed non-functional donate button * [WordPress] Code simplifications * [WordPress] Added versioning to WordPress resource calls * Updated readme.txt for WordPress publishing = 0.9.20.20240418 = * [JavaScript] rel="nofollow" now writes "rel="nofollow sponsored" = 0.9.19.20240407 = * [JavaScript] Added .DisclaimerText and .DisclaimerPosition fields to both Amazon and eBay types * [JavaScript] Added .TOP and .BOTTOM static fields to set the disclaimer position * [JavaScript] Added .setDisclaimer(position, text) function to both Amazon and eBay types * [WordPress] Added Enable/Disable disclaimer text fields for all sponsored link types * [WordPress] Added fields to set disclaimer text and set the top/bottom position for all sponsored link types = 0.9.18.20240305 = * [JavaScript] Added this.RegionsList list to the eBay class to allow 'ALL' to be fed into the .addRegions() method = 0.9.17.20230807 = * Added flag images for AE, PL, SA, SE and SG * [JavaScript] Added regional support for UAE, Belgium, Netherlands, Poland, Saudi Arabia, Sweden and Singapore * [WordPress] Added property to lookup full country names * [WordPress] Expanded country support for Amazon on the Amazon Associates Settings page * [WordPress] Full country names are now displayed on the settings pages = 0.9.16.20230510 * [JavaScript] Fixed issue with eBay URL link conversion where the URL did not include a SEO friendly product name string = 0.9.15.20221220 * [JavaScript] Updated eBay URL syntax = 0.9.14.20220523 = * [WordPress] Added eBay.pl support on the admin UI for eBay settings * [WordPress] Fixed issue with saving eBay country visibility * [JavaScript] Added eBay.pl support * [JavaScript] Updated eBay URL syntax * [JavaScript] Added GB as an eBay country code alias for United Kingdom * [JavaScript] Ampersand characters in freetext search strings were not being URL encoded and were thus dropped as querystring demarcation characters = 0.9.13.20220121 = * [JavaScript] Added rendering choice property to allow the default rendering of the Marbl link adjacent to the calling HTML