Paid Memberships Pro – Mailchimp Add On

Beschrijving

Abonneer WordPress gebruikers en leden op je Mailchimp doelgroepen.

Deze plugin biedt uitgebreide functionaliteit voor lidmaatschapswebsites met behulp van de Paid Memberships Pro plugin die gratis beschikbaar is in de WordPress plugin repository.

Als Paid Memberships Pro is geïnstalleerd, kun je unieke doelgroepen voor elk lidmaatschapsniveau specificeren, evenals opt-in doelgroepen waaraan een lid kan deelnemen als onderdeel van het afrekenen of door hun gebruikersprofiel te bewerken. Standaard voegt de integratie het e-mailadres van de gebruiker en het lidmaatschapsniveau samen. Je kunt aanvullende gebruikersprofielgegevens verzenden naar Mailchimp met behulp van de hier beschreven methode.

Op de instellingenpagina kan de sitebeheerder specificeren aan welke doelgroeplijsten gebruikers en leden moeten worden toegewezen, plus extra functies die je mogelijk wilt aanpassen. De eerste stap is om je website te verbinden met Mailchimp met behulp van de API sleutel van je account. Zo vind je de API sleutel in Mailchimp:

Aanvullende instellingen

  • Lidmaatschap Niveaus en doelgroepen: dit zijn de doelgroepen waarop gebruikers automatisch kunnen worden geabonneerd wanneer ze een lidmaatschapsniveau ontvangen.
  • Aanmeldingsdoelgroepen: dit zijn de doelgroepen waarop gebruikers zich kunnen abonneren tijdens het PMPro afrekenproces. Gebruikers kunnen hun keuze later vanuit hun profiel bijwerken. Doelgroepen die zijn ingesteld als Opt-in doelgroepen, mogen niet ook worden ingesteld als een niet-ledendoelgroep of een niveau-doelgroep.
  • Dubbele opt-in vereisen?: Indien ingesteld op “Ja (alle doelgroepen)”, krijgen gebruikers de status “In behandeling” in Mailchimp wanneer ze worden toegevoegd aan een doelgroep in plaats van dat ze meteen worden geabonneerd. Ze ontvangen dan een e-mail van Mailchimp om zich aan te melden voor het publiek.
  • Afmelden bij niveauwijziging?: Indien ingesteld op ‘Nee’, worden gebruikers niet automatisch uitgeschreven voor doelgroepen wanneer ze een lidmaatschapsniveau verliezen. Als dit is ingesteld op ‘Ja (alleen oude doelgroepen)’, wordt het abonnement van gebruikers op elk niveau waarop ze zijn geabonneerd, opgezegd wanneer ze dat niveau verliezen, ervan uitgaande dat die doelgroep ook geen niet-leden is. Indien ingesteld op “Ja (Oud niveau en opt-in-doelgroepen.)”, worden gebruikers ook uitgeschreven van opt-in-doelgroepen wanneer ze hun lidmaatschapsniveau verliezen (hoewel ze zich opnieuw kunnen abonneren door de instelling in hun profiel bij te werken).
  • Update op profiel opslaan: Indien ingesteld op “Ja”, zal PMPro Mailchimp-doelgroepen bijwerken wanneer de profielpagina van een gebruiker wordt opgeslagen. Indien ingesteld op “Nee”, zal PMPro Mailchimp alleen bijwerken wanneer het lidmaatschapsniveau van een gebruiker wordt gewijzigd, het e-mailadres wordt gewijzigd of de gekozen opt-in-doelgroepen worden gewijzigd.
  • API aanroepen loggen?: Indien ingesteld op “Ja”, worden API aanroepen naar Mailchimp vastgelegd in de map /pmpro-mailchimp/logs.
  • Lidmaatschapsniveaus en doelgroepen: dit zijn de doelgroepen waarop gebruikers automatisch worden geabonneerd wanneer ze een lidmaatschapsniveau ontvangen.

Schermafdrukken

  • Algemene instellingen voor plugins, inclusief de aanmeldregels voor niet-leden, en afmeldregels.
  • Specifieke instellingen voor lidmaatschapsniveaus en doelgroepen.

Installatie

Deze plugin werkt met en zonder Paid Memberships Pro geïnstalleerd.

Download, installeer en activeer!

  1. Upload de pmpro-mailchimp folder naar de /wp-content/plugins/ folder van je site.
  2. De plugin activeren via het ‘Plugin’ menu in WordPress.
  3. Navigeer naar Instellingen > PMPro Mailchimp om door te gaan met de installatie.

