Actions

Difference between revisions of "How do you add a PayPal button?"

From Joomla! Documentation

(Moved one paragraph from the email cloaking section to the top of the article.)
m (Minor wording changes.)
Line 7: Line 7:
  
 
== HTML Editor Pitfalls ==
 
== 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.
+
You can insert this type of HTML code, including forms, either inside an Article or in 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 ===
 
=== TinyMCE Editor Solution ===
 
To avoid this problem while using the TinyMCE editor:
 
To avoid this problem while using the TinyMCE editor:
Line 13: Line 13:
 
#Go to the article or Custom HTML module and paste in the desired HTML code.
 
#Go to the article or Custom HTML module and paste in the desired HTML code.
 
#Go back to the User Manager and change the User Editor back to TinyMCE.
 
#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).
 
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 ===
 
=== JCE Editor Solution ===
 
#Install the JCE editor from here: http://extensions.joomla.org/component/option,com_mtree/task,viewlink/link_id,88/Itemid,35/
 
#Install the JCE editor from here: http://extensions.joomla.org/component/option,com_mtree/task,viewlink/link_id,88/Itemid,35/
 
#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.
 
#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.
#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.
+
#Go to the article or Custom HTML module and hit the ''show/hide'' button, which will change the edit box to allow you to input HTML code instead of WYSIWYG text.
#Paste the desired HTML code.  
+
#Paste the HTML code into the editor.
 
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.
 
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 ==
 
== Email Cloaking Pitfalls ==
Line 29: Line 28:
 
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.
 
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 ===
+
=== Secure Merchant Account 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.
+
PayPal offers a Secure Merchant Account 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 the extra-cost plans. Email cloaking does not affect the Secure Merchant Account ID.
  
 
[[Category:FAQ]]
 
[[Category:FAQ]]
 
[[Category:Administration FAQ]]
 
[[Category:Administration FAQ]]
 
[[Category:Version 1.5 FAQ]]
 
[[Category:Version 1.5 FAQ]]

Revision as of 19:57, 26 April 2010

PayPal, Google Checkout and other ecommerce sites often provide HTML code that you can use to insert links such as Add to Cart and Buy Now buttons into your Website.

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.

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 in 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 will change the edit box to allow you to input HTML code instead of WYSIWYG text.
  4. Paste the HTML code into the editor.

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.

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 Account ID in Place of the Email Address

PayPal offers a Secure Merchant Account 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 the extra-cost plans. Email cloaking does not affect the Secure Merchant Account ID.