# News with Images

## Inhalt

- Allgemein
- Download
- Lizenz
- Systemvoraussetzungen
- Installation/Update
- Beiträge erstellen/bearbeiten
- Einstellungen

## Allgemein

News with images (kurz: NWI) ermöglicht das Erstellen von News-Seiten bzw. -Beiträgen und bietet u.a. folgende Funktionen:

- Beitragsbild
- integrierte Bildergalerie (Masonry oder Fotorama)
- optionaler 2. Inhaltsbereich
- Sortieren von Beiträgen mit Drag & Drop
- Verschieben/Kopieren von Beiträgen zwischen Gruppen und Abschnitten
- Import von Beiträgen und Einstellungen aus dem Modul "Topics" sowie "News" ("klassisches Newsmodul" bis Version 3.5.12)

## Download

Das Modul ist ab WBCE CMS 1.4 ein Coremodul und standardmäßig installiert. Darüber hinaus ist der Download im WBCE CMS Add-On Repository verfügbar.

## Lizenz

NWI steht unter der GNU General Public License (GPL) v3.0.

## Systemvoraussetzungen

NWI hat keine besonderen Systemvoraussetzungen. Wenn WBCE CMS funktioniert, sollte auch NWI laufen.

## Installation/Update

1. Sofern erforderlich, aktuelle Version aus dem AOR herunterladen
2. Wie jedes andere WBCE-Modul auch über Erweiterungen > Module installieren bzw. aktualisieren

## Beiträge erstellen und bearbeiten

### Loslegen und Schreiben

1. Ggfs. eine neue Seite mit "News with Images" anlegen
2. Um einen neuen Beitrag zu erstellen, auf die Schaltfläche "Beitrag verfassen" klicken. Zum Bearbeiten des Inhalts eines vorhandenen Beitrags auf dessen Titel klicken.
3. Überschrift und ggf. weitere Felder ausfüllen, ggf. Bilder auswählen. Die Funktion der Eingabefelder ist wohl selbsterklärend.
4. Auf "Speichern" oder "Speichern und zurück" klicken
5. Schritte 2. - 4. ein paar Mal wiederholen und sich das ganze im Frontend anschauen

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.

### Bilder im Beitrag

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).

Welches Galeriescript verwendet wird, wird für alle Beiträge in den Einstellungen des jeweiligen Abschnitts festgelegt.

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.

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.)

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.

### Gruppen

Beiträge können Gruppen zugeordnet werden. Dies hat einerseits Einfluss auf die Reihenfolge (die Beiträge werden erst nach Gruppe und dann nach einem weiteren anzugebenden Kriterium sortiert), und ermöglicht andererseits, 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.

Ein Beitrag kann immer nur einer Gruppe zugeordnet sein.

Einzelne oder mehrere Beiträge können von einer Gruppe in eine andere kopiert und verschoben werden.

### Stichworte

Diese Funktion steht nur zur Verfügung, wenn bei den Einstellungen der "Expertenmodus" aktiviert wurde und Stichworte angelegt wurden.

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.

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.

Globale Stichworte stehen in allen NWI-Abschnitten zur Verfügung, also auch auf anderen Seiten des Auftritts.

Nach dem Anlegen können Stichworte bearbeitet/geändert werden, ebenso ist es möglich, diesen eigene Farben zuzuweisen.

### 2. Block

Diese Funktion steht nur zur Verfügung, wenn bei den Einstellungen der "Expertenmodus" aktiviert wurde und die Verwendung des 2. Blocks aktiviert ist.

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.

### Importfunktion

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.

### Beiträge kopieren / verschieben

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").

### Beiträge löschen

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 VERNICHTET, es gibt keinen Papierkorb!

## Einstellungen

### Expertenmodus

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.

Achtung: Beim Wechsel zwischen aktiviertem und deaktivierten Expertenmodus erfolgt jeweils die Rückkehr zur Beitragsübersicht, andere Änderungen an den Einstellungen werden dabei nicht gespeichert.

### Übersichtsseite

- Sortierung: 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)
- Nachrichten pro Seite: Auswahl, wie viele Einträge (Teaserbild/Text) pro Seite angezeigt werden sollen
- Kopfzeile, Beitrag Schleife, Fußzeile: HTML-Code zur Formatierung der Anzeige
- Vorschaubild Größe ändern auf Breite/Höhe des Bildes in Pixeln. Bei Änderungen erfolgt keine 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.
  Das Beitragsbild steht nur 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.

