Das Modul dient zum Anzeigen aktueller News, meist auf der Startseite. Es werden jeweils die vier jüngsten News nach dem Eingabedatum in jeweils einer Box angezeigt.

Bei der Installation wurde eine versteckte Seite mit dem Namen "Newsbox - Admin" angelegt, auf der sämtliche Datensätze angezeigt werden. Über die orangen Wartungslinks "Beitrag erstellen", "ändern" und "löschen" können neue News angelegt, bzw. bestehende News geändert oder gelöscht werden.

Über das Feld "ausblenden" können Datensätze ausgeblendet werden. Sie scheinen dann nur mehr unter Newsbox - Admin auf und können dort wieder aktiviert werden.

Die Auswahl der anzuzeigenden Newsboxen, sowie die Reihenfolge auf der Seite werden durch zwei Werte bestimmt.

• Datum (Sortierfolge)
  Es werden immer die vier Boxen mit dem jüngsten Datum ausgewählt. Im Normallfall ist das Datum ident mit dem Eingabedatum, kann aber übersteuert werden.
  
  Soll beispielsweise gewährleistet sein, dass ein Beitrag bis zum Datum einer bestimmten Messe angezeigt wird, dann würde man hier das Datum der Messe eingeben. Da dieses Datum in der Zukunft liegt, wird es bis dahin immer das jüngste Datum sein und der Beitrag wird bis dahin geschalten, unabhängig davon, wie viele Beiträge, bei denen das Datum nicht übersteuert wurde, in der Zwischenzeit hinzukommen. Ab dem Tag der Messe, wird der Beitrag durch nachfolgende Beiträge verdrängt.
  
  
• Priorität
  Bei der Auswahl der Beiträge wird die Priorität nicht beachtet, es werden immer die vier Beiträge mit dem jüngsten Datum ausgewählt
  
  Die Priorität bestimmt die Reihenfolge der ausgewählten Beiträge innerhalb der Seite. Standardmäßig werden alle Beiträge mit mittlerer Priorität angelegt. Erhält ein Beitrag höhere Priorität, dann wird dieser vor den anderen geschalten, erhält er niedrigere Priorität, wird er nach den anderen geschalten. Auf diese Weise weist man das System an, bestimmte Beiträge immer vor oder nach den übrigen Beiträgen zu schalten.
  
  Werden mehrere Beiträge mit höherer / niedrigerer Priorität ausgewählt, dann werden diese in der Reihenfolge, in der sie angelegt wurden, angezeigt.
  

Auf der "Newsbox - Admin" Seite finden sich bei jedem Datensatz orange Wartungslinks, über die man Detailseiten anlegen oder diese wieder löschen kann.

Beim Anlegen werden automatisch der Titel, das Bild, Termine, falls eingetragen und der Kurztext auf der Seite eingetragen und können dort nach Belieben verändert werden.

Hinweis: falls nachträglich Änderungen in der Datenbank vorgenommen werden, müssen diese manuell auch auf der Detailseite geändert werden.

Anzahl der angezeigten Boxen:

Mit der rechten Maustaste auf die Box klicken und "Datenbank Eigenschaften" aufrufen.

Im Reiter "Datenbank" den Text "limit 4" suchen und entsprechend ausbessern.

Auf der Archivseite genauso vorgehen, allerdings steht an dieser Stelle "limit -1 offset 4". In dem Fall bitte den offset-Wert ändern.

Stile:

Standardmäßig werden die Boxen ohne Stil angelegt. Der HTML-Code pro Datensatz:

<div class="newsbox">
<div class="Bild"><img src="..."></div>
<h2>Kopfzeile ...</h2>
<p class="termin">1.1.2015</p>
Kurztext ...
<div class="link"><a href="...">mehr ...</a></div>
</div>

Erst durch Zuweisen der Stilklasse "newsbox" erhält die Newsbox ihr typisches Aussehen. Dabei werden folgende Stile angewendet:

div.newsbox {
    max-width: 200px;
    width: 100%;
    min-height: 200px;
    background: white;
    border: 1px solid blue;
    padding: 6px;
    margin: 6px;
    float: left;
}

Diese können über "Stile bearbeiten" angepasst werden

Boxen individuell gestalten:

Über Datenbank Eigenschaften und dem Reiter "Vorlagen" kann der HTML-Code beliebig verändert werden.

Die Syntax für die Platzhalter und der dazu gehörenden Definitionen ist ident mit jener des Datenbank-Elements. Siehe dazu die Dokumentation des Datenbank-Managers

Bildgröße konfigurieren:

Beim Hochladen von Bildern werden diese automatisch auf eine Größe von max. 200x200 Pixel verkleinert. In dieser Größe werden die Bilder auf der Detailseite angezeigt, innerhalb der Newsbox werden sie per CSS auf die richtige Größe getrimmt.

Dieser Wert kann bei den Feldeigenschaften der Schaltfläche "Bild auswählen" verändert werden.

Öffnen Sie unter "Newsbox - Admin"mit Hilfe des Links "Beitrag erstellen" die Eingabeseite der Datenbank, dann mit der rechten Maustaste auf die Schaltfläche "Bild auswählen" die Feldeigenschaften. Geben Sie in das entsprechende Feld die gewünschte Dimension ein.

Beispiel:

Bild=200x200
Bild

Im ersten Fall wird das Bild verzerrungsfrei so verkleinert, bis es maximal 200 Pixel breit und 200 Pixel hoch ist.

Im zweiten Beispiel wurde die Größenangabe weggelassen, damit wird das Bild unverändert übernommen.

Detailseiten konfigurieren:

Die Vorlage für die Detailseiten befindet sich im Sitemap unter Seitenvorlagen mit dem Namen "Newsbox - Vorlage" und kann dort angepasst werden. Änderungen an der Vorlage wirken sich immer nur auf jene Seiten aus, die ab dem Zeitpunkt angelegt werden. Bereits bestehende Seiten werden nicht verändert.

Datenbank anpassen:

Bei Bedarf kann die Datenbank um weitere Datenbankfelder erweitert werden, die dann in den Newsboxen verwendet werden können. Dies geschieht über den Datenbank-Manager, die Datenbank heißt "database.db", die Tabelle heißt "News". Näheres siehe die Dokumentation über den Datenbank-Manager.

Zugriffsrechte:

Standardmäßig wird die Newsbox - Admin Seite automatisch geschützt angelegt und ist für "owner" und "Siteadmin" aufrufbar. Die Zugriffsrechte können über die Seiteneigenschaften der Seite "Newsbox - Admin" angepasst werden.