Advanced Newsletter Suite voor Magento 2 - installatie- en configuratiehandleiding

Doel van het document

Dit document beschrijft de installatie en configuratie van het pakket magento-2-package-advanced-newsletter-suite. Het is een volledig newsletter- en e-mailmarketingpakket voor Magento 2, met ontvangers, capture, campagnes, content, verzending, tracking, een operationeel paneel en registratiepunten op de frontend.

Vereisten

Bereid vóór de implementatie het volgende voor:

• Magento Open Source 2.4.x,
• Composer,
• CLI-toegang tot bin/magento,
• een Magento-beheerdersaccount,
• SMTP-toegangsgegevens,
• geconfigureerde Magento cron,
• gereedheid om queue consumers uit te voeren,
• een testomgeving om inschrijving, campagnes en verzendingen te controleren.

Wat het pakket installeert

Het pakket omvat:

• Kowal_MarketingCore,
• Kowal_EmailTransport,
• Kowal_EmailSmtp,
• Kowal_EmailEvents,
• Kowal_EmailTemplateStudio,
• Kowal_NewsletterAudience,
• Kowal_NewsletterCapture,
• Kowal_NewsletterCampaigns,
• Kowal_NewsletterConsole,
• Kowal_NewsletterFrontend.

Dit is het hoogste aggregatieniveau binnen het ecosysteem van e-mailmarketingmodules voor Magento.

Installatie

1. Installatie van het Composer-pakket

De toegangsgegevens voor de Composer-repository, namelijk het e-mailadres van de klant en de licentietoken, ontvangt u na aankoop per e-mail. Ze zijn ook beschikbaar in het klantenpaneel nadat u bent ingelogd op kowal.store. Vervang TWOJ_EMAIL_KLIENTA door het e-mailadres van uw account en TWOJ_TOKEN door de ontvangen token. Voer de commando's uit in de hoofdmap van Magento.

composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/package-advanced-newsletter-suite

2. Modules activeren in Magento

bin/magento module:enable \ Kowal_MarketingCore \ Kowal_EmailTransport \ Kowal_EmailSmtp \ Kowal_EmailEvents \ Kowal_EmailTemplateStudio \ Kowal_NewsletterAudience \ Kowal_NewsletterCapture \ Kowal_NewsletterCampaigns \ Kowal_NewsletterConsole \ Kowal_NewsletterFrontendbin/magento setup:upgradebin/magento cache:flush

Voer in productiemodus aanvullend uit:

bin/magento setup:di:compilebin/magento setup:static-content:deploy -f

Configuratie

1. Beheersectie

De basisconfiguratie zou beschikbaar moeten zijn in:

Kowal / Email Marketing

Volgens de specificatie zijn de verwachte instellingengroepen:

• general,
• transport,
• smtp,
• campaigns,
• double_opt_in,
• events.

2. Verzendconfiguratie

Configureer eerst de basis voor delivery:

• moduleactiviteit,
• standaard transporttype,
• logging van verzendingen,
• SMTP-account of -accounts,
• berichtrouting,
• fallback voor reserveaccounts, indien gebruikt.

De implementatie van het volledige pakket vereist nog steeds een goed werkende SMTP- en transportlaag.

3. Configuratie van ontvangers en inschrijvingen

Bevestig vervolgens de configuratie van de ontvangerslaag:

• integratie met newsletter_subscriber,
• mailinglijsten,
• segmenten,
• abonnementsstatussen,
• aanvullende metadata van de abonnee,
• wervingsbronnen,
• marketingtoestemmingen.

Configureer ook het inschrijfproces:

• formulieren en registratiepunten,
• double opt-in,
• template voor het bevestigingsbericht,
• geldigheidsduur van de bevestigingstoken.

4. Campagneconfiguratie

Stel in de sectie campaigns het volgende in:

• batch_size,
• max_retry_count,
• send_rate_limit_per_run,
• watchdog_timeout_minutes.

