Arfaly Gold Upload & Share with no limit

Documentation version 1.1


Table of Content


Arfaly Gold is a professional Wordpress plugin that adds unlimited responsive and cohesive upload and share capabilities to your website, with Arfaly Gold you can create and build beautiful forms and uploaders; and, also you can select, archive, export, and securely share files to the social media with security protection option.

What Arfaly Gold can do for your website?

  1. Do you have valuable content to share? Arfaly Gold will help you boost your traffic by providing export media feature and social integration where users can download and forward your shareable content to five most commonly used social media channels (Facebook, Twitter, Linkedin, Google+, and Pinterest
  2. It can easily fit your culture. Arfaly Gold has been translated into 6 different languages (Eglish, Arabic, French, Spanish, Russian, and Chinese).
  3. It works as a download manager, where you can select, archive, and share any files with users; and, Arfaly Gold will track the number of downloads and other details for you.
  4. It works as an upload manager, with strong front-end uploader.
  5. Easy to integrate to other plugins through hooks. See Developer section.
  6. It allows you to easily interact with your users, whether guests or members.
  7. It allows you to exquisitely collect digital files through a responsive and multi-styled uploader, that accepts multi-file uploads up to 2GB of size bypassing all host restrictions through Chunk Upload feature.
  8. It provides responsive and professional looking email notification for new user uploads with customization option.
  9. It provides an isolated dashboard to review & approve new uploads
  10. It is integrated to one of the most modern and uprising dynamic and free Form builders (Caldera Forms). With this integration you can create custom forms and associate Arfaly uploaders with them.
  11. It scales wordpress file type filters and allow more radical file types to be uploaded and accepted in your Wordpress website
  12. SEO optimization for the secure download page.
  13. It provides strong export functinoalities that enable you to archive, and download any patch of files you need.
  14. It can export files orderly according to Wordpress Upload folder strcuture (YYYY/MM).
  15. Many more

How to Install #back to top

This section describes how to install the plugin and get it working. To learn how to do Wordpress Installation, watch the video.


Uploading the plugin in WordPress Dashboard

  1. Navigate to the 'Add New' in the plugins dashboard
  2. Navigate to the 'Upload' area
  3. Select arfaly-gold.zip from your computer
  4. Click 'Install Now'
  5. Activate the plugin in the Plugin dashboard

Using FTP

  1. Download arfaly-gold.zip
  2. Extract the arfaly-gold directory to your computer
  3. Upload the arfaly-gold directory to the /wp-content/plugins/ directory
  4. Activate the plugin in the Plugin dashboard

Create Arfaly Uploader #back to top

Create an uploader

Go to Arfaly Gold menu in the dashboard, you will find a submenu "Add New Uploader", click over it to create a new instance.

Arfaly Gold is a result of an above 2 years of a collective and colloperative legacy Media management code base. Arfaly Gold is a centric digital Media clearing house that work in harmony with any Wordpress website. Now Arfaly Gold can be integrated to one of the most uprising free and professional form buider solution (Caldera Forms).

Arfaly Gold Uploader - Features

  1. Upload notification enabled through EMail
  2. Allow diverse MIME (File Types) that are not originally accepted by Wordpress
  3. Isolated media section for review and approve
  4. Accept (Documents, Audio, Video, Music, and Archives)
  5. Frontend upload preview and delete
  6. Responsive design that will make the uploader works with (Mobile, Tablets, and Desktop)
  7. Global and local setting capabilities
  8. Cross browser compatibility (IE 9+, Firefox, Chrome, Opera, Safari)
  9. Unlimited instantiation of Arfaly uploaders with independent settings
    1. Max upload size
    2. Max upload limit per session
    3. Customize theme and colors
    4. Allow guests to upload
    5. Filter extensions
    6. Enforce title and description submission along with uploads
    7. Debug mode
    8. more
  10. Drag and Drop
  11. AJAX progress indicator

Customize uploader's options

Option Default Description
Allow website guests to upload files false By checking this box, visitors will be authorized to upload digital files in whatever instance you created.
Enforce information submission false Force user to send Title and Description for every file he uploads
Information submission is required false This option define whether user must submit information (Title/Descirption) or not.
Disable Drag & Drop effect false Checking this option will remove drag and drop effect, and convert it into regular HTML multi-upload button
Enable circular dropbox effect false This is a beta option for administrator that wants to play with the shape of uploader's container in the fron-end. Check if it works for you.
Max file size (MB) '10 MB' Define the maximum file size limit for users.
Max file upload count '10' This option allow you to control how many uploads the users can do for every single session.
Strictly allow extensions '' Allow only the extensions given (Use comma seperator). Leave it empty to allow WP default mime list.
Debug false Enable debugging for trouble-shooting.
Debugging info target '' Only works if Debug is enabled. Target HTML element, for class name add "." letter prefix. For ID based targeting put "#" letter.
Uploader message '' Give users direction message. Tell them what file should be uploaded, and add extra notice if neede.
File Title placeholder '' Only works with enforce submission option being enabled. Customize title placeholder
File Description placeholder '' Only works with enforce submission option being enabled. Customize description placeholder.
Theme Options 'section' Options related to uploader look and feel.

Plugin prerequisite for form integration #back to top

Caldera Froms

If you want to build custom and responsive forms that include Arfaly Gold Uploader, then you need to download Caldera Forms which we fully integrate our uploader in it.

Caldera Forms - Tutorial (Basic)

Learn how to make a responsive contact form for your WordPress site that looks great on any device using Caldera Forms.

Caldera Forms - Tutorial (Advance)

Learn to use conditional fields and calculation fields to make complex WordPress registration forms, payment forms and more with Caldera Forms.

Create beautiful, responsive forms with a simple drag and drop editor. Caldera Forms is a diffrent kind of WordPress form builder. With its intuitive drag and drop interface, it's never been easier and less stressful to create forms for your WordPress site that look awesome on any device. The visual editor simplifies form building for WordPress. Set up your form with multiple columns, add additional pages, and funnel user responses with conditional logic to get more robust data and relevant information from your customers and visitors..

Arfaly Gold Form Integration #back to top

With our File Upload Field, you can have your users upload documents, photos and other media along with the other data you collect from them Caldera forms. This makes it really convenient to ask for screenshots on a Customer Support Form or accept videos, music, and resumes in PDF or Word on an Employment Application form. The possibilities are endless when you can easily accept and store files from your users.

Drag & Drop Arfaly Upload Element

As shown in the picture, you will just need to drag and drop Arfaly Gold Upload element into your custom form to start the fun.

Configuring Arfaly Gold Upload

As any other Form element in Caldera, you need to give your element a name; then, you can magically select ready and pre-configured Arfaly Gold Uploaders from the Dropdown box highlighted in red in the figure shown above. So all of your configuration of the uploader will be inherited from Arfaly Gold Upload section, and you can reasily tune your configuration at any given time to change the behaviour, GUI and constraints of your selected uploader.

Preview the form

The above picture shows how a test form looks at the front-end. If you want to quickly play around with the plugin and create this same form, you will find a ready template for it once you create a new form at Caldera, the form template name should be found as "Registration Form". You will also find a basic Contact Us form as a template when you create a form.

Here we have given a guidance pertaining on where and how you can find Arfaly Gold Upload form element for Caldera. As all of the basic and advanced tutorial on how to create a form has already been discussed in the previous Section

Media File Export & Share #back to top

In this section you will learn how you can work and fully utilize Media File Export functionalities.

Media Exporter Page - #back to top

With Media Exporter page, you can select, archive and download files from two different sources. You can switch between Arfaly Gold source and Wordpress Media source, where by selecting Arfaly Gold source you will only see those files uploaded through your Arfaly uploaders, and by selecting Wordpress Media source, you will see all of the current Media files in your website.

How you can download
  • Step 1 - Make sure you select the right Media source from the select media section.
  • Step 2 - After you select the right source you can search, sort, and filter files from the table, then check whatever files need to be downloaded.
  • Step 3 - After checking the right files for download, you can now download the files through two options. You can either click over (Archive & Download) to get a patched ZIP files with all of your files archived inside, or you can click over (Structured Archive & Download) to basically structure your downloaded files based on YEAR/MONTH exactly as Wordpress structure its Media Files inside of Upload folder.

Shareable Archives page - #back to top

With Arfaly upload you can securely share whatever files to (Facebook, Twitter, Linkedin, Pinterest, and Google+) through Share archives page. And to create shareable archives, you need to do the same steps shown for Exporting files in Media Exporter tab with slight difference in action selection.

How you can create a shareable archive
  • Step 1 - Go to Arfaly Gold -> Share & Export -> Media Exporter, then select your files as previsouly described.
  • Step 2 - Once you check all of the files you need to share, find Create shareable archive section and give your shareable a paassword and expiry date if needed and then click Archive.
  • Step 3 - Now all of the shareable that you have created from Media Exporter tab, will be found in Share archives tab.
  • Step 4 - Now you can delete, and copy links and share them for any archive you want using Actions column. Also you can copy shortcode and place them anywhere inside of your website for users.

Secure download page - #back to top

Click over the thubnail shown above to see the look and feel of the download page once user clicks of your shared links.

By providing valuable content Arfaly Gold will help generating traffic to your website by providing social media integration where users can forward your shareable content to five most commonly used social media channels.

You can also copy shortcodes from Share Archive tab, and then style it and place it whenever you like in your website. Basically these shortcode button will redirect users to the secure download page

Arfaly Gold Reports #back to top

.

Understand Your Data

Arfaly Gold does not give you only the functionalities, but it tries to help you understand the user interaction, workflow and the used resource allocation. With a responsive and intelligent Arfaly Gold Report page you can get comperhensive statistics about top uploaders, upload types, and about how many files need to be reviewed by the management. Furthermore, all of the aforementioned statistics can be generated for a specific custom date range through the form shown above.
  • Step 1 - Select your desired date range from the top left corner of the page.
  • Step 2 - Click Update button and wait for the results to be projected.
  • Note - By default the date range will be set to the last 6 months.
  • Note - By default the date range will be set to the last 6 months.

Responsive design

Arfaly Gold has been developed to provide maximum convinience to the website moderators. And for that reason, you can easily check this user-friendly report page through your mobile and tablet devices

How to Use Settings Panel #back to top

General Options - #back to top

From here you can enable Form Integration if needed, otherwise you will not find our field inside of "Caldera Forms" plugin. Also you can enable Email notification along with the message template that you want to send


Filter File Types- #back to top

From this setting tab you can add new file types to force Wordpress to support it in the system. If you have extra radical file types that are not listed here, please check Developers section to know how you can add new file types.

Support Desk #back to top

Please remember you have purchased a very affordable plugin and you have not paid for a full-time web development agency. Occasionally we will help with small tweaks, but these requests will be put on a lower priority due to their nature. Support is also 100% optional and we provide it for your connivence, so please be patient, polite and respectful.

Please visit our profile page or ask question @mindsquare

Support for my items includes:
  • * Responding to questions or problems regarding the item and its features
  • * Fixing bugs and reported issues
  • * Providing updates to ensure compatibility with new software versions
Item support does not include:
  • * Customization and installation services
  • * Support for third party software and plug-ins
Before seeking support, please...
  • * Make sure your question is a valid Plugin Issue and not a customization request.
  • * Make sure you have read through the documentation and any related video guides before asking support on how to accomplish a task.
  • * Try disabling any active plugins to make sure there isn't a conflict with a plugin. And if there is this way you can let us know.
  • * Almost 80% of the time we find that the solution to people's issues can be solved with a simple "Google Search". You might want to try that before seeking support. You might be able to fix the issue yourself much quicker than we can respond to your request.
  • * Make sure to state the name of the plugin you are having issues with when requesting support via CodeCanyon.

Files & Sources #back to top

Included JavaScript

These are the various attribution links to the Javascript files included or modified to work with in this plugin. All included JavaScript codes under arfaly-gold/widgets/assets/js/

  • 1. chart.js - Generate professional charts
  • 2. clipboard.js - Facilitate copying
  • 3. goodshare.js - Share to social media
  • 4. jquery.counterup.js - Animate numbers
  • 5. jquery.daterangepicker.js - Daterange picker
  • 6. moment.js - As a helper for daterange picker
  • 7. tooltip.js - Add help tooltip all around
  • 8. jquery.datatables.js - Populate information in filterable professional tables

Developers #back to top

For those who are intersted on integrating Arfaly Gold Uploader and its features with their own code. Here is some useful hooks and action that you can use:

Useful Uploader Hooks


							// This should fire when an image been approved
							add_action('arfalygold_media_approved', 'YOUR FUNCTION');
							  
							  
							// This should fire when a file gets uploaded successfully
							add_action('arfalygold_file_uploaded', 'YOUR FUNCTION', 10, 4);
							    // Your hook function would intercept 4 parameters ($att_id, $arfalygold_id, $user_id, $att_size)
								// $att_id: Attachment ID of the file has been uploaded
								// $arfalygold_id: Unique ID for the uploader that has been used for uploading.
								// $user_id: The user who uploaded the file
								// $att_size: Uploaded file size
								
							// This action will be fired only one for each user, regardless of how many files has been uploaded
							// It is been used to notify admins about new uploads each time a new user uploads files.
							add_action( 'new_arfalygold_files_uploaded', 'YOUR FUNCTION' );
							
				        

Useful Download Hooks

							// This should fire when new shareable package has been created by Administrators
							add_action('arfalygold_new_shareable_created', 'YOUR FUNCTION', 10, 1);
							
							// This should fire whenever user or a guest has downloaded a package that has been shared through your website
							add_action('arfalygold_shared_file_downlaoded', 'YOUR FUNCTION', 10, 1);
				        

If you are intersted to have more hooks and integration capabiliteis, please create a ticket under Developer Reguest Help Topic and we will be more than glad to help.

Need more hooks Create a ticket

Allow new file types that are not exist in Settings

If you have any radical file type that does not been supported by default; then, all you need to do is to access the functions.php file under your domain/wp-content/plugins/arfaly-gold/includes/arfaly-lib/functinos.php. Then you can append new file types to "$mimes_exts" array according to the below shown code, and to be able to know what is your file type exact MIME, you can visit this link: MIME list

							function itech_arfalygold_get_mime_types() {
								// Generated with dyn_php class: http://www.phpclasses.org/package/2923-PHP-Generate-PHP-code-programmatically.html
								$mimes_exts = array(
									'zip'=>
									array(
										'label'=> __('Compressed File', ARFALY_GOLD_TEXT_DOMAIN),
										'mimes'=>
										array(
											'application/zip',
											'application/octet-stream'
										),
									),
									'rar'=>
									array(
										'label'=> __('Compressed File', ARFALY_GOLD_TEXT_DOMAIN),
										'mimes'=>
										array(
											'application/x-rar-compressed', 
											'application/octet-stream'
										),
									));
				        

Version History (Changelog) #back to top

Once again, thank you so much for purchasing this plugin. As I said at the beginning, I'd be glad to help you if you have any questions relating to this plugin. No guarantees, but I'll do my best to assist. If you have a more general question relating to the plugins on Codecanyon, you might consider visiting the forums and asking your question in the "Item Discussion" section.


Changelog


						-----------------------------------------------------------------------------------------
						Version 1.6.0 - Jan 25th, 2016
						-----------------------------------------------------------------------------------------
							- Added email notification setting to configure images icon
							- Added social message configuration options
							- Fixed Android & iPhone background image styling
							- Added new uploader options to control the text inside the box
							- Fixed hashing issue when using similar password
							- Fixed expiry date bug
							- Fixed documentation index miss-pointers
							- Fixed the Arfaly-Gold form filed-processor for Caldera
							- Removed an extra hidden input field from Arfaly-multi.js


						
						-----------------------------------------------------------------------------------------
						Version 1.5.9 - Jan 7th, 2016
						-----------------------------------------------------------------------------------------
							- Download manager (Download link for all media, or through a filter)
							- Created a new report widget
							- Created a new export widget
							- Download hits for front-end shortcodes
							- Shorten link and share option through (Twitter, Facebook, Linkedin, and others)
							- Support shareable archive saving with expiry date handle
							- Added circular dropbox option
							- Added recording table
							- Fixed js/css for multiple mult-uploaders
							- Added change upload icon option
							- Fixed enforce information field miss-behavior
							- Added required option
							- Upload process enhancement
							- Wordpress Media file title/description will change according to information submission

						-----------------------------------------------------------------------------------------
						Version 1.6.1.2 - April 8th, 2016
						-----------------------------------------------------------------------------------------

							- Fix name duplication issue that prevents two files with similar name to be overwritten.
							- Add more stability
							- Fixed email template and make it more responsive
							
						-----------------------------------------------------------------------------------------
						Version 1.6.1.3 - April 11th, 2016
						-----------------------------------------------------------------------------------------

							- Enhance HTTPS Compatibility.
							- Moved shareable files to "wp-content/upload/arfaly-gold-uploads" to be reserved even after the plugin is been updated.
							- Optimized check restricted files to give an error notification right from the first instance.
							- Adding smart chunk upload slicing algorithm that will optimize the number of chunks according to the size of the uploaded file.
							- Enforce download template to be unique and not influenced by any external styles or libraries.
							- Overall enhancements.

						-----------------------------------------------------------------------------------------
						Version 1.6.1.4 - April 12th, 2016
						------------------------------------------------------------------------------------------ 

							- Amend required field behavior issue and make it fully compatible with the last Caldera update.
							- Now developer can set Arfaly Uploader field to be either required or not required with no problems.
							- Wordpress 4.5 Compatibility updates