PMailinglist
Die Klasse PMailinglist bildet eine Mailingliste ab.
Dieses Objekt ist abgeleitet von > PObject.
Felder:
CreateDateTime (readonly) Deault
Subject Default
SubjectQuit Default
SubjectWelcome
fDeleted (readonly)
fPublic (readonly)
LastChange (readonly)
MailTemplate
MailTemplateQuit
MailTemplateWelcome
Memo
Name
POP3Code (writeonly)
POP3Login
POP3Server
SenderAddress
SenderAddressQuit
SenderAddressWelcome
SenderCheck
SenderConfirmationMail
SenderName
SenderNameQuit
SenderNameWelcome
function PMailinglist ($sMailinglist = "", $fDeleted = PS_TRASH_OUT)[KONSTRUKTOR]
Der Konstruktur erstellt eine Instanz der Klasse PMailinglist. Bei Übergabe einer Mailinglisten-ID oder eines Mailinglistennamens wird die entsprechenden Mailingliste geladen. Mit dem Parameter $fDeleted können jedoch auch gelöschte Mailinglisten, die sich im Papierkorb befinden, abgebildet werden ($fDeleted=PS_TRASH_IN).
function CheckMailAddress ($sMailAddress = "")
Prüft, ob es sich bei der übergebenen E-Mail-Adresse auch tatsächlich um eine solche handelt. Gibt eine 1 zurück, falls es sich um eine gültige E-Mail-Adresse handelt, ansonsten eine 0.
function Create ($sMailinglistname == "")
Legt eine neue Mailingliste in der Datenbank an, sofern nicht schon eine Mailingliste mit dem gleichen Namen existiert oder keine Name für die neue Mailingliste übergeben wurde. Wenn dies erfolgreich erledigt werden konnte, bildet dieses Objekt dann die neue Mailingliste ab. Sinnvoll ist es im Anschluß die Objektfunktion WriteField aufzurufen um die Valuewerte für die verschiedenen Felder zu definieren.
function Delete ($fDeleted = 0)
Löscht die Mailingliste in der Portalsuite Datenbank, die das Objekt repräsentiert. Normalerweise wird die Mailingliste dabei jedoch nur in den Portalsuite-Papierkorb verschoben. Wenn der Parameter $fDeleted auf 1 gesetzt wird, wird die Mailingliste sofort vollständig und unwiderruflich gelöscht.
function Field ($sFieldName)
Liest das übergebene Feld $sFieldName aus und liefert den Feldinhalt zurück.
function GetAddresses ()
Holt die Mail-Adressen aus dem Feld "SenderCheck", trennt diese und schreibt jede einzelne Mail-Adresse in ein Array-Feld. Das Array wird von der Funktion zurückgegeben.
function GetMails ()
Holt von dem für diese Mailingliste hinterlegten POP3-Konto E-Mails ab, überprüft, ob der Absender authentifiziert ist, E-Mails an diese Mailingliste zu versenden und erstellt dann einen Mailinglisten-Job.
function Restore ()
Stellt eine Mailingliste wieder her, die sich im Portalsuite-Papierkorb befindet.
function Subscribe ($sMailAddress = "", $sMemberName = "", $fMailWelcome = 1)
Prüft, ob die übergebene Mail-Adresse eine korrekte E-Mail-Adresse ist und diese Mail-Adresse noch nicht in der Mailingliste hinterlegt ist und legt dann ein neues Mailinglisten-Mitglied an. Ausserdem versendet diese Funktion auch direkt eine Willkommens-Mail an das neue Mitglied (falls entsprechende Daten hinterlegt sind und $fMailWelcome = 1 ist.
function Unsubscribe ($sMailAddress = "", $sMemberName = "", $fMailQuit = 1)
Prüft, ob die übergebene E-Mail-Adresse in der Mailingliste existiert und löscht diese. Wenn ein Name mit übergeben wird, muss der Name und die E-Mail-Adresse genau so in der datenbank existieren. Nach erfolgreicher Löschung wird eine Bestätigungsmail an das Mitglied geschickt (es sei denn $fMailQuit ist gleich 0).
function Valid ()
Prüft, ob das aktuelle Objekt gültig ist (Rückgabewert =1) oder nicht (Rückgabewert=0). Das Objekt ist gültig, wenn es eine Mailingliste in der Portalsuite Datenbank repräsentiert. Die Validfunktion wird u.a. von anderen Objektfunktionen aufgerufen.
function WriteField ($sFieldName, $sFieldValue)
Schreibt den übergebenen Inhalt der Variabel $sFieldValue in das Feld welches durch den Paramter $sFieldName definiert ist.
function MemberCallForEach ($sActionfunction,$sParameter)
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion CallForEach dieses Objektes). Ruft für alle Elemente einmal die mit dem Parameter $sActionfunction übergebene Funktion auf. Die aufzurufende Funktion erhält als ersten Parameter immer die Identifikationsnummer des jeweiligen Elementes. Der optionale Parameter $sParameter enthält für die aufzurufende Funktion weitere Parameter die einfach durchgereicht werden. Intern wird allerdings die Objektfunktion "CallForEachSelected" mit dem Parameter Mode=-1 aufgerufen!
function MemberCallForEachSelected ($sActionfunction,$sParameter,$fMode=1)
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion CallForEachSelected dieses Objektes). Ruft für Elemente einmal die mit dem Parameter $sActionfunction übergebene Funktion auf. Die aufzurufende Funktion erhält als ersten Parameter immer die Identifikationsnummer des jeweiligen Elementes. Der optionale Parameter $sParameter enthält für die aufzurufende Funktion weitere Parameter die einfach durchgereicht werden. Mit dem dritten Parameter $fMode kann definiert werden, ob alle Elemente berücksichtigt werden sollen (=-1), alle unselektierten (=0) oder alle selektierten (=1).
function MemberCreate($sMailAddress = "")
Ist eine Weiterleitungsfunktion an das Objekt PMailinglistMember (entspricht der Funktion Create dieses Objektes). Erstellt ein neues Mitglied für die aktuelle Mailingliste.
function MemberDelete()
Ist eine Weiterleitungsfunktion an das Objekt PMailinglistMember (entspricht der Funktion Delete dieses Objektes). Löscht das Mitglied, auf dem gerade der Zeiger steht.
function MemberDeSelectCurrent()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion DeSelectCurrent dieses Objektes). Hebt die Selektierung das aktuelle Mailinglisten-Mitglied auf.
function MemberEOF()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion EOF dieses Objektes). Liefert eine "1", wenn der Datensatzzeiger hinter dem letzten Element steht, ansonsten eine "0".
function MemberField ($sFieldName)
Ist eine Weiterleitungsfunktion an das Objekt PMailinglistMember (entspricht der Funktion Field dieses Objektes). Liest das übergebene Feld $sFieldName aus und liefert den Feldinhalt des Mitgliedes zurück, auf dem gerade der Zeiger steht.
function MemberGetCurrent()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion GetCurrent dieses Objektes). Gibt die interne Identifikationsnummer des Datensatzes des aktuellen Elementes zurück.
function MemberGoToNumber ($iNumber)
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion GoToNumber dieses Objektes). Setzt den Zeiger auf die mit $iNumber übergebene Position (sofern die übergebene Nummer kleiner / gleich der Anzahl der Mailinglisten-Mitglieder ist).
function MemberIsCurrentSelected()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion IsCurrentSelected dieses Objektes). Prüft, ob das Mailinglisten-Mitglied, auf dem gerade der Zeiger steht, slektiert ist oder nicht. Wenn es selektiert ist, dann wird eine "1" zurückgegeben, ansonsten eine "0".
function MemberListCount ()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion ListCount dieses Objektes). Zählt die Anzahl der Mitglieder dieser Mailingliste.
function MemberMoveFirst()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion MoveFirst dieses Objektes). Setzt den Zeiger auf das erste Mitglied dieser Mailingliste.
function MemberMoveFirstSelected()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion MoveFirstSelected dieses Objektes). Setzt den Zeiger auf das erste Mitglied dieser Mailingliste, welches selektiert wurde.
function MemberMoveLast()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion MoveLast dieses Objektes). Setzt den Zeiger auf das letzte Mitglied dieser Mailingliste.
function MemberMoveLastSelected()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion MoveLastSelected dieses Objektes). Setzt den Zeiger auf das letzte Mitglied dieser Mailingliste, welches selektiert wurde.
function MemberMoveNext()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion MoveNext dieses Objektes). Setzt den Zeiger auf das nächste Mitglied dieser Mailingliste.
function MemberMoveNextSelected()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion MoveNextSelected dieses Objektes). Setzt den Zeiger auf das nächste Mitglied dieser Mailingliste, welches selektiert wurde.
function MemberMovePrevious()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion MovePrevious dieses Objektes). Setzt den Zeiger auf das vorige Mitglied dieser Mailingliste.
function MemberMovePreviousSelected()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion MovePreviousSelected dieses Objektes). Setzt den Zeiger auf das vorige Mitglied dieser Mailingliste, welches selektiert wurde.
function MemberRemoveAll()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion RemoveAll dieses Objektes). Löscht unwiderruflich alle Mitglieder der Mailingliste.
function MemberSelectCurrent()
Ist eine Weiterleitungsfunktion an das Objekt PGroupMailinglistMembers (entspricht der Funktion SelectCurrent dieses Objektes). Selektiert das aktuelle Mailinglisten-Mitglied.
function MemberWriteField ($sFieldName,$sFieldValue)
Ist eine Weiterleitungsfunktion an das Objekt PMailinglistMember (entspricht der Funktion WriteField dieses Objektes). Schreibt den übergebenen Inhalt der Variable $sFieldValue in das Feld welches durch den Paramter $sFieldName definiert ist.
Jede Instanz von der Klasse PMailinglist enthält auch eine Instanz von der Klasse PGroupMailinglistMembers, in der alle Mitglieder der entsprechenden Mailingliste hinterlegt sind.
Auf diese Instanz kann mit den Member...-Funktionen zugegriffen werden.
Beispiel:
// für die Liste NameMeinerMailingliste wird eine Instanz angelegt
// gleichzeitig wird in dem Objekt eine Instanz vom Typ
// PGroupMailinglistMembers angelegt, in der alle Mailinglisten-
// Mitglieder hinterlegt sind. Der Zeiger steht in dieser Instanz
// automatisch ganz am Anfang.
$o_MeineMailingliste = new PMailinglist ("NameMeinerMailingliste");
// es soll nun jedes Mitglied dieser Mailingliste ausgegeben werden
// dazu wird die gesamte Instanz vom Typ PGroupMailinglistMembers durchlaufen
while (!$o_MeineMailingliste->MemberEOF())
{
// nun werden die gewünschten Elemente an der aktuellen Zeigerposition
// ausgelesen
// der Mitgliedsname wird in eine Variable übergeben
$AktuellesMitgliedName = $o_MeineMailingliste->MemberField ("Name");
// die Mail-Adresse des Mitglieds wird ausgelesen
$AktuellesMitgliedMailAdresse = $o_MeineMailingliste->MemberField ("MailAddress");
// die Werte werden ausgegeben
echo ($AktuellesMitgliedName.", ".$AktuellesMitgliedMailAdresse."<br>");
// der Zeiger in der Instanz com Typ PGroupMailinglistMembers wird eine Position
// weiter gesetzt
$o_MeineMailingliste->MemberMoveNext();
} // ENDE while (!$o_MeineMailingliste->MemberEOF())
[zurück] -
[bookmarken] -
[Druckversion] - [Weiterempfehlen] - [Kontakt] - [Impressum]
Copyright © 2000-2012 by Portunity GmbH - Alle Rechte vorbehalten.
Diese Seite wird mit der Portunity Portalsuite Enterprise-Edition betrieben.
| 
