ZoomFolio WordPress DZS

Created: 03/04/2016
Author: Digital Zoom Studio
Twitter: http://twitter.com/
Facebook: http://facebook.com/dzs
Support - via item comments
Thank you for purchasing our component. If you have any questions that are beyond the scope of this help file, you can ask them in the Item Discussions.

Intro - top

DZS ZoomFolio is the ultimate plugin for displaying your creative portfolio to your clients and that's not all. You can use it to show the recent posts from your blog or a gallery from your vacation. The possibilities are endless. And the backend helps you do just that in a easy way. Uses the WordPress's Custom Post Types for you to create Portfolio items in the WordPress intuitive way. It's based on shortcodes, but there is zero effort to understand how you customize it because there is a intuitive Shortcode Generator bundled that does just that for you.

Features

What do you get?

 

 


Installation - top

There are two ways to install the plugin

Method 1 - Direct WordPress Install

  1. Just download the zip from your http://activeden.net/user/yourusername/downloads directory in a folder of your choosing.
  2. Then in your wordpress installation, in the Plugins panel, click Add New like in this picture:


  3. Then click Upload, and select the zip you have downloaded from CC. Then click Activate.
  4. Create Portfolio Items from your dashboard > Portfolio Items
  5. Access any post / page and you should now see this icon above the editor
  6. This launches a editor in a lightbox that generates the shortcode based on the options you select. Start cusomizing to your needs. Have fun!

Method 2 - FTP Install

  1. Just download the zip from your http://activeden.net/user/yourusername/downloads directory in a folder of your choosing.
  2. Unzip it with your preffered unziping utility.
  3. Then, if the folder dzs-portfolio is zipped, unzip that too. The copy the folder in the wp-content/plugins folder. On Windows, there can be some warnings while unziping. Those are nothing to worry about if they appear, they are just Mac OS X files that cannot be read by Windows.
  4. Then in your wordpress installation, in the Plugins panel, locate DZS ZoomFolio and click Activate
  5. Create Portfolio Items from your dashboard > Portfolio Items
  6. Access any post / page and you should now see this icon above the editor
  7. This launches a editor in a lightbox that generates the shortcode based on the options you select. Start customizing to your needs. Have fun!

Recommended FTP client: Filezilla


This video should make it crystal clear on how to install and add some data

 


Adding to the Post / Page - top

  1. access / create your post / page
  2. use the shortcode generator to get a shortcode like this generated

    [portfolio skin="skin-default" sortable="on" settings_disablecats="off"]


  3. all done!

 

 


Customize - top

 

First of all,

The plugin is made to display your potfolio items. You can access them from your WordPress Dashboard > Portfolio Items and create as many as you wish. Don't forget to add the Featured Image in order for the thumbnail to appear.

The item structure

This is the skin-default item structure. The structure can differ from skin to skin, but this is the main idea of customization.

Shortcode Generator

This plugin is based on shortcodes. This popup that assembles when you push the Portfolio button will be reffered too as the Shortcode Generator - it includes most of the options you can customize. Once the Shortcode is generated, the parameters can be edited manually.

For reference, this is an example output by the Shortcode Generator, offcouse it can be manually inputed too.

[zoomfolio settings_mode="masonry" skin="skin-accordion" settings_specialgrid="none" settings_lightboxlibrary="zoombox" design_item_width="100%" fullscreen="off" settings_disablecats="off" settings_preloadall="off" design_categories_pos="top" settings_ajax="off" bgcolor="transparent"]

 

What does each option do ?