Configuratie en instellingen

Voer je Mailchimp API sleutel in: Je Mailchimp API sleutel vindt je in je Mailchimp account onder Account > Extra’s > API sleutels. Als je geen Mailchimp account hebt, je kunt er hier een maken. Lees onze documentatie voor een video die laat zien hoe u uw Mailchimp API sleutel kunt vinden.

Nadat je je API sleutel hebt ingevoerd, ga je verder met de installatie door gebruikers- of ledendoelgroepen toe te wijzen en de aanvullende instellingen te bekijken.

Ga voor volledige documentatie over alle instellingen naar de Mailchimp Integration Add On-documentatiepagina op Paid Memberships Pro.

Er zijn verschillende actie- en filterhooks beschikbaar voor ontwikkelaars die specifieke aspecten van de integratie moeten aanpassen. Bekijk hier de actie van de plugin en filter hooks.

FAQ

Ik heb een bug in de plugin gevonden.

Plaats het in de issues sectie van GitHub en we zullen het zo snel mogelijk oplossen. Bedankt voor het helpen. https://github.com/strangerstudios/pmpro-mailchimp/issues

Ik heb hulp nodig bij het installeren, configureren of aanpassen van de plugin.

Bezoek onze ondersteuning site op https://www.paidmembershipspro.com voor meer documentatie en onze ondersteuningsforums.

Beoordelingen

1 maart 2023 1 reactie
While the plugin can be used standalone, it stand out best when used with the PMPRO plugin. As a companion plugin for syncing members and member information to Mail Chimp it works well and is flexible. The multiple triggers and ability to define custom user meta to pass to Mail Chimp merge tags is great. I would love to see it better support tagging and tagging based on events and changes in the membership system.
25 september 2017
Causes same error now that mike1mus above mentioned. It used to work, is there a problem with the new WordPress version?
17 september 2017
Trying to install this plugin and it only generates a fatal error. Will definitely look for a different plugin that actually installs correctly on a current version of Wordpress. Fatal error: Uncaught Error: Call to a member function get_error_message() on array in /home1/southfn2/public_html/hombredr/wp-content/plugins/pmpro-mailchimp/includes/class.mailchimp.api.php:122 Stack trace: #0 /home1/southfn2/public_html/hombredr/wp-content/plugins/pmpro-mailchimp/pmpro-mailchimp.php(187): PMProMailChimp->connect() #1 /home1/southfn2/public_html/hombredr/wp-content/plugins/pmpro-mailchimp/pmpro-mailchimp.php(777): pmpromc_getAPI() #2 /home1/southfn2/public_html/hombredr/wp-includes/class-wp-hook.php(298): pmpromc_options_page('') #3 /home1/southfn2/public_html/hombredr/wp-includes/class-wp-hook.php(323): WP_Hook->apply_filters('', Array) #4 /home1/southfn2/public_html/hombredr/wp-includes/plugin.php(453): WP_Hook->do_action(Array) #5 /home1/southfn2/public_html/hombredr/wp-admin/admin.php(222): do_action('settings_page_p...') #6 /home1/southfn2/public_html/hombredr/wp-admin/options-general.php(10): require_once('/home1/southfn2...') #7 {main} thrown in /home1/southfn2/public_html/hombredr/wp-content/plugins/pmpro-mailchimp/includes/class.mailchimp.api.php on line 122
30 oktober 2016
Works but on membership cancellation, the plugin only removes Members from it's membership level's List but not from the All User's List.
Lees alle 11 beoordelingen

Bijdragers & ontwikkelaars

“Paid Memberships Pro – Mailchimp Add On” is open source software. De volgende personen hebben bijgedragen aan deze plugin.

Bijdragers

“Paid Memberships Pro – Mailchimp Add On” is vertaald in 2 talen. Dank voor de vertalers voor hun bijdragen.

Vertaal “Paid Memberships Pro – Mailchimp Add On” naar jouw taal.

Interesse in ontwikkeling?

Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.

Changelog

2.3.3 – 2023-03-01

  • ENHANCEMENT: Improved formatting of opt-in audience section on checkout page. (@mircobabini)
  • ENHANCEMENT: Added filter pmpromc_log_path to allow changing the path where API calls are logged. (@JarrydLong)
  • BUG FIX/ENHANCEMENT: Now using readfile() during CSV export if fpassthru() is not available. (@JarrydLong)
  • REFACTOR: Marking the set_user_interest() method as deprecated. (@dparker1005)

