NEWSolved Readme


:: Inhalt ::

1. Lizenzbedinung
2. Installaiontvorraussetzungen
3. Installation
4. Ausgabe
5. Administrationbereich
6. Changelog
7. Sonstiges





1. Lizenzbedinung Die aktuellste geltende Fassung der Lizenzbestimmungen findet sich immer auf USOLVED.net
  • Es ist nicht gestattet das Copyright zu entfernen, verändern oder unkenntlich zu machen. Mit dem Kauf einer entsprechenden Lizenz erhalten Sie eine Version ohne Copyright, dürfen aber kein eigenes Copyright unter das Script setzen.
  • Der Quellcode, oder ein Teil aus diesem, darf nicht kopiert und für eigene Zwecke verwendet werden.
  • USOLVED ist nicht für die Inhalte der Seite, auf denen ein Script eingesetzt wird, verantwortlich. Außerdem untersagen wir, mit dem Newsletter Script NLetter Spam jeglicher Art zu versenden.
  • Der Autor übernimmt keine Haftung oder Gewährleistung für die angebotenen Scripte.
  • Die Scripte dürfen nur privat kostenlos eingesetzt werden solange das Copyright zu sehen ist. Gemeinnützigen Vereinen ist ebenfalls eine kostenlose Nutzung mit den gleichen Einschränkungen wie für Privatpersonen gestattet.
  • Bei kommerziellen Nutzen muss eine Lizenz erworben werden, die Sie auch, je nach Lizenzwahl, dazu berechtigt das Copyright zu entfernen. Dies gilt für Firmen, Gesellschaften und den gewinnorientierten Einsatz durch Privatpersonen.
  • Die Lizenz gilt nur pro Domain.
  • Die Scripte dürfen auf keiner anderen Seite zum Download angeboten werden.
  • Die Scripte dürfen nicht auf pornografischen, gewaltverherrlichenden, rechtsextremen, und im Allgemeinen nicht auf Seiten mit illegalen Inhalten verwendet werden. Ebenfalls untersagt ist die Anwendung der Skripte auf Seiten, die das Dritte Reich idealisieren.
  • Wir behalten uns vor, Lizenzen ohne Angabe von Gründen nicht auszustellen.
  • Mit dem Download des Scripts erkennen Sie die Lizenz- und Nutzungsbedingung an.




2. Installaiontvorraussetzungen

Ein Webserver mit mindestens PHP v4.0 und einer MySQL Datenbankanbindung.




3. Installation

1.) Die path.php öffnen und bei $url_path="http://"; euren Pfad zum Script schreiben
(sofern dieser nicht automatisch vom Installationsscript erkannt wird)
2.) Alle Dateien und Verzeichnisse der Zip Datei auf den Server mit einem FTP Programm hochladen
3.) In das Verzeichnis settings/ gehen und für die Datei config.php den CHMOD 777 festlegen (Meist möglich durch Rechtsklick auf die Datei)
4.) Für Template Export, WAP und KlipFolio Unterstützung muss man bei folgende Dateien ebenfalls noch den CHMOD auf 777 stellen:
    /dl/
    /dl/cat
    /dl/files
    /dl/images
    /templates/styles
    /newsreader/newsscript_klipfolio.klip
    /newsscript_wap.wml

5.) Im Browser Adresse zur install.php eingeben. Zum Beispiel: http://wwww.adresse.net/mysite/script/install.php
6.) Wenn ihr den Pfad richtig angegeben habt, solltet ihr dazu aufgefordert werden eure Datenbank Daten anzugeben damit ihr eine Verbindung zu dieser aufbauen könnt. Diese Daten sind meist die gleichen wie bei eurem FTP Login. Ansonsten einfach bei eurem ISP nachfragen. Habt ihr auf 'Weiter' geklickt wird eine Testverbindung zur Datenbank aufgebaut. Waren eure Daten korrekt seit ihr bereits mit der Installation des Newsscripts fertig.

............................................................

Zur Einbindung des Scripts in eure Seite gibt es 2 verschiedene Möglichkeiten. Entweder per iFrame:
<iframe src="relativer_pfad_zum_script/newsscript.php" frameborder="0" width="100%" height="600"></iframe>

