Custom Currency Conversion - Installation Guide

Welcome, and thank you for choosing the Custom Currency Conversion plugin! We're delighted to have you as a customer and are committed to ensuring you have a seamless experience. This README aims to guide you through the installation of your new plugin. If you're new to Blesta or encounter any issues, please don't hesitate to reach out for support.

Installation Guide

Before proceeding, ensure you have the Blesta.club subscription manager installed.

Follow these steps to install the Custom Currency Conversion plugin:

1. Download the Plugin Files:

   • Download the Custom Currency Conversion plugin files from the download section of the client area.

2. Upload the Plugin Files:

   • Upload the plugin files to a /plugins/custom_currency_conversion/ directory within your Blesta installation path. For example:

     /var/www/html/blesta/plugins/custom_currency_conversion/

3. Log in to Blesta Admin:

   • Log in to your admin Blesta account.

4. Navigate to Plugins:

   • Go to Settings > Plugins.

5. Install the Plugin:

   • Find the Custom Currency Conversion plugin and click the "Install" button.

You're done with the installation! Proceed to configure the plugin as needed by following the usage guide.

Contact Us

If you encounter any issues or have suggestions for improving the plugin, please get in touch with us. We are committed to providing robust updates and welcome customer feedback.

Custom Currency Conversion - Update Guide

Keeping your Custom Currency Conversion plugin up-to-date ensures you have the latest features and security improvements. Follow these steps to update your plugin:

Update Steps

1. Backup Existing Plugin Files:

   • It's always a good practice to backup your existing plugin files before making any updates.

2. Download the Latest Version:

   • Download the latest version of the Custom Currency Conversion plugin files from the client area.

3. Upload New Plugin Files:

   • Upload the new plugin files to your Blesta plugins directory, overwriting the existing files:

     /var/www/html/blesta/plugins/custom_currency_conversion/

4. Log in to Blesta Admin:

   • Log in to your Blesta admin area.

5. Navigate to Plugins:

   • Go to Settings > Plugins.

6. Update the Plugin:

   • Find the Custom Currency Conversion plugin and click the "Update" button.

No additional changes are needed outside of updating the files. Any breaking changes will be communicated to clients.

Keep your Custom Currency Conversion plugin up-to-date to ensure you have the latest features and improvements.

Contact Us

If you encounter any issues or have suggestions for improving the plugin, please get in touch with us. We are committed to providing robust updates and welcome customer feedback.

Custom Currency Conversion - Usage Guide

Once your Custom Currency Conversion plugin is installed, you'll want to configure it to suit your needs. Follow the steps below for a comprehensive setup.

Setting Up the Plugin

1. Install the Plugin:

   • Follow the installation guide to install the Custom Currency Conversion plugin.

2. Configure the Plugin:

   • Log in to your Blesta admin account.
   • Navigate to Settings > Plugins.
   • Find the Custom Currency Conversion plugin in the list of installed plugins and click on the "Manage" button.
   • In the plugin settings, input your API key if applicable, and adjust the settings to specify which currencies you want to support and how you want to round off pricing values.

Why and How to Use This Plugin

This plugin works by using the company default currency and modifying prices of all the pricing fields with different currencies to match the conversion rate and apply specified rounding rules. This method provides greater customization and the ability to have "cleaner" prices (e.g., ending with .99 in all currencies). Additionally, it allows for adding currency-converted pricing packages via the admin panel, which is not possible with Blesta's default currency conversion.

Generating Additional Pricings

To allow this plugin to work, you can either generate additional pricings for the currencies you want to convert to using the provided utility inside the plugin or manually specify the pricings.

Example:

If your current pricing is as follows:

• 1 month - 2 GBP
• 2 months - 4 GBP
• 3 months - 6 GBP

To add support for EUR and USD, add additional pricing with the same terms but keep their prices at 0. The plugin will automatically apply new prices once it runs via cron or manually triggered by clicking "Save And Run Conversion" inside the plugin settings. The final pricing should look like:

• 1 month - 2 GBP
• 2 months - 4 GBP
• 3 months - 6 GBP
• 1 month - 0 EUR
• 2 months - 0 EUR
• 3 months - 0 EUR
• 1 month - 0 USD
• 2 months - 0 USD
• 3 months - 0 USD

You're now done with the setup! Ensure your Blesta installation is properly configured to use the Custom Currency Conversion plugin effectively.

Contact Us

If you encounter any issues or have suggestions for improving the plugin, please get in touch with us. We are committed to providing robust updates and welcome customer feedback