Het pakket ondersteunt:

• campagnedefinitie,
• planning,
• ontvangersqueue,
• batchverwerking van verzendingen,
• geschiedenis van campagne-uitvoering,
• testverzendingen.

5. Configuratie van Template Studio

Als de implementatie ook werk met newslettercontent omvat, configureer dan EmailTemplateStudio volgens de MVP-scope:

• werken met native Magento-newslettertemplates,
• selectie van productlayouts,
• opslaan van de gegenereerde sectie in een native template,
• import van kant-en-klare content in een campagne.

6. Configuratie van e-mailgebeurtenissen

Configureer in de sectie events het volgende:

• verwerking van gebeurtenissen,
• retentie van payloads,
• beleid voor het accepteren van dubbele events van providers.

De laag EmailEvents is verantwoordelijk voor de observeerbaarheid van het bezorgproces en voor het koppelen van events aan transportlogs en campagnes.

7. Configuratie van het beheerpaneel en de frontend

Het volledige pakket omvat:

• Kowal_NewsletterConsole als operationeel paneel,
• Kowal_NewsletterFrontend als frontendlaag voor inschrijfformulieren en -widgets.

Controleer na installatie:

• beschikbaarheid van het dashboard,
• snelkoppelingen naar configuratie en operationele modules,
• weergave van recente fouten en verzendingen,
• aanwezigheid van inschrijfformulieren op de frontend van de shop.

Cron en queue consumers

Het volledige pakket vereist dat asynchrone verwerking actief is.

1. Magento cron

bin/magento cron:install

Cron zou verantwoordelijk moeten zijn voor:

• campagneplanning,
• herstel van taken,
• operationele watchdog.

2. Queue consumers

Queue consumers zouden verantwoordelijk moeten zijn voor de daadwerkelijke verwerking van verzendbatches. De namen van de consumers moeten worden opgehaald uit de actuele bestanden etc/queue_consumer.xml van de geïmplementeerde modules.

Zorg in de productieomgeving voor:

• het uitvoeren van consumers op de achtergrond,
• autostart na een serverherstart,
• monitoring van storingen,
• logging van fouten.

Stappen na installatie

Voer na de implementatie de volledige checklist uit:

1. Configureer en test het SMTP-account.
2. Controleer de berichtrouting.
3. Controleer de inschrijving van de abonnee en double opt-in.
4. Bevestig de compatibiliteit met de native Magento-newsletter.
5. Maak een testlijst of testsegment aan.
6. Bereid een testcampagne voor.
7. Voer een test send uit.
8. Controleer de campagneplanning via cron.
9. Controleer de queueverwerking door consumers.
10. Bevestig het opslaan van logs en e-mailgebeurtenissen.
11. Controleer het beheerdashboard.
12. Controleer de frontendformulieren en registratie-widgets.

Acceptatietest na implementatie

Het pakket is correct geïmplementeerd als:

• de modules correct worden geïnstalleerd in Magento 2.4.x,
• SMTP-verzending werkt op basis van accounts en routing,
• de inschrijving van abonnees compatibel blijft met de native Magento-newsletter,
• de campagne wordt gepland door cron en verwerkt door queue consumer,
• bezorgstatussen de logs en e-mailgebeurtenissen bijwerken,
• het beheerpaneel basisoperationele gegevens toont,
• frontendregistratiepunten correct werken,
• na het uitschakelen van de modules het basismechanisme Magento_Newsletter nog steeds kan werken.

Implementatieopmerkingen

• Het volledige pakket kan het beste worden geïmplementeerd samen met een gevalideerde SMTP- en trackingconfiguratie.
• Uitbreidende gegevens moeten in eigen tabellen worden opgeslagen, zonder de native tabel newsletter_subscriber te dupliceren.
• De operationele documentatie van de implementatie zou daarnaast een procedure moeten bevatten voor queuebeheer, webhooks en regressietests van de beheerconfiguratie.