Erlaubte Platzhalter:

#### Kopfzeile/Fußzeile

- [NEXT_PAGE_LINK] "Nächste Seite", verlinkt zur nächsten Seite (bei Aufteilung der Übersichtsseite auf mehrere Seiten),
- [NEXT_LINK], "Nächste", s.o.,
- [PREVIOUS_PAGE_LINK], "Vorherige Seite", s.o.,
- [PREVIOUS_LINK],"Vorherige", s.o.,
- [OUT_OF], [OF], "x von y",
- [DISPLAY_PREVIOUS_NEXT_LINKS] "hidden" / "visible", je nach dem, ob Paginierung erforderlich ist
- [BACK] URL der News-Übersichtsseite
- [TEXT_BACK] "Zurück zur Übersicht"

#### Beitrag Schleife

- [PAGE_TITLE] Überschrift der Seite,
- [GROUP_ID] ID der Gruppe, der der Beitrag zugeordnet ist, bei Beiträgen ohne Gruppe "0"
- [GROUP_TITLE] Titel der Gruppe, der der Beitrag zugeordnet ist, bei Beiträgen ohne Gruppe "",
- [GROUP_IMAGE] Bild (<img src.../>) der Gruppe, der der Beitrag zugeordnet ist, bei Beiträgen ohne Gruppe "",
- [DISPLAY_GROUP] inherit oder none,
- [DISPLAY_IMAGE] inherit oder none,
- [TITLE] Titel (Überschrift) des Beitrags,
- [IMAGE] Beitragsbild (<img src=... />),
- [SHORT] Kurztext,
- [LINK] Link zur Beitrags-Detailansicht,
- [MODI_DATE] Datum der letzten Änderung des Beitrags,
- [MODI_TIME] Zeitpunkt (Uhrzeit) der letzten Änderung des Beitrags,
- [CREATED_DATE] Datum, wann der Beitrag erstellt wurde,
- [CREATED_TIME] Uhrzeit, zu der der Beitrag erstellt wurde,
- [PUBLISHED_DATE] Startdatum,
- [PUBLISHED_TIME] Startuhrzeit,
- [USER_ID] ID des Erstellers des Beitrags,
- [USERNAME] Benutzername des Erstellers des Beitrags,
- [DISPLAY_NAME] Anzeigename des Erstellers des Beitrags,
- [EMAIL] Mailadresse des Erstellers des Beitrags,
- [TEXT_READ_MORE] "Details anzeigen",
- [SHOW_READ_MORE], hidden oder visible,
- [GROUP_IMAGE_URL] URL des Gruppen-Bildes,
- [CONTENT_LONG] Langtext,
- [TAGS] Dem Beitrag zugeordnete Stichworte (Tags)

### Beitragsansicht

- Nachrichten-Kopfzeile, -Inhalt, -Fußzeile, Block 2: HTML-Code zur Formatierung der Anzeige

Erlaubte Platzhalter:

#### Nachrichten-Kopfzeile, Nachrichten-Fußzeile, Block 2

