diff --git a/sitemap.xml b/sitemap.xml index 628de7e..aef755b 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -2,22 +2,22 @@ None - 2023-01-24 + 2023-03-10 daily None - 2023-01-24 + 2023-03-10 daily None - 2023-01-24 + 2023-03-10 daily None - 2023-01-24 + 2023-03-10 daily \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz index 1f781db..ba26837 100644 Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ diff --git a/usage/index.html b/usage/index.html index c7ebd67..e51ab32 100644 --- a/usage/index.html +++ b/usage/index.html @@ -254,22 +254,21 @@

Usage

How it works

-

Ajaxupload generates an upload button for uploading multiple files with progress -counter in FormIt forms. Works well in FF3.6+, Safari4+, Chrome and falls back to -hidden iframe based upload in other browsers, providing good user experience -everywhere.

-

All uploaded files and generated thumbnails are given random filenames to avoid -hotlinking uploaded not published files. Automatic thumbnail generation for -uploaded jpeg, png and gif files. Other uploaded files will get a generic icon -the file extension.

-

The package contains FormIt hooks for prefilling the upload queue from a FormIt -field value and to save the upload queue into a FormIt field value after a form -submission. A third FormIt hook could attach the uploaded files to the FormIt -mails.

+

Ajaxupload creates an upload button for uploading multiple files with progress +counter in FormIt forms. Works well in FF3.6+, Safari4+, Chrome and falls back +to a hidden iframe-based upload in other browsers, providing a good user +experience everywhere.

+

All uploaded files and generated thumbnails are given random file names to avoid +hotlinking of uploaded unpublished files. Automatic thumbnail generation for +uploaded jpg, png and gif files. Other uploaded files get a generic file +extension icon.

+

The package includes FormIt hooks for pre-filling the upload queue from a FormIt +field and saving the upload queue to a FormIt field after a form submission. A +third FormIt hook can append the uploaded files to the FormIt mails.

Display the Upload Button

-

To display the upload button, you have to insert the AjaxUpload snippet call -somewhere in a Resource. If you want to use it with FormIt, you should place the -snippet call in the FormIt form:

+

To display the upload button, you need to place the AjaxUpload snippet call +somewhere in a Resource. If you want to use it with FormIt, you need to place +the snippet call in the FormIt form:

[[!AjaxUpload?
 &uid=`image`
 &allowedExtensions=`jpg,jpeg,png,gif`
@@ -288,14 +287,19 @@ 

Display the Upload Button

-uid -Unique upload queue id 1. -md5 of MODX 'site_url' setting and the current resource id +addCss +Add the snippet css ad the end of the head. +1 (Yes) -language -Snippet/Javascript language. -- +addJquery +Add jQuery script at the end of the body. +0 (No) + + +addJscript +Add the snippet javascript and the fileuploader script at the end of the body. +1 (Yes) allowedExtensions @@ -303,9 +307,9 @@

Display the Upload Button

jpg,jpeg,png,gif -maxFilesizeMb -Maximum size for one file to upload. -8 +language +Snippet/Javascript language. +- maxFiles @@ -313,6 +317,11 @@

Display the Upload Button

3 +maxFilesizeMb +Maximum size for one file to upload. +8 + + thumbX Horizontal size of generated thumb. 100 @@ -323,19 +332,14 @@

Display the Upload Button

100 -addJquery -Add jQuery script at the end of the body. -0 (No) - - -addJscript -Add the snippet javascript and the fileuploader script at the end of the body. -1 (Yes) +uid +Unique upload queue id 1. +md5 of MODX 'site_url' setting and the current resource id -addCss -Add the snippet css ad the end of the head. -1 (Yes) +uploadSectionTpl +Name of a chunk that contains the HTML code for the upload section. +tplAjaxuploadUploadSection @@ -365,9 +369,9 @@

Set and retrieve the upload queue

-ajaxuploadUid -Unique upload queue id. -- +ajaxuploadFieldformat +Format of the data saved in ajaxuploadFieldname. +csv ajaxuploadFieldname @@ -380,12 +384,14 @@

Set and retrieve the upload queue

- -ajaxuploadFieldformat -Format of the data saved in ajaxuploadFieldname. -csv +ajaxuploadUid +Unique upload queue id. +- +

The folder in ajaxuploadTarget has to exist and it has to be writable for PHP +or it must be createable.

The AjaxUpload2Formit hook uses additional properties:

@@ -397,15 +403,15 @@

Set and retrieve the upload queue

- - - - - + + + + +
ajaxuploadClearQueueClear the upload queue after a sucessful run of the hook.0 (No)
ajaxuploadAllowOverwrite Allow overwrite of existing files with the same filename. 1 (Yes)
ajaxuploadClearQueueClear the upload queue after a sucessful run of the hook.0 (No)

Attach the uploaded files to a mail

@@ -466,13 +472,19 @@

System Settings

Log debug information in the MODX error log. No + +ajaxupload.image_tpl +Image Template +Name of a chunk that contains the HTML code for displaying the uploaded image. +tplAjaxUploadImage +

  1. -

    The parameter uid should be set different for each upload button on the site to separate multiple upload queues. 

    +

    The parameter uid has to be set different for each upload button on the site to separate multiple upload queues.