Google translator »

(Opens in a new window - öffnet in einem neuen Fenster)

Kurz-Dokumentation Plugin "Collection"

Version Collection 1.8 - released 2024-07

Das Plugin Collection ist eine Sammlung von Scripten, für die sich ein eigenes Plugin nicht lohnt.

1. Systemvoraussetzungen

Voraussetzung ist eine funktionierende Installation von CMSimple 4.2 oder höher.

2. Installation

  1. zip-Datei herunterladen und mit einem geeigneten Programm entpacken
  2. Laden Sie den Ordner collection/ in das Verzeichnis ./plugins/ Ihrer CMSimple Installation hoch.

3. Datei- und Ordnerrechte

Damit das Programm funktioniert und arbeiten kann (bzw. administrierbar ist), müssen eventuell für bestimmte Dateien und Ordner bestimmte Schreib- und Leserechte vergeben werden.

Dateien: chmod 666

4. Plugin-Aufrufe / Funktionen

Hinweis: Bitte fügen Sie die Plugin Aufrufe immer in der Quelltext Ansicht ein.
Oder kopieren Sie sie zuerst in einen Code- oder Texteditor, und von da aus in den CMSimple Inhalt, damit Formatierungen entfernt werden.

4.1 Zuletzt geänderte CMSimple Seiten (Last Changed CMSimple Pages)

Mit dieser Funktion können Sie eine im Plugin-Aufruf festgelegte Anzahl der zuletzt geänderten CMSimple Seiten anzeigen.

{{{plugin:col_lastChangedPages(9);}}}

Die Anzeige des Änderungsdatums können Sie mit einem 2. Parameter deaktivieren:

{{{plugin:col_lastChangedPages(9,'nodate');}}}

nach oben

4.2 Zeitgesteuerte Veröffentlichung (scheduled publishing)

Mit dieser Funktion können Sie eine CMSimple-Seite zeitgesteuert stundengenau veröffentlichen.

{{{plugin:col_scheduledPage('yyyymmddhh','yyyymmddhh');}}}

Beispiel (Example):

Mit diesem Funktions-Aufruf wird die Seite vom 01.03.2019 0:00 Uhr bis zum 31.03.2019 24:00 Uhr veröffentlicht.

{{{plugin:col_scheduledPage('2019030100','2019033123');}}}

nach oben

4.3 Externe Datei einfügen (embed file)

Mit dieser Funktion können Sie z. B. eine pdf-Datei in Ihre Seite einfügen.

{{{plugin:col_embedFile('path','width','height','class');}}}

Beispiel (Example):

{{{plugin:col_embedFile('userfiles/pdf/my.pdf','100%','480px','col_embedFile');}}}

Den letzten Parameter kann man weglassen, dann ist automatisch die CSS-Klasse .col_embedFile aktiv.

nach oben

4.4 Adventskranz

Mit diesen Funktionen können Sie einen Adventskranz in Ihre Seite einfügen. Der Adventskranz erscheint am 1. Advent, an jedem Advent geht eine weitere Kerze an. Ab dem 4. Advent brennen 4 Kerzen bis zum 24. Dezember 14:00 Uhr. Danach erscheint ein Weihnachtsbaum bis zum Jahresende.

Im Inhalt:

mit .png Grafiken:

{{{plugin:col_adventPNG();}}}

oder mit animierten GIFs:

{{{plugin:col_adventGIF();}}}

Im Template (template.htm):

mit .png Grafiken:

<?php echo col_adventPNG();?>

mit animierten GIFs:

<?php echo col_adventGIF();?>

Wenn Sie den Parameter 'test' eingeben, ist der Adventskranz dauerhaft sichtbar:

<?php echo col_adventPNG('test');?>

nach oben

4.5 Countdown PHP

Mit dieser Funktion können Sie einen Countdown zu einem Tag in Ihre Seite oder in das Template einfügen.

In eine Seite einfügen:

{{{plugin:col_countdown(year,month,day,'text_singular','text_plural','Text am Zieltag','Text nach Ablauf',hdiff);}}}

In die template.htm einfügen:

<?php echo col_countdown(year,month,day,'text_singular','text_plural','Text am Zieltag','Text nach Ablauf');?>

Beispiel (Example):

Countdown auf Silvester

{{{plugin:col_countdown(2022,12,31,'Tag bis Silvester','Tage bis Silvester','Guten Rutsch!','Prost Neujahr!');}}}

Achtung! Die ersten 3 Parameter sind numerische Werte, werden also NICHT in Quotes gesetzt.
Es sind die Werte des Zieltages.

nach oben

4.6 Countdown JS

Mit dieser Funktion können Sie einen dynamischen JavaScript Countdown zu einem Tag in Ihre Seite oder in das Template einfügen.

In eine Seite einfügen:

{{{plugin:col_jsCountdown('Zieltag','text_Tage','text_Stunden','text_Minuten','text_Sekunden','Text_nach_Ablauf','id');}}}

In die template.htm einfügen:

<?php echo col_jsCountdown('Zieltag','text_Tage','text_Stunden','text_Minuten','text_Sekunden','Text_nach_Ablauf','id');?>

Beispiel (Example):

Countdown auf Neujahr

{{{plugin:col_jsCountdown('2023-01-01 00:00:00','Tage','Std','Min','Sec','Prost Neujahr!','neujahr2023');}}}

