1. Kopieren Sie config.dist.php nach config.php und editieren Sie diese Datei, so dass die Einstellungen für Ihren Server stimmen (nur empfohlen für Personen mit PHP-Kenntnissen) oder rufen Sie admin/mkconfig.php auf, um eine config.php zu erzeugen. (wenn Sie eine PHP Version >=4.2.0 benutzen, so müssen Sie $new_global_handling=true; in mkconfig.php einstellen)
   Anmerkung: Sie können mehrere Instanzen von SimpNews in einer Datenbank haben. Benutzen Sie dabei nur bei jeder Installation verschiedene Werte für tableprefix in der config.php. Dies muss gemacht werden bevor Sie install.php aufrufen.
   
   Stellen Sie beim Upgrade von einer alten Installation sicher, daß Sie alle neuen Variablen der aktuellen Version in Ihre bestehende config.php übernehmen!
2. Kopieren Sie alle Dateien (.php, .inc ...) auf den Webhost. Bitte unbedingt die Unterverzeichnisstruktur beibehalten.
   Wichtig: Die Dateien in /applet, /gfx und /sfx im Binärmodus übertragen !!!!
3. 1. Erstinstallation:
      Rufen Sie nun http://ihr.host.de/installationsverzeichnis/admin/install.php auf, um die Tabellen in der Datenbank zu erzeugen und den ersten Administrator zu definieren.
   2. Updates:
      IM AKTUELLEN ARCHIV SIND NUR UPDATE-SKRIPTS FÜR UPDATES AB >=V2.25 VORHANDEN !!! UM DAS UPDATE ÄLTERER SKRIPTS DURCHZUFÜHREN LADEN SIE BITTE NOCH DAS UPDATE-PAKET AUF 2.25 HERUNTER !!
      Alle Dateien (.php, .inc ...) auf dem Server durch die neuen ersetzen.
      So bestimmen Sie das benötigte Updateskript:
      • Nehmen Sie die aktuell installierte Version (z.B. 1.10)
      • Entfernen Sie den Punkt innerhalb der Versionnummer (im Beispiel wird das dann 110).
        Jetzt haben Sie die benötigte Updateversion.
      • Benutzen Sie nun alle Updateskripts von dieser Version an bis zur aktuellen Version (in der richtigen Reihenfolge).
        Angenommen im Beispiel wäre die aktuelle Version 1.22 (kurz 122), dann benutzen Sie upgrade_110_to_111.php, danach upgrade_111_to_112.php usw. bis upgrade_121_to_122.php.
        Existiert eines der Zwischenskripte nicht, so war bei den entsprechenden Versionen kein Update der DB nötig. Fahren sie in diesem Fall einfach mit dem nächsten, passenden Skript in der Reihe fort.
4. Nach der Installation entfernen Sie bitte mkconfig.php, install.php, upgrade_* and fill_* vom Server und setzen die Dateizugriffsrechte für die config.php so, dass PHP nicht in die Datei schreiben kann (bei den meissten Serverkonfigurationen ist das chmod 644).
5. Nun können Sie sich bei der Administrationsoberfläche unter

   http://ihr.host.de/installionsverzeichnis/admin/index.php

   mit dem bei der Installation angegebenen Daten anmelden.

• Liste der News:
  • Typ 1:
    

    http://your.host.com/installdir/news.php?params

  • Typ 2:
    

    http://your.host.com/installdir/news4.php?params

  • Typ 3:
    

    http://your.host.com/installdir/news5.php?params

• Liste der News, in einer Archivkategorie:
  • Typ 1:
    

    http://your.host.com/installdir/news_arc.php?params

  • Typ 2:
    

    http://your.host.com/installdir/news4_arc.php?params

• Liste der News, nach Kategorien getrennt:
  • Typ 1:
    

    http://your.host.com/installdir/news2.php?params

  • Typ 2:
    

    http://your.host.com/installdir/news3.php?params

• Anmeldeformular für das Abonnement:
  

  http://your.host.com/installdir/subscription.php?params

• Kalender mit den Events:
  

  http://your.host.com/installdir/eventcal.php?params

