{"id":250816,"date":"2025-09-04T13:38:23","date_gmt":"2025-09-04T13:38:23","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/marbl-affiliate-links\/"},"modified":"2025-09-04T13:37:58","modified_gmt":"2025-09-04T13:37:58","slug":"marbl","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/marbl\/","author":23361376,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"0.9.23","stable_tag":"0.9.23","tested":"6.8.5","requires":"4.7","requires_php":"7.0","requires_plugins":null,"header_name":"Marbl","header_author":"C:Amie","header_description":"Embeds a Multi-region Affiliate & Referral Buyers Link (Marbl) for Amazon and eBay. Embed a drop-list buyer link into the page at any point the shortcode is added. Page can include, none, 1 or 1000 different shortcodes. Written in pure JavaScript, with no external dependencies, tracking, privacy issues and no geo-location guesttimation - the user selects their preffered store from your Amazon Associates or eBay Partners list.","assets_banners_color":"e0dcdb","last_updated":"2025-09-04 13:37:58","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/www.c-amie.co.uk\/","header_plugin_uri":"http:\/\/www.c-amie.co.uk\/marbl","header_author_uri":"http:\/\/www.c-amie.co.uk\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":243,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.9.23":{"tag":"0.9.23","author":"camieuk","date":"2025-09-04 13:37:58"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3356133,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3356133,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.9.23"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3356129,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3356129,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3356129,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3356129,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3356129,"resolution":"5","location":"assets","locale":""}},"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"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[369,209,1706,537,377],"plugin_category":[35],"plugin_contributors":[247412],"plugin_business_model":[],"class_list":["post-250816","plugin","type-plugin","status-publish","hentry","plugin_tags-affiliate","plugin_tags-amazon","plugin_tags-ebay","plugin_tags-link","plugin_tags-monetization","plugin_category-advertising","plugin_contributors-camieuk","plugin_committers-camieuk"],"banners":{"banner":"https:\/\/ps.w.org\/marbl\/assets\/banner-772x250.png?rev=3356133","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/marbl\/assets\/icon-256x256.png?rev=3356133","icon_2x":"https:\/\/ps.w.org\/marbl\/assets\/icon-256x256.png?rev=3356133","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/marbl\/assets\/screenshot-1.png?rev=3356129","caption":"Sample page body showing an expanded Amazon Associates link"},{"src":"https:\/\/ps.w.org\/marbl\/assets\/screenshot-2.png?rev=3356129","caption":"Sample page body showing an expanded eBay Partnet Network link"},{"src":"https:\/\/ps.w.org\/marbl\/assets\/screenshot-3.png?rev=3356129","caption":"Marbl General settings"},{"src":"https:\/\/ps.w.org\/marbl\/assets\/screenshot-4.png?rev=3356129","caption":"Marbl Amazon Associates Settings"},{"src":"https:\/\/ps.w.org\/marbl\/assets\/screenshot-5.png?rev=3356129","caption":"eBay Partner Network (EPN) Settings"}],"raw_content":"<!--section=description-->\n<p>The <code>Multi-region Affiliate &amp; Referral Buyers Link<\/code> plugin, or Marbl is a simple plugin designed to allow a single affiliate\nlink to be present the browser with a list of national flags so that they can select their own home marketplace and be\nredirected towards the correct affiliate site and language without relying on external tools.<\/p>\n\n<p>The plugin features include:<\/p>\n\n<ul>\n<li>Supports Amazon Affiliates and eBay Partner Networks (EPN)<\/li>\n<li>Allows affiliate schemes between the two in the following geographic locations, each with their own scheme ID:\n\n<ul>\n<li>Austria<\/li>\n<li>Australia<\/li>\n<li>Belgium<\/li>\n<li>Brazil<\/li>\n<li>Canada<\/li>\n<li>China<\/li>\n<li>France<\/li>\n<li>Germany<\/li>\n<li>Ireland<\/li>\n<li>India<\/li>\n<li>Italy<\/li>\n<li>Japan<\/li>\n<li>Mexico<\/li>\n<li>Netherlands<\/li>\n<li>Poland<\/li>\n<li>Saudi Arabia<\/li>\n<li>Singapore<\/li>\n<li>Spain<\/li>\n<li>Sweden<\/li>\n<li>Switzerland<\/li>\n<li>United Arab Emirates<\/li>\n<li>United Kingdom<\/li>\n<li>United States<\/li>\n<\/ul><\/li>\n<li>A full shortcode API<\/li>\n<li>A full JavaScript API for inclusion on pages outside of WordPress<\/li>\n<li>NO telemetry<\/li>\n<li>NO tracking<\/li>\n<li>NO redirecting of your affiliate scheme links EVER<\/li>\n<li>Customisable CSS\/national flag images via the specification of a custom resources folder<\/li>\n<\/ul>\n\n<p>For examples and the full documentation please visit https:\/\/www.c-amie.co.uk\/marbl\/<\/p>\n\n<p>To view the source code please visit https:\/\/github.com\/c-amie\/marbl<\/p>\n\n<!--section=installation-->\n<h4>To install Marbl<\/h4>\n\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/marbl<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress<\/li>\n<li>Use the Settings, 'Marbl Links for Amazon &amp; eBay' screen to configure the plugin<\/li>\n<li>Configure the 'General Settings' section as required<\/li>\n<\/ol>\n\n<h4>To enable Shortcodes for Amazon Links<\/h4>\n\n<ol>\n<li>Open Settings, 'Marbl Links for Amazon &amp; eBay' screen<\/li>\n<li>Select the 'Amazon Settings' button<\/li>\n<li>Select 'yes' next to 'Enable Marbl for Amazon'<\/li>\n<li>Click 'Save Changes'<\/li>\n<li>Enter at least one global Amazon Associates ID into its respective country textbox<\/li>\n<li>Click 'Save Changes'<\/li>\n<\/ol>\n\n<h4>To enable Shortcodes for eBay Links<\/h4>\n\n<ol>\n<li>Open Settings, 'Marbl Links for Amazon &amp; eBay' screen<\/li>\n<li>Select the 'eBay Settings' button<\/li>\n<li>Select 'yes' next to 'Enable Marbl for eBay'<\/li>\n<li>Click 'Save Changes'<\/li>\n<li>Enter your eBay Partner ID<\/li>\n<li>Enter your Default Campaign ID<\/li>\n<li>Enable at least one global eBay region from the list<\/li>\n<li>Click 'Save Changes'<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='how%20do%20i%20obtain%20an%20amazon%20affiliates%20id%3F'><h3>How do I obtain an Amazon Affiliates ID?<\/h3><\/dt>\n<dd><p>Head to https:\/\/affiliate-program.amazon.com\/ and select the regional Amazon programme that you would like to sign up with.<\/p><\/dd>\n<dt id='how%20do%20i%20obtain%20an%20ebay%20partner%20network%20id%3F'><h3>How do I obtain an eBay Partner Network ID?<\/h3><\/dt>\n<dd><p>Head to https:\/\/epn.ebay.com and sign-up for your regional programme.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.9.23.20250904<\/h4>\n\n<ul>\n<li>Corrected default 16x16 alignment in the sample CSS<\/li>\n<li>[WordPress] Fixed skipped config removals from the database in the uninstall command due to syntax error<\/li>\n<li>[WordPress] Switched plugin self location definition from using WP_PLUGIN_URL to plugin_dir_url()<\/li>\n<li>[WordPress] Added list of legal county codes to the admin documentation sections for both eBay and Amazon<\/li>\n<li>[JavaScript] Removed hard-coded CSS floats<\/li>\n<\/ul>\n\n<h4>0.9.22.20250903<\/h4>\n\n<ul>\n<li>[WordPress] Changed minimum PHP version to 7.0<\/li>\n<li>[WordPress] Removed calls to deprecated utf8_encode()<\/li>\n<li>[WordPress] Removed sanitisation calls that used json_encode()<\/li>\n<li>[WordPress] Added if ( ! defined( 'ABSPATH' ) ) exit; \/\/ Exit if accessed directly<\/li>\n<li>[WordPress] Renamed main WordPress file marbl.php -&gt; marbl-affiliate-links.php<\/li>\n<\/ul>\n\n<h4>0.9.21.20250901<\/h4>\n\n<ul>\n<li>[WordPress] Simplified sanitation for WordPress code review<\/li>\n<li>[WordPress] Fixed non-functional donate button<\/li>\n<li>[WordPress] Code simplifications<\/li>\n<li>[WordPress] Added versioning to WordPress resource calls<\/li>\n<li>Updated readme.txt for WordPress publishing<\/li>\n<\/ul>\n\n<h4>0.9.20.20240418<\/h4>\n\n<ul>\n<li>[JavaScript] rel=\"nofollow\" now writes \"rel=\"nofollow sponsored\"<\/li>\n<\/ul>\n\n<h4>0.9.19.20240407<\/h4>\n\n<ul>\n<li>[JavaScript] Added .DisclaimerText and .DisclaimerPosition fields to both Amazon and eBay types<\/li>\n<li>[JavaScript] Added .TOP and .BOTTOM static fields to set the disclaimer position<\/li>\n<li>[JavaScript] Added .setDisclaimer(position, text) function to both Amazon and eBay types<\/li>\n<li>[WordPress] Added Enable\/Disable disclaimer text fields for all sponsored link types<\/li>\n<li>[WordPress] Added fields to set disclaimer text and set the top\/bottom position for all sponsored link types<\/li>\n<\/ul>\n\n<h4>0.9.18.20240305<\/h4>\n\n<ul>\n<li>[JavaScript] Added this.RegionsList list to the eBay class to allow 'ALL' to be fed into the .addRegions() method<\/li>\n<\/ul>\n\n<h4>0.9.17.20230807<\/h4>\n\n<ul>\n<li>Added flag images for AE, PL, SA, SE and SG<\/li>\n<li>[JavaScript] Added regional support for UAE, Belgium, Netherlands, Poland, Saudi Arabia, Sweden and Singapore<\/li>\n<li>[WordPress] Added property to lookup full country names<\/li>\n<li>[WordPress] Expanded country support for Amazon on the Amazon Associates Settings page<\/li>\n<li>[WordPress] Full country names are now displayed on the settings pages<\/li>\n<\/ul>\n\n<p>= 0.9.16.20230510\n* [JavaScript] Fixed issue with eBay URL link conversion where the URL did not include a SEO friendly product name string<\/p>\n\n<p>= 0.9.15.20221220\n* [JavaScript] Updated eBay URL syntax<\/p>\n\n<h4>0.9.14.20220523<\/h4>\n\n<ul>\n<li>[WordPress] Added eBay.pl support on the admin UI for eBay settings<\/li>\n<li>[WordPress] Fixed issue with saving eBay country visibility<\/li>\n<li>[JavaScript] Added eBay.pl support<\/li>\n<li>[JavaScript] Updated eBay URL syntax<\/li>\n<li>[JavaScript] Added GB as an eBay country code alias for United Kingdom<\/li>\n<li>[JavaScript] Ampersand characters in freetext search strings were not being URL encoded and were thus dropped as querystring demarcation characters<\/li>\n<\/ul>\n\n<h4>0.9.13.20220121<\/h4>\n\n<ul>\n<li>[JavaScript] Added rendering choice property to allow the default rendering of the Marbl link adjacent to the calling HTML  tag or alternatively into a named HTML Element (by ID)<\/li>\n<li>[JavaScript] Added INPLACE and CONTAINER ENUM<\/li>\n<li>[JavaScript] RenderMode and ContainerId properties<\/li>\n<\/ul>\n\n<h4>0.9.12.20210222<\/h4>\n\n<ul>\n<li>[JavaScript] Improved Amazon ISBN detection that was leading to corrupt derived link results<\/li>\n<li>[JavaScript] Added PrintDebug [boolean] property to allow console.log output of derived link generation decisions<\/li>\n<li>[JavaScript] Fixed an issue where legacy http:\/\/ links that contained Amazon search friendly product names in the URL would not display the friendly name<\/li>\n<li>[JavaScript] Fixed an issue where Amazon URL keyword search term friendly names would appear with + signs instead of corrected spaces<\/li>\n<\/ul>\n\n<h4>0.9.11.20210220<\/h4>\n\n<ul>\n<li>[JavaScript] Implemented new eBay Partner Network Link format<\/li>\n<li>[JavaScript] Added createDerivedLink(), createDerivedBuyLink(); to MarblEbayLink. createDerivedLink() allows an eBay URL containing a Item ID, search phrase or URL to be automatically converted into a working link<\/li>\n<li>[JavaScript] MarblAmazonLink.createDerivedLink() can now accept and will attempt to parse an Amazon URL to extract keyword and\/or ASIN\/ISBN information from the URL<\/li>\n<li>[JavaScript] Deprecated and removed eBay getRedirectorVectorId()<\/li>\n<li>[JavaScript] Deprecated and removed eBay getVectorId()<\/li>\n<li>[JavaScript] Deprecated and removed eBay PartnerId<\/li>\n<li>[JavaScript] Modularised Amazon.isAsin() and Amazon.isIsbn();<\/li>\n<li>[JavaScript] Fixed non-working Amazon ISBN link URL<\/li>\n<li>[WordPress] Removed Partner ID box from the eBay settings UI<\/li>\n<li>[WordPress] Enhanced uninstaller<\/li>\n<\/ul>\n\n<h4>0.9.10.20210130<\/h4>\n\n<ul>\n<li>[JavaScript] Link labels will always be generated for Amazon Link ASIN and ISBN values, instead of leaving a blank in the event that no manual label paramater is provided<\/li>\n<li>[JavaScript] Added createDerivedLink(), createDerivedBuyLink(); to MarblAmazonLink. createDerivedLink() allows an Amazon URL containing a ASIN or ISBN to be automatically converted into a working link<\/li>\n<\/ul>\n\n<h4>0.9.9.20210128<\/h4>\n\n<ul>\n<li>[WordPress] Improved string sanitisation processing<\/li>\n<li>[WordPress] Added macro to allow &quot; to be used to enter a quotation mark in the search or label shortcode parameters should a quote be necessary (e.g. for inches)<\/li>\n<li>[WordPress] The default region country flags were not displaying properly on the eBay Settings tab in the Setting plugin<\/li>\n<li>[JavaScript] Added HTML decode\/encode functions to allow contectual sanitisation of search and label text depending on whether it is in the affliate URL or link text<\/li>\n<li>[JavaScript] Added workaround to allow the EPN redirector to accept searches with \" marks in it without sending the user to the homepage<\/li>\n<\/ul>\n\n<h4>0.9.8.20190411<\/h4>\n\n<ul>\n<li>[JavaScript] Added MarblLink generator class with automatic repository pathintrospection<\/li>\n<li>[JavaScript] Merged MarblLink, MarblAmazonLink and MarblEbayLink into a single Marbl.js file<\/li>\n<li>[JavaScript] Added eBay Vector ID lookups internally rather than expecting them to come from external supplier lookups<\/li>\n<li>[JavaScript] createCustomBuyLink() -&gt; createLink()<\/li>\n<li>[JavaScript] Added optional CustomImagePath argument to createLink()<\/li>\n<li>[JavaScript] The behaviour of DisplayMode.IMAGE was not correctly inserting the Label into the ATL tag if one was provided<\/li>\n<\/ul>\n\n<h4>0.9.7.20190409<\/h4>\n\n<ul>\n<li>[WordPress] Improved appearance and layout of the settings UI<\/li>\n<li>[WordPress] Implemented custom CSS\/image resources path setting<\/li>\n<li>[WordPress] Added options to enable\/disable Amazon Affiliates links<\/li>\n<li>[WordPress] Added options to enable\/disable eBay Partner Network links<\/li>\n<li>[WordPress] Implemented input sanitisation and validation on all settings input objects<\/li>\n<li>[JavaScript] Added IMAGE, TEXT, BOTH enum values to the link classes<\/li>\n<\/ul>\n\n<h4>0.9.6.20190408<\/h4>\n\n<ul>\n<li>Added flag images for AT, BE, CH, IE and NL<\/li>\n<li>Added default eBay icons<\/li>\n<li>Added default eBay CSS<\/li>\n<li>[WordPress] Added administrative screen settings for eBay Partner ID<\/li>\n<li>[WordPress] Added administrative screen settings for eBay Campaign ID<\/li>\n<li>[Bug Fix] Display mode wasn't honouring the bit flag settings as intended<\/li>\n<li>[JavaScript] First release of Marbl for eBay Partner Network (EPN), with search, store and item links<\/li>\n<li>Default CSS adds a 2px pad to the bottom of the icon to keep it off of baselines<\/li>\n<li>[WordPress] Added examples of the eBay icons to the eBay settings tab<\/li>\n<li>[WordPress] Changed the Amazon sotores=\"\" attribute to regions=\"\" to align the Amazon and eBay API<\/li>\n<li>[WordPress] Added usage examples on the administrative screen for eBay<\/li>\n<\/ul>\n\n<h4>0.9.5.20190325<\/h4>\n\n<ul>\n<li>[JavaScript] Converted to Object-Orientated<\/li>\n<li>[JavaScript] Added Links for eBay Partner Network [beta]<\/li>\n<li>[WordPress] Added settings for eBay Partner Network<\/li>\n<li>[WordPress] Converted settings page into tabs<\/li>\n<li>[Wordpress] Plugin syntax changed from [marbl-amazon... to [marbl type=\"amazon\"...<\/li>\n<\/ul>\n\n<h4>0.9.4.20180626<\/h4>\n\n<ul>\n<li>[JavaScript] Added 'Link add nofollow option' with default=true to base class<\/li>\n<li>[WordPress] Added settings option to configure the Link nofollow on\/off state<\/li>\n<\/ul>\n\n<h4>0.9.3.20180605<\/h4>\n\n<ul>\n<li>[JavaScript] Added CustomImage parameter, used to override the built-in images<\/li>\n<li>[JavaScript] Converted bolLabelOnly to ENUM DisplayStyle<\/li>\n<li>[JavaScript] Added IMAGE, TEXT, BOTH emum lookup values<\/li>\n<li>[JavaScript] If label is set on an image only render, the label will be added to the image ALT text<\/li>\n<li>[JavaScript] URL encoded labels with + sings are now decoded back to spaces<\/li>\n<li>[WordPress] Added 'nclude default CSS StyleSheet' configuration option<\/li>\n<li>[WordPress] imageonly property renamed display to align with the DisplayStyle ENUM<\/li>\n<\/ul>\n\n<h4>0.9.2.20180604<\/h4>\n\n<ul>\n<li>[JavaScript] Updated plugin entry points to 'marbl-amazon' as a brand identity for 'Multi-region Affiliate &amp; Referral Buyers Link'<\/li>\n<li>[WordPress] Added usage and examples to the options page<\/li>\n<li>Added the 4 built-in Amazon icons to the options page<\/li>\n<li>[JavaScript] Renamed the base JS class to MarblAmazonLink<\/li>\n<li>[WordPress] Added WordPress uninstall<\/li>\n<li>Code pattern now available to add Marbl to PD9 Software MegaBBS 2.2<\/li>\n<\/ul>\n\n<h4>0.9.1.20180531<\/h4>\n\n<ul>\n<li>[JavaScript] Updated plugin entry points to 'abl-amazon' to comply with WordPress plugin directory naming requirements<\/li>\n<li>[JavaScript] Added support for text label linking instead of the default icon links<\/li>\n<\/ul>\n\n<h4>0.9.0.20180521<\/h4>\n\n<ul>\n<li>[WordPress] Initial WordPress plugin version as 'amazon-buyer-link'<\/li>\n<li>[WordPress] Added config page to WordPress plugin<\/li>\n<li>Added default 16x16, 24x24, 32x32 and 48x48 Amazon icons<\/li>\n<\/ul>\n\n<h4>0.1.0.20180429<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>[JavaScript] Standalone JavaScript File for www.c-amie.co.uk<\/li>\n<\/ul>","raw_excerpt":"Embeds a user-selectable multi-contry Amazon or eBay store drop-down buyer link into the page at any point the shortcode is added.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/250816","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=250816"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/camieuk"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=250816"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=250816"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=250816"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=250816"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=250816"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=250816"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}