Actions

How do you add a PayPal button?

From Joomla! Documentation

Revision as of 20:43, 16 March 2010 by Cmb (Talk | contribs)

PayPal, Google and other sites often provide HTML code that you can use to insert links into your Website.

Contents

PayPal Technical Documentation

Specifications and examples of the HTML code are shown in the PayPal Website Payments Standard Integration Guide (in PDF format).

HTML Editor Pitfalls

You can insert this type of HTML code, including forms, either inside an Article or using a Custom HTML Module. However, the TinyMCE editor will normally strip out HTML code. If you try to paste in some types of HTML code using this editor, it will not work; the editor will remove the code when you save the Article or Module.

TinyMCE Editor Solution

To avoid this problem while using the TinyMCE editor:

  1. Go to the User Manager and change the User Editor to No editor.
  2. Go to the article or Custom HTML module and paste in the desired HTML code.
  3. Go back to the User Manager and change the User Editor back to TinyMCE.

Note that you will need to repeat this any time you want to edit the code (unless you use the alternate solution below).

JCE Editor Solution

  1. Install the JCE editor from here: http://extensions.joomla.org/component/option,com_mtree/task,viewlink/link_id,88/Itemid,35/
  2. Change the default editor (Global Configuration > Site > Default WYSIWYG Editor) to JCE from TinyMCE. You may also need to change the default editor for other users.
  3. Go to the article or Custom HTML module and hit the show/hide button, which should change the box to allow you to input HTML code instead of WYSIWYG text.
  4. Paste the desired HTML code.

When you navigate back to the article or module in the back end, it will already be set to HTML input; the code will not get garbled. This is easier than having to change the user settings each time you want to edit the code while you are testing different button settings.

Email Cloaking Pitfalls

The PayPal code includes an email address for your Website. Joomla! has a Plugin called Content - Email Cloaking that attempts to disguise emails in Articles. If you wish to paste the PayPal code directly inside an Article, you may need to disable this Plugin. Navigate to Extensions / Plugins, find the Plugin Content - Email Cloaking and click the green checkbox in the Enabled column to disable it.

It is generally preferable to create a Custom HTML module instead of just pasting the code into an article. This way you can put the link in a module position on as many page as you like. You can also put the module inside an article using the {loadposition myposition} command.

Plugins are not processed in modules, so should you use a Custom HTML module, you will still be able to have email cloaking enabled.

Article-Specific Email Cloaking Switch

You can disable email cloaking in an article by entering {emailcloak=off} anywhere in the article before the email address. With this control, you do not need to disable global email cloaking.

Secure Merchant ID in Place of the Email Address

PayPal offers Secure Merchant ID (an alphanumeric string used in place of the merchant email address) at no cost. It is available for Web Payments Standard customers as well as in extra-cost plans. Email cloaking does not affect the Secure Merchant ID.