{"id":183838,"date":"2024-01-03T05:35:39","date_gmt":"2024-01-03T05:35:39","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/eacsimpleaws\/"},"modified":"2025-07-30T21:30:08","modified_gmt":"2025-07-30T21:30:08","slug":"eacsimpleaws","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/eacsimpleaws\/","author":20183118,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.1.1","stable_tag":"1.1.1","tested":"6.8.5","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"{eac}SimpleAWS","header_author":"EarthAsylum Consulting","header_description":"{eac}SimpleAWS includes and enables use of the Amazon Web Services (AWS) PHP SDK","assets_banners_color":"b4c5a5","last_updated":"2025-07-30 21:30:08","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/github.com\/sponsors\/EarthAsylum","header_plugin_uri":"https:\/\/eacdoojigger.earthasylum.com\/eacsimpleaws\/","header_author_uri":"http:\/\/www.earthasylum.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":2082,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.0.1":{"tag":"1.0.1","author":"kevinburkholder","date":"2024-01-03 05:40:40"},"1.0.2":{"tag":"1.0.2","author":"kevinburkholder","date":"2024-04-16 02:47:39"},"1.0.4":{"tag":"1.0.4","author":"kevinburkholder","date":"2025-04-23 00:23:04"},"1.1.0":{"tag":"1.1.0","author":"kevinburkholder","date":"2025-07-21 22:26:01"},"1.1.1":{"tag":"1.1.1","author":"kevinburkholder","date":"2025-07-30 21:30:08"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3016750,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3016751,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3016748,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3016747,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.1","1.0.2","1.0.4","1.1.0","1.1.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3284450,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3284450,"resolution":"2","location":"assets","locale":""}},"screenshots":{"1":"

Simple AWS\n<\/p>","2":"

Simple AWS Help\n<\/p>"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[3876,1898,223571,241582,241581],"plugin_category":[],"plugin_contributors":[211905],"plugin_business_model":[],"class_list":["post-183838","plugin","type-plugin","status-publish","hentry","plugin_tags-amazon-web-services","plugin_tags-aws","plugin_tags-aws-php-sdk","plugin_tags-eventbridge","plugin_tags-s3-bucket","plugin_contributors-kevinburkholder","plugin_committers-kevinburkholder"],"banners":{"banner":"https:\/\/ps.w.org\/eacsimpleaws\/assets\/banner-772x250.jpg?rev=3016747","banner_2x":"https:\/\/ps.w.org\/eacsimpleaws\/assets\/banner-1544x500.jpg?rev=3016748","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/eacsimpleaws\/assets\/icon-128x128.png?rev=3016750","icon_2x":"https:\/\/ps.w.org\/eacsimpleaws\/assets\/icon-256x256.png?rev=3016751","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/eacsimpleaws\/assets\/screenshot-1.png?rev=3284450","caption":"

Simple AWS\n<\/p>"},{"src":"https:\/\/ps.w.org\/eacsimpleaws\/assets\/screenshot-2.png?rev=3284450","caption":"

Simple AWS Help\n<\/p>"}],"raw_content":"\n

Simple AWS<\/h4>\n\n

This extension, when enabled, provides easy access to Amazon Web Services (AWS) from other plugins, extensions and custom functions through the AWS SDK for PHP<\/a>.<\/p>\n\n

From the settings page, enter your AWS Region and your IAM account credentials, then access AWS programmatically using the provided methods and filters along with the AWS SDK classes and methods.<\/p>\n\n

Please review:\n+ Policies and permissions in IAM<\/a>\n+ Managing access keys for IAM users<\/a><\/p>\n\n

