Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 21 additions & 21 deletions readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

## Introduction

The WordPress Plugin makes it very easy and quick to add Flutterwave Payment options on your eCommerce site, Donation Page or a list of Payment Subscriptions you want your clients to subscribe to.
The WordPress Plugin makes it very easy and quick to add Flutterwave Payment options on your e-commerce site, Donation Page, or a list of Payment Subscriptions you want your clients to subscribe to.

Take donations and payments for services on your WordPress site using Flutterwave.

Expand Down Expand Up @@ -35,14 +35,14 @@ Available features include:

## Requirements

1. Flutterwave for business [API Keys](https://developer.flutterwave.com/docs/integration-guides/authentication)
1. Flutterwave for business [API Keys](https://flutterwave.com/tz/support/my-account/getting-your-api-keys)
2. Supported PHP version: 7.4 or higher
3. For Elementor: Elementor version: 2.8.0 or higher

## Installation

### Automatic Installation
* Login to your WordPress Dashboard.
* Log in to your WordPress Dashboard.
* Click on "Plugins > Add New" from the left menu.
* In the search box type __Flutterwave Payments__.
* Click on __Install Now__ on __Flutterwave Payments__ to install the plugin on your site.
Expand All @@ -53,7 +53,7 @@ Available features include:

### Manual Installation
* Download the plugin zip file.
* Login to your WordPress Admin. Click on "Plugins > Add New" from the left menu.
* Log in to your WordPress Admin. Click on "Plugins > Add New" from the left menu.
* Click on the "Upload" option, then click "Choose File" to select the zip file you downloaded. Click "OK" and "Install Now" to complete the installation.
* Activate the plugin.
* Go to "Rave > Settings" from the left menu to configure the plugin.
Expand All @@ -64,12 +64,12 @@ For FTP manual installation, [check here](http://codex.wordpress.org/Managing_Pl

- When in doubt about a transaction, always check the Flutterwave Dashboard to confirm the status of a transaction.
- Always ensure you keep your API keys securely and privately. Do not share with anyone.
- Ensure you change from the default secret hash on the Wordpress admin and apply same on the Flutterwave Dashboard.
- Ensure you change from the default secret hash on the WordPress admin and apply the same on the Flutterwave Dashboard.
- Always ensure you install the most recent version of the Flutterwave WooCommerce plugin.

## Debugging Errors

We understand that you may run into some errors while integrating our plugin. You can read more about our error messages [here](https://developer.flutterwave.com/docs/integration-guides/errors).
We understand that you may run into some errors while integrating our plugin. You can read more about our error messages [here](https://flutterwave.com/gb/support/general/common-transaction-errors).

For `authorization` and `validation` error responses, double-check your API keys and request. If you get a `server` error, kindly engage the team for support.

Expand All @@ -85,31 +85,31 @@ To configure the plugin, go to __Rave > Settings__ from the left menu.
###
![Rave Settings Screenshot](https://cloud.githubusercontent.com/assets/8383666/21610555/f1b32abc-d1c8-11e6-8d53-e77c9e35a6c7.png)

* __Pay Button Public Key__ - Enter your public key which can be retrieved from "Pay Buttons" page on your Rave account dashboard.
* __Recurring Payments__ - To enable recurring payments/subscription for your users, click the Enable Recurring Payment 'checkbox' to enable it. Go to your Rave Dashboard, navigate to 'Payment Plans' and click the 'Create Payment Plan' button to create a payment plan with an interval. The intervals accepted for this plugin are WEEKLY, MONTHLy, QUARTERLY, ANNUALLY/YEARLY.
* __Modal Title__ - (Optional) customize the title of the Pay Modal. Default is FLW PAY.
* __Modal Description__ - (Optional) customize the description on the Pay Modal. Default is FLW PAY MODAL.
* __Modal Logo__ - (Optional) customize the logo on the Pay Modal. Enter a full url (with 'http'). Default is Rave logo.
* __Success Redirect URL__ - (Optional) The URL the user should be redirected to after a successful payment. Enter a full url (with 'http'). Default: "".
* __Failed Redirect URL__ - (Optional) The URL the user should be redirected to after a failed payment. Enter a full url (with 'http'). Default: "".
* __Pay Button Public Key__ - Enter your public key, which can be retrieved from the "Pay Buttons" page on your Rave account dashboard.
* __Recurring Payments__ - To enable recurring payments/subscription for your users, click the Enable Recurring Payment 'checkbox' to enable it. Go to your Rave Dashboard, navigate to 'Payment Plans', and click the 'Create Payment Plan' button to create a payment plan with an interval. The intervals accepted for this plugin are WEEKLY, MONTHLY, QUARTERLY, ANNUALLY/YEARLY.
* __Modal Title__ - (Optional) Customize the title of the Pay Modal. Default is FLW PAY.
* __Modal Description__ - (Optional) Customize the description on the Pay Modal. Default is FLW PAY MODAL.
* __Modal Logo__ - (Optional) Customize the logo on the Pay Modal. Enter a full URL (with 'http'). Default is the Rave logo.
* __Success Redirect URL__ - (Optional) The URL the user should be redirected to after a successful payment. Enter a full URL (with 'http'). Default: "".
* __Failed Redirect URL__ - (Optional) The URL the user should be redirected to after a failed payment. Enter a full URL (with 'http'). Default: "".
* __Pay Button Text__ - (Optional) The text to display on the button. Default: "PAY NOW".
* __Charge Currency__ - (Optional) The currency the user is charged. Default: "NGN".
* __Charge Country__ - (Optional) The country the merchant is serving. Default: "NG: Nigeria".
* __Form Style__ - (Optional) Disable form default style and use the activated theme style instead.
* Click __Save Changes__ to save your changes.

### Styling
You can enable default theme's style to override default form style from the __Settings__ page.
You can enable the default theme's style to override the default form style from the __Settings__ page.
Or you can override the _form_ class `.flw-simple-pay-now-form` from your stylesheet.


## Usage ##

####1. Shortcode

Insert the shortcode anywhere on your page or post that you want the form to be displayed to the user.
Insert the shortcode anywhere on your page or post where you want the form to be displayed to the user.

Basic: _requires the user to enter amount and email to complete payment_
Basic: _requires the user to enter the amount and email to complete payment_
```
[flw-pay-button]
```
Expand Down Expand Up @@ -145,9 +145,9 @@ With custom and excluded fields.

```

With order rearranged.
With the order rearranged.
```
[flw-pay-form amount=1234 fullname="Abraham Olaobaju" currency="USD,UGX,NGN" order="currency,fullname,amount,phone,email"]
[flw-pay-form amount=1234 fullname=" Abraham Olaobaju" currency="USD,UGX,NGN" order="currency,fullname,amount,phone,email"]
```

Donation Form.
Expand All @@ -159,7 +159,7 @@ Donation Form.

The shortcode can be added via Visual Composer elements.

* On Visual Composer __Add Element__ dialog, click on "__Rave Forms__" and select the type of form you want to include on your page.
* On the Visual Composer __Add Element__ dialog, click on "__Rave Forms__" and select the type of form you want to include on your page.
![Visual Composer Screenshot 1](https://cloud.githubusercontent.com/assets/8383666/21606192/20887a10-d1ae-11e6-85f7-6f8771cb8688.png)
###

Expand All @@ -173,7 +173,7 @@ The shortcode can be added via Visual Composer elements.

## Transaction List ##

All the payments made through the forms to Rave can be accessed on __Rave > Transactions__ page.
All the payments made through the forms to Rave can be accessed on the __Rave > Transactions__ page.

![Rave Transactions Screenshot](https://cloud.githubusercontent.com/assets/8383666/21606454/01022040-d1b0-11e6-8c61-755cea93ea14.png)

Expand All @@ -185,4 +185,4 @@ We love to get your input. Read more about our community contribution guidelines

By contributing to the Rave WooCommerce Plugin, you agree that your contributions will be licensed under its [MIT license](/LICENSE).

Copyright (c) Flutterwave Inc.
Copyright (c) Flutterwave Inc.
Loading