-
Notifications
You must be signed in to change notification settings - Fork 0
/
Readme.htm
229 lines (212 loc) · 20.1 KB
/
Readme.htm
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="de" xml:lang="de">
<head>
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
<meta http-equiv="Content-Language" content="de" />
<meta http-equiv="Content-Script-Type" content="text/javascript" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="author" content="Chrissyx" />
<meta name="copyright" content="Chrissyx" />
<meta name="description" content="Readme for the news script from CHS" />
<meta name="generator" content="Notepad 4.10.1998" />
<meta name="keywords" content="Newsscript, CHS, readme, liesmich, Chrissyx" />
<meta name="revisit-after" content="14 days" />
<meta name="robots" content="all" />
<link href="newsscript/style.css" media="all" rel="stylesheet" />
<title>CHS - Newsscript: Readme</title>
</head>
<body>
<h1>Chrissyx Homepage Scripts - Newsscript</h1>
<h2>Version: 1.0.7.2</h2>
<h3><a href="#ENGLISH">ENGLISH - CLICK HERE!</a></h3>
<h4>Inhalt</h4>
<ul>
<li><a href="#de_intro">Vorwort</a></li>
<li><a href="#de_reqs">Vorraussetzungen</a></li>
<li><a href="#de_install">Installation</a></li>
<li><a href="#de_update">Update auf neue Version</a></li>
<li><a href="#de_faq">FAQ</a></li>
<li><a href="#de_bbcode">BBCode Referenz</a></li>
<li><a href="#de_credits">Credits</a></li>
</ul><br />
<h4 id="de_intro">Vorwort</h4>
<p>Datei-basiertes, schnelles, mehrsprachiges Newsscript mit BBCode, Smilies, Kommentarfunktion, Newsticker und eigener Adminoberfläche inkl. Nutzer-, Kategorien-, Smilieverwaltung und kleiner Statistik. Weitere Features für "Weiterlesen", Quellenangaben und ein Newsticker für RSS Newsfeeds, interne Anzeige und externe Einbindung auf anderen Webseiten. Alles stark einstellbar, von der Anzahl der gezeigten News pro Seite, über Anzahl der Smilies (auch pro Reihe) bis hin zu den Speicherorten der internen Systemdateien. Einfache Installation mit interaktiver Hilfe, inkl. Übersetzungen für Deutsch und Englisch. Durchgehend valides XHTML und dank Cache-Funktionen sehr schnell. Benötigt PHP ab V5.3 und KEINE Datenbank.</p><br />
<h4 id="de_reqs">Vorraussetzungen</h4>
<ul>
<li>PHP ab 5.3</li>
<li>chmod fähiger Webspace</li>
</ul><br />
<h4 id="de_install">Installation</h4>
<p>Die Installation ist gewohnt einfach: Lade in dem Ordner, wo deine Webseite ist (auf welcher das Newsscript zum Einsatz kommen soll), die "news.php" und den Ordner "newsscript" samt Inhalt hoch. Rufe danach die "index.php" aus dem Ordner "newsscript" auf und folge dann den Anweisungen. Wenn Du auch den Newsticker nutzen möchtest, lade die "newsticker.php" dahin hoch, wo die "news.php" schon ist.</p><br />
<h4 id="de_update">Update auf neue Version</h4>
<p>Lade, wie schon zur Installation auch, alle Dateien hoch und ersetze so jede Datei durch ihre neue Version. Rufe danach die "update.php" aus dem Ordner "newsscript" auf und folge den Anweisungen.<br />
<span style="color:#FF0000;">WICHTIG:</span> Nach dem Update die "update.php" wieder löschen!</p><br />
<h4 id="de_faq">FAQ</h4>
<ul>
<li style="margin-bottom:10px;">Wie kann ich mein Newsscript verwalten?<br />
Rufe, wie schon bei der Installation auch, die "index.php" im "newsscript"-Ordner auf und folge den Anweisungen.</li>
<li style="margin-bottom:10px;">Ich habe mein Passwort vergessen!<br />
Begib dich ganz normal zum Login, dort kannst Du dir auch ein neues Passwort zu schicken lassen. Das alte bleibt weiterhin gültig, bis Du dich mit dem neuen eingeloggt hast.</li>
<li style="margin-bottom:10px;">Wie funktioniert das mit den Quellen?<br />
Gib den Link zur Seite ein und füge ihn hinzu, danach ist er gespeichert und wird nicht mehr im Feld angezeigt. Genau so kannst Du die jeweils letzte Quelle wieder löschen mit dem Link daneben. Klicke auf "Vorschau", um alle vorhandenen Quellen einzusehen, und dann auf das Dropdown-Menü mit dem Pfeil.</li>
<li style="margin-bottom:10px;">Kann ich das Newsscript auch in andere Sprachen übersetzen?<br />
Aber sicher: Kopiere dir eine INI Datei und benenne sie in das offizielle Sprachkürzel der jeweiligen Sprache um. Z.B. "fr.ini" für Französisch oder "nl.ini" für Niederländisch. Übersetzte dann die Texte in den Anführungszeichen und achte dabei auf die Hinweise am Anfang der Datei. Wenn Du eine vollständige Übersetzung hast, lade sie in den "newsscript"-Ordner und wähle sie im Sprachmenü der Administration aus. Bitte schick sie mir auch, so dass ich anderen diese ebenfalls zur Verfügung stellen kann! :)</li>
<li style="margin-bottom:10px;">Was kann alles der Newsticker?<br />
Er bietet eine Auflistung der letzten X News für deine Seite selbst, eine RSS Newsfeed Anbindung und sogar die Möglichkeit, deine Newstitel auf anderen Webseiten einzubinden. Für die interne Einbindung, füge diesen Code an der gewünschten Stelle in den Quelltext deiner Seite ein:<br />
<code><!-- CHS - Newsscript - Ticker --><?php include('newsticker.php'); ?><!-- /CHS - Newsscript - Ticker --></code><br />
Für die RSS Anbindung solltest Du deinen Besuchern einen Link mit einer passenden Grafik zur Verfügung stellen. Der Link ergibt sich natürlich aus dem Ort, wo Du den Ticker bzw. das Script betreibst. Auf jeden Fall endet er mit "/newsticker.php?type=rss", z.B. "https://www.meineseite.tld/newsticker.php?type=rss". Es bietet sich an, den Link unmittelbar neben der internen Ausgabe des Newstickers zu platzieren.<br />
Die Einbindung der letzten News auf anderen Webseiten erfolgt ähnlich, d.h. anstatt "type=rss" einfach "type=extern" anhängen. Lautet der Link also z.B. "https://www.meineseite.tld/newsticker.php?type=extern", so muss man<br />
<code><script type="text/javascript" src="https://www.meineseite.tld/newsticker.php?type=extern"></script></code><br />
in den Quellcode seiner Seite einbinden für eine Anzeige deiner letzten News. Willst Du diesen Service anbieten, so musst Du den Code auf deiner Seite präsentieren und natürlich den Link wie oben beschrieben vorher anpassen. Die Anzahl der gezeigten News hängt im Wesentlichen von der Einstellung ab, die Du während der Installation triffst. Allerdings kann man im externen Modus und beim RSS Feed diese nochmals individualisieren, d.h. wenn Du z.B. die letzten 5 News bei deinen internen Ticker ausgeben lässt, so werden es auch 5 beim RSS Newsfeed und der externen Ausgabe sein. Um nun eine höhere Anzahl zu ermöglichen, kann man einfach die Anzahl per "&anz=X" angeben, in dem man es an den vorhandenen Link hängt. Z.B. für 10 News im RSS Feed:<br />
https://www.meineseite.tld/newsticker.php?type=rss&anz=10<br />
Oder 7 News bei der externen Einbindung:<br />
<code><script type="text/javascript" src="https://www.meineseite.tld/newsticker.php?type=extern&anz=7"></script></code><br />
Auch das sollte man an geeigneter Stelle den Interessierten mitteilen.</li>
<li style="margin-bottom:10px;">Ich erhalte beim Aufruf die Meldung "ERROR: Datei/Ordner nicht gefunden!"?!?<br />
Lies dir die Installationsanleitung hier genaustens durch! Achte darauf, dass Ordnerpfade immer mit "/" enden.</li>
<li style="margin-bottom:10px;">Ich erhalte beim Aufruf die Meldung "ERROR: Konnte keine Rechte setzen!"?!?<br />
Setze mit deinem FTP Programm per chmod Befehl die Rechte auf "775" für die/den angegebene/n Datei/Ordner.</li>
<li style="margin-bottom:10px;">Es kommt beim Aufruf eine "Warning: session_start(): Cannot send session cache limiter" Warnung?!?<br />
Füge ganz am Anfang deiner Seite (also noch vor "<code><html></code>" bzw. "<code><!DOCTYPE...</code>"), auf welcher Du das Newsscript eingesetzt hast, das ein:<br />
<code><?php session_start(); ?></code></li>
<li style="margin-bottom:10px;">Kann ich das Design vom Newsscript anpassen?<br />
Das Newsscript selber sollte sich schon weitestgehend deinem Seitendesign anpassen. Wenn Du aber weitere Feinheiten an der Darstellung der News vornehmen möchtest, stehen dir seit Version 1.0.1 vordefinierte CSS Klassen zur Verfügung, deren Inhalt Du selber bestimmen kannst:
<ul>
<li>newsscriptmain: Für alle Newseinträge inkl. Einzelansicht</li>
<li>newsscriptfooter: Für die Seitennavigation unter den News</li>
<li>newsscriptcomments: Für den kompletten Kommentarbereich</li>
</ul>
Diese Klassen kannst Du dann bei Bedarf im <code><head>...</head></code> Bereich oder in deiner eigenen CSS Datei einbinden.<br />
Mehr zum Thema CSS findest Du hier: <a href="https://wiki.selfhtml.org/wiki/CSS/Tutorials/Einstieg/Stylesheets_einbinden" target="_blank">https://wiki.selfhtml.org/wiki/CSS/Tutorials/Einstieg/Stylesheets_einbinden</a></li>
<li style="margin-bottom:10px;">Beim Hochladen eines Bilders kommt die Meldung "Fatal error: Call to undefined function imagecreatetruecolor()"?!?<br />
Für das automatische Skalieren eines Kategoriebildes muss die <a href="http://www.libgd.org/" target="_blank">GD Bibliothek</a> als PHP Erweiterung vorhanden sein. Wenn Du keine Möglichkeit hast, diese in der php.ini zu aktivieren, musst Du die Bildgröße vor dem Upload von Hand anpassen.</li>
<li>Meine Frage wurde nicht beantwortet!<br />
Dann besuch mein Forum unter <a href="https://www.chrissyx.com/forum/" target="_blank">https://www.chrissyx.com/forum/</a> oder schreib mir eine E-Mail: <a href="mailto:chris@chrissyx.com">chris@chrissyx.com</a></li>
</ul><br />
<h4 id="de_bbcode">BBCode Referenz</h4>
<ul>
<li>[b]Fetter Text[/b]</li>
<li>[i]Kursiver Text[/i]</li>
<li>[u]Unterstrichender Text[/u]</li>
<li>[s]Durchgestrichender Text[/s]</li>
<li>[center]Zentrierter Absatz[/center]</li>
<li>[quote]Zitat[/quote]</li>
<li>[url]Link[/url]</li>
<li>[url=Link]Verlinkter Text[/url]</li>
<li>[img]Bild[/img]</li>
<li>[img=Bild]Beschreibung[/img]</li>
<li>[email]Verlinkte E-Mail Adresse[/email]</li>
<li>[email=E-Mail Adresse]Verlinkter Text[/email]</li>
<li>[color=Farbe]Farbiger Text[/color]</li>
<li>[iframe]iFrame mit 560x315 YouTube Größe[/iframe]</li>
<li>[iframe=Breite,Höhe]iFrame mit vorgegebener Breite und Höhe[/iframe]</li>
<li>[code]Quellcode[/code]</li>
<li>[size=Größe]Um Größe skalierter Text[/size]</li>
<li>[sup]Hochgestellter Text[/sup]</li>
<li>[sub]Tiefgestellter Text[/sub]</li>
<li>[list][*]Listeneintrag[/list]</li>
</ul><br />
<h4 id="de_credits">Credits</h4>
<p>© 2008–2023 by Chrissyx<br />
Powered by V4 Technology<br />
<a href="https://www.chrissyx.de/" target="_blank">https://www.chrissyx.de/</a><br />
<a href="https://www.chrissyx.com/" target="_blank">https://www.chrissyx.com/</a></p>
<hr id="ENGLISH"/>
<h4>Content</h4>
<ul>
<li><a href="#en_intro">Introduction</a></li>
<li><a href="#en_reqs">Requirements</a></li>
<li><a href="#en_install">Installation</a></li>
<li><a href="#en_update">Update to new version</a></li>
<li><a href="#en_faq">FAQ</a></li>
<li><a href="#en_bbcode">BBCode reference</a></li>
<li><a href="#en_credits">Credits</a></li>
</ul><br />
<h4 id="en_intro">Introduction</h4>
<p>File-based, fast, multilingual newsscript with BBCode, smilies, commenting, newsticker and dedicated admin panel incl. user, category, smiley administration and small statistic. Additional features are "Read on", list of references and newsticker supporting RSS feeds, internal listing and external embedding on other websites. Everything is configurable, starting with number of news per page, number of smilies (even for each row!) up to storage locations for the internal system files. Simple and easy installation with interactive help incl. translations for German and English. Continuous valid XHTML and due to caching really fast. Requires PHP 5.3 or higher and NO database.</p><br />
<h4 id="en_reqs">Requirements</h4>
<ul>
<li>PHP 5.3 or higher</li>
<li>chmod-able webspace</li>
</ul><br />
<h4 id="en_install">Installation</h4>
<p>The installation is simple as usual: Upload in that directory, in which your website is (and you're planning to use the Newsscript), the "news.php" file and the folder "newsscript" including its contents. Point your browser to the "index.php" in the "newsscript" folder and follow the instructions. If you would like to use the news ticker as well, upload the "newsticker.php" to the same location you've uploaded the "news.php" before.</p><br />
<h4 id="en_update">Update to new version</h4>
<p>Upload, just like the installation, all files by replacing every file with its newer version. Point your browser to the "update.php" in the "newsscript" folder and follow the instructions.<br />
<span style="color:#FF0000;">IMPORTANT:</span> Delete the "update.php" after updating the script!</p><br />
<h4 id="en_faq">FAQ</h4>
<ul>
<li style="margin-bottom:10px;">How to manage my news script?<br />
Just point your browser to the "index.php" file in the "newsscript" folder, as you did during the installation and follow the instructions.</li>
<li style="margin-bottom:10px;">I've forgot my password!<br />
Go to the login form, you can request a new password there. The old one is still valid until you log in with the new password.</li>
<li style="margin-bottom:10px;">How are these sources working?<br />
Type in the link and add it. It's now saved and will disappear from the field. On the same way, you can remove the last added source with the link next to it. Click on "Preview" and then on the dropdown list with the arrow to check all available sources.</li>
<li style="margin-bottom:10px;">Is it possible to translate the news script to another language?<br />
Of course, copy an INI file and name it to the official language code corresponding to the desired language. E.g. "fr.ini" for French or "nl.ini" for Dutch. Start translating the strings between the quotation marks and check the hints at the beginning of the file. By having a complete translation, upload it to the "newsscript" folder and choose it from the language menu in the administration. Also please send it to me for providing it for other user! :)</li>
<li style="margin-bottom:10px;">What about the news ticker?<br />
Just a quick overview for now: Use this code for internal listing of headlines on your homepage:<br />
<code><!-- CHS - Newsscript - Ticker --><?php include('newsticker.php'); ?><!-- /CHS - Newsscript - Ticker --></code><br />
This example link will provide a RSS Newsfeed:<br />
https://www.mysite.tld/newsticker.php?type=rss<br />
This example code will provide the latest headlines for an external website:<br />
<code><script type="text/javascript" src="https://www.mysite.tld/newsticker.php?type=extern"></script></code><br />
To change the number of displayed news apart from the setting you've entered during installation, add "&anz=X" to each link, e.g. 10 entries for the RSS Feed:<br />
https://www.mysite.tld/newsticker.php?type=rss&anz=10<br />
Or last 7 headlines for another website displaying your news:<br />
<code><script type="text/javascript" src="https://www.mysite.tld/newsticker.php?type=extern&anz=7"></script></code><br />
You should provide your visitors these informations somewhere, thought.<br />
Hope you got a clue about the features anyway. ;)</li>
<li style="margin-bottom:10px;">I'm getting a message like "ERROR: Datei/Ordner nicht gefunden!"?!?<br />
Read again the install instructions carefully! Keep in mind, that folderpaths always have to end with "/".</li>
<li style="margin-bottom:10px;">I'm getting a message like "ERROR: Konnte keine Rechte setzen!"?!?<br />
Set with your FTP program and chmod command the rights to "775" for the mentioned file/folder.</li>
<li style="margin-bottom:10px;">I'm getting a "Warning: session_start(): Cannot send session cache limiter" warning?!?<br />
Paste at the very beginning of your homepage (even before "<code><html></code>" or "<code><!DOCTYPE...</code>"), on which you're running the news script, this code:<br />
<code><?php session_start(); ?></code></li>
<li style="margin-bottom:10px;">Is it possible to change the design of the news script?<br />
The news script itself should already fit as far as possible to your own page design. If you would like to adjust more details of the news layout, you can use and fill out some predefined CSS classes, available since version 1.0.1:
<ul>
<li>newsscriptmain: For all news entries incl. single news viewing</li>
<li>newsscriptfooter: For the page navigation under the news listing</li>
<li>newsscriptcomments: For the whole comments area</li>
</ul>
You can define those classes in the <code><head>...</head></code> section or include them in your own CSS file.<br />
For more information about CSS, see here: <a href="https://en.wikibooks.org/wiki/Cascading_Style_Sheets" target="_blank">https://en.wikibooks.org/wiki/Cascading_Style_Sheets</a></li>
<li style="margin-bottom:10px;">I'm getting a message "Fatal error: Call to undefined function imagecreatetruecolor()" while uploading a pic?!?<br />
Automatic scaling of a category image needs the <a href="http://www.libgd.org/" target="_blank">GD library</a> loaded as PHP extension. If you don't have any access to the php.ini file to activate it, you have to adjust the image size manually before uploading.</li>
<li style="margin-bottom:10px;">My question isn't answered here!<br />
Sorry, no more FAQ entries for now. Please visit my board at <a href="https://www.chrissyx.com/forum/" target="_blank">https://www.chrissyx.com/forum/</a> for more help.<br />
Or write me an email: <a href="mailto:chris@chrissyx.com">chris@chrissyx.com</a></li>
</ul><br />
<h4 id="en_bbcode">BBCode reference</h4>
<ul>
<li>[b]Bolded text[/b]</li>
<li>[i]Italicized text[/i]</li>
<li>[u]Underlined text[/u]</li>
<li>[s]Strikethrough text[/s]</li>
<li>[center]Centered paragraph[/center]</li>
<li>[quote]Quotation[/quote]</li>
<li>[url]Link[/url]</li>
<li>[url=Link]Linked text[/url]</li>
<li>[img]Image[/img]</li>
<li>[img=Image]Description[/img]</li>
<li>[email]Linked email address[/email]</li>
<li>[email=Email address]Linked text[/email]</li>
<li>[color=Color]Colored text[/color]</li>
<li>[iframe]iFrame with 560x315 YouTube size[/iframe]</li>
<li>[iframe=Width,Height]iFrame with given width and height[/iframe]</li>
<li>[code]Source code[/code]</li>
<li>[size=Size]With size scaled text[/size]</li>
<li>[sup]Superscript text[/sup]</li>
<li>[sub]Subscript text[/sub]</li>
<li>[list][*]List entry[/list]</li>
</ul><br />
<h4 id="en_credits">Credits</h4>
<p>© 2008–2023 by Chrissyx<br />
Powered by V4 Technology<br />
<a href="https://www.chrissyx.de/" target="_blank">https://www.chrissyx.de/</a><br />
<a href="https://www.chrissyx.com/" target="_blank">https://www.chrissyx.com/</a></p>
</body>
</html>