=== 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
Contributors: Thaya Kareeson
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
Stable Tag: 4.4.2

Display a different greeting message to your visitor depending on which site they are coming from.  Please re-activate after every upgrade to be safe.

== 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.
* 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 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.
* AJAX greeting message in the frontend makes it compatible with caching
  plugins (such as WP Super Cache) and WPMU.
* AJAX administrative interface that uses nonce verification to discourage
  hackers.
* 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.
* 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. furl.com
  1. google.*
  1. ma.gnolia.com
  1. mister-wong.com
  1. myspace.com
  1. netvibes.com
  1. newsvine.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

== 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 clear your cache after you've activate
WP Greet Box.

= Does this work with WPMU? =
Yes it does!  The frontend greeting message makes an AJAX call to the server
to display the proper greeting message instead of pre-populating a static
Javascript file with the data.

= 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! =
I will be writing a troubleshooting guide soon, but until then, please post
your issues on the [plugin page](http://omninoggin.com/projects/wordpress-plugins/wp-greet-box-wordpress-plugin/).
I will try my best to help you resolve the 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.

== Changelog ==

* 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

== 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.