De logging class in Easy Digital Downloads werd voor het eerst geïntroduceerd in v1.3.1 als middel voor het loggen van gebeurtenissen en fouten. In deze tutorial gaan we de Logging Class van Easy Digital Downloads gebruiken om elke betaal-ID op te halen die is gekoppeld aan de aankoop van een download. Zodra je de betaal-ID hebt, heb je toegang tot een schat aan informatie over de aankoop, die je kunt gebruiken voor praktische toepassingen.
Een van die voorbeelden is
EDD Purchase Gravatars, die de gravatars weergeeft van klanten die je product hebben gekocht. Dit kan worden gebruikt voor het tonen van sociale bewijskracht/vertrouwen, waarbij klanten eerder geneigd zijn je product te kopen als ze andere echte klanten zien die al hebben gekocht.
De plugin gebruikt het e-mailadres en de voornaam van de klant, die vereist zijn door Easy Digital Downloads om de aankoop te voltooien. Met behulp van de get_avatar()-functie van WordPress haalt de plugin de gravatar op die is gekoppeld aan het opgegeven e-mailadres en gebruikt de voornaam van de klant voor de alt-tag van de afbeelding.
Het verkooplogboek
Om het e-mailadres en de voornaam van de klant voor de gravatars op te halen, hebben we uiteindelijk de betaal-ID voor elke aankoop nodig. Dit kan worden gevonden door eerst de log-ID van elke aankoop op te halen. We kunnen een lijst zien van alle aankopen van een download door op "Bekijk verkooplogboek" te klikken in de metabox "downloadstatistieken" op het bewerkings-/publicatiescherm van de download.
Uit de onderstaande afbeelding kunnen we zien dat één aankoop een Log ID van 55 heeft. In dezelfde rij kunnen we zien dat deze een betaal-ID van 54 heeft. Elke keer dat een aankoop wordt gedaan, worden de Log ID en de betaal-ID tegelijkertijd, sequentieel opgeslagen.
Duiken in wp_postmeta
Om te begrijpen hoe we de betaal-ID uit de log-ID kunnen halen, moeten we de wp_postmeta tabel van WordPress induiken. Als we de tabel filteren op een post_id van 55 (log-ID), vinden we de _edd_log_payment_id meta_key met een waarde van 54 (onze betaal-ID). Dit komt ook overeen met het verkooplogboek, geïllustreerd in de bovenstaande afbeelding.
Door te filteren op post_id met onze nieuw ontdekte betaal-ID (54), vinden we alle nuttige informatie die tegen onze aankoop is opgeslagen. In EDD Purchase Gravatars gebruiken we de e-mail die is opgeslagen in de _edd_payment_user_email meta_key, en de voornaam die is opgeslagen in de _edd_payment_meta array (er staat ook een e-mailadres in hier). Om gebruik te maken van alle informatie die is opgeslagen in de _edd_payment_meta array, moet je deze eerst unserializen met behulp van de maybe_unserialize functie in WordPress.
Het ophalen van de Log ID's
Nu we weten dat we eerst alle Log ID's van een download moeten ophalen, gebruiken we de handige logging class in Easy Digital Downloads om dit voor ons te doen. Deze functie vereist dat een download-ID wordt doorgegeven, wat in het geval van EDD Purchase Gravatars, de gravatars overal op de website laat zien, voor elke download.
Het ophalen van de Betaal-ID's
Now that we have an array of all the log IDs, we can use them in a new function to retrieve an array of all the payment IDs.
Conclusie
Now that you have an array of all the payment IDs, you can loop and output the information you need. What else can you build using payment IDs and EDD’s Logging Class?