Features
Mode
Here you can set up the mode for the portfolio - there are 4 types - masonry, advancedscroller, simple, wall.
Skin
Here you can set up the skin for the portfolio - there are 6 types - skin-default, skin-clean, skin-blog, skin-accordion, skin-boxed, skin-corporate.
Special Grid
Here you can choose one of the five special grids - special-grid-1, special-grid-2, special-grid-3, special-grid-4, special-grid-5. For example, select a special grid like special-grid-1 where elments are always justified no matter screen size.
Item Width
The item's width, percent width is acceptable.
Item Height
The item's height, leave blank for auto width.
Order by
Here you can choose the type of ordering for the portfolio-items: date, title, random, meta-order.
Order
Here you can choose if the ordering for the portfolio-items should be ascending or descending.
Preload all elements
The portfolio will be visible only after ALL images will be loaded, using the ON option, or OFF for loading normally.
Background
Choose the background's color.
Hide Categories
You can either choose to display the categories or hide them, using the ON/OFF option.
Categories display
Categories display as normal or a dropown.
Disable item meta
Disable title and description (for a category mode for example) using the ON/OFF option.
Show layout chooser
Display 2 boxes for changing the layout using the ON/OFF option.
Make All Big Media Part of the Same Gallery ?
You can set a gallery on each Portfolio Item individually, but if you want all the items to be part of the same gallery, you can choose this to ON.
Categories Position
Choose where you want the categories to appear - TOP/BOTTOM. Note: categories only work in masonry mode.
Page Content Position
Choose where you want the page content to appear - TOP/BOTTOM. Note: page content only works in skin-clean mode.
Items to show
Here you can specify the visibility of certain items. Leave blank to show all items.
Endless scrolling
- If you want endless scrolling, you must set how many items would you like to show on every user load in the Items to show field.
Fullscreen
Choose either the portfolio should appear on full screen or normal using the ON/OFF option.
Lightbox Library
Choose the lightbox library: zoombox/prettyphoto. We HIGHLY recommend ZOOMBOX.
Categories
Check the categories which you would like to include in the post/page. Note: Categories only work in masonry mode; these are categories for the portfolio and wall mode, for the normal post type you have to input the categories id yourself.
Default Category
Check the default category. You can choose a default category at start.
Extra Classes -
Some extra classes to be added to the portfolio container - ie. delay-effects filter-grayscale.
Custom WPQuery Arguments
Advanced arguments to the query - like post_type=post or posts_per_page=4 or combine them post_type=post&posts_per_age=4.
Wall Items Per Row
Only for the wall mode - choose how many items should be on one row.
Wall Items Spacing
Only for the wall mode - choose the spacing between the wall's items.

 

 

What if I just want to display regular posts ?

When you access the Shortcode Generator, you will see a WordPress Query field. Write there the following code:

post_type=post

 

The Big Image

You may notice in some demos that you have the posibility to open a bigger image in a lightbox.

You can add Big Images by going to your specific Portfolio Item and populating the Big Image field with a link to a image. You can use the Upload button bundled in the package.

The item type

You'll notice the first meta option for each Portfolio Item is the Media Type

It can be a image, a gallery, an audio item etc.

After you select the type, instructions will appear underneath the Featured Media field on how to customize the item. Most items are set up from the Featured Media field.

Set up the item as a link

To setup an item as a link( that has all title and image as a link ) is very simple, just set up the Portfolio Item as a link by clicking this icon.

And input the link in the Featured Media field.

What does each option from DZS ZoomFolio Settings do ?

Featured Media
The path to the location of the image / if you have a featured image set, there is no need to input anything here.
Big Image
The path to the location of the image. Put here a bigger image of your project or a youtube video to describe your project in a lightbox.
Big Gallery
Make the big image part of a gallery. The different items on the same page with the same gallery name will have appear in the same gallery.
Disable Content
Disable the content in skin-clean and skin-accordion using the ON/OFF option.
Force Item Width
Here you can force a specific width for that item.
Force Item Height
Here you can force a specific height for that item.
Force Thumb Width
Here you can force a specific width for the thumb of this item.
Force Thumb Height
Here you can force a specific height for the thumb of this item.
Highlight Color
Here you can set the overlay color of the item (if for example the selected skin is skin-blog ) / leave blank for default
Skin Blog / Position Top Overlay
Here you can set the overlay initial top position. NOTE: Only for skin-blog.
Meta Order
Used only if orderby is set to meta order in the shortcode parameters. It will display the portfolio items based on the values of each portfolio item defined here.
Featured Area Links To....
Choose where clicking the featured area should go. You can choose one of the options: Big Image, Item URL, Custom Link, Nowhere.
Open Big Image In Lightbox
Choose if the Big Image should be open with a lightbox library, using the option ON/OFF.
Meta Area Links To....
Choose where clicking the featured area should go. ou can choose one of the options: Big Image, Item URL, Custom Link, Nowhere. You can input the custom link below.

Set it up as Wall Style and Fullscreen

 