• Liste mit allen eingetragenen Events:
  • Typ 1:
    

    http://your.host.com/installdir/events.php?params

  • Typ 2:
    

    http://your.host.com/installdir/evlist2.php?params

  • Typ 3:
    

    http://your.host.com/installdir/evlist3.php?params

• News und Kategorieliste als Frameset:
  

  http://your.host.com/installdir/newsframe.php?params

• RSS Newsfeed:
  

  http://your.host.com/installdir/rss_news.php?params

• WAP Seiten:
  • WAP Kategorieliste:
    

    http://your.host.com/installdir/wap_catlist.php?params

  • WAP Kategorieliste Typ 2:
    

    http://your.host.com/installdir/wap_catlist2.php?params

  • WAP Eventsuche:
    

    http://your.host.com/installdir/wap_ev_search.php?params

  • WAP Eventliste Typ 1:
    

    http://your.host.com/installdir/wap_short_events.php?params

  • WAP Eventliste Typ 2:
    

    http://your.host.com/installdir/wap_short_events2.php?params

  • WAP Liste der Ankündigungen:
    

    http://your.host.com/installdir/wap_short_announce.php?params

  • WAP Liste der News:
    

    http://your.host.com/installdir/wap_short_news.php?params

• Dem erste Parameter nach der URL muss ein? vorangestellt werden (z.B. news.php?language=de)
• Allen folgenden Parametern muss ein & vorangestellt werden (z.B. news.php?language=de&layout=1)

Listen in Ihre eigenen Seiten einbinden

Hotnewsliste

1. Mit

   include('<pathtosimpnews>/hotnews.php');

   bzw.

   include('<pathtosimpnews>/hotnews2.php');

   bzw.

   include('<pathtosimpnews>/hotnews4.php');

   bzw.

   include('<pathtosimpnews>/hotnews5.php');

   bzw.

   include('<pathtosimpnews>/hotnews6.php');

   bzw.

   include('<pathtosimpnews>/hotnews7.php');

   bzw.

   include('<pathtosimpnews>/hotnews8.php');

   bzw.

   include('<pathtosimpnews>/hotnews9.php');

   können Sie das Skript in Ihre Seite einbinden.
2. Wenn Sie das Cookie für die Speicherung des letzten Besuches verwenden wollen, benutzen Sie

   include('<pathtosimpnews>/newscookie.php');

   um die Cookieroutine in Ihre bestehende Seite einzubinden.
   Diese Datei muss eingebunden werden, bevor der HTTP Body von PHP gesendet wird.

Liste der aktuellen Events

1. Mit

   include('<pathtosimpnews>/currentevents.php');

   können Sie das Skript in Ihre Seite einbinden.
2. Wenn Sie das Cookie für die Speicherung des letzten Besuches verwenden wollen, benutzen Sie

   include('<pathtosimpnews>/newscookie.php');

   um die Cookieroutine in Ihre bestehende Seite einzubinden.
   Diese Datei muss eingebunden werden, bevor der HTTP Body von PHP gesendet wird.

Icon für die Anzeige von neuen News

ohne Cookie für letzten Besuch

1. Mit

   include('<pathtosimpnews>/newsnotify.php');

   können Sie das Skript in Ihre Seite einbinden.

mit Cookie für letzten Besuch

1. Mit

   include('<pathtosimpnews>/newsnotify2.php');

   können Sie das Skript in Ihre Seite einbinden.
2. Wenn Sie das Cookie für die Speicherung des letzten Besuches verwenden wollen, benutzen Sie

   include('<pathtosimpnews>/newscookie.php');

   um die Cookieroutine in Ihre bestehende Seite einzubinden.
   Diese Datei muss eingebunden werden, bevor der HTTP Body von PHP gesendet wird.

Eventkalender

1. Mit

   include('<pathtosimpnews>/eventcal2.php');

   können Sie das Skript in Ihre Seite einbinden.
2. Wenn Sie das Cookie für die Speicherung des letzten Besuches verwenden wollen, benutzen Sie

   include('<pathtosimpnews>/newscookie.php');

   um die Cookieroutine in Ihre bestehende Seite einzubinden.
   Diese Datei muss eingebunden werden, bevor der HTTP Body von PHP gesendet wird.