Oder per Include in eine Datei: (Die Seite in die das Script eingebunden wird muss die Endung *.php haben)
<? include("relativer_pfad_zum_script/newsscript.php"); ?>

Danach sollte die install.php vom Server gelöscht werden. Es kann zwar niemand etwas böses damit anstellen da er die Datenbank Daten nicht hat, aber sicher ist sicher.




4. Ausgabe

Hier wird die über den Admin Bereich verfasste News ausgegeben. Das Layout ist über den Admin Bereich individuell Einstellbar.

Ist Die Funktion "Jedem Besucher anzeigen welche News neu ist" aktiviert wurden im Admin Bereich dann müssen noch die Zeilen 12 und 13 wegkommentiert werden, allerdings nur, wenn das Newsscript alleine in einem Frame z.B. angezeigt wird oder auf andere Weise ohne Einbindung in eine Seite erfolgte. Ansonsten muss in seinem Code selbst folgender Quellcode eingefügt werden, vor jeder anderen HTML Ausgabe:
<?
$usolved_ns_new=$_COOKIE['usolved_ns_new'];
setcookie("usolved_ns_new",time(),time()+31536000);
?>


Sollen die Latest News, der Newsticker, das Archiv oder Kategorien-News seperat angezeigt werden kann folgende URL zum Include verwendet werden:

Latest News:
<? $m="latest";
include("relativer_pfad_zum_script/newsscript.php");
unset($m); ?>

Archiv:
<? $m="archive";
include("relativer_pfad_zum_script/newsscript.php");
unset($m); ?>

Newsticker:
<? $m="ticker";
include("relativer_pfad_zum_script/newsscript.php");
unset($m); ?>

Kategorien-News:
<? $m="catnews";
include("relativer_pfad_zum_script/newsscript.php");
unset($m); ?>




