Cleaned up plugin + Extra readme documentation

README.md

@@ -1,44 +1,78 @@
 ![Build Status](https://github.com/DiscipleTools/disciple-tools-media/actions/workflows/ci.yml/badge.svg?branch=master)
-## Dev notes, delete me:
-This is a starter plugin to jumpstart your work with Disciple.Tools.
-Click the "Use this template" button above.
-See instructions for refactoring and getting started in the [wiki](https://github.com/DiscipleTools/disciple-tools-media/wiki)
-See instructions for creating releases and publishing your plugin: [wiki](https://github.com/DiscipleTools/disciple-tools-media/wiki)
-In order to display the banner correctly on the Disciple.Tools Community Plugins Site, don't change the 'Plugin Banner' text on line 12; only the URL.
-
-## readme format:
-
-![Plugin Banner](https://raw.githubusercontent.com/DiscipleTools/disciple-tools-media/b30402d97895e3f911efcb47fb8f29ccd1eb92e5/documentation/banner.png)
 
 # Disciple.Tools - Media
 
-Description Description Description Description Description Description Description
-Description Description Description Description Description Description Description
+Disciple.Tools - Media is intended to help manage connections with remote object storage services, such as AWS S3, Backblaze, etc.
 
 ## Purpose
 
-Purpose purpose purpose purpose purpose purpose purpose purpose purpose purpose purpose
-Purpose purpose purpose purpose purpose purpose purpose purpose purpose purpose purpose
+Provide the ability to store/retrieve all media content within 3rd party object storage services; offering greater security.
 
-Purpose purpose purpose purpose purpose purpose purpose purpose purpose purpose purpose
-Purpose purpose purpose purpose purpose purpose purpose purpose purpose purpose purpose
+A detailed description of the typical usage flow for creating and using connections is provided below.
 
 ## Usage
 
 #### Will Do
 
-- Item
-- Item
-- Item
+- Create multiple object storage services connections.
+- Test supplied connection credentials.
+- Select default media connection to be used for file storage within D.T theme.
+- Edit user profile pictures.
 
 #### Will Not Do
 
-- Item
-- Item
+- Add media content to comments.
+- Add media content to records.
+
+#### Typical Usage Flow
+
+- In order to use the new D.T Media Plugin, ensure PHP version 8.1 or greater has been installed.
+
+![0](documentation/readme/imgs/0.png)
+
+- Once D.T Media Plugin has been installed, create a new connection.
+
+![1](documentation/readme/imgs/1.png)
+
+- The following connection types (3rd Party Object Storage Services) are currently supported:
+  - [AWS S3](https://aws.amazon.com/s3/)
+  - [BackBlaze](https://www.backblaze.com/)
+  - [MinIO](https://min.io/)
+
+
+- Enter required connection details; ensuring specified bucket has already been created within 3rd party object storage service.
+
+![2](documentation/readme/imgs/2.png)
+
+> If no endpoint protocol scheme is specified; then https:// will be used.
+
+- Test connection, to ensure supplied credentials are valid.
+
+![3](documentation/readme/imgs/3.png)
+
+- The following will be shown for failed connection tests.
+
+![4](documentation/readme/imgs/4.png)
+
+> Some important things to note when working with Backblaze services:
+>
+> - Currently, due to API version restrictions, Backblaze connections are unable to be validated and will typically fail, with Network Error exceptions, when attempting to test connection. However, you should be able to upload and retrieve files freely within the D.T Frontend UI.
+> - Ensure sufficient CORS permissions have been applied to target Backblaze bucket, as shown below:
+
+![5](documentation/readme/imgs/5.png)
+
+- Once new connection has been validated and saved, navigate to Media Settings section within D.T General Settings and select connection to be used for the default media storage within D.T.
+
+![6](documentation/readme/imgs/6.png)
+
+- Currently, media connections are only available when editing user profile pictures.
+
+![7](documentation/readme/imgs/7.png)
 
 ## Requirements
 
-- Disciple.Tools Theme installed on a Wordpress Server
+- Disciple.Tools Theme installed on a Wordpress Server.
+- Ensure PHP v8.1 or greater, has been installed.
 
 ## Installing
 
@@ -53,8 +87,3 @@ in the [Discussions](https://github.com/DiscipleTools/disciple-tools-media/discu
 code contributions are welcome using the [Pull Request](https://github.com/DiscipleTools/disciple-tools-media/pulls)
 system for git. For a more details on contribution see the
 [contribution guidelines](https://github.com/DiscipleTools/disciple-tools-media/blob/master/CONTRIBUTING.md).
-
-
-## Screenshots
-
-![screenshot](documentation/community/starter-banners/banner-blue-green.png)