Version Description
- Fix: Title notice.
Download this release
Release Info
| Developer | pdclark |
| Plugin |  Menu Social Icons |
| Version | 1.3.8 |
| Comparing to | |
| See all releases | |
Code changes from version 1.3.7 to 1.3.8
- classes/msi-frontend.php +1 -1
- plugin.php +49 -49
- readme.txt +240 -232
classes/msi-frontend.php
CHANGED
|
@@ -231,7 +231,7 @@ class MSI_Frontend {
|
|
| 231 |
$item->classes[] = $network['class'];
|
| 232 |
|
| 233 |
if ( $this->hide_text ) {
|
| 234 |
-
$html = "<span class='fa-hidden'
|
| 235 |
$item->title = apply_filters( 'storm_social_icons_title_html', $html, $item->title );
|
| 236 |
}
|
| 237 |
|
| 231 |
$item->classes[] = $network['class'];
|
| 232 |
|
| 233 |
if ( $this->hide_text ) {
|
| 234 |
+
$html = "<span class='fa-hidden'>{$item->title}</span>";
|
| 235 |
$item->title = apply_filters( 'storm_social_icons_title_html', $html, $item->title );
|
| 236 |
}
|
| 237 |
|
plugin.php
CHANGED
|
@@ -1,49 +1,49 @@
|
|
| 1 |
-
<?php
|
| 2 |
-
/*
|
| 3 |
-
Plugin Name: Menu Social Icons
|
| 4 |
-
Description: Change menu links to social sites to icons automatically. Uses <a href="http://fortawesome.github.io/Font-Awesome/" target="_blank">FontAwesome</a> and supports: Bitbucket, Dribbble, Dropbox, Flickr, Foursquare, Gittip, Instagram, RenRen, Stack Overflow, Trello, Tumblr, VK, Weibo, Xing, and YouTube.
|
| 5 |
-
Version: 1.3.
|
| 6 |
-
Author:
|
| 7 |
-
Author URI: http://
|
| 8 |
-
License: GPLv2 or later
|
| 9 |
-
License URI: http://www.gnu.org/licenses/gpl-2.0.html
|
| 10 |
-
*/
|
| 11 |
-
|
| 12 |
-
define( 'MSI_PLUGIN_FILE', __FILE__ );
|
| 13 |
-
define( 'MSI_VERSION', '1.3.
|
| 14 |
-
|
| 15 |
-
add_action( 'init', 'storm_menu_social_icons_init' );
|
| 16 |
-
|
| 17 |
-
function storm_menu_social_icons_init() {
|
| 18 |
-
|
| 19 |
-
// PHP Version Check
|
| 20 |
-
$php_is_outdated = version_compare( PHP_VERSION, '5.2', '<' );
|
| 21 |
-
|
| 22 |
-
// Only exit and warn if on admin page
|
| 23 |
-
$okay_to_exit = is_admin() && ( !defined('DOING_AJAX') || !DOING_AJAX );
|
| 24 |
-
|
| 25 |
-
if ( $php_is_outdated ) {
|
| 26 |
-
if ( $okay_to_exit ) {
|
| 27 |
-
require_once ABSPATH . '/wp-admin/includes/plugin.php';
|
| 28 |
-
deactivate_plugins( __FILE__ );
|
| 29 |
-
wp_die( sprintf( __( 'Menu Social Icons requires PHP 5.2 or higher, as does WordPress 3.2 and higher. The plugin has now disabled itself. For information on upgrading, %ssee this article%s.', 'menu-social-icons'), '<a href="http://codex.wordpress.org/Switching_to_PHP5" target="_blank">', '</a>') );
|
| 30 |
-
} else {
|
| 31 |
-
return;
|
| 32 |
-
}
|
| 33 |
-
}
|
| 34 |
-
|
| 35 |
-
require_once dirname ( __FILE__ ) . '/classes/msi-frontend.php';
|
| 36 |
-
require_once dirname ( __FILE__ ) . '/classes/msi-admin.php';
|
| 37 |
-
|
| 38 |
-
if ( class_exists( 'BWP_MINIFY' ) ) {
|
| 39 |
-
require_once dirname ( __FILE__ ) . '/classes/msi-bwp-compatibility.php';
|
| 40 |
-
}
|
| 41 |
-
|
| 42 |
-
// Frontend actions
|
| 43 |
-
// WP E-Commerce blocks other template_redirect actions by exiting at priority 10.
|
| 44 |
-
add_action( 'template_redirect', 'MSI_Frontend::get_instance', 5 );
|
| 45 |
-
|
| 46 |
-
// Admin actions
|
| 47 |
-
add_action( 'admin_init', 'MSI_Admin::get_instance' );
|
| 48 |
-
|
| 49 |
-
}
|
| 1 |
+
<?php
|
| 2 |
+
/*
|
| 3 |
+
Plugin Name: Menu Social Icons
|
| 4 |
+
Description: Change menu links to social sites to icons automatically. Uses <a href="http://fortawesome.github.io/Font-Awesome/" target="_blank">FontAwesome</a> and supports: Bitbucket, Dribbble, Dropbox, Flickr, Foursquare, Gittip, Instagram, RenRen, Stack Overflow, Trello, Tumblr, VK, Weibo, Xing, and YouTube.
|
| 5 |
+
Version: 1.3.8
|
| 6 |
+
Author: Paul Clark
|
| 7 |
+
Author URI: http://pdclark.com
|
| 8 |
+
License: GPLv2 or later
|
| 9 |
+
License URI: http://www.gnu.org/licenses/gpl-2.0.html
|
| 10 |
+
*/
|
| 11 |
+
|
| 12 |
+
define( 'MSI_PLUGIN_FILE', __FILE__ );
|
| 13 |
+
define( 'MSI_VERSION', '1.3.8' );
|
| 14 |
+
|
| 15 |
+
add_action( 'init', 'storm_menu_social_icons_init' );
|
| 16 |
+
|
| 17 |
+
function storm_menu_social_icons_init() {
|
| 18 |
+
|
| 19 |
+
// PHP Version Check
|
| 20 |
+
$php_is_outdated = version_compare( PHP_VERSION, '5.2', '<' );
|
| 21 |
+
|
| 22 |
+
// Only exit and warn if on admin page
|
| 23 |
+
$okay_to_exit = is_admin() && ( !defined('DOING_AJAX') || !DOING_AJAX );
|
| 24 |
+
|
| 25 |
+
if ( $php_is_outdated ) {
|
| 26 |
+
if ( $okay_to_exit ) {
|
| 27 |
+
require_once ABSPATH . '/wp-admin/includes/plugin.php';
|
| 28 |
+
deactivate_plugins( __FILE__ );
|
| 29 |
+
wp_die( sprintf( __( 'Menu Social Icons requires PHP 5.2 or higher, as does WordPress 3.2 and higher. The plugin has now disabled itself. For information on upgrading, %ssee this article%s.', 'menu-social-icons'), '<a href="http://codex.wordpress.org/Switching_to_PHP5" target="_blank">', '</a>') );
|
| 30 |
+
} else {
|
| 31 |
+
return;
|
| 32 |
+
}
|
| 33 |
+
}
|
| 34 |
+
|
| 35 |
+
require_once dirname ( __FILE__ ) . '/classes/msi-frontend.php';
|
| 36 |
+
require_once dirname ( __FILE__ ) . '/classes/msi-admin.php';
|
| 37 |
+
|
| 38 |
+
if ( class_exists( 'BWP_MINIFY' ) ) {
|
| 39 |
+
require_once dirname ( __FILE__ ) . '/classes/msi-bwp-compatibility.php';
|
| 40 |
+
}
|
| 41 |
+
|
| 42 |
+
// Frontend actions
|
| 43 |
+
// WP E-Commerce blocks other template_redirect actions by exiting at priority 10.
|
| 44 |
+
add_action( 'template_redirect', 'MSI_Frontend::get_instance', 5 );
|
| 45 |
+
|
| 46 |
+
// Admin actions
|
| 47 |
+
add_action( 'admin_init', 'MSI_Admin::get_instance' );
|
| 48 |
+
|
| 49 |
+
}
|
readme.txt
CHANGED
|
@@ -1,233 +1,241 @@
|
|
| 1 |
-
=== Menu Social Icons ===
|
| 2 |
-
Contributors:
|
| 3 |
-
Plugin URI: https://github.com/
|
| 4 |
-
Author URI: http://
|
| 5 |
-
Tags: social, icons, menus, FontAwesome, social media, easy
|
| 6 |
-
Requires at least: 3.4
|
| 7 |
-
Tested up to: 3.7.1
|
| 8 |
-
Stable tag: 1.3.
|
| 9 |
-
License: GPLv2
|
| 10 |
-
License URI: http://www.gnu.org/licenses/gpl-2.0.html
|
| 11 |
-
|
| 12 |
-
Add social icons to your WordPress menu items automatically.
|
| 13 |
-
|
| 14 |
-
== Description ==
|
| 15 |
-
|
| 16 |
-
This plugin changes social website links in any of your WordPress menus to use icons from FontAwesome.
|
| 17 |
-
|
| 18 |
-
No configuration is necessary, other having links to your social media profiles in the built-in WordPress menus. Add links to any of these social sites under `Appearance > Menus`, then enable the plugin.
|
| 19 |
-
|
| 20 |
-
http://www.youtube.com/watch?v=AS3hLeyV4S0
|
| 21 |
-
|
| 22 |
-
**Supported Sites**
|
| 23 |
-
|
| 24 |
-
`
|
| 25 |
-
bitbucket.org dribbble.com dropbox.com
|
| 26 |
-
facebook.com flickr.com foursquare.com
|
| 27 |
-
github.com gittip.com instagram.com
|
| 28 |
-
linkedin.com mailto:(email) pinterest.com
|
| 29 |
-
plus.google.com renren.com stackoverflow.com
|
| 30 |
-
*stackexchange.com trello.com tumblr.com
|
| 31 |
-
twitter.com *vimeo.com vk.com
|
| 32 |
-
weibo.com xing.com youtube.com
|
| 33 |
-
|
| 34 |
-
*Requires storm_social_icons_use_latest be turned on. (See below.)
|
| 35 |
-
`
|
| 36 |
-
|
| 37 |
-
**Changing Icon Appearance**
|
| 38 |
-
|
| 39 |
-
If you want to edit the appearance of the icons in ways that the options below don't provide, you can do more with custom CSS to match your theme. This video walks through the process:
|
| 40 |
-
|
| 41 |
-
http://youtube.com/watch?v=hA2rjDwmvms
|
| 42 |
-
|
| 43 |
-
**Option: Add Vimeo and Stack Exchange**
|
| 44 |
-
|
| 45 |
-
To use FontAwesome 4.0, which drops support for **IE7**, but adds **vimeo.com** and **stackexchange.com**, add this to your theme's **functions.php** file:
|
| 46 |
-
`add_filter( 'storm_social_icons_use_latest', '__return_true' );`
|
| 47 |
-
|
| 48 |
-
**Option: Show Text**
|
| 49 |
-
|
| 50 |
-
To show menu item text in addition to the icons, add this to your theme's **functions.php** file:
|
| 51 |
-
`add_filter( 'storm_social_icons_hide_text', '__return_false' );`
|
| 52 |
-
|
| 53 |
-
**Option: Alternate Icons**
|
| 54 |
-
|
| 55 |
-
To show an alternative icon style, where logos are cut out of signs, , add this to your theme's **functions.php** file:
|
| 56 |
-
`add_filter( 'storm_social_icons_type', create_function( '', 'return "icon-sign";' ) );`
|
| 57 |
-
|
| 58 |
-
**Option: Icon Sizes**
|
| 59 |
-
|
| 60 |
-
To vary icon sizes, add this to your theme's **functions.php** file: (Default is 2x)
|
| 61 |
-
|
| 62 |
-
add_filter( 'storm_social_icons_size', create_function( '', 'return "normal";' ) );
|
| 63 |
-
add_filter( 'storm_social_icons_size', create_function( '', 'return "large";' ) );
|
| 64 |
-
add_filter( 'storm_social_icons_size', create_function( '', 'return "2x";' ) );
|
| 65 |
-
add_filter( 'storm_social_icons_size', create_function( '', 'return "3x";' ) );
|
| 66 |
-
add_filter( 'storm_social_icons_size', create_function( '', 'return "4x";' ) );
|
| 67 |
-
|
| 68 |
-
**Option: Add More Icons**
|
| 69 |
-
|
| 70 |
-
Add icons from [FontAwesome](http://fortawesome.github.io/Font-Awesome/) for other URLs. For example, an RSS feed:
|
| 71 |
-
|
| 72 |
-
add_filter( 'storm_social_icons_networks', 'storm_social_icons_networks');
|
| 73 |
-
function storm_social_icons_networks( $networks ) {
|
| 74 |
-
|
| 75 |
-
$extra_icons = array (
|
| 76 |
-
'/feed' => array( // Enable this icon for any URL containing this text
|
| 77 |
-
'name' => 'RSS', // Default menu item label
|
| 78 |
-
'class' => 'rss', // Custom class
|
| 79 |
-
'icon' => 'icon-rss', // FontAwesome class
|
| 80 |
-
'icon-sign' => 'icon-rss-sign' // May not be available. Check FontAwesome.
|
| 81 |
-
),
|
| 82 |
-
);
|
| 83 |
-
|
| 84 |
-
$extra_icons = array_merge( $networks, $extra_icons );
|
| 85 |
-
return $extra_icons;
|
| 86 |
-
|
| 87 |
-
}
|
| 88 |
-
|
| 89 |
-
**Option: Change HTML Output**
|
| 90 |
-
|
| 91 |
-
This is useful for developers using the plugin with custom icon sets.
|
| 92 |
-
|
| 93 |
-
Edit icon HTML output:
|
| 94 |
-
`
|
| 95 |
-
add_filter( 'storm_social_icons_icon_html', 'storm_social_icons_icon_html', 10, 4 );
|
| 96 |
-
|
| 97 |
-
function storm_social_icons_icon_html( $html, $size, $icon, $show_text ) {
|
| 98 |
-
$html = "<i class='$size $icon $show_text'></i>";
|
| 99 |
-
return $html;
|
| 100 |
-
}
|
| 101 |
-
`
|
| 102 |
-
|
| 103 |
-
Edit title HTML output:
|
| 104 |
-
`
|
| 105 |
-
add_filter( 'storm_social_icons_title_html', 'storm_social_icons_title_html', 10, 2 );
|
| 106 |
-
|
| 107 |
-
function storm_social_icons_title_html( $html, $title ){
|
| 108 |
-
$html = "<span class='fa-hidden'>$title</span>";
|
| 109 |
-
return $html;
|
| 110 |
-
}
|
| 111 |
-
`
|
| 112 |
-
|
| 113 |
-
Edit all link attributes (WordPress core filter):
|
| 114 |
-
|
| 115 |
-
`
|
| 116 |
-
add_filter( 'wp_nav_menu_objects', 'storm_wp_nav_menu_objects', 7, 2 );
|
| 117 |
-
|
| 118 |
-
function storm_wp_nav_menu_objects( $sorted_menu_items, $args ){
|
| 119 |
-
|
| 120 |
-
foreach( $sorted_menu_items as &$item ) {
|
| 121 |
-
|
| 122 |
-
if ( 0 != $item->menu_item_parent ) {
|
| 123 |
-
// Skip submenu items
|
| 124 |
-
continue;
|
| 125 |
-
}
|
| 126 |
-
|
| 127 |
-
// Only apply changes to links containing this text.
|
| 128 |
-
$search_url = 'facebook.com';
|
| 129 |
-
|
| 130 |
-
if ( false !== strpos( $item->url, $search_url ) ) {
|
| 131 |
-
|
| 132 |
-
// Add a custom class
|
| 133 |
-
$item->classes[] = 'some-custom-class';
|
| 134 |
-
|
| 135 |
-
// Add custom HTML inside the link
|
| 136 |
-
$item->title = '<strong>custom html</strong>' . $item->title;
|
| 137 |
-
|
| 138 |
-
}
|
| 139 |
-
}
|
| 140 |
-
|
| 141 |
-
return $sorted_menu_items;
|
| 142 |
-
|
| 143 |
-
}
|
| 144 |
-
`
|
| 145 |
-
|
| 146 |
-
== Installation ==
|
| 147 |
-
|
| 148 |
-
1. Search for "Menu Social Icons" under `WordPress Admin > Plugins > Add New`
|
| 149 |
-
1. Activate the plugin.
|
| 150 |
-
|
| 151 |
-
== Screenshots ==
|
| 152 |
-
|
| 153 |
-
1. Icons and shortcuts in WordPress Menu Editor.
|
| 154 |
-
1. Menu without the plugin activated.
|
| 155 |
-
1. Menu with default settings.
|
| 156 |
-
1. Alternative "icon-sign" display.
|
| 157 |
-
1. Hidden text disabled.
|
| 158 |
-
1. "normal" icon size
|
| 159 |
-
1. "4x" icon size
|
| 160 |
-
|
| 161 |
-
== Frequently Asked Questions ==
|
| 162 |
-
|
| 163 |
-
= Can you add X icon? =
|
| 164 |
-
|
| 165 |
-
Menu Social Icons is dependent on the [FontAwesome icon library](http://fortawesome.github.io/Font-Awesome). If an icon exists in FontAwesome, you can add a filter for it using the `storm_social_icons_networks` example shown in the plugin description.
|
| 166 |
-
|
| 167 |
-
If an icon does not exist in FontAwesome, you can request see FontAwesome's instructions for [requesting new icons](http://fortawesome.github.io/Font-Awesome/community/#requesting-new-icons).
|
| 168 |
-
|
| 169 |
-
= How can I change how the icons are aligned, positioned, colored, sized, etc. =
|
| 170 |
-
|
| 171 |
-
See the tutorial video on editing appearance and the code samples for various options in the [plugin description](http://wordpress.org/plugins/menu-social-icons/).
|
| 172 |
-
|
| 173 |
-
= Does this plugin install all of FontAwesome? =
|
| 174 |
-
|
| 175 |
-
Yes. The plugin installs the complete FontAwesome package. You can use any of the icons in your HTML.
|
| 176 |
-
|
| 177 |
-
= I don't see FontAwesome anywhere in the plugin! =
|
| 178 |
-
|
| 179 |
-
We load FontAwesome onto your site using NetDNA's [Bootstrap CDN](http://www.bootstrapcdn.com/#tab_fontawesome) service. This makes it load much faster for your users.
|
| 180 |
-
|
| 181 |
-
== Changelog ==
|
| 182 |
-
|
| 183 |
-
= 1.3.
|
| 184 |
-
|
| 185 |
-
*
|
| 186 |
-
|
| 187 |
-
= 1.3.
|
| 188 |
-
|
| 189 |
-
* New:
|
| 190 |
-
|
| 191 |
-
= 1.3.
|
| 192 |
-
|
| 193 |
-
*
|
| 194 |
-
|
| 195 |
-
= 1.3.
|
| 196 |
-
|
| 197 |
-
* Fix:
|
| 198 |
-
|
| 199 |
-
= 1.3.
|
| 200 |
-
|
| 201 |
-
* Fix: Work around
|
| 202 |
-
|
| 203 |
-
= 1.3.
|
| 204 |
-
|
| 205 |
-
* Fix:
|
| 206 |
-
|
| 207 |
-
|
| 208 |
-
|
| 209 |
-
|
| 210 |
-
*
|
| 211 |
-
|
| 212 |
-
|
| 213 |
-
|
| 214 |
-
|
| 215 |
-
|
| 216 |
-
*
|
| 217 |
-
|
| 218 |
-
|
| 219 |
-
|
| 220 |
-
|
| 221 |
-
|
| 222 |
-
*
|
| 223 |
-
|
| 224 |
-
|
| 225 |
-
|
| 226 |
-
|
| 227 |
-
*
|
| 228 |
-
|
| 229 |
-
|
| 230 |
-
|
| 231 |
-
|
| 232 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 233 |
* New: Remove templates folder. Replace with filters `storm_social_icons_title_html` and `storm_social_icons_icon_html`. Add example of core `wp_nav_menu_objects` filter to readme.
|
| 1 |
+
=== Menu Social Icons ===
|
| 2 |
+
Contributors: pdclark
|
| 3 |
+
Plugin URI: https://github.com/pdclark/menu-social-icons
|
| 4 |
+
Author URI: http://pdclark.com
|
| 5 |
+
Tags: social, icons, menus, FontAwesome, social media, easy
|
| 6 |
+
Requires at least: 3.4
|
| 7 |
+
Tested up to: 3.7.1
|
| 8 |
+
Stable tag: 1.3.8
|
| 9 |
+
License: GPLv2
|
| 10 |
+
License URI: http://www.gnu.org/licenses/gpl-2.0.html
|
| 11 |
+
|
| 12 |
+
Add social icons to your WordPress menu items automatically.
|
| 13 |
+
|
| 14 |
+
== Description ==
|
| 15 |
+
|
| 16 |
+
This plugin changes social website links in any of your WordPress menus to use icons from FontAwesome.
|
| 17 |
+
|
| 18 |
+
No configuration is necessary, other having links to your social media profiles in the built-in WordPress menus. Add links to any of these social sites under `Appearance > Menus`, then enable the plugin.
|
| 19 |
+
|
| 20 |
+
http://www.youtube.com/watch?v=AS3hLeyV4S0
|
| 21 |
+
|
| 22 |
+
**Supported Sites**
|
| 23 |
+
|
| 24 |
+
`
|
| 25 |
+
bitbucket.org dribbble.com dropbox.com
|
| 26 |
+
facebook.com flickr.com foursquare.com
|
| 27 |
+
github.com gittip.com instagram.com
|
| 28 |
+
linkedin.com mailto:(email) pinterest.com
|
| 29 |
+
plus.google.com renren.com stackoverflow.com
|
| 30 |
+
*stackexchange.com trello.com tumblr.com
|
| 31 |
+
twitter.com *vimeo.com vk.com
|
| 32 |
+
weibo.com xing.com youtube.com
|
| 33 |
+
|
| 34 |
+
*Requires storm_social_icons_use_latest be turned on. (See below.)
|
| 35 |
+
`
|
| 36 |
+
|
| 37 |
+
**Changing Icon Appearance**
|
| 38 |
+
|
| 39 |
+
If you want to edit the appearance of the icons in ways that the options below don't provide, you can do more with custom CSS to match your theme. This video walks through the process:
|
| 40 |
+
|
| 41 |
+
http://youtube.com/watch?v=hA2rjDwmvms
|
| 42 |
+
|
| 43 |
+
**Option: Add Vimeo and Stack Exchange**
|
| 44 |
+
|
| 45 |
+
To use FontAwesome 4.0, which drops support for **IE7**, but adds **vimeo.com** and **stackexchange.com**, add this to your theme's **functions.php** file:
|
| 46 |
+
`add_filter( 'storm_social_icons_use_latest', '__return_true' );`
|
| 47 |
+
|
| 48 |
+
**Option: Show Text**
|
| 49 |
+
|
| 50 |
+
To show menu item text in addition to the icons, add this to your theme's **functions.php** file:
|
| 51 |
+
`add_filter( 'storm_social_icons_hide_text', '__return_false' );`
|
| 52 |
+
|
| 53 |
+
**Option: Alternate Icons**
|
| 54 |
+
|
| 55 |
+
To show an alternative icon style, where logos are cut out of signs, , add this to your theme's **functions.php** file:
|
| 56 |
+
`add_filter( 'storm_social_icons_type', create_function( '', 'return "icon-sign";' ) );`
|
| 57 |
+
|
| 58 |
+
**Option: Icon Sizes**
|
| 59 |
+
|
| 60 |
+
To vary icon sizes, add this to your theme's **functions.php** file: (Default is 2x)
|
| 61 |
+
|
| 62 |
+
add_filter( 'storm_social_icons_size', create_function( '', 'return "normal";' ) );
|
| 63 |
+
add_filter( 'storm_social_icons_size', create_function( '', 'return "large";' ) );
|
| 64 |
+
add_filter( 'storm_social_icons_size', create_function( '', 'return "2x";' ) );
|
| 65 |
+
add_filter( 'storm_social_icons_size', create_function( '', 'return "3x";' ) );
|
| 66 |
+
add_filter( 'storm_social_icons_size', create_function( '', 'return "4x";' ) );
|
| 67 |
+
|
| 68 |
+
**Option: Add More Icons**
|
| 69 |
+
|
| 70 |
+
Add icons from [FontAwesome](http://fortawesome.github.io/Font-Awesome/) for other URLs. For example, an RSS feed:
|
| 71 |
+
|
| 72 |
+
add_filter( 'storm_social_icons_networks', 'storm_social_icons_networks');
|
| 73 |
+
function storm_social_icons_networks( $networks ) {
|
| 74 |
+
|
| 75 |
+
$extra_icons = array (
|
| 76 |
+
'/feed' => array( // Enable this icon for any URL containing this text
|
| 77 |
+
'name' => 'RSS', // Default menu item label
|
| 78 |
+
'class' => 'rss', // Custom class
|
| 79 |
+
'icon' => 'icon-rss', // FontAwesome class
|
| 80 |
+
'icon-sign' => 'icon-rss-sign' // May not be available. Check FontAwesome.
|
| 81 |
+
),
|
| 82 |
+
);
|
| 83 |
+
|
| 84 |
+
$extra_icons = array_merge( $networks, $extra_icons );
|
| 85 |
+
return $extra_icons;
|
| 86 |
+
|
| 87 |
+
}
|
| 88 |
+
|
| 89 |
+
**Option: Change HTML Output**
|
| 90 |
+
|
| 91 |
+
This is useful for developers using the plugin with custom icon sets.
|
| 92 |
+
|
| 93 |
+
Edit icon HTML output:
|
| 94 |
+
`
|
| 95 |
+
add_filter( 'storm_social_icons_icon_html', 'storm_social_icons_icon_html', 10, 4 );
|
| 96 |
+
|
| 97 |
+
function storm_social_icons_icon_html( $html, $size, $icon, $show_text ) {
|
| 98 |
+
$html = "<i class='$size $icon $show_text'></i>";
|
| 99 |
+
return $html;
|
| 100 |
+
}
|
| 101 |
+
`
|
| 102 |
+
|
| 103 |
+
Edit title HTML output:
|
| 104 |
+
`
|
| 105 |
+
add_filter( 'storm_social_icons_title_html', 'storm_social_icons_title_html', 10, 2 );
|
| 106 |
+
|
| 107 |
+
function storm_social_icons_title_html( $html, $title ){
|
| 108 |
+
$html = "<span class='fa-hidden'>$title</span>";
|
| 109 |
+
return $html;
|
| 110 |
+
}
|
| 111 |
+
`
|
| 112 |
+
|
| 113 |
+
Edit all link attributes (WordPress core filter):
|
| 114 |
+
|
| 115 |
+
`
|
| 116 |
+
add_filter( 'wp_nav_menu_objects', 'storm_wp_nav_menu_objects', 7, 2 );
|
| 117 |
+
|
| 118 |
+
function storm_wp_nav_menu_objects( $sorted_menu_items, $args ){
|
| 119 |
+
|
| 120 |
+
foreach( $sorted_menu_items as &$item ) {
|
| 121 |
+
|
| 122 |
+
if ( 0 != $item->menu_item_parent ) {
|
| 123 |
+
// Skip submenu items
|
| 124 |
+
continue;
|
| 125 |
+
}
|
| 126 |
+
|
| 127 |
+
// Only apply changes to links containing this text.
|
| 128 |
+
$search_url = 'facebook.com';
|
| 129 |
+
|
| 130 |
+
if ( false !== strpos( $item->url, $search_url ) ) {
|
| 131 |
+
|
| 132 |
+
// Add a custom class
|
| 133 |
+
$item->classes[] = 'some-custom-class';
|
| 134 |
+
|
| 135 |
+
// Add custom HTML inside the link
|
| 136 |
+
$item->title = '<strong>custom html</strong>' . $item->title;
|
| 137 |
+
|
| 138 |
+
}
|
| 139 |
+
}
|
| 140 |
+
|
| 141 |
+
return $sorted_menu_items;
|
| 142 |
+
|
| 143 |
+
}
|
| 144 |
+
`
|
| 145 |
+
|
| 146 |
+
== Installation ==
|
| 147 |
+
|
| 148 |
+
1. Search for "Menu Social Icons" under `WordPress Admin > Plugins > Add New`
|
| 149 |
+
1. Activate the plugin.
|
| 150 |
+
|
| 151 |
+
== Screenshots ==
|
| 152 |
+
|
| 153 |
+
1. Icons and shortcuts in WordPress Menu Editor.
|
| 154 |
+
1. Menu without the plugin activated.
|
| 155 |
+
1. Menu with default settings.
|
| 156 |
+
1. Alternative "icon-sign" display.
|
| 157 |
+
1. Hidden text disabled.
|
| 158 |
+
1. "normal" icon size
|
| 159 |
+
1. "4x" icon size
|
| 160 |
+
|
| 161 |
+
== Frequently Asked Questions ==
|
| 162 |
+
|
| 163 |
+
= Can you add X icon? =
|
| 164 |
+
|
| 165 |
+
Menu Social Icons is dependent on the [FontAwesome icon library](http://fortawesome.github.io/Font-Awesome). If an icon exists in FontAwesome, you can add a filter for it using the `storm_social_icons_networks` example shown in the plugin description.
|
| 166 |
+
|
| 167 |
+
If an icon does not exist in FontAwesome, you can request see FontAwesome's instructions for [requesting new icons](http://fortawesome.github.io/Font-Awesome/community/#requesting-new-icons).
|
| 168 |
+
|
| 169 |
+
= How can I change how the icons are aligned, positioned, colored, sized, etc. =
|
| 170 |
+
|
| 171 |
+
See the tutorial video on editing appearance and the code samples for various options in the [plugin description](http://wordpress.org/plugins/menu-social-icons/).
|
| 172 |
+
|
| 173 |
+
= Does this plugin install all of FontAwesome? =
|
| 174 |
+
|
| 175 |
+
Yes. The plugin installs the complete FontAwesome package. You can use any of the icons in your HTML.
|
| 176 |
+
|
| 177 |
+
= I don't see FontAwesome anywhere in the plugin! =
|
| 178 |
+
|
| 179 |
+
We load FontAwesome onto your site using NetDNA's [Bootstrap CDN](http://www.bootstrapcdn.com/#tab_fontawesome) service. This makes it load much faster for your users.
|
| 180 |
+
|
| 181 |
+
== Changelog ==
|
| 182 |
+
|
| 183 |
+
= 1.3.8 =
|
| 184 |
+
|
| 185 |
+
* Fix: Title notice.
|
| 186 |
+
|
| 187 |
+
= 1.3.7 =
|
| 188 |
+
|
| 189 |
+
* New: Remove templates folder. Replace with filters `storm_social_icons_title_html` and `storm_social_icons_icon_html`. Add example of core `wp_nav_menu_objects` filter to readme.
|
| 190 |
+
|
| 191 |
+
= 1.3.6 =
|
| 192 |
+
|
| 193 |
+
* New: Allow themes to override HTML output with msi-templates directory.
|
| 194 |
+
|
| 195 |
+
= 1.3.5 =
|
| 196 |
+
|
| 197 |
+
* Fix: Horizontal scrollbar on RTL layouts. Thanks [@mascatu](http://wordpress.org/support/profile/mascatu) for the [bug report](http://wordpress.org/support/topic/rtl-issue-1).
|
| 198 |
+
|
| 199 |
+
= 1.3.4 =
|
| 200 |
+
|
| 201 |
+
* Fix: Work around compatibility issue with [Better WordPress Minify](http://wordpress.org/plugins/bwp-minify/) plugin.
|
| 202 |
+
|
| 203 |
+
= 1.3.3 =
|
| 204 |
+
|
| 205 |
+
* Fix: Work around bug in WP E-commerce that causes other plugins to not load properly on product pages. Thanks [@elfary](http://wordpress.org/support/topic/menu-with-e-commerce). See [bug report to WP E-commerce](http://wordpress.org/support/topic/other-plugins-blocked-from-loading-on-product-pages).
|
| 206 |
+
|
| 207 |
+
= 1.3.2 =
|
| 208 |
+
|
| 209 |
+
* Fix: Properly enqueue stylesheets
|
| 210 |
+
* Fix: Set FontAwesome 4.0 to off by default
|
| 211 |
+
|
| 212 |
+
= 1.3 =
|
| 213 |
+
|
| 214 |
+
* New: Preview icons and shortcuts in the WordPress Menu Editor.
|
| 215 |
+
* New: vimeo.com and stackexchange.com icons when FontAwesome 4.0 is turned on.
|
| 216 |
+
* Notice: FontAwesome 4.0 removes support for IE7, so it is off by default. Use the filter `storm_social_icons_use_latest` shown in the readme to turn on FontAwesome 4.0.
|
| 217 |
+
|
| 218 |
+
= 1.2 =
|
| 219 |
+
|
| 220 |
+
* New: Filter for custom icons and URLs.
|
| 221 |
+
* New: Icon for `mailto:` links.
|
| 222 |
+
* [Thanks to mmcginnis](http://wordpress.org/support/topic/just-works-40) for both of these changes.
|
| 223 |
+
|
| 224 |
+
= 1.1 =
|
| 225 |
+
|
| 226 |
+
* New: Upgrade to FontAwesome 3.2.1
|
| 227 |
+
* New: ots of new site icons: bitbucket.org, dribbble.com, dropbox.com, flickr.com, foursquare.com, gittip.com, instagram.com, renren.com, stackoverflow.com, trello.com, tumblr.com, vk.com, weibo.com, xing.com, youtube.com
|
| 228 |
+
|
| 229 |
+
= 1.0 =
|
| 230 |
+
|
| 231 |
+
* Initial public release.
|
| 232 |
+
|
| 233 |
+
== Upgrade Notice ==
|
| 234 |
+
|
| 235 |
+
= 1.3.8 =
|
| 236 |
+
|
| 237 |
+
* Fix: Title notice.
|
| 238 |
+
|
| 239 |
+
= 1.3.7 =
|
| 240 |
+
|
| 241 |
* New: Remove templates folder. Replace with filters `storm_social_icons_title_html` and `storm_social_icons_icon_html`. Add example of core `wp_nav_menu_objects` filter to readme.
|
