=== WP-Prowl === Contributors: milkandtang Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=7648647 Plugin homepage: http://blog.milkandtang.com/projects/wp-prowl Tags: prowl, growl, sms, message, contact Requires at least: 2.6 Tested up to: 2.8.4 Stable tag: 0.6.2 A plugin for interfacing your Wordpress with Prowl, an application for receiving custom push notifications on your iPhone. == Description == WP-Prowl is a Prowl integration plugin for Wordpress. It will allow you to receive Push notifications on your iPhone about things happening on your blog. The first version has the following capabilities: * Notify on new Comment * Notify on new Ping/Trackback * Notify on new Page creation * Notify on new Post Additionally, it allows you to configure the format of these notifications, so that you can pick what information is relevant to you and how to display it on your phone. == Installation == 1. Upload the files into the `/wp-content/plugins/` directory 2. Activate the plugin through the 'Plugins' menu in WordPress 3. Purchase Prowl for your iPhone (http://prowl.weks.net) 4. Follow Prowl's setup instructions. 5. Login to the Prowl website to retrieve your API key. 6. Enter the API key into WP-Prowl's settings page. == Frequently Asked Questions == = What is Prowl? = Prowl is a probably one of the most useful iPhone applications that you could ever own, and it's a downright steal at $3 USD (iTunes Store Link). Prowl allows you to receive Growl notifications on your iPhone (more on Growl later). In a particularly impressive twist, it also exposes an API so that any internet connected service can send notifications to your iPhone. Imagine the possibilities: shell scripts, web servers, Wordpress plugins (howabout that?). = What is Growl? = Growl is a system-wide notification system, originally for Mac OS X but that's since been cloned into Windows compatible versions as well. It allows "Growl aware" applications to send notifications to a centralized notification system on your computer, where they can be displayed on screen, emailed, pushed to your phone (via Prowl) or any other thing that a Growl plugin developer could imagine. Growl doesn't come into the WP-Prowl equation, but it's probably to your benefit to know where it all started. How can I use WP-Prowl? Getting started is easy. First, own an iPhone running software 3.0+. Second, purchase Prowl from the app store. Third, Install my Wordpress plugin, WP-Prowl. Fourth, get your API key from the Prowl website (more on that later). Fifth and finally, configure my Wordpress plugin with your API key, and you're done! = Are there special requirements to install? = Yes. The webserver that hosts your Wordpress must have [cURL](http://curl.haxx.se/) support in PHP, with SSL enabled. Most do. If not, you'll need to get it installed, which is something you'll have to work out yourself (or with your hosting provider). WP-Prowl will warn you if cURL isn't available on install, and will fail to activate with a message telling you so. Also, your iPhone must be updated to version 3.0 or later to support [Prowl](http://prowl.weks.net). = Your configuration screen sucks! = Yes, it's both ugly and confusing. It's not even a 1.0 product yet, give me a break! In all seriousness though, I am working on making it better, but I want to add more functionality before I make it really concrete. = I have an idea for your plugin! = Awesome! If it's a good one (and I'm sure it is), I'd love to implement it. Send me what you're thinking (nate at milkandtang dot com), and I'll send you back my thoughts. I'm super-excited to hear from you! = I love your plugin! = Hey thanks! Perhaps you'd consider making a [donation](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=7648647 "Make a donation via PayPal!")? Love goes a long way, but money keeps me living; and when I'm alive, I'm writing plugins! Seriously though, I could always use help with the rent and bills, and would appreciate whatever you can give. Even if it's just some kudos on your blog. == Changelog == = 0.6.2 = * Checks for required cURL abilities and warns if they aren't present. * Sanity checks on a few things to make sure the best always happens. * Killed some defines and minimized some database calls. * Removed ability to put date/time into formatting strings. Redundant as Prowl knows the time. * Added a few more options for formatting strings. * Actually removes all database entries on deactivation. * Fixed more readme typos. I need a proofreader. * Configuration is still ugly. This is now a feature (until I get around to it). = 0.6.1 = * Fixed some issues in the readme. * Fixed an issue that caused an error to be thrown on plugin activation. sorry. = 0.6.0 = * Fixed up some bits * Added explanations of some configuration options * Changed how versions are handled = 0.5.0 = * Initial Release. Configuration still very ugly. == Miscellaneous == Big thanks to [ProwlPHP](http://github.com/Fenric/ProwlPHP/tree/master) for making my life easier. It's a classy little PHP library for interacting with the Prowl API, and it does all the heavy lifting for WP-Prowl! Serious thanks to ##PHP and #wordpress on freenode for always being helpful. The ability to get instant answers when you're lost is amazing. Mighty thanks to Zachary West, author of Prowl, for 1.) writing a seriously awesome iPhone app and 2.) Listing my plugin on your API page.