/
readme.html
492 lines (431 loc) · 30.6 KB
/
readme.html
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
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
<!DOCTYPE HTML>
<html lang="de-de" dir="ltr">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<head>
<title>Readme</title>
<style type="text/css">
body {
font-family:"Open Sans",Arial,sans-serif;
font-size:0.8em;
}
h1 { font-size:1.8em; }
/*
https://www.mediaevent.de/tutorial/css-tabs.html
Tabs mit radio-Buttons */
.tabbed figure {
display: block;
margin-left: 0;
border-bottom: 1px solid silver;
clear: both;
}
.tabbed > input,
.tabbed figure > div { display: none; }
.tabbed figure>div {
padding: 20px;
width: 100%;
border: 1px solid silver;
background: #fff;
line-height: 1.5em;
letter-spacing: 0.3px;
color: #444;
}
#tab1:checked ~ figure .tab1,
#tab2:checked ~ figure .tab2,
#tab3:checked ~ figure .tab3,
#tab4:checked ~ figure .tab4,
#tab5:checked ~ figure .tab5 { display: block; }
nav label {
float: left;
padding: 15px 15px;
border-top: 1px solid silver;
border-right: 1px solid silver;
background: hsl(210,50%,50%);
color: #eee;
}
nav label:nth-child(1) { border-left: 1px solid silver; }
nav label:hover { background: hsl(210,50%,40%); }
nav label:active { background: #ffffff; }
#tab1:checked ~ nav label[for="tab1"],
#tab2:checked ~ nav label[for="tab2"],
#tab3:checked ~ nav label[for="tab3"],
#tab4:checked ~ nav label[for="tab4"],
#tab5:checked ~ nav label[for="tab5"] {
background: white;
color: #111;
position: relative;
border-bottom: none;
}
#tab1:checked ~ nav label[for="tab1"]:after,
#tab2:checked ~ nav label[for="tab2"]:after,
#tab3:checked ~ nav label[for="tab3"]:after,
#tab4:checked ~ nav label[for="tab4"]:after,
#tab5:checked ~ nav label[for="tab5"]:after {
content: "";
display: block;
position: absolute;
height: 2px;
width: 100%;
background: white;
left: 0;
bottom: -1px;
}
</style>
</head>
<body>
<div class="tabbed">
<input checked="checked" id="tab1" type="radio" name="tabs" />
<input id="tab2" type="radio" name="tabs" />
<nav>
<label for="tab1">DE</label>
<label for="tab2">EN</label>
</nav>
<figure>
<div class="tab1">
<h1>News with Images</h1>
<h2>Inhalt</h2>
<ul>
<li><a href="#d1">Allgemein</a></li>
<li><a href="#d2">Download</a></li>
<li><a href="#d3">Lizenz</a></li>
<li><a href="#d4">Systemvoraussetzungen</a></li>
<li><a href="#d5">Installation/Update</a></li>
<li><a href="#d6">Beiträge erstellen/bearbeiten</a></li>
<li><a href="#d7">Einstellungen</a></li>
</ul>
<h2 id="d1">Allgemein</h2>
<p>News with images (kurz: NWI) ermöglicht das Erstellen von News-Seiten bzw. -Beiträgen und bietet u.a. folgende Funktionen:</p>
<ul>
<li>Beitragsbild</li>
<li>integrierte Bildergalerie (Masonry oder Fotorama)</li>
<li>optionaler 2. Inhaltsbereich</li>
<li>Sortieren von Beiträgen mit Drag & Drop</li>
<li>Verschieben/Kopieren von Beiträgen zwischen Gruppen und Abschnitten</li>
<li>Import von Beiträgen und Einstellungen aus dem Modul "Topics" sowie "News" ("klassisches Newsmodul" bis Version 3.5.12)</li>
<li>Bereitstellung der News als RSS-Feed: https://www.deinedomain.tld/modules/news_img/rss.php?section_id=XX&page_id=YY<br/>
(deinedomain.tld, XX und YY durch die tatsächlichen Werte ersetzen)</li>
</ul>
<h2 id="d2">Download</h2>
<p>Das Modul ist ab WBCE CMS 1.4 ein Coremodul und standardmäßig installiert. Darüber hinaus ist der Download im <a href="https://addons.wbce.org">WBCE CMS Add-On Repository</a> verfügbar.</p>
<h2 id="d3">Lizenz</h2>
<p>NWI steht unter der <a href="http://www.gnu.org/licenses/gpl-3.0.html">GNU General Public License (GPL) v3.0</a>.</p>
<h2 id="d4">Systemvoraussetzungen</h2>
<p>NWI hat keine besonderen Systemvoraussetzungen. Wenn WBCE CMS funktioniert, sollte auch NWI laufen. </p>
<h2 id="d5">Installation/Update</h2>
<ol>
<li>Sofern erforderlich, aktuelle Version aus dem <a href="https://addons.wbce.org">AOR</a> herunterladen</li>
<li>Wie jedes andere WBCE-Modul auch über Erweiterungen > Module installieren bzw. aktualisieren </li>
</ol>
<h2 id="d6">Beiträge erstellen und bearbeiten</h2>
<h3 id="d61">Loslegen und Schreiben</h3>
<ol>
<li>Ggfs. eine neue Seite mit "News with Images" anlegen</li>
<li>Um einen neuen Beitrag zu erstellen, auf die Schaltfläche "Beitrag verfassen" klicken. Zum Bearbeiten des Inhalts eines vorhandenen Beitrags auf dessen Titel klicken.</li>
<li>Überschrift und ggf. weitere Felder ausfüllen, ggf. Bilder auswählen. Die Funktion der Eingabefelder ist wohl selbsterklärend.</li>
<li>Auf "Speichern" oder "Speichern und zurück" klicken</li>
<li>Schritte 2. - 4. ein paar Mal wiederholen und sich das ganze im Frontend anschauen</li>
</ol>
<p>Grundsätzlich kann NWI mit anderen Modulen auf einer Seite bzw. in einem Block kombiniert werden, es kann dann aber wie bei jedem Modul, das eigene Detailseiten generiert, zu Ergebnissen kommen, die nicht dem Erwarteten/Erwünschten entsprechen.</p>
<p>Es wird dringend empfohlen, nicht mehrere NWI-Abschnitte auf derselben Seite (Page) zu verwenden.</p>
<h3 id="d62">Bilder im Beitrag</h3>
<p>Für jeden Beitrag kann ein Beitragsbild hinterlegt werden, das auf der Übersichtsseite und ggfs. der Beitragsseite angezeigt wird. Darüber hinaus ist es möglich, beliebig viele Bilder zu einem Beitrag zu hinterlegen, die als Bildergalerie angezeigt werden. Die Galeriedarstellung erfolgt entweder als Fotorama-Galerie (Thumbnails, Bild über die gesamte Breite) oder als Masonry-Galerie (Bildermosaik). </p>
<p>Welches Galeriescript verwendet wird, wird für alle Beiträge in den Einstellungen des jeweiligen Abschnitts festgelegt.</p>
<p>Die Galeriebilder werden hochgeladen, sobald der Beitrag gespeichert wird, und können dann mit Bildunterschriften versehen, per Drag&Drop umsortiert oder auch wieder gelöscht werden.</p>
<p>Beim Upload von Dateien mit gleichen Namen wie bereits vorhandenen Bildern werden die vorhandenen Dateien nicht überschrieben, sondern bei den nachfolgenden Dateien wird eine fortlaufende Nummerierung ergänzt (bild.jpg, bild_1.jpg usw.)</p>
<p>Die Verwaltung der Bilder erfolgt nur über den Beitrag, nicht über die WBCE-Medienverwaltung, da NWI sonst nicht "weiß", wo welche Bilder hingehören/fehlen usw.</p>
<p>Das Beitragsbild liegt nur in der Größe vor, die bei den Moduleinstellungen hinterlegt wurde. Werden unterschiedlich große Darstellungen gewünscht, so ist die Maximalgröße bei den Einstellungen zu hinterlegen und die kleinere Darstellung über CSS-Formatierung zu realisieren.</p>
<h3 id="d63">Gruppen</h3>
<p>Beiträge können Gruppen zugeordnet werden. Dies ermöglicht, themenspezifische Übersichtsseiten zu generieren. Diese können dann über die URL der NWI-Seite mit dem Parameter g?=GROUP_ID, also z.B. news.php?g=2 angesteuert werden.</p>
<p>Ein Beitrag kann immer nur einer Gruppe zugeordnet sein.</p>
<p>Einzelne oder mehrere Beiträge können von einer Gruppe in eine andere kopiert und verschoben werden.</p>
<h3 id="d64">Stichworte</h3>
<p>Diese Funktion steht nur zur Verfügung, wenn bei den Einstellungen der "Expertenmodus" aktiviert wurde und Stichworte angelegt wurden.</p>
<p>Beiträge können einem oder mehreren Stichworten zugeordnet werden. Diese Stichworte werden dann je nach Konfiguration im Frontend auf der Beitragsübersicht und/oder der Detailansicht angezeigt und sind jeweils mit der Übersicht aller Beiträge zu diesem Stichwort verlinkt.</p>
<p>Stichworte aus der Beitragsübersicht heraus zentral für alle Beiträge im Abschnitt zur Verfügung gestellt (Reiter "Stichworte") und können dann in der Beitrags-Detailansicht ausgewählt werden.</p>
<p>Globale Stichworte stehen in allen NWI-Abschnitten zur Verfügung, also auch auf anderen Seiten des Auftritts.</p>
<p>Nach dem Anlegen können Stichworte bearbeitet/geändert werden, ebenso ist es möglich, diesen eigene Farben zuzuweisen.</p>
<h3 id="d65">2. Block</h3>
<p>Diese Funktion steht nur zur Verfügung, wenn bei den Einstellungen der "Expertenmodus" aktiviert wurde und die Verwendung des 2. Blocks aktiviert ist.</p>
<p>Sofern vom Template unterstützt, können Inhalte in einem zweiten Block (z.B. einer Randspalte) dargestellt werden. Dabei kann es sich entweder um bei den Einstellungen hinterlegte, wiederkehrende Inhalte handeln, beitragsspezifische Inhalte (Beitragsbild, Anreißertext o.ä.) oder direkt im Beitrag hinterlegte Texte, die im Eingabefeld für den 2. Block eingetragen wurden.</p>
<p>Achtung: wird der zweite Block deaktiviert, oder vom Experten- in den Standardmodus gewechselt, gehen die Einstellungen für diesen Block verloren.</p>
<h3 id="d66">Importfunktion</h3>
<p>So lange noch kein Beitrag im jeweiligen NWI-Abschnitt erstellt wurde, können Beiträge aus anderen NWI-Abschnitten, News 3.x sowie Topics automatisch importiert werden.
Die Seiteneinstellungen werden mit übernommen. Beim Import von Topics-Beiträgen sind aber noch manuelle Nacharbeiten erforderlich, sofern bei Topics die "Additional Images"-Funktion genutzt wurde.</p>
<h3 id="d67">Beiträge kopieren / verschieben</h3>
<p>Aus der Beitragsübersicht im Backend heraus können einzelne, mehrere markierte oder alle (markierten) Beiträge innerhalb eines Abschnitts kopiert oder zwischen unterschiedlichen Abschnitten (auch auf unterschiedlichen Seiten) kopiert oder verschoben werden. Kopierte Beiträge sind stets zunächst im Frontend nicht sichtbar (Auswahl Aktiv: "nein").</p>
<h3 id="d68">Beiträge löschen</h3>
<p>Aus der Beitragsübersicht können einzelne, mehrere markierte oder alle (markierten) Beiträge gelöscht werden. Nach der Bestätigung der Rückfrage sind die betreffenden Beiträge unwiderruflich <strong>VERNICHTET</strong>, es gibt <strong>keinen</strong> Papierkorb!</p>
<h2 id="d7">Einstellungen</h2>
<h3 id="d71">Expertenmodus</h3>
<p>Wird der "Expertenmodus" aktiviert, so stehen zusätzliche Eingabefelder bei den Einstellungen (2. Block), in der Beitragsübersicht (Stichworte) sowie Beitragsdetailansicht (Stichwortzuweisung, 2. Block) zur Verfügung.</p>
<p><strong>Achtung: </strong>Beim Wechsel zwischen aktiviertem und deaktivierten Expertenmodus erfolgt jeweils die Rückkehr zur Beitragsübersicht, andere Änderungen an den Einstellungen werden dabei <strong>nicht</strong> gespeichert. </p>
<h3 id="d72">Übersichtsseite</h3>
<ul>
<li><strong>Sortierung</strong>: Festlegung der Reihenfolge der Beiträge (Benutzerdefiniert = manuelle Festlegung, Beiträge erscheinen so, wie sie im Backend angeordnet werden; Startdatum / Ablaufdatum / eingetragen (=Erstelldatum) / Eintrags-ID: jeweils absteigend nach entsprechendem Kriterium) </li>
<li><strong>Nachrichten pro Seite</strong>: Auswahl, wie viele Einträge (Teaserbild/Text) pro Seite angezeigt werden sollen</li>
<li><strong>Kopfzeile, Beitrag Schleife, Fußzeile</strong>: HTML-Code zur Formatierung der Anzeige</li>
<li><strong>Vorschaubild Größe ändern auf</strong> Breite/Höhe des Bildes in Pixeln. Bei Änderungen erfolgt <strong>keine</strong> automatische Neuberechnung, es ist also sinnvoll, sich im voraus Gedanken über die gewünschte Größe zu machen und dann den Wert nicht mehr zu ändern. <br />
Das Beitragsbild steht <strong>nur</strong> in der angegebenen Auflösung zur Verfügung. Soll es in verschiedenen Größen (klein auf der Übersichtsseite, größer auf der Beitragsseite) verwendet werden, die Bildgröße auf den Wert für die größere Darstellung setzen und das Bild auf der Übersichtsseite per CSS verkleinern.</li>
</ul>
<p>Erlaubte Platzhalter:</p>
<h4 id="d721">Kopfzeile/Fußzeile</h4>
<ul>
<li>[NEXT_PAGE_LINK] "Nächste Seite", verlinkt zur nächsten Seite (bei Aufteilung der Übersichtsseite auf mehrere Seiten), </li>
<li>[NEXT_LINK], "Nächste", s.o.,</li>
<li>[PREVIOUS_PAGE_LINK], "Vorherige Seite", s.o., </li>
<li>[PREVIOUS_LINK],"Vorherige", s.o.,</li>
<li>[OUT_OF], [OF], "x von y",</li>
<li>[DISPLAY_PREVIOUS_NEXT_LINKS] "hidden" / "visible", je nach dem, ob Paginierung erforderlich ist</li>
<li>[BACK] URL der News-Übersichtsseite</li>
<li>[TEXT_BACK] "Zurück zur Übersicht"</li>
</ul>
<h4 id="d722">Beitrag Schleife</h4>
<ul>
<li>[PAGE_TITLE] Überschrift der Seite,</li>
<li>[GROUP_ID] ID der Gruppe, der der Beitrag zugeordnet ist, bei Beiträgen ohne Gruppe "0"</li>
<li>[GROUP_TITLE] Titel der Gruppe, der der Beitrag zugeordnet ist, bei Beiträgen ohne Gruppe "",</li>
<li>[GROUP_IMAGE] Bild (<img src.../>) der Gruppe, der der Beitrag zugeordnet ist, bei Beiträgen ohne Gruppe "",</li>
<li>[DISPLAY_GROUP] <em>inherit</em> oder <em>none</em>,</li>
<li>[DISPLAY_IMAGE] <em>inherit</em> oder <em>none</em>,</li>
<li>[TITLE] Titel (Überschrift) des Beitrags,</li>
<li>[IMAGE] Beitragsbild (<img src=... />),</li>
<li>[SHORT] Kurztext,</li>
<li>[LINK] Link zur Beitrags-Detailansicht,</li>
<li>[HREF] gibt den Link zum Beitrag inkl. href="" aus, also z.B. <code>href="beitrag.php"</code>. Gibt es keinen Langtext und keine Galerie, wird nichts ausgegeben. Mit <code><a [HREF]> ... </a></code> ist es dann möglich, den jeweiligen Beitragslink nur dann klickbar zu machen, wenn es auch tatsächlich einen Langtext und/oder eine Galerie gibt,</li>
<li>[AOPEN] Der komplette <a href="beitrag.php"> Tag, wenn es Langtext oder Galeriebilder gibt, sonst leer,</li>
<li>[ACLOSE] Der schließende </a> - Tag zu [AOPEN],</li>
<li>[MODI_DATE] Datum der letzten Änderung des Beitrags,</li>
<li>[MODI_TIME] Zeitpunkt (Uhrzeit) der letzten Änderung des Beitrags,</li>
<li>[CREATED_DATE] Datum, wann der Beitrag erstellt wurde,</li>
<li>[CREATED_TIME] Uhrzeit, zu der der Beitrag erstellt wurde,</li>
<li>[PUBLISHED_DATE] Startdatum,</li>
<li>[PUBLISHED_TIME] Startuhrzeit,</li>
<li>[USER_ID] ID des Erstellers des Beitrags,</li>
<li>[USERNAME] Benutzername des Erstellers des Beitrags,</li>
<li>[DISPLAY_NAME] Anzeigename des Erstellers des Beitrags,</li>
<li>[EMAIL] Mailadresse des Erstellers des Beitrags,</li>
<li>[TEXT_READ_MORE] "Details anzeigen",</li>
<li>[SHOW_READ_MORE], <em>hidden</em> oder <em>visible</em>,</li>
<li>[GROUP_IMAGE_URL] URL des Gruppen-Bildes,</li>
<li>[CONTENT_LONG] Langtext,</li>
<li>[TAGS] Dem Beitrag zugeordnete Stichworte (Tags)</li>
</ul>
<h3 id="d73">Beitragsansicht</h3>
<ul>
<li><strong>Nachrichten-Kopfzeile, -Inhalt, -Fußzeile, Block 2</strong>: HTML-Code zur Formatierung der Anzeige</li>
</ul>
<p>Erlaubte Platzhalter:</p>
<h4 id="d731">Nachrichten-Kopfzeile, Nachrichten-Fußzeile, Block 2</h4>
<ul>
<li>[PAGE_TITLE] Überschrift der Seite,</li>
<li>[GROUP_ID] ID der Gruppe, der der Beitrag zugeordnet ist, bei Beiträgen ohne Gruppe "0"</li>
<li>[GROUP_TITLE] Titel der Gruppe, der der Beitrag zugeordnet ist, bei Beiträgen ohne Gruppe "",</li>
<li>[GROUP_IMAGE] Bild (<img src.../>) der Gruppe, der der Beitrag zugeordnet ist, bei Beiträgen ohne Gruppe "",</li>
<li>[DISPLAY_GROUP] <em>inherit</em> oder <em>none</em>,</li>
<li>[DISPLAY_IMAGE] <em>inherit</em> oder <em>none</em>,</li>
<li>[TITLE] Titel (Überschrift) des Beitrags,</li>
<li>[IMAGE] Beitragsbild (<img src=... />),</li>
<li>[IMAGE_URL] URL des Beitragsbilds (https://example.com/media/.news_img/filename.jpg),</li>
<li>[CONTENT_SHORT] Kurztext,</li>
<li>[MODI_DATE] Datum der letzten Änderung des Beitrags,</li>
<li>[MODI_TIME] Zeitpunkt (Uhrzeit) der letzten Änderung des Beitrags,</li>
<li>[CREATED_DATE] Datum, wann der Beitrag erstellt wurde,</li>
<li>[CREATED_TIME] Uhrzeit, zu der der Beitrag erstellt wurde,</li>
<li>[PUBLISHED_DATE] Startdatum,</li>
<li>[PUBLISHED_TIME] Startuhrzeit,</li>
<li>[USER_ID] ID des Erstellers des Beitrags,</li>
<li>[USERNAME] Benutzername des Erstellers des Beitrags,</li>
<li>[DISPLAY_NAME] Anzeigename des Erstellers des Beitrags,</li>
<li>[EMAIL] Mailadresse des Erstellers des Beitrags,</li>
<li>[TAGS] Dem Beitrag zugeordnete Stichworte (Tags)</li>
</ul>
<h4 id="d732">Nachrichten-Inhalt</h4>
<ul>
<li>[CONTENT] kompletter Beitragsinhalt (SHORT+LONG) (HTML)<,/li>
<li>[IMAGES] Bilder / Galerie-HTML,</li>
<li>[IMAGE_URL] URL des Beitragsbilds (https://example.com/media/.news_img/filename.jpg),</li>
<li>[CONTENT_SHORT] Kurztext,</li>
<li>[CONTENT_LONG] Langtext, </li>
<li>[TAGS] Dem Beitrag zugeordnete Stichworte (Tags)</li>
</ul>
<h3 id="d74">Galerie-/Bild-Einstellungen</h3>
<ul>
<li><strong>Bildergalerie</strong>: Auswahl des zu verwendenden Galeriescripts. Bitte beachten, dass eventuell vorgenommene individuelle Anpassungen am Galeriecode im Feld Nachrichten-Inhalt bei einer Änderung verloren gehen.</li>
<li><strong>Bild Schleife</strong>: HTML-Code für die Darstellung eines einzelnen Bildes, muss zum jeweiligen Galeriescript passen</li>
<li><strong>Max. Bildgröße in Bytes</strong>: Dateigröße pro Bilddatei, warum das jetzt in Bytes und nicht in lesbareren KB oder MB angegeben werden muss, weiß ich gerade nicht</li>
<li><strong>Galeriebilder / Thumbnailbilder Größe ändern auf Breite x Höhe</strong>: genau selbige. Bei Änderungen erfolgt <strong>keine</strong> automatische Neuberechnung, es ist also sinnvoll, sich im voraus Gedanken über die gewünschte Größe zu machen und dann den Wert nicht mehr zu ändern.</li>
<li><strong>Beschneiden</strong>: Siehe Erläuterung auf der Seite.</li>
</ul>
<h3 id="d75">2. Block</h3>
<p>Optional kann ein 2. Block angezeigt werden, sofern das Template dies unterstützt. In diesem wird dann entweder der hier hinterlegte Inhalt <strong>oder</strong> beim Beitrag hinterlegter Text angezeigt (beides gleichzeitig ist nicht vorgesehen). Das Eingabefeld wird nur angezeigt, wenn der 2. Block aktiviert ist.</p>
</div> <!-- 1 -->
<!-- -------------------------------------------------------------------------------------------------------------------------------------------- -->
<div class="tab2">
<p><strong>This document has been translated automatically. Please notice that there might be some errors or non-exact matches to the actual wording used in the backend.</strong></p>
<h1>News with Images</h1>
<p>News with images (short: NWI) makes it easy to create news pages or posts with several functions:</p>
<ul>
<li>Post picture</li>
<li>integrated picture gallery (Masonry or Fotorama)</li>
<li>optional 2nd content area</li>
<li>Sort articles with drag & drop</li>
<li>Moving / copying posts between groups and sections</li>
<li>Import of entries from the WBCE/WebsiteBaker modules Topics and "Classic" News</li>
<li>Generates a RSS feed: https://www.yourdomain.tld/modules/news_img/rss.php?section_id=XX&page_id=YY<br/>
(replace yourdomain.tld, XX and YY with the actual values)</li>
</ul>
<h2>Download</h2>
<p>The module is a core module as of WBCE CMS 1.4 and installed by default. In addition, the download is available in the [WBCE CMS Add-On Repository] (<a href="https://addons.wbce.org">https://addons.wbce.org</a>).</p>
<h2>License</h2>
<p>NWI is under [GNU General Public License (GPL) v3.0] (<a href="http://www.gnu.org/licenses/gpl-3.0.html">http://www.gnu.org/licenses/gpl-3.0.html</a>).</p>
<h2>System requirements</h2>
<p>There are no special requirements; if WBCE CMS is running fine, NWI should work too.</p>
<h2>installation</h2>
<ol>
<li>If necessary, download the latest version from [AOR] (<a href="https://addons.wbce.org">https://addons.wbce.org</a>)</li>
<li>Install/Update like any other WBCE module via add-ons & gt; modules</li>
</ol>
<h2>Use</h2>
<h3>Getting started and writing</h3>
<ol>
<li>Create a new page with "News with Images"</li>
<li>Click on "Add post" to create a new post or on the headline of an existing post to edit it</li>
<li>Fill out the heading and, if necessary, further fields, if necessary select images. The function of the input fields is probably self-explanatory.</li>
<li>Click "Save" or "Save and go back"</li>
<li>Repeat steps 2. - 4. a few times and look at the whole in the frontend</li>
</ol>
<p>Basically, NWI can be combined with other modules on a page or in a block, but then it can, as with any module that generates its own detail pages, come to results that do not meet the expected / desirable results.</p>
<p>It is strongly recommended to use only one NWI section per page.</p>
<h3>Pictures in the post</h3>
<p>For each post a preview image can be uploaded, which is shown on the overview page and if necessary the post page. In addition, it is possible to add any number of images to a post, which are displayed as a picture gallery. The gallery presentation is shown either as a Fotorama gallery (thumbnails, full-width image) or as a Masonry gallery (picture mosaic).</p>
<p>Which gallery script is used is set for all posts in the settings of each section.</p>
<p>The gallery images are uploaded as the post is saved, and can then be captioned, resorted, or deleted.</p>
<p>When uploading files with the same name as already existing images, the existing files are not overwritten, but the following files are supplemented with consecutive numbering (bild.jpg, bild_1.jpg, etc.).</p>
<p>The management of the pictures takes place only over the post page, not over the WBCE media administration, since NWI does not "know" otherwise, where which images belong / are missing etc.</p>
<h3>Groups</h3>
<p>Posts can be assigned to groups. On the one hand, this has an influence on the order (the posts are sorted according to the group and then according to a further criterion to be specified), and on the other hand, it is possible to generate topic-specific overview pages. These can then be accessed via the URL of the NWI page with the parameter g?=GROUP_ID, e.g. news.php?g=2.</p>
<p>A post can be assigned to one group only.</p>
<p>Single or multiple posts can be copied and moved between groups.</p>
<h3>Tags</h3>
<p>This function is only available if "expert mode" has been activated in the settings and tags have been created.</p>
<p>Posts can be assigned to one or more tags. Depending on the configuration, these tags are then displayed in the front end on the article overview and / or the detailed view and are linked to the overview of all articles for this tag.</p>
<p>Tags are made available centrally for all articles in the section from the article overview ("tags" tab) and can then be selected in the article detail view.</p>
<p>Global tags are available in all NWI sections, e.g. also on other pages of the website.</p>
<p>Once created, tags can be modified and it's also possible to define own colors for each tag.</p>
<h3>2nd Block</h3>
<p>This function is only available if "expert mode" has been activated in the settings and "Use second block" is chosen.</p>
<p>If supported by the template, content can be displayed in a second block (e.g. an aside column). This can be either recurring content stored in the settings, post-specific content (post image, short text, etc.) or texts stored directly in the post that were entered in the input field for the 2nd block.</p>
<h3>import function</h3>
<p>As long as no post has been made in the respective NWI section, posts from the classic news module, other NWI sections as well as topics can be imported automatically.
The page settings of the source page are applied. When importing Topics posts, however, manual rework is still required, if the "Additional Images" function was used in Topics.</p>
<h3>Copy / move posts</h3>
<p>From the post overview in the backend, individual, multiple selected or all (marked) posts within a section can be copied or either copied or moved between different sections (even on different pages). Copied posts are always initially not visible in the frontend (Active selection: "no").</p>
<h3>Delete posts</h3>
<p>You can delete single, multiple selected or all (selected) posts from the post overview. After confirming, the respective posts are irrevocable <strong> DESTROYED </strong>, there is <strong> no </strong> way to restore them!</p>
<h2>configuration</h2>
<h3>Expert mode</h3>
<p>If "Expert mode" is activated, additional input fields are available in the settings (2nd block), in the post overview (tags) and in the detailed post view (tag assignment, 2nd block).</p>
<p><strong>Attention:</strong> If you switch between activated and deactivated expert mode, you will be returned to the entry overview, other changes to the settings will <strong>not</strong> be saved.</p>
<h3>overview page</h3>
<ul>
<li><strong> Order by </strong>: definition of the order of posts (custom = manual definition, posts appear as they are arranged in the backend, start date / expiry date / submitted (= creation date) / Submission ID: each descending order according to the corresponding criterion)</li>
<li><strong> Posts per page </strong>: Selection of how many entries (teaser image / text) per page should be displayed</li>
<li><strong> header, post loop, footer </strong>: HTML code to format the output</li>
<li><strong> Resize preview image to </strong> Width / height of image in pixels. <strong> no </strong> automatic recalculation will take place if changes are made, so it makes sense to think in advance about the desired size and then not change the value again.<br />
The image is only available in the specified resolution. If it is to be used in different sizes (small on the overview page, larger on the post page), set the image size to the value for the larger display and reduce the image on the overview page using CSS.</li>
</ul>
<p>Allowed placeholders:</p>
<h4>Header / Footer</h4>
<ul>
<li>[NEXT_PAGE_LINK] "Next page", linked to the next page (if the overview page is split over several pages),</li>
<li>[NEXT_LINK], "Next", s.o.,</li>
<li>[PREVIOUS_PAGE_LINK], "Previous Page", s.o.,</li>
<li>[PREVIOUS_LINK], "Previous", s.o.,</li>
<li>[OUT_OF], [OF], "x of y",</li>
<li>[DISPLAY_PREVIOUS_NEXT_LINKS] "hidden" / "visible", depending on whether pagination is required</li>
<li>[BACK] URL of the news overview page</li>
<li>[TEXT_BACK] "back"</li>
</ul>
<h4>post loop</h4>
<ul>
<li>[PAGE_TITLE] headline of the page,</li>
<li>[GROUP_ID] ID of the group to which the post is assigned, for posts without group "0"</li>
<li>[GROUP_TITLE] Title of the group to which the post is assigned, for posts without group "",</li>
<li>[GROUP_IMAGE] Image (<img src ... />) of the group to which the post is assigned for posts without group "",</li>
<li>[DISPLAY_GROUP] <em> inherit </em> or <em> none </em>,</li>
<li>[DISPLAY_IMAGE] <em> inherit </em> or <em> none </em>,</li>
<li>[TITLE] title (heading) of the article,</li>
<li>[IMAGE] post image (<img src = ... />),</li>
<li>[SHORT] short text,</li>
<li>[LINK] Link to the article detail view,</li>
<li>[HREF] Link to the detail view including href="" (i.e. <code>href="example-post.php"</code>). If no long content or gallery exists, this placeholder will return an empty string. Depending on the page settings (using <code><a [HREF]> ... </a></code>) links to the detail view are only clickable if some displayable content exists,</li>
<li>[AOPEN]The whole <a href="beitrag.php"> tag, if long text or gallery images exist, otherwise empty,</li>
<li>[ACLOSE] the closing </a> tag to [AOPEN],</li>
<li>[MODI_DATE] date of the last change of the post,</li>
<li>[MODI_TIME] Time (time) of the last change of the post,</li>
<li>[CREATED_DATE] Date when the post was created,</li>
<li>[CREATED_TIME] time at which the post was created,</li>
<li>[PUBLISHED_DATE] start date,</li>
<li>[PUBLISHED_TIME] start time,</li>
<li>[USER_ID] ID of the creator of the post,</li>
<li>[USERNAME] username of the creator of the post,</li>
<li>[DISPLAY_NAME] Display name of the creator of the post,</li>
<li>[EMAIL] Email address of the creator of the post,</li>
<li>[TEXT_READ_MORE] "Show details",</li>
<li>[SHOW_READ_MORE], <em> hidden </em> or <em> visible </em>,</li>
<li>[GROUP_IMAGE_URL] URL of the group image,</li>
<li>[CONTENT_LONG] long text,</li>
<li>[TAGS] The tags assigned to the post</li>
</ul>
<h3>post view</h3>
<ul>
<li><strong> Message Header, Content, Footer, Block 2 </strong>: HTML code for formatting the message</li>
</ul>
<p>Allowed placeholders:</p>
<h4>Message Header, Message Footer, Block 2</h4>
<ul>
<li>[PAGE_TITLE] headline of the page,</li>
<li>[GROUP_ID] ID of the group to which the post is assigned, for posts without group "0"</li>
<li>[GROUP_TITLE] Title of the group to which the post is assigned, for posts without group "",</li>
<li>[GROUP_IMAGE] Image (<img src ... />) of the group to which the post is assigned for posts without group "",</li>
<li>[DISPLAY_GROUP] <em> inherit </em> or <em> none </em>,</li>
<li>[DISPLAY_IMAGE] <em> inherit </em> or <em> none </em>,</li>
<li>[TITLE] title (heading) of the article,</li>
<li>[IMAGE] post image (<img src = ... />),</li>
<li>[IMAGE_URL] post image (http://www.example.com/media/.news_img/file.jpg),</li>
<li>[CONTENT_SHORT] short text,</li>
<li>[MODI_DATE] date of the last change of the post,</li>
<li>[MODI_TIME] Time (time) of the last change of the post,</li>
<li>[CREATED_DATE] Date when the post was created,</li>
<li>[CREATED_TIME] time at which the post was created,</li>
<li>[PUBLISHED_DATE] start date,</li>
<li>[PUBLISHED_TIME] start time,</li>
<li>[USER_ID] ID of the creator of the post,</li>
<li>[USERNAME] username of the creator of the post,</li>
<li>[DISPLAY_NAME] Display name of the creator of the post,</li>
<li>[EMAIL] Email address of the creator of the post,</li>
<li>[TAGS] The tags assigned to the post</li>
</ul>
<h4>news content</h4>
<ul>
<li>[CONTENT] complete post Content (short+long) (HTML),</li>
<li>[IMAGES] Images / Gallery HTML,</li>
<li>[CONTENT_SHORT] short text,</li>
<li>[CONTENT_LONG] long text,</li>
<li>[TAGS] The tags assigned to the post</li>
</ul>
<h3>Gallery / Picture Settings</h3>
<ul>
<li><strong> Image Gallery </strong>: Selection of the gallery script to use. Please note that any customizations made to the gallery code in the Message Content field will be lost in case of a change.</li>
<li><strong> Image loop </strong>: HTML code for the representation of a single image must match the respective gallery script</li>
<li><strong>Max. Image size in bytes </strong>: File size per image file, why this must now be specified in bytes and not in readable KB or MB, I just do not know</li>
<li><strong> Resize gallery images to / Thumbnail size width x height </strong>: exactly same. <strong> no </strong> automatic recalculation will take place if changes are made, so it makes sense to think in advance about the desired size and then not change the value again.</li>
<li><strong> Crop </strong>: See the explanation on the page.</li>
</ul>
<h3>2nd block</h3>
<p>Optionally, a second block can be displayed if the template supports it.</p>
</div> <!-- 2 -->
<!-- -------------------------------------------------------------------------------------------------------------------------------------------- -->
</figure>
</div>
</body>
</html>