Skip to content

Commit 8aea960

Browse files
author
John Hutcheson
authored
Merge pull request #49 from Jhut89/3.0.0
Prepare Readme for release
2 parents 580aa8e + 7808757 commit 8aea960

File tree

1 file changed

+6
-62
lines changed

1 file changed

+6
-62
lines changed

README.md

Lines changed: 6 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,3 @@
1-
## VERSION 3.0.0 COMING - August 27th 2018
2-
3-
Version 3.0.0 of this library will introduce several *new features*, and some **breaking changes**.
4-
`master` is the current dev branch for version 3.0.0. A formal release with a tag will be made once it is considered stable.
5-
6-
### Incoming Features
7-
8-
* Namespaced classes
9-
* Full PSR-4 Autoloading via _Composer_
10-
* Tests
11-
* Programmatically alterable settings
12-
* Success & Failure Callbacks
13-
* Support for new endpoints
14-
15-
### Breaks From Older Versions
16-
17-
* No non-autoloading option
18-
* Class names and directory structure changes
19-
20-
If these changes are breaking for your app we suggest you wait on updating to 3.0.0. Upcoming changes can now be viewed in `master` (`dev-master` on [packagist](https://packagist.org/packages/jhut89/mailchimp3php)) before the release is made. As well feel free to pull in an
21-
older version by requiring the version you want in your `composer.json`:
22-
23-
```json
24-
{
25-
"require": {
26-
"jhut89/mailchimp3php": "2.3.*"
27-
}
28-
}
29-
30-
```
31-
321
# Table Of Contents
332
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
343
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
@@ -44,10 +13,6 @@ older version by requiring the version you want in your `composer.json`:
4413
- [DELETE](#delete)
4514
- [Handling A Response](#handling-a-response)
4615
- [Method Chart (\*excluding verbs)](#method-chart-heading)
47-
- [Settings](#settings)
48-
- [Debugger](#debugger)
49-
- [SSL Verify](#ssl-verify)
50-
- [Request Headers](#request-headers)
5116

5217
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
5318

@@ -178,6 +143,7 @@ $mailchimp
178143
->get();
179144
```
180145

146+
> You can read about `GET` requests in depth here: https://github.com/Jhut89/Mailchimp-API-3.0-PHP/wiki/Get-Requests
181147
### POST
182148

183149
While being able to retrieve data from your account is great we also need to be able to post new data. This can be done by calling the `POST()` method at the end of a chain. As an example subscribing an address to a list would look like this:
@@ -214,6 +180,7 @@ $mailchimp
214180
->members()
215181
->post($post_params);
216182
```
183+
> You can read about `POST` requests in depth here: https://github.com/Jhut89/Mailchimp-API-3.0-PHP/wiki/Post-Requests
217184
218185
### PATCH &amp; PUT
219186

@@ -227,6 +194,7 @@ $mailchimp
227194
"merge_fields" => ["FNAME" => "Jane"]
228195
]);
229196
```
197+
> You can read about `PATCH` & `PUT` requests in depth here: https://github.com/Jhut89/Mailchimp-API-3.0-PHP/wiki/Patch-&-Put-Requests
230198
231199
### DELETE
232200

@@ -238,6 +206,7 @@ $mailchimp
238206
->members('a1167f5be2df7113beb69c95ebcdb2fd')
239207
->delete();
240208
```
209+
> You can read about `DELETE` requests in depth here: https://github.com/Jhut89/Mailchimp-API-3.0-PHP/wiki/Delete-Requests
241210
## Handling A Response
242211

243212
Methods named for http verbs such as `get()` ,`post()`, `patch()`, `put()`, or `delete()` kick off an over the wire request to MailChimp's A.P.I. Given a successful request these methods return an instance of a `MailchimpResponse`.
@@ -267,6 +236,8 @@ $contact_email = $account
267236
print $contact_email; // outputs something like "example@domain.com"
268237
```
269238

239+
> You can read about how to work with responses in depth here: https://github.com/Jhut89/Mailchimp-API-3.0-PHP/wiki/Handling-A-Response
240+
270241
## <a name="method-chart-heading"></a>Method Chart (\*excluding verbs)
271242

272243
@@ -408,33 +379,6 @@ print $contact_email; // outputs something like "example@domain.com"
408379
\*Please see [MailChimp's API Documentation](http://developer.mailchimp.com/documentation/mailchimp/reference/overview/) for what verbs are appropriate where.
409380

410381
\** Methods marked with a `*` make a network request
411-
## Settings
412-
413-
This library offers several setting that can be altered by changing the value of the class constants at the begining of the `Mailchimp` class in the `mailchimpRoot.php` file. Be sure to check them out to see if they can be altered to fit your project a little better.
414-
415-
### Debugger
416-
This library has a very small debug function that will allow you to output some request information and what was returned. This can be turned on by setting:
417-
418-
```php
419-
const DEBUGGER = true;
420-
```
421-
The debugger can also log to a file if you provide a file for it to write to using `const DEBUGGER_LOG_FILE` like this:
422-
423-
```php
424-
const DEBUGGER_LOG_FILE = 'path/to/some/file.php';
425-
```
426-
427-
By default this option is set to `false`.
428-
429-
### SSL Verify
430-
`CURLOPT_SSL_VERIFYPEER` can be disabled by setting:
431-
432-
```php
433-
const VERIFY_SSL = false;
434-
````
435-
436-
By default this option is set to `true`.
437-
438382

439383
\*\*Please watch for updates, and feel free to Fork or Pull Request. Check out the Wiki for a little more info on contributing.
440384

0 commit comments

Comments
 (0)