### wp-greet ###

wp-greet ist ein WordPress-Plugin, mit dem eigene Grafiken und Fotos
als Grukarten aus einem WordPress-Blog gesendet werden knnen.
wp-greet bentigt das Plugin NextGenGallery
(http://alexrabe.boelinger.com/wordpress-plugins/nextgen-gallery/) ab
Version 0.83 zum Verwalten der Grukarten, sowie WordPress Version 2.2
oder hher. Getestet mit WordPress bis Version 2.5 und NextGen Gallery
bis Version 0.92.


Die Punkte 1. bis 4. dieser Anleitung setzen voraus, dass
NextGenGallery in der Version 0.83 oder hher bereits installiert ist.
Wer NextGen Gallery noch nicht installiert hat, findet unter Punkt 5
eine Kurzanleitung dazu.


1. Installation und Vorbereitungen:

Nach dem Download der zwei Dateien wp-greet.zip und PHPMailer_v2.0.0.zip
beide Verzeichnisse entpacken. Den Inhalt von  PHPMailer_v2.0.0 in das
Verzeichnis wp-greet/phpmailer kopieren. Die Datei wp-greet/phpmailer-conf.php
muss angepasst werden:
- bei    $wpg_smtpserver="localhost"
  statt "localhost" den jeweiligen SMTP-Servernamen eintragen (meist so etwas
  wie "smtp.deine-domain.de" oder nur "deine-domain.de")
- bei    // $wpg_smtpuser="babsi"
  und    // $wpg_smtppass="password"
  mssen, sofern der SMTP-Server eine Anmeldung verlangt, Username und Passwort
  angegeben werden. Diese Einstellungen sind providerabhngig. Wenn ein Eintrag
  notwendig ist, mssen auch die // am Zeilenanfang entfernt werden.

Anschlieend alle Dateien auf den Webspace in das Verzeichnis /wp-plugins
hochladen. Die Datei nggfunctions.php aus dem Verzeichnis wp-greet/patches
in das Verzeicnnis /wp-plugins/nextgen-gallery kopieren. (Die Originaldatei
sollte vorher gesichert werden.)
In der Pluginverwaltung das Plugin wp-greet aktivieren.


2. Einstellungen:

Im WordPress-Adminbereich werden unter "Einstellungen/wp-greet" die gewnschten
Einstellungen vorgenommen:

- Unter "Mailreturn-Pfad" kann eine Emailadresse angegeben werden, an die
  Grukarten, die nicht zugestellt werden konnten, zurckgeschickt werden.
- Unter "BCC-Kopie senden an" kann eine Emailadresse angegeben werden, an die eine
  Kopie jeder verschickten Grukarte gesendet wird (Blogbetreiber, die sich eine
  Kopie an die eigene Emailadresse schicken lassen, sollten Ihre Leser bzw. die
  potentiellen Grukarten-Verschicker auf diese Tatsache hinweisen).
- "Bild inline senden" wird aktiviert, wenn das Bild in der Mail und nicht als
  Anhang verschickt werden soll.
- Bei "Feste Bildbreite" sollte eine feste Breite fr das Bild eingestellt
  werden, die nicht grer ist als die Breite des Inhaltsbereichs des Blogs. Wenn
  breitere Bilder hochgeladen werden, wird ihre Gre dann automatisch angepasst
  (wobei die Bilder mglichst nicht in wesentlich grerem Format hochgeladen
  werden sollten, da die Qualitt durch die Verkleinerung sinkt).
- Durch Aktivierung von "Profilinformationen verwenden" wird die Emailadresse,
  die unter "Allgemeine Einstellungen" als Emailadresse hinterlegt ist, im
  Mailformular als Standard-Absenderadresse eingetragen.
- Wird "Logging aktivieren" markiert, werden Daten ber die verschickten Karten
  in der Datenbank abgespeichert. Momentan lsst sich diese Statistik nur direkt
  in der Datenbank in der Tabelle wp_wpgreet_stats (bzw. statt "wp_" das eigene
  Prfix) einsehen. Eine Integration in den Adminbereich ist geplant.
- Unter "Mindest-Benutzerstatus zum Versenden einer Karte" wird ausgewhlt, ob
  jeder Besucher Karten verschicken darf nur registrierte Blogbenutzer und
  welcher Benutzerstatus dazu notwendig ist.
- Unter "Standard Betreff" kann eine Standard-Betreffzeile angegeben werden, die
  vom Grukarten-Verschicker wieder gendert werden kann.
- Unter "Standard Mail-Header" und "Standard Mail-Footer" kann Text
  eingegeben werden, der standardmig ber und unter jeder Grukarte erscheint.

Die nderungen mit Klick auf "Update Options" abspeichern.


3. Benutzung:

a. In der Verwaltung von NextGenGallery eine neue Galerie fr die Grukarten
   anlegen und die Grafiken oder Fotos, die als Grukarten verschickt werden
   sollen, in diese Galerie hochladen.

b. Eine statische Seite erstellen und als Inhalt lediglich "&nbsp;[wp-greet]"
   (ohne die Anfhrungszeichen - das &nbsp; ist notwendig, weil es sonst einen
   XHTML-Fehler gibt) einfgen. Als Seitentitel z.B. "greet" angeben.
   Anschlieend die Seite verffentlichen und aus der Seitenauflistung
   ausschlieen. Das geht bei Nutzung von Widgets ganz einfach, indem die ID
   der Seite in der Widgetverwaltung bei "Ausschlieen" eingetragen wird.
   Wer keine Widgets nutzt, sucht in seiner sidebar.php den Befehl
   <?php wp_list_pages(); ?> und ndert ihn so:
   <?php wp_list_pages('exclude=ID'); ?>, wobei "ID" durch die ID der soeben
   erstellten Seite ersetzt wird.

c. Eine weitere statische Seite erstellen, auf der die Galerie, die die zu
   verschickenden Grafiken enthlt, aufgerufen wird. Hierzu wird auf der Seite
   eingefgt: [gallery=ID url=http://deine-domain.de/greet/], wobei "ID" ersetzt
   wird mit der ID der in Schritt a. erstellten Galerie und "deine-domain.de/greet/"
   mit dem Permalink der in Schritt b. erstellten Seite. Als Seitentitel fr
   diese Seite z.B. "Grusskarten" angeben und die Seite verffentlichen.

d. Im Blog die unter Punkt c. erstellte Seite, also
   "http://deine-domain.de/grusskarten/" aufrufen, wobei "deine-domain.de/grusskarten"
   natrlich wieder mit der eigenen URL ersetzt wird. Aus den Vorschaubildern
   das gewnschte per Klick auswhlen. Daraufhin ffnet sich eine Seite mit dem
   Bild in Groansicht und den Textfeldern Absender, Empfnger, Betreff und
   Nachrichtentext. Nachdem diese ausgefllt wurden, kann die Grukarte per Klick
   auf "Vorschau" begutachtet werden und dann entweder durch Anklicken von
   "Zurck" gendert werden oder durch Anklicken von "Senden" abgeschickt werden.

e. Grukarten knnen auch in einen Beitrag eingebunden werden. Hierzu wie in Punkt c.
   die Grukartenseite durch [gallery=ID url=http://deine-domain.de/greet/] aufrufen
   - auch hier natrlich mit entsprechender Anpassung der ID und der URL.


4. Anpassung des Designs

Zur Anpassung des Designs der Grukartenseite wird die Datei wp-greet.css
bearbeitet.

Bei schmalen Themes kann z.B. das Feld zum Eingeben des Nachrichtentextes verschmlert
werden durch Hinzufgen von
   .wp-greet-form textarea { width: 300px; }.

Um auf der Grukartenseite den gleichen Rahmen um das Bild zu haben wie auf der
bersichtsseite, wird dem stylesheet z.B. hinzugefgt
   .wp-greet-form img { border: 1px solid #a9a9a9; padding: 4px;}


5. Kurzanleitung zur Installation von NextGenGallery:

Das entpackte Verzeichnis nextgen-gallery in das Verzeichnis wp-plugins auf
den Webspace hochladen und das Plugin in der Pluginverwaltung aktivieren.
Es erscheint ein neuer Menpunkt "Gallery". Hier kann beim Unterpunkt "Optionen"
der Verzeichnispfad gendert werden, unter dem die Grukarten abgespeichert
werden sollen, wenn nicht der Standardpfad "wp-content/gallery" beibehalten
werden soll. Auerdem lsst sich unter "Thumbnails" die Thumbnailgre, also
die Gre der Vorschau-Bilder, verndern.
Weitere Verwendungshinweise zu NextGen Gallery und Links zu Dokumentationen
finden sich auf der Plugin-Seite:
http://alexrabe.boelinger.com/wordpress-plugins/nextgen-gallery/.