Promo ID
Door: De Web Developer
Details
Installatie
Development
Beschrijving
De Promo ID Tracking & Commissiebeheer plugin voor WooCommerce biedt een geautomatiseerde manier om bestellingen te koppelen aan unieke tracking-URL’s en de bijbehorende commissie automatisch te berekenen. Dit is ideaal voor webshops die werken met influencers, affiliates of externe partners en willen bijhouden welke bestellingen via welke bron binnenkomen.
Met deze plugin wordt een Promo ID automatisch opgeslagen wanneer een klant via een speciale URL de webshop bezoekt. Bij het afrekenen wordt de Promo ID gekoppeld aan de bestelling, en de commissie wordt direct berekend en opgeslagen. Hierdoor kun je gemakkelijk commissies beheren en inzicht krijgen in de prestaties van je partners.
De plugin voegt een extra kolom toe aan WooCommerce-bestellingen waarin de gekoppelde Promo ID en het berekende commissiebedrag worden weergegeven. Dit zorgt voor een duidelijke en overzichtelijke administratie, zonder handmatige berekeningen of externe tracking-tools.
Met een intuïtief beheerpaneel in de WordPress admin kun je eenvoudig Promo ID’s en hun bijbehorende commissies instellen. Je partners krijgen unieke tracking-URL’s, waardoor je precies kunt bijhouden welke influencer of affiliate verantwoordelijk is voor welke verkoop.
De plugin werkt volledig automatisch en vereist geen technische kennis. Het enige wat je hoeft te doen, is een Promo ID toewijzen en een percentage instellen. Vanaf dat moment worden alle commissies automatisch berekend en vastgelegd.
Belangrijkste functies:
- Automatische Promo ID tracking – De plugin detecteert en slaat automatisch een Promo ID op uit de URL, zonder dat de klant hier iets voor hoeft te doen.
- Commissieberekening op basis van bestelbedrag – Het systeem berekent automatisch de commissie op basis van een vooraf ingesteld percentage, zodat je eenvoudig affiliate- en influencer-betalingen kunt beheren.
- Promo ID en commissie in WooCommerce-orders – Bestellingen krijgen een extra kolom waarin de gekoppelde Promo ID en het bijbehorende commissiebedrag worden weergegeven.
- Gebruiksvriendelijke admin-interface – Beheer eenvoudig meerdere Promo ID’s en stel de bijbehorende commissies in via een overzichtelijk configuratiescherm.
- Volledig geïntegreerd met WooCommerce – Werkt naadloos samen met WooCommerce en past automatisch commissieberekeningen toe op relevante bestellingen.
- Automatische ordernotities – De commissie wordt als ordernotitie toegevoegd, zodat je altijd een duidelijk overzicht hebt van de berekende bedragen.
- Flexibele inzet voor verschillende partners – Ideaal voor webshops die samenwerken met influencers, affiliates of externe verkopers en hun verkopen willen bijhouden.
- Geen technische kennis vereist – De plugin is ontworpen voor gebruiksgemak en werkt volledig op de achtergrond, zonder complexe instellingen of aanpassingen.
Hoe gebruik je de plugin?
- Na activatie van de plugin ga je naar het WooCommerce-beheerpaneel en zoek je naar het tabblad Promo ID Tracking.
- In de instellingen kun je nieuwe Promo ID's aanmaken en koppelen aan specifieke partners, affiliates of influencers.
- Voor elke Promo ID kun je een uniek commissiepercentage instellen. Dit percentage wordt automatisch toegepast op alle bestellingen die via deze Promo ID binnenkomen.
- De gegenereerde Promo ID’s kunnen eenvoudig worden toegevoegd aan marketinglinks, zoals:
https://jouwwebshop.nl/?promo_id=partner123. - Wanneer een klant via een speciale URL binnenkomt, wordt de Promo ID automatisch opgeslagen en gekoppeld aan hun bestelling.
- Bij elke nieuwe bestelling wordt in de WooCommerce-order een extra kolom toegevoegd met de Promo ID en de berekende commissie.
- Je kunt de ordergegevens bekijken in het WooCommerce-bestellingsoverzicht en filteren op specifieke Promo ID’s.
- De plugin biedt een exportfunctie waarmee je commissies eenvoudig kunt downloaden en verwerken voor uitbetalingen.
- Klaar! Met deze plugin kun je moeiteloos commissies beheren en inzicht krijgen in de prestaties van je partners.
Data opslag
De plugin slaat alle Promo ID’s, commissieberekeningen en trackinggegevens op in de WordPress-database. Dit zorgt ervoor dat alle gegevens behouden blijven, zelfs als je de plugin tijdelijk deactiveert.
Als je de plugin verwijdert, blijven de Promo ID’s en commissiedata standaard in de database opgeslagen. Dit betekent dat je bij herinstallatie direct verder kunt gaan waar je gebleven was. Wil je alle data volledig verwijderen? Dit kan handmatig via phpMyAdmin of een database-cleaning tool.
Let op
De plugin is geoptimaliseerd voor standaard WooCommerce-installaties. Bij sommige op maat gemaakte thema’s of caching-plugins kan het nodig zijn om aanvullende instellingen aan te passen voor optimale werking.
Changelog voor De Web Developer: Promo ID Plugin
Versie 1.0.0 - 2025-04-03
Eerste versie - Basisfunctionaliteit
- Basisstructuur van de plugin: Het hoofdbestand van de plugin genaamd
promo-id-plugin.phpwerd aangemaakt. De basisstructuur voor de plugin werd opgezet met de benodigde WordPress hooks voor het verwerken van promo ID's via URL en cookies. - Promo ID genereren via URL: De mogelijkheid werd toegevoegd om een
promoidvia een URL-parameter (?promoid=12345) door te geven. Het promo ID werd opgeslagen in een cookie, zodat het ID over verschillende pagina's en sessies heen kan worden gevolgd. - Promo ID zichtbaar in de WooCommerce bestellingen: Een nieuwe kolom 'Promo ID' werd toegevoegd aan de WooCommerce bestellingenlijst in de admin. Het promo ID werd toegevoegd aan de bestelmeta van de bestelling bij het afrekenen.
Versie 1.1.0 - 2025-04-03
Toevoegen van Admin Interface voor het Beheren van Promo ID's en Commissies
- Submenu in WordPress zijbalk: Een sub-menu werd toegevoegd in de admin zijbalk via
add_menu_pagewaarmee beheerders promo ID's en commissies kunnen beheren. - Instellingenpagina met invoervelden voor promo ID's en percentages: Er werd een instellingenpagina gecreëerd waarin gebruikers meerdere promo ID's kunnen toevoegen, samen met bijbehorende commissiepercentages. De promo ID's en percentages worden opgeslagen in de WordPress database via
update_option. - Opslaan van Promo ID's en Commissies: De ingevoerde promo ID's en percentages worden opgeslagen in de WordPress opties (
dwsd_promo_data). Het formulier op de instellingenpagina ondersteunt meerdere promo ID's en maakt het mogelijk om de gegevens bij te werken.
Versie 1.2.0 - 2025-04-03
Berekening van de Commissie op Basis van Producten
- Berekening van de commissie op basis van het producttotaal: De commissie wordt nu berekend op basis van het producttotaal van de bestelling, zonder verzendkosten of overige kosten mee te rekenen. Dit gebeurde door de juiste methode aan te roepen, zoals
$order->get_subtotal()in plaats van$order->get_total(). - Promo ID en Commissie in Bestellingstabel: Een nieuwe kolom 'Commissie Bedrag' werd toegevoegd aan de bestellingstabel in de admin. De commissie (in NOK) werd weergegeven naast het promo ID, zodat beheerders snel kunnen zien welk bedrag aan commissie is berekend voor elke bestelling.
- Toevoegen van Commissie als Ordernotitie: Het berekende commissiebedrag werd toegevoegd als ordernotitie bij de bestelling, zodat het makkelijk terug te vinden is bij het bekijken van de bestelling in de admin.
Versie 1.3.0 - 2025-04-03
Verbeteringen en extra functionaliteit
- Ondersteuning voor meerdere promo ID's: De instellingenpagina ondersteunt nu het beheer van meerdere promo ID's en commissies tegelijk. Bestaande promo ID's en percentages worden geladen bij het openen van de instellingenpagina, zodat gebruikers makkelijk kunnen aanpassen, toevoegen of verwijderen.
- Verbeterde weergave van bestaande gegevens: Alle bestaande promo ID's en bijbehorende percentages worden nu correct weergegeven op de instellingenpagina, zodat beheerders ze kunnen bijwerken.
- Beveiliging en validatie: Sanitization van gegevens werd toegepast bij het verwerken van de promo ID en percentage om te voorkomen dat onbeveiligde of ongewenste gegevens de database binnenkomen. Het promo ID wordt nu veilig opgeslagen en opgehaald, met gebruik van
sanitize_text_field()en andere veilige WordPress-functies.
Versie 1.4.0 - 2025-04-03
Verbeterde code en bugfixes
- Code refactoren: De code werd opgeschoond en verbeterd voor betere leesbaarheid en onderhoudbaarheid. Functies werden beter gestructureerd en hergebruikt waar mogelijk. Verbeteringen werden doorgevoerd in de manier waarop de promo ID's en commissies worden opgehaald uit de database.
- Betere foutafhandeling: Foutafhandelingsmechanismen werden toegevoegd voor het geval een promo ID niet gevonden wordt of als er een probleem is met de bestelling. Extra logging werd toegevoegd om beheerders te helpen bij het oplossen van eventuele problemen bij het toepassen van promo ID's.
- Compatibiliteitstests uitgevoerd: De plugin werd getest met de laatste versie van WooCommerce om compatibiliteit en functionaliteit te garanderen.
Versie 1.4.1 - 2025-04-03
Toegevoegd
- Toekomstbestendig maken van de PHP-code: We hebben de code geoptimaliseerd voor betere compatibiliteit met toekomstige versies van WooCommerce en WordPress door functies als
sanitize_text_field()toe te passen voor inputvalidatie en betere structuur van de gegevensopslag. - Promo ID en commissie verwerkt in de bestellingen: De plugin kan nu meerdere promo ID's beheren en deze koppelen aan specifieke kortingen voor bestellingen. Dit maakt het gemakkelijker om promo ID's toe te voegen zonder de backend-code voortdurend te moeten aanpassen.
- Promo ID en commissie tonen in de admin: We hebben de functionaliteit toegevoegd om het Promo ID en het commissiebedrag te tonen in de bestellingenlijst in de WooCommerce admin.
- Flexibele structuur voor het opslaan van percentages: Het opslaan van meerdere promo ID's met bijbehorende percentages in de database is nu mogelijk via de WordPress-opties. Dit maakt het beheren van meerdere promo ID's eenvoudiger en maakt de plugin uitbreidbaar voor meer functionaliteiten.
- Promo ID-gegevens nu zichtbaar in bestellingen: In de bestelnotities wordt nu duidelijk het gebruik van een promo ID en het bijbehorende commissiebedrag weergegeven.
Verbeteringen
- Betere interface voor het beheren van Promo ID's in de admin: De admin-pagina is verbeterd om een eenvoudigere en efficiëntere manier te bieden om promo ID's en hun bijbehorende percentages toe te voegen en op te slaan.
- Gebruik van veilige methoden om gebruikersinvoer te verwerken: Inputvelden voor promo ID's en percentages worden nu correct gevalideerd en opgeslagen, wat de algehele veiligheid van de plugin verhoogt.
Bugfixes
- Verwerking van alleen productkosten in de commissie: De berekening van de commissie wordt nu alleen uitgevoerd op de productkosten en negeert verzendkosten en andere kosten, zoals gewenst.
Technische wijzigingen
- PHP-bestanden herschikt: Het hoofdpluginbestand (
index.php) maakt nu gebruik van depromo-id-functions.phpom de complexiteit te scheiden en de code beter beheersbaar te maken. Alle noodzakelijke acties en filters worden in het hoofdbestand geregistreerd voor een betere modulariteit. - Verbetering van de admin-UI: De pagina voor het beheren van promo ID's is verbeterd voor gebruiksgemak en duidelijkere inputvelden voor meerdere ID's en percentages.
Versie 1.4.2 - 2025-04-04
Toegevoegd
- Improved URL copy/paste functionality: URLs are now formatted for universal use, making it easier to copy and paste them directly.
- New admin dashboard functions: Added
includes > promo-id-wp-admin.phpto handle dashboard functionalities. - Enhanced Promo ID copy/paste feature: The copy and paste functionality for Promo IDs has been updated for better usability.
- Custom admin styling: Added
assets > css > promo-admin-style.cssto improve dashboard styling. - New row bug fix: Fixed a bug that prevented adding a new row when saving Promo IDs.
- Automatic Promo ID copying: When leaving the input field, the new and old Promo IDs are now automatically copied.
- Paste button for Promo ID input field: A dedicated paste button has been added to the Promo ID input field.
- Browser-based notifications: Implemented browser notifications to enhance user experience.
- Improved cut & paste functionality for URLs: Copy and paste operations for URLs have been optimized for seamless workflow.
- DWD icon in the dashboard sidebar: Added a new DWD icon to the dashboard menu for better visibility.
Bugfixes
- WooCommerce not active notification: Adjusted the warning message that appears when WooCommerce is not active.
- Versie 1.4.2
- Laatste update 04/04/2025
- Downloads 6 keer gedownload
- WordPress versie 5.0.0 of hoger
- Getest tot 6.7.2
- PHP versie 5.6.0 of hoger
- Talen NL