/freefolio

Adds a portfolio to your WordPress site + Dribbble importer.

Primary LanguagePHPGNU General Public License v2.0GPL-2.0

=== Freefolio ===
Contributors: mattsimo, chriswallace, andrewtaylor-1, upthemes
Donate link: https://upthemes.com/themes/creative/
Tags: portfolio,dribbble,post types
Requires at least: 3.8
Tested up to: 4.0
Stable tag: 1.1.3
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

The best way to get up and running with a portfolio on your very own WordPress website.

== Description ==

Freefolio adds responsive portfolio functionality to your WordPress website that works with any theme. It adds the following items:

* Portfolio post type (compatible with the Jetpack Portfolio post type)
* Project Type taxonomy (works like categories)
* Project Tag taxonomy (works like tags)
* [portfolio] shortcode to display a responsive grid of portfolio items
* Imports your Dribbble shots to WordPress

= Coming Soon =

* Portfolio widget (for showcasing recent items)
* FreeFolio theme finder

= Credits =

- The team at [Automattic](http://automattic.com) for [Jetpack](http://jetpack.me) and, specifically, the Jetpack Portfolio post type.
- [Tammy Hart](http://www.tammyhartdesigns.com/) for http://zurb.com/forrst/posts/Dribbble_to_WordPress-wZv
- [The nice folks at array.is](https://array.is) for the [Jetpack Portfolio Polyfill](https://array.is/articles/designer/#install-array-portfolio) which we've adapted for use here.

== Installation ==

= Using The WordPress Dashboard =

1. Navigate to the 'Add New' in the plugins dashboard
2. Search for 'plugin-name'
3. Click 'Install Now'
4. Activate the plugin on the Plugin dashboard
5. Visit `General > Writing` settings and enable the `Portfolio Projects` option.
6. Visit `Tools > Dribbble Importer`
7. Add your dribbble username in the appropriate settings field.
8. Click the "Import Shots From Dribbble" button
9. Wait for the import to finish - it may take up to 15 minutes for all shots to be imported
10. Visit `Portfolio` to see the imported items

= Uploading in WordPress Dashboard =

1. Navigate to the 'Add New' in the plugins dashboard
2. Navigate to the 'Upload' area
3. Select `plugin-name.zip` from your computer
4. Click 'Install Now'
5. Activate the plugin in the Plugin dashboard
6. Visit `General > Writing` settings and enable the `Portfolio Projects` option.
7. Visit `Tools > Dribbble Importer`
8. Add your dribbble username in the appropriate settings field.
9. Click the "Import Shots From Dribbble" button
10. Wait for the import to finish - it may take up to 15 minutes for all shots to be imported
11. Visit `Portfolio` to see the imported items

= Using FTP =

1. Download `freefolio.zip`
2. Extract the `plugin-name` directory to your computer
3. Upload the `plugin-name` directory to the `/wp-content/plugins/` directory
4. Activate the plugin in the Plugin dashboard
5. Visit `General > Writing` settings and enable the `Portfolio Projects` option.
6. Visit `Tools > Dribbble Importer`
7. Add your dribbble username in the appropriate settings field.
8. Click the "Import Shots From Dribbble" button
9. Wait for the import to finish - it may take up to 15 minutes for all shots to be imported
10. Visit `Portfolio` to see the imported items

== Frequently Asked Questions ==

= How does the Dribbble importer work? =

When the import button is clicked the plugin will work in the background to read your dribbble feed and see if it needs to import any posts.

If it does, it will create `jetpack-portfolio` posts for items that don't exist. It will also create three post meta key/values:

- `dribbble_id`: holds the dribbble shot ID
- `dribbble_link_url`: holds the URL for the shot on dribbble
- `dribbble_image_url`: holds the URL for the image src for the shot

= How do I use the portfolio shortcode? =

Shortcode options:

* `display_types`: display Project Types. (true/false)
* `display_tags`: display Project Tags. (true/false)
* `display_content`: display project content. (true/false)
* `include_type`: display specific Project Types. Defaults to all. (comma-separated list of Project Type slugs)
* `include_tag`: display specific Project Tags. Defaults to all. (comma-separated list of Project Tag slugs)
* `columns`: number of columns in shortcode. Defaults to 2. (number, 1-6)
* `showposts`: number of projects to display. Defaults to all. (number)

Shortcode example:

[portfolio display_types=true display_tags=false include_type=ui-design,app-design columns=3 showposts=10]

== Screenshots ==

1. Single portfolio/project view.
2. Portfolio shortcode view.
3. Editor shortcode example.
4. Dribbble import utility.
5. Portfolio list view.

== Changelog ==

= 1.1.3 =
* Removed duplicate post image on non-portfolio post types

= 1.1.2 =
* Cleaned up responsive grid styles
* Updated README instructions

= 1.1.0 =
* Updated Dribbble importer to use v1 of the Dribbble API

= 1.0.0 =
* Initial release