=== Subscription Options ===

Contributors: Tom Saunter

Donate link: http://bit.ly/donate_to_me

Tags: subscription, subscribe, option, options, color, colour, colors, colours, feedburner, rss, feed, mail, email, service, twitter, stream, follow, facebook, page, delivery, linkedin, flickr, google, google plus, google+, podcast, podcasting, itunes, icon, icons, widget, sidebar, settings

Requires at least: 2.8

Tested up to: 3.2.1

Stable tag: 0.8.5



Adds subscription option icons for your RSS Feed; your FeedBurner Email Service; your Twitter Stream and your Facebook page. Totally user-defined.



== Description ==

The most common ways for people to subscribe to a blog and its content are through RSS, Email and Twitter. Facebook pages are increasing in usage too. This plugin places related subscription icons in a widget area and lets users enter their own feed or page URLs and select the colour of their icons. Its really simple but theres lots of power under the hood.



= Features: =

* Offers an attractive range of subscription options for your readers using familiar-looking icons.

* Intuitive interface for editing options, including your feed or page URLs, widget title and icon sizes.

* Independent handling across multiple widget instances, using WordPress 2.8's widget_class coolness.

* NEW in Version 0.8 - the ability to select any colour, via HEX code or [HTML Color Name](http://www.w3schools.com/html/html_colornames.asp).

* NEW in Version 0.8 - integration with the brand new [Subscription Options Add-on Pack](http://digitalcortex.net/plugins/subscription-options/addon-pack).



== Installation ==

1. Download the plugin by hitting that big red button to the right.

2. Extract the files and place the entire 'subscription-options' folder into your wp_content/plugins directory.

3. Go to your 'Installed Plugins' panel and activate 'Subscription Options'.

4. You are now ready to use the widget.



= Setup: =

* Go to your 'Appearance > Widgets' panel and select the widget area you wish for the plugin to appear in.

* Enter the following details:

1. Widget Title

2. RSS Feed URL & Colour

3. Email Service URL & Colour

4. Twitter Stream URL & Colour

5. Facebook Page URL & Colour

6. Size of Feed Icons


* Please note that you don't need to use all the icons - just don't enter a URL if you don't want an icon to show up.

* Please also note that you can use any HTML colour code, be it HEX code or [HTML Color Name](http://www.w3schools.com/html/html_colornames.asp).

* Hit 'Done' then 'Save Changes'. Test the appearance and perhaps change the size of the icons as necessary.

* If you would like additional icons for LinkedIn, Flickr, Google+ or Podcasting, consider installing the [Subscription Options Add-on Pack](http://digitalcortex.net/plugins/subscription-options/addon-pack) and a new set of subscription options will automatically appear in the widget options panel.

== Screenshots ==

1.  This is how the plugin could look on your blog.

2.  This is the widget options panel.

3.  These are some example configurations.



== Changelog ==

* 0.1.0 was the first iteration of what I promise will be a participatory experience

* 0.1.5 - added css classes for users to hook into and edit through their css sheets

* 0.2 - added user-defined header size and target of users' clicks

* 0.3 - updated icons to scale up to higher sizes without dithering

* 0.4 - switched to WP 2.8's widget_class functionality to really crank it up

* 0.5 - inclusion of a new subscription icon for Facebook, by popular demand

* 0.6 - implemented an icon colour changer with twelve options

* 0.7 - upgraded to pass XHTML 1.0 Transitional validation

* 0.8 - full colour options & additional subscription icons based on user feedback

= Future Versions: =

* 0.9  farbtastic or other java-based colour picker integration



== Upgrade Notice ==



= 0.8 =

This new version give you thousands of new colour options, using transparent icons and CSS3 rounded corners. As such, the widget looks best in modern CSS3-compatible web browsers, so please upgrade only if you are entirely comfortable with this.



== Frequently Asked Questions ==

= Where do I put the widget? =

You can place the widget wherever you like as long as it is within a pre-defined widget area. I haven't worked out how to let people place the widget wherever they like. Let me know if you can help on my [contact page](http://digitalcortex.net/contact) though.



= Can I style the widget in my own way? =

Yes of course, it's WordPress! You can use your stylesheet.css or this widget's internal stylesheet to override your theme's default widget settings by using the following CSS classes:

* img.suboptions-icon  all icons (useful for setting alignment or spacing)

* img.rss-icon  the RSS feed icon

* img.email-icon  the email service icon

* img.twitter-icon  the Twitter icon

* img.facebook-icon  the Facebook icon



Please note that the icons' sizes will still need to be set from within the widget admin panel. CSS doesn't let you override that.



= Why don't my icons have nice rounded corners any more? =

The latest version of this plugin gives you thousands of new colour options, using transparent icons and CSS3 rounded corners. As such, the widget looks best in modern CSS3-compatible web browsers such as Firefox, Google Chrome or IE9. If you are not entirely comfortable with this, you can always roll back to an [older version](http://wordpress.org/extend/plugins/subscription-options/download).



= How do I find my Feedburner Email Service URL? =

The clickstream from within Feedburner looks like this: Publicize > Email Subscriptions > Activate. Then right click and copy the text that says 'Preview Subscription Link' That's your Feedburner Email Service URL... BOOM!



= Where can I find more help and support? =

Just email me from the contact page on [my blog](http://digitalcortex.net/contact) or leave a comment [right here](http://digitalcortex.net/plugins/subscription-options). I'll be happy to help where possible.



= I'm a fan of this plugin. What are my options? =

[Digital Cortex](http://digitalcortex.net) ([rss](http://feeds.feedburner.com/digitalcortex)) is actively seeking new fans & followers on [Facebook](http://facebook.com/digitalcortex) and [Twitter](http://twitter.com/freedimensional) if you fancy it?



= How can I support the development of this plugin? =

Thank you so much for asking. There are a couple of options. You can purchase the [Subscription Options Add-on Pack](http://digitalcortex.net/plugins/subscription-options/addon-pack) for $1.50, or you can [donate here](http://bit.ly/donate_to_me) without upgrading.