lukeyouell/craft3-fetch

Utilise the Guzzle HTTP client from within your Craft templates.

, _(*1)

Fetch plugin for Craft CMS 3.x

Utilise the Guzzle HTTP client from within your Craft templates., _(*2)

Requirements

This plugin requires Craft CMS 3.0.0 or later., _(*3)

Installation

To install the plugin, follow these instructions., _(*4)

1. Open your terminal and go to your Craft project:, _(*5)

   cd /path/to/project

2. Then tell Composer to load the plugin:, _(*6)

   composer require jalendport/craft-fetch

3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Fetch., _(*7)

Using Fetch

This plugin is built to work with the standard Guzzle request options, _(*8)

Parameters

Example Usage

Request

{% set client = {
    base_uri : 'https://gtmetrix.com',
    timeout : 10
} %}

{% set options = {
    auth : ['username', 'password'],
    form_params : {
      url : 'https://www.google.co.uk'
    }
} %}

{% set request = fetch(client, 'POST', 'api/0.1/test', options) %}

Response (successful)

{
   "statusCode":200,
   "reason":"OK",
   "body": {
      "credits_left":30,
      "test_id":"JDHFbrt7",
      "poll_state_url":"https:\/\/gtmetrix.com\/api\/0.1\/test\/JDHFbrt7"
   }
}

You can fetch the string response by adding an additional parameter of false like so:, _(*9)

{% set request = fetch(client, 'POST', 'api/0.1/test', options, false) %}

Response (error)

{
   "error":true,
   "reason":"Client error: `POST https:\/\/gtmetrix.com\/api\/0.1\/test` resulted in a `401 Authorization Required` response:\n{\u0022error\u0022:\u0022Invalid e-mail and\/or API key\u0022}\n\n"
}

Fetch Roadmap

Some things to do, and ideas for potential features:, _(*10)

Brought to you by Luke Youell, _(*11)