Merge remote-tracking branch 'origin/main'

README.md

@@ -6,3 +6,89 @@
 2. Copy the following docker-compose file into it (remember to unzip):[docker-compose.yml.zip](https://github.com/uafrica/magento-uafrica-shipping-extension/files/10193253/docker-compose.yml.zip)
 3. Run `docker compose up`
 
+
+
+
+## Introduction
+
+A guide to install Magento uAfrica Shipping extension
+
+## Features
+This extension allows you to get real-time shipping rates from Bobgo shipping service and display them to your customers during checkout.
+
+
+This extension also allows you to track shipments.
+
+## How to install Magento 2 Bobgo Shipping Extension
+
+### ✓ Install via composer (recommend)
+
+Run the following command in Magento 2 root folder:</br>
+
+
+<_Note: You must have composer installed on your server & at this point this option does not work,
+, option working is manual, although everything is set and ready for installation through composer from https://packagist.org/_ >
+
+``` 
+composer require uafrica/bobgo
+php bin/magento setup:upgrade
+php bin/magento setup:static-content:deploy
+```
+
+### ✓ Install via zip file
+
+1. Download the extension
+
+2. Unzip the file
+
+3. Create a folder {Magento root}/app/code/uafrica/Customshipping
+
+4. Copy the content from the unzip folder(Registration.php, etc, view, etc) to {Magento root}/app/code/uafrica/Customshipping)
+
+
+5. Go to Magento root folder and run upgrade `bin/magento setup:upgrade` command line to install `uafrica_Customshipping`:
+
+```
+Bin/magento cache:clean
+Bin/magento cache:flush
+Bin/magento setup:upgrade
+Bin/magento setup:di:compile
+```
+
+## How to configure Magento 2 Bobgo Shipping Extension
+
+### ✓ Step 1: Create an account on Bobgo
+
+You need to create an account on Bobgo to get API key and API secret<Not Sure About This At This Point> . Please visit [Bobgo](https://bobgo.co.za) to create an account.
+
+### ✓ Step 2: Login to Magento Admin
+
+Login to Magento Admin and go to `Stores > Configuration > Sales > Delivery Methods`
+
+
+### ✓ Step 3: Configure Bobgo Shipping Extension
+
+1. Select `Bobgo` as shipping method
+2. Enter API key and API secret
+3. Select `Enable` to enable the extension
+4. Select `Enable Debug Mode` to enable debug mode
+5. Click `Save Config`
+6. Flush cache (System > Cache Management) and reindex (System > Index Management)
+7. Clear generated files(`rm -rf var/generation/*`)
+8. Reindex data (`php bin/magento indexer:reindex`)
+9. Deploy static content (`php bin/magento setup:static-content:deploy`)
+10. Run `php bin/magento cache:clean`
+11. Run `php bin/magento cache:flush`
+12. Run `php bin/magento setup:upgrade`
+13. Run `php bin/magento setup:di:compile`
+14. Run `php bin/magento setup:static-content:deploy`
+
+## How to use Magento 2 Bobgo Shipping Extension (carrier) to ship orders
+
+### ✓ Step 1: Create shipment
+
+1. Go to `Sales > Orders` in Magento Admin
+2. Select an order
+3. Click `Ship` button
+4. Select `Bobgo` as shipping method
+5. Click `Submit Shipment` button

uafrica/Customshipping/Readme.md

-<!--- Document The Magento Bobgo shipping plugin with Read Me Styling, Installation and everything--->
+
 
 # Magento 2 Bobgo Shipping Extension