Translating and customising the Stripe Button, Mail and text

The Stripe Plugins rely on the Joomla Language translation files, so you can customise any text.

Localise the Stripe Button

For example, when you are using text mode the Stripe Button appears like this:

Joomla Stripe Button test

to clearly indicate if the current Vendor is using Connect or not. When you go live, the text changes to "Pay 52.50€".

If you want to change it instead to "Pay EUR 52.50", different strings for test and live modes are available:

STRIPE_PAY_NOW = "Pay %AMOUNT%"  // the site is Live
STRIPE_PAY_NOW_BASIC = "Pay %AMOUNT% (Basic Stripe)" // the site is in test mode and normal Stripe is used
STRIPE_PAY_NOW_CONNECT = "Pay %AMOUNT% (Stripe Connect)" // the site is in test mode and Stripe Connect is used

You can use the following tokens to change the button text to your liking:

        %AMOUNT% => let me decide i.e. 30,50€    $ 20.00     £15,15
        %TOTAL%  => the price i.e. 30,20   22,00 (will use the correct decimal separator based on your location)
        %CURRENCYSYMBOL% => €  $  £ supported.
        %CURRENCY% => the value passed by the techjoomla component e.g. EUR GBP USD

To continue the example above, the following:

STRIPE_PAY_NOW = "Pay %CURRENCY% %TOTAL%"

should be inserted in Joomla Language overrides.

How to use the Joomla Language Overrides

1. Open the Joomla Language Overrides

102.joomla language overrides

2. Choose Language and "site"

103.joomla language overrides choose language and site

3. Create a New override (Press the green New button in the top-left corner)

4. Search for the string (make sure you select "Search For Constant":

104. search string

5. Click on the item you wish to change, the first in the search results

6. Edit the string on the left

105. create override

7. Press save and test:

106.updated Stripe Button

Joomla Language Overrides: how to change the text you see

When you don't know the name of the language constant you can use the above search function to search for text. Exclude any numbers from your search or search for a part of the text if the search does not find it.

A complete example follows

How to change the email text

The second most requested customisation is the email text.

Make sure you select "Search for Value" and input some text from the email.

107 email text customization with Joomla Language Overrides

Here you can use the following tokens:

  • %STRIPE_CUSTOMER_NAME%
  • %STRIPE_ITEM_LINE% the item description
  • %STRIPE_PAYMENT_MESSAGE% i.e. The payment is confirmed or pending i.e. one of the two language strings:STRIPE_PAYMENT_FAILED STRIPE_PAYMENT_SUCCESS_UNPAID or STRIPE_PAYMENT_SUCCESS_PAID
  • %STRIPE_PAYMENT_STATUS% as returned from Stripe i.e. "paid", "unpaid", the latter meaning that the payment is pending, which is absolutely normal for Bank payments.
  • %STRIPE_PURCHASE_DATE%
  • %STRIPE_CUSTOMER_IP% the IP address of the customer

Additionally, you may want to change the other mail strings:

  • STRIPE_MAIL_SUBJECT
  • STRIPE_MAIL_SENDER

Customizing the return screen

After payment is completed, Stripe redirects to our return screen, which rebuilds the session for use by the Common Payment API applications.

This file does not as of yet support overriding, but you can edit in place, and restore the file after each update until I support proper overriding

You can find the file here:

plugins/payment/stripe/assets/redirect.html

 

Customizing the configuration  for vendor onboarding

The template `plugins/system/stripe_connect/tmpl/vendor.php`
        shows / edits the individual vendor's configuration.
        It serves the onboarding process.
        It is a fairly complicated view, in that it shows the current status
            of the configuration, and depending on the choices adapts
            to make onboarding as straightforward as possible.
 
        Should you choose to override it, ensure you watch this readme for
        relevant changes which you should port to your override.
        The override should be placed in your template folder under
            `templates/your_template/html/plg_stripe_connect/vendor.php`
        and this means you can have different overrides for backend
        and frontend.

        The vendor configuration page is hardly initialised (just the system path)
        and lives thanks to two calls, to read and save vendor data;
        Security is checked on frontend and backend to ensure only the vendor
        or a site administrator can access the configuration.

Other translation strings

Use the method outlined above to find the text you wish to change. Most are simple texts without tokens, and tokens are usually named in a sensible fashion. If in doubt, contact us.

Stripe Plugin Roadmap and Changelog

The Stripe Plugin, Stripe Connect Plugin, Stripe Button Plugin and Stripe Editor Button Plugin all follow the same roadmap, but some updates only apply to a specific plugin, so the latest available version may be different.

A detailed changelog is available in the ./plugins/payment/stripe/README.php file.

Continue Reading

Joomla Stripe Payment Plugin

Receive money via Stripe Checkout to safely accept cards, Apple Pay, Google Pay, SEPA, and more.

Set up in minutes, and start accepting money now on your Joomla site with no extra extensions required, or in combination with one of the many supported ones.

Continue Reading

Stripe security

This article is but a narrow list of the many security measures both Stripe and we adopted in order to make your experience the most secure.

Continue Reading

Stripe Example

This page showcases some of the codes you can use to generate a Stripe button: Simply insert the codes below in any article or module. If you still see your code instead of the button, ensure you have real " characters and not the typographical one (simply type it yourself in the editor in code mode).

1. Buy me a beer, euro:

{stripe-button amount="5.25" currency="EUR" description="buy you a beer"}

2. Buy me a computer, USD:

{stripe-button amount="1000" currency="USD" description="buy you a computer"}

3. Send me a variable amount, in EURO:

{stripe-button currency="EUR" description="buy you a house"}

4. send me to a new page after payment:

{stripe-button  amount="155" currency="EUR"" returnUrl="https://www.fasterjoomla.com/stripe-thank-you" description="Lightsaber"}

Stripe Button

The Stripe Button plugin is a free addon to our (commercial) Stripe Payment plugin, and it allows to use a Stripe account to accept payments on your website with no extra components.

Continue Reading

Quick2Cart Extensions

Quick2Cart is an excellent multivendor e-commerce solution.  Some features are yet to come, but its architecture is the finest Joomla! MVC, allowing us to integrate and extend it to its full potential!  Here's a short list of the aspects we are working on:
some will make it to the core, some will remain independent extensions.  Most aim at extending the multivendor features of version 2.1, and has become in large parte obsolete after Quick2Cart 2.2 was released in September, 2014.

New release 0.3.2 of the plugins released on 2018 Quick2Cart 2.9  download now. (includes the pdf doc)

Continue Reading

Easy Https and SSL

Are you tired of Mixed Content errors in Joomla?

Solve the "mixed content" errors in your browser, stop getting a broken lock in your site.

Continue Reading