You can follow the video below.

Set up Content Opener for skin-clean or skin-accordion

You can follow the video below.

Also note that to set the gallery on which each item open you can use the Item Gallery tab on each Portfolio Item.

This is the shortcode. Remember to set Misc Options > Maximum Number of Characters for Content to all in the shortcode generator

[zoomfolio settings_mode="masonry" skin="skin-accordion" settings_specialgrid="special-grid-3" settings_lightboxlibrary="zoombox" design_item_width="280" design_item_height="200" fullscreen="off" sort_order="ASC" settings_disablecats="off" disable_itemmeta="off" settings_preloadall="off" design_categories_style="normal" design_pageContent_pos="top" settings_specialgrid_chooser_enabled="off" design_categories_pos="top" settings_biggalleryall="off" orderby="date" settings_ajax="off" settings_ajax_loadmoremethod="button" cats="202" bgcolor="transparent" settings_mode_masonry_layout="masonry" design_total_height_full="off" settings_mode_masonry_layout_straightacross_setitemsoncenter="off" settings_excerpt_len="all"]

You also need to set Featured Media Link to Content Opener for ecah Portfolio Item / Post that you want to open the Content Opener.

The custom text on the right in the demo. You can just insert it in your post content.

<h4>Corporate Brouchure</h4>
<p>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo... <a href="#">[ Read More ]</a></p>
<div class="simple-hr-with-mb-20"></div>
<p><span class="meta-prop-label">Categories:</span> Illustration / Print</p>
<div class="simple-hr-with-mb-20"></div>
<p><span class="meta-prop-label">Date:</span> 14 Jul 2014</p>
<div class="simple-hr-with-mb-20"></div>
<p><span class="meta-prop-label">Project URL:</span> <a href="#">Live Preview</a></p>
<div class="simple-hr-with-mb-20"></div>
<p><span class="meta-prop-label">Share:</span> Illustration / Print</p>

 

 

 

What are the differences between the special grids?

Here you can see some screens with the visual aspects of the special grids:

Special-grid-none


Special-grid-1


Special-grid-2


Special-grid-3


Special-grid-4


Special-grid-5

Twitter Items

In order to retrieve twitter items, the plugin uses Twitter API 1.1 - which requires oAuth login. What that means for you, is you have to register a new application on this site - https://dev.twitter.com/apps/new - and supply the required fields inside Settings > DZS Portfolio Settings

Set it up as Media Gallery style (demo here )

It's very simple. First set up the skin to skin-boxed .Then you can select the type of each item ( as seen above ), hero images ( the icons in the center of the item ) will be set automatically.

Set it up as Scrolling Content style ( demo here )

Just set the mode to Advanced Scroller. All gallery items will be styled according to the

Import Skin Blog Example ( demo here )

A sample comes bundled with the plugin.

To install it, first import it via the WordPress Importer

How to install WordPress Importer

  1. access your WP Dashboard
  2. click Tools > Import
  3. choose WordPress as the import source
  4. click Install Now
  5. click Activate
  6. choose the import file

In this case, choose the dzs-portfolio/samples/skin_blog.xml

After the import is succesful ( remember, you need to have ZoomFolio activated ) you can place the shortcode found indzs-portfolio/samples/skin_blog.txt into any Page / Post.

 

How to set up YouTube videos with a cover photo ( thumbnail )

Setting up a YouTube video to appear in the portfolio is pretty straight forward. Just go the Portfolio Item from the Portfolio Items menu . Select the type to YouTube and in the Featured Media field input the youtube video id. And for the Featured Image, click the set Featured Image and choose a thumbnail. It will appear before the video plays.

Some Example Shortcodes

 

blog example with endless scrolling
[zoomfolio settings_mode="masonry" skin="skin-blog" settings_specialgrid="none" settings_lightboxlibrary="zoombox" design_item_width="280" fullscreen="off" sort_order="ASC" settings_disablecats="off" settings_preloadall="off" design_categories_pos="top" settings_biggalleryall="off" orderby="date" settings_ajax="on" posts_per_page="3" bgcolor="transparent"]

 

