Index

Files & Images add-ons

This set of add-ons offers functionality to upload and store files and images for your content. You can both upload images and automatically create thumbnail previews for them, and even embed icons directly to the document without loading them. Also, these plugins can help you upload file (documents, archives) and instantly embed the link to download them.

Technically, the set contains three add-ons: File Uploader (uploading and relocation of files including Image Gallery), Embed (embedding images without uploading) and Image Options (configuring uploaded images).

Buttons

Upload image
Upload image
upload an image and embeds the original (resize is available).
Upload preview
Upload preview
upload an image and generate a preview. If your website has preview scripts like LightBox, they will process the image automatically. Upon uploading you can change both the size of the full-size image and the preview.
Upload file
Upload file
upload a file and embedding a link to it.
Upload gallery
Upload gallery
multiple images uploading.
Embed image
Embed image
embed an image without uploading it to the server using Base64 URI Scheme. Recommended for small images like icons.
Edit image options
Edit image element
configure the embedded image. Allows to invoke the loader again to change the image and also to fine-tune styles and classes in the <img> tag.

Uploading files & images

The main add-on in this set is surely File Uploader. This uploader has the following advantages:

  1. Transactional uploading. This means that the uploaded files will not be copied to the main file directory until all files are uploaded and you confirm this by clicking Insert in the dialog. This feature does not require any database or specific configuration.

  2. Keep image original. For any image, a shadow copy is created with the _original suffix when the image requires resizing (except preview). This is useful because the image may be resized many times without quality loss. This option is especially helpful in Image Editor and File Manager add-ons that are awaited in future N1ED updates.

  3. Image resize. For photos and images you can set default dimensions for resizing, and manually adjust them in the dialog.

Installing

If you use our module for CMS, your uploader is already installed and is ready to work. All that follows below only applies to custom installation.

For custom installation you should install the uploader script to your server. We support various platforms, plus there is a universal installation as a microservice. The uploader can be installed both to your main server and to an individual subdomain. The URL of the uploader and the URL of the file directory should be specified in Dashboard.

Available uploaders for custom installation:

Options

Uploader URL - the address of the uploader on your website. The optional parameter needed to allow uploading images to your own website. Read more on installing uploader to the website.

Files URL - the address of the file directory uploaded by the uploader. Optional. Specify it if you installed the uploader on your website, but the URL of the default directory is for uploading images. Read more on installing uploader to the website.

Image edit configuration screenshotEdit configuration page. Files & Images options

Preset options

Below the URL parameters there are three available presets (uploaded files embedding formats). Configure each one and you will be able to modify the embedding template and the default image sizes. Below is the list of preset options.

Template - the template to embed files/images to the edited document. Use HTML code to adjust the template and use snippets to insert file parameters to the template.

{URL} Full URL of the uploaded file

{NAME} Name and extension of the uploaded files

{PATH} Upload directory plus name and extension

{PREVIEW_URL} Preview URL. Only for modes with preview embedding

{PREVIEW_NAME} Preview file name with extension

{PREVIEW_PATH} Upload directory of the preview plus name and extension

{ORIGINAL_URL} URL of the original image (if exists). If no original image exists, equal to {URL}

{ORIGINAL_NAME} Name and extension of the original image. If no original image exists, equal to {NAME}

{ORIGINAL_DIR} Directory of the original image. If no original image exists, equal to {DIR}

{ORIGINAL_PATH} Directory + name and extension of the original image. If no original image exists, equal to {PATH}

Target full width & height - default limitations on height and width. If the image is bigger than these values, it is fit into the rectangle of the specified size. 0 means no limit.

Enlarge full image if smaller - if the image is smaller than the specified sizes, but this option is set, the image is sized up to fit this rectangle (see height and width parameters above).

Target preview width & height - default limitations on height and width of the preview. If the image is bigger than these values, the preview is fit to the rectangle of the corresponding size. 0 means no limit.

Enlarge preview image if smaller - if the image is smaller than the specified sizes, but this option is set, the preview of the image is sized up to fit this rectangle (see height and width parameters above).