=== WP Greet Box ===
Tags: referrer, search engine, seo, rss, landing sites, google, yahoo, social networks, digg, stumbleupon, delicious, technorati, twitter, live, blinklist, blogmarks, diigo, facebook, furl, magnolia, mister-wong, myspace, newsvine, reddit, simpy, youtube, flickr, tumblr, wordpress, linkedin, plurk, friendfeed
Contributors: madeinthayaland
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=thaya.kareeson@gmail.com&currency_code=USD&amount=&return=&item_name=Donate+a+cup+of+coffee+or+two+to+support+WP+Greet+Box+plugin.
Requires at least: 2.6
Tested up to: 2.7.1
Stable Tag: 5.0.1

Display a different greeting message to your visitor depending on which site they are coming from.

== Description ==

This plugin lets you show a different greeting message to your new visitors
depending on their referrer url.  For example, when a Digg user clicks through
from Digg, they will see a message reminding them to digg your post if they
like it.  Another example, when a visitor clicks through from Twitter, they
will see a message suggesting them to twit the post and follow you on Twitter.
You can also set a default greeting message for new visitors (not matching any
referrer URLs) suggesting them to subscribe to your RSS feed.  Having these
targeted suggestions will help your blog increase exposure, loyal readership,
and reader interaction.  Best of all, this plugin is compatible with WPMU
and various WordPress cache plugins (so you do not have to sacrifice speed).

= Features =

* Show a different greeting message to your visitor depending on the referrer
  URL.  You can add/edit/delete/disable these greeting messages as you choose.
* Beautiful set of icons shipped along with the different default referrers.
* Clickable icon in greeting messages.
* Greeting messages automatically get inserted into the top of your posts upon
  activation.  There is no need to modify theme files.
* Ability to auto-insert greeting message to the top or bottom of the post.
* Greeting messages can be user closeable or not.
* Ability to detect the visitor's search keywords from major search engines
  and automatically display related posts under or above the greeting message.
* Show a default greeting message even if the vistor does not match any of
  your configured referrer URL.
* Show a default greeting message even if the visitor does not have javascript
  enabled.
* Cache compatible mode makes use of AJAX to display greeting messages in the
  frontend.  This makes WP Greet Box compatible with other caching plugins
  (such as WP Super Cache) and WPMU.
* AJAX administrative interface that uses nonce verification to discourage
  hackers.
* Ability to keep displaying the greeting message until after the user clicks
  close for the first time.  After that, the greeting message will not show up
  for that user anymore.
* Ability to set a timeout to forget a visitor so we do not keep nagging them
  with greeting messages.
* Ablity to set rules to exclude some referrer URLs from seeing greeting
  messages.  Regular expressions is also supported (but not required!).
* Ultra customizeable greeting message box (with CSS) allowing you to
  prepend/append HTML around the greeting message box.
* Ability to disable included CSS for manual CSS management.
* Ability to disable included JS for manual JS management.
* Available "greet_box_text" filter for other plugins to modify greeting
  message before outputting.
* Ability to import and export all WP Greet Box Settings.
* Currently the following referrers are installed by default, but you can
  easily create your own if your favorite referrer is not on the list!
  1. blinklist.com
  1. blogmarks.com
  1. del.icio.us
  1. delicious.com
  1. digg.com
  1. diigo.com
  1. facebook.com
  1. flickr.com
  1. friendfeed.com
  1. furl.com
  1. google.*
  1. linkedin.com
  1. ma.gnolia.com
  1. mister-wong.com
  1. myspace.com
  1. netvibes.com
  1. newsvine.com
  1. plurk.com
  1. reddit.com
  1. search.live.com
  1. search.msn.com
  1. search.yahoo.com
  1. simpy.com
  1. stumbleupon.com
  1. technorati.com
  1. twitter.com
  1. youtube.com

= Changelog =

* 5.0.1
  1. Fixed array_slice() warning in the admin dashboard.
  1. Fixed version check to not break page when $wp_version is empty.
* 5.0
  1. Added ability to expand related posts by default.
  1. Added ability to display related posts before the greeting message.
  1. Added localization support.
  1. Added version checking.
  1. Cleaned up a lot of code.