Ticker Java Applets

• newsticker.php
• newsscroller.php
• newstyper.php
• newsmsgtyper.php
• starscroller.php
• eventscroller.php

1. Mit

   include('<pathtosimpnews>/<script>');

   können Sie das Skript in Ihre Seite einbinden.
2. Wenn Sie das Cookie für die Speicherung des letzten Besuches verwenden wollen, benutzen Sie

   include('<pathtosimpnews>/newscookie.php');

   um die Cookieroutine in Ihre bestehende Seite einzubinden.
   Diese Datei muss eingebunden werden, bevor der HTTP Body von PHP gesendet wird.

JavaScript newsfader/newsscroller

1. Mit

   include('<pathtosimpnews>/js_newsfader.php');

   bzw.

   include('<pathtosimpnews>/js_newsscroller.php');

   können Sie das Skript in Ihre Seite einbinden.
2. Wenn Sie das Cookie für die Speicherung des letzten Besuches verwenden wollen, benutzen Sie

   include('<pathtosimpnews>/newscookie.php');

   um die Cookieroutine in Ihre bestehende Seite einzubinden.
   Diese Datei muss eingebunden werden, bevor der HTTP Body von PHP gesendet wird.

catlist_inc.php

1. Mit

   include('<pathtosimpnews>/catlist_inc.php');

   können Sie das Skript in Ihre Seite einbinden.

Newsletterbestellung

Durch von der Anwendung erzeugte Formulare

Bestellung von einzelnen Newslettern

Bestellung von mehreren Newslettern auf einmal

Verwaltung der bestellten Newsletter

Newsletterbestellung in eigene Seiten einbauen

Formular zur Bestellung eines einzelnen Newsletters

<!-- --------- Start of subscription code --------- -->
<table width="80%" align="center">
<form method="post" action="/simpnews/subscription.php">
<input type="hidden" name="lang" value="de">
<input type="hidden" name="layout" value="1">
<input type="hidden" name="mode" value="subscribe">
<tr><td align="right" width="30%">E-Mail:</td>
<td><input type="text" name="email" size="40" maxlength="240"></td></tr>
<tr><td align="right" valign="top">E-Mailart:</td><td>
<input type="radio" name="emailtype" value="0" checked> HTML<br>
<input type="radio" name="emailtype" value="1"> nur text</td></tr>
<input type="hidden" name="newscat" value="{desired category}">
<td align="center" colspan="2"><input type="submit" value="subscribe">
</td></tr></form></table>
<!-- --------- End of subscription code --------- -->

<!-- --------- Start of unsubscription code --------- -->
<table width="80%" align="center">
<form method="post" action="/simpnews/subscription.php">
<input type="hidden" name="lang" value="de">
<input type="hidden" name="layout" value="1">
<input type="hidden" name="mode" value="unsubscribe">
<tr><td align="right" width="30%">E-Mail:</td>
<td><input type="text" name="email" size="40" maxlength="240"></td></tr>
<input type="hidden" name="newscat" value="{desired category}">
<td align="center" colspan="2"><input type="submit" value="unsubscribe">
</td></tr></form></table>
<!-- --------- End of unsubscription code --------- -->

Formular zu Bestellung mehrere Newsletter auf einmal

Administrationsoberfläche

Hinweis zu den Dateianhängen

Anmerkung zum Feld "Vermerk (wird in E-Mails mitgeschickt)" im Layout:

Textbausteine

• Anmerkung für übernommenen Eintragsvorschlag
  • {postername} --> Name der Person, die den Eintrag (Event, bzw. News) vorgeschlagen hat.
  • {postermail} --> E-Mailadresse der Person, die den Eintrag vorgeschlagen hat.
• Benachrichtigung bei neuen Vorschlägen (Betreff)
  • {sitename} --> In der config.php definierter Websitename
  • {ptype} --> Art des Vorschlags. Bei News wird hier "News" und bei Events "Events" eingetragen