2.3.2 – 2021-03-02

  • VERBETERING: Instelling toegevoegd om API aanroepen die naar Mailchimp zijn verzonden te loggen in de map pmpro-mailchimp/logs.
  • VERBETERING: Een pmpromc user_data filter toegevoegd om gebruikersgegevens te filteren die naar Mailchimp worden verzonden.
  • VERBETERING: selectievakjes voor doelgroepen worden nu weergegeven als een schuifbare lijst op de instellingenpagina als er meer dan 5 zijn.
  • BUG FIX/VERBETERING: CSS klasse toegevoegd voor checkbox labels.
  • BUG FIX/VERBETERING: Geeft nu een geldig gebruikersobject door bij het genereren van CSV exportbestandheaders.
  • BUG FIX: Vaste niet-gedefinieerde variabele in pmpromc_user_register() (Bedankt, x140l31 op GitHub).
  • BUG FIX: Vaste vereiste parameter wordt opgenomen na optionele parameters in add_merge_field().
  • BUG FIX: URL naar PMPro ondersteuningspagina opgelost (bedankt, majerus1223 op GitHub).

2.3.1 – 2020-04-28

  • VERBETERING: Ondersteuning toegevoegd voor Paid Memberships Pro v2.3+ front-end profielbewerkingspagina.
  • VERBETERING: gebruik nu selectievakjes om doelgroepen te selecteren in plaats van velden

2.3 – 2020-03-25

  • FUNCTIE: Abonnementen/afmeldingen in Mailchimp worden nu overgedragen naar PMPro voor opt-in doelgroepen
  • VERBETERING: instelling toegevoegd om contact in Mailchimp bij te werken wanneer het profiel wordt opgeslagen
  • VERBETERING: opgenomen doelgroepnamen in foutopsporingslogboeken en verbeterde foutrapportage
  • BUG FIX: probleem opgelost waarbij contacten kunnen worden gemaakt in een niet-geabonneerde status in opt-in doelgroepen waarop ze zich niet hadden geabonneerd
  • BUG FIX: probleem opgelost waarbij contacten niet werden verwijderd uit niet-ledenpubliek wanneer ze een niveau kregen
  • BUG FIX: Strings opgelost met het onjuiste tekstdomein
  • BUG FIX: Ampersands in namen opgelost die worden gecodeerd wanneer ze naar Mailchimp worden verzonden
  • BUG FIX: PHP waarschuwing opgelost in API functie in_merge_fields()
  • BUG FIX/VERBETERING: Contacten in Mailchimp worden nu bijgewerkt wanneer het e-mailadres van een gebruiker wordt gewijzigd in plaats van te worden vervangen
  • HERSTRUCTUREER: Georganiseerde code in verschillende bestanden

2.2.1 – 2019-12-31

  • BUG FIX: Vaste samenvoegvelden die niet werden verzonden tijdens updates van gebruikersprofielen
  • BUG FIX: Logboekregistratie voor Mailchimp API aanroepen opgelost
  • BUG FIX: Mailchimp updates worden niet verzonden tijdens wp_redirect-filter

2.2 – 2019-12-19

  • BUG FIX: Updates van e-mailadressen via profiel opgelost.
  • BUG FIX: “Ongeldige API sleutel”-fout opgelost die soms optrad bij nieuwere API sleutels.
  • VERBETERING: Gebruik van “Publiek” in plaats van “Lijst” in strings in de plugin voor consistentie met de naamswijzigingen van Mailchimp.
  • VERBETERING: Gebruik van “Mailchimp” in plaats van “MailChimp” in strings in de plugin voor consistentie met de naamswijzigingen van Mailchimp.
  • VERBETERING: Standaardkolommen naast e-mail verwijderd uit Mailchimp CSV-export. Gebruik nu in plaats daarvan het filter pmpro_mailchimp_listsubscribe_fields.
  • VERBETERING: Gebruikers worden nu uitgeschreven van alle opt-in doelgroepen wanneer ze het lidmaatschap annuleren.
  • BUG FIX/VERBETERING: Updates van Mailchimp abonnees worden verwerkt met behulp van het /lists/ API endpoint om snelheidsbeperking door Mailchimp te voorkomen. Dit lost problemen op die soms zouden optreden als veel leden op dezelfde dag verlopen.
  • BUG FIX/VERBETERING: Gebruikers die annuleren, worden nu uitgeschreven voor het publiek in plaats van verwijderd te worden uit Mailchimp.
  • BUG FIX/VERBETERING: Gebruik nu de Mailchimp lid “status” eigenschap bij het afmelden van leden in plaats van ze te verwijderen.

