=== Plugin Name ===
Contributors: acumensystems
Donate link: http://www.acumendevelopment.net
Tags: widget, html, xpath
Requires at least: 2.5
Tested up to: 3.0
Stable tag: trunk

Widget and shortcode providing elements from external or local webpages.

== Description ==

The HTML Grabber Widget was developed by [Acumen](http://www.acumendevelopment.net/ "Acumen Development")
in order to provide a way to insert HTML from local or external webpages within your Wordpress pages.

Once the plugin is installed, you will have a new Widget shown in the Appearance section, which you'll be able to
drag into your sidebar. From there, you can configure the page settings, including an xPath query to the element
that you want to include in the sidebar.

== Installation ==

This section describes how to install the plugin and get it working.

1. Upload the plugin to it's own directory within `/wp-content/plugins/`
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Add the widget to a sidebar in Appearance > Widgets and/or use the [grabber] shortcode
1. Set up either the widget or the shortcode with the following fields:
 * Add the URL to the webpage you want to capture from
 * Set the selector type, either `id` or `xpath`.
 * Set up the element selector, using either [xPath](http://php.net/manual/en/domxpath.query.php) syntax or the element ID
1. For the shortcode, the format should be `[grabber url=http://example.com element=myElement type=id]`
1. Enjoy!

== Frequently Asked Questions ==

= What format can I specify HTML elements using? =

Currently, we are using PHP's [DomXPath](http://php.net/manual/en/domxpath.query.php) object. We have added support for choosing
an element by ID. However, if you were writing this yourself using the xPath syntax, you would use the syntax `//*[@id='myElementId']`.
We hope to support jQuery to support parsing of pages via a proxy using AJAX.

== Screenshots ==

1. Configuration options for the Grabber Sidebar Widget


== Changelog ==

= 0.1 =
* Initial release using DOMXPath

= 0.2 =
* Added shortcode format