* 4.9.1
  1. Fix page reload (in some cases) when closing greet box.
* 4.9
  1. Added the ability to keep displaying the greeting message until after the
     user clicks close for the first time.  After that, the greeting message
     will not show up for that user anymore.
  1. Added support for icon links so icons are now clickable.
  1. Fixed default CSS display for when the greet box is too long compared
     to the greeting message.
  1. Fixed PHP cookie writing outside of place bug in PHP mode (Thank you
     Daniel from Bonetree Blog!).
  1. Fixed cookie bug in PHP mode (causes message to show up too often).
  1. Fixed some XHTML stuff.
  1. Fixed other minor bugs.
* 4.8.1
  1. Fixed PHP & JS cookies conflict when switchng WP Greet Box modes.
  1. Fixed admin general configuration page not saving options.
* 4.8
  1. Added support for non-cache-compatible mode for people who do not use
     this plugin with any caching plugins.
  1. Added option to disable JS references for manual JS management.
* 4.7
  1. Added friendfeed.com, linkedin.com, and plurk.com along with
     corresponding icons.
  1. Made related posts not show up if no related results are found.
* 4.6.2
  1. Fixed WP Greet Box triggering wp-include/query.php WordPress core error
     for some themes.
* 4.6.1
  1. Fixed broken manual insertion.
* 4.6
  1. Added ability to import and export all WP Greet Box options
     (including greeting messages).
  1. Added option to disable CSS for manual CSS management.
  1. Enhance upgrade procedure.  Now all you have to do is visit any admin
     page after every upgrade.
* 4.5
  1. Added apply_filters("greet_box_text", $greet_html) filter for other
     plugins to modify message before display.
  1. Added icons for WordPress (thanks Joost De Valk!) and Tumblr
* 4.4.3
  1. Fixed WP 2.5 backwards compatibility (though pre WP 2.6 is not officially
     supported)
  1. Added option to allow self referral to trigger greet box.
  1. Added [[email-link]] short code for displaying "Subscribe via Email" links
     in greeting messages.
* 4.4.2
  1. Fixed MySQL index key conflicts by using a more unique index key name.
  1. Fixed XHTML validity with IMG tag and CSS file reference.
  1. Moved JS reference to the footer to help page load faster.
* 4.4.1
  1. Fix preg_match() error that occurs when there are slashes (/) specified
     in the referrer URL of each custom greeting message.
* 4.4
  1. Added more default greeting messages.
  1. Created and used my own set of free transparent icons.
  1. Added support for wildcard referrers (*.fr, *.uk).
  1. Added ability to specify multiple referrers per greeting message.
  1. Adjusted default CSS again.
  1. Fixed bug with stumbleupon & digg URLs that won't work on some sites.
* 4.3.3
  1. Fixed incompatibility on some web server setups which required URL escape.
* 4.3.2
  1. Fixed site_url() compatibility.
* 4.3.1
  1. Fixed /index.php to index.php in onload.js again.
* 4.3
  1. Added ability to detect the visitor's search keywords from major search
     engines and automatically display related posts under the greeting
     message.
  1. Fixed blank line bug in RSS feeds.
* 4.2.3
  1. Fixed bug that causes WP Greet Box to not work with sites with WordPress
     not installed in the root directory.
  1. Changed donation URL.
* 4.2.2
  1. Added ability to auto-insert greeting message before or after the post.
  1. Fixed default CSS (again).
  1. Fixed parse_url() incompatibilty in some version of PHP.
  1. Fixed blank line bug that shows up in IE when no greeting is shown.
  1. Fixed invalid reference to wp-greet-box/js/admin_functions.js.
  1. Hide advanced options in general configurations.
  1. Gave administration pages a bit of a facelift.
* 4.2.1
  1. Added optional "Powered by WP Greet Box" at the bottom right of messages.
