Adding iDEAL to Joomla! articles - cciDEAL Simpel

It is possible to accept iDEAL payments from within Joomla! articles with great flexibility and ease! The cciDEAL content plugin allows you to, for example, accept donations or get payments for an invoice or order.

The amount to be paid and payment ID can be fixed by you or kept "open" so the user can enter his/her preferred value. But it is also possible to use a dropdown from which the user can select an amount to be paid. To add an iDEAL form to any Joomla! article, a simple "tag" is added to the article.

That tag will be converted to a nice looking iDEAL form in your website. The below image shows what this iDEAL button might look like in your Joomla! articles:

iDEAL in Joomla! articles

 

Want to get this working without reading anything else? Scroll to the bottom for examples that you can copy/paste right into your articles!
  1. Enabling the required plugins
  2. iDEAL tag in the administrator
  3. Customizing your iDEAL form
  4. A few iDEAL tag and form examples
  5. Overzicht van betalingen
  6. FAQ: Alleen iDEAL, of ook andere betaalmethoden?

1. Enabling the required plugins

To easily work with iDEAL in your Joomla! articles, you need to enable two plugins that where installed with cciDEAL.

  1. First make sure you already installed the latest version of cciDEAL
  2. Go to Components > cciDEAL > Integrations, click "Install" next to "Content plugin" and make sure it's enabled under "Status". 
  3. Then go to Extensions > Plug-in Manager and search for "ideal" in the filter. Enable the "Editor button - iDEAL" and "Content plugin for cciDEAL Platform" plugins. 
  4. Now you can go to the Joomla! article manager and use the below manuals to add iDEAL forms to your articles. 

2. iDEAL tag in the administrator

You will now see a new iDEAL button under the editor in the Joomla! article manager, when an article is opened, as marked in the below image. When that button is clicked, the default iDEAL tag is added to the Joomla! article. That tag can be customized to fit your needs, and will generate the iDEAL form in the website. 
 
iDEAL in Joomla! article
The default iDEAL code is:
 
{ccidealplatform title="Betaal_met_iDEAL" amount_by_user amount="15.00,22.00" amount_text="Kies_bedrag:" paymentid_by_user paymentid="399" paymentid_text="Kenmerk:" extra_textfield extra_textarea extra_textfield_required extra_textarea_required extra_text="Informatie:" submit_button="Verder" }
The most minimalistic version that will work, only set an amount and cciDEAL does the rest:
 
{ccidealplatform amount="15"}

3. Customizing your iDEAL form

The above code has to be customized to your wishes before it is usable. All possibilities are explained in below table and image.
 
ideal_site_article_notes 
 
Please note that all values between braces ".." should use an underscore  _, not spaces!
You can add only one extra field per button/form, for extended forms consider our integration with RSForm Pro. So it's either extra_textfield OR extra_textarea OR extra_textfield_required OR extra_textarea_required. 
 

Type Possible values
title Title above the form, “Betaal_met_iDEAL” by default
amount

There are three options for the amount shown in the form

  • A fixed single amount can be created by adding: amount="15.00"
  • Multiple fixed amounts in a dropdown can be created by: amount="15.00,22.00"
  • An input field so a user can enter an amount can be created by: amount_by_user
amount_text The title of the amount field, “Kies_bedrag:” by default
paymentid There are a few different options for the payment ID in the form
  • To set a fixed payment ID, use the code: paymentid="399"
  • To allow the user to enter a payment ID himself, add the code: paymentid_by_user
  • If you do not set a preferred payment ID tag, cciDEAL will automatically add a randomly generated one.
This value can be removed from the tag if you don't want to show a payment ID.
paymentid_text The title of the payment id, "Kenmerk:" by default. This value can be removed from the tag if you don't want to show a payment ID. 
extra_text...

This can be used to collect just a little bit more information about the user or payment. The field will change nothing about the iDEAL payment, it will only register the information submitted by the user, and show it in the "Extra information" field in the cciDEAL Platform Payments page. These fields will accept letters, numbers, spaces and . , ? ! @ #. Other symbols are blocked for security reasons.

These fields can be used to collect, for example names, e-mail addresses, comments or other short messages. They allow you to easier identify the payment then with only the paymentid fields mentioned above. 

  • optional text field, maximum input 100 characters, use the code extra_textfield
  • required text field, maximum input 100 characters the code extra_textfield_required 
  • optional text area, use the code extra_textarea 
  • required text area, use the code extra_textarea_required

This value can be removed from the tag if you don't want to show an extra text field or area. 
extra_text The title of the extra text field or extra text area, "Informatie:" by default. This value can be removed from the tag if you don't want to show an extra text field or area. 
submit_button Text of the submit button, “Verder” by default
 

4. A few iDEAL tag and form examples

You can copy/paste these examples to your article, they should immediately work!
 
ideal site article example-05

{ccidealplatform amount="15"}

ideal_site_article_example-01

{ccidealplatform title="Betaal_met_iDEAL" amount="15.00,22.00" amount_text="Kies_bedrag:" paymentid="399" paymentid_text="Kenmerk:" submit_button="Verder" }

ideal_site_article_example-02

{ccidealplatform title="Betaal_met_iDEAL" amount="15.00" amount_text="Bedrag:" paymentid_by_user paymentid_text="Uw_factuur:" submit_button="Verder" }

ideal_site_article_example-03

{ccidealplatform title="Betaal_met_iDEAL" amount_by_user amount_text="Uw_donatie:" paymentid_none submit_button="Verder" }

ideal_site_article_example-04

{ccidealplatform title="Betaal_met_iDEAL" amount="15.00" amount_text="Kies_bedrag:" paymentid="399" paymentid_text="Kenmerk:" submit_button="Verder" }

5. Overzicht van betalingen

Betalingen via cciDEAL Simpel worden allemaal volledig geregistreerd in cciDEAL. Het overzicht is te benaderen via Componenten > cciDEAL > Betalingen in het Joomla menu. Alle informatie die uw gebruikers invullen tijdens het afrekenen zal in dit overzicht zichtbaar worden, ook als de betaling niet voltooid is (u kunt dus zien welke betalingen mislukt zijn). Ook de status van de betaling is zichtbaar in het overzicht.

 

6. FAQ: Alleen iDEAL, of ook andere betaalmethoden?

Vraag: Werkt cciDEAL Simpel alleen voor iDEAL betalingen, of kan ik ook andere betaalmethoden (MisterCash, Sofort, credit cards) aanbieden via de betaal knop?

Antwoord: Je kunt meerdere betaalmethoden gebruiken met cciDEAL Simpel, maar of dat mogelijk is is afhankelijk van je iDEAL account. Bijvoorbeeld Mollie heeft de betaalmethoden zo geïmplementeerd in hun systeem, dat als je er meerdere activeert in hun dashboard ze automatisch weergeven worden als iemand via jou Mollie account afrekent. Je kunt dan cciDEAL Simpel gebruiken voor eenvoudige betalingen in Joomla artikelen met iDEAL, MisterCash, Sofort, credit cards en meer!