Skip to content
Offerel edited this page Oct 4, 2023 · 6 revisions

Pictures Plugin

This is a very simple pictures/gallery plugin for Roundcube. You can view your personal photos that are synced to your personal storage in a easy way. This plugin does not sync itself, it gives you only easy access to the synced photos. To sync your photos, you can use any sync software/system which can automatically sync the photos from your smartphone (or any other device) to a storage accessible by Roundcube.

History

This plugin was originally based on MinigalNano (https://github.com/sebsauvage/MinigalNano), but was changed so far that there is hardly any code left from this project.

Hints and Tips

Albums and folders

An album is stored in the file system as a folder. Thus, folder and album are synonymous with each other. This means that an album can also have a sub-album. Albums can be created thus also over the file system.

Folder "Incoming

This folder is meant for new photos to "arrive" unsorted. For example pictures from the digital camera or from the smartphone. From here, the images can be moved to existing albums or deleted. This folder should therefore never be deleted.

Thumbnails

Normally albums get their thumbnails automatically from the respective content of the folders. The first image of the folder is used for this purpose. Usually this is the oldest one. But if a folder has only subfolders, there are no direct images in the folder from which a preview can be created. In this case, a default gray image is used. Alternatively, you can place any image named "folder.jpg" in the folder. This image will not be displayed as an image in the folder but will be used as a preview image. A custom "folder.jpg" also overwrites the preview automatically created from the content.

Sometimes newly uploaded images via manual uploads are not visible as previews. The preview is generated automatically overnight or manually via the maintenance script if required. Images uploaded via the web interface receive a preview immediately.

Share images

Images can be shared with others. Sharing creates a link that can be easily shared with anyone. Anyone who has the link can access the images with read access and also download them. However, the person cannot delete, edit or otherwise change the images. Usually, a link has an expiration timestamp. Once this is reached, no images can be accessed under the link. When sharing, the expiration date can be specified more precisely or it can be suppressed altogether. You can also add more images to an existing link later.

Clone this wiki locally