* 4.2
  1. Auto-insert into the top of posts by default.
  1. Added ability to auto-insert into the top of pages.
  1. AJAXify adding new greeting message in administration.
  1. New settings to make messages closable or not.
  1. Easier exclusion rules (with regex toggle).
  1. Prevent self-referral to trigger greeting messages.
  1. Refferals are now per domain, instead of per URL.
  1. Fixed a bug that causes greeting messages to not work if one of the
     custom messages did not have a referrer URL specified.
  1. Fixed a bug that causes greeting messages to not work on non-default
     path WordPress installations.
  1. More generic/stable CSS defaults.
* 4.1.1
  1. Modification so that Javscripts are only ran on pages with
     that has <? wp_greet_box() ?> calls.
  1. Fixed adding new message bug.
* 4.1
  1. Security patch using nonce verification on admin AJAX calls.
* 4.0.3
  1. Fixed regression AJAX bug.
* 4.0.2
  1. Fix some IE compatibility issues.
  1. Also fixed Javascript to work with non-standard directory WordPress installs.
* 4.0.1
  1. Fix PHP4 compatibility issue.
* 4.0
  1. Greeting message now fades out when the close button is clicked.
  1. Frontend greeting message display now uses AJAX to display the proper
     greeting message.
  1. There is no longer a need to pre-generate a static wp-greet-box.js file for
     these greeting messages.  This also fixes the "Fatal error: Cannot redeclare
     wp_greet_box()" error that many people are getting from incorrect
     permissions.
  1. Greeting message administration UI became a lot easier and quicker after
     AJAXification.
* 3.1.1
  1. Fixed a bug that caused the greet box to not show up if exclusion rules are
     not specified.
* 3.1
  1. Added referral URL exclusion rules capabilities.
  1. Added noscript support for users with javascript disabled.
  1. Paginate admin pages.
* 3.0
  1. Added cookies support so we do not keep showing the same message to
     returning visitors.
  1. Added default message when no referrer match is found.
* 2.1
  1. Fixed PHP4 incompatibility.
* 2.0
  1. Added ability for users to add/delete/disable greeting messages.
  1. Added confirmation dialogs for delete and reset function.
* 1.0
  1. Initial release

== Installation ==

1. Upload the plugin to your plugins folder: 'wp-content/plugins/'
2. Activate the 'WP Greet Box' plugin from the Plugins admin panel.
3. (optional) Go to the Options -> WP Greet Box admin panel to make
   any customizations.
4. Test this out by googling for one of your articles and click through to your
   site from google.  You should see the greeting message custimized for a
   google visitor.

== Frequently Asked Questions ==

= Does this work with cache plugins? =
Yes it does!  Just make sure that you enable cache compatibility in WP Greet
Box advanced options and clear your cache afterwards.

= Does this work with WPMU? =
Yes it does (even when cache compatiblity mode is enabled)!

= Can I customize where I want to place my greeting message? =
Yes!  You will have to disable the auto insert feature in General
Configurations.  Next, copy the following code to your desired location in any
of the theme files:
  <?php if(function_exists('wp_greet_box')){wp_greet_box();} ?>

= The default settings are ugly!  Can I change the way it looks? =
Yes!  You can modify the CSS entries for greeting messages in:
  wp-greet-box/css/wp-greet-box.css.

= Can I add additional greeting messages? =
Yes!  You can easily do this on the WP Greet Box options page.  You can even
modify preinstalled messages or delete them.

= I can't get it to work! I'm frustrated! =
You can find troubleshooting guides and more information on the
[plugin page](http://omninoggin.com/projects/wordpress-plugins/wp-greet-box-wordpress-plugin/).
Feel free to post questions to the comment form.  I will try my best to help
you resolve any issues that you are having.

== Credits ==
Search engine keyword retrieval algorithm borrowed from the
[Landing Sites](http://wordpress.org/extend/plugins/landing-sites/) plugin
by [The undersigned](http://theundersigned.net/) and devil1591.

== Screenshots ==

1. Display message to google visitors.
2. Display related posts based on most search engine keywords.
3. Ask visitors from stumbleupon.com to thumbs up your post.
4. Display default message to visitors not matching any special referrer.
5. AJAXed message administration.
6. Buckets for active and inactive messages.
7. Exclusion rules with optional regex support.
8. General settings with advanced options hidden by default.