recent posts ( let's say 206 and 207 are your categories ids )
[zoomfolio settings_mode="masonry" skin="skin-default" settings_specialgrid="none" settings_lightboxlibrary="zoombox" design_item_width="280" fullscreen="off" sort_order="ASC" settings_disablecats="off" settings_preloadall="off" design_categories_style="normal" design_pageContent_pos="top" settings_specialgrid_chooser_enabled="off" design_categories_pos="top" settings_biggalleryall="off" orderby="date" settings_ajax="off" bgcolor="transparent" wpqargs=" post_type=post" cats="206,207"]

 

gallery shortcode
[zoomfolio settings_mode="masonry" skin="skin-default" settings_specialgrid="none" settings_lightboxlibrary="zoombox" design_item_width="280" settings_extraclasses="filter-grayscale" fullscreen="off" sort_order="ASC" settings_disablecats="on" settings_preloadall="off" design_categories_style="normal" design_pageContent_pos="top" settings_specialgrid_chooser_enabled="off" design_categories_pos="top" settings_biggalleryall="off" orderby="date" settings_ajax="off" bgcolor="transparent" disable_itemmeta="on"]

 

client list ( from demo )
[zoomfolio settings_mode="advancedscroller" skin="skin-zero" settings_specialgrid="none" settings_lightboxlibrary="zoombox" design_item_width="280" settings_extraclasses="filter-gray filter-gray100" fullscreen="off" sort_order="ASC" settings_disablecats="off" disable_itemmeta="on" settings_preloadall="off" design_categories_style="normal" design_pageContent_pos="top" settings_specialgrid_chooser_enabled="off" design_categories_pos="top" settings_biggalleryall="off" orderby="date" settings_ajax="off" bgcolor="transparent"]

 

 

The Excerpt

In the first demo, you can see some dates like January 2013. Those are added from the Subtitle field you have when editing the Portfolio Item.

Skin_blog meta fields

This is the default setup

{{metadate}}{{metatags}}{{metacomments}}

This means that under the title will appear the post date, the post categories and the number of comments. The order, details can be changed by just changing the position in the text.

Let's say for example we want only the date to appear

{{metadate}}

Then lets say we want to add a custom field from our posts

{{metadate}}{{icon-bolt,cf-dzsp_big_image}}

 

The icon- part represents a fontawesome icon from here- http://fontawesome.io/icons/

While the cf is a custom field - and can be found in any post ( activate Custom Fields in the top of each post edit screen if necessary )

 

The result

How to build a portfolio page with slider with Item Builder

WP ZoomFolio offers a complete solution to build the portfolio page. And the portfolio items page individually. In the preview you will see a theme with a Portfolio Item on a page. It was build very easy via Page Builder included.

  1. access any portfolio item
  2. go below to Layoutitem xxxx
  3. add a new 2/3 + 1/3 layout ( fig 1 )
  4. drag the slider icon above the first white block ( fig 2 )
  5. drag the content icon above the second

 

Localization

The process to translate the plugin is fairly easy:

  1. download poedit
  2. go to the plugin folder ( wp-content/plugins/dzs-zoomfolio or in the package you receive from CC ) to the languages folder
  3. duplicate default.po and rename the dupe to dzsp-{region}_{language}.po -> for example for Spain / Spanish it's dzsp-es_ES.po you can find the format for each language in the link above
  4. open the newly renamed file in poedit - do the changes and save - a .mo file with the same name will be created - that will be the translation file

 

 

 

 

 



FAQ - top

You can check this link for a list of popular questions. Other questions you might have:

 

What is an youtube ID?

Take this movie for example - http://www.youtube.com/watch?v=UXLvR6ZaZk4 . The youtube ID is just this part: UXLvR6ZaZk4

 
How about if I want a CMS / admin version [ no wordpress ] ?

A non cms version will be launched soon, you can follow / ask us on facebook for details.

 

Developer Tips ( for advanced usage ) - top

This gallery provides all source files so if you are developer you can start customizing it.

Recommended Programs

You can generally use any text editing software to edit most content/code, but this is what I recommend:

 

Make your own skin
  1. duplicate all the .dzsportfolio.skin-blog to .dzsportfolio.skin-yourskinname
  2. start customizing the new skin-yourskinname references
  3. change the shortcodes skin attribute to skin-yourskinname
  4. be crazy, with a little css knowledge , the possibilities are endless