Massignano AP, Italy
lacasettabio@lacasettabio.it

WordPress webcam viewer module document and changelog

Creation and consulting for software and web site

Instructions for Use

Installation:

IF YOU HAVE A NEW BRAND WORDPRESS after 5.7 SITE YOU NEED TO INSTALL ‘CLASSIC WIDGET PLUG-IN’

After downloading the plugin zip folder, make a complete backup of the site where the installation will be performed, for safety. Go to the Plugins menu and then click on Add a new one. Click on Load plugin and select your .zip folder of the webcam viewer. Then wait for the confirmation message. Look at the list of all your plugin and look for Webcam viewer and click on Attivate.

VERY IMPORTANT: your webcam must upload the images into a folder INSIDE your domain. It is strongly recommended to have the webcam upload the images in daily folders contained in a general folder.

Update:

Pro-edition updating is only by download the new version from your purchase account.

Module setting:

On the main backend menu you now have Webcam viewer settings. Click on it and find all the main settings that are the same for widget and for shortcode:

Caption: If selected you enable Caption: the date, time and text over the images are showed.

Text before date: here it is possible to write a text that will appear as a caption on the images before the date.

Text before time: Here you can write a text that will appear as a caption on the images before the time.

Show the time: You can choose whether or not to show the time the picture is taken.

Time format: You can choose the format of the time 12h or 24h.

Show the date: You can choose whether or not to show the date the picture is taken.

Date format: You can choose in which format to show the date. DD / MM / YY or DD / Month / year or day week / DD / month / year or YYYY/MM/DD.

Single or sequenced images:

– Single: select if the webcam sends different images but always with the same name.

– Multiple: select if the webcam sends each image with a different name in a daily folder, that is, the webcam creates a different folder every day in which all the images of that day will end.URL of the image or the folder: write the URL in which the images will be found.

-Rapid: This type of setting only displays the last image loaded in the daily folder. In this case, however, the refresh is only for the image and not for the whole page of the site. There will be a refresh every 10 seconds.

-Bootstrap: basically it is like the Multiple mode but more performing . It Uses Bootstrap and Jquery libraries.

URL of the image or of the folder: write the URL in which the images will be found. For example, if the webcam sends images to the “webcam” folder located in the main root, the URL will be

– case single image: your-path-to-webcam-folder/img.jpg

– case multiple images or rapid: your-path-to-webcam-folder/

NOTE: in neither case should the domain of the site be written. In the case of multiple images with a longer path the url must always end with “/”; the form will automatically add the daily folder with the name created by the webcam.

NOTE2: some server require that you have to write even your domain. So first of all try like in the above example, then try to write a complete path to your webcam folder with your domain

NOTE3: for the shortcode you have to write the url into the shortcode (see example below). For the widget, you have to write it into the widget settings.

Images dimensionIf you want to change the dimension of the images write a number. The number is in % but you write only the number, without %. (It works only with short-code)
Hourly webcamCheck this option if your webcam upload the images in daily, hourly and minutely folder. This option fits for SNC-441FBIFE Burg-Wächter cam and similar.
Images q.tyEnter the number of images to display (max 24). The last saved images will be shown.
TimerThe time in milliseconds between one image and the next
CSS styleSet if you like a CSS image style or not
None: without style
Style 1
Style 2
RefreshSet after how many seconds you want an auto page refresh. Set to 0 if you don’t like it. It’s not settable for RAPID.
FadeCheck it if you like a fade in and fade out effect when the images are changed
ZoomIf it’s setted, you enable an auto zoom whit cursor hover the image
Progress bar indicatorIf it’s setted, you enable a progress indicator bar about the image
BootstrapThe Bootstrap mode uses the Jquery library too and that could create conflict with other component of your site. This is not a bug. If you are not be able to fix the conflict, please, don’t use Bootstrap mode!
JqueryLoad Jquery if it is not loaded jet. Jquery is required if you select BOOTSTRAP on image type.
SlideBootstrap.If it’s setted, the transition of the images will be by a scroll from right to left. The fade effect will be disabled.
Purge folderIf you need to delete the oldest images into your folder, set how many days you like to keep the images. If you don’t need deleting, leave empty or zero.

Pay attention that the images files extension must be .jpg in lowercase letters

WIDGET

Add your widget to your widget area and set:

Title: write the title of your widget

URL of the image or of the folder: write the URL in which the images will be found. For example, if the webcam sends images to the “webcam” folder located in the main root, the URL will be

– case single image: your-path-to-webcam-folder/img.jpg

– case multiple images or rapid: your-path-to-webcam-folder/

NOTE: in neither case should the domain of the site be written. In the case of multiple images with a longer path the url must always end with “/”; the form will automatically add the daily folder with the name created by the webcam.

NOTE2: some server require that you have to write even your domaim. So first of all try like in the above example, then try to write a complete path to your webcam folder with your domain

Single or sequenced images:

Select how your webcam works for uploading the images.
SINGLE: set it if there is a single image with the same name always.
MULTIPLE: set it if there are multiple images into a folder.
RAPID: set it if there are multiple immages into a folder but you want to show only the last one with a rapid refresh. With this mode you can publish more modules with different webcams.
BOOTSTRAP: if there are multiple immages into a folder and you want to show them with a nice fade-in/out effect by Bootstrap.

SHORTCODE

This is the short code you can use to publish the webcam viewer plug-in:

[webcam url="webcam2/20181201/" id="1"]

Webcam url = write the URL in which the images will be found. For example, if the webcam sends images to the “webcam” folder located in the main root, the URL will be.

– case single image: your-path-to-webcam-folder/img.jpg

– case multiple images or rapid: your-path-to-webcam-folder/

NOTE: in neither case should the domain of the site be written. In the case of multiple images with a longer path the url must always end with “/”; the form will automatically add the daily folder with the name created by the webcam.

NOTE2: some server require that you have to write even your domain. So first of all try like in the above example, then try to write a complete path to your webcam folder with your domain

ID = An id number, usually progressive if you like to use more than one shortcode.

== Changelog ==

== Upgrade Notice ==
= 1.1 =
First WordPress release. Many thanks.

== Upgrade Notice ==
= 2.1 =
Compatible until Php 8. and WordPress 6.

== Upgrade Notice ==
= 2.2 =

  • You can now choose whether to delete the pictures into folder. If set, the plugin will erase all images older than the set number of days.
  • Fixed an issue with single image url setting
development softwares and web sites