Skip to content

Commit

Permalink
Merge pull request #49 from pfadfinden/mailchimp
Browse files Browse the repository at this point in the history
Milestone 1.0.1 - Mailchimp
  • Loading branch information
cowboyxup committed Nov 15, 2015
2 parents d47e536 + fa9f80d commit aa09206
Show file tree
Hide file tree
Showing 4 changed files with 332 additions and 205 deletions.
64 changes: 64 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
### SublimeText template
# cache files for sublime text
*.tmlanguage.cache
*.tmPreferences.cache
*.stTheme.cache

# workspace files are user-specific
*.sublime-workspace

# project files should be checked into the repository, unless a significant
# proportion of contributors will probably not be using SublimeText
# *.sublime-project

# sftp configuration file
sftp-config.json
### JetBrains template
# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio

*.iml

## Directory-based project format:
.idea/
# if you remove the above rule, at least ignore the following:

# User-specific stuff:
# .idea/workspace.xml
# .idea/tasks.xml
# .idea/dictionaries

# Sensitive or high-churn files:
# .idea/dataSources.ids
# .idea/dataSources.xml
# .idea/sqlDataSources.xml
# .idea/dynamic.xml
# .idea/uiDesigner.xml

# Gradle:
# .idea/gradle.xml
# .idea/libraries

# Mongo Explorer plugin:
# .idea/mongoSettings.xml

## File-based project format:
*.ipr
*.iws

## Plugin-specific files:

# IntelliJ
/out/

# mpeltonen/sbt-idea plugin
.idea_modules/

# JIRA plugin
atlassian-ide-plugin.xml

# Crashlytics plugin (for Android Studio and IntelliJ)
com_crashlytics_export_strings.xml
crashlytics.properties
crashlytics-build.properties

# Created by .ignore support plugin (hsz.mobi)
35 changes: 2 additions & 33 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,6 @@
# BdP Newsletter Template für MailChimp
# Bund der Pfadfinderinnen und Pfadfinder (BdP) - Newsletter Template

## Voraussetzungen
Es wird ein MailChimp Account benötigt. Dieser kann auf www.mailchimp.com kostenfrei angelegt werden.