5. Administrationbereich

    News schreiben:
    Mit diesem Forumlar kann man News verfassen. Ebenfalls ist es möglich Dateien und Bilder hochzuladen um Sie in die News einzubinden. Sie können als Admin auch das Formular selber zusammenstellen damit bei einer seriösen Seite, Leute die ebenfalls News verfassen können, z.B. die Smilieauswahl erst gar nicht zu Gesicht bekommen oder keine Links an den Beitrag anhängen können, etc...

    News editieren:
    Hier sehen Sie standartmäßig die letzten 10 News aufgelistet die Sie editieren können. Natürlich können Sie die Zahl der gelisteten News auch selber bestimmen. Ebenfalls ist es möglich nach einer bestimmen News zu suchen falls durch das Alter der News zu lange danach per Hand gesucht werden müsste. Die sogenannten Ankündigungs News werden getrennt gelistet. Das edtieren und löschen der News erfolgt aber genau gleich wie bei den Normalen. Durch einen Doppelklick auf die News öffnet sich ein Popup mit dem Inhalt dieser welcher komplett editiert werden kann.

    News freischalten:
    Hier können Sie News freischalten die Sie noch nicht gleich veröffentlichen wollten. Ebenfalls kann man hier die News auch editieren und löschen.

    Benutzerverwaltung:
    Sollten Sie nicht alleiniger Newsposter sein können Sie auch mehrere Benutzer anlegen mit einem individuellen Loginnamen und Passwort. Ebenfalls können Sie eingetragene Benutzer auch editieren und wieder löschen. Soll ein neuer Benutzer nicht an die Einstellungen ihres Newssystems gelangen können, können Sie ihm verschiedene Rechte geben die seine Befugnisse einschränken.
    Bei vielen Benutzern mit gleichen Rechten kann es schonmal nerven wenn man für jeden einzeln die Haken setzen muss. Daher ist auch ein Gruppensystem implementiert mit dem man den Benutzern Gruppen zuordnen kann.

    News freischalten:
    Hier können Sie News freischalten die Sie noch nicht gleich veröffentlichen wollten. Ebenfalls kann man hier die News auch editieren und löschen.

    Protokoll:
    Alle getätigten Aktionen können hier eingesehen werden.

    Messenger:
    Hier kann an eingetragene Benutzer Nachrichten verschickt und empfangen werden. Entweder direkt als Mail oder als 'Personal Message'.

      Ausgabe Optionen:

    • Allgemein
      In dem Bereich können Sie z.B. bestimmte Sachen bei der Ausgabe einfach ausblenden lassen oder Sachen wie eine Umsetzung von HTML Code festlegen und mehr.

    • Ausgabearten

      • Baukasten System
        Sollte ihnen das standartmäßig Layout nicht in ihr Seitendesign passen können Sie dieses vollkommen ändern. Anfangen von Einstellungen der Schriftgrößen über Textfarben und Hintergrundfarben bis hin zu einer kompletten Umforumung der Tabellen für die Ausgabe.

      • Templates
        Mit dem Template System hat man mehr Freiheiten als mit dem Baukastensystem. Man kann Platzhalter platzieren die dann automatisch die richtig Funktion erfüllen und man kann dann frei drum herum das Layout machen. Hierbei gilt der normale HTML Standart.

      • Newsticker
        Brauchen Sie nur einen kleinen Ticker mit den News auf Ihrer Seite ist dies hiermit auch möglich. Von der Laufgeschwindigkeit bis hin zu den Farben ist hier alles einstellbar.

      • RSS Feed
        Optional können Sie ihren Besuchern auch einen RSS News Feed zur Verfügung stellen. Es besteht auch die Möglichkeit die News per KlipFolio oder Atom zur Verfügung zu stellen.

      • WAP
        Ihre Besucher können sich auch auf einer WAP Seite die aktuellen News holen. Hier kann man die Einstellungen dazu treffen.




      Admin Bereich Optionen:

    • Newsformular
      Hier können Sie Einstellungen am Formular vornehmen, dass zum Schreiben der News dient. Man kann z.B. bestimmte Felder einfach ausblenden, zusätzliche Related Link Felder hinzufügen, Kategorien samt Kategoriebilder hinzufügen und vieles mehr.

    • Upload / Dateien
      Da Sie auch Dateien und Bilder mit hochladen können, können Sie in diesem Bereich die Dateien verwalten. Zum einem kann hier festgelegt werden welche Dateitypen und Dateigrößen erlaubt sein sollen zum anderen steht einem auch ein Dateibrowser zur Verfügung mit dem man einfach und schnell seine hochgeladenen Dateien löschen, umbennen, verschienen und ansehen kann.

    • Wortengine
      Hier können Sie bestimmte Wörter die Sie nicht in Ihren News wünschen angeben. Man wird nach dem Posten aufgefordert entsprechende Wörter zu entfernen falls diese vorkamen. Außerdem lassen sich hier 'Keywords' einstellen, die bei Vorkommen mit einem Link belegt werden.

    • Mail/SMS
      Durch diese Funktion ist es möglich, dass angemeldete Benutzer per SMS oder Mail direkt News zukommen lassen können und diese entweder direkt veröffentlicht werden, oder in den Freischaltungsmodus kommen.
      Falls Sie nicht wissen wie man mit den verschiedenen Netzbetreibern die "SMS to Mail" Funktion nutzt, an dieser Stelle eine kleine Hilfestellung:

      SMS-Nachricht in folgendem Format schreiben:
      name@anbieter.de <Leerzeichen> Die Nachricht
      (Anmerkung: Bei manchen Handys können @ und _ nicht eingetippt werden, daher statt @ ein * und ein -- statt einem _)

      Dann die SMS je nach Netztbetreiber an folgende Nummer schicken (für Deutschland):
      D1: 8000
      D2: 3400
      E-Plus: 7676245
      O2: 6245

      Es ist vorteilhaft einen extra Mailaccount für diese Funktion einzurichten, da sonst durch Outlook oder andere Mailprogramme die News vor dem Eintragen in das Newssystem abgeholt werden. Die Mails selber werden vom Newssystem aller 10 Minuten geprüft um eine Belastung zu vermeiden bei häufigen Zugriff auf Ihr Newssystem, daher nicht wundern wenn nicht sofort die News erscheint.


6. Changelog

## Version 1.1.8 ##
* Wichtiges Sicherheitsupdate, welches eine Lücke beim Loginprozess schließt

=================================================================================================
Files:
========

Changed Files:
	inc/user_login.php
	inc/user_check.php

