How to Allow Users to Upload Documents Wordpress
The File Uploads addition needs to be installed and activated to meet the features mentioned in this this documentation.
- Adding and configuring a File Upload selection for your users
- Attaching an uploaded file to an email
- Saving uploaded files to Dropbox, Google Bulldoze, or Amazon S3
- File Uploads Full general Settings
- Advanced functionality
Calculation a File Upload selection to your grade
A File Uploads field tin be added to the course past clicking on the Add Field Push button on the bottom right, then choosing the File Upload field from the list.
Configuring your File Upload field
Click on the File Upload field to open up its settings window.
d
General Settings
Label
The proper noun of the field as displayed to your users.
Required Field
If enabled, this field must be completed before the form can exist submitted.
Save to Server
Enabled by default, this choice volition save an uploaded file to your server when the form is submitted.
Rename Uploaded File
If you want the file to retain the proper noun your user gave information technology, leave this bare. If you prefer your ain naming convention, you can enter it here using the merge tag button.
There is a {file:extension} merge tag, but that doesn't have to exist added to the end of the setting as information technology volition be added automatically.
The {file:proper name} and {file:extension} merge tags are merely used the field settings and can't be used in deportment or other places. You can also create directories using / in the name.
The old style "shortcodes" are still supported for renaming and can be mixed with merge tags. These shortcodes tin be found in the expandable section immediately below:
Renaming Conventions
%filename% – The file's original filename, with any special characters removed.
%formtitle% – The title of the current form, with whatsoever special characters removed.
%username% – The WordPress username for the user, if they are logged in.
%userid% – The WordPress ID (int) for the user, if they are logged in.
%displayname% – The WordPress displayname for the user, if they are logged in.
%lastname% – The WordPress lastname for the user, if they are logged in.
%firstname% – The WordPress firstname for the user, if they are logged in.
%engagement% – Today's date in yyyy-mm-dd format.
%month% – Today's month in mm format.
%24-hour interval% – Today's day in dd format.
%twelvemonth% – Today'southward year in yyyy format.
Salve to Media Library
If this setting is enabled, the File Upload will be saved to the server'south Media Library.
Y'all tin can remember data nearly the attachment created in the media library using the following merge tags:
{field:my_field_key:attachment_id} – the ID of the attachment
{field:my_field_key:attachment_url} – the URL of the attachment
{field:my_field_key:attachment_embed} – an HTML paradigm of the attachment
Restrictions Settings
File Limit
Utilise this option to adjust the number of files that be uploaded from this File Upload field.
Maximum File Size
Set the maximum size of the file that can be uploaded here. This setting defaults to MB. Your server also probable has a maximum file size limit, then if yous set something hither and users nonetheless cannot upload files of that size, contact your host to accept the server file size limit increased.
Minimum File Size
Prepare the minimum size of the file that can exist uploaded here. This setting defaults to MB
Immune File Types
This setting creates a whitelist of the types of files that can be uploaded by file extension (i.eastward. .pdf, .jpg, .png, .xls, etc). With data entered into this setting, users volition be able to upload files of that type only.
Display Settings
Clarification
Whatsoever text entered hither will appear between the label and the field.
Select File Button Text
Past default, the text that appears on the File Uploads button when viewing the form will read "Select Files". That tin can be inverse to whatsoever you similar here.
Bear witness Advanced Features
To run across these features, you will demand to enable Developer Style in Ninja Forms' settings.
Display Settings
Custom Course Names
- Container: Text entered here applies a custom HTML grade to this field's wrapper
- Element: Text entered hither applies a custom HTML course to this field'southward element
Assist Text
Entering text hither will display an informational icon side by side to the field label. When a user hovers over information technology, a pocket-sized window will appear containing this text.
Advanced Settings
Label Position
Changes the orientation of the field characterization relative to the field element (above, below, left, correct, hidden)
Administration Settings
Field Key
A unique programmatic fundamental that tin can be used to place and target your field for custom evolution. Ane is generated for each field automatically, and this is what you lot see pre-populated in the setting. It can be changed, though doing so will not update it in anything y'all've already written.
[Leap to top]
Attaching an uploaded file to an email
This can exist accomplished in two ways, the first method via merge tag, which will and then create a link to the file(due south) uploaded in the received email.
Sending a download link with the e-mail
- From the Emails and Actions tab, edit the electronic mail activity past clicking on the action's gear symbol. From hither, click the merge tag button located in the E-mail Message line, shown below.
Attaching the file(s) to the email
The second method will attach the file(south) itself to the email itself.
- From the Emails and Actions tab, edit the email action by clicking on the action's gear symbol.
- From the pull out drawer, scroll downwards to the Advanced tab and click to drop downwards.
- And then actuate (click) the Adhere File Uploads toggle.
[Leap to top]
Saving uploaded files to Dropbox, Google Bulldoze, or Amazon S3
This process requires 2 steps: i) adjusting plugin settings and 2) adjusting form settings
1. Setup your plugin settings to transport uploaded files to an external service
Connecting Ninja Forms to Dropbox
To connect Ninja Forms to Dropbox, go to Ninja Forms > File Uploads > External Settings tab and click on the Connect button
Dropbox volition create a default directory of Apps/NinjaFormsUploads within your Dropbox business relationship. While this cannot be changed, y'all tin can use the File Path setting hither to define a custom directory within that file path for this upload field.
Connecting Ninja Forms to Amazon S3
- Open the IAM console inside your Amazon S3 account
- In the navigation pane, choose Users. Then choose your IAM user name.
- Choose the Security Credentials tab and then cull Create Access Key.
- To retrieve your Admission Fundamental and Underground Key, choose Show User Security Credentials.
- Choose Download Credentials, and store the keys in a secure location.
- Go to Ninja Forms > File Uploads > External Settings tab and enter your Access Key ID and Secret Access Key
- Alternatively yous tin can define your Access Key ID and Hush-hush Access Key as constants in wp-config.php:
define( 'NF_FU_AMAZON_S3_ACCESS_KEY', 'xxxxxxxxxxxxxx' ); ascertain( 'NF_FU_AMAZON_S3_SECRET_KEY', 'xxxxxxxxxxxxxxxxxxxxxxxxxxxx' );
- If your bucket is prepare as private you will need to add this code snippet to an mu-plugin file, eg. wp-content/mu-plugins/ninja-forms.php (the mu-plugin directory might need to exist created if information technology doesn't exist):
<?php add_filter( 'ninja_forms_uploads_s3_acl', function () { return NF_FU_External_Services_S3_Service::ACL_PRIVATE; } );
Connecting Ninja Forms to Google Drive To connect Ninja Forms to Google Bulldoze, get to Ninja Forms > File Uploads > External Settings tab and click on the Connect push button in the 'Google Drive Settings' box. Name the folder you want your file uploads to be stored in using the File Path setting. Whatever you type hither will exist the name of the folder in Drive. If you leave this setting blank, files will get straight to your general My Drive area and volition not be placed in a folder. Share with Google Drive 
You tin right-click the folder where the files are beingness uploaded and click "Share with Google Drive" Then click the avant-garde settings in the bottom-right and change access to anyone that has the URL.
ii. Setup your course to transport uploaded files to an external service
At present that yous accept your plugin configured to transport to either Dropbox or Amazon S3 (step i), y'all demand to add and configure an External File Upload action on the form itself. Open up your form and navigate to the Emails & Actions tab, and so click the blue circle/+ in the bottom right corner to add a new action.
Under the External File Upload Action, y'all can cull the service you would like the files from your course to salvage to.
[Leap to acme]
File Uploads General Settings
Access these settings in your WordPress dashboard under Ninja Forms > File Uploads.
Browser Uploads
This tab allows you to view or delete all uploaded files that have been saved to your server. Yous tin can sort past class or past date.
Upload Settings
- Max File Size (in MB) – The Max File Upload size allowed per grade.
- File upload error message – The Error Bulletin that the user receives when the Max File Size is met.
- Custom Directory – Is used to create dynamic directories.
If yous migrate from some other server and the File Uploads path is pointing to the older server location, you can deactivate then reactivate your File Uploads and Ninja Forms plugins to reset the file path.
Avant-garde Functionality
Delight annotation that modifying your add-on with custom code is outside the scope of support that we are able to provide. Notwithstanding, this department provides solutions to highly specific apply cases of File Uploads that may come in handy if you find yourself needing them!
Sending a straight link to the public URL of a file uploaded to External Services
To enable a direct link to the public URL for the uploaded file on Dropbox, Google Drive, or Amazon S3, plough on 'Employ Public URL' setting in Ninja Forms > File Uploads > External Settings
Allowing file types in File Uploads that are not usually allowed by WordPress
For security purposes, File Uploads only allows the upload of file types that WordPress allows. Yet, this list of file types can be amended with the 'ninja_forms_upload_mime_types_whitelist' filter.
If Allowed File Type is Setup If Immune File Type is not Setup
Add together to functions.php
add_filter( 'ninja_forms_upload_mime_types_whitelist', 'my_ninja_forms_upload_mime_types_whitelist' );
part my_ninja_forms_upload_mime_types_whitelist( $types ) {
return $types;
}
add_filter( 'ninja_forms_upload_check_mime_types_whitelist', '__return_false' );
Copy & paste both the function and the filter if y'all set up the immune file types – File Uploads > Restrictions > Permit File Types – inside the File Uploads field of your course.
Include add_filter( 'ninja_forms_upload_mime_types_whitelist', 'my_ninja_forms_upload_mime_types_whitelist' );
role my_ninja_forms_upload_mime_types_whitelist( $types ) {
return $types;
}
Note: The WordPress uploads folder is accessible by default on WordPress installations. To limit access to the WordPress Uploads folder, you may want to use an .htaccess file.
File Upload Addition Tutorials!
Source: https://ninjaforms.com/docs/file-uploads/
0 Response to "How to Allow Users to Upload Documents Wordpress"
Post a Comment