From 53ce359a762b7146b2a6287d5cf27ddaff096101 Mon Sep 17 00:00:00 2001 From: VladimirAus Date: Fri, 2 Oct 2020 13:13:52 +1000 Subject: [PATCH 1/9] Updated help. --- README.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 5a55579..26130b4 100644 --- a/README.md +++ b/README.md @@ -244,7 +244,7 @@ All URIs are relative to *https://server.api.mailchimp.com/3.0* | **lists.removeSegmentMember** | /lists/{list_id}/segments/{segment_id}/members/{subscriber_hash} | | **lists.deleteListWebhook** | /lists/{list_id}/webhooks/{webhook_id} | | **lists.getListMemberTags** | /lists/{list_id}/members/{subscriber_hash}/tags | -| **lists.getAllLists** | /lists | +| [**lists.getAllLists**](#lists.getAllLists) | /lists | | **lists.getList** | /lists/{list_id} | | **lists.getListAbuseReports** | /lists/{list_id}/abuse-reports | | **lists.getListAbuseReportDetails** | /lists/{list_id}/abuse-reports/{report_id} | @@ -347,6 +347,18 @@ All URIs are relative to *https://server.api.mailchimp.com/3.0* | **verifiedDomains.getVerifiedDomainsAll** | /verified-domains | | **verifiedDomains.submitDomainVerification** | /verified-domains/{domain_name}/actions/verify | +## Examples + +### lists.getAllLists + +``` +$response = $mailchimp->lists->getAllLists(); +foreach ($response->lists as $list) { + $list_id = $list->id; + $list_name = $list->name; + ... +} +``` ## Additional Client Libraries From e0d88592f2ffe09289e10fbe788f1ff6ea50f2ac Mon Sep 17 00:00:00 2001 From: VladimirAus Date: Fri, 2 Oct 2020 13:15:35 +1000 Subject: [PATCH 2/9] Updated help for lists.getAllLists. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 26130b4..b2ab152 100644 --- a/README.md +++ b/README.md @@ -244,7 +244,7 @@ All URIs are relative to *https://server.api.mailchimp.com/3.0* | **lists.removeSegmentMember** | /lists/{list_id}/segments/{segment_id}/members/{subscriber_hash} | | **lists.deleteListWebhook** | /lists/{list_id}/webhooks/{webhook_id} | | **lists.getListMemberTags** | /lists/{list_id}/members/{subscriber_hash}/tags | -| [**lists.getAllLists**](#lists.getAllLists) | /lists | +| [**lists.getAllLists**](#listsgetalllists) | /lists | | **lists.getList** | /lists/{list_id} | | **lists.getListAbuseReports** | /lists/{list_id}/abuse-reports | | **lists.getListAbuseReportDetails** | /lists/{list_id}/abuse-reports/{report_id} | From 6e276a0c3f803f6adc166d7d98452d1961e85de1 Mon Sep 17 00:00:00 2001 From: VladimirAus Date: Fri, 2 Oct 2020 13:19:19 +1000 Subject: [PATCH 3/9] Updated help for lists.getListInterestCategories. --- README.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index b2ab152..de6ce85 100644 --- a/README.md +++ b/README.md @@ -252,7 +252,7 @@ All URIs are relative to *https://server.api.mailchimp.com/3.0* | **lists.getListClients** | /lists/{list_id}/clients | | **lists.getListGrowthHistory** | /lists/{list_id}/growth-history | | **lists.getListGrowthHistoryByMonth** | /lists/{list_id}/growth-history/{month} | -| **lists.getListInterestCategories** | /lists/{list_id}/interest-categories | +| [**lists.getListInterestCategories**](#listsgetlistinterestcategories) | /lists/{list_id}/interest-categories | | **lists.getInterestCategory** | /lists/{list_id}/interest-categories/{interest_category_id} | | **lists.listInterestCategoryInterests** | /lists/{list_id}/interest-categories/{interest_category_id}/interests | | **lists.getInterestCategoryInterest** | /lists/{list_id}/interest-categories/{interest_category_id}/interests/{interest_id} | @@ -360,6 +360,17 @@ foreach ($response->lists as $list) { } ``` +### lists.getListInterestCategories + +``` +$response = $mailchimp->lists->getListInterestCategories($list_id); +foreach ($response->categories as $category) { + $category_id = $category->id; + $category_title = $category->title; + ... +} +``` + ## Additional Client Libraries Mailchimp Marketing libraries are available in the following languages: From 298022f332ce288ccb71bff90cffe4e3ad2fa7ca Mon Sep 17 00:00:00 2001 From: VladimirAus Date: Fri, 30 Oct 2020 23:45:18 +1000 Subject: [PATCH 4/9] Creted lists.getList help. --- README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index de6ce85..51a7fd0 100644 --- a/README.md +++ b/README.md @@ -245,7 +245,7 @@ All URIs are relative to *https://server.api.mailchimp.com/3.0* | **lists.deleteListWebhook** | /lists/{list_id}/webhooks/{webhook_id} | | **lists.getListMemberTags** | /lists/{list_id}/members/{subscriber_hash}/tags | | [**lists.getAllLists**](#listsgetalllists) | /lists | -| **lists.getList** | /lists/{list_id} | +| [**lists.getList**](#listsgetlist) | /lists/{list_id} | | **lists.getListAbuseReports** | /lists/{list_id}/abuse-reports | | **lists.getListAbuseReportDetails** | /lists/{list_id}/abuse-reports/{report_id} | | **lists.getListRecentActivity** | /lists/{list_id}/activity | @@ -360,6 +360,19 @@ foreach ($response->lists as $list) { } ``` +### lists.getList + +``` +$list_id = '7f4f516be'; +$response = $mailchimp->lists->getList($list_id); +if ($response->lists && is_array($response->lists) && count($response->lists)) { + $list = reset($response); + $list_id = $response->id; + $list_name = $response->name; + ... +} +``` + ### lists.getListInterestCategories ``` From 956a66affdaea981ea2fbfeca473c72bc8954c67 Mon Sep 17 00:00:00 2001 From: VladimirAus Date: Fri, 30 Oct 2020 23:46:42 +1000 Subject: [PATCH 5/9] Creted lists.getList help. --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 51a7fd0..534ad03 100644 --- a/README.md +++ b/README.md @@ -367,8 +367,8 @@ $list_id = '7f4f516be'; $response = $mailchimp->lists->getList($list_id); if ($response->lists && is_array($response->lists) && count($response->lists)) { $list = reset($response); - $list_id = $response->id; - $list_name = $response->name; + $list_id = $list->id; + $list_name = $list->name; ... } ``` From 1670cafc2645a97b2b6db7b90bdae01a8faf9836 Mon Sep 17 00:00:00 2001 From: VladimirAus Date: Sat, 31 Oct 2020 00:01:52 +1000 Subject: [PATCH 6/9] Creted lists.listSegments help. --- README.md | 22 ++++++++++++++++++---- 1 file changed, 18 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 534ad03..d462eb3 100644 --- a/README.md +++ b/README.md @@ -295,7 +295,7 @@ All URIs are relative to *https://server.api.mailchimp.com/3.0* | **lists.createSegmentMember** | /lists/{list_id}/segments/{segment_id}/members | | **lists.updateListSignupForm** | /lists/{list_id}/signup-forms | | **lists.createListWebhook** | /lists/{list_id}/webhooks | -| **lists.listSegments** | /lists/{list_id}/segments | +| [**lists.listSegments**](#listslistsegments) | /lists/{list_id}/segments | | **lists.previewSegment** | /lists/{list_id}/preview-segment | | **lists.setListMember** | /lists/{list_id}/members/{subscriber_hash} | | **ping.get** | /ping | @@ -364,9 +364,8 @@ foreach ($response->lists as $list) { ``` $list_id = '7f4f516be'; -$response = $mailchimp->lists->getList($list_id); -if ($response->lists && is_array($response->lists) && count($response->lists)) { - $list = reset($response); +$list = $mailchimp->lists->getList($list_id); +if ($list) { $list_id = $list->id; $list_name = $list->name; ... @@ -384,6 +383,21 @@ foreach ($response->categories as $category) { } ``` +### lists.listSegments + +``` +$list_id = '7f4f516be'; +$response = $mailchimp->lists->listSegments($list_id); +if ($response) { + foreach ($response->segments as $segment) { + $segment_id = $segment->id; + $segment_name = $segment->name; + $segment_member_count = $segment->member_count; + $segment_list_id = $segment->list_id; + } +} +``` + ## Additional Client Libraries Mailchimp Marketing libraries are available in the following languages: From 064246bbd1a0e3b8578e42a57d03cc6620218aad Mon Sep 17 00:00:00 2001 From: VladimirAus Date: Mon, 2 Nov 2020 16:05:04 +1000 Subject: [PATCH 7/9] Updated examples. --- README.md | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d462eb3..baec325 100644 --- a/README.md +++ b/README.md @@ -240,7 +240,7 @@ All URIs are relative to *https://server.api.mailchimp.com/3.0* | **lists.deleteListMember** | /lists/{list_id}/members/{subscriber_hash} | | **lists.deleteListMemberNote** | /lists/{list_id}/members/{subscriber_hash}/notes/{note_id} | | **lists.deleteListMergeField** | /lists/{list_id}/merge-fields/{merge_id} | -| **lists.deleteSegment** | /lists/{list_id}/segments/{segment_id} | +| [**lists.deleteSegment**](#listsdeletesegment) | /lists/{list_id}/segments/{segment_id} | | **lists.removeSegmentMember** | /lists/{list_id}/segments/{segment_id}/members/{subscriber_hash} | | **lists.deleteListWebhook** | /lists/{list_id}/webhooks/{webhook_id} | | **lists.getListMemberTags** | /lists/{list_id}/members/{subscriber_hash}/tags | @@ -290,7 +290,7 @@ All URIs are relative to *https://server.api.mailchimp.com/3.0* | **lists.deleteListMemberPermanent** | /lists/{list_id}/members/{subscriber_hash}/actions/delete-permanent | | **lists.createListMemberNote** | /lists/{list_id}/members/{subscriber_hash}/notes | | **lists.addListMergeField** | /lists/{list_id}/merge-fields | -| **lists.createSegment** | /lists/{list_id}/segments | +| [**lists.createSegment**](#listscreatesegment) | /lists/{list_id}/segments | | **lists.batchSegmentMembers** | /lists/{list_id}/segments/{segment_id} | | **lists.createSegmentMember** | /lists/{list_id}/segments/{segment_id}/members | | **lists.updateListSignupForm** | /lists/{list_id}/signup-forms | @@ -349,6 +349,24 @@ All URIs are relative to *https://server.api.mailchimp.com/3.0* ## Examples +### lists.createSegment + +``` +// Create tag (static). +$segment = $mailchimp->lists->createSegment($list_id, '{"name":"Tag 1","static_segment":[]}'); +// Create segment (dynamic tag). +$segment = $mailchimp->lists->createSegment($list_id, '{"name":"Segment 2","options":{"match":"any","conditions":[]}}'); +``` + +### lists.deleteSegment + +``` +$segment_id = $segment->id; +$segment_list_id = $segment->list_id; + +$mailchimp->lists->deleteSegment($segment_list_id, $segment_id); +``` + ### lists.getAllLists ``` From bc10bfab7418d5c1d018e7efeac48cc7db96e9c2 Mon Sep 17 00:00:00 2001 From: VladimirAus Date: Thu, 4 Mar 2021 15:52:47 +1000 Subject: [PATCH 8/9] Updated help. --- README.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index baec325..ec40c93 100644 --- a/README.md +++ b/README.md @@ -355,7 +355,8 @@ All URIs are relative to *https://server.api.mailchimp.com/3.0* // Create tag (static). $segment = $mailchimp->lists->createSegment($list_id, '{"name":"Tag 1","static_segment":[]}'); // Create segment (dynamic tag). -$segment = $mailchimp->lists->createSegment($list_id, '{"name":"Segment 2","options":{"match":"any","conditions":[]}}'); +$segment = $mailchimp->lists->createSegment($list_id, + '{"name":"Segment 2","options":{"match":"any","conditions":[]}}'); ``` ### lists.deleteSegment @@ -405,7 +406,10 @@ foreach ($response->categories as $category) { ``` $list_id = '7f4f516be'; +// Load up to 10 tags. $response = $mailchimp->lists->listSegments($list_id); +// Load up to 200 tags. +$response = $mailchimp->lists->listSegments($list_id, NULL, NULL, '200'); if ($response) { foreach ($response->segments as $segment) { $segment_id = $segment->id; From 1cd182dbd389fccd76801bded6342248dcc056cd Mon Sep 17 00:00:00 2001 From: VladimirAus Date: Thu, 4 Mar 2021 15:59:12 +1000 Subject: [PATCH 9/9] Allowing Guzzle 6 and 7. --- composer.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/composer.json b/composer.json index bbc088c..249f6ba 100644 --- a/composer.json +++ b/composer.json @@ -21,7 +21,7 @@ "ext-curl": "*", "ext-json": "*", "ext-mbstring": "*", - "guzzlehttp/guzzle": "^7.2" + "guzzlehttp/guzzle": "^6.2|^7.2" }, "require-dev": { "phpunit/phpunit": "^7",