• Benachrichtigung bei neuen Vorschlägen (Mailtext)
  • {sitename} --> In der config.php definierter Websitename
  • {ptype} --> Art des Vorschlags.
  • {category} --> Name der Kategorie, für die der Vorschlag ist
  • {postername} --> Name der Person, die den Vorschlag verfasst hat.
  • {postermail} --> E-Mailadresse der Person, die den Vorschlag verfasst hat.
  • {linkurl} --> URL, die direkt zur Anzeige des Vorschlags in der Administrationsoberfläche führt.
• Benachrichtigung bei neuem Abonnenten (Betreff)
  • {sitename} --> In der config.php definierter Websitename
• Benachrichtigung bei neuem Abonnenten (Mailtext)
  • {sitename} --> In der config.php definierter Websitename
  • {email} --> E-Mailadresse des Abonnenten.
  • {category} --> Name der Kategorie, für die der Vorschlag ist
  • {linkurl} --> URL, die direkt zur Anzeige des Abonnenten in der Administrationsoberfläche führt.
• Benachrichtigung bei Abmeldung eines Abonnenten (Betreff)
  • {sitename} --> In der config.php definierter Websitename
• Benachrichtigung bei Abmeldung eines Abonnenten (Mailtext)
  • {sitename} --> In der config.php definierter Websitename
  • {email} --> E-Mailadresse des Abonnenten.
  • {category} --> Name der Kategorie, für die der Vorschlag ist
• Bestätigungsmail bei Aboabmledung
  • {sitename} --> In der config.php definierter Websitename
  • {confirmurl} --> URL, die der Besucher aufrufen muss, um seine Abmeldung zu bestätigen
• Bestätigungsmail bei Aboanmeldung
  • {sitename} --> In der config.php definierter Websitename
  • {confirmurl} --> URL, die der Besucher aufrufen muss, um seine Anmeldung zu bestätigen
  • {confirtime} --> Zeitraum, in dem die Bestätigung erfolgen muss
• Bestätigungsmail bei Aboabmledung (nlmaint.php)
  • {sitename} --> In der config.php definierter Websitename
  • {confirmurl} --> URL, die der Besucher aufrufen muss, um seine Abmeldung zu bestätigen
  • {catname} --> Name der gewählten Kategorie
• Bestätigungsmail bei Aboanmeldung (massub.php)
  • {sitename} --> In der config.php definierter Websitename
  • {confirmurl} --> URL, die der Besucher aufrufen muss, um seine Anmeldung zu bestätigen
  • {confirtime} --> Zeitraum, in dem die Bestätigung erfolgen muss
  • {catname} --> Name der gewählten Kategorie
• Benachrichtigung bei neuem Kommentar (Betreff)
  • {sitename} --> In der config.php definierter Websitename
• Benachrichtigung bei neuem Kommentar (Mailtext)
  • {sitename} --> In der config.php definierter Websitename
  • {email} --> E-Mailadresse des Verfassers.
  • {poster} --> Name des Verfassers.
  • {entry} --> # des Eintrags, auf den sich der Kommentar bezieht.
  • {linkurl} --> URL, die direkt zur Anzeige des Abonnenten in der Administrationsoberfläche führt.

Authentifizierung von Administratoren

1. Die interne Authentifizierungsmethode. Diese basiert auf den Benutzerdaten, die per Administrationsoberfläche eingegeben wurden und benutzt ein Cookie für das Sessionhandling.
2. wie 1, aber die Session-ID wird per GET und POST übermittelt.
3. Authentifizierung durch den Webserver (z.B. .htaccess)

Methode #1

• $url_simpnews
• $cookiename
• $cookiepath
• $cookiesecure
• $sesscookiename
• $sesscookietime

Methode #2

Methode #3

Speicherart für Dateianhänge ändern

getestete Browser und Systeme

Lizenzbestimmungen

• language/*
• admin/language/*
• stylesheets (*.css)
• index.html
• metadata.php
• die gekennzeichneten Bereiche in den Dateien im Hauptverzeichnis, d.h. Sie dürfen Änderungen nur zwischen

  // begin user editable part

  und

  // end user editable part

  vornehmen