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

From Joomla! Documentation

(Added headings to the article.)
Line 1: Line 1:
PayPal, Google, and other sites often provide HTML code that you can use to insert links into your website. 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 this type of HTML code. So if you try to paste in some types of HTML code using this editor, it will not work, since the editor will remove the code when you save the Article or Module.
+
PayPal, Google and other sites often provide HTML code that you can use to insert links into your Website.
 
+
== HTML Editor Pitfalls ==
To avoid this problem, do these steps:
+
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.
#Go to the User Manager and change the User Editor to "No editor".
+
=== TinyMCE Editor Solution ===
 +
To avoid this problem while using the TinyMCE editor:
 +
#Go to the User Manager and change the User Editor to ''No editor''.
 
#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 (or your normal editor).
+
#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 ===
Alternatively, do these steps:
 
 
#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 Tiny. You may also need to change the default editor for certain users, but likely not with Joomla 1.5.
+
#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 should change the box to allow you to input HTML code instead of WYSIWYG text.
 
#Paste the desired HTML code.  
 
#Paste the desired HTML code.  
#From my experience when you navigate back to the article or module in the back end it will already be set to HTML input, meaning the code will not get garbled. This is a bit 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 ==
Also, the PayPal code includes an e-mail address for your site. Joomla! has a Plugin called "Content - Email Cloaking" that attempts to disguise e-mails 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 check icon in the Enabled column to disable it.
+
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 [[How_do_you_put_a_module_inside_an_article%3F|{loadposition myposition}]] command.
 
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 [[How_do_you_put_a_module_inside_an_article%3F|{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.
+
Plugins are not processed in modules, so should you use a Custom HTML module, you will still be able to have email cloaking enabled.
  
 
[[Category:FAQ]]
 
[[Category:FAQ]]
 
[[Category:Administration FAQ]]
 
[[Category:Administration FAQ]]
 
[[Category:Version 1.5 FAQ]]
 
[[Category:Version 1.5 FAQ]]

Revision as of 18:51, 16 March 2010

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

HTML Editor Pitfalls[edit]

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[edit]

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[edit]

  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[edit]

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.