-------------------------------------------------------------------------------------------------
## Version 1.1.7 ##
+ Direkt einen Newseintrag bei Twitter oder Facebook veröffentlichen
+ Neue Icons unter dem Newseintrag für Kommentare, Drucken und E-Mail
+ FCKEditor durch neuen CKEditor ersetzt (erweiterte Kompatibilität)
+ Neues Lizenzmodell implementiert (direkte Copyright-Freischaltung im Script)
* RSS Kompatibilität erweitert
* PHP5 Kompatibilität verbessert
* Standardmäßig HTML Code im Newsformular und Ausgabe aktiviert

=================================================================================================
Files:
========

Changed Files:
	admin.php
	newsscript.php
	newsscript_lyt.php
	newsscript_tpl.php
	newsscript_ticker.php
	path.php
	
	inc/admin_set_output_template_e.php
	inc/admin_set_output_allg.php
	inc/admin_licence.php
	inc/admin_newsedit_edit.php
	inc/admin_newsadd.php
	inc/output/news_symbols.php
	inc/output/news_style_1.1.php
	inc/output/news_style_1.2.php
	inc/output/news_style_1.3.php
	inc/output/news_style_1.4.php
	inc/output/news_style_2.5.php
	inc/output/news_style_2.6.php
	inc/output/news_style_2.7.php
	inc/output/news_style_2.8.php
	inc/js/popups.js
	
	newsreader/newsscript_rss.php
	
	newsticker/newsscript_get.php
	
	templates/newswhile.php
	templates/styles/newsolved/images/icon_comment.png
	templates/styles/newsolved/images/icon_email.png
	templates/styles/newsolved/images/icon_print.png
	
	images/output/icon_comment.png
	images/output/icon_email.png
	images/output/icon_print.png

	
Added Files:
	images/licence_error.png
	images/licence_correct.png
	images/bottombar_licence.png
	images/bottombar_deinstall.gif
	images/bottombar_logout.png
	images/bottombar_changelogin.png
	images/output/icon_facebook.png
	images/output/icon_twitter.png

	templates/styles/newsolved/images/icon_facebook.png
	templates/styles/newsolved/images/icon_twitter.png
	
	inc/admin_checksum_check.php
	inc/admin_checksum.php
	inc/json_encode.php
	inc/js/jquery.functions.js
	inc/js/jquery.min.js
	inc/ckeditor
	
	
Database:
=========
Added:
    Table _settings:
	show_att_facebook int(1) NOT NULL
	show_att_twitter int(1) NOT NULL
	
Updates:
    UPDATE {$prefix}_settings (show_html) VALUES ('1')
	UPDATE {$prefix}_settings (admin_write_html) VALUES ('1')
	
Created:
	 Table _info
	 
-------------------------------------------------------------------------------------------------
## Version 1.1.6 ##
+ Zusammenführung von Lite und Professional Version zu NEWSolved

-------------------------------------------------------------------------------------------------
## Version 1.1.5 ##
+ Captcha Spamschutz hinzugefügt (verwendet wird Captcha X unter GPL)

-------------------------------------------------------------------------------------------------
## Version 1.1.4 ##
* RTE Editor durch FCKEditor ausgetauscht

-------------------------------------------------------------------------------------------------
## Version 1.1.3a ##
* Freischalt Datums Bug gefixt

-------------------------------------------------------------------------------------------------
## Version 1.1.3 ##
+ WYSIWYG Editor hinzugefügt (Cross-Browser Rich Text Editor (www.kevinroth.com))
+ Leichte Designänderungen im News-Verfassen-Formular

-------------------------------------------------------------------------------------------------
## Version 1.1.2 ##
* Remote File Inclusion Fix
+ Simpler Spamschutz für Kommentare aktivierbar

-------------------------------------------------------------------------------------------------
## Version 1.1.1 ##
+ BBCode Toolbar auch beim Editieren sichtbar
* Eingestellte Linkfarbe wird nun bei allen Links in der News umgesetzt
* Es können nicht mehr 2 Kategorien mit dem selben Namen hinzugefügt werden
* HTML Codes werde beim News-Versand rausgestrichen

-------------------------------------------------------------------------------------------------
## Version 1.1 ##
+ Angehängte Linkklicks werden gezählt
+ Optional Anzeige einschaltbar wann die News zuletzt editiert wurde
+ Einleitungstext definierbar
+ Druckausgabe etwas abgeändert
+ Standard Topic und Nachricht festlegen
* Tabellenfehler gefixt welcher entstand wenn man BBCode Tabellen + Abgeschnittene News hat
* Schriftgröße bei Schrift innerhalb BBCode Tabellen gefixt