2.1.2

  • BUG FIX: Controleren op 204 status bij afmelden. We controleerden eerder op 200 en gooiden een fout ten onrechte.
  • BUG FIX: Bug opgelost waarbij gebruikers zich niet afmeldden voor MailChimp toen ze verlopen. Een verdere herstructutering is nodig om te voorkomen dat de MailChimp API limiet wordt bereikt als er veel gebruikers tegelijk worden verwerkt.
  • BUG FIX/VERBETERING: Het label “Alle gebruikers” is gewijzigd in “Niet-leden” om overeen te komen met hoe de instelling daadwerkelijk wordt gebruikt.

2.1.1

  • BUG FIX: Problemen opgelost met foutafhandeling en de weergave van foutmeldingen. In het bijzonder zal het invoeren van een onjuiste API sleutel de instellingenpagina niet langer laten crashen. (Bedankt, Hugh Brock)

2.1

  • BUG: een aantal bugs opgelost met betrekking tot de MailChimp API, inclusief een bug geïntroduceerd in v2.0.3 die er soms voor zorgde dat de plugin gebruikers niet kon abonneren op lijsten.
  • BUG/VERBETERING: We kunnen het aantal API verzoeken beter beperken om API limieten te vermijden.
  • VERBETERING: Ondersteunt de pmpro-meerdere-lidmaatschappen-per-gebruiker Add-on.
  • VERBETERING: Ondersteuning voor lokalisatie toegevoegd. (Nu zou in staat moeten zijn om taalbestanden te maken via GlotPress)

2.0.3

  • BUG: probleem opgelost met het bijwerken van e-mailadressen in MailChimp wanneer e-mailadressen worden bijgewerkt in WordPress.
  • VERBETERING: Een filter pmpromc_profile_update toegevoegd die je kunt instellen op __return_true om de add-on te vertellen gebruikersgegevens te synchroniseren bij elke profielupdate. PMPro MailChimp synchroniseert standaard alleen gegevens als het e-mailadres is gewijzigd. Filter passeert $update_user, $user_id en $old_user_data en is gedocumenteerd in de code.

2.0.2

  • BUG: probleem opgelost waarbij het verkeerde abonnee-ID werd gebruikt voor volgende API-aanroepen wanneer oproepen werden gedaan voor meer dan één abonnee (bijvoorbeeld bij importeren, bulksgewijs bijwerken of leden die verlopen).
  • BUG: andere waarschuwingen, typefouten en kleine bugs opgelost.
  • VERBETERING: filter toegevoegd (pmpro_addon_mc_api_timeout) om de time-out van de API-verbinding aan te passen (standaard is 10 seconden, wat genoeg zou moeten zijn!)

2.0.1

  • BUG: bug opgelost waarbij “aanvullende opt-in lijsten” fatale fouten veroorzaakten bij het afrekenen, indien ingesteld.

2.0.0

  • FIX/vERBETERING: de v2 MailChimp API klasse verwijderd en nu onze eigen API klasse op basis van MailChimps v3 API.
  • FUNCTIE: Voeg nu PMPLEVEL- en PMPLEVELID-samenvoegvelden toe voor gebruikers die aan lijsten zijn toegevoegd. Deze kunnen worden gebruikt om segmenten en groepen aan te maken in MailChimp.
  • FUNCTIE: Een link toegevoegd op de instellingenpagina om een CSV-bestand te exporteren dat speciaal is geformatteerd voor importeren in MailChimp. Dit kan worden gebruikt om bestaande leden als nieuwe abonnees in MailChimp te importeren of om de samenvoegvelden voor bestaande abonnees bij te werken.

1.2

  • De MailChimp API geüpdatet om een $verify_ssl-eigenschap te hebben die de CURLOPT_SSL_VERIFYPEER-optie van de CURL verbinding bestuurt. Dit is standaard ingesteld op false, waardoor sommige problemen worden vermeden die mensen hebben gehad om verbinding te maken met de MailChimp API.

1.1

  • Optie toegevoegd om het lidmaatschapsniveau door te geven aan MailChimp als een aangepast veld.

