Once the extension is installed and activated you can navigate to Downloads > Settings > Extensions > Slack and you will want to first create an Incoming Webhook for your Slack Team.
This allows EDD Slack to send Notifications on your behalf, meaning it can only send Notifications to the same Channels that you can. If you have access to a Private Channel it can send Notifications to that Private Channel, but it cannot send Notifications to Private Channels to which you do not have access.
While creating an Incoming Webhook Integration Slack will ask you which Channel you would like to post to. Think of this as a “Default Channel”. For each Notification that you create in the extension, you are able to designate different Channels if needed.
Once you have generated an Incoming Webhook, enter it into the “Default Webhook URL” field and click “Save Changes”. Now you can proceed to Create Notifications!
EDD Slack allows you to configure an unlimited number of Notifications to be sent to any specified Channel in your Slack Team. Simply navigate to the settings page for the extension and click “Add Slack Notification” to bring up the configuration form. These settings can be edited later at any time.
Here’s a description of what each field does:
Identifier for this Notification: This field is simply a label for you and helps you determine which saved Notification does what. You can enter whatever you’d like here. If nothing is entered, it will default to “New Slack Notification”.
Slack Trigger: Defines the Trigger which results in this notification sending a message to Slack. This can be an action within Easy Digital Downloads or another supported Easy Digital Downloads Extension. Based on the choice of Trigger, additional fields will be added to the Form and different Text Replacements for the Message Pre-text, Message Title, and Message fields will become available so that pertinent information about the Notification can be passed to Slack.
Message Pre-text: Optional text which shows above the Message Title.
Message Title: This allows you to control the Message Title. If nothing is entered, this will default to the Notification Identifier above.
Message: This is an optional field where you can enter more descriptive text within the Notification below the Pre-Text and the Title.
Slack Webhook URL: Allows for an alternate Webhook URL to be used in special cases. This can be used in an event where a Notification should be sent to a different Team than the one that is defined for the Default Webhook.
Slack Channel: This allows you to override the Slack Channel of the Webhook for this particular Notification. If you desire to send notifications to a specific Slack User in your Team, use the @username syntax. Leave blank for the Default Channel defined by the Webhook. Remember, this Channel needs to be one that the creator of the Webhook URL has access to!
Color: Messages sent to Slack will have this color appear in a bar before the message.
Username: Defines the name of the User that the message will appear to be from. The User does not need to exist in Slack and this can be set to anything you’d like. This will default to the name of your WordPress site.
Icon Emoji or Image URL: If the default image or emoji used for notifications isn’t your style, this field will allow for custom graphics to be specified. You can also set any created Custom Slack Emoji that you want for this field.
Additional fields will also appear depending on the selected Slack trigger. These allow you to specify for which Downloads a Trigger should send a Notification for example.
When a Slack Trigger is chosen, additional Fields and Text Replacement tags are added to the Form. For example, here’s what you will see when choosing the “Purchase Complete” Trigger:
The Text Replacement tags allow information about the Trigger to be added to the content of the Notification. This way you can see the contents of a cart for a Purchase, the Total, and other bits of information based on the chosen Trigger.
Once the Form has been filled out to your liking, click the “Save Slack Notification” button at the bottom of the form. This will close out the Form and bring you back to the screen you were at before and flash the Notification green to show that it has been Saved. The green Checkmark will show that the Notification is Active. Congratulations, you have configured your first Slack Notification!
If instead of a green Checkmark, you see a red “X”, the notification is Inactive. This can happen for one or more of the following reasons:
A Webhook URL was not set as the Default or otherwise provided as part of the Form.
The form was closed out without Saving.
A previously saved Notification was using a Trigger that is no longer available. This can happen when a plugin that integrates with EDD Slack gets disabled.
Setting up a Slack App
These steps are optional, but unlock extra functionality within EDD Slack. If you follow these steps, you will be able to perform actions on your site directly from a Slack Notification by clicking a Button within a Slack notification as well as return data from your site using Slash Commands.
Note: To proceed, your site must have SSL enabled!
Als je site SSL heeft ingeschakeld, zie je hieronder de extra opties voor de aangemaakte Slack-meldingen:
Bovenaan deze sectie wordt een lijst weergegeven van alle beschikbare Triggers die Interactieve Knoppen ondersteunen. Als er geen worden weergegeven, kun je dit nog steeds instellen om Slash Commands te gebruiken!
Deze functionaliteit is gebaseerd op het koppelen van een Slack-app aan je website. Volg de link om je eigen Slack-app te maken door op de knop "Nieuwe app maken" te klikken om te beginnen.
Eerst de Slack-app koppelen:
Het veld App-naam kan alles zijn wat je wilt. Het wordt binnen Slash Commands gebruikt als de "Gebruikersnaam" wanneer het gegevens naar je terugstuurt. Het Werkruimte-veld moet het Team zijn waaraan je je EDD-winkel wilt koppelen. Klik op "App maken" om door te gaan.
Het volgende scherm toont je Client ID, Client Secret en Verification Token voor de Slack-app in de sectie App-gegevens lager op de pagina. Voer deze in de EDD Slack-instellingen in (Downloads > Instellingen > Extensies > Slack) en klik op "Wijzigingen opslaan" onderaan het scherm.
Voordat je op de knop "Slack-app koppelen" kunt klikken die verschijnt, moet je een Redirect URL definiëren voor de Slack-app. Terug in de instellingen voor de Slack-app die je hebt gemaakt:
Klik op "OAuth & Machtigingen" aan de linkerkant van het scherm.
Nu kun je terugkeren naar de EDD Slack-instellingenpagina en op de knop "Slack-app koppelen" klikken. Dit opent een nieuw venster waar je inlogt bij je Team dat je eerder hebt ingesteld om de Slack-app op je site te autoriseren. Net als bij de Webhook URL's hiervoor, betekent dit dat het beperkt is tot dezelfde Kanalen waartoe de Slack-gebruiker die de Slack-app aan de site heeft gekoppeld, toegang heeft binnen het gekozen Team.
Eenmaal geautoriseerd, sluit het pop-upvenster zichzelf en wordt de EDD Slack-instellingenpagina vernieuwd, met de melding "Slack-app succesvol gekoppeld".
Nu deze stap is voltooid, zijn API-eindpunten op je site geopend. Deze worden gebruikt voor zowel Interactieve Meldingen als Slash Commands.
Om Interactieve Meldingen in te stellen voor EDD Slack, ga terug naar de Instellingen van je Slack-app en klik aan de linkerkant van het scherm op "Interactiviteit & Snelkoppelingen".
Sneltoetsopdrachten fungeren als snelkoppelingen voor specifieke acties in Slack die u kunt gebruiken om te communiceren met uw EDD-winkel.
Om Sneltoetsopdrachten in te stellen, klikt u binnen de Instellingen van uw Slack-app op "Sneltoetsopdrachten" en vervolgens op "Nieuwe opdracht maken". Dit opent een venster waar de instellingen voor de Sneltoetsopdracht worden ingevoerd.
EDD Slack maakt gebruik van één enkele Sneltoetsopdracht en stuurt deze naar verschillende functies op basis van een doorgegeven parameter. Hier is een voorbeeld van een /edd-opdracht:
Opdracht: /edd We raden aan om de "Opdracht" in te stellen op /edd, maar als u besluit deze /webstore of iets anders te noemen, zal dat ook werken.
Verzoek-URL: https://uwwebsite.com/wp-json/edd-slack/v1/slack-app/slash-command/submit waarbij uwwebsite.com de domeinnaam van uw website is.
Korte beschrijving: Haal info uit EDD
Gebruikstip: Voer "/edd help" uit voor gebruikstips
Kanalen/gebruikers negeren: Dit kan in de meeste gevallen uitgeschakeld blijven. Als u dit inschakelt, worden de parameters die met een opdracht van een gebruiker worden verzonden, gewijzigd. Meer details hier
U kunt Sneltoetsopdrachten testen door /edd help in te voeren in een kanaal waartoe u toegang heeft. Interactieve meldingen worden gebruikt in plaats van reguliere meldingen waar van toepassing.
De extensie biedt verschillende nuttige opdrachten die binnen Slack kunnen worden uitgevoerd om gegevens op te halen of iets nieuws te creëren op uw WordPress-site zonder dat u überhaupt op uw site hoeft in te loggen.
Slack bevat al veel nuttige sneltoetsopdrachten die erg nuttig kunnen zijn, zoals de /remind-opdracht. EDD Slack introduceert een paar nieuwe opdrachten die specifiek van toepassing zijn op gebruikers van Easy Digital Downloads.
De eenvoudigste manier om alle beschikbare sneltoetsopdrachten van EDD Slack te bekijken, is door /edd help in Slack in te voeren. Dit kan overal worden gedaan en de resultaten zijn alleen voor u zichtbaar. Ze zien er als volgt uit:
*/edd sales*
Description: Show an Earnings Report for the Selected Time Period
Example: `/edd sales this_month`
Option(s): `today`, `yesterday`, `this_week`, `last_week`, `this_month`, `last_month`, `this_quarter`, `last_quarter`, `this_year`, `last_year`
Default: `this_month`
*/edd version*
Description: Outputs the current version of Easy Digital Downloads.
Example: `/edd version`
*/edd discount*
Description: Outputs information about a Discount Code. This can also be used to create new Discount Codes.
Examples:
`/edd discount DISCOUNTCODE` - Retrieve information about a Discount Code
`/edd discount DISCOUNTCODE $3.50` - Create or Update a Discount Code with a Flat Rate Discount
`/edd discount DISCOUNTCODE 42%` - Create or Update a Discount Code with a Percentage Discount
*/edd customer*
Description: Outputs information about a Customer. You can use either their Customer ID or their Primary Email Address for this command.
Examples:
`/edd customer 42`
`/edd customer [email protected]`
*/edd help*
Description: Shows this Dialog. Optionally can show the Help Dialog for a Single Command.
Example: `/edd help`
Option(s): `sales`, `version`, `discount`, `customer`
Zoals hierboven getoond, zijn de momenteel opgenomen sneltoetsopdrachten:
/edd help
/edd sales
/edd version
/edd discount
/edd customer
Configuring Slack Team Invites
Om deze functie in te schakelen, moet uw eigen persoonlijke Slack Gebruikersaccount over de nodige machtigingen beschikken om Gebruikers uit te nodigen. Dit is normaal gesproken voorbehouden aan Slack Team Admins. Net als bij Interactieve Berichten en Webhook URL's, erft dit enkele mogelijkheden van uw Slack Gebruiker. Als u geen Gebruikers kunt uitnodigen, kan uw Slack App dat ook niet.
De mogelijkheid om klanten automatisch uit te nodigen voor uw Slack Team is aanwezig in de extensie, waarvoor Interactieve Meldingen en Sneltoetsopdrachten al ingeschakeld moeten zijn.
Zodra je Interactieve Meldingen en Slash Commando's hebt ingeschakeld, verschijnt er een nieuwe knop in je EDD Slack-instellingen om Slack Team Uitnodigingen in te schakelen.
Zodra je op deze knop klikt, verschijnt er een vergelijkbaar pop-upvenster als toen je eerder Interactieve Berichten en Slash Commando's hebt ingesteld. Dit komt doordat je meer machtigingen moet verlenen aan je Slack App.
Het venster dat verschijnt, geeft aan dat je de Slack App de mogelijkheid verleent om alle inhoud en alle gebeurtenissen in realtime te benaderen. Dit komt doordat je Slack App, om klanten en Slack-gebruikers uit te nodigen, alle machtigingen nodig heeft als een volwaardige Slack Client. Dit wordt alleen gebruikt voor het uitnodigen van klanten naar je Slack Team.
Zodra dit is gedaan, verschijnen er enkele nieuwe opties. Hiermee kun je Slack Team Uitnodigingen inschakelen voor klanten, evenals Slack Team Uitnodigingen voor verkopers (als de Frontend Submissions-extensie actief is op je site).
Alle nieuw uitgenodigde Slack-gebruikers worden automatisch uitgenodigd voor je #general-kanaal (of hoe je het ook hebt hernoemd). Op dit scherm kun je echter aanvullende openbare kanalen definiëren waarnaar je ze wilt uitnodigen. Het haalt alle openbare kanalen van je Slack Team voor je op, dus kies gewoon welke je wilt uit de dropdown.
Het veld "Tekst voor Slack Team Toetreding" past de tekst aan die wordt weergegeven wanneer je een klant/verkoper de optie geeft om te worden uitgenodigd voor je Slack Team. Voor klanten wordt dit weergegeven op de afrekenpagina en voor verkopers op de registratiepagina van de verkoper.
Je kunt klanten ook handmatig uitnodigen vanaf hun Klantenpagina onder het tabblad "Tools" en, als je de Frontend Submissions-extensie gebruikt, verkopers vanaf hun Verkoperspagina onder het tabblad "Profiel" in het WordPress Dashboard.
Nieuw verkopersproduct (Als verkopers toestemming hebben om producten te maken)
Verkoopproduct bewerkt (Als verkopers toestemming hebben om hun producten te bewerken)
Nieuw contactformulier van verkoper ingediend
Nieuwe feedback van verkoper (Vereist dat Reviews ook actief is)
Ondersteuning voor interactieve meldingen
De volgende Frontend Submissions Triggers ondersteunen Interactieve Meldingen, mits aan verschillende voorwaarden is voldaan. Je kunt de volgende verkopersacties rechtstreeks vanuit Slack goedkeuren of weigeren:
Nieuwe verkopersaanvraag (Als nieuwe verkopersaanvragen niet automatisch worden goedgekeurd)
Nieuw verkopersproduct (Als nieuwe verkopersproducten niet automatisch worden goedgekeurd)
Verkoopproduct bewerkt (Als nieuwe bewerkingen van verkoopproducten niet automatisch worden goedgekeurd)
Easy Digital Downloads – Softwarelicenties
Als Softwarelicenties actief is, worden de volgende Triggers beschikbaar:
Nieuwe licentiesleutel gegenereerd
Licentiesleutel geactiveerd
Opmerking: Handmatig activeren vanaf het scherm Licenties triggert dit niet.
Licentiesleutel gedeactiveerd
Opmerking: Handmatig deactiveren vanaf het scherm Licenties activeert dit niet.
Licentie Geüpgraded
Easy Digital Downloads – Commissies
Als Commissies actief is, wordt de volgende Trigger beschikbaar:
Nieuwe Commissie
Easy Digital Downloads – Aankooplimiet
Als Aankooplimiet actief is, wordt de volgende Trigger beschikbaar:
Aankooplimiet Bereikt
Reacties op Downloads (indien ingeschakeld)
Hoewel niet precies een "Integratie", biedt Easy Digital Downloads standaard geen ondersteuning voor Reacties op Downloads. Echter, als u het zelf inschakelt of via een andere plugin, wordt de volgende Trigger beschikbaar:
Nieuwe Reactie op Download
Ondersteuning voor interactieve meldingen
Deze Interactieve Melding is uniek omdat het twee versies heeft: Eén voor wanneer uw site is ingesteld op handmatige goedkeuring van Reacties en één voor wanneer dat niet het geval is.
Als u reacties handmatig goedkeurt op uw site, heeft u de mogelijkheid om de Reactie goed te keuren of deze als Spam te markeren. Anders heeft u alleen de mogelijkheid om deze als Spam te markeren.
Opmerking over Server-side Caching:
Licentie Activering Triggers zijn nu specifiek voor Activering/Deactivering via EDD's web API.
Dit kan problemen veroorzaken in sommige serverconfiguraties vanwege server-side caching. edd_action=activate en edd_action=deactivate URL Parameters moeten worden uitgesloten van caching op de startpagina van uw site om ervoor te zorgen dat alles correct werkt.
Easy Digital Downloads – Beoordelingen
Als Beoordelingen actief is, worden de volgende Triggers beschikbaar:
Nieuwe Beoordeling op Download
Nieuwe Verkoper Feedback (Vereist dat Frontend Submissions ook actief is)
Easy Digital Downloads – Fraude Monitor
Als Fraude Monitor actief is, wordt de volgende Trigger beschikbaar:
Verdachte Frauduleuze Aankoop
Ondersteuning voor interactieve meldingen
U kunt Interactieve Meldingen gebruiken om een Betaling als Geldig te markeren of als Fraude te markeren, rechtstreeks vanuit Slack. Wanneer u dit doet, zal het Logboek dat aan de Betaling is gekoppeld de genomen actie vermelden en zeggen dat deze via EDD Slack en door welke Slack Gebruiker is gedaan.