- [PAGE_TITLE] Überschrift der Seite,
- [GROUP_ID] ID der Gruppe, der der Beitrag zugeordnet ist, bei Beiträgen ohne Gruppe "0"
- [GROUP_TITLE] Titel der Gruppe, der der Beitrag zugeordnet ist, bei Beiträgen ohne Gruppe "",
- [GROUP_IMAGE] Bild (<img src.../>) der Gruppe, der der Beitrag zugeordnet ist, bei Beiträgen ohne Gruppe "",
- [DISPLAY_GROUP] inherit oder none,
- [DISPLAY_IMAGE] inherit oder none,
- [TITLE] Titel (Überschrift) des Beitrags,
- [IMAGE] Beitragsbild (<img src=... />),
- [IMAGE_URL] URL des Beitragsbilds (https://example.com/media/.news_img/filename.jpg),
- [CONTENT_SHORT] Kurztext,
- [MODI_DATE] Datum der letzten Änderung des Beitrags,
- [MODI_TIME] Zeitpunkt (Uhrzeit) der letzten Änderung des Beitrags,
- [CREATED_DATE] Datum, wann der Beitrag erstellt wurde,
- [CREATED_TIME] Uhrzeit, zu der der Beitrag erstellt wurde,
- [PUBLISHED_DATE] Startdatum,
- [PUBLISHED_TIME] Startuhrzeit,
- [USER_ID] ID des Erstellers des Beitrags,
- [USERNAME] Benutzername des Erstellers des Beitrags,
- [DISPLAY_NAME] Anzeigename des Erstellers des Beitrags,
- [EMAIL] Mailadresse des Erstellers des Beitrags,
- [TAGS] Dem Beitrag zugeordnete Stichworte (Tags)

#### Nachrichten-Inhalt

- [CONTENT] kompletter Beitragsinhalt (SHORT+LONG) (HTML)<,/li>
- [IMAGES] Bilder / Galerie-HTML,
- [IMAGE_URL] URL des Beitragsbilds (https://example.com/media/.news_img/filename.jpg),
- [CONTENT_SHORT] Kurztext,
- [CONTENT_LONG] Langtext,
- [TAGS] Dem Beitrag zugeordnete Stichworte (Tags)

### Galerie-/Bild-Einstellungen

- Bildergalerie: Auswahl des zu verwendenden Galeriescripts. Bitte beachten, dass eventuell vorgenommene individuelle Anpassungen am Galeriecode im Feld Nachrichten-Inhalt bei einer Änderung verloren gehen.
- Bild Schleife: HTML-Code für die Darstellung eines einzelnen Bildes, muss zum jeweiligen Galeriescript passen
- Max. Bildgröße in Bytes: Dateigröße pro Bilddatei, warum das jetzt in Bytes und nicht in lesbareren KB oder MB angegeben werden muss, weiß ich gerade nicht
- Galeriebilder / Thumbnailbilder Größe ändern auf Breite x Höhe: genau selbige. Bei Änderungen erfolgt keine 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.
- Beschneiden: Siehe Erläuterung auf der Seite.

### 2. Block

Optional kann ein 2. Block angezeigt werden, sofern das Template dies unterstützt. In diesem wird dann entweder der hier hinterlegte Inhalt oder beim Beitrag hinterlegter Text angezeigt (beides gleichzeitig ist nicht vorgesehen). Das Eingabefeld wird nur angezeigt, wenn der 2. Block aktiviert ist.

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.

# News with Images

News with images (short: NWI) makes it easy to create news pages or posts with several functions:

- Post picture
- integrated picture gallery (Masonry or Fotorama)
- optional 2nd content area
- Sort articles with drag & drop
- Moving / copying posts between groups and sections
- Import of entries from the WBCE/WebsiteBaker modules Topics and "Classic" News

## Download

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] (https://addons.wbce.org).

## License

NWI is under [GNU General Public License (GPL) v3.0] (http://www.gnu.org/licenses/gpl-3.0.html).

## System requirements

There are no special requirements; if WBCE CMS is running fine, NWI should work too.

## installation

1. If necessary, download the latest version from [AOR] (https://addons.wbce.org)
2. Install/Update like any other WBCE module via add-ons & gt; modules

## Use

### Getting started and writing

1. Create a new page with "News with Images"
2. Click on "Add post" to create a new post or on the headline of an existing post to edit it
3. Fill out the heading and, if necessary, further fields, if necessary select images. The function of the input fields is probably self-explanatory.
4. Click "Save" or "Save and go back"
5. Repeat steps 2. - 4. a few times and look at the whole in the frontend

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.

### pictures in the post

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).

Which gallery script is used is set for all posts in the settings of each section.

The gallery images are uploaded as the post is saved, and can then be captioned, resorted, or deleted.

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.).

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.

### Groups

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.

A post can be assigned to one group only.

Single or multiple posts can be copied and moved between groups.

### Tags

This function is only available if "expert mode" has been activated in the settings and tags have been created.

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.

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.

Global tags are available in all NWI sections, e.g. also on other pages of the website.

Once created, tags can be modified and it's also possible to define own colors for each tag.

### 2nd Block

This function is only available if "expert mode" has been activated in the settings and "Use second block" is chosen.

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.

### import function

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.

### Copy / move posts

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").

### Delete posts

You can delete single, multiple selected or all (selected) posts from the post overview. After confirming, the respective posts are irrevocable DESTROYED , there is no way to restore them!

## configuration

### Expert mode

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).

Attention: If you switch between activated and deactivated expert mode, you will be returned to the entry overview, other changes to the settings will not be saved.

### overview page

- Order by : 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)
- Posts per page : Selection of how many entries (teaser image / text) per page should be displayed
- header, post loop, footer : HTML code to format the output
- Resize preview image to Width / height of image in pixels. no 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.
  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.

