upload v0.3.3

README.md

@@ -0,0 +1,129 @@
+## WooLaqiraPay 
+
+Tags: wordpress, woocommerce, web3, woocommerce-plugin, woocommerce-payment, metamask, woocommerce-payment-gateway, crypto-payment, cryptopayments, cryptocurrency-payments, wordpress-payments, crypto-payments, blockchain-payments, crypto-payment-gateway, metamask-payment, web3-payments, wordpress-crypto-payments
+Requires at least: 6.2
+Tested up to: 6.5.2
+Requires PHP: 7.4
+
+## Description
+
+A cryptocurrency payment gateway for woocommerce powered by Laqira.io
+
+## ABOUT LAQIRAPAY
+The First Ever Fully Decentralized Asset-Agnostic MultiNetwork Payment Gateway.
+
+### ABSTRACT
+LaqiraPay is a decentralized asset-agnostic, multi-network payment gateway with enhanced flexibility and security through blockchain technology, offering transparent financial statements and in-app wallet features for users.
+
+### HOW LAQIRAPAY WORKS
+LaqiraPay's operation involves provider registration, financial statement generation, plugin setup and customer payment processing, ensuring a seamless workflow.
+
+### PROVIDER REGISTRATION
+Providers register on LagiraPay and receive a dedicated smart contract address analogous to an API key in which transparent financial records will be carved.
+
+### PLUGIN SETUP
+Post-registration, providers install the LaqiraPay plugin, input their API key, and get ready for accepting cryptocurrency payments.
+
+### CUSTOMER PAYMENT
+Customers select LaqiraPay method in payment section, choose a network and cryptocurrency, connect their wallet, press "pay" and await confirmation.
+
+### FEATURES:
+
+#### 1. FULLY DECENTRALIZED 
+LagiraPay is a fully decentralized payment gateway using blockchain technology for secure, anonymous transactions without third-party oversight.
+It operates through decentralized applications (DApps) that ensure transparency and eliminate intermediaries, providing a direct, immutable, and private transaction environment across various functions.
+
+#### 2. PROVIDER'S FINANCIAL STATEMENT
+
+#### 3. IN-APP WALLET
+
+#### 4. DIRECT RECEIVE
+
+#### 5. DIRECT PAY
+
+#### 6. CASHBACK
+
+#### 7. ASSET-AGNOSTIC 
+LagiraPay is asset-agnostic, allowing payments in any origin asset and providing stablecoin in destination to providers, ensuring implicit support and flexibility while minimizing risk and maximizing stability.
+
+#### 8.READILY INCLUSIVE
+LagiraPay's readily inclusive, asset-agnostic approach allows implicitly acceptance of any cryptocurrency by providers and broadening usage opportunities for various tokens, overcoming challenges faced by both providers and crypto teams.
+
+#### 9. MULTI-NETWORK
+LaqiraPay is a multi-network gateway, supporting diverse network payments, with user options dependent on provider acceptance and configuration. Providers are encouraged to embrace multiple networks for broader user access.
+
+#### 10. AUTOMATIC NETWORK DETECTION
+
+#### 11. AUTOMATIC VALID ASSET DETECTION
+
+#### 12. SLIPPAGE
+
+#### 13. CHAINLINK PRICE FEEDS 
+Automatic exact amount detection for customer payment and automatic stable coin depeg detection for vendor settlement based on CHAINLINK’s decentralized price feeds.
+
+
+
+
+## Features
+
+- user can select Networks.
+- user can select assest to pay.
+- use metamask,ConnectWallet,Trustwallet 
+- ...
+
+## Installation
+
+1. Upload the entire `woo-laqirapay` folder to the `/wp-content/plugins/` directory.
+2. Activate the plugin through the `Plugins` menu in WordPress.
+3. Configure the plugin settings via the `woo LaqiraPay Settings` menu.
+4. Get your `LaqiraPay API-KEY` from [LaqiraPay website](https://laqirahub.com) and add it to the plugin settings.
+5. Edit the WooCommerce Checkout page on the Pages menu in WordPress and insert `[woocommerce-checkout]` shortcode in it and save.
+6. Enable and activate the `woo LaqiraPay` gateway in WooCommerce settings.
+
+**Minimum Requirements:**
+
+- PHP version 7.4 or higher
+- WordPress version 6.2 or higher
+- WooCommerce version 8.2 or higher
+
+
+
+#### Compatibility
+The plugin is compatible with WordPress version 6.2 and PHP versions 7.4 and 8.2.
+
+#### Limitations
+The plugin may not be compatible with older versions of WordPress and PHP.
+
+## Compatibility
+
+LaqiraPay has been tested and confirmed to be compatible with the following plugins and themes:
+
+### Plugins
+
+- [WooCommerce 8.2](https://wordpress.org/plugins/woocommerce/)
+- [WPML](https://wpml.org/)
+- [elementor / elementor pro v3.21.0 Tested](https://elementor.com/)
+- [WPBakery-page-builder 6.5.0 (Visual Composer)](https://visualcomposer.com/)
+- [Yoast SEO](https://wordpress.org/plugins/wordpress-seo/)
+
+
+### Themes
+
+- [Astra](https://wpastra.com/)
+- [OceanWP](https://oceanwp.org/)
+- [Avada](https://avada.io/)
+
+
+## Upgrade Notice
+
+Include any important upgrade information here.
+
+## Support
+
+For support or bug reports, please visit the support forum.
+
+## Credits
+
+- Laqira.io
+- laqirapay.com
+- laqirahub.com

Workflow.md

@@ -0,0 +1,87 @@
+# Workflow for LaqiraPay Plugin
+## Introduction
+This guide delineates the procedure for configuring and utilizing the LaqiraPay plugin. It covers two tailored workflows: one tailored for website administrators and another crafted for the end-users or customers.
+
+## Administrator Workflow
+1. **Registration on LaqiraPay Websit:**
+   - Initially, the site administrator registers on the LaqiraPay portal via [laqirapay.com](https://laqirapay.com), completing the necessary steps to create an account.
+
+     ![image preview](./workflow-media/001.png)
+
+
+1. **API Key Acquisition:**
+   - Following successful registration, the administrator is to navigate to the API section within the LaqiraPay dashboard. Here, they can generate a unique API key that will facilitate secure communication between the website and LaqiraPay's services. The API key acts as a secure identifier and should be safeguarded accordingly.
+
+      ![image preview](./workflow-media/002.png)
+
+1. **Plugin Download:**
+   - After obtaining the API key, the administrator will be directed to the download section.
+1. **Installation and Configuration:**
+   - ` `Upon downloading the LaqiraPay plugin, the administrator will navigate to the 'Plugins' section of their website's administrative dashboard.
+
+      ![image preview](./workflow-media/003.png) ![image preview](./workflow-media/004.png) ![image preview](./workflow-media/005.png)
+
+      ![image preview](./workflow-media/006.png)
+
+   - In the WordPress dashboard, the administrator will find a dedicated section for LaqiraPay under the 'Settings' menu. Clicking on this brings up the LaqiraPay settings panel. Here, the administrator will enter the unique API key provided during the registration process on the LaqiraPay website. This key is essential for linking the website to LaqiraPay and enabling transactions. Once the API key is correctly entered, changes are saved to finalize the setup, ensuring that LaqiraPay is now ready to process payments securely and efficiently.
+
+      ![image preview](./workflow-media/007.png)
+## User Workflow
+1. **Purchase Process:**
+   - Customers navigate through the website's offerings and add their desired products to the shopping cart. When ready to checkout, they proceed to the WooCommerce checkout page, where they can review their order details and prepare to make a payment. This process is intuitive and designed to ensure a smooth transition from shopping to payment, providing a hassle-free experience for users engaging with the site.
+
+1. **Payment Selection:**
+   - When customers arrive at the payment stage, they are presented with various options. For those choosing to utilize LaqiraPay, they simply select LaqiraPay as their payment method. This action seamlessly leads them to the next steps, specifically designed for the choice of payment network and asset, ultimately guiding them towards a secure and successful transaction.
+   - After choosing LaqiraPay as the payment method and selecting the preferred network, customers are prompted to connect their digital wallet.
+
+      ![image preview](./workflow-media/008.png)
+
+
+
+
+
+
+
+     - They can choose from supported wallet options, such as MetaMask or WalletConnect, ensuring a secure and personalized transaction experience.
+
+      ![image preview](./workflow-media/009.png)
+
+
+     - Following the wallet connection, customers will select the asset they wish to use for the transaction. They can choose from a variety of native currencies or tokens available within their connected wallet, ensuring a smooth and tailored payment process with LaqiraPay.
+
+      ![image preview](./workflow-media/010.png)
+
+Once the customer selects an asset, a detailed modal window appears, displaying critical transaction details. This modal provides visibility into:
+
+\- The network chosen by the customer.
+
+\- The asset selected for the transaction.
+
+\- The total order amount in US dollars.
+
+\- An estimated amount of the chosen cryptocurrency equivalent to the order value.
+
+\- Options for wallet source selection:
+
+`  `- By default, "External Pay" is selected, prompting customers to connect to their external wallet through the browser.
+
+ ![image preview](./workflow-media/011.png)
+
+- When the "Internal Pay" option is selected by the customer, the modal provides visibility into their in-app balance relative to the selected token. If the balance is insufficient, the modal offers a straightforward option to charge and replenish their in-app balance, enabling them to proceed with the payment.
+
+   ![image preview](./workflow-media/012.png)
+
+  In the payment detail modal:
+
+- ` `The in-app balance is displayed, showing the amount available based on the selected token. If the balance is not sufficient for the transaction, the customer has the option to "Charge" their in-app wallet to proceed with the payment.
+
+- ` `To accommodate for price fluctuations during the transaction process, the customer is provided with the option to set a "Slippage Tolerance". This feature allows the customer to specify the maximum percentage of price movement they are willing to accept before their transaction is executed, minimizing the risk of transaction reversion due to market volatility.
+
+- ` `The option for slippage tolerance is deactivated for payments made with NativeCoin to simplify the process, as the value is generally more stable and does not require this additional step.
+
+   ![image preview](./workflow-media/013.png) 
+
+1. **Payment Execution:**
+   - The user confirms the payment details and executes the transaction using their preferred cryptocurrency and network. The process is designed to be straightforward, enabling a swift and secure transaction experience.
+## Conclusion
+The integration of the LaqiraPay payment gateway provides a dual advantage: it streamlines the payment process for end-users, allowing for a variety of cryptocurrencies and networks to be used, and it offers a simple, hassle-free setup for administrators. This effectively bridges the gap between traditional e-commerce and the burgeoning world of digital currency transactions, embodying a new era of financial flexibility and user empowerment.