Grundlagen der Pegasus Mail Erweiterung

aus PmailWiki, der freien Wissensdatenbank

Inhaltsverzeichnis

[bearbeiten]

Was eine Erweiterung ist

Aus der deutschen Hilfe

"Eine Erweiterung ist ein Programm, das in Pegasus Mail geladen werden kann und dessen Funktionalität in irgendeiner Weise erweitert - entweder, indem eine neue Funktionalität zugefügt oder indem eine bestehende Funktionalität verändert wird. In anderen Programmen wird diese Technik auch Plug-In oder Snap-In genannt. Pegasus Mail wird mit einer Reihe dieser Erweiterungen ausgeliefert, die von dem Autor von Pegasus Mail geschrieben wurden; Erweiterungen können aber auch von völlig anderen Entwicklern angeboten werden."
[bearbeiten]

Wie Pegasus Mail eine Erweiterung findet

Pegasus Mail sucht beim Programmstart nach vorhandenen "Form Fact Files". Dies sind Textdateien die auf den Dateinamen ".FFF" enden und die Eigenschaften der Erweiterung beschreiben. ".FFF" trifft nur zu, wenn Pegasus Mail in seiner Originalsprache, also englisch, betrieben wird. Wird das Programm in einer übersetzten Fassung betrieben, so wird nach "Fxx" gesucht. "xx" ist hier durch den verwendeten Sprachschlüssel zu ersetzen. Bei der deutschsprachigen Programmversion ist "xx" durch "DE" zu ersetzen.

Pegasus Mail durchsucht mehrere Verzeichnisse nach ".Fxx" Dateien in der folgenden Reihenfolge:

  1. Briefkastenverzeichnis des Anwenders (home mailbox location)
  2. Pegasus Mail Programmverzeichnis
  3. Verzeichnis, das durch die DOS Umgebungsvariable "FFF=verzeichnispfad" angegeben ist

Dieses Vorgehen erlaubt sowohl die Verwendung von globalen als auch privaten Erweiterungen.

[bearbeiten]

Formaler Aufbau eines "Form Fact Files"

Für eine ausführliche Beschreibung wird auf die im "Extension Development Kit" enthaltene Dokumentation verwiesen. (Siehe Abschnitt "Erweiterung selber programmieren" weiter unten.)

"Form Fact Files" sind zeilenorientierte Textdateien. Leerzeilen und Zeilen, die mit den Zeichen #, ; oder * beginnen werden als Kommentarzeilen ignoriert. Befehlszeilen bestehen aus einer Schlüsselwortsequenz gefolgt von dem Zeichen = gefolgt von einem Parameter.

Folgende Schlüsselwortsequenzen werden erkannt und sind für eine Anpassung an die eigenen Bedürfnisse interessant:

  • Form name - Der Name, unter dem die Erweiterung in Pegasus Mail Menüs angezeigt wird.
    Beispiel: Form name = "Telefon-Notiz"
  • Form DLL - Pfad und Name des Programms (DLL), das Pegasus Mail laden muss, um die Erweiterung zu verwenden. Im Pfad kann auch den Platzhalter ~a verwendet werden, der durch das Pegasus Mail Programmverzeichnis ersetzt wird.
    Beispiel: Form DLL = ~a\FORMS.DE\TPH32DE.DLL
  • Bitmap file - Diese Schlüsselwortsequenz ist optional. Sie ermöglicht es diese Erweiterung der Pegasus Mail Werkzeugleiste als weiteren Knopf hinzuzufügen. Die Erweiterung kann dann einfach durch das Betätigen des Knopfes aufgerufen werden. Der Parameter besteht aus zwei Teilen, die durch ein Komma getrennt werden. Der erste Teil enthält Pfad und Name einer Windows .BMP Datei (Platzhalter wie bei "Form DLL" ist möglich). Die Grafik muss exakt 22x20 (BxH) Pixel groß sein. Der zweite Teil des Parameters ist ein Text, der als 'Tooltip' angezeigt werden soll. Der Text darf beliebige Zeichen enthalten und sollte nicht länger als 45 Zeichen sein.
    Beispiel: Bitmap file = ~a\FORMS\TPHONE.BMP,Telefon-Notiz erstellen
[bearbeiten]

Vorgegebene Verzeichnisstruktur für Erweiterungen

Nach einer deutschsprachigen Standardinstallation von Pegasus Mail wird, unter anderem, folgende Verzeichnisstruktur erzeugt. 

-- PMAIL --+--
           |
           +-- FORMS     <- für englischsprachige Erweiterungen
           |
           +-- FORMS.DE  <- für deutschsprachige Erweiterungen
           |

Damit ist es theoretisch möglich alle für eine Erweiterung erforderlichen Dateien, bis auf die ".Fxx"-Datei, in die "FORMS"-Verzeichnisse zu legen. Nur dadurch ist eine "saubere" mehrsprachige Integration einer Erweiterung möglich. Leider gibt es Erweiterungen, die (eigentlich sprachabhängige) Dateien intern festgelegt im Programmverzeichnis erwarten. Pegasus Mail selber geht hier, bei im Programmpaket mitgelieferten Erweiterungen, mit "schlechtem" Beispiel voran. Z.B. wird der englischsprachige "LDAP client" im Programmverzeichnis und nicht im dafür vorgesehenen "FORMS"-Verzeichnis abgelegt; die deutsche Fassung wandert brav nach "FORMS.DE".

[bearbeiten]

Erweiterung selber programmieren

Hierzu ist das "WinPMail 2.x Extension Development Kit" erforderlich. Eine aktuelle Fassung gibt es zur Zeit hier. Nach "You can download the latest version (1997/02/11) following this link." suchen.

[bearbeiten]

externe Links (zu Erweiterungen)

  • MAILMERGE von Martin Ireland
    Serienbriefe mit der Möglichkeit Anhänge zu versenden.
  • Ordner-Statistik von Wolfgang R. Schulz
    Zeigt alle Mail-Ordner von Pegasus-Mail incl. Größe und Dateinamen an.
  • Plato von Leon S. Salters
    This extension is capable of handling quotes, you can collect quotes, organize them in several files and create special Pegasus Mail files in order to use them in your email messages.
  • VIRSCAN von Martin Ireland
    Anhänge vor dem Öffnen/Speichern automatisiert mit einem Virenscanner prüfen.
  • idw's PGP-Frontend
    PGP-Erweiterung für Pegasus Mail von Michael in der Wiesche.
Von "http://pmail.con-takt.com/wiki/index.php?title=Grundlagen_der_Pegasus_Mail_Erweiterung"
'Persönliche Werkzeuge