=== Speed Contact Bar ===
Contributors: Hinjiriyo, allamoda07
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=TPCX6FVZ5NSJ6
Tags: address, cell phone, contact, email, facebook, fax, flickr, g+, google plus, google+, icons, imdb, instagram, linkedin, phone, pinterest, position, responsive, skype, slideshare, snapchat, social media, soundcloud, tumblr, twitter, vimeo, xing, yelp, youtube
Requires at least: 3.5
Requires PHP: 5.2
Tested up to: 4.9.6
Stable tag: 6.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Let your website visitors get in touch with you easily with permanent visible contact informations
== Description ==
The plugin is available in English, German (Deutsch) and Polish (Polski). It does not collect any personal data, so it is ready for EU General Data Protection Regulation (GDPR) compliance.
= Quick contact to you =
Speed Contact Bar enables your visitors to get in contact with you quickly. The plugin shows a colored bar with your contact data and social media URLs on the top of every page of your website.
The bar design is responsive and thus ready for smartphones and tablets. The social media icons are included already.
Each icon appears if you set its target URL in the option page. The phone icons and numbers are clickable to trigger a phone call. The e-mail is clickable to open a mail client.
= What users said =
* **"Perfect 5 star plugin"** in [WordPress.org Reviews](https://wordpress.org/support/topic/perfect-5-star-plugin/) by maartensurf on December 13, 2017
* **"This plugin is the only one in the whole repository that really provides what I want."** in [WordPress.org Support](https://wordpress.org/support/topic/remove-link-phone-and-email-link-on-desktop/) by stepheniryna on July 14, 2017
* **"the BEST customer service I have received in 2016!"** in [WordPress.org Support](https://wordpress.org/support/topic/hide-the-email-address-but-still-it-responsive/#post-8606116) by chrissavid33 on December 31, 2016
* **"100% recommended. Saved my time"** in [WordPress.org Reviews](https://wordpress.org/support/topic/i-love-this-plugin-193) by ramarao on August 20, 2016
* **"Exactly what I needed"** in [WordPress.org Reviews](https://wordpress.org/support/topic/exactly-what-i-needed-340) by wineisallforme on May 23, 2016
* **Number 8** in [Top 9 WordPress Free Contact Forms](http://www.thenightmarketer.com/wordpress/top-9-wordpress-free-contact-forms/) by The Night Marketer on May 29, 2015
* **Number 23** in [24 Best Free & Premium WordPress Notification Bars Plugin 2015](http://www.frip.in/best-premium-free-wordpress-notification-bars/) by Himanshu on May 8, 2015
* **"Absolutely fantastic. Was exactly what I was looking for and looks brilliant on my website."** in [WordPress.org Reviews](https://wordpress.org/support/topic/does-exactly-what-youd-expect) by tydem00 on April 15, 2015
* **"It's one of my favorites, and easily one of the best for social buttons."** in [WordPress.org Support Forum](https://wordpress.org/support/topic/adding-yelp) by aleos97 on April 25, 2015
= What you can configure =
There are some options you can set to let the contact bar fit to your needs. You can set
1. your contact data
2. URLs to your social media pages and profiles and
3. many design options like colors
View the video [**Installation & Configuration of Speed Contact Bar WordPress Plugin** on Youtube](https://www.youtube.com/watch?v=uLRyHyKIh8M) by Wordpress Support on August 19, 2015.
= Available contact data options =
You can show these three **personal contact data**:
1. **Headline**, can be a **link** with an optional URL
2. **Postal address**, can be a **link** with an optional URL
3. **Phone number**, automatically **linked** to open an available phone application, can be displayed with a **text of your choice**
4. **Fax number**, automatically **linked** to open an available phone application, can be displayed with a **text of your choice**
5. **Cell phone number**, automatically **linked** to open an available phone application, can be displayed with a **text of your choice**
6. **E-Mail address**, automatically **linked** to open an available mail client, can be displayed with a **text of your choice**
7. any further content you wish by using the filter hook `speed-contact-bar-data` (as documented in section "Add and re-order list entries by using hooks" below)
= Supported social media platforms =
Speed Contact Bar supports links to these **social media platforms**, as ordered alphabetically:
1. Facebook
2. Flickr
3. Google Plus
4. IMDb
5. Instagram
6. LinkedIn
7. Pinterest
8. Skype
9. SlideShare
10. Snapchat
11. SoundCloud
12. Tumblr
13. Twitter
14. Vimeo
15. Xing
16. Yelp
17. Youtube
18. any further content you wish by using the filter hook `speed-contact-bar-icons` (as documented in section "Add and re-order list entries by using hooks" below)
More social media plattforms will come in future.
= Design options under your fingertips =
You can set the **design of the contact bar** easily, fast and safe to be suitable to the design of your website:
1. **Position of the bar**: You can place the bar at the **top** or **bottom** on every page
2. **Fixed position**: You can set whether it should **scroll** with the content or **stay fixed**
3. **Horizontal padding** of the contact bar
4. **Vertical padding** of the contact bar
5. **Space between bar and page content** if the bar is fixed
6. **Background color** of the contact bar or a **transparent bar**
7. **Background color opacity** of the contact bar, i.e. its grade of transparency
8. **Text color**
9. **Link color**
10. **Lightness of icons**: You can select between **dark** or **bright** icons
11. **Content alignment** within the bar
12. **Font size** of the texts and links
13. **Icon size**
14. **Headline visibility**: switch the headline on or off
15. **Headline text**
16. **Headline HTML tag**
17. **Headline URL** to make the headline a link
18. **Shadow under or above the bar** for a chic 3D effect
19. **Link target** of all links to open a contact link in the same window or in a new window
20. **Show contact data on small displays** instead of showing icons only
21. any further style you wish by using the filter hook `speed-contact-bar-style`
Do you miss some options? We will add it! Please write your request in the plugin's [support forum at wordpress.org](http://wordpress.org/support/plugin/speed-contact-bar). We will try to take a look and answer as soon as possible.
Read the section "Add and re-order list entries by using hooks" about how to use the plugin's hooks.
= Available Languages =
The user interface is available in
* English
* German (Deutsch)
* Polish (Polski), kindly drawn up by [Marcin Mikolajczyk](https://wordpress.org/support/profile/marcinmik)
Further translations are welcome. If you want to give in your translation please leave a notice in the [plugin's support forum](https://wordpress.org/support/plugin/speed-contact-bar).
== Installation ==
= Using The WordPress Dashboard =
1. Navigate to the 'Add New' in the plugins dashboard
2. Search for 'Speed Contact Bar'
3. Click 'Install Now'
4. Activate the plugin on the Plugin dashboard
5. Configure the plugin with the options page at "Settings" => "Speed Contact Bar".
= Uploading in WordPress Dashboard =
1. Navigate to the 'Add New' in the plugins dashboard
2. Navigate to the 'Upload' area
3. Select `speed-contact-bar.zip` from your computer
4. Click 'Install Now'
5. Activate the plugin in the Plugin dashboard
6. Configure the plugin with the options page at "Settings" => "Speed Contact Bar".
= Using FTP =
1. Download `speed-contact-bar.zip`
2. Extract the `speed-contact-bar` directory to your computer
3. Upload the `speed-contact-bar` directory to the `/wp-content/plugins/` directory
4. Activate the plugin in the Plugin dashboard
5. Configure the plugin with the options page at "Settings" => "Speed Contact Bar".
= Add and re-order list entries by using hooks =
Repeatedly users ask for special things to be included in the contact bar. Of course, if you know how to code with PHP, HTML and CSS you can change the plugin's code and insert whatever you want.
But changing the plugin's code is not a good idea. Every upgrade of the plugin will delete your inserted code.
Luckily there is a solution: hooks offered by this plugin. You can change the content and design of the contact bar with your own functions. And you can be sure that they will not be overwritten by future plugin's upgrades when you place your function in the `functions.php` of your theme or in a self-written plugin.
Use the hooks:
1. `speed_contact_bar_data` for altering the personal contact informations list
2. `speed_contact_bar_icons` for altering the social media icons list
3. `speed_contact_bar_style` for altering the style of the contact bar
You can place the code in your `functions.php` of your theme or in your own plugin. Lets look at the following examples.
= Add an item to the personal contact information list =
The following function does two things:
1. it adds a list item with the content 'Hello World' as the first item
2. and it changes the order of the list items.
At the end the function returns the changed list.
`// Passed parameter: an array of personal contact data as list items
function change_speed_contact_bar_data ( $list_items ) {
// Adds an item as first item in the list via array_unshift()
// The content has to be surrounded by the LI element
array_unshift( $list_items, '
Hello World' );
// Re-orders the list items and returns the new list
// Here: ( a, b, c, d ) => ( c, d, a, b )
return array(
$list_items[ 2 ],
$list_items[ 3 ],
$list_items[ 0 ],
$list_items[ 1 ],
);
}
// Let the function work
add_filter( 'speed_contact_bar_data', 'change_speed_contact_bar_data' );`
= Add an item to the icon list =
The following function does two things:
1. it appends a list item with the content 'Foo Bar' at the end of the list,
2. and it inserts a list item with a standard WordPress search form at a desired position in the list.
At the end the function returns the changed list.
`// Passed parameter: an array of social media icons as list items
function change_speed_contact_bar_icons ( $list_items ) {
// Add an item as last item in the list, via $array[]
// The content has to be surrounded by the LI element
$list_items[] = 'Foo Bar';
// Adds an item at any position in the list via array_splice()
// Way of thinking: the new item should be the x-th element:
// so is x - 1 the parameter value for the position
// Example: if 4th element then parameter value is 4 - 1 = 3
// You can find more tipps for array_splice() at
// http://php.net/manual/en/function.array-splice.php
// The content has to be surrounded by the LI element
// In this example the LI element is extended by an ID attribute
// to have an exact selector for CSS
array_splice(
$list_items, // array to change
3, // position: array index where to insert the new item
0, // number of items to replace
// content of new item:
'' . get_search_form( false ) . ''
);
// Returns changed list
return $list_items;
}
// Let the function work
add_filter( 'speed_contact_bar_icons', 'change_speed_contact_bar_icons' );`
= Add style sheets for the search box =
The following function appends some Cascading Style Sheets code for the search form inserted by the previous function.
At the end the function returns the changed CSS code.
`// Passed parameter: a string of CSS
function change_speed_contact_bar_style ( $css_code ) {
// Adds style for search form, appends it to existing code with '.='
// The content has to be surrounded by the STYLE element
$css_code .= "\n";
// Returns changed CSS
return $css_code;
}
// Let the function work
add_filter( 'speed_contact_bar_style', 'change_speed_contact_bar_style' );`
== Frequently Asked Questions ==
= Could there be any conflicts with my theme? =
In most themes the Speed Contact Bar works fine without any conflicts. Only if the theme comes with an own fixed top bar there can be a source of design conflicts with a fixed Speed Contact Bar.
In that case you can try to set the position of the Speed Contact Bar at the bottom of every page. That will avoid the conflict.
= What does the plugin need to work fine? =
Speed Contact bar requires a WordPress installation version equal or higher than 3.5.
= I am logged in as administrator. Why do I not see the contact bar? =
The most likely reason is the **WordPress Admin Bar fixed on top of the page**. In this case it overlaps the Speed Contact Bar.
You have two possibilities to see the bar:
1. Go to your user profile in the backend a deactivate the checkbox at "Show admin bar"
2. Use another browser, as unlogged visitor
= I want to display this and that. How can I add it? =
If you are a developer please read the section "Add and re-order list entries by using hooks". You will find a documentation about the hooks of the Speed Contact Bar. That way you can easily insert your own content into the bar.
If you do not know how to use PHP please write your request in the plugin's [support forum at wordpress.org](http://wordpress.org/support/plugin/speed-contact-bar). We will try to take a look and answer as soon as possible.
= Why are the icons shown as broken images? =
Most of the icons in the Speed Contact Bar are in SVG format. It is a scalable image format which keeps the images fine in every size.
The reason of the broken icons is a misconfiguration of your server. It sends the wrong HTTP header for SVG files.
Your web server needs an extra line in the configuration file:
`AddType image/svg+xml svg`
For Apache servers the configuration file is called ‘.htaccess’.
= I want to switch off the contact bar for a while without losing all settings. How? =
Just deactivate the plugin. The contact bar does not appear and all your data are kept stored. If you activate the plugin again you see the contact bar with the last stored settings.
If you deactivate and delete the plugin on the plugins page all files and settings of the contact bar will be deleted residue-free.
= How can I get the contact bar in my language? =
Translations are available in English and German. If you want to see another language it would be great if you would provide the translation.
Please write your request in the plugin's [support forum at wordpress.org](http://wordpress.org/support/plugin/speed-contact-bar). We will try to take a look and answer as soon as possible.
== Screenshots ==
1. The contact bar in black with headline, phone number, cell phone number, e-mail address, icons of Facebook icon and Google Plus icons on top of a webpage
2. The options page of the contact bar in the WordPress backend
== Changelog ==
= 6.2 =
* Fixed conflict of multiple calls of the output buffer, reported in the [WordPress.org Forum](https://wordpress.org/support/topic/ob_get_clean-creates-conflict/)
* Successfully tested with WP 4.9.6
= 6.1 =
* Added protection for the displayed email address against spam bots
= 6.0 =
* Changed hook for object buffer start to avoid conflicts with other plugins
* Added priority at actions calls of object buffer
* Fixed wrong call of shutdown action
* Successfully tested with WP 4.9.4
= 5.1 =
* Added options for the fax icon
* Added option for the background color opacity
* Fixed wrong color of dark email icon to adapt it to the color of the other icons
* Fixed a typo
* Updated *.pot file and translations
* Updated screenshot of options page
* Successfully tested with WP 4.9.1
= 5.0 =
* Added option to exclude links of headline and postal address from opening in new windows
* Updated *.pot file and translations
* Tested successfully with WordPress 4.8.2
= 4.9.3 =
* Removed antispambot() for email address formatting
* Added 'Requires PHP' info in readme.txt
= 4.9.2 =
* Increased maximum font size
* Fixed missing email address sanitization for frontend output
* Tested successfully with WordPress 4.8.1
= 4.9.1 =
* Fixed malformed output of the email address
= 4.9 =
* Revised sanitizations for texts and URLs on the pages
* Revised translations
* Set activation message as dismissible
* Tested successfully with WordPress 4.8
= 4.8 =
* Added text option for the phone icon, e.g. for Call To Action
* Added text option for the cell phone icon, e.g. for Call To Action
* Updated Instagram icon
* Fixed undesired layout of two icon lines in some themes
* Updated *.pot file and translations
* Successfully tested with WP 4.7.3
= 4.7 =
* Added link text option for the email link
* Updated *.pot file and translations
= 4.6.1 =
* Added link target for the postal address to open the link in a new window
= 4.6 =
* Added postal address option with icon
* Updated *.pot file and translations
= 4.5.3 =
* Successfully tested with WP 4.7
= 4.5.2 =
* Fixed wrong output of headline if dollar sign is in
= 4.5.1 =
* Removed conversion of '+' to '00' in phone numbers
* Replaced HTML space character by CSS margin at icons
* Successfully tested with WP 4.6.1
= 4.5 =
* Added Snapchat option
* Updated *.pot file and translations
= 4.4 =
* Revised uninstall function for WordPress 4.6 due to the introduction of WP_Site_Query class
* Successfully tested with WordPress 4.6
= 4.3 =
* Added Skype option
* Updated *.pot file and translations
* Successfully tested with WordPress 4.5.3
= 4.2.4 =
* Added polish translation. Thank you very much, [Marcin Mikolajczyk](https://wordpress.org/support/profile/marcinmik)
* Revised plugin activation message function
* Successfully tested with WordPress 4.5
= 4.2.3 =
* Fixed XML Parsing Error
= 4.2.2 =
* Improved headline hierarchy on options page for better accessibility since WP 4.4
* Successfully tested with WordPress 4.4.2
= 4.2.1 =
* Fixed wrong aspect ratios for some social media icons
* Refactoring to keep non-static object context and moved a function into class
* Tested successfully with WP 4.4
= 4.2 =
* Added SoundCloud option
* Sort the social media options in the options page alphabetically
* Improvement style of the options page for smartphones
* Updated *.pot file and translations
= 4.1 =
* Added option to hide bar in mobile devices
* Fixed icon size for some themes
* Tested successfully with WP 4.2.4
* Updated screenshot of Options Page
* Updated *.pot file and german translation
= 4.0 =
* Introducing hooks to filter the lists and styles of the contact bar with your own functions:
* Added filter hook `speed_contact_bar_data`
* Added filter hook `speed_contact_bar_icons`
* Added filter hook `speed_contact_bar_style`
* Augmented ranges of readjustment and padding pulldowns in the options page
= 3.0.1 =
* Fixed font size of links for some themes
* Changed minimum font size from 8px to 4px
* Changed minimum icon size from 16px to 10px
* Some refactoring
= 3.0 =
* Added Position option: place the bar at the top or at the bottom on every page
* Added Headline URL option: The headline can become a link with a given URL
* Added donation button to make it easier for you to contribute the plugin
* Moved some headline options to the 'Appereance' section
* Cleared up options page: More structure and new order of the options
* Updated screenshot of Options Page
* Updated *.pot file and german translation
= 2.6 =
* Added option to keep the headline in mobile devices
* Tested successfully with WP 4.2.2
* Updated *.pot file and german translation
= 2.5.1 =
* Fixed wrong aspect ratios for the IMDb and Yelp icons
= 2.5 =
* Added Yelp option
* Tested successfully with WP 4.2
* Updated *.pot file and german translation
= 2.4 =
* Added option for a transparent bar
* Updated *.pot file and german translation
= 2.3 =
* Added option to keep phone numbers and mailaddress displayed in small screens
* Added function sanitizing phone numbers to make visual representations callable technically
* Enhanced description at phone numbers on the options page
* Updated *.pot file and german translation
= 2.2 =
* Added Instagram option
* Successfully tested with WordPress 4.1.1
* Updated *.pot file and german translation
= 2.1 =
* Added option to select the horizontal padding within the bar
* Added option to select the vertical padding within the bar
* Added option to select the space between the bar and the page content
* Moved all contact bar CSS code into HTML code to circumvent removing the call of the CSS main file
* Updated *.pot file and german translation
= 2.0 =
* Phone numbers are clickable to trigger phone calls
* Added vimeo option
* Added IMDb option
* Added option to select the font size
* Added option to select the icon size
* Added option to select the headline HTML tag
* Changed visibility of phone and cellphone in mobile design
* Significant improved robustness in case of no or fake settings
* Updated *.pot file and german translation
= 1.9.3 =
* Successfully tested with WordPress 4.1
= 1.9.2 =
* Successfully tested with WordPress 4.0
* Added icons for plugin search
* Changed order of links for this plugin on plugin list
= 1.9.1 =
* Added option for opening links in new windows
* Updated *.pot file and german translation
= 1.9 =
* Improve uninstall routine
* Tested successfully with WordPress 3.9.2
= 1.8 =
* Added Flickr option
* Added SlideShare option
* Added tumblr option
* Fixed undesired occurrence of the contact bar on admin error pages
* Updated *.pot file and german translation
= 1.5 =
* Added LinkedIn option
* Added Xing option
* Updated *.pot file and german translation
= 1.4 =
* Added Youtube option
* Added icons in options page
* Updated *.pot file and german translation
= 1.3 =
* Added Twitter option
* Updated *.pot file and german translation
= 1.2 =
* Added Pinterest option
* Updated *.pot file and german translation
= 1.1 =
* Fixed incorrect call of a non-static method in the admin area
* Added WordPress function antispambot() to prevent spam bots recognizing the email address
* Changed color picker type from Fantastic to modern Iris
* Refactoring the options page
* Fixed a german typo
* Updated *.pot file and german translation
= 1.0 =
First official release
= 0.3 =
* Added dashicons
* Added text color option
* Updated *.pot file and german translation
= 0.2 =
* Added headline in the contact bar
* Better CSS logic for fixed position
* Sanitize input and output of user given data
= 0.1 =
First release for just trying it
== Upgrade Notice ==
= 6.2 =
Fixed conflict of multiple calls of the output buffer, tested with WP 4.9.6
= 6.1 =
Added protection for the displayed email address against spam bots
= 6.0 =
Refactored buffering, tested with WP 4.9.4
= 5.1 =
Added options for fax icon and background color opacity, small fixes, tested with WP 4.9.1
= 5.0 =
Added option to exclude links from opening in new windows, tested with WordPress 4.8.2
= 4.9.3 =
Removed antispambot(), added 'Requires PHP' info in readme.txt
= 4.9.2 =
Increased maximum font size, email sanitization, tested with Wordpress 4.8.1
= 4.9.1 =
Fixed malformed output of the email address
= 4.9 =
Revised sanitizations and translations, tested with WordPress 4.8
= 4.8 =
Text options for phone and cell phone, updated Instagram icon, fixed layout in some themes, WP 4.7.3
= 4.7 =
Added link text option for the email link
= 4.6.1 =
Added link target for the postal address
= 4.6 =
Added postal address option with icon
= 4.5.3 =
Tested with WP 4.7
= 4.5.2 =
Fixed wrong output of headline if dollar sign is in
= 4.5.1 =
Removed conversion of '+' to '00' in phone numbers, tested with WP 4.6.1
= 4.5 =
Added Snapchat option
= 4.4 =
Revised uninstall function, tested with WP 4.6
= 4.3 =
Added Skype option, tested with WordPress 4.5.3
= 4.2.4 =
Added polish translation, revised plugin activation message function, tested with WP 4.5
= 4.2.3 =
Fixed XML Parsing Error
= 4.2.2 =
Improved headline hierarchy on options page for better accessibility since WP 4.4
= 4.2.1 =
Fixed some wrong aspect ratios, refactoring, tested with WP 4.4
= 4.2 =
Added SoundCloud option, graphical improvements in the options page
= 4.1 =
Added option to hide bar in mobile devices, fixed icon size for some themes, tested with WP 4.2.4
= 4.0 =
Introduced hooks, augmented ranges for padding and readjusment
= 3.0.1 =
Fixed font size of links, refactoring
= 3.0 =
Added and reordered options
= 2.6 =
Added option for the headline in mobile devices, tested successfully with WP 4.2.2
= 2.5.1 =
Fixed wrong aspect ratios for the IMDb and Yelp icons
= 2.5 =
Added Yelp option, tested successfully with WP 4.2
= 2.4 =
Added option for a transparent bar
= 2.3 =
Added option to keep phone numbers and mailaddress displayed in small screens
= 2.2 =
Added Instagram option, tested with WP 4.1.1
= 2.1 =
Added options, please reset the settings of the bar
= 2.0 =
Please set the new Speed Contact Bar settings: IMDb, vimeo, headline HTML tag selection, sizes of texts and icons. Phone numbers are clickable now
= 1.9.3 =
Successfully tested with WordPress 4.1
= 1.9.2 =
Successfully tested with WordPress 4.0, added icons for plugin search
= 1.9.1 =
Added option for opening links in new windows
= 1.9 =
Improved uninstall routine, tested with WordPress 3.9.2
= 1.8 =
Added Flickr, SlideShare and tumblr option
= 1.5 =
Added LinkedIn and Xing options
= 1.4 =
Added Youtube option
= 1.3 =
Added Twitter option
= 1.2 =
Added Pinterest option
= 1.1 =
Fixed errors and changed color picker
= 1.0 =
Added new options and security for data inputs and outputs, removed dashicons
= 0.3 =
Added dashicons and text color option
= 0.2 =
Improvements in sanitizing user data and style
= 0.1 =
First release in beta status