Konfiguration
Bevor Sie WebYep am Webserver installieren, sollten Sie noch die nötigen Konfigurationseinstellungen vornehmen. Vordringlich ist hier der Name und das Kennwort für die Anmeldung. Wenn die BenutzerInnen der Website Änderungen an einer Seite vornehmen wollen, müssen diese sich per Name und Kennwort identifizieren (nach Klick auf das Schloss-Symbol in der Seite). Dieser Name und das Kennwort sind die ersten Konfigurationseinstellungen, die Sie vornehmen sollten.
Die Konfiguration ist in der Datei konfiguration.php im webyep-system Ordner gespeichert. Um sie zu bearbeiten, öffnen Sie diese Datei in einem beliebigen Text-Editor. Sie können auch Dreamweaver dafür verwenden – Sie sollten dabei aber auf die "Quelltext-Ansicht" wechseln, da die Konfigurationsdatei ausschließlich PHP-Code enthält.
Wichtig: Die Konfigurationsdatei verwendet die UTF-8 Kodierung um auch Sonderzeichen korrekt darstellen zu können. Manche Text-Editoren setzen eine unsichtbare Zeichensequenz an den Beginn der Datei, wenn sie diese speichern: Die UTF-8 BOM Sequenz (Byte Order Mark). Dadurch wird die Konfigurationsdatei leider unbrauchbar (PHP kann dann keine HTTP-Header mehr senden). Bitte schalten Sie die Option für das Erzeugen der UTF-8 BOM in Ihrem Editor ab, oder verwenden Sie einen Editor, der diese nicht in die Datei einfügt.
Name und Kennwort
Um den Benutzernamen und das Kennwort einzustellen, ändern Sie bitte den Text zwischen den Anführungszeichen in diesem Block der Konfigurationsdatei:
$webyep_sAdminName = "admin";
$webyep_sAdminPassword = "test";
Bitte beachten Sie dabei, dass bei Name und Kennwort die Groß-/Kleinschreibung relevant ist!
Zeichenkodierungen
Sie können mit der Konfigurationsvariable $webyep_sCharset die verwendete Zeichenkodierung (Character Set) einstellen. Tragen Sie hier gleiche Zeichenkodierung ein, die Sie auch in Ihren Webseiten verwenden – z.B. UTF-8.
$webyep_sCharset = "utf-8";
Wenn Sie eine explizite Kodierung konfigurieren, wird WebYep Sonderzeichen nicht mehr in HTML-Entities wandeln.
Mehrere BenutzerInnen (multiple logins)
Sie können mehrere Name/Kennwort-Kombinationen (Logins) definieren um verschiedenen BenutzerInnen das Editieren unterschiedlicher Seiten Ihrer Website zu erlauben.
Das oben definierte Login ist dann das Master Login - nach Anmelden mit diesem Namen und diesem Kennwort können Sie alle WebYep-Inhalte der Website editieren.
Sie können mehrere Logins definieren, indem Sie einen oder mehrere Blöcke folgender Form in die Konfigurationsdatei einfügen:
$webyep_aMultiLoginName[] = "einName";
$webyep_aMultiLoginPassword[] = "einKennwwort";
$webyep_aMultiLoginURLPatterns[] = "/eineSeite.php /andereSeite.php";
Mit den ersten beiden Zeilen legen Sie eine neue Name/Kennwort-Kombination (ein neues Login) fest. Mit der dritten Zeile definieren Sie, welche Seite(n) oder Seitengruppen (durch Platzhalter) dieses Login editieren darf, indem Sie die URL-Pfade für diese Seiten angeben.
Wichtig: Bitte beachten Sie die eckigen Klammern nach den Konfigurationsvariablen-Namen. Dies ist ein Unterschied zu anderen Konfigurationsvariablen.
Im einfachsten Fall wird hier einfach nur der URL-Pfad zu einer Seite angegeben.
Sie können aber auch die Pfade für mehrere Seiten angeben, jeweils durch ein Leerzeichen getrennt. Bitte beachten Sie, dass URL-Pfade eigentlich keine Leerzeichen oder andere Sonderzeichen enthalten dürfen. Sonderzeichen müssen mit der URL-Kodierung notiert werden (z.B. "%20" für ein Leerzeichen).
Sie können auch Platzhalter in den Pfadangaben verwenden ("*", den Stern) - die Pfadangabe passt dann auf mehrere Seiten oder ganze Seiten-Gruppen. Um zum Beispiel alle Seiten in einem bestimmten Ordner anzugeben, müsste nur der Pfad zu dem Ordner, gefolgt von einem Schrägstrich, gefolgt von einem Stern angegeben werden:
$webyep_aMultiLoginURLPatterns[] = "/einOrdner/*";
Ein paar Worte zu URL-Pfaden
Wenn Sie die Pfade für ein Login definieren, ist es wichtig, dass Sie sich über die Pfadstruktur Ihrer Website im Klaren sind.
Der Pfad-Teil eines URLs ist der Teil direkt hinter dem Hostnamen - z.B. im URL
http://www.einewebsite.net/ordner/unterordner/seite.php
wäre der Pfad-Teil:
/ordner/unterordner/seite.php
Wenn Sie also einem Login das Editieren dieser Seite erlauben möchten, so müssten Sie in die Konfigurationsvariable $webyep_aMultiLoginURLPatterns[] folgendes eintragen:
$webyep_aMultiLoginURLPatterns[] = "/ordner/unterordner/seite.php";
Wichtig: Beachten Sie den Schrägstrich am Beginn der Pfadangabe. Wenn dieser weggelassen wird, würde es sich um einen relativen Pfad handeln. Ein solcher Pfad würde auch auf alle Seiten-Pfade passen, die nur mit dieser Zeichenfolge enden.
Beispiele für URL Pfadangaben
Das Login soll...
...nur die beiden Seiten "/SeiteA.php" und "/SeiteB.php" editieren können:
$webyep_aMultiLoginURLPatterns[] = "/SeiteA.php /SeiteB.php";
...alle Seiten im Ordner "/workshops" sowie die Seite "/news.php" editieren können:
$webyep_aMultiLoginURLPatterns[] = "/workshops/* /news.php";
...alle Seiten im Ordner "/workshops" und seinen direkten Unterordnern editieren können:
$webyep_aMultiLoginURLPatterns[] = "/workshops/* /workshops/*/*";
...alle Seiten mit dem Dateinamen "veranstaltungen.php" editieren können - egal in welchem Ordner sie liegen:
$webyep_aMultiLoginURLPatterns[] = "veranstaltungen.php";
(Beachten Sie den fehlenden Schrägstrich am Beginn! Dadurch wird dies zu einer relativen Pfadangabe, die auf alle Pfade passt, die auf ".../veranstaltungen.php" enden)
...alle Seiten, deren Dateiname mit "_oeffentlich.php" endet, egal in welchem Ordner sie liegen:
$webyep_aMultiLoginURLPatterns[] = "*_oeffentlich.php";
Hinweis: Um die passende Pfadangabe für eine Seite oder Seitengruppe zu finden, definieren Sie am besten zuerst den Namen und das Kennwort für das Login. Melden Sie Sich dann im Web-Browser mit diesem Login an und navigieren Sie zu der betreffenden Seite Ihrer Website. Erscheinen die Editier-Knöpfe inaktiv, korrigieren Sie die Pfadangabe und laden Sie die Seite neu (Reload) – bis die Editier-Knöpfe aktiv erscheinen.
Stellen Sie danach aber auch sicher, dass andere Logins die betreffende Seite nicht editieren können!
Abmelden und mit anderem Login anmelden
Einmal im Browser mit einem Login angemeldet, bleiben Sie in diesem Login für die gesamte Browser-Session (Laufzeit des Browsers). BenutzerInnen wechseln ja üblicherweise nicht zwischen verschiedenen Logins.
Wenn Sie aber gerade die Logins konfigurieren, werden Sie doch zwischen den verschiedenen Logins wechseln wollen. Sie können dazu einfach den Browser beenden und sich danach mit einem anderen Login anmelden.
Oder Sie halten die ALT- (Umschalt) und/oder SHIFT- (Großschreib) Taste Ihrer Tastatur, während Sie auf das Ausloggen-Symbol von WebYep klicken (offenes Schloss) - ja nach dem welchen Browser Sie verwenden: Beim Safari verwenden Sie die SHIFT-Taste, beim Firefox SHIFT und ALT gemeinsam und beim Internet Explorer nur die ALT-Taste.
Globale Inhalte
WebYep Elemente die als "global" gekennzeichnet sind (deren "Inhalte" Attribut auf "für alle Seiten" steht) können üblicherweise nur vom Master Login editiert werden.
Wenn Sie möchten, dass auch alle anderen Logins globale Inhalte editieren können (sofern sie sich auch Seiten befinden, die diese editieren dürfen), dann ändern Sie folgende Konfigurationsvariable:
$webyep_bOtherLoginsMayEditGlobalData = true;