Achtung! Die Syntax für den 1. Parameter muss unbedingt eingehalten werden: 'YYYY-mm-dd hh:mm:ss'

Bei mehreren Countern auf einer Seite muss der letzte Parameter mit einer eindeutigen ID angegeben werden.

nach oben

4.7 Bildschirmauflösung und Viewport

Mit diesen Funktionen können Sie die Bildschirmauflösung und den Viewport (Breite x Höhe in px) anzeigen lassen.

In eine Seite einfügen:

{{{plugin:col_screenres();}}}

{{{plugin:col_viewport();}}}

In die template.htm einfügen:

<?php echo col_screenres();?>

<?php echo col_viewport();?>

Die Funktionen dürfen nur 1x pro Seite aufgerufen werden.

nach oben

4.8 CMSimple Seiten als Overlay im Lightbox Stil

Mit diesen Funktionen können Sie die Druckansicht einer CMSimple Seite, Webseiten und verschiedene Dateitypen in einem Overlay im Lightbox Stil präsentieren. Sie erzeugen einen Link, der, wenn er angeklickt wird, das Overlay erzeugt.

Hinweis: Diese Funktionen sind zur Darstellung eigener Inhalte in Overlays gedacht.
Manche Funktionen bieten auch die Möglichkeit, fremde Inhalte einzubinden. Wenn Sie das tun, beachten Sie bitte das Urheberrecht.

4.8.1 Die Funktion col_ovlPage()

Diese Funktion zeigt eine eigene CMSimple Seite aus der aktuellen Website, Subsite oder Zweitsprache als Overlay:

{{{plugin:col_ovlPage('id','Seite','Linktext','Design','top');}}}

Beispiel:

<?php echo col_ovlPage('2023-12-20-15-10','Datenschutzerklaerung','Datenschutzerklärung','dark','60px');?>

4.8.2 Die Funktion col_ovlURL()

Diese Funktion zeigt Websites und Dateien als Overlay.

Getestet wurden folgende Dateitypen: .mp4 .ogv .webm .jpg .jpeg .png .gif .htm sowie .txt Dateien mit html Code.

Es wurde auch mit .php Dateien getestet, diese müssen grundsätzlich absolut referenziert werden, beginnend mit http(s)://.

{{{plugin:col_ovlURL('id','URL','Linktext','Design','top');}}}

Beispiel:

{{{plugin:col_ovlURL('2023-12-20-15-16','./userfiles/overlays/demo.txt','Externe Textdatei','bright');}}}

4.8.3 Die Funktion col_ovlFrame()

Diese Funktion funktioniert wie die Funktion col_ovlURL() und hat die gleiche Syntax. Sie verwendet einen iFrame im Overlay und ist hauptsächlich zur Darstellung eigener CMSimple Seiten auf restriktiv konfigurierten Servern geeignet. Man kann damit auch externe Websites und Dateien in einem Overlay darstellen, manche Website Betreiber verhindern jedoch die Anzeige ihrer Websites in fremden Frames (und das mit Recht), und es gibt Probleme mit der Darstellung von http-Seiten in iFrames von https-Seiten.

Beispiel:

{{{plugin:col_ovlFrame('2023-12-20-15-24','./userfiles/overlays/demo.txt','Externe Textdatei','bright');}}}

4.8.4 Vorschaubild statt Linktext

Die Funktionen col_ovlURL() und col_ovlFrame() können für Bilder und Videos (.mp4 .ogv .webm .jpg .jpeg .png .gif) statt des Textlinks ein Vorschaubild (Thumbnail) anzeigen. Dazu müssen folgende Bedingungen erfüllt sein:

Beispiel:

{{{plugin:col_ovlURL('2023-12-20-15-39','./userfiles/overlays/demo.mp4','%img%Demo Video');}}}

Jetzt muss man nur die Zeichenfolge %img% entfernen, wenn man statt des Vorschaubildes wieder den Textlink haben will.

nach oben

4.9 Anrufbuttons

Mit diesen Funktionen können Anrufbuttons erzeugt werden. Auf Mobiltelefonen funktionieren die in der Regel, auf PCs muss ein entsprechendes Programm installiert sein, ähnlich wie bei E-mail Links.

4.9.1 Die Funktion col_callPhone()

Diese Funktion erzeugt einen Button mit einem konventionellen Telefon Icon:

{{{plugin:col_callPhone('Telnr','Titel','Style','maxwidth');}}}

4.9.2 Die Funktion col_callMobile()

Diese Funktion erzeugt einen Button mit einem Smartphon Icon:

{{{plugin:col_callMobile('Telnr','Titel','Style','maxwidth');}}}

Die Syntax ist die gleiche wie bei der Funktion col_callPhone().

nach oben

4.10 RSS Feeds einbinden

Mit dieser Funktion können Sie RSS Feeds in eine CMSimple Seite einbinden.

{{{plugin:col_embedRssFeed('URL',Anzahl,'Beschreibung',trim);}}}

Beispiel

{{{function:col_embedRssFeed('https://www.wetterkontor.de/de/rss.asp',6,'desc');}}}

Dieser Pluginaufruf zeigt den RSS Feed mit 6 Beiträgen und mit Teasertexten an.

nach oben

5. Konfiguration

Für Collection gibt es keine Konfigurations Optionen.