jsdecena/mailchimp

MailChimp subscription

Installs: 28 337

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 2

Forks: 1

Open Issues: 1

Type:project

7.0.5 2017-09-15 14:38 UTC

This package is auto-updated.

Last update: 2024-11-09 15:31:03 UTC


README

Build Status Latest Stable Version Total Downloads License

MailChimp API v2.0 Laravel PHP Example

Installation

  • Step1: Add this to your root composer.json
	"require": {
	    "jsdecena/mailchimp": "^7.0"
	}

Or issue this command:

composer require jsdecena/mailchimp

  • Step2: Add this to your config/app.php in providers array
	'providers' => [
	    Jsdecena\MailChimp\MailChimpServiceProvider::class,
	]
  • Step3: Run this in your terminal

php artisan vendor:publish --provider="Jsdecena\MailChimp\MailChimpServiceProvider"

  • Step4: Include the template anywhere in your template @include('mailchimp::mailchimp')

  • Step5: Set the variable in your .env file

MAILCHIMP_API_KEY=YourMailChimpAPIKey

MAILCHIMP_LIST_ID=YourMailChimpListId

  • Step6: Enjoy!

Overriding the template file?

  • Yes you can. Override the file in /resources/views/vendor/mailchimp/mailchimp.blade.php

What is new with 1.6?

  • Recently, I learned the power of doing TDD (test driven development) on applications using PHPUnit. So now, I am already throwing exception messages whenever there is an issue on the request!

What are the exception messages we are returning?

  • Email that MailChimp does not allow
  {
    "error": "List_RoleEmailMember: test@test.com is an invalid email address and cannot be imported."
  }
  • Wrong API key provided
  {
    "error":"Invalid MailChimp API key: 1112e36f7f44ef4cc3c5a584747abb05be"
  }
  • Wrong List ID provided
  {
    "error":"Invalid MailChimp List ID: accf6b0a0e111"
  }

And if the subscription is successful, it will return the email, euid, leid on the data object

  {
    "data": {
      "email":"super@mario.com",
      "euid":"b0b8fdacbd",
      "leid":"430369209"
    }
  }