## Installation
1. Lade die aktuelle Version des Templates unter [Github Releases](https://github.com/pfadfinden/newsletter/releases) als `.zip` Datei herunter.
2. Erstelle in MailChimp unter Template > Create Template ein neues Template. Importiere entweder den HTML Code aus der Datei base_boxed_basic_2column_query.html (Paste in code) oder lade die zip-Datei direkt hoch (Import HTML).
3. Ersetze Stamm ????? im Header und 2x im Footer durch deinen Stamm oder Landesverband.
4. Ersetze den automatischen Insert-Tag \*|LIST:ADDRESS|\* durch die postalische Adresse in der Form: Strasse Hausnummer, PLZ Ort, DE
5. Speichere das Template. Nun kann es unter Campaigns > Create Campaign genutzt werden.

## Update
Das Update des Extension erfolgt durch überschreiben des HTML-Codes der Datei base_boxed_basic_2column_query.html (Paste in code) aus dem aktuellen Release (https://github.com/pfadfinden/newsletter/releases)
version: 1.0.1

## Bekannte Probleme
Hier werden Probleme bei der Darstellung des Newsletters aufgeführt, die systembedingt nicht gelöst werden können.
Expand All @@ -35,26 +24,6 @@ Hier werden Probleme bei der Darstellung des Newsletters aufgeführt, die system
### Darstellung in Thunderbird
* Elemente werden nach einem Fenster Resize versetzt angezeigt. Abhilfe: E-Mail Anzeige neuladen.

## Hinweise zur Benutzung von Mailchimp

### Spambekämpfung
Der Großteil des weltweiten E-Mail Aufkommens ist Spam. Um den Spam zu verringeren wird versucht, diesen schon zu blockieren, bevor die Mails vom Mailserver angenommen werden. Grundsätzlich wird überprüft, ob der Mailserver, der die E-Mails verschickt diese auch verschicken darf. Mailchimp versendet die Newsletter von den Mailchimp-Servern und nicht von dem zu eurer Domain gehörigen Server. Mittels SPF und DKIM erteilt ihr den Mailchimp-Servern die Berechtigung Mails für eure Domain zu versenden.

Damit eure Newsletter nicht im Spamordner landen solltet ihr folgende zwei Einstellungen bei eurer Domain erstellen. Dazu müsst ihr zwei Einträge bei eurem DNS-Provider hinzufügen.

##### TXT(SPF) Record

v=spf1 a mx include:servers.mcsv.net ~all


##### DKIM (CNAME Eintrag)

Ersetze example.com durch eure Domain.

k1._domainkey.example.com CNAME dkim.mcsv.net

Nach ca. 24 Stunden sollten diese DNS-Änderungen im ganzen Internet verfügbar sein. Danach sollet ihr nur noch eure Domain in [Mailchimp authentifiziren](http://kb.mailchimp.com/delivery/deliverability-research/set-up-mailchimp-authentication).

## Fragen & Antworten
#### Warum werden einige Dateien über CDN Links geladen?
CDN steht für Content Delivery Network. Es handelt sich hierbei um einen Verbund von Servern, die speziell für die Auslieferung von statischen Dateien optimiert sind. Durch Einsatz des CDN und die Wiederverwendung der selben Resourcen durch Bund und Länder wird die Darstellung des Newsletters beschleunigt. Als Standard CDN wird cdn.pfadfinden.de verwendet.
Expand Down
38 changes: 38 additions & 0 deletions mailchimp/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# BdP Newsletter Template für MailChimp

version: 1.0.1

## Voraussetzungen
Es wird ein MailChimp Account benötigt. Dieser kann auf [mailchimp.com](//mailchimp.com/) kostenfrei angelegt werden.

## Installation
1. Lade die aktuelle Version des Templates unter [Github Releases](https://github.com/pfadfinden/newsletter/releases) als `.zip` Datei herunter.
2. Erstelle in MailChimp unter Template > Create Template ein neues Template. Importiere den HTML Code aus der Datei /mailchimp/newsletter_buena_mailchimp.html (Paste in code).
3. Ersetze Stamm ????? im Header und 2x im Footer durch deinen Stamm oder Landesverband.
4. Ersetze den automatischen Insert-Tag \*|LIST:ADDRESS|\* durch die postalische Adresse in der Form: Strasse Hausnummer, PLZ Ort, DE
5. Speichere das Template. Nun kann es unter Campaigns > Create Campaign genutzt werden.

## Update
Das Update des Extension erfolgt durch überschreiben des HTML-Codes der Datei /mailchimp/newsletter_buena_mailchimp.html (Paste in code) aus dem aktuellen Release (https://github.com/pfadfinden/newsletter/releases)

## Hinweise zur Benutzung von Mailchimp

### Spambekämpfung
Der Großteil des weltweiten E-Mail Aufkommens ist Spam. Um den Spam zu verringeren wird versucht, diesen schon zu blockieren, bevor die Mails vom Mailserver angenommen werden. Deshalb wird überprüft, ob der Mailserver, der die E-Mails verschickt, diese auch verschicken darf. Mailchimp versendet die Newsletter von den Mailchimp-Servern und nicht von dem zu eurer Domain gehörigen Server. Mittels SPF und DKIM erteilt ihr den Mailchimp-Servern die Berechtigung Mails für eure Domain zu versenden.

Damit eure Newsletter nicht im Spamordner landen solltet ihr folgende zwei Einstellungen bei eurer Domain erstellen. Dazu müsst ihr zwei Einträge bei eurem DNS-Provider hinzufügen.

##### TXT(SPF) Record

v=spf1 a mx include:servers.mcsv.net ~all


##### DKIM (CNAME Eintrag)

Ersetze example.com durch eure Domain.

k1._domainkey.example.com CNAME dkim.mcsv.net

Nach ca. 24 Stunden sollten diese DNS-Änderungen im ganzen Internet verfügbar sein. Danach sollet ihr nur noch eure Domain in [Mailchimp authentifiziren](http://kb.mailchimp.com/delivery/deliverability-research/set-up-mailchimp-authentication).


Loading

0 comments on commit aa09206

Please sign in to comment.