{{ pluginName }} Settings

{{ msg_page_notifications|raw }}

General Settings

Whether the plugin is enable and other general settings.

If set to 'no', users will not see the file details page when visiting a download url. This would trigger a download of the file instead of previewing it. Useful if you don't want the details page but want to retain image thumbnails.

If set to 'yes', a list of files within the same folder will be shown below the file preview. Shown for both logged in users and shared file urls.

If set to 'yes', a new direct file url will be available to users. This can be used by any user type to directly download a file. Useful for embedding videos in third party players.

Image Preview Settings

Whether to enable image previews and thumbnails. If enabled, thumbnails will be shown while browsing files aswell as when you click to view a file.

If set to 'yes', image previews will be automatically rotated the correct way up (based on EXIF data).

Image Library

Which image library to use? GD is installed by default on most PHP installs and supports 4 images types (jpg, png, gif, bmp). Imagemagick can be installed as an additional PHP module, but can support over 200 image types (inc psd, ai, raw, mng and much more).

Set the extensions above you want to auto-generate previews on. The extension must be listed in the 'available formats' below. It is not recommended to include video file types such as mp4.

Total 5:

jpg,jpeg,png,gif,wbmp (gif is static gif only)

Total {{ formatsArr|length }}:

{{ formatsArr|join(',')|lower }}

If set to 'yes', GIF image thumbnails with be resized as animated. Otherwise a static image will be used.

Watermark

Whether to overlay a watermark on the images. Watermark image should be a png file. If using transparency ensure it's at least 24bit for the best results.

{% if watermark_contents|length > 0 %}
{% endif %}
px

Image Options

The preview image quality.

Between 1 (low quality) and 100 (best quality). Default is 90. The higher the quality the larger the filesize. This does not effect the downloaded file, only the preview/thumbnails.

Embedded Thumbnail Options

Size of externally embedded thumbnails and method of resizing. Thumbnails are used when link to the image from an external site.

Width px
Height px

The maximum size to create the thumbnail. Default is 180x150.

Optional Background Thumbnail Creation

Thumbnails are created and cached as the images are requested via the user interface. You can however generate the cached thumbnails via an automated background task to improve the overall user experience. To enable this setup the following cron task.

The cron script is located here:

{{ DOC_ROOT }}/plugins/filepreviewer/tasks/background_thumbs.cron.php

To execute it, set it up on only main server as a cron task. It is not required on any file servers. This is the line for the crontab file:

* * * * * php {{ DOC_ROOT }}/plugins/filepreviewer/tasks/background_thumbs.cron.php >> /dev/null 2>&1

See here for more information on executing scripts via a cron task.

Document Preview Settings

Whether to enable document previews. If enabled, the document will be shown using Google Docs or Microsoft Office Web Viewer. It's recommended you do not use the document previewer for sensitive or private files. By previewing documents via Google Docs or Microsoft Office Web Viewer you are agreeing to their terms and conditions.

Requires ImageMagick within PHP. Please contact your host to enable this.

Default: doc,docx,xls,xlsx,ppt,pptx,pdf,pages,ai,psd,tiff,dxf,svg,eps,ps,ttf,otf,xps

Other Options

Whether to show embed code and related options.

Width px
Height px

This is the size of the iframe and hence document when embedded on an external site.

Video Preview Settings

Whether to enable video previews. If enabled, the video will be shown after you click on the file.

Default: mp4,flv,ogg

This is browser dependant and may not always be supported. In addition, autoplayed videos are initially muted to adhere to browser autoplay policies.

Other Options

Whether to show embed code and related options.

Width px
Height px

This is the size of the video iframe when embedded on an external site.

Audio Preview Settings

Whether to enable audio previews. If enabled, the audio will be played after you click on the file.

Default: mp3

This is browser dependant and may not always be supported.

Other Options

Whether to show embed code and related options.

Width px
Height px

This is the size of the audio iframe when embedded on an external site.

Text File/Code Preview Settings

Whether to enable text file & code previews. If enabled, the file will be shown directly on the page. Only files up to 2MB will be previewed for performance reasons.

Default: txt,php,html,htm,xhtml,js,css,srt,vtt,log,sql,xml,asp,aspx,cer,cfm,cgi,pl,jsp,py,rss,c,class,cpp,h,java,sh,vb,swift,cfg,ini,text