1.0.7

  • VERBETERING: Het gedeelte Mailinglijsten van de profielpagina voor bewerken wordt niet weergegeven als er geen lijsten zijn ingesteld voor “opt-in lijsten”.
  • BUG: De opties voor “aanvullende lijsten” worden niet weergegeven op de beoordelingspagina bij gebruik van PayPal Express/Standard/etc. (Bedankt, Christopher Souser)
  • BUG: Enkele waarschuwingen opgelost.

1.0.6

  • BUG: waarschuwingen vermijden bij afmelden. (Bedankt, Adam Shaw)

1.0.5

  • VERBETERING: zal niet proberen zich aan/uit te schrijven als de gebruiker geen e-mailadres heeft. Komt niet vaak voor in WP, maar kan.
  • BUG: Bug opgelost waarbij als gebruikers alle optionele lijstenopties uitschakelden, de plugin ze niet uit de lijsten zou verwijderen. (Bedankt, Darlene)

1.0.4

  • BUG: waarschuwingen vermijden in sommige gevallen waarin niveaus zijn verwijderd.

1.0.3

  • BUG: add_settings_error-aanroep verwijderd om fatale fout op front-end te voorkomen. Gebruikte het niet.

1.0.2

  • BUG: Betere foutafhandeling bij het invoeren van ongeldige API sleutels.

1.0.1

  • BUG: Enkele waarschuwingen en fatale fouten opgelost als de site wordt uitgevoerd met een lege of ongeldige API sleutel.

1.0

  • Toegeven dat we officieel zijn uitgebracht met een 1.0 versie. 🙂
  • Gebruikt nu Mailchimp v2.0 API.

.3.6.2

  • Code geüpdatet om ervoor te zorgen dat bij het uitchecken sub-adds worden uitgevoerd op pmpro_after_checkout in plaats van pmpro_after_change_membership_level.

.3.6.1

  • Enkele waarschuwingen opgelost die zouden verschijnen als de plugin nog niet met de API was verbonden.

.3.6

  • Nu 3 opties voor de optie “Afmelden bij niveauwijziging”. Nee, Ja (Alleen oude niveaulijsten.) en Ja (Alle andere lijsten.).
  • Mogelijke problemen opgelost die in de .3.5-versie waren geïntroduceerd.

.3.5

  • De “Opt-in lijsten” toegevoegd die op de PMPro afrekenpagina zullen verschijnen als selectievakjes waarmee het lid zich kan aanmelden voor een of meer lijsten.
  • In plaats van gebruikers uit te schrijven van alle lijsten bij het wijzigen van lidmaatschapsniveaus (voordat ze weer worden toegevoegd aan lijsten voor het nieuwe lidmaatschapsniveau), schrijven we alleen gebruikers af van de lijsten die waren geselecteerd voor hun oude niveau. Als lijst #1 bijvoorbeeld aan een gebruiker wordt gegeven voor niveau 1, zullen gebruikers die van niveau 1 veranderen, alleen worden uitgeschreven van lijst #1. Ze blijven op elke andere lijst staan die ze mogelijk buiten PMPro MailChimp hebben gekregen.

.3.4

  • Oplossen van SQL-waarschuwing bij het uitvoeren van PMPro Mailchimp zonder PMPro. (Bedankt, kateM82)

.3.3

  • Optie toegevoegd om uitschrijvingen volledig uit te schakelen. Als je meerdere lijsten beheert in MailChimp en gebruikers zich buiten WordPress laten abonneren, wil je misschien Nee kiezen, zodat contacten niet worden uitgeschreven van andere lijsten wanneer ze zich registreren op je site.

.3.2

  • pmpro_mailchimp_listsubscribe_fields filter geüpdatet om ook het $list_user object door te geven.

.3.1

  • Het updaten van e-mailadressen in MailChimp lijsten als het e-mailadres van een gebruiker wordt gewijzigd.

.3

  • Toegevoegd pmpro_mailchimp_listsubscribe_fields filters om velden toe te voegen die de listSubscribe API aanroep hebben doorstaan.
  • Enkele dingen gewijzigd om ervoor te zorgen dat de gebruikerscache schoon is en de listSubscribe aanroep laat genoeg plaatsvindt zodat de voor- en achternaam worden ingevuld.

.2.2

  • Eerste gelogde release met een readme.
  • Een instelling “Dubbele aanmelding vereisen” toegevoegd die bepaalt of een extra aanmeldingse-mail ter bevestiging wordt verzonden voordat gebruikers aan een lijst worden toegevoegd. Staat standaard op “Nee”.