Closify Press Acquire & play with images like a maestro

Documentation version 1.1


Table of Content


Closify is a wordpress plugin, that has a comperhensive image storing and processing features, it comprises of backend management panel where you can create unlimited number of two modes image uploaders that conceptually work as album containers, the first mode is for uploading single image with predefined dimensions, and the second mode is for uploading multiple images in a single shot. Closify accepts wide range of image type (PNG, JPEG, GIF, PSD, AI, EPS, SVG, TIFF and BMP). Administrator can place multi/single image uploaders using automatically generated shortcode. The plugin is responsive, rich, and intelligent with flexible and intuitive backend front-end elements.

What is unique about Closify that it does record all of the uplading images for each registred user, so that it can build dynamic and live gallery in a form of modern HTML/CSS collage that has 6 different effects. The galleries can be gathered and built using a convenient shortode generator "Closify Editor Plugin" for TinyMCE. Using shortcode generator for galleries, you can build galleries based on three filter elements (Albums, Usernames, and Roles).

What Closify Press can do for your website?

  1. It provide a custom uploader with a convinient modern image collector.
  2. Closify helps you manage image uploads seperately through a strong backend approval system, so that you can make sure no images will display into a dynamic live gallery without approval.
  3. It supports upload auto-approval in case your confident was high enough for the users.
  4. It support responsive Email notification for new uploads.
  5. Developer friendly, developers will have many Wordpress filters and actions that they can use to extend this plugin to a higher degree.

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 closfy-press.zip from your computer
  4. Click 'Install Now'
  5. Activate the plugin in the Plugin dashboard

Using FTP

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

Create Closify Uploader (Album) #back to top

Create an uploader

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

Closify Press deemed to be a Media clearing house that work in harmony with any Wordpress website.

Closify Uploader - Features

  1. Upload notification enabled through Emails
  2. Allow diverse (Image Types) that are not originally accepted by Wordpress
  3. Isolated media section for review and approve
  4. Accepts (PNG, JPG, AI, PSD, EPS, SVG, TIFF and BMP)
  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 Closify uploaders that has it own segregated 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. Three different skins for Multi-image uploader to almost suite any website theme.
  11. Drag and Drop
  12. AJAX progress indicator

Multi-image 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
Disable Drag & Drop effect false Checking this option will remove drag and drop effect, and convert it into regular HTML multi-upload button
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.
Allowed images/graphics '' Strictly select what type of images you need this uploader to accept.
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.

Single predefined dimension image uploader's options

Option Default Description
Description empty Give your Closify a description for future and cross reference.
Allow guests false Give guests permission to upload photos and images. Note that there is no upload track records for guests.
Enforce information submission false Force user to send Title and Description for every file he uploads
Image container's width & height '200' x '200' Define your desired image dimension to force the users to meet this constraint, and have a nice and ready made images uploaded right to your Media Library
Max File Size '10 MB' Restrict users with max image size constraint.
Progress Bar true By setting this option to "true", a progress bar feature will be enabled for the image uploader.
Responsive container false Make the uploaded image container to be responsive. Note, when the container get shrinked, the image upload will be inacurate. This feature tend to be used in future version updates.
Styling Options '' The rest of option are all related of styling and formatting the image uploader.
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.

Create a multi-image uploader


Create a single predefined dimension image uploader


Review & Approve Page

Generate Dynamic Live Galleries #back to top

In this section you will learn how you can generate library by using cross-filtered selection table.

TinyMCE Closify Plugin - #back to top

First you go to your target page or post and find the Closify Editor plugin as shown in the picture.

The gallery builder page - #back to top

With Closify you can securely build live galleries, that feed itself from specific albums. And to create a dynamic gallery, all you need to do is to click over the Closify Plugin button, and then do the following steps:

How you can create a dynamic collage
  • Step 1 - Select the desired effect for your collage.
  • Step 2 - Check "Disable Caption" option if you don't want to display image descriptions.
  • Step 3 - Select the Closify Albums (uploaders) in which your gallery should be fed from.
  • Step 4 - Now filter your gallery from Closify Albums according to specific uploaders, in which only those images uploaded by user (x, y, and z) will be displayed.
  • Step 5 - This step will overrule the previous one, and it basically simplify filtering images by roles instead of usernames. This feature will be much more effective when you have a sommunity with thousands of users and you need to display images only for those who has special roles.

Insert gallery shortcode - #back to top

After you finish from configuring your gallery, find a button called "Insert" at the very bottom of the Gallery Builder page shown on the left. Click over "Insert" button to have your shortcode placed inside of editor box.

Here is a sample Closify Collage been generated to display images. To see live demo click "HERE"

Get introduced to Front-end uploader's GUI#back to top

.

Single image uploader with predefined dimension

Responsive Multi Image uploader

How to Use Settings Panel #back to top

General Settings - #back to top

From here you can do the following:

  • Enable email notification and change notification logo, email content, and recipient email.
  • Tweak gallery thumbnail sizes to optimize performance.
  • Enable upload auto-approve in case your confident rate was high for the users.

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 convenience, so please be patient and considerate.

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 closfy-press/widgets/assets/js/

  • 1. jquery.js
  • 2. imagesLoaded.js - Generate professional charts
  • 3. Iconmoon
  • 4. arfaly.js - Responsive javascript uploader
  • 5. jquery.datatables.js - Populate information in filterable professional tables

Developers #back to top

Animation for possible technical implementation

Please right click over the video and click play to loop back the animation if it ends.

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

