- Tags: iconfinder, portfolio, referral content, icons
- Requires at least: 3.0.1
- Tested up to: 4.3
- License: GPLv2 or later
- License URI: http://www.gnu.org/licenses/gpl-2.0.html
A WordPress plugin that integrates the Iconfinder API with a WordPress-powered site
This plugin allows anyone to display content from Iconfinder.com on a WordPress-powered site. In order to use this plugin, you will need an active account on Iconfinder.com and a valid API application key.
In order to use this plugin you will need a valid (free) account on Iconfinder. To create an account, simply visit http://iconfinder.com and click the "Sign Up" link in the upper right-hand corner of the home page.
You will also need a valid API Application on Iconfinder.com. You can request an API application by visiting https://www.iconfinder.com/api-solution and clicking the Request A Demo button or email [email protected]
- Upload
iconfinder-portfolioto the/wp-content/plugins/directory - Activate the plugin through the 'Plugins' menu in WordPress
- Navigate to Admin Menu > Settings > Iconfinder Portfolio
- Enter your valid username that you selected when you created your Iconfinder account
- Enter the API Application Client ID and Client Secret, which you can locate ... TBD
Iconfinder Portfolio uses shortcodes to display content that you specify anywhere on your site.
The most basic version of the shortcode will display up to 100 iconsets from your Iconfinder account. If no count is specified, the default API limit of 100 sets will be displayed.
To display an unfiltered list of iconsets, simply add this token to any blog post or page on your site:
[iconfinder_portfolio]
You can also use the following list of parameters to filter the content that displayed. Details for each parameter are included below.
| Parameter | Accepted Values | Description |
|---|---|---|
| sets | comma-separated list of iconset ids | Displays a specific list of icon sets. Over-rides all other parameters except sort_by and sort_order. |
| count | inegeger 0-100 | Limits the number of iconsets that are displayed. |
| style string identifier | Shows only iconsets matching a valid style identifier. | |
| type | premium or free | Shows only iconsets matching a valid type identifier. |
| categories | comma-separated list of string identifiers | Shows only iconsets matching a comma-separated list of 1 or more category identifiers. |
| omit | comma-separated list of iconset ids | Filters from display 1 or more icon sets. |
| sort_by | string field name | Sorts the icon sets by the field name given. Requires sort_order param. |
| sort_order | Whether to sort in ASC or DESC order. | |
| collection | integer collection ID | Displays all icon sets within a given collection. Requires sort_by param. Over-rides sets param. |
| img_size | normal or large | The icon set preview image size. |
[iconfinder_portfolio count=20]
The above token will display the first 20 iconsets from your Iconfinder account. ordered by newest to oldest.
You can specify the display order or iconsets in either ascending (ASC) or descending (DESC) order based on the date, name, or iconset_id.
[iconfinder_portfolio sort_by=date sort_order=DESC]
| Value | Description |
|---|---|
| date | the publication date of the iconset |
| name | the name of the iconset |
| iconset_id | the ID of the iconset |
Valid sort_order values:
| Value | Description |
|---|---|
| ASC | oldest to newest, Z-A, lowest to highest ID |
| DESC | newest to oldest, A-Z, highest to lowest ID |
You can omit one or more iconsets from display by including the omit parameter like in the example below
[iconfinder_portfolio style=outline omit=10234,56078,98706]
You can show only iconsets that are a particular style by including the 'style' parameter.
[iconfinder_portfolio style=outline]
- 3d
- cartoon
- flat
- glyph
- handdrawn
- outline
- photorealistic
- pixel
- smooth
You can show only free or premium iconsets by including the 'type' parameter.
[iconfinder_portfolio style=outline]
- premium
- free
You can specify a Collection of iconsets from your Iconfinder profile to display.
[iconfinder_portfolio collection=12345]
You can combine the collection parameter with other filtering parameters as well.
[iconfinder_portfolio collection=12345 sort_by=name sort_order=DESC omit=98765,98764]
You can show specific sets by including a comma-separated list of iconset IDS. You can find the iconset ID by ... TBD
[iconfinder_portfolio sets=18389,16747,16745]
Note that if you specify a list of iconset IDs, all other filters will be ignored.
You can show iconsets from specific categories by including the 'categories' parameter.
[iconfinder_portfolio categories=christmas,halloween,easter]
- abstract
- animal
- arrow
- avatars-smiley
- business-finance
- christmas
- clothes-accessory
- computer-hardware
- desktop-app
- easter
- education-science
- events-and-entertainment
- fall
- family-home
- file-folder
- flag
- food-drinks
- gaming-gambling
- halloween
- health-beauty-and-fashion
- healthcare-medical
- interior-building
- ios7-optimized
- maps-navigation
- mixed
- mobile-app
- music-multimedia
- nature-outdoor
- network-communication
- nsfw
- photography-graphic-design
- real-estate
- recreation-hobby
- romance
- seasons
- security
- seo-web
- shipping-delivery-and-fulfillment
- shopping-ecommerce
- sign-symbol
- social-media
- sports-award
- spring
- summer
- touch-gesture
- transportation
- travel-hotel
- ui
- weather
- winter
You can choose which iconset preview image size to display on your site.
[iconfinder_portfolio style=outline img_size=large]
- normal
- large
You can also display iconsets that match multiple filters. Keep in mind, however, that 'sets' (a list of specific iconset IDs, overrides all other filters)
[iconfinder_portfolio style=outline type=free categories=business-finance,shopping-ecommerce,seo-web]
You can also call the Iconfinder Portfolio shortcode from your theme files with the following:
<?php do_shortcode("[iconfinder_portfolio style=outline]"); ?>
You can create your own templates for the output from the Iconfinder Portfolio plugin. Add your custom theme file to wp-content/iconfinder-portfolio/public/partials/.
Note that theme names are required to follow the format theme-identifier.php where theme- is the required prefix and idenfitier is your custom theme name. identifier is the only part of the name you can modify.
For complete details for creating your own theme, See the example theme in:
wp-content/plugins/iconfinder-portfolio/public/partials/theme-mytheme.php
You can specify a custom theme by including the 'theme' parameter to the Iconfinder Portfolio shortcode. The name of your theme is the middle part of the theme file name. For example, if your theme file name is theme-mytheme.php. The theme name would simply be mytheme.
[iconfinder_portfolio theme=mytheme]
Iconfinder Portfolio comes with a built-in image slider based on the Owl image slider for jQuery. You can specify the theme by adding the following parameter to your shortcode:
[iconfinder_portfolio theme=owly]
- Version 1.0 causes an error in WP admin but doesn't cause errors on public pages
- Allow multiple style identifiers
- Add WP text editor integration
- Add UI to create new smartcodes for copy/paste or direct insert
- Widgetize output
- Integration with Social Media sharing
- Allow site users to view all icons in an iconset
- Update for better SEO
- Show all valid shortcode params in settings panel
- Show Iconset and Collection IDs in plugin settings panel
- Add "Test API credentials" to Iconfinder Porfolio settings page
- Add graceful failure recovery
- Add local caching of objects to display if the API is unreachable
- Initial release
- Added sorting
- Added
omitto filter out specific sets by iconset_id - Removed user_id from settings page
- Updated API calls to use username instead of user_id
- Adding constants to settings file for ICONFINDER_URL, ICONFINDER_CDN_URL
- Added collections to output options
- Added Iconset and Collection IDs in plugin settings panel
- Added img_size parameter to shortcode
- Added "Clear Cache" feature to admin
- Changed the way API calls are made. Instead of API-first, cache-second, the logic was changed to use the cached version of data first and only call the API if the cache has been purged or is otherwise empty.
- Added Bogdan Rosu's implementation of the Owl image carousel. Now ships with two themes for front end.
- Removed tags column in Iconset post admin list view
- Added ability to restrict search box to only search a specific set on single page
- Change search post_type on iconset single template to 'icons' so searches happen in the set being displayed
- The Iconfinder Portfolio plugin is built on the WordPress Plugin Boilerplate by http://wppb.io
- The initial code was auto-generated using WPPB generator at http://wppb.me
- Additional guidance was provided by the article https://scotch.io/tutorials/how-to-build-a-wordpress-plugin-part-1