Allowed placeholders:

#### Header / Footer

- [NEXT_PAGE_LINK] "Next page", linked to the next page (if the overview page is split over several pages),
- [NEXT_LINK], "Next", s.o.,
- [PREVIOUS_PAGE_LINK], "Previous Page", s.o.,
- [PREVIOUS_LINK], "Previous", s.o.,
- [OUT_OF], [OF], "x of y",
- [DISPLAY_PREVIOUS_NEXT_LINKS] "hidden" / "visible", depending on whether pagination is required
- [BACK] URL of the news overview page
- [TEXT_BACK] "back"

#### post loop

- [PAGE_TITLE] headline of the page,
- [GROUP_ID] ID of the group to which the post is assigned, for posts without group "0"
- [GROUP_TITLE] Title of the group to which the post is assigned, for posts without group "",
- [GROUP_IMAGE] Image (<img src ... />) of the group to which the post is assigned for posts without group "",
- [DISPLAY_GROUP] inherit or none ,
- [DISPLAY_IMAGE] inherit or none ,
- [TITLE] title (heading) of the article,
- [IMAGE] post image (<img src = ... />),
- [SHORT] short text,
- [LINK] Link to the article detail view,
- [MODI_DATE] date of the last change of the post,
- [MODI_TIME] Time (time) of the last change of the post,
- [CREATED_DATE] Date when the post was created,
- [CREATED_TIME] time at which the post was created,
- [PUBLISHED_DATE] start date,
- [PUBLISHED_TIME] start time,
- [USER_ID] ID of the creator of the post,
- [USERNAME] username of the creator of the post,
- [DISPLAY_NAME] Display name of the creator of the post,
- [EMAIL] Email address of the creator of the post,
- [TEXT_READ_MORE] "Show details",
- [SHOW_READ_MORE], hidden or visible ,
- [GROUP_IMAGE_URL] URL of the group image,
- [CONTENT_LONG] long text,
- [TAGS] The tags assigned to the post

### post view

- Message Header, Content, Footer, Block 2 : HTML code for formatting the message

Allowed placeholders:

#### Message Header, Message Footer, Block 2

- [PAGE_TITLE] headline of the page,
- [GROUP_ID] ID of the group to which the post is assigned, for posts without group "0"
- [GROUP_TITLE] Title of the group to which the post is assigned, for posts without group "",
- [GROUP_IMAGE] Image (<img src ... />) of the group to which the post is assigned for posts without group "",
- [DISPLAY_GROUP] inherit or none ,
- [DISPLAY_IMAGE] inherit or none ,
- [TITLE] title (heading) of the article,
- [IMAGE] post image (<img src = ... />),
- [IMAGE_URL] post image (http://www.example.com/media/.news_img/file.jpg),
- [CONTENT_SHORT] short text,
- [MODI_DATE] date of the last change of the post,
- [MODI_TIME] Time (time) of the last change of the post,
- [CREATED_DATE] Date when the post was created,
- [CREATED_TIME] time at which the post was created,
- [PUBLISHED_DATE] start date,
- [PUBLISHED_TIME] start time,
- [USER_ID] ID of the creator of the post,
- [USERNAME] username of the creator of the post,
- [DISPLAY_NAME] Display name of the creator of the post,
- [EMAIL] Email address of the creator of the post,
- [TAGS] The tags assigned to the post

#### news content

- [CONTENT] complete post Content (short+long) (HTML),
- [IMAGES] Images / Gallery HTML,
- [CONTENT_SHORT] short text,
- [CONTENT_LONG] long text,
- [TAGS] The tags assigned to the post

### Gallery / Picture Settings

- Image Gallery : 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.
- Image loop : HTML code for the representation of a single image must match the respective gallery script
- Max. Image size in bytes : 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
- Resize gallery images to / Thumbnail size width x height : exactly same. no 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.
- Crop : See the explanation on the page.

### 2nd block

Optionally, a second block can be displayed if the template supports it.