Available Methods<\/h4>\n\n
getAwsRegion() returns your selected region\n\ngetAwsAccessKey() returns your access key\n\ngetAwsAccessSecret() returns your access secret\n\ngetAwsCredentials() returns a 'credentials' array with your key and secret\n\ngetAwsClientParams() returns an AWS client instantiation array\n\ngetAwsEndpoints() returns a (large) array of all AWS endpoint parameters\n\ngetAwsRegions() returns an array of all regions (name=>description)\n\nsetAwsVersion() override default ('latest') version\n\nsetAwsRegion() override set region\n\nsetAwsEndPoint() override default endpoint\n<\/code><\/pre>\n\n
Available Filters<\/h4>\n\n
SimpleAWS_version returns the AWS version string\n\nSimpleAWS_region returns your selected region\n\nSimpleAWS_access_key returns your access key\n\nSimpleAWS_access_secret returns your access secret\n\nSimpleAWS_credentials returns a 'credentials' array with your key and secret\n\nSimpleAWS_client_params returns an AWS client instantiation array\n\nSimpleAWS_endpoints returns a (large) array of all AWS endpoint parameters\n\nSimpleAWS_regions returns an array of all regions (name=>description)\n<\/code><\/pre>\n\n
Examples<\/h4>\n\n
`php\n<\/code><\/pre>\n\n
$cloudFront = new Aws\\CloudFront\\CloudFrontClient([\n    'version'       => 'latest',\n    'region'        => apply_filters('SimpleAWS_region',''),\n    'credentials'   => [\n        'key'       => apply_filters('SimpleAWS_access_key',''),\n        'secret'    => apply_filters('SimpleAWS_access_secret','')\n    ]\n]);<\/p>\n\n
if ($aws = $this->getExtension('Simple_AWS')) {\n    $cloudFront = new Aws\\CloudFront\\CloudFrontClient([\n        'version'       => 'latest',\n        'region'        => $aws->getAwsRegion(),\n        'credentials'   => $aws->getAwsCredentials(),\n    ]);\n}<\/p>\n\n
if ($aws = eacDoojigger()->getExtension('Simple_AWS')) {\n    $cloudFront = new Aws\\CloudFront\\CloudFrontClient([\n        'version'       => $aws->getAwsVersion(),\n        'region'        => $aws->getAwsRegion(),\n        'credentials'   => $aws->getAwsCredentials(),\n    ]);\n}<\/p>\n\n
if ($aws = $this->getExtension('Simple_AWS')) {\n    $cloudFront = new Aws\\CloudFront\\CloudFrontClient(\n        $aws->getAwsClientParams()\n    );\n}<\/p>\n\n
if ($aws = eacDoojigger()->getExtension('Simple_AWS')) {\n    $cloudFront = new Aws\\CloudFront\\CloudFrontClient(\n        $aws->getAwsClientParams()\n    );\n}<\/p>\n\n
if ($aws = $this->plugin->getExtension('Simple_AWS')) {\n    if ($awsParams = $aws->getAwsClientParams()) {\n        try {\n            $s3client = new \\Aws\\S3\\S3Client($awsParams);\n            $result = $s3client->createBucket([\n                'Bucket'    => $bucketName,\n            ]);\n            $result = $s3client->putObject([\n                'Bucket'    => $bucketName,\n                'Key'       => $fileName,\n                'Metadata'  => $metadata,\n                'Body'      => json_encode($payload,JSON_PRETTY_PRINT),\n            ]);\n        } \n        catch (\\AwsException $exception) {\n            $this->logError($exception,\"AWS S3Client Error\");\n        }\n    }\n}<\/p>\n\n
`\n<\/code><\/pre>\n\n
Simple AWS S3 Events<\/h4>\n\n
The Simple AWS S3 Events<\/em> extension is intended to facilitate events through AWS EventBridge, passing data from and to WordPress\/WooCommerce ... but you may find other uses.<\/p>\n\n
    \n
  1. A webhook delivery URL<\/em> is created to be used by WooCommerce to send data (order, product, or coupon) as a file to an AWS S3 bucket.<\/p><\/li>\n
  2. An EventBridge Target URL<\/em> is created to accepts data from AWS EventBridge derived from the file saved to the S3 bucket.<\/p><\/li>\n<\/ol>\n\n
    These 2 features may be used by the same WordPress installation (though I'm not sure why) or by different, even several, installations to route WooCommerce data to other destinations.<\/p>\n\n
    For example:<\/p>\n\n
    \nSite1 \\                                                      \/ EventBridge Target -> Site5\nSite2 -> - WC Webhook Delivery -> [ Site4 ] -> - S3 Bucket ->  EventBridge Target -> Site6\nSite3 \/                                                      \\ EventBridge Target -> Site7\n<\/pre>\n\n
    One or many WooCommerce sites can use the WebHook Delivery URL<\/em> of another site to send orders through that site and then on to an S3 bucket as individual files.<\/p>\n\n
    EventBridge can be configured to deliver S3 files to one (or many) WordPress sites using the EventBridge Target URL<\/em>.<\/p>\n\n
    This extension creates the APIs and formats the data to be sent to or received from AWS. To process data beyond what this extension does, you may use any of these actions:\n    `php\n\/**\n * action _eventbridge_<object|order|product|coupon>\n * @param object $file - S3 file object ($file->get('Body') to get contents)\n * @param array  $meta - EventBridge API metadata\n * @param string $type - object type (order|product|coupon)\n * @param string $name - object file name\n *\/\nadd_action( \"eacDoojigger_eventbridge_object\",  'my_eventbridge_action', 10, 4 );\nadd_action( \"eacDoojigger_eventbridge_order\",   'my_eventbridge_action', 10, 4 );\nadd_action( \"eacDoojigger_eventbridge_product\", 'my_eventbridge_action', 10, 4 );\nadd_action( \"eacDoojigger_eventbridge_coupon\",  'my_eventbridge_action', 10, 4 );<\/p>\n\n
    function my_EventBridge_action($file, $payload, $type, $fileName) {\n    $data = $file->get('Body');\n}\n    `<\/p>\n\n
    WooCommerce Setup<\/strong><\/p>\n\n
    WooCommerce Webhooks can be added for Orders, Products, or Coupons. When creating a new webhook (WooCommerce -> Settings -> Advanced -> Webhooks) use the Webhook Delivery URL<\/code> and Webhook Secret<\/code> provided by this extension.<\/p>\n\n
    S3 Setup<\/strong><\/p>\n\n
    This extension, by default, creates a new S3 bucket named wc-webhook-<your-site-name><\/code>. To override this or use an existing bucket...\n    php\nadd_action( \"eacDoojigger_eventbridge_bucketname\", function($bucketName) {\n    return 'my-s3-bucket';\n} );<\/code><\/p>\n\n
    S3 bucket filenames are wc_<order|product|coupon>_##.json<\/code>, e.g. wc_order_300.json<\/code>. To override the file name used...\n    php\nadd_action( \"eacDoojigger_eventbridge_filename\", function($fileName, $objectType, $objectId) {\n    return 'my_s3_' . $objectType . '_' . $objectId . '.json';\n},10,3 );<\/code><\/p>\n\n
    When changing the bucket name and\/or file name, the Event pattern<\/em> shown below will also have to be changed.<\/p>\n\n
    EventBridge Setup<\/strong><\/p>\n\n
    There are several steps and configurations needed to get EventBridge working properly. Below are the key components needed for proper configuration, other options may be set to your preferences\/needs.<\/p>\n\n
    In AWS EventBridge:<\/p>\n\n
      \n
    1. EventBridge -> Connections -> Create Connection<\/li>\n<\/ol>\n\n