README

Consume for Craft CMS

Consume is a Craft CMS plugin for making HTTP requests in your Twig templates. Integrates with the Auth module to make it possible to use OAuth clients without having to worry about refresh tokens, token management, etc.

It's your complete solution to fetch and consume data from third-party API providers.

Features

• Create OAuth or Credential clients to make requests with. Save settings in the control panel to use in your templates.
• Create Guzzle requests in your Twig templates for on-demand data fetching.
• Parse JSON, XML and CSV responses from endpoints into arrays. Also supports HTML and raw text!
• Automatic cache control to save requests, or control it yourself with {% cache %} tags.
• Create your own OAuth or Credential clients with our Generic clients.
• Provides events to write your own clients.

Supports

Consume supports 80+ popular OAuth-based API providers for you to create clients for.

• Amazon
• Apple
• Auth0
• Aweber
• Azure
• Basecamp
• Bitbucket
• Box
• Buddy
• Buffer
• ConstantContact
• Deezer
• DeviantArt
• Discord
• Disqus
• Docusign
• Dribbble
• Drip
• Dropbox
• Envato
• Etsy
• Eventbrite
• Facebook
• Fitbit
• Foursquare
• FreshBooks
• GitHub
• GitLab
• Google
• GoToWebinar
• Gumroad
• Harvest
• Heroku
• HubSpot
• Imgur
• Infusionsoft
• Instagram
• Jira
• Line
• LinkedIn
• Linode
• Mailchimp
• Mailru
• Marketo
• Mastodon
• Meetup
• Microsoft
• Mollie
• Odnoklassniki
• PayPal
• Pinterest
• Pipedrive
• Reddit
• Salesforce
• Shopify
• Slack
• Snapchat
• SoundCloud
• Spotify
• Square
• StackExchange
• Strava
• Stripe
• Sugarcrm
• TikTok
• Trello
• Trustpilot
• Tumblr
• Twitch
• Twitter
• Uber
• Unsplash
• Vend
• Vimeo
• Vkontakte
• WeChat
• Weibo
• Yahoo
• Yelp
• Zendesk
• Zoho

We also provide a "Generic" OAuth client in case your provider isn't in the list above.

Documentation

Visit the Consume Plugin page for all documentation, guides, pricing and developer resources.

Support

Get in touch with us via the Consume Support page or by creating a Github issue