Useful Uploader Hooks


							// This should fire before image is been put in processing pipeline
							add_action('closify_image_pre_process', 'YOUR FUNCTION', 10, 1);
							   Argument Passed: $img_src
							
							// This should fire right after the processing pipeline is finished, so you can add your last touches here on the image if you want
							add_action('closify_image_post_process', 'YOUR FUNCTION', 10, 1);
							   Argument Passed: $img_src
							   
							// This should fire right before the single uploaded image get resized
							add_action('closify_image_pre_resize', 'YOUR FUNCTION', 10, 1);
							   Argument Passed: $img_src
							   
							// This should fire right after the single uploaded image get resized
							add_action('closify_image_post_resize', 'YOUR FUNCTION', 10, 1);
							   Argument Passed: $img_src
							   
							// This should fire before cropping the single uploaded image
							add_action('closify_image_post_cropping', 'YOUR FUNCTION', 10, 1);
							   Argument Passed: $img_src
							   
							// This should fire after cropping the single uploaded image
							add_action('closify_image_pre_cropping', 'YOUR FUNCTION', 10, 1);
							   Argument Passed: $img_src
							   
							// This should fire if the user used iPhone, Android, or any other mobile phone and the plugin intelligently reorient the image before processing
							add_action('closify_image_oriented', 'YOUR FUNCTION', 10, 4);
							   Argument Passed: $reorientation_angle, img_obj, currWidth, currHeight
							   
							// This should be fired whenever temp images are been purged
							add_action('closify_temp_images_after_cleaning', 'YOUR FUNCTION', 10);
							   Argument Passed: NONE
							
							// Enable developers to modify all galleries before they get rendered
							FILTER: closify_gallery_pre_render ($img_array) 
							
				        

Add Fixed Gallery Item using (add_filter)

							// As an example, we will use 'closify_gallery_pre_render' filter to add Google logo at the end of every gallery we post in Wordpress
							add_filter('closify_gallery_pre_render', 'add_static_image', 10, 1);
							
							function add_static_image($gallery)
							{
								$gal['full'][] = array('https://www.google.ca/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png');
								$gal['thumb'][] = array('https://www.google.ca/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png');
								$gal['img_title'][] = 'This is a test title';
								  
								return $gal;
							}
							
							
				        

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

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


						= 1.3 (2014-11-12)
							- Initial release (Read docs for more detailed information)

						= 1.4 (2014-12-10)
							- Fixed horizontal minor image upload bug
							- Fixed typo in configuration page
							- added two new shortcode attributes (user_id + disable_menu)
							- Fixed progress bar styling

						= 1.5 (2014-12-11)
							- Increased multi-image upload performance
							- Eliminate temp file needs for multiple uploader
							- Added support for (eps, tif, ai, psd and svg)
							- Extra enhancements

						= 1.6.1
							- Complete code redesign for the single image uploader
							- Complete responsive mobile handling redesign with quality test
							- Now uploaded images are all been stored in a temporary location
							where every image need to be reviewed & approve before it get
							stored in Media Library.
							- Update theme options
							- Performance improvement
							- Mobile touch fixes for iOS/Android
							- Add disable preview option
							- Changed initial button opacity to 0.8
							- Fixed multi-image uploader initial generation error
							- Remove responsive option

						= 1.6.2
							- Removed faulty responsive feature
							- Added enforceInfo option for both Single/Multi uploaders
							- Now user can add title and description that will be stored with the attachment
							- Replaced Touch-Punch and jquery-ui with wordpress native options
							- Add Thickbox effect for closify
							- General enhancements
							- Expand mobile support

						= 1.6.3
							- Secure the plugin against the XSS vulnerbility for WP 1.4.1
							- Compatible with 1.4.2
							- Fixed the iOS hidden input text issue by removing no-select.
							- Adding new shortcode to build collage for user images, not finished "needs finalization"
							- Fixed font css loose declaration
							- Compress libraries (JS, CSS)
							- Unify font styles and files, and fixed minor CSS issues
							- Fixed post_status problem, to fix non-approved files visibility problem.

						= 1.8 (2015-09-21)
							- Add gallery builder feature
							- TinyMCE plugin for closify to facilitate building flexible galleries
							- Add email notification feature for new uploads
							- Add auto-approve feature
							- General improvement for code base
							- Add two new themes for multi-image uploader
							- Add building collage capability with 6 different effects
							- Add lightbox integration for gallery display

						= 1.9 (2015-10-04)
							- Added new flexible table to record upload information
							- Fixed multiple multi-uploader drawbacks
							- Enhanced the overall operations and performance

						= 1.9.1
							- Added version to js files and css

						= 1.9.2.5:

							- Auto-rotate fix for iOS & Android devices. Now the plugin automatically fix the orientation of the image according to EXIF information.
							- Adding new valuable filters and actions
									- EVENTs, ACTIONS, FILTERS & HOOKS
									 ACTION: closify_image_pre_process (img_src)
									 ACTION: closify_image_post_process (img_src)
									 ACTION: closify_image_pre_resize (img_src)
									 ACTION: closify_image_post_resize (img_src)
									 ACTION: closify_image_pre_cropping (img_src)
									 ACTION: closify_image_post_cropping (img_src)
									 ACTION: closify_image_oriented (angle, img_obj, currWidth, currHeight)
									 FILTER: closify_gallery_pre_render ($img_array) // Enable developers to modify all galleries using this filter
									 ACTION: closify_temp_images_after_cleaning()
							- Major security updates
							- Code restructuring and stability increase
							- Enhance TinyMCE initialization and registration logic to match Wordpress Standards
							- Rectified Closify upload media table list style
							- Fixed upload location miss-target, and now any new upload will land in the corresponding yyyy/mm folder under /uploads folder