laipower/wp-content/plugins/menu-icons/vendor/codeinwp/icon-picker/readme.md

86 lines
2.6 KiB
Markdown

<!-- DO NOT EDIT THIS FILE; it is auto-generated from readme.txt -->
# Icon Picker
Pick an icon of your choice.
**Contributors:** [kucrut](https://profiles.wordpress.org/kucrut)
**Tags:** [icons](https://wordpress.org/plugins/tags/icons), [image](https://wordpress.org/plugins/tags/image), [svg](https://wordpress.org/plugins/tags/svg)
**Requires at least:** 4.3
**Tested up to:** 4.7.2
**Stable tag:** 0.5.0
**License:** [GPLv2](http://www.gnu.org/licenses/gpl-2.0.html)
**Donate Link:** http://kucrut.org/#coffee
[![Build Status](https://travis-ci.org/kucrut/wp-icon-picker.svg?branch=master)](https://travis-ci.org/kucrut/wp-icon-picker) [![Built with Grunt](https://cdn.gruntjs.com/builtwith.svg)](http://gruntjs.com)
## Description ##
An icon picker library plugin.
## Screenshots ##
### Icon selector
![Icon selector](assets/screenshot-1.png)
### Icon fields in a post meta box using [CMB](https://github.com/humanmade/Custom-Meta-Boxes/)
![Icon fields in a post meta box using [CMB](https://github.com/humanmade/Custom-Meta-Boxes/)](assets/screenshot-2.png)
## Frequently Asked Questions ##
### How do I use css file from CDN? ###
You can use the `icon_picker_icon_type_stylesheet_uri` filter, eg:
```php
/**
* Load Font Awesome's CSS from CDN
*
* @param string $stylesheet_uri Icon type's stylesheet URI.
* @param string $icon_type_id Icon type's ID.
* @param Icon_Picker_Type_Font $icon_type Icon type's instance.
*
* @return string
*/
function myprefix_font_awesome_css_from_cdn( $stylesheet_uri, $icon_type_id, $icon_type ) {
if ( 'fa' === $icon_type_id ) {
$stylesheet_uri = sprintf(
'https://maxcdn.bootstrapcdn.com/font-awesome/%s/css/font-awesome.min.css',
$icon_type->version
);
}
return $stylesheet_uri;
}
add_filter( 'icon_picker_icon_type_stylesheet_uri', 'myprefix_font_awesome_css_from_cdn', 10, 3 );
```
## Changelog ##
### 0.5.0 ###
* Update Font Awesome to 4.7.0.
* Switch to Webpack.
* Various [bug fixes and enhancements](https://github.com/kucrut/wp-icon-picker/issues?q=is%3Aissue+milestone%3A0.5.0+is%3Aclosed).
### 0.4.1 ###
* Improve support for CMB: Make the field usable in a repeatable field.
### 0.4.0 ###
* Introduce `icon_picker_icon_type_stylesheet_uri` filter hook.
* Font Awesome 4.6.1
### 0.3.0 ###
* Fix CSS classname conflicts.
### 0.2.0 ###
* Introduce `icon_picker_field()`.
* Add support for [CMB](https://github.com/humanmade/Custom-Meta-Boxes/).
### 0.1.1 ###
* Load translation, props [Eduardo Larequi](https://wordpress.org/support/profile/elarequi).
### 0.1.0 ###
* Initial