-------------------------------------------------------------------------------------------------
## Version 1.0 ##
- phpBB Unterstützung
- Alternatives Admin Layout
- Anzeige der Ausgabeeinstellungen beim Edit
- WAP wurde nicht aktualisiert bei Queued News, gefixt
- Angeklickte News werden gezählt
- Text umfließt Kategoriebild und ist nicht mehr seperat
- Kategoriebild kann auch im Topic angezeigt werden
- Höhe der oberen und unteren Box bestimmmen
- Schattenkategorien
- News einschicken Funktion: News direkt in die DB und im Admin Menü freischaltbar
- Vor den freizuschaltenden News diverse Icons um zu sehen auf welche Art eingesandt
- Auch wenn mehr Latest News als normale Ausgabe, richtiger Link zur Seite 2
- Bei Vorschau wurden die Links gelöscht und gewählte Kategorie nicht gemerkt
- Template Ex- und Import
- SQL Klasse
- Dritte Linköffnungsart wählbar: Popup
- Marquee Ticker
- Falscher Link bei RSS Feed Kommentar gefixt
- Neues Newsreaderformat: Atom Reader
- Standard Templatelayout ähnelt dem des Baukastensystems
- Neuer Datenbanktyp: SQLight
- Neuer Datenbanktyp: MySQLi
- Flash BBCode
- Archiv seperat anzeigbar
- Kategorien inkl. News seperat anzeigbar
- Seperate Latest News gefixt, da noch auf dem alten Linksystem
- Falsche Links beim Archiv gefixt
- Überprüfung auf Richtigkeit des generierten Pfades bei der Installation
- Flashgröße des seperaten Tickers gefixt
- News in eine andere Kategorie verschieben
- Unterstützung für BB Code Tabellen
- Newsticker stopt wenn man darüberfährt
- Bis zu 3 Standardthumbnailgrößen zur Auswahl
- Einstellbar ob nach Beiden Seiten, nur Höhe oder nur Länge resized werden soll
- Beim Editieren der News direkt im Fenster zur nächsten/vorherigen News schalten
- Sprachsupport - Man kann News nun in mehreren Sprachen verfassen
- Optional Datum bei latest News rausstreichen
- Kurzansicht der Suchergebnisse - Per Liste die News auszuwählen
- Datenbank import/export Funktion
- Interner Messenger - Man kann den angemeldeten Benutzern Nachrichten zukommen lassen
- Beim editieren der News steht eine "Search and Replace" Funktion zur Verfügung
- RSS Feed System aktualisisert - Auf dem Stand der neusten Version, d.h. es können HTML Codes und BBCodes interpretiert werden
- BBCodes per Eingabemaske - Nach dem Klick auf den gewünschen BBCode, kann man den zu formatierenden Text direkt in ein JavaScript Fenster eingeben
- BBCode und HTML Code wird beim Abschneiden der News nach XXX Zeichen nicht mehr mitgezählt
- Erfolgsbildschirm nach Newspost geändert
- Bug gefixt, dass keine related Links beim Template System angezeigt wurden
- Beim Schreiben der News, kann nun direkt für jeden Link eine Beschreibung gewählt werden und es steht einem zur Wahl den Link im neuen oder selben Fenster zu öffnen
- Sollte beim hochladen einer Datei diese schon vorhanden sein, wird man nun gefragt ob man diese überschreiben will
- Ankündigungen können optional ein Ablaufdatum erhalten
- Latest News nach Tagen zusammenfassend ausgeben
- Gesamtes Layout des Admin Bereichs geändert
- Bewerten von News - News mit besten Bewertungen ausgeben lassen
- Thumbnails für Bilder - Thumbnailgröße optional einstellbar
- KlipFolio Unterstützung
- WAP Newsseite
- Template System: Seitenzahlen und Kategorien verfügbar
	





7. Sonstiges

Fremde Software die unter LGPL in diesem Script verwendet wird:
- CKeditor (Homepage) - Captcha X (Ondrej Maly)

Bei Fragen oder Verbesserungsvorschlägen können Sie uns unter info@usolved.net oder www.usolved.net erreichen.