## {eac}Doojigger Simple AWS Extension for WordPress  
[![EarthAsylum Consulting](https://img.shields.io/badge/EarthAsylum-Consulting-0?&labelColor=6e9882&color=707070)](https://earthasylum.com/)
[![WordPress](https://img.shields.io/badge/WordPress-Plugins-grey?logo=wordpress&labelColor=blue)](https://wordpress.org/plugins/search/EarthAsylum/)
[![eacDoojigger](https://img.shields.io/badge/Requires-%7Beac%7DDoojigger-da821d)](https://eacDoojigger.earthasylum.com/)

<details><summary>Plugin Header</summary>

Plugin URI:         https://eacdoojigger.earthasylum.com/eacsimpleaws/  
Author:             [EarthAsylum Consulting](https://www.earthasylum.com)  
Stable tag:         1.0.2  
Last Updated:       10-Apr-2024  
Requires at least:  5.5.0  
Tested up to:       6.5  
Requires PHP:       7.2  
Requires EAC:       2.0  
Contributors:       [kevinburkholder](https://profiles.wordpress.org/kevinburkholder)  
License:            GPLv3 or later  
License URI:        https://www.gnu.org/licenses/gpl.html  
Tags:               aws, amazon web services, AWS PHP SDK, {eac}Doojigger  
WordPress URI:      https://wordpress.org/plugins/eacsimpleaws  
GitHub URI:         https://github.com/EarthAsylum/eacSimplaAWS  

</details>

> {eac}SimpleAWS includes and enables use of the Amazon Web Services (AWS) PHP Software Development Kit (SDK).

### Description

Once enabled, AWS services are easily accessable from other plugins, extensions and custom functions.

From the settings page, you can enter your AWS Region and your IAM account credentials to access AWS programmatically.

Please review:
+   [Policies and permissions in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)  
+   [Managing access keys for IAM users](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html)

#### Available Methods:

`getAwsRegion()` returns your selected region

`getAwsAccessKey()` returns your access key

`getAwsAccessSecret()` returns your access secret

`getAwsCredentials()` returns a 'credentials' array with your key and secret

`getAwsClientParams()` returns an AWS client instantiation array

`getAwsEndpoints()` returns a (large) array of all AWS endpoint parameters

`getAwsRegions()` returns an array of all regions (name=>description)

`setAwsVersion()` override default ('latest') version

`setAwsRegion()` override set region

`setAwsEndPoint()` override default endpoint

#### Available Filters:

`SimpleAWS_version` returns the AWS version string

`SimpleAWS_region` returns your selected region

`SimpleAWS_access_key` returns your access key

`SimpleAWS_access_secret` returns your access secret

`SimpleAWS_credentials` returns a 'credentials' array with your key and secret

`SimpleAWS_client_params` returns an AWS client instantiation array

`SimpleAWS_endpoints` returns a (large) array of all AWS endpoint parameters

`SimpleAWS_regions` returns an array of all regions (name=>description)

#### Examples:

    $cloudFront = new Aws\CloudFront\CloudFrontClient([
        'version'       => 'latest',
        'region'        => apply_filters('SimpleAWS_region',''),
        'credentials'   => [
            'key'       => apply_filters('SimpleAWS_access_key',''),
            'secret'    => apply_filters('SimpleAWS_access_secret','')
        ]
    ]);

    if ($aws = $this->getExtension('Simple_AWS')) {
        $cloudFront = new Aws\CloudFront\CloudFrontClient([
            'version'       => 'latest',
            'region'        => $aws->getAwsRegion(),
            'credentials'   => $aws->getAwsCredentials(),
        ]);
    }

    if ($aws = eacDoojigger()->getExtension('Simple_AWS')) {
        $cloudFront = new Aws\CloudFront\CloudFrontClient([
            'version'       => $aws->getAwsVersion(),
            'region'        => $aws->getAwsRegion(),
            'credentials'   => $aws->getAwsCredentials(),
        ]);
    }

    if ($aws = $this->getExtension('Simple_AWS')) {
        $cloudFront = new Aws\CloudFront\CloudFrontClient(
            $aws->getAwsClientParams()
        );
    }

    if ($aws = eacDoojigger()->getExtension('Simple_AWS')) {
        $cloudFront = new Aws\CloudFront\CloudFrontClient(
            $aws->getAwsClientParams()
        );
    }


### Installation

**{eac}Doojigger Simple AWS Extension** is an extension plugin to and requires installation and registration of [{eac}Doojigger](https://eacDoojigger.earthasylum.com/).

#### Automatic Plugin Installation

This plugin is available from the [WordPress Plugin Repository](https://wordpress.org/plugins/search/earthasylum/) and can be installed from the WordPress Dashboard » *Plugins* » *Add New* page. Search for 'EarthAsylum', click the plugin's [Install] button and, once installed, click [Activate].

See [Managing Plugins -> Automatic Plugin Installation](https://wordpress.org/support/article/managing-plugins/#automatic-plugin-installation-1)

#### Upload via WordPress Dashboard

Installation of this plugin can be managed from the WordPress Dashboard » *Plugins* » *Add New* page. Click the [Upload Plugin] button, then select the eacsimpleaws.zip file from your computer.

See [Managing Plugins -> Upload via WordPress Admin](https://wordpress.org/support/article/managing-plugins/#upload-via-wordpress-admin)

#### Manual Plugin Installation

You can install the plugin manually by extracting the eacsimpleaws.zip file and uploading the 'eacsimpleaws' folder to the 'wp-content/plugins' folder on your WordPress server.

See [Managing Plugins -> Manual Plugin Installation](https://wordpress.org/support/article/managing-plugins/#manual-plugin-installation-1)

#### Settings

Once installed and activated options for this extension will show in the 'General' tab of {eac}Doojigger settings.


### Screenshots

1. Simple AWS
![{eac}SimpleAWS Extension](https://ps.w.org/eacsimpleaws/assets/screenshot-1.png)

2. Simple AWS Help
![{eac}SimpleAWS Help](https://ps.w.org/eacsimpleaws/assets/screenshot-2.png)


### Other Notes

#### Additional Information

+   {eac}SimpleAWS is an extension plugin to and requires installation and registration of [{eac}Doojigger](https://eacDoojigger.earthasylum.com/).