Discourse Affiliate

[Discourse]

	Summary	Discourse Affiliate Allows the creation of Amazon affiliate links, and can help you monetize your Discourse forum. When users create links and other users click through those links and buy products from Amazon (or another supported affiliate), they earn referral fees.
	Repository Link	https://github.com/discourse/discourse-affiliate
	Install Guide	How to install plugins in Discourse

As this is an official plugin maintained by the Discourse team, support, bug, ux, and feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started.

 Support  Bug  UX  Feature

Features

List

Amazon.co.uk Associates Program
Amazon.co.uk

Amazon.de Associates Program
Amazon.de

Amazon.fr Associates Program
Amazon.fr

Amazon.it Associates Program
https://programma-affiliazione.amazon.it/

Amazon.ca Associates Program
Amazon.ca

Amazon.co.jp Associates Program
アソシエイト・セントラル

Amazon.es Associates Program
https://afiliados.amazon.es/

Amazon.in Associates Program
https://affiliate-program.amazon.in/gp/associates/apply/main.html

Amazon.br Associates Program
https://associados.amazon.com.br/

Amazon.com.mx Associates Program
https://afiliados.amazon.com.mx/

Amazon.cn Associates Program
亚马逊 登录

Sign up and read more about the Amazon Associates program at https://affiliate-program.amazon.com/

Configuration

This plugin strips out all referral links in posts and replaces them with your Amazon Associates ID or other supported affiliate ID.

This change will only affect new and future posts. To have the change affect all existing posts, you will need to do a full post rebake once you set your affiliate ID.

If you set the Site Setting affiliate amazon com to say sams-shop, when people link ANYTHING from amazon.com the plugin will auto append tag=sams-shop and strip out all the existing referral links.

So for example:

https://www.amazon.com/Dragon-Quest-Echoes-Elusive-Age-PlayStation/dp/B07BP3J6RG/

Will be auto converted to:

https://www.amazon.com/Dragon-Quest-Echoes-Elusive-Age-PlayStation/dp/B07BP3J6RG/ref=br_asw_pdt-5?tag=sams-shop

Site Settings

• affiliate enabled: Enable the Affiliate plugin.
  If you change this, you must rebake all posts with: rake posts:rebake.

• affiliate amazon com: Your amazon.com (United States) Associates ID. The links will be transformed only for all amazon.ca links using the value entered here.

You will see many more settings such as affiliate amazon co jp, affiliate amazon com au, affiliate amazon ca, enter your Associate ID depending on which country programs you have registered for.

Run Tests

Run bundle exec rake plugin:spec["discourse-affiliate"]

CHANGELOG

TODO

Extras

• Can be paired with (Obsolete) Use Amazon OneLink to make affiliated links on global forums much easier for global sites using Amazon affiliate links.

• This plugin also has support for the French site ldlc.com at Affiliation Groupe LDLC which can be configured via affiliate ldlc com: Your ldlc.com Affiliate ID (without the #).

Last edited by @JammyDodger 2024-06-18T15:16:54Z

Check document

Perform check on document:

[Richie (Richie Rich)]

Is it possible to add support for amzn.eu links to this?

Eg:

https://amzn.eu/d/4c3852b

Currently redirects to:

https://www.amazon.co.uk/dp/B0CXJ9GM3G?ref_=cm_sw_r_cso_cp_apin_dp_CDAMFS1FPQXBQEWSKWVE&starsLeft=1

It should be converted to something along the lines of:

https://www.amazon.com/dp/B0CXJ9GM3G/?tag=sams-shop

[PeakProsperity (Aaron McKeon)]

I recently installed this plugin on our site and it works great for new posts, but running the rake posts:rebake command did not cause historical posts to have their Amazon links updated. Is there some common mistake that my team may be making? What I find odd is that the output he received after running the command mentions a different plugin:

Plugin name is 'GroupInvitation', but plugin directory is named 'group-invitation'
Rebaking post markdown for 'default'
414610 / 414610 (100.0%)e
414610 posts done!

Thanks for any additional guidance you can offer.

[HeyAgain]

Hi, did you manage to get this working?

[zuker (Matías)]

Im getting about.json does not exists or not valid error when trying to install

[Moin]

How are you trying to install?

Usually that error is shown when you try to install a Plugin like you would install a Theme or Theme component. Did you follow the instructions in the install guide linked in the first post?

@Discourse

	Install Guide	How to install plugins in Discourse

[zuker (Matías)]

Sorry my mistake! Thanks

[mediaex]

Hello, I’m using the Discourse Affiliate plugin and have Amazon OneLink enabled for my affiliate ID XXXXXX-20. Since OneLink automatically redirects users to their local Amazon stores, should I enter my affiliate ID only for affiliate amazon com (USA), or do I need to add it for each country separately?

Thanks for your help!

More info about OneLink

https://affiliate-program.amazon